💿Compute Units (CUs)

Compute Unit is a way to measure your RPC request usage on ThunderStack RPC. We provide each user a daily quota of usage, and each method will consume a cost based on the resource required for execution. You can think of this as you have a balance in your account and each method has its own price. This will be deducted from your account upon submission of RPC requests. The price of each RPC method is called Compute Unit. Based on this calculation, we enable our users to utilize the daily request quota more efficiently. In short, you only pay for what you use.

For different subscription tiers, there may have different daily usage quotas.

CUs of RPC Method

Below are the CUs for each method. We define the CUs based on the resource required for execution.

Supported Method

Method	CUs
eth_accounts	5
eth_blockNumber	5
eth_chainId	5
eth_syncing	5
net_listening	5
net_version	5
web3_clientVersion	5
eth_subscribe	10
eth_uninstallFilter	10
eth_unsubscribe	10
web3_sha3	10
eth_signTransaction	10
net_peerCount	10
eth_gasPrice	15
eth_getBalance	15
eth_getBlockByNumber	15
eth_getCode	15
eth_getStorageAt	15
eth_getTransactionByBlockHashAndIndex	15
eth_getTransactionByBlockNumberAndIndex	15
eth_getTransactionByHash	15
eth_getTransactionReceipt	15
eth_getBlockByHash	18
eth_getBlockTransactionCountByHash	18
eth_getBlockTransactionCountByNumber	18
eth_getFilterChanges	18
eth_newBlockFilter	18
eth_newFilter	18
eth_newPendingTransactionFilter	18
eth_call	20
eth_getTransactionCount	25
eth_getFilterLogs	50
eth_getLogs	50
eth_estimateGas	75
eth_sendRawTransaction	150
debug_traceTransaction	280
debug_traceCall	280
debug_traceBlockByNumber	1800
debug_traceBlockByHash	1800

Unsupported Method

If ThunderStack RPC received requests using unsupported RPC method, the CUs are 2 for each request.

How does ThunderStack RPC calculate my daily CU quota?

We accumulate the daily usage by account. Regardless of how many API Keys you created in your account, we calculate the usage by summing the entire usage across all API Keys.

What happens if I run out of daily CU quota?

If you keep sending RPC request even though you've reached the daily CU quota, the request will fail and you will receive http 429 error and an error code: -32005

Copy

{
   "jsonrpc":"2.0",
   "id":1,
   "error":{
      "code":-32005,
      "message":"ran out of cu"
   }
}

You may consider a subscription plan upgrade https://rpc.thunderstack.org/billing

What happens if I send a request with incorrect payload?

If you're sending a RPC request with an incorrect payload, it will cost:

• If incorrect method: it will cost you 2 usage for incorrect or unsupported RPC method.

• If other parameters are incorrect, or execution failed due to the wrong payload: it will consume the original cost of each method.

How much daily quota do I have?

We provide ThunderStack RPC users different tiers of daily quota according to their pricing plan. Please refer to our pricing plan.