ERPC Base RPC 端點文件
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 方法和文件
有關標準方法、參數和規範的完整列表,請參閱官方文件。






