网络 RPC 端点
This page lists the public RPC endpoints for Conflux eSpace. Public RPC endpoints for Conflux Core Space is provided here.
Confura
Confura 是由 Conflux 基金会提供的公共 RPC 服务，可以免费使用。
Public Endpoints
Confura为主网和测试网提供了多个可用的RPC端点。 我们按照“优先选择前者”的原则对它们进行了排序，并提供了简要描述。 如果您不确定选择哪一个，请优先选择列表顶部的 RPC 端点。
主网
Chain ID for Conflux eSpace Mainnet is 1030(0x406). The corresponding blockchain explorer URL is https://evm.confluxscan.io.
| RPC 端点 | 类型 | 备注 |
|---|---|---|
| https://evm.confluxrpc.com | HTTP | |
| https://evmmain-china.confluxrpc.com | HTTP | 面向中国用户的 RPC 服务 |
| https://evmmain-global.confluxrpc.com | HTTP | 面向全球用户的 RPC 服务 |
| https://evm.confluxrpc.org | HTTP | 备用 RPC 服务 |
| wss://evm.confluxrpc.com/ws | Websocket | |
| wss://evm.confluxrpc.org/ws | Websocket | 备用 RPC 服务 |
测试网
Chain ID for Conflux eSpace Mainnet is 71(0x47). The corresponding blockchain explorer URL is https://evmtestnet.confluxscan.io.
| RPC 端点 | 类型 | 备注 |
|---|---|---|
| https://evmtestnet.confluxrpc.com | HTTP | |
| https://evmtest.confluxrpc.com | HTTP | |
| https://evmtestnet.confluxrpc.org | HTTP | 备用 RPC 服务 |
| wss://evmtestnet.confluxrpc.com/ws | Websocket | |
| wss://evmtestnet.confluxrpc.org/ws | Websocket |
速率限制
为了保持服务的可用性，免费版本设有访问频率限制。 如果你需要更高级别的 RPC 服务，你可以通过 Web3 Paywall 进行购买，或者可以直接发送邮件到 bd@confluxnetwork.org 向 Conflux 基金会申请。
这里提供了各种费用等级及其访问速率限制的参考信息。
| 付费级别 | 价格 | 速率限制 | 购买链接 |
|---|---|---|---|
| 免费 | $0 | 每秒 50 次调用，每天最多100,000次 调用 | - |
| 标准 | 150 美元/月 | 每秒 100 次调用，每天最多 1,000,000 次调用 | mainnet testnet |
| 企业用户 | 请发邮件至 bd@confluxnetwork.org | 按需定制 | - |
备注
getLogs调用的结果集最大大小为10,000。- 由于数据裁剪，旧的存档事件日志可能无法访问。
- 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>); - 每个RPC方法也有速率限制，请查阅以下规范以了解更多详细信息。
速率限制细则
| RPC 方法 | 免费级别 | 标准级别 | 注释 |
|---|---|---|---|
| 全部 | 每秒请求数< 50； 每日总数 < 100,000 | 每秒请求数< 100； 每日总数 < 100,0000 | RPC 请求总数 |
| eth_getLogs | 每秒请求数< 5 | 每秒请求数< 20 | - |
| eth_call | 每秒请求数< 5 | 每秒请求数< 50 | - |
| eth_getBlockBy* | 每秒请求数< 5 | 每秒请求数< 20 | includes: eth_getBlockByHash, eth_getBlockByNumber |
| eth_getTransaction* | 每秒请求数< 5 | 每秒请求数< 20 | includes: eth_getTransactionByHash, eth_getTransactionReceipt |
| debug RPC | 暂不支持 | 每秒请求数< 20 | includes: parity_getBlockReceipts etc. |
| trace RPC | 暂不支持 | 每秒请求数< 20 | 包括： trace_block, trace_filter, trace_transaction |
| filter API | 暂不支持 | 支持 | includes: eth_newFilter, eth_getFilterChanges etc. |
Confura Common Errors
Confura 服务存在一些特有错误，这些错误并不是因为 Conflux-rust 客户端 RPC 而导致的。
常见错误响应格式：
{
"id": 123,
"jsonrpc": "2.0",
"error": {
"code": -32000,
"message": "daily request limit exceeded: Too many requests (exceeds 100000)"
}
}
限流相关错误：
| 消息 | 注释 |
|---|---|
| 每日请求限额超标：请求过多（超过 100000） | |
| 访问被白名单拒绝 | 请求的方法仅在 VIP 服务中可用。 |
| 允许的 qps 超标：请求量过多，并发请求量超过了 50 |
遇到此类错误，请通过 web3 支付墙购买更高级别的服务。
getLogs 相关错误：
| 消息 | 注释 |
|---|---|
| 事件日志太旧（已被裁剪） | |
| 筛选器必须提供以下之一：(1) 一个通过 fromEpoch 和 toEpoch 提供的纪元范围，(2) 一个通过 fromBlock 和 toBlock 提供的区块号范围，(3) 一组通过 blockHashes 提供的区块哈希 | |
| 无效的区块范围（从 block 大于到 block) | |
| 筛选器必须提供以下之一：(1) 一个通过 fromBlock 和 toBlock 提供的区块号范围，(2) 一组通过 blockHash 提供的区块哈希 | |
| filter.block_hashes 最多可以包含 32 个哈希；提供了 xxx 个。 | |
| filter.address 最多可以包含 32 个地址；提供了 xxx 个。 | |
| filter.topics 必须是不超过 4 维的数组；提供了 xxx 个。 | |
| filter.topics 每维最多可以包含 32 个主题；提供了 xxx 个。 | |
| 查询集太大，请缩小筛选条件 | |
| 要查询的结果集太大，超过 10000 条日志，请缩小筛选条件 | |
| 未找到筛选器 |
服务错误：
| 消息 | 注释 |
|---|---|
| 没有可用的全节点 | |
| 订阅代理错误 | |
| 查询超时，持续时间超过 3 秒 | |
| 服务器繁忙，请稍后再试 | |
| RPC 中间件崩溃 |
此类错误表明存在由 Confura 服务引起的问题。 请稍后再试或联系服务提供者。
商业 RPC 服务
有许多商业性的 RPC 服务提供商, 您可以点击 这里 查看
常见问题解答
如何获取 Confura 高级 API 密钥？
Confura 是由 Conflux 基金会提供的公共 RPC 服务，可以免费使用。 对于免费级别，您不需要 API 密钥。 要获 取更高级别的 RPC 服务，您可以在 Web3 Paywall 上进行购买，或者发送邮件到 bd@confluxnetwork.org 向 Conflux 基金会申请。