ERPC Ethereum RPC エンドポイントドキュメント

Ethereum RPC エンドポイントドキュメント

ERPC を Ethereum RPC エンドポイントとして、HTTP JSON-RPC リクエストと WebSocket 購読にご利用いただけます。Ethereum RPC は、Global Edge Blockchain Infrastructure における ERPC の RPC APIs の一部であり、API key は ERPC Web Dashboard から管理できます。

Solana と同じ RPC キーを利用できます。

'api-key' パラメータにあなたの API key を追加してください。

エンドポイント

JSON-RPC 2.0 リクエストは、次の URL に対して HTTP POST で送信します。

text

https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

購読の場合は、次の URL に WebSocket で接続します。

text

wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

使用例

HTTP リクエストの例です。

bash

curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'

curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'

WebSocket 購読の例です。

bash

wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}

wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}

API key は ERPC Web Dashboard 上にて取得、確認いただけます: ERPC Web Dashboard

バッチリクエスト

1 回の HTTP リクエストにつき最大 256 件までの JSON-RPC バッチに対応しており、JSON-RPC notification も受け付けます。バッチ内の各呼び出しは、それぞれ個別の呼び出しとして計測されます。

利用量の計測

利用量は JSON-RPC 呼び出し 1 回あたり一律のレートで token として計測され、すべての Ethereum RPC メソッドで同一のレートが適用されます。HTTP バッチ内の各エントリ、および WebSocket 接続経由で送信された各 JSON-RPC 呼び出しは、それぞれ個別に計測されます。現在の呼び出し単価（token レート）は Ethereum RPC API リファレンスでご確認いただけます。

対応メソッド

本エンドポイントは、標準の Ethereum JSON-RPC メソッドファミリー — eth_*、net_*、txpool_*、web3_* — をカバーしています。アカウント / ブロックの読み取り（eth_getBalance、eth_getBlockByNumber、eth_getLogs）、トランザクションフロー（eth_sendRawTransaction、eth_getTransactionReceipt）、手数料データ（eth_feeHistory、eth_maxPriorityFeePerGas）、コールシミュレーション（eth_call、eth_callMany、eth_simulateV1）、ステートプルーフ（eth_getProof）、フィルター（eth_newFilter、eth_getFilterChanges）、txpool の検査（txpool_status、txpool_content）、WebSocket 購読（eth_subscribe、eth_unsubscribe）が含まれます。

リクエストとレスポンスの形式を含む完全なメソッド一覧は、Ethereum RPC API リファレンスをご覧ください。

レスポンスステータスコード

HTTP ステータス	意味
200	アップストリームの JSON-RPC レスポンス
400	無効な JSON-RPC リクエスト
401	API key が未指定、または権限がありません
429	ダウンストリーム RPC のポリシーによるレート制限
502	プロキシが利用できません
503	ダウンストリームの RPC サービスが利用できません