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>
如需订阅,请通过 WebSocket 连接至:
text
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"
}'
您可以在 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 响应
400Missing API key、Invalid JSON-RPC request 或 JSON-RPC batch exceeds 256 calls
401Unauthorized API KEY
403Free 方案中的 WebSocket 连接
404/ 以外的路径
429已被限速,包括上文的 Free 方案限制:每 10 秒超过一个请求,或一个请求中包含两个或更多调用。retry-after 响应头给出等待秒数
502上游 RPC 请求无法完成
503服务暂时不可用
WebSocket 连接除上述状态码外,还会使用 101(协议升级已接受)。

Base RPC 方法和文档

有关标准方法、参数和规范的完整列表,请参阅官方文档。