跳到主要内容

网络 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.io。

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://test.confluxscan.io。

RPC 端点类型备注
https://test.confluxrpc.comHTTP
https://cfxtest.confluxrpc.comHTTP
https://test.confluxrpc.orgHTTP备用 RPC 服务
wss://test.confluxrpc.org/comWebsocket
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 等。
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 提供的区块哈希
无效的区块范围(从 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