跳到主要内容

网络 RPC 端点

提示

本页面列出了 Conflux eSpace 的公共 RPC 端点。 Public RPC endpoints for Conflux Core Space is provided here.

Confura​

Confura 是由 Conflux 基金会提供的公共 RPC 服务，可以免费使用。

公共端点​

Confura 为主网和测试网提供了多个可用的 RPC 端点。 我们已根据选定的优先级对它们进行排序，并提供了简要描述。 如果您不确定选择哪一个，请选择列表顶部附近的 RPC 端点。

主网​

Conflux eSpace 主网的链 ID 为 1030(0x406)。 相应的区块链浏览器 URL 是 https://evm.confluxscan.org。

RPC 端点类型备注
https://evm.confluxrpc.comHTTP
https://evmmain-china.confluxrpc.comHTTP针对中国用户的 RPC 服务
https://evmmain-global.confluxrpc.comHTTP针对全球用户的 RPC 服务
https://evm.confluxrpc.orgHTTP备用 RPC 服务
wss://evm.confluxrpc.com/wsWebsocket
wss://evm.confluxrpc.org/wsWebsocket备用 RPC 服务

测试网​

Conflux eSpace 测试网的链 ID 为 71(0x47)。 相应的区块链浏览器 URL 是 https://evmtestnet.confluxscan.org。

RPC 端点类型备注
https://evmtestnet.confluxrpc.comHTTP
https://evmtest.confluxrpc.comHTTP
https://evmtestnet.confluxrpc.orgHTTP备用 RPC 服务
wss://evmtestnet.confluxrpc.com/wsWebsocket
wss://evmtestnet.confluxrpc.org/wsWebsocket

速率限制​

为了保持服务的可用性，免费版本设有访问频率限制。 如果你需要更高级别的 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每秒请求数< 20includes:
eth_getBlockByHash,
eth_getBlockByNumber
eth_getTransaction*每秒请求数< 5每秒请求数< 20includes:
eth_getTransactionByHash,
eth_getTransactionReceipt
debug RPC暂不支持每秒请求数< 20includes:
parity_getBlockReceipts etc.
trace RPC暂不支持每秒请求数< 20包括：
trace_block, trace_filter, trace_transaction
filter API暂不支持支持includes:
eth_newFilter, eth_getFilterChanges etc.

A diagnostic method diagnostic_getRateLimitStatus has been provided for users to check their current rate-limit status.

Usage Example:

curl --location 'https://evm.confluxrpc.com/<api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "jsonrpc":"2.0",
  "method":"diagnostic_getRateLimitStatus",
  "params":[],
  "id":1
}'

常见错误​

If you encounter RPC-related issues that are not covered above, refer to the common error cases below.

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)"
    }
}

Authentication related errors:

Message备注
invalid api keyThe provided key is malformed or unrecognized.
api key is already expiredThe key is no longer valid and cannot be used for requests.

Encountering such errors, please either upgrade to a higher-tier plan via the Web3 paywall or proceed without using an API key.

限流相关错误：

消息注释
每日请求限额超标：请求过多（超过 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 基金会申请。