Documentazione dell'endpoint RPC di Arc

Documentazione dell'endpoint RPC di Arc

Usa ERPC come tuo endpoint RPC di Arc™ per richieste HTTP JSON-RPC. Arc 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, Ethereum e Avalanche.
Passa la tua chiave API nel parametro di query api-key, oppure inviala come Authorization: Bearer <YOUR_API_KEY>. Se sono presenti entrambi, viene usato il parametro di query.

Endpoint

Invia richieste JSON-RPC 2.0 come HTTP POST a:
endpoint
https://edge.erpc.global/arc?api-key=<YOUR_API_KEY>
oppure all'host dedicato:
endpoint
https://arc.erpc.global?api-key=<YOUR_API_KEY>
Le richieste sono accettate solo su /.

Esempi

Ecco un esempio di richiesta HTTP con la chiave API nel parametro di query.
bash
curl 'https://edge.erpc.global/arc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
Ecco la stessa richiesta con la chiave API nell'header Authorization.
bash
curl 'https://edge.erpc.global/arc' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard

Richieste in batch

Sono supportati batch JSON-RPC da 1 a 100 chiamate per richiesta HTTP. Ogni chiamata deve avere un proprio id, e i valori di id non devono ripetersi all'interno di un batch. Ogni chiamata in un batch viene misurata come chiamata a sé stante. Il corpo della richiesta può arrivare a 1 MiB.

Utilizzo dei token

L'utilizzo viene misurato in token, e la tariffa in token può variare in base al metodo. Ogni chiamata in un batch HTTP viene misurata separatamente.

Limiti del piano Free

Con il piano Free, il tuo account può inviare una richiesta ogni 10 secondi. Il limite viene conteggiato per account, non per endpoint, quindi anche una richiesta a un'altra chain può rientrare nel conteggio. Una richiesta inviata prima riceve una risposta HTTP 429, e l'header retry-after indica l'attesa in secondi.
Con il piano Free, una richiesta che contiene due o più chiamate JSON-RPC riceve una risposta HTTP 429, e nessuna delle sue chiamate viene inviata: ogni chiamata riceve un errore JSON-RPC con codice -32041. Invia invece queste chiamate una alla volta.

Metodi supportati

L'endpoint serve questi 38 metodi, raggruppati per namespace.
  • eth_* (24): eth_blockNumber, eth_call, eth_chainId, eth_estimateGas, eth_feeHistory, eth_gasPrice, eth_getBalance, eth_getBlockByHash, eth_getBlockByNumber, eth_getBlockReceipts, eth_getBlockTransactionCountByHash, eth_getBlockTransactionCountByNumber, eth_getCode, eth_getLogs, eth_getProof, eth_getStorageAt, eth_getTransactionByBlockHashAndIndex, eth_getTransactionByBlockNumberAndIndex, eth_getTransactionByHash, eth_getTransactionCount, eth_getTransactionReceipt, eth_maxPriorityFeePerGas, eth_sendRawTransaction, eth_syncing
  • net_* (3): net_listening, net_peerCount, net_version
  • web3_* (2): web3_clientVersion, web3_sha3
  • txpool_* (3): txpool_content, txpool_inspect, txpool_status
  • debug_* (4): debug_traceBlockByHash, debug_traceBlockByNumber, debug_traceCall, debug_traceTransaction
  • trace_* (2): trace_block, trace_transaction
Un metodo o un percorso non elencato riceve una risposta HTTP 400.

Codici di stato della risposta

Stato HTTPSignificato
200Risposta JSON-RPC upstream. Anche un errore JSON-RPC viene restituito con HTTP 200: mantiene l'id della richiesta e l'error.code, il suo error.message è ERPC upstream error, e error.data non viene restituito.
400Un metodo o un percorso al di fuori dell'elenco dei metodi supportati, una richiesta JSON-RPC non valida, un batch vuoto o con più di 100 chiamate, un id duplicato in un batch, o un corpo superiore a 1 MiB.
401Chiave API mancante o non valida, oppure non è soddisfatta una restrizione di IP o di Origin impostata sulla chiave.
405Un metodo di richiesta diverso da POST.
426È stato richiesto un WebSocket Upgrade. L'endpoint supporta solo HTTP.
429Rate limitato, compresi i limiti del piano Free indicati sopra: più di una richiesta ogni 10 secondi, oppure due o più chiamate in una richiesta. Se è presente un header retry-after, attendi il numero di secondi indicato.
502La richiesta upstream non è stata completata: una risposta upstream non riuscita, una risposta superiore a 8 MiB, o nessuna risposta entro 30 secondi.
503Il servizio è temporaneamente non disponibile.

Metodi RPC di Arc e documentazione

La documentazione di Arc descrive i metodi JSON-RPC standard di Ethereum su Arc e, per i parametri, rimanda alla relativa documentazione di riferimento. Un metodo assente dall'elenco qui sopra riceve una risposta HTTP 400, anche se la documentazione di Arc lo elenca.
Arc is a trademark of Circle Internet Group, Inc. and/or its affiliates.