Base RPC endpoint avec ERPC | Documentation

Documentation de l'endpoint RPC Base

Utilisez ERPC comme votre endpoint RPC Base pour vos requêtes HTTP JSON-RPC et vos abonnements WebSocket. Base RPC fait partie des RPC APIs d'ERPC au sein de notre Global Edge Blockchain Infrastructure, et l'API key se gère depuis le Dashboard Web ERPC.
Vous pouvez utiliser la même RPC key que Solana, Ethereum et Avalanche.
Veuillez ajouter votre API key au paramètre api-key.

Endpoints

Envoyez les requêtes JSON-RPC 2.0 en HTTP POST à :
text
https://base.erpc.global?api-key=<YOUR_API_KEY>
Pour les abonnements, connectez-vous via WebSocket à :
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>
Les requêtes sont acceptées uniquement sur /.

Exemples

Voici un exemple de requête 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"
}'
Vous pouvez obtenir et vérifier votre API key sur le Dashboard Web ERPC : Dashboard Web ERPC

Requêtes en batch

Les batchs JSON-RPC allant jusqu'à 256 appels par requête HTTP sont pris en charge. Chaque appel dans un batch est mesuré comme un appel à part entière.

Utilisation des tokens

L'utilisation est mesurée en tokens par appel JSON-RPC. Chaque entrée d'un batch HTTP et chaque appel JSON-RPC envoyé sur une connexion WebSocket est mesuré séparément.

Limites du forfait Free

Avec le forfait Free, votre compte peut envoyer une requête toutes les 10 secondes. La limite est comptée par compte et non par endpoint, si bien qu'une requête vers une autre chaîne peut aussi y compter. Une requête envoyée plus tôt reçoit une réponse HTTP 429, et l'en-tête retry-after indique l'attente en secondes.
Avec le forfait Free, une requête qui contient deux appels JSON-RPC ou plus reçoit une réponse HTTP 429, et aucun de ses appels n'est envoyé : chaque appel reçoit une erreur JSON-RPC avec le code -32041. Envoyez plutôt ces appels un par un.
Avec le forfait Free, les connexions WebSocket ne sont pas disponibles et reçoivent une réponse HTTP 403.

Méthodes prises en charge

Base est compatible EVM et utilise les mêmes méthodes JSON-RPC qu'Ethereum. ERPC n'applique pas de liste fixe de méthodes autorisées à l'endpoint Base. Pour les familles de méthodes Ethereum, consultez la Documentation de l'endpoint RPC Ethereum.

Codes de statut de réponse

Statut HTTPSignification
200Réponse JSON-RPC en amont.
400Missing API key, Invalid JSON-RPC request ou JSON-RPC batch exceeds 256 calls.
401Unauthorized API KEY.
403Une connexion WebSocket avec le forfait Free.
404Un chemin autre que /.
429Limité par le débit, y compris par les limites du forfait Free ci-dessus : plus d'une requête toutes les 10 secondes, ou deux appels ou plus dans une requête. L'en-tête retry-after indique le délai d'attente en secondes.
502La requête RPC en amont n'a pas pu être complétée.
503Le service est temporairement indisponible.
Les connexions WebSocket utilisent 101 (mise à niveau de protocole acceptée) en plus des codes ci-dessus.

Méthodes Base RPC et documentation

Pour la liste complète des méthodes standard, des paramètres et des spécifications, veuillez consulter la documentation officielle.