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

Falscher HTTP-Anfragetyp (z. B. Verwendung von GET statt POST) oder ungültige Zeichen

401Nicht autorisiert

Dies kann passieren, wenn eine oder mehrere Sicherheitsanforderungen nicht erfüllt sind, z. B. bei einer fehlerhaften Token-Authentifizierung, einer IP-Adresse, die nicht auf der Whitelist steht, einem ungültigen JWT usw.

403Zugriff verweigert

Endgerät deaktiviert (Ein Grund hierfür könnte eine überfällige Zahlung sein)

403Zugriff verweigert – benutzerdefinierte Ablaufverfolgung nicht gefunden

Benutzerdefinierter Trace-Code ist nicht in der Whitelist aufgeführt (Reichen Sie ein Ticket ein, um den Genehmigungsprozess zu durchlaufen)

404Nicht gefunden

Falsche URL oder falsche Methode

413Inhalt zu groß

Der Hauptteil der Anfrage ist zu groß

413Anfrage-Entität zu groß

eth_getLogs und eth_newFilter sind auf einen Bereich von 10.000 Blöcken beschränkt. Bei der Abfrage von Protokollen und Ereignissen wenden wir eine Begrenzung auf 10.000 Blockbereiche an.

429Zu viele Anfragen

Die Anzahl der Anfragen pro Sekunde (RPS) liegt über dem in Ihrem Tarif zulässigen Limit. Weitere Informationen zu den 429-Fehlern finden Sie in unserer Support-Dokumentation.

500Interner Serverfehler

Reichen Sie ein Ticket ein, damit sich das Support-Team so schnell wie möglich die Fehler ansieht.

503Dienst nicht verfügbar

Reichen Sie ein Ticket ein, damit sich das Support-Team so schnell wie möglich die Fehler ansieht.

Beispiel für einen HTTP-Fehlercode

Der folgende Codeausschnitt ist ein Beispiel für den Fehlercode 429.

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

Starknet RPC Error Codes

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

1Failed to receive transaction

Sequencer rejected the transaction during validation. Verify transaction format and required fields

10No trace available

Trace data not available for the transaction. Verify the transaction hash is correct and exists on the network

20Contract not found

The specified contract address does not exist on the network

21Invalid message selector

Function selector does not exist in the contract ABI

22Invalid call data

Calldata is malformed or contains invalid parameters. Verify parameter types and encoding

24Block not found

The requested block does not exist. Check block number/hash or wait for sync

26Invalid block hash

Block hash format is invalid. Ensure it's a valid hexadecimal string with correct length

27Invalid transaction index

Transaction index is out of range for this block

28Class hash not found

The specified class hash has not been declared on the network

29Transaction hash not found

No transaction found with the provided hash

31Page size too big

Page size exceeds the maximum allowed limit.

32No blocks

No blocks available in the specified range

33Invalid continuation token

The continuation token is invalid or has expired

34Too many keys in filter

Filter contains more keys than the maximum allowed

40Contract error

An error occurred during contract execution

41Transaction execution error

Transaction failed to execute. Check contract logic and resource limits

51Class already declared

Class already exists on the network. Duplicate declarations are not allowed

52Invalid transaction nonce

Invalid nonce for the account. Use the correct sequential nonce value

53Insufficient max fee

Max fee too low. Increase the fee to cover transaction costs

54Insufficient account balance

Account balance too low. Ensure sufficient funds to cover the transaction fee

55Validation failure

Account validation failed. Check your signature and account contract logic

56Compilation failed

Contract compilation failed. Fix Cairo code syntax and compilation errors

57Contract class size is too large

Contract class too large. Reduce the contract size to fit within network limits

58Non account

Sender is not an account contract. Only account contracts can send transactions

59Duplicate transaction

Transaction already exists in mempool. Avoid submitting duplicate transactions

60Compiled class hash mismatch

The compiled class hash does not match the declared hash

61Unsupported transaction version

Transaction version not supported. Use a compatible transaction version

62Unsupported contract class version

Contract class version not supported. Use a compatible Cairo compiler version

63Unexpected error

Unexpected server error occurred. Submit a ticket if the issue persists

Starknet RPC Error Code Example

The code snippet below is an example of Error Code 20.

{
  "error": {
    "code": 20,
    "message": "Contract not found"
  },
  "id": 1,
  "jsonrpc": "2.0"
}

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.