Arc RPC endpoint avec ERPC | Documentation

Documentation de l'endpoint RPC Arc

Utilisez ERPC comme endpoint RPC Arc™ pour vos requêtes HTTP JSON-RPC. Arc RPC fait partie des API RPC d'ERPC au sein de notre Global Edge Blockchain Infrastructure, et l'API key se gère depuis l'ERPC Web Dashboard.
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 à :
endpoint
https://edge.erpc.global/arc?api-key=<YOUR_API_KEY>
ou à l'hôte dédié :
endpoint
https://arc.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/arc?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/arc' --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 l'ERPC Web Dashboard : ERPC Web Dashboard

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.

Mesure de l'utilisation

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 compter dans cette limite. 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 38 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
  • net_* (3): net_listening, net_peerCount, net_version
  • web3_* (2): web3_clientVersion, web3_sha3
  • txpool_* (3): txpool_content, txpool_inspect, txpool_status
  • debug_* (4): debug_traceBlockByHash, debug_traceBlockByNumber, debug_traceCall, debug_traceTransaction
  • trace_* (2): trace_block, trace_transaction
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.
429Débit limité, 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 Arc RPC et documentation

La documentation Arc décrit les méthodes JSON-RPC Ethereum standard sur Arc et renvoie vers la référence où vous trouverez leurs paramètres. Une méthode absente de la liste ci-dessus reçoit une réponse HTTP 400, même si la documentation Arc la mentionne.
Arc is a trademark of Circle Internet Group, Inc. and/or its affiliates.