Documentazione dell'endpoint RPC di Base | ERPC
Documentazione dell'endpoint RPC di Base
Usa ERPC come tuo endpoint RPC di Base per richieste HTTP JSON-RPC e sottoscrizioni WebSocket. Base 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.
Aggiungi la tua chiave API al parametro
api-key.Endpoint
Invia richieste JSON-RPC 2.0 come HTTP POST a:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>Per le sottoscrizioni, connettiti via WebSocket a:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>wss://base.erpc.global?api-key=<YOUR_API_KEY>Le richieste sono accettate solo su
/.Esempi
Ecco un esempio di richiesta HTTP.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --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 fino a 256 chiamate per richiesta HTTP. Ogni chiamata in un batch viene misurata come chiamata a sé stante.
Utilizzo dei token
L'utilizzo viene misurato in token per chiamata JSON-RPC. Ogni voce in un batch HTTP e ogni chiamata JSON-RPC inviata su una connessione WebSocket 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.Con il piano Free, le connessioni WebSocket non sono disponibili e ricevono una risposta HTTP
403.Metodi supportati
Base è compatibile con EVM e usa gli stessi metodi JSON-RPC di Ethereum. ERPC non applica un elenco fisso di metodi consentiti all'endpoint di Base. Per le famiglie di metodi di Ethereum, consulta la Documentazione dell'endpoint RPC di Ethereum.
Codici di stato della risposta
| Stato HTTP | Significato |
|---|---|
| 200 | Risposta JSON-RPC upstream. |
| 400 | Missing API key, Invalid JSON-RPC request o JSON-RPC batch exceeds 256 calls. |
| 401 | Unauthorized API KEY. |
| 403 | Una connessione WebSocket con il piano Free. |
| 404 | Un percorso diverso da /. |
| 429 | Rate limitato, compresi i limiti del piano Free indicati sopra: più di una richiesta ogni 10 secondi, oppure due o più chiamate in una richiesta. L'header retry-after indica il tempo di attesa in secondi. |
| 502 | La richiesta RPC upstream non è stata completata. |
| 503 | Il servizio è temporaneamente non disponibile. |
Le connessioni WebSocket utilizzano
101 (aggiornamento di protocollo accettato) in aggiunta ai codici sopra indicati.Metodi RPC di Base e documentazione
Per l'elenco completo dei metodi standard, dei parametri e delle specifiche, consulta la documentazione ufficiale.