跳到主要内容

网络 RPC 端点

公开可用的 Conflux Core 空间网络 RPC 端点

提示

Conflux eSpace 的公共 RPC 端点信息可在此处获取。

1. Confura​

Confura是Conflux网络上的一个类似于Ethereum Infura的公共JSON-RPC服务，由Conflux基金会开发和维护，并可免费使用。

公共端点​

Confura为主网和测试网提供了多个可用的RPC端点。 我们按照“优先选择前者”的原则对它们进行了排序，并提供了简要描述。 如果您不确定选择哪一个，请优先选择列表顶部的 RPC 端点。

主网​

Conflux Core space 主网的链 ID 是 1029(0x405)。 相应的区块链浏览器 URL 是 https://confluxscan.org。

RPC 端点类型说明
https://main.confluxrpc.comHTTP
https://cfxmain-china.confluxrpc.comHTTP面向中国用户的 RPC 服务
https://cfxmain-global.confluxrpc.comHTTP面向全球用户的 RPC 服务
https://main.confluxrpc.orgHTTP备用 RPC 服务
wss://main.confluxrpc.com/wsWebsocket
wss://main.confluxrpc.org/wsWebsocket备用 RPC 服务

测试网​

Conflux Core Space 测试网的链 ID 是 1(0x1)。 相应的区块链浏览器 URL 是 https://testnet.confluxscan.org。

RPC 端点类型备注
https://test.confluxrpc.comHTTP
https://cfxtest.confluxrpc.comHTTP
https://test.confluxrpc.orgHTTP备用 RPC 服务
wss://test.confluxrpc.com/wsWebsocket
wss://test.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。
  • 由于数据裁剪，旧的存档事件日志可能无法访问。
  • 请将您的 Api 密钥附加到端点上以获取特权访问（例如：https://main.confluxrpc.com/<api-key>）。
  • 每个RPC方法也有速率限制，请查阅以下规范以了解更多详细信息。
速率限制细则
RPC 方法免费级别标准级别注释
全部每秒请求数< 50；
每日总数 < 100,000		每秒请求数< 100；
每日总数 < 100,0000		RPC 请求总数
cfx_getLogs每秒请求数< 5每秒请求数< 20-
cfx_call每秒请求数< 5每秒请求数< 50-
cfx_getBlockBy*每秒请求数< 5每秒请求数< 20包括：
cfx_getBlockByHash,
cfx_getBlockByEPochNumber
cfx_getTransaction*每秒请求数< 5每秒请求数< 20包括：
cfx_getTransactionByHash,
cfx_getTransactionreceipt
debug RPC暂不支持每秒请求数< 20包括：
cfx_getEpochreceips 等。
trace RPC暂不支持每秒请求数< 20包括：
trace_block, trace_filter, trace_transaction
filter API暂不支持支持包括：
cfx_newFilter, cfx_getFilterChanges 等。

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

Usage Example:

curl --location 'https://main.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 提供的区块哈希
无效的区块范围（从 epoch 大于到 epoch)
筛选器必须提供以下之一：(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 服务引起的问题。 请稍后再试或联系服务提供者。

2. Unifra​

Unifra是一个专注于简化区块链开发的Web3开发者平台。 它建立了一套开发者工具，增强了API，以及一个卓越的节点基础设施，以无缝构建和运行区块链应用程序。 Unifra 为多个链提供 API 服务，包括 以太坊、BNB 智能链、Polygon 和 Conflux。

Unifra提供：

  • 开放访问免费的公共端点
  • 通过Notify提供实时的webhook提醒
  • 一流的支持和可靠性/稳定性
  • Unifra的NFT API
  • 带有请求浏览器的仪表板

要使用Unifra的服务，开发者需要先注册一个账户，并在Unifra 控制台中找到RPC端点。 详情请查看 Unifra的文档

公共端点​

网络名称链 ID浏览器网址端点
主网1029https://confluxscan.nethttps://conflux-core-public.unifra.io