Network RPC Endpoints
This page lists the public RPC endpoints for Conflux eSpace. Public RPC endpoints for Conflux Core Space is provided here.
Confura
Confura, a public RPC service offered by the Conflux Foundation, is available for free use.
Public Endpoints
Confura provides several available RPC endpoints for the mainnet and testnet. We have sorted them by selected priority and provided brief descriptions. If you are unsure which one to choose, please select an RPC endpoint near the top of the list.
Mainnet
Chain ID for Conflux eSpace Mainnet is 1030(0x406). The corresponding blockchain explorer URL is https://evm.confluxscan.io.
| RPC Endpoint | Type | Notes |
|---|---|---|
| https://evm.confluxrpc.com | HTTP | |
| https://evmmain-china.confluxrpc.com | HTTP | RPC Service for China Users |
| https://evmmain-global.confluxrpc.com | HTTP | RPC Service for Global Users |
| https://evm.confluxrpc.org | HTTP | Backup RPC Service |
| wss://evm.confluxrpc.com/ws | Websocket | |
| wss://evm.confluxrpc.org/ws | Websocket | Backup RPC Service |
Testnet
Chain ID for Conflux eSpace Mainnet is 71(0x47). The corresponding blockchain explorer URL is https://evmtestnet.confluxscan.io.
| RPC Endpoint | Type | Notes |
|---|---|---|
| https://evmtestnet.confluxrpc.com | HTTP | |
| https://evmtest.confluxrpc.com | HTTP | |
| https://evmtestnet.confluxrpc.org | HTTP | Backup RPC Service |
| wss://evmtestnet.confluxrpc.com/ws | Websocket | |
| wss://evmtestnet.confluxrpc.org/ws | Websocket |
Rate Limits
To maintain the service's usability, there are rate limits in place for the free tier. For access to a higher tier of RPC service, you can make a purchase through the Web3 Paywall, or you can apply directly to the Conflux Foundation by emailing bd@confluxnetwork.org.
Here are references for various fee tiers and their rate limits.
| Fee Tier | Price | Rate Limits | Buy Links |
|---|---|---|---|
| Free | $0 | 50 calls/second, up to 100,000 calls/day | - |
| Standard | $150/mo | 100 calls/second, up to 1,000,000 calls/day | mainnet testnet |
| Enterprise | please inquire bd@confluxnetwork.org | customize on demand | - |
Notes
- Maximum result-set size is 10,000 for
getLogscall; - Old archived event logs may be inaccessible due to data prune;
- Append your api key(get from Web3 Paywall or Conflux Foundation) to the endpoint for privileged access (eg.,
https://evm.confluxrpc.com/<mainnet-api-key>or for testnet,https://evmtestnet.confluxrpc.org/<testnet-api-key>); - Rate limits are also imposed per RPC method, please check the following specification for more details.
Rate Limit Specification
| RPC Method | Free tier | Standard Tier | Comment |
|---|---|---|---|
| all | QPS < 50; daily total < 100k | QPS < 100; daily total < 1million | overall RPC requests |
| eth_getLogs | QPS < 5 | QPS < 20 | - |
| eth_call | QPS < 5 | QPS < 50 | - |
| eth_getBlockBy* | QPS < 5 | QPS < 20 | includes: eth_getBlockByHash, eth_getBlockByNumber |
| eth_getTransaction* | QPS < 5 | QPS < 20 | includes: eth_getTransactionByHash, eth_getTransactionReceipt |
| debug RPC | not supported | QPS < 20 | includes: parity_getBlockReceipts etc. |
| trace RPC | not supported | QPS < 20 | includes: trace_block, trace_filter, trace_transaction |
| filter API | not supported | supported | includes: eth_newFilter, eth_getFilterChanges etc. |
Confura Common Errors
The Confura service have some proprietary errors, these errors are not part of the Conflux-rust client RPC implementation.
common error response format:
{
"id": 123,
"jsonrpc": "2.0",
"error": {
"code": -32000,
"message": "daily request limit exceeded: Too many requests (exceeds 100000)"
}
}
Rate Limit related errors:
| message | note |
|---|---|
| daily request limit exceeded: Too many requests (exceeds 100000) | |
| access forbidden by allowlists | The requested method is only available in the VIP service. |
| allowed qps exceeded: Too many requests, exceeds 50 at a time |
Encountering such errors, please purchase a higher-tier service through the web3 paywall.
getLogs related errors:
| message | note |
|---|---|
| event logs are too stale (already pruned) | |
| Filter must provide one of the following: (1) an epoch range through fromEpoch and toEpoch, (2) a block number range through fromBlock and toBlock, (3) a set of block hashes through blockHashes | |
| invalid block range (from block larger than to block) | |
| Filter must provide one of the following: (1) a block number range through fromBlock and toBlock, (2) a set of block hashes through blockHash | |
| filter.block_hashes can contain up to 32 hashes; xxx were provided. | |
| filter.address can contain up to 32 addresses; xxx were provided. | |
| filter.topics must be no more than 4-dimensional array; xxx were provided. | |
| filter.topics can contain up to 32 topics per dimension; xxx were provided. | |
| query set is too large, please narrow down your filter condition | |
| result set to be queried is too large with more than 10000 logs, please narrow down your filter condition | |
| filter not found |
service errors:
| message | note |
|---|---|
| no full node available | |
| subscription proxy error | |
| query timeout with duration exceeds 3s | |
| server is too busy, please try again later | |
| RPC middleware crashed |
This type of error indicates an issue with the Confura service. Please try again later or contact the service provider.
Commercial RPC Service
There are couple of commercial RPC service providers, you can check them here
FAQs
How to get a Confura advanced API key?
Confura is a public RPC service provided by Conflux Foundation, it is free to use. For using the free tier, you don't need an API key. To get a higher tier RPC service, you can buy it at Web3 Paywall or apply from Conflux foundation by sending email to bd@confluxnetwork.org.