Base RPC 端点文档 - ERPC
Base RPC 端点文档
将 ERPC 用作您的 Base RPC 端点,处理 HTTP JSON-RPC 请求和 WebSocket 订阅。Base RPC 是 ERPC 在 Global Edge Blockchain Infrastructure 中提供的 RPC APIs 之一,API key 可以在 ERPC Web Dashboard 中管理。
您可以直接使用与 Solana、Ethereum 和 Avalanche 相同的 RPC key。
请将您的 API key 添加到
api-key 参数中。端点
将 JSON-RPC 2.0 请求以 HTTP POST 方式发送至:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>如需订阅,请通过 WebSocket 连接至:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>wss://base.erpc.global?api-key=<YOUR_API_KEY>仅接受发往
/ 的请求。示例
以下是 HTTP 请求示例。
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'您可以在 ERPC Web Dashboard 获取和查看 API key。
批量请求
每次 HTTP 请求最多支持 256 个 JSON-RPC 批量调用。批次中的每次调用都会作为单独的调用计量。
用量计量
用量按每次 JSON-RPC 调用以 token 计量。HTTP 批量请求中的每个条目,以及通过 WebSocket 连接发送的每个 JSON-RPC 调用,都会单独计量。
Free 方案限制
在 Free 方案中,您的账户每 10 秒可以发送一个请求。该限制按账户计算,而不是按端点计算,因此发往另一条链的请求也可能计入该限制。过早发送的请求会收到 HTTP
429 响应,retry-after 响应头给出以秒为单位的等待时间。在 Free 方案中,包含两个或更多 JSON-RPC 调用的请求会收到 HTTP
429 响应,且其中的调用都不会被发送:每个调用都会收到错误码为 -32041 的 JSON-RPC 错误。请改为逐个发送这些调用。在 Free 方案中,WebSocket 连接不可用,会收到 HTTP
403 响应。支持的方法
Base 兼容 EVM,使用与 Ethereum 相同的 JSON-RPC 方法。ERPC 不对 Base 端点设置固定的方法允许列表。有关 Ethereum 方法族,请参阅 Ethereum RPC 端点文档。
响应状态码
| HTTP 状态码 | 含义 |
|---|---|
| 200 | 上游 JSON-RPC 响应 |
| 400 | Missing API key、Invalid JSON-RPC request 或 JSON-RPC batch exceeds 256 calls |
| 401 | Unauthorized API KEY |
| 403 | Free 方案中的 WebSocket 连接 |
| 404 | / 以外的路径 |
| 429 | 已被限速,包括上文的 Free 方案限制:每 10 秒超过一个请求,或一个请求中包含两个或更多调用。retry-after 响应头给出等待秒数 |
| 502 | 上游 RPC 请求无法完成 |
| 503 | 服务暂时不可用 |
WebSocket 连接除上述状态码外,还会使用
101(协议升级已接受)。Base RPC 方法和文档
有关标准方法、参数和规范的完整列表,请参阅官方文档。






