ERPC

Soneium RPC endpoint avec ERPC | Documentation

Documentation de l'endpoint RPC Soneium

Utilisez ERPC comme votre endpoint RPC Soneium pour vos requêtes HTTP JSON-RPC. Soneium 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.
Passez votre API key dans le paramètre d'URL api-key, ou envoyez-la sous la forme Authorization: Bearer <YOUR_API_KEY>. Si les deux sont présents, c'est le paramètre d'URL qui est utilisé.

Endpoints

Envoyez les requêtes JSON-RPC 2.0 en HTTP POST à :
text
https://edge.erpc.global/soneium?api-key=<YOUR_API_KEY>
ou à l'hôte dédié :
text
https://soneium.erpc.global?api-key=<YOUR_API_KEY>
Les requêtes sont acceptées uniquement sur /.

Exemples

Voici un exemple de requête HTTP avec l'API key dans le paramètre d'URL.
bash
curl 'https://edge.erpc.global/soneium?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
Voici la même requête avec l'API key dans l'en-tête Authorization.
bash
curl 'https://edge.erpc.global/soneium' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --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 de 1 à 100 appels par requête HTTP sont pris en charge. Chaque appel doit avoir son propre id, et les valeurs id ne doivent pas se répéter au sein d'un batch. Chaque appel dans un batch est mesuré comme un appel à part entière. Le corps de la requête peut atteindre 1 MiB.

Utilisation des tokens

L'utilisation est mesurée en tokens, et le tarif en tokens peut varier selon la méthode. Chaque appel d'un batch HTTP 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.

Méthodes prises en charge

L'endpoint dessert ces 33 méthodes, regroupées par 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
  • web3_* (2): web3_clientVersion, web3_sha3
  • net_* (3): net_listening, net_peerCount, net_version
  • debug_* (4): debug_traceBlockByHash, debug_traceBlockByNumber, debug_traceCall, debug_traceTransaction
Une méthode ou un chemin non listé reçoit une réponse HTTP 400.

Codes de statut de réponse

Statut HTTPSignification
200Réponse JSON-RPC en amont. Une erreur JSON-RPC est également renvoyée avec HTTP 200 : elle conserve l'id de la requête et le error.code, son error.message vaut ERPC upstream error, et error.data n'est pas renvoyé.
400Une méthode ou un chemin hors de la liste des méthodes prises en charge, une requête JSON-RPC invalide, un batch vide ou de plus de 100 appels, un id en double dans un batch, ou un corps de plus de 1 MiB.
401API key manquante ou invalide, ou une restriction d'IP ou d'Origin définie sur la clé n'est pas respectée.
405Une méthode de requête autre que POST.
426Un WebSocket Upgrade a été demandé. L'endpoint ne prend en charge que HTTP.
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. Si un en-tête retry-after est présent, attendez le nombre de secondes indiqué.
502La requête en amont n'a pas pu être complétée : réponse en amont en échec, réponse de plus de 8 MiB, ou aucune réponse dans les 30 secondes.
503Le service est temporairement indisponible.

Méthodes Soneium RPC et documentation

Pour la liste complète des méthodes standard, des paramètres et des spécifications, veuillez consulter la documentation officielle.
https://docs.soneium.org/docs/builders/overview

Précédent

Soneium RPC - Quickstart

Suivant

Sui RPC - Quickstart