网络 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.com | HTTP | |
https://cfxmain-china.confluxrpc.com | HTTP | 面向中国用户的 RPC 服务 |
https://cfxmain-global.confluxrpc.com | HTTP | 面向全球用户的 RPC 服务 |
https://main.confluxrpc.org | HTTP | 备用 RPC 服务 |
wss://main.confluxrpc.com/ws | Websocket | |
wss://main.confluxrpc.org/ws | Websocket | 备用 RPC 服务 |
Testnet
Conflux Core Space 测试网的链 ID 是 1(0x1)
。 相应的区块链浏览器 URL 是 https://testnet.confluxscan.io。
RPC 端点 | 类型 | 备注 |
---|---|---|
https://test.confluxrpc.com | HTTP | |
https://cfxtest.confluxrpc.com | HTTP | |
https://test.confluxrpc.org | HTTP | 备用 RPC 服务 |
wss://test.confluxrpc.com/ws | Websocket | |
wss://test.confluxrpc.org/ws | Websocket |
Rate Limits
为了保持服务的可用性,免费版本设有访问频率限制。 如果你需要更高级别的 RPC 服务,你可以通过 Web3 Paywall 进行购买,或者可以直接发送邮件到 bd@confluxnetwork.org 向 Conflux 基金会申请。
这里提供了各种费用等级及其访问速率限制的参考信息。
付费级别 | 价格 | Rate Limits | 购买链接 |
---|---|---|---|
免费 | $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的文档
公共端点
网络名称 | Chain ID | 浏览器网址 | 端点 |
---|---|---|---|
Mainnet | 1029 | https://confluxscan.net | https://conflux-core-public.unifra.io |