Note: for non-billing questions, see our Sui Products FAQ.

Node Service

Pay-As-You-Go Payment Terms

Monthly automated billing, due when invoice is created

When you sign up for a Pay-as-you-go plan, we create a monthly plan for you. Our system generates an initial $0 invoice the day you make the plan. After that, a monthly invoice is generated on approximately the same day every month starting with the UTC day after you sign up (our billing days are in UTC). As an example, if you sign up on the 10th of the month, you'll get a $0 invoice on the 10th and then an invoice for your usage on the 11th of each month moving forward. Invoices take about an hour to finalize, so in this example you would get an invoice around 1am UTC on the 11th of each month.

This means you'll get an invoice the UTC day after you sign up. In our example, this invoice would cover your usage on the 10th. If your usage on the 10th was greater than your daily free allotment, your invoice on the 11th will be > $0 to reflect that.

When an invoice > $0 is generated, we automatically charge the payment method on file. So, you may see a charge the day after you sign up (for 1 day of usage). This gives you a chance to see our invoices and gives us a chance to test the payment method on file.

Where do I view my invoices?

Invoices will be emailed to your workspace contact email and also will appear in your Shinami dashboard. You can find them on the "Sui Node Service" tab of your Billing page. Scroll to the bottom to find your invoices table, where you can view your current and historical invoices. We show you the status and you can download a PDF copy if you wish.

The invoice date shown is in local time. The Stripe invoice in the PDF is in UTC so may show a different date. — Note: the invoice date shown is in local time. The Stripe invoice in the PDF is in UTC so may show a different date.

What you're billed for

See our section below.

10 days to rectify a failed payment

In the event of a issue charging your payment method on file, you have 10 days to make a payment including the day the invoice was created. For example, if your invoice was created on the 11th, it is due by end of UTC day on the 20th.

Stripe will automatically retry in certain cases, and generally will send you an email if there was an issue. However, this may not happen in all cases, so please follow the "Best practices for prompt payment" below to prevent a service disruption.

Your requests will be blocked if you don't pay in 10 days

If your invoice has not been paid within 10 days (as described above), our system will return a JSON-RPC -32012 error on all of your Node Service requests. If you're getting this error due to an unpaid bill, you can use the link in the Stripe invoice sent to the workspace contact email to pay the bill. In about 5-10 minutes your service will be restored. If you can't find the link, contact us through our support email.

Best practices for prompt payment

To ensure prompt payment and no service disruption, please:

Make sure the payment method on the "Sui Node Service" tab of your Billing page is up to date.
Set your workspace contact email to an address that will be monitored. This is where Stripe sends the emails about failed and successful payments. It will arrive on approximately the same day and time every month.
Monitor your payment method to make sure that you've been charged within a few days of your monthly invoice date.

Cancelling your monthly plan

You can schedule a downgrade to the free tier by clicking "Downgrade to Free" in the Free tier box on the "Sui Node Service" tab of the Billing page in your Shinami dashboard. You will remain on your Pay-as-you-go-plan until the remainder of your current billing month. So, if your invoicing day is the 11th of the month and you schedule a downgrade on the 1st, you'll remain on Pay-as-you-go until start of UTC day on the 11th, when your final invoice is generated. This invoice will cover any paid usage you had before scheduling the downgrade, as well as any after. You can prevent additional charges for usage after you schedule a downgrade by keeping your request count under the daily free limit.

Which Node Service requests am I billed for?

Free plan

None. Customers on the Free plan are not charged for requests but have a daily request limit per network (e.g. Mainnet). If you hit the daily limit on a network, all subsequent requests will return a JSON-RPC -32012 error until the next day (UTC).

Pay-as-you-go

The Pay-as-you-go plan has no daily request limit. You are only limited by the max QPS per network allotment. You get the same daily free allotment as the Free plan. You are charged for all requests you send to Testnet or Mainnet above the daily free allotment. This includes all errors. We expect your error rate to be very low outside of heavy rate limiting (which would indicate you may need an Enterprise plan for higher QPS).

"Unexpected" Node Service requests

There are some actions you can take that add additional Node Service requests you may not expect. Key actions include:

Invisible Wallet API requests that use your Node Service plan. These are marked in the doc and include executing a transaction for a wallet.
Building a transaction before executing it.

We encourage you to monitor your usage in on the "Sui Node Service" page of your Shinami Dashboard. Our API Insights break down your requests by method, so you can see if there was anything you didn't expect to see.

Tip: click a method name on the right side to show or hide it in the graph. I've hidden a few above.

What is the cost?

To see our daily limits and per-request pricing and upgrade to Pay-as-you-go as needed, visit the "Sui Node Service" tab of your Billing page) of your Shinami dashboard.

Step 1: select Billing page. Step 2: select Sui Node Service tab. Step 3 (if needed): upgrade

What's in an Enterprise plan?

We offer dedicated Node Service plans that give you private, non-shared infrastructure, that scales to accommodate your needs. We can also deploy in your preferred geographic region for the quickest read latency possible (write latency may improve as well, but is dependent on validator location). If you don't need dedicated infrastructure, we offer discounts for high-volume commitments. You also get TG or Slack with our team for support, and you can pay in crypto if you want. If this sounds right for you, reach out to us at [email protected].

How do I monitor my request and QPS usage?

See our Sui Node Service product FAQ for some very helpful guidance on monitoring your request count over time as well as how many rate limits you've gotten and what your and current QPS is.

Gas Station

What fee does Shinami charge for sponsorships?

We charge a small fee per sponsorship, as well as a fee if your sponsorship goes unused. For full details, visit the "Sui Gas Station" tab of the Billing page in your Shinami dashboard (partial screenshot shown):

How do I monitor my fund balance and recent usage?

See our Sui Gas Station Product FAQ for helpful guidance.

How do I view my monthly Gas Station billing summary statements?

Visit the "Sui Gas Station" tab of the Billing page in your Shinami dashboard to view the "Mainnet Statements" table. You'll find an entry for each month you've been sponsoring transactions on Mainnet.

We add an entry for a new month 3-4 days after it ends. You can see a summary of your total sponsorships, as well as the total Sui transaction fees and Shinami fees for those transactions. Click the + next to All in the Fund(s) column to see a breakdown by fund. I've clicked it below so now it's a - that I can click to close the expanded row.

You can also download a full report for the month, which is a CSV file containing each transaction sponsorship you made. You can do this by clicking the "Download" button in the "FULL REPORT" column.

Wallet Services

When you create a Shinami account, you are automatically put on the free Wallet Services tier. This tier has a monthly wallet creation cap for Sui wallets as shown in the "Sui Wallet Services" tab of the Billing page of your Shinami dashboard. The limit is applies to the sum of wallets you've created across all wallet types, so we check if zkLogin_wallets_created_this_month + Invisible_Wallets_created_this_month < free_tier_limit. If you need more than this, or more than the default QPS, reach out to [email protected] and we can create a custom plan for you based on your committed usage and QPS needs.

Even on the free tier, some Wallet Service requests can incur a cost due to their use of other Shinami services. For example, executing a sponsored transaction for an Invisible Wallet uses our Gas Station and Node Services, and you will be charged for your use of those services as explained in their billing sections. In the API docs it will be clear when Node or Gas Station services are used because we call out the need to use an API access key with rights to those services when applicable.