Quicknode biedt foutlogboeken voor uw RPC-eindpunten. U kunt problemen eenvoudig opsporen en oplossen door gedetailleerde foutinformatie rechtstreeks vanuit uw dashboard te bekijken.

HTTP-foutcodes

Let's look at the common HTTP errors you can encounter, what they mean and what you can do to prevent them.

400Ongeldig verzoek

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

401Niet-geautoriseerd

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

403Toegang geweigerd

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

404Niet gevonden

Incorrect URL or incorrect method

413Inhoud te groot

De inhoud van het verzoek is te groot

429Te veel verzoeken

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

500Interne serverfout

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

503Dienst niet beschikbaar

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

Voorbeeld van een HTTP-foutcode

{
  "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
}

Eindpuntlogboeken

Quicknode biedt logbestanden voor je RPC-eindpunten om je te helpen bij het opsporen van problemen. Je kunt de logbestanden rechtstreeks in je Quicknode-dashboard bekijken door naar het volgende te gaan:

1. Eindpunten in de zijbalk
2. Uw eindpunt selecteren
3. Het tabblad 'Logs ' openen

Je kunt logbestanden filteren op tijdsperiode, reactietype, methode en netwerk.

Wat wordt geregistreerd

Verzoeken aan het eindpunt
Verzoeken die naar uw eindpunt zijn verzonden, inclusief de HTTP-status, de verzoekmethode, de RPC-methode of het pad, en de tijdstempel.

Foutdetails
Indien beschikbaar, bevatten mislukte verzoeken foutdetails zoals RPC-foutcodes, de inhoud van verzoeken en antwoorden, en links naar relevante documentatie.

Beperkingen bij het loggen

De beschikbaarheid van logbestanden kan variëren afhankelijk van de methode, het type reactie, het netwerk en het abonnement. Om optimale prestaties van de eindpunten te waarborgen, werkt het loggen op basis van ‘best effort’. Sommige logbestanden kunnen tijdens periodes met veel verkeer worden weggelaten om een lage latentie te behouden.

Bewaring en toegang

Bij de Build- en Scale-abonnementen is toegang tot het dashboard inbegrepen, met standaard bewaartermijnen voor logbestanden. Enterprise-abonnementen bieden langere bewaartermijnen en programmatische API-toegang voor het ophalen van logbestanden.

Mocht u andere foutcodes tegenkomen, laat het ons dan weten door een ticket in te dienen. We helpen u graag verder