Passer au contenu principal

Référence des codes d'erreur de la couche X

Mis à jour le
15 avril 2026
Quicknode met à votre disposition des journaux d'erreurs pour vos points de terminaison RPC. Identifiez et résolvez facilement les problèmes en consultant les informations détaillées sur les erreurs directement depuis votre tableau de bord.

Codes d'erreur HTTP

Voyons ensemble les erreurs HTTP les plus courantes que vous pouvez rencontrer, ce qu'elles signifient et comment les éviter.

400Erreur de requête

Type de requête HTTP incorrect (par exemple, utilisation de GET au lieu de POST) ou caractères non valides

401Non autorisé

Cela peut se produire lorsqu'une ou plusieurs conditions de sécurité ne sont pas remplies, par exemple en cas d'authentification par jeton incorrecte, d'adresse IP ne figurant pas sur la liste blanche, de JWT non valide, etc.

403Accès interdit

Terminal désactivé (cela peut notamment être dû à un paiement en retard)

403Accès interdit - trace personnalisée introuvable

Le code de suivi personnalisé ne figure pas sur la liste blanche (envoyez une demande d'assistance pour lancer la procédure de validation)

404Page introuvable

URL incorrecte ou méthode incorrecte

413Contenu trop volumineux

Le corps de la requête est trop volumineux

413Entité de requête trop volumineuse

Les fonctions `eth_getLogs` et `eth_newFilter` sont limitées à une plage de 10 000 blocs. Nous appliquons une limite de 10 000 blocs lors des requêtes de journaux et d'événements.

429Trop de requêtes

Le nombre de requêtes par seconde (RPS) dépasse la limite autorisée par votre forfait. Pour en savoir plus sur les erreurs 429, consultez notre documentation d'assistance.

500Erreur interne du serveur

Envoyez une demande d'assistance afin que l'équipe d'assistance puisse examiner ces erreurs dès que possible

503Service indisponible

Envoyez une demande d'assistance afin que l'équipe d'assistance puisse examiner ces erreurs dès que possible

Exemple de code d'erreur HTTP

L'extrait de code ci-dessous illustre le code d'erreur 429.

{
"jsonrpc": "2.0",
"error": {
"code": 429,
"message": "The requests per second (RPS) of your requests are higher than your plan allows."
},
"id": 1
}

Codes d'erreur RPC EVM

Voyons ensemble les erreurs courantes liées à l'EVM que vous pouvez rencontrer, ce qu'elles signifient et comment vous pouvez les éviter.

-32000En-tête introuvable / Bloc introuvable

Le bloc demandé n'existe pas sur le nœud. Le numéro de bloc est incorrect ou le nœud que vous interrogez n'est pas encore synchronisé. Utilisez un mécanisme de nouvelle tentative avec un délai d'attente croissant.

-32 000Limite de la pile atteinte

Il s'agit généralement d'une erreur ou d'un bug dans le contrat intelligent : limite de la pile atteinte à 1024 (1023)

-32 000Plantage du gestionnaire de méthode

Erreur interne du client blockchain, qui peut être due à un bug du client. Veuillez créer un ticket afin que nous puissions vérifier les nœuds.

-32 000Délai d'exécution dépassé

Ajoutez le paramètre « timeout » dans votre requête pour remplacer le délai d'expiration par défaut du client.

-32 000Nonce trop faible

La valeur du nonce indiquée dans votre transaction est inférieure au prochain nonce valide pour le compte de l'expéditeur.

-32 000Filtre introuvable

Le délai d'attente du filtre a expiré ; vous devrez recréer le filtre.

-32001Ressource introuvable

La ressource demandée n'existe pas ou n'est pas disponible.

-32002Ressource indisponible

La ressource demandée est temporairement ou définitivement indisponible.

-32003Transaction refusée

La transaction n'a pas pu être créée en raison d'un échec de validation ou d'un manque de ressources.

-32004Méthode non prise en charge

La méthode demandée n'est pas implémentée ou prise en charge par le serveur.

-32005Limite dépassée

La requête dépasse la limite ou le quota autorisé.

-32006Version JSON-RPC non prise en charge

La version JSON-RPC indiquée n'est pas prise en charge par le serveur.

-32009Nombre limité de demandes de traçage

Nous avons limité l'utilisation des méthodes de débogage et de traçage à un RPS spécifique afin d'éviter toute surcharge des nœuds.

-32010Le coût de la transaction dépasse la limite de gaz

La limite de gaz est réglée à un niveau trop bas

-32011Erreur réseau

Cette erreur se produit lorsqu'un problème survient au niveau de la connexion entre le client et le serveur, par exemple un délai d'expiration ou une interruption de connexion.

-32015Erreur d'exécution de la machine virtuelle

Erreur d'exécution d'un contrat intelligent

-32600Demande non valide

La requête JSON est mal formée ou il manque des champs obligatoires. Assurez-vous qu'elle respecte le format attendu.

-32601Méthode introuvable

Il s'agit généralement d'une faute de frappe dans le nom de la méthode ; vérifiez s'il y a des fautes d'orthographe.

-32601Échec de l'analyse de la requête

Contenu de la requête incorrect ; vérifiez les paramètres de la méthode

-32602Paramètres non valides - préfixe 0x manquant

Requête incorrecte ; le 0x manque dans l'adresse. La valeur hexadécimale

-32602Limite de plage de blocs dépassée

Les fonctions `eth_getLogs` et `eth_newFilter` sont limitées à une plage de 10 000 blocs. Vous trouverez une explication détaillée dans notre documentation d'assistance.

-32603Erreur JSON-RPC interne

Cette erreur est généralement due à une charge utile incorrecte ou non valide.

-32612Les traces personnalisées sont bloquées

Envoyez une demande pour activer les traces personnalisées.

-32613Trace personnalisée non autorisée

La trace personnalisée n'apparaît pas dans la liste des traces personnalisées autorisées. Envoyez une demande pour que cette trace soit ajoutée à la liste blanche.

-32700Erreur d'analyse

JSON non valide reçu. Le serveur a rencontré une erreur lors de l'analyse du texte JSON.

3Exécution annulée

La transaction a été annulée au cours de son exécution, probablement en raison de conditions non remplies, d'un manque de gaz ou d'une erreur dans le contrat.

Exemple de code d'erreur RPC EVM

L'extrait de code ci-dessous illustre le code d'erreur -32601.

{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32601,
"message": "the method eth_randomMethod does not exist/is not available"
}
}

Les erreurs RPC définies ci-dessus constituent un ensemble d'erreurs courantes que vous pouvez rencontrer lors du développement sur des chaînes telles que ETH, BSC, Polygon, etc. Ces chaînes fonctionnent sur plusieurs clients, chacun disposant de ses propres définitions d'erreurs. Vous pouvez également consulter ici les erreurs mentionnées dans le code source du client du nœud :


Si vous rencontrez d'autres codes d'erreur, n'hésitez pas à nous en faire part en créant un ticket. Nous serons ravis de vous aider.

Partager ce document