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

Incorrect HTTP request type (e.g. using GET instead of POST) or invalid characters

401Non autorisé

One or more security requirements not met such as incorrect token auth, IP not in whitelist, invalid JWT, etc

403Accès interdit

Endpoint disabled (one reason could be a past due payment)

403Forbidden — custom trace not found in allowed custom traces

Custom trace code not whitelisted; submit a ticket to go through the approval process

404Page introuvable

Incorrect URL or incorrect method

413Contenu trop volumineux

Le corps de la requête est trop volumineux

429Trop de requêtes

The requests per second (RPS) of your requests are higher than your plan allows; see support docs for details

500Erreur interne du serveur

Submit a ticket for the support team to investigate as soon as possible

503Service indisponible

Submit a ticket for the support team to investigate as soon as possible

Exemple de code d'erreur HTTP

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

Solana RPC Error Codes

When working with Solana, understanding its API error codes is essential for effective troubleshooting and smooth application operation.

-32002Transaction simulation failed / preflight check error

The transaction being sent has errors; double check params, signatures, and message

-32002Blockhash not found

The blockhash sent is not known by the validator yet; implement a retry mechanism

-32003Transaction signature verification failure

One or more signatures are invalid; verify private/public keys and signatures

-32004Block not available for slot

Timeout or block not retrievable; use a retry mechanism

-32005Node is unhealthy / behind by slots

Node is behind the tip; retry with backoff or try another endpoint

-32007Slot was skipped or missing due to snapshot jump

Requested block does not exist; verify the slot in a block explorer

-32009Slot was skipped or missing in long-term storage

The requested slot is missing from long-term storage; see support FAQ for details

-32010Key excluded from account secondary indexes

Unexpected payload or incorrect data for the method; ensure request body matches validator expectations

-32013Transaction signature length mismatch

Signature length is not as expected; re-encode or rebuild the transaction

-32014Block status not yet available

Block is pending or not yet synced; retry later

-32015Transaction version not supported

Use "maxSupportedTransactionVersion": 0 or upgrade client to support versioned transactions

-32016Minimum context slot not reached

The required context slot is too far in the future; lower the minimum context slot or retry later

-32602Invalid params

Flags/params are invalid; double check method parameters against Solana docs

Solana RPC Error Code Example

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Invalid param: Invalid"
  },
  "id": 1
}

Journaux des terminaux

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 à :

1. Éléments de la barre latérale
2. Sélection de votre terminal
3. 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.