ERPC

Avalanche RPC endpoint documentatie | ERPC

Avalanche RPC endpoint documentatie

Gebruik ERPC als uw Avalanche RPC endpoint voor HTTP JSON-RPC-verzoeken en WebSocket-abonnementen. Avalanche RPC maakt deel uit van de RPC APIs van ERPC binnen onze Global Edge Blockchain Infrastructure, en de API key kan worden beheerd via het ERPC Web Dashboard.
U kunt dezelfde RPC key als Solana en Ethereum gebruiken.
Voeg uw API key toe aan de 'api-key'-parameter.

Endpoints

Verstuur JSON-RPC 2.0-verzoeken als HTTP POST naar:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Voor abonnementen maakt u verbinding via WebSocket met:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
De upstream API wordt bepaald aan de hand van de exacte JSON-RPC-methodenaam, zodat aanroepen voor de C-Chain, X-Chain en P-Chain allemaal naar hetzelfde endpoint gaan.

Voorbeelden

Hier is een HTTP-verzoekvoorbeeld.
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"
}'
Hier is een WebSocket-abonnementsvoorbeeld.
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"]}
U kunt uw API key verkrijgen en controleren in het ERPC Web Dashboard: ERPC Web Dashboard

Batch-verzoeken

JSON-RPC-batches van maximaal 256 aanroepen per HTTP-verzoek worden ondersteund voor C-Chain EVM-methoden, en JSON-RPC-notificaties worden eveneens geaccepteerd. De native Avalanche-namespaces — avax.*, avm.*, platform.*, proposervm.* en info.upgrades — worden één voor één aangeroepen. Elke aanroep in een batch wordt gemeten als een eigen aanroep.

Tokengebruik

Het gebruik wordt gemeten in tokens tegen een vast tarief per JSON-RPC-aanroep — hetzelfde tarief voor elke Avalanche RPC-methode. Elke invoer in een HTTP-batch en elke JSON-RPC-aanroep die via een WebSocket-verbinding wordt verstuurd, wordt afzonderlijk gemeten. Het huidige tokentarief per aanroep vindt u in de Avalanche RPC API-referentie.

Ondersteunde methodes

Het endpoint dekt de C-Chain EVM JSON-RPC-methodefamilies — eth_*, net_*, txpool_* en web3_* — waaronder account- en bloklezingen (eth_getBalance, eth_getBlockByNumber, eth_getLogs), transactieverloop (eth_sendRawTransaction, eth_getTransactionReceipt), fee-gegevens (eth_gasPrice, eth_maxPriorityFeePerGas), call-simulatie (eth_call, eth_estimateGas), filters (eth_newFilter, eth_getFilterChanges), txpool-inspectie (txpool_status, txpool_content), de C-Chain-extensies (eth_getAssetBalance, eth_baseFee) en WebSocket-abonnementen (eth_subscribe, eth_unsubscribe).
De native Avalanche-API's worden vanaf hetzelfde endpoint bediend: C-Chain atomic operations (avax.getAtomicTx, avax.getUTXOs, avax.issueTx), de X-Chain (avm.getBalance, avm.getTx, avm.issueTx), de P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight) en netwerkupgradetijden (info.upgrades).
Voor de volledige methodelijst met verzoek- en antwoordstructuren, zie de Avalanche RPC API-referentie.

Antwoordstatuscodes

HTTP-statusBetekenis
200Upstream JSON-RPC-respons.
400Ontbrekende API key, of een ongeldig JSON-RPC-verzoek.
401Ongeautoriseerde API key.
429Rate-limited. De retry-after-header geeft de wachttijd in seconden aan.
502Het upstream RPC-verzoek kon niet worden voltooid.
503De service is tijdelijk niet beschikbaar.
Een JSON-RPC-methode die niet in de gepubliceerde catalogus voorkomt, wordt beantwoord met HTTP 400 en JSON-RPC-fout -32601 (Method not found), en een batch van meer dan 256 aanroepen wordt beantwoord met HTTP 400.
WebSocket-verbindingen gebruiken naast de bovenstaande codes ook 101 (protocol-upgrade geaccepteerd) en 426 (een WebSocket Upgrade-handshake is vereist).

Avalanche RPC-methoden en documentatie

Voor de volledige lijst van standaardmethoden, parameters en abonnementsspecificaties verwijzen wij u naar de officiële documentatie. Deze behandelt zowel HTTP- als WebSocket-gebruik.

Vorige

Avalanche RPC - Snelstart

Volgende

SLV AI