Skip to Content

Base

Base Gateway 提供 EVM JSON-RPC 入口。Gas Token 为 ETH。

支持的网络

网络Chain IDJSON-RPC Host
Mainnet8453base-jsonrpc
Sepolia84532base-sepolia-jsonrpc

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

免 Endpoint 调用

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

配置完整方法访问

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

Mainnet 应返回 0x2105,Sepolia 应返回 0x14a34

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

当前边界

  • 支持单条 EVM JSON-RPC over HTTP;不支持 batch、WebSocket 和公开 gRPC。
  • Gateway 不提供 Base 专用 REST 接口。
  • Base 特有方法、trace 和历史状态是否可用取决于上游 Endpoint。
  • Mainnet 与 Sepolia 使用独立 Gateway 和 route,不会跨网络故障切换。

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

Last updated on