Dokumentasi Avalanche RPC Endpoint | ERPC

Dokumentasi Avalanche RPC Endpoint

Gunakan ERPC sebagai endpoint RPC Avalanche Anda untuk HTTP JSON-RPC request dan WebSocket subscription. Avalanche RPC adalah bagian dari RPC APIs ERPC di dalam Global Edge Blockchain Infrastructure kami, dan API key dapat dikelola dari ERPC Web Dashboard.
Anda dapat menggunakan RPC key yang sama dengan Solana dan Ethereum.
Tambahkan API key Anda ke parameter api-key.

Endpoint

Kirim request JSON-RPC 2.0 sebagai HTTP POST ke:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Untuk subscription, hubungkan melalui WebSocket ke:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
API upstream dipilih berdasarkan nama method JSON-RPC yang tepat, sehingga panggilan C-Chain, X-Chain, dan P-Chain semuanya menuju endpoint yang sama.

Contoh

Berikut adalah contoh HTTP request.
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"
}'
Berikut adalah contoh WebSocket subscription.
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"]}
Anda dapat membuat dan memeriksa API key Anda di ERPC Web Dashboard: ERPC Web Dashboard

Batch Request

JSON-RPC batch hingga 256 panggilan per HTTP request didukung untuk method EVM C-Chain, dan JSON-RPC notification juga diterima. Namespace native Avalanche — avax.*, avm.*, platform.*, proposervm.*, dan info.upgrades — dipanggil satu per satu. Setiap panggilan dalam satu batch diukur sebagai panggilan tersendiri.

Pengukuran Penggunaan

Penggunaan diukur dalam token dengan tarif tetap per panggilan JSON-RPC — tarif yang sama untuk setiap method Avalanche RPC. Setiap entri dalam satu HTTP batch dan setiap panggilan JSON-RPC yang dikirim melalui koneksi WebSocket diukur secara terpisah. Anda dapat memeriksa tarif token per panggilan saat ini di Referensi API Avalanche RPC.

Method yang Didukung

Endpoint ini mencakup keluarga method JSON-RPC EVM C-Chain — eth_*, net_*, txpool_*, dan web3_* — termasuk pembacaan akun dan block (eth_getBalance, eth_getBlockByNumber, eth_getLogs), alur transaksi (eth_sendRawTransaction, eth_getTransactionReceipt), data fee (eth_gasPrice, eth_maxPriorityFeePerGas), simulasi panggilan (eth_call, eth_estimateGas), filter (eth_newFilter, eth_getFilterChanges), inspeksi txpool (txpool_status, txpool_content), ekstensi C-Chain (eth_getAssetBalance, eth_baseFee), dan WebSocket subscription (eth_subscribe, eth_unsubscribe).
API native Avalanche juga dilayani dari endpoint yang sama: operasi atomik 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), dan waktu upgrade jaringan (info.upgrades).
Untuk daftar method lengkap dengan bentuk request dan response, lihat Referensi API Avalanche RPC.

Kode Status Response

HTTP statusArti
200Response JSON-RPC dari upstream.
400API key tidak ada, atau request JSON-RPC tidak valid.
401API key tidak diotorisasi.
429Dibatasi rate. Header retry-after menunjukkan waktu tunggu dalam detik.
502Request RPC upstream tidak dapat diselesaikan.
503Layanan tidak tersedia sementara.
Method JSON-RPC di luar katalog yang dipublikasikan dijawab dengan HTTP 400 dan error JSON-RPC -32601 (Method not found), dan batch di atas 256 panggilan dijawab dengan HTTP 400.
Koneksi WebSocket menggunakan 101 (peningkatan protokol diterima) dan 426 (diperlukan handshake WebSocket Upgrade) selain kode di atas.

Metode dan Dokumentasi Avalanche RPC

Untuk daftar lengkap metode, parameter, dan spesifikasi subscription, lihat dokumentasi resmi. Dokumentasi tersebut mencakup penggunaan HTTP dan WebSocket.