Documentazione dell'endpoint RPC di Ethereum | ERPC
Documentazione dell'endpoint RPC di Ethereum
Usa ERPC come tuo endpoint RPC di Ethereum per richieste HTTP JSON-RPC e sottoscrizioni WebSocket. Ethereum 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.
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/eth?api-key=<YOUR_API_KEY>https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Per le sottoscrizioni, connettiti via WebSocket a:
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Esempi
Ecco un esempio di richiesta HTTP.
bash
curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl https://edge.erpc.global/eth?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/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}wscat -c "wss://edge.erpc.global/eth?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, e sono accettate anche le notifiche JSON-RPC. 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 Ethereum 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 Ethereum RPC.
Metodi supportati
L'endpoint copre le famiglie di metodi JSON-RPC standard di Ethereum —
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_feeHistory, eth_maxPriorityFeePerGas), simulazione delle chiamate (eth_call, eth_callMany, eth_simulateV1), prove di stato (eth_getProof), filtri (eth_newFilter, eth_getFilterChanges), ispezione del txpool (txpool_status, txpool_content), e sottoscrizioni WebSocket (eth_subscribe, eth_unsubscribe).Per l'elenco completo dei metodi con i formati di richiesta e risposta, consulta il Riferimento API Ethereum RPC.
Codici di stato della risposta
| Stato HTTP | Significato |
|---|---|
| 200 | Risposta JSON-RPC upstream. |
| 400 | Richiesta JSON-RPC non valida. |
| 401 | Chiave API mancante o non autorizzata. |
| 429 | Rate limitato dalla policy RPC downstream. |
| 502 | Proxy non disponibile. |
| 503 | Servizio RPC downstream non disponibile. |
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 Ethereum 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.