ERPC

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

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

ERPC を Avalanche RPC エンドポイントとして、HTTP JSON-RPC リクエストと WebSocket 購読にご利用いただけます。Avalanche RPC は、Global Edge Blockchain Infrastructure における ERPC の RPC APIs の一部であり、API key は ERPC Web Dashboard から管理できます。
Solana、Ethereum と同じ RPC キーを利用できます。
'api-key' パラメータにあなたの API key を追加してください。

エンドポイント

JSON-RPC 2.0 リクエストは、次の URL に対して HTTP POST で送信します。
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
購読の場合は、次の URL に WebSocket で接続します。
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
アップストリーム API は JSON-RPC のメソッド名そのもので選ばれるため、C-Chain、X-Chain、P-Chain の呼び出しはすべて同じエンドポイントに送られます。

使用例

HTTP リクエストの例です。
bash
curl https://edge.erpc.global/ava?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/ava?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

バッチリクエスト

C-Chain の EVM メソッドでは、1 回の HTTP リクエストにつき最大 256 件までの JSON-RPC バッチに対応しており、JSON-RPC notification も受け付けます。ネイティブ名前空間 — avax.*、avm.*、platform.*、proposervm.*、info.upgrades — は 1 件ずつの呼び出しになります。バッチ内の各呼び出しは、それぞれ個別の呼び出しとして計測されます。

利用量の計測

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

対応メソッド

本エンドポイントは、C-Chain の EVM JSON-RPC メソッドファミリー — eth_*、net_*、txpool_*、web3_* — をカバーしています。アカウント / ブロックの読み取り（eth_getBalance、eth_getBlockByNumber、eth_getLogs）、トランザクションフロー（eth_sendRawTransaction、eth_getTransactionReceipt）、手数料データ（eth_gasPrice、eth_maxPriorityFeePerGas）、コールシミュレーション（eth_call、eth_estimateGas）、フィルター（eth_newFilter、eth_getFilterChanges）、txpool の検査（txpool_status、txpool_content）、C-Chain 拡張（eth_getAssetBalance、eth_baseFee）、WebSocket 購読（eth_subscribe、eth_unsubscribe）が含まれます。
ネイティブ Avalanche API は同じエンドポイントから提供されます。C-Chain のアトミック操作（avax.getAtomicTx、avax.getUTXOs、avax.issueTx）、X-Chain（avm.getBalance、avm.getTx、avm.issueTx）、P-Chain（platform.getCurrentValidators、platform.getStake、platform.getHeight、platform.issueTx、proposervm.getProposedHeight）、ネットワークアップグレードのタイミング（info.upgrades）が含まれます。
リクエストとレスポンスの形式を含む完全なメソッド一覧は、Avalanche RPC API リファレンス をご覧ください。

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

HTTP ステータス意味
200アップストリームの JSON-RPC レスポンス
400API key が未指定、または無効な JSON-RPC リクエスト
401API key に権限がありません
429レート制限。retry-after ヘッダーが待機秒数を示します
502アップストリームの RPC リクエストを完了できませんでした
503サービスが一時的に利用できません
公開されているメソッド一覧に含まれない JSON-RPC メソッドには、HTTP 400 と JSON-RPC エラー -32601（Method not found）が返されます。256 件を超えるバッチには HTTP 400 が返されます。
WebSocket 接続では、上記のコードに加えて 101（プロトコルアップグレードを承認）と 426（WebSocket Upgrade ハンドシェイクが必要）が使用されます。

Avalanche RPC メソッドとドキュメント

標準メソッド、パラメータ、サブスクリプション仕様の全一覧については、公式ドキュメントをご参照ください。HTTP と WebSocket 両方の利用方法がまとめられています。

前へ

ERPC Avalanche RPC クイックスタート

次へ

SLV AI