Quicknode stellt Fehlerprotokolle für Ihre RPC-Endpunkte bereit. Sie können Probleme ganz einfach identifizieren und beheben, indem Sie detaillierte Fehlerinformationen direkt über Ihr Dashboard einsehen.

HTTP-Fehlercodes

Schauen wir uns einmal die häufigsten HTTP-Fehler an, die auftreten können, was sie bedeuten und was Sie tun können, um sie zu vermeiden.

400Ungültige Anfrage

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

401Nicht autorisiert

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

403Zugriff verweigert

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

404Nicht gefunden

Incorrect URL or incorrect method

413Inhalt zu groß

Der Hauptteil der Anfrage ist zu groß

429Zu viele Anfragen

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

500Interner Serverfehler

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

503Dienst nicht verfügbar

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

Beispiel für einen HTTP-Fehlercode

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

Endpunktprotokolle

Quicknode stellt Protokolle für Ihre RPC-Endpunkte bereit, um Ihnen bei der Fehlerbehebung zu helfen. Sie können die Protokolle direkt in Ihrem Quicknode-Dashboard einsehen, indem Sie zu folgender Seite navigieren:

1. Endpunkte in der Seitenleiste
2. Auswahl Ihres Endpunkts
3. Die Registerkarte „Protokolle “ öffnen

Sie können die Protokolle nach Zeitfenster, Antworttyp, Methode und Netzwerk filtern.

Was wird protokolliert?

Endpunktanfragen
An Ihren Endpunkt gerichtete Anfragen, einschließlich HTTP-Status, Anfragemethode, RPC-Methode oder -Pfad sowie Zeitstempel.

Fehlerdetails
Sofern verfügbar, enthalten fehlgeschlagene Anfragen Fehlerdetails wie RPC-Fehlercodes, Anfrage- und Antwortinhalte sowie Links zu weiterführender Dokumentation.

Einschränkungen bei der Protokollierung

Die Verfügbarkeit von Protokollen kann je nach Methode, Antworttyp, Netzwerk und Tarif variieren. Um eine optimale Endpunktleistung zu gewährleisten, erfolgt die Protokollierung nach dem „Best-Effort“-Prinzip. In Zeiten mit hohem Datenverkehr können einige Protokolle verworfen werden, um eine geringe Latenz zu gewährleisten.

Aufbewahrung und Zugriff

Die „Build“- und „Scale“-Tarife umfassen den Zugriff auf das Dashboard mit standardmäßiger Protokollaufbewahrung. Die „Enterprise“-Tarife bieten verlängerte Aufbewahrungsfristen und programmgesteuerten API-Zugriff zum Abrufen von Protokollen.

Sollten bei Ihnen andere Fehlercodes auftreten, teilen Sie uns dies bitte über ein Ticket mit. Wir helfen Ihnen gerne weiter.