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 codes d'erreur HTTP les plus courants que vous pouvez rencontrer, leur signification et les mesures à prendre pour 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)
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
}
Tron RPC Error Codes
Let's look at the common Tron RPC Error Codes you can encounter, what they mean and what you can do to prevent them.
-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.
Tron RPC Error Code Example
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 :
Quicknode fournit des journaux pour vos points de terminaison RPC afin de vous aider à diagnostiquer les problèmes. Vous pouvez consulter ces journaux directement dans votre tableau de bord Quicknode en accédant à :
Éléments de la barre latérale
Sélection de votre terminal
Ouvrir l'onglet « Journaux »
Vous pouvez filtrer les journaux par plage horaire, type de réponse, méthode et réseau.
Quelles sont les données enregistrées ?
Requêtes adressées au point de terminaison : requêtes adressées à votre point de terminaison, y compris le statut HTTP, la méthode de requête, la méthode RPC ou le chemin d'accès, ainsi que l'horodatage.
Détails de l'erreur Lorsque ces informations sont disponibles, les requêtes ayant échoué incluent des détails sur l'erreur, tels que les codes d'erreur RPC, le contenu des requêtes et des réponses, ainsi que des liens vers la documentation correspondante.
Restrictions en matière d'exploitation forestière
La disponibilité des journaux peut varier en fonction de la méthode, du type de réponse, du réseau et du forfait. Afin de garantir des performances optimales des terminaux, la journalisation fonctionne selon le principe du « meilleur effort ». Certains journaux peuvent être supprimés pendant les périodes de fort trafic afin de maintenir une faible latence.
Conservation et accès
Les formules « Build » et « Scale » incluent l'accès au tableau de bord avec une durée de conservation standard des journaux. Les formules « Enterprise » offrent des durées de conservation prolongées ainsi qu'un accès programmatique via API pour la récupération des journaux.
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.