Base RPC - Quickstart

Base RPC - Quickstart

Ce guide vous accompagne de zéro jusqu'à votre première réponse Base JSON-RPC avec ERPC.

1. Récupérez votre API key

Vous pouvez obtenir et vérifier votre API key sur le Dashboard Web ERPC : Dashboard Web ERPC
Vous utilisez déjà ERPC pour Solana, Ethereum ou Avalanche ? Vous pouvez utiliser la même RPC key.

2. Effectuez votre première requête

Envoyez une requête JSON-RPC 2.0 en tant que HTTP POST, avec votre API key dans le paramètre api-key :
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"
}'
La réponse renvoie le dernier numéro de bloc en hexadécimal :
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }
Avec le forfait Free, votre compte peut envoyer une requête toutes les 10 secondes, et une requête vers une autre chaîne peut aussi compter dans cette limite. Attendez 10 secondes avant d'envoyer la requête suivante.
Vous pouvez vérifier quelle chaîne l'endpoint dessert avec eth_chainId :
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_chainId"
}'

3. Abonnez-vous via WebSocket

Pour les abonnements, connectez-vous via WebSocket à :
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>
Pour les types d'abonnement disponibles, consultez la documentation officielle Base en lien ci-dessous. Avec le forfait Free, les connexions WebSocket ne sont pas disponibles et reçoivent une réponse HTTP 403.

4. Requêtes en batch

Vous pouvez envoyer jusqu'à 256 appels JSON-RPC en une seule requête HTTP. Chaque appel dans un batch est mesuré comme un appel à part entière. Avec le forfait Free, envoyez un appel par requête : une requête de deux appels ou plus reçoit une réponse HTTP 429.

Prochaines étapes