Skip to Content
链与网络BNB Smart Chain

BNB Smart Chain

BNB Smart Chain Gateway 提供 EVM JSON-RPC 入口。Gas Token 为 BNB。

支持的网络

网络Chain IDJSON-RPC Host
Mainnet56bnb-jsonrpc
Testnet97bnb-testnet-jsonrpc

从控制台复制完整 Access Point,不要只根据 Host 自行拼接域名。

免 Endpoint 调用

Accelerator 缓存命中时,无需配置 Endpoint 即可调用 eth_blockNumbereth_getBlockByNumber([hexHeight, false])debug_traceBlockByNumber([hexHeight, {"tracer":"callTracer"}])。明确参数和缓存未命中行为见免 Endpoint 调用

配置完整方法访问

  1. 创建对应 BNB Smart Chain 网络的 Gateway。
  2. 通过 Provider 自动同步或手工添加同网络的 EVM Endpoint。
  3. 将 Endpoint 加入默认 JSON-RPC route,并完成 health check。
  4. 调用 eth_chainId 验证网络。
curl '<bsc_access_point>' \ -H 'Authorization: Bearer <app_api_key>' \ -H 'Content-Type: application/json' \ --data '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Mainnet 应返回 0x38,Testnet 应返回 0x61

eth_chainId 不属于 Accelerator 方法,因此该验证需要可用 Endpoint。

当前边界

  • 支持单条 EVM JSON-RPC over HTTP;不支持 batch、WebSocket 和公开 gRPC。
  • 不提供 BNB Smart Chain 专用 REST 接口。
  • debugtrace、Archive 和供应商扩展方法取决于上游 Endpoint。
  • Mainnet 与 Testnet 是独立路由,不会自动跨网络故障切换。

请求格式和错误处理见JSON-RPC错误与排查

Last updated on