ERPC

ERPC Avalanche RPC 端點文件

Avalanche RPC 端點文件

將 ERPC 作為您的 Avalanche RPC 端點，用於處理 HTTP JSON-RPC 請求與 WebSocket 訂閱。Avalanche RPC 是 ERPC 在 Global Edge Blockchain Infrastructure 中提供的 RPC APIs 之一，API key 可以在 ERPC Web Dashboard 中管理。
您可以直接使用與 Solana 和 Ethereum 相同的 RPC key。
請將您的 API key 新增到 'api-key' 參數中。

端點

將 JSON-RPC 2.0 請求以 HTTP POST 方式傳送至：
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
如需訂閱，請透過 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"]}
您可以在 ERPC Web Dashboard 上取得和檢視您的 API key。

批次請求

每次 HTTP 請求最多支援 256 個 JSON-RPC 批次呼叫，適用於 C-Chain 的 EVM 方法，同時也接受 JSON-RPC notification。Avalanche 的原生命名空間 — avax.*、avm.*、platform.*、proposervm.* 和 info.upgrades — 需要逐一呼叫。批次中的每次呼叫都會作為單獨的呼叫計量。

用量計量

用量依每次 JSON-RPC 呼叫的統一費率以 token 計量，所有 Avalanche RPC 方法費率相同。HTTP 批次請求中的每個項目，以及透過 WebSocket 連線傳送的每個 JSON-RPC 呼叫，都會單獨計量。您可以在 Avalanche RPC API 參考 中查看目前的單次呼叫 token 費率。

支援的方法

此端點涵蓋 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 回應
400缺少 API 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