Network RPC Endpoints
Public available Conflux Core Space network RPC endpoints
1. Confura
Confura is an Ethereum Infura equivalent public JSON-RPC service on Conflux network, which is developed and maintained by Conflux foundation.
Our public RPC services are located in different regions globally. By utilizing geographic DNS routing, developers can request the regional RPC services which are physically closest to them.
Public Endpoint
Hong Kong
| Network | Chain ID | Explorer | RPC Endpoint |
|---|---|---|---|
| Mainnet | 1029 | https://confluxscan.net | HTTP: https://main.confluxrpc.com Websocket: wss://main.confluxrpc.com/ws |
| Testnet | 1 | https://testnet.confluxscan.net | HTTP: https://test.confluxrpc.com Websocket: wss://test.confluxrpc.com/ws |
US East
| Network | Chain ID | Explorer | RPC Endpoint |
|---|---|---|---|
| Mainnet | 1029 | https://confluxscan.io | HTTP: https://main.confluxrpc.org Websocket: wss://main.confluxrpc.org/ws |
| Testnet | 1 | https://testnet.confluxscan.io | HTTP: https://test.confluxrpc.org Websocket: wss://test.confluxrpc.org/ws |
Rate Limits
Reference 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 to the endpoint for privileged access (eg.,
https://main.confluxrpc.com/<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 |
| cfx_getLogs | QPS < 5 | QPS < 20 | - |
| cfx_call | QPS < 5 | QPS < 50 | - |
| cfx_getBlockBy* | QPS < 5 | QPS < 20 | includes: cfx_getBlockByHash, cfx_getBlockByEpochNumber |
| cfx_getTransaction* | QPS < 5 | QPS < 20 | includes: cfx_getTransactionByHash, cfx_getTransactionReceipt |
| debug RPC | not supported | QPS < 20 | includes: cfx_getEpochReceipts etc. |
| trace RPC | not supported | QPS < 20 | includes: trace_block, trace_filter, trace_transaction |
| filter API | not supported | supported | includes: cfx_newFilter, cfx_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 epoch larger than to epoch) | |
| 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.
2. Unifra
Unifra is a Web3 developer platform focused on simplifying blockchain development. It has built a suite of developer tools, enhanced APIs, and a superior node infrastructure to seamlessly build and run blockchain applications. Unifra provide API services for multiple chains including Ethereum, BNB Smart Chain, Polygon and Conflux.
Unifra provides:
- Open access to free public end-points
- Real-time webhook alerts via Notify
- Best-in-class support and reliability / stability
- Unifra's NFT API
- Dashboard with Request Explorer
To use Unifra's service, developer need to register an account first and find the RPC endpoint in Unifra console. For detail infomation check Unifra's documentation
Public Endpoint
| Network | Chain ID | Explorer | Endpoint |
|---|---|---|---|
| Mainnet | 1029 | https://confluxscan.net | https://conflux-core-public.unifra.io |