Base RPC endpoint documentatie | ERPC

Base RPC endpoint documentatie

Gebruik ERPC als uw Base RPC endpoint voor HTTP JSON-RPC-verzoeken en WebSocket-abonnementen. Base 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, Ethereum en Avalanche gebruiken.
Voeg uw API key toe aan de api-key-parameter.

Endpoints

Verstuur JSON-RPC 2.0-verzoeken als HTTP POST naar:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>
Voor abonnementen maakt u verbinding via WebSocket met:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>
Verzoeken worden alleen op / geaccepteerd.

Voorbeelden

Hier is een HTTP-verzoekvoorbeeld.
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"
}'
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. Elke aanroep in een batch wordt gemeten als een eigen aanroep.

Tokengebruik

Het gebruik wordt gemeten in tokens per JSON-RPC-aanroep. Elke invoer in een HTTP-batch en elke JSON-RPC-aanroep die via een WebSocket-verbinding wordt verstuurd, wordt afzonderlijk gemeten.

Limieten van het Free-abonnement

Bij het Free-abonnement kan uw account één verzoek per 10 seconden versturen. De limiet wordt per account geteld, niet per endpoint, dus een verzoek naar een andere chain kan ook meetellen. Een verzoek dat sneller wordt verstuurd, wordt beantwoord met HTTP 429, en de retry-after-header geeft de wachttijd in seconden aan.
Bij het Free-abonnement wordt een verzoek met twee of meer JSON-RPC-aanroepen beantwoord met HTTP 429, en wordt geen van de aanroepen verzonden: elke aanroep krijgt een JSON-RPC-fout met code -32041. Verstuur deze aanroepen in plaats daarvan één voor één.
Bij het Free-abonnement zijn WebSocket-verbindingen niet beschikbaar en worden ze beantwoord met HTTP 403.

Ondersteunde methodes

Base is EVM-compatibel en gebruikt dezelfde JSON-RPC-methodes als Ethereum. ERPC past geen vaste allowlist van methodes toe op het Base-endpoint. Voor de Ethereum-methodefamilies, zie de Ethereum RPC endpoint documentatie.

Antwoordstatuscodes

HTTP-statusBetekenis
200Upstream JSON-RPC-respons.
400Missing API key, Invalid JSON-RPC request of JSON-RPC batch exceeds 256 calls.
401Unauthorized API KEY.
403Een WebSocket-verbinding bij het Free-abonnement.
404Een ander pad dan /.
429Rate-limited, inclusief de hierboven genoemde limieten van het Free-abonnement: meer dan één verzoek per 10 seconden, of twee of meer aanroepen in één verzoek. De retry-after-header geeft de wachttijd in seconden aan.
502Het upstream RPC-verzoek kon niet worden voltooid.
503De service is tijdelijk niet beschikbaar.
WebSocket-verbindingen gebruiken naast de bovenstaande codes ook 101 (protocol-upgrade geaccepteerd).

Base RPC-methoden en documentatie

Voor de volledige lijst van standaardmethoden, parameters en specificaties verwijzen wij u naar de officiële documentatie.