ERPC

Documentazione dell'endpoint RPC di Avalanche | ERPC

Documentazione dell'endpoint RPC di Avalanche

Usa ERPC come tuo endpoint RPC di Avalanche per richieste HTTP JSON-RPC e sottoscrizioni WebSocket. Avalanche RPC fa parte delle RPC APIs di ERPC all'interno della nostra Global Edge Blockchain Infrastructure, e la chiave API può essere gestita dalla ERPC Web Dashboard.
Puoi usare la stessa chiave RPC di Solana ed Ethereum.
Aggiungi la tua chiave API al parametro 'api-key'.

Endpoint

Invia richieste JSON-RPC 2.0 come HTTP POST a:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Per le sottoscrizioni, connettiti via WebSocket a:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
L'API upstream viene selezionata in base al nome esatto del metodo JSON-RPC, quindi le chiamate C-Chain, X-Chain e P-Chain vanno tutte allo stesso endpoint.

Esempi

Ecco un esempio di richiesta 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"
}'
Ecco un esempio di sottoscrizione 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"]}
Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard

Richieste in batch

Sono supportati batch JSON-RPC fino a 256 chiamate per richiesta HTTP per i metodi EVM della C-Chain, e sono accettate anche le notifiche JSON-RPC. I namespace nativi di Avalanche — avax.*, avm.*, platform.*, proposervm.* e info.upgrades — vengono chiamati uno alla volta. Ogni chiamata in un batch viene misurata come chiamata a sé stante.

Utilizzo dei token

L'utilizzo viene misurato in token a una tariffa fissa per chiamata JSON-RPC — la stessa tariffa per ogni metodo Avalanche RPC. Ogni voce in un batch HTTP e ogni chiamata JSON-RPC inviata su una connessione WebSocket viene misurata separatamente. Puoi verificare la tariffa attuale in token per chiamata nel Riferimento API Avalanche RPC.

Metodi supportati

L'endpoint copre le famiglie di metodi JSON-RPC EVM della C-Chain — eth_*, net_*, txpool_* e web3_* — inclusi lettura di account e blocchi (eth_getBalance, eth_getBlockByNumber, eth_getLogs), flusso delle transazioni (eth_sendRawTransaction, eth_getTransactionReceipt), dati sulle commissioni (eth_gasPrice, eth_maxPriorityFeePerGas), simulazione delle chiamate (eth_call, eth_estimateGas), filtri (eth_newFilter, eth_getFilterChanges), ispezione del txpool (txpool_status, txpool_content), le estensioni della C-Chain (eth_getAssetBalance, eth_baseFee), e sottoscrizioni WebSocket (eth_subscribe, eth_unsubscribe).
Le API native di Avalanche sono servite dallo stesso endpoint: operazioni atomiche della C-Chain (avax.getAtomicTx, avax.getUTXOs, avax.issueTx), la X-Chain (avm.getBalance, avm.getTx, avm.issueTx), la P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight), e gli orari di aggiornamento della rete (info.upgrades).
Per l'elenco completo dei metodi con i formati di richiesta e risposta, consulta il Riferimento API Avalanche RPC.

Codici di stato della risposta

Stato HTTPSignificato
200Risposta JSON-RPC upstream.
400Chiave API mancante, o richiesta JSON-RPC non valida.
401Chiave API non autorizzata.
429Rate limitato. L'header retry-after indica il tempo di attesa in secondi.
502La richiesta RPC upstream non è stata completata.
503Il servizio è temporaneamente non disponibile.
Un metodo JSON-RPC al di fuori del catalogo pubblicato riceve una risposta HTTP 400 con errore JSON-RPC -32601 (Method not found), e un batch di oltre 256 chiamate riceve una risposta HTTP 400.
Le connessioni WebSocket utilizzano 101 (aggiornamento di protocollo accettato) e 426 (è richiesto un handshake WebSocket Upgrade) in aggiunta ai codici sopra indicati.

Metodi RPC di Avalanche e documentazione

Per l'elenco completo dei metodi standard, dei parametri e delle specifiche di sottoscrizione, consulta la documentazione ufficiale. Copre sia l'utilizzo HTTP che WebSocket.

Precedente

Avalanche RPC - Guida rapida

Successivo

SLV AI