ERPC Base RPC エンドポイント ドキュメント
Base RPC エンドポイント ドキュメント
ERPC を Base RPC エンドポイントとして、HTTP JSON-RPC リクエストと WebSocket 購読にご利用いただけます。Base RPC は、Global Edge Blockchain Infrastructure における ERPC の RPC APIs の一部であり、API key は ERPC Web Dashboard から管理できます。
Solana、Ethereum、Avalanche と同じ RPC キーを利用できます。
api-key パラメータにあなたの API key を追加してください。エンドポイント
JSON-RPC 2.0 リクエストは、次の URL に対して HTTP POST で送信します。
text
https://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>購読の場合は、次の URL に 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"
}'API key は ERPC Web Dashboard 上にて取得、確認いただけます: ERPC Web Dashboard
バッチリクエスト
1 回の HTTP リクエストにつき最大 256 件までの JSON-RPC バッチに対応しています。バッチ内の各呼び出しは、それぞれ個別の呼び出しとして計測されます。
利用量の計測
利用量は JSON-RPC 呼び出しごとに token として計測されます。HTTP バッチ内の各エントリ、および WebSocket 接続経由で送信された各 JSON-RPC 呼び出しは、それぞれ個別に計測されます。
Free プランの制限
Free プランでは、お使いのアカウントから送信できるのは 10 秒に 1 リクエストまでです。この制限はエンドポイントごとではなくアカウントごとに数えられるため、別のチェーンへのリクエストも数えられることがあります。それより早く送ったリクエストには HTTP
429 が返され、retry-after ヘッダーに待機する秒数が示されます。Free プランでは、2 件以上の JSON-RPC 呼び出しを含むリクエストには HTTP
429 が返され、そのリクエストの呼び出しはどれも送信されません。それぞれの呼び出しには、コード -32041 の JSON-RPC エラーが返されます。代わりに、これらの呼び出しを 1 件ずつ送信してください。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 秒に 1 リクエストを超える送信、または 1 回のリクエストに 2 件以上の呼び出し）も対象です。retry-after ヘッダーが待機秒数を示します |
| 502 | アップストリームの RPC リクエストを完了できませんでした |
| 503 | サービスが一時的に利用できません |
WebSocket 接続では、上記のコードに加えて
101（プロトコルアップグレードを承認）が使用されます。Base RPC メソッドとドキュメント
標準メソッド、パラメータ、仕様の全一覧については、公式ドキュメントをご参照ください。