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
}
Bitcoin RPC Error Codes
Let's look at the common Bitcoin RPC Error Codes you can encounter, what they mean and what you can do to prevent them.
-32700Erreur d'analyse
Invalid JSON was received by the server; check JSON syntax and formatting
-32600Invalid Request
The JSON sent is not a valid Request object; verify the request structure matches JSON-RPC 2.0 specification
-32601Méthode introuvable
The method does not exist or is not available; verify method name spelling or check if the method requires a specific marketplace add-on (e.g., Blockbook methods like bb_gettx require the Blockbook add-on to be enabled)
-32602Invalid params
Invalid method parameter(s); double check parameter types, values, and order against Bitcoin Core documentation
-32603Internal error
Internal JSON-RPC error; this typically indicates an issue with the Bitcoin node itself
-1Miscellaneous error
General error that doesn't fit other categories; check error message for specific details
-2Forbidden by safe mode
Server is in safe mode, and command is not allowed in safe mode
-3Type error
Unexpected type was passed as parameter; ensure parameter types match expected values
-4Wallet error
Unspecified problem with wallet (key not found etc.)
-5Invalid address or key
Invalid Bitcoin address or key format; verify address/key format and network (mainnet vs testnet)
-6Insufficient funds
Not enough funds in wallet or account
-7Out of memory
Ran out of memory during operation
-8Invalid parameter
Invalid, missing or duplicate parameter
-9Client not connected
Bitcoin is not connected
-10Client in initial download
Still downloading initial blocks
-11Invalid account name
Invalid account name
-12Keypool ran out
Keypool ran out, call keypoolrefill first
-13Wallet unlock needed
Enter the wallet passphrase with walletpassphrase first
-14Wallet passphrase incorrect
The wallet passphrase entered was incorrect
-15Wrong encryption state
Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.)
-16Wallet encryption failed
Failed to encrypt the wallet
-17Wallet already unlocked
Wallet is already unlocked
-18Wallet not found
Invalid wallet specified
-19Wallet not specified
No wallet specified (error when there are multiple wallets loaded)
-20Database error
Database read/write error; this may indicate corruption or disk issues
-22Deserialization error
Error parsing or validating structure in raw format; verify the raw transaction or block hex is properly formatted
-23Node already added
Node is already added
-24Node not added
Node has not been added before
-25Verify error
General error during transaction or block submission
-26Verify rejected
Transaction or block was rejected by network rules
-27Verify already in chain
Transaction already in chain
-28Client in warmup
Client still warming up
-29Node not connected
Node to disconnect not found in connected nodes
-30Invalid IP or subnet
Invalid IP/Subnet
-31P2P disabled
No valid connection manager instance found
Bitcoin RPC Error Code Example
L'extrait de code ci-dessous illustre le code d'erreur -32601.
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.