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 gängigen HTTP-Fehlercodes 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
}

Avalanche RPC Error Codes

Let's look at the common Avalanche RPC Error Codes you can encounter, what they mean and what you can do to prevent them.

-32000Kopfzeile nicht gefunden / Block nicht gefunden

Der angeforderte Block ist auf dem Knoten nicht vorhanden. Entweder ist die Blocknummer ungültig oder der Knoten, auf den Sie zugreifen, ist noch nicht synchronisiert. Verwenden Sie einen Wiederholungsmechanismus mit einem inkrementellen Timeout.

-32000Stapelgrenze erreicht

In der Regel ein Fehler/Bug im Smart Contract – Stack-Limit erreicht: 1024 (1023)

-32000Methoden-Handler ist abgestürzt

Interner Fehler des Blockchain-Clients, der möglicherweise auf einen Fehler im Client zurückzuführen ist. Reichen Sie bitte ein Ticket ein, damit wir die Knoten noch einmal überprüfen können.

-32000Zeitüberschreitung bei der Ausführung

Fügen Sie den Parameter „timeout“ in Ihre Anfrage ein, um das standardmäßige Client-Timeout zu überschreiben.

-32000Nonce zu niedrig

Der in Ihrer Transaktion angegebene Nonce-Wert ist niedriger als die nächste gültige Nonce für das Absenderkonto.

-32000Filter nicht gefunden

Das Zeitlimit für den Filter wurde überschritten; Sie müssen den Filter erneut erstellen.

-32001Ressource nicht gefunden

Die angeforderte Ressource existiert nicht oder ist nicht verfügbar.

-32002Ressource nicht verfügbar

Die angeforderte Ressource ist vorübergehend oder dauerhaft nicht verfügbar.

-32003Transaktion abgelehnt

Die Transaktion konnte aufgrund eines Validierungsfehlers oder unzureichender Ressourcen nicht erstellt werden.

-32004Methode wird nicht unterstützt

Die angeforderte Methode ist auf dem Server nicht implementiert oder wird nicht unterstützt.

-32005Grenzwert überschritten

Die Anfrage überschreitet das zulässige Limit bzw. die zulässige Quote.

-32006JSON-RPC-Version wird nicht unterstützt

Die angegebene JSON-RPC-Version wird vom Server nicht unterstützt.

-32009Anfragen zur Rückverfolgung begrenzt

Wir haben die Debug- und Trace-Methode auf einen bestimmten RPS beschränkt, um eine Überlastung der Knoten zu verhindern.

-32010Die Transaktionskosten überschreiten das Gaslimit

Der Gasgrenzwert ist zu niedrig eingestellt

-32011Netzwerkfehler

Dieser Fehler tritt auf, wenn ein Problem mit der Verbindung zwischen Client und Server vorliegt, beispielsweise ein Timeout oder ein Verbindungsabbruch.

-32015Fehler bei der Ausführung der VM

Fehler bei der Ausführung eines Smart Contracts

-32600Ungültige Anfrage

Die JSON-Anfrage ist fehlerhaft oder es fehlen erforderliche Felder. Stellen Sie sicher, dass sie dem erwarteten Format entspricht.

-32601Methode nicht gefunden

In der Regel handelt es sich um einen Tippfehler im Methodennamen; überprüfen Sie den Namen auf Rechtschreibfehler.

-32601Die Anfrage konnte nicht analysiert werden

Falscher Request-Body; bitte überprüfen Sie die Methodenparameter noch einmal

-32602Ungültige Parameter – 0x-Präfix fehlt

Falsche Anfrage; in der Adresse fehlt das „0x“. Der Hexadezimalwert

-32602Blockbereichsgrenze überschritten

eth_getLogs und eth_newFilter sind auf einen Bereich von 10.000 Blöcken beschränkt. Eine ausführliche Erläuterung finden Sie in unserer Support-Dokumentation.

-32603Interner JSON-RPC-Fehler

Dieser Fehler ist in der Regel auf eine fehlerhafte oder ungültige Nutzlast zurückzuführen.

-32612Benutzerdefinierte Traces werden blockiert

Reichen Sie einen Antrag ein, um benutzerdefinierte Traces zu aktivieren.

-32613Benutzerdefinierte Verfolgung nicht zulässig

Die benutzerdefinierte Ablaufverfolgung wurde nicht in der Liste der zulässigen benutzerdefinierten Ablaufverfolgungen gefunden. Reichen Sie einen Antrag ein, damit diese Ablaufverfolgung auf die Whitelist gesetzt wird.

-32700Parsing-Fehler

Ungültiges JSON empfangen. Beim Parsen des JSON-Textes ist auf dem Server ein Fehler aufgetreten.

3Ausführung rückgängig gemacht

Die Transaktion wurde während der Ausführung rückgängig gemacht, wahrscheinlich aufgrund nicht erfüllter Bedingungen, unzureichender Gasmenge oder eines Vertragsfehlers.

Avalanche RPC Error Code Example

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

{
	"jsonrpc": "2.0",
	"id": 1,
	"error": {
		"code": -32601,
		"message": "the method eth_randomMethod does not exist/is not available"
	}
}

Die oben definierten RPC-Fehler sind eine Zusammenstellung häufiger Fehler, die bei der Entwicklung auf Blockchains wie ETH, BSC, Polygon usw. auftreten können. Diese Blockchains laufen auf verschiedenen Clients mit jeweils eigenen Fehlerdefinitionen. Die im Quellcode des Node-Clients erwähnten Fehler können Sie auch hier einsehen:

• Erigon-Fehler im Quellcode
• Geth-Fehler
• Fehler bei Nethermind

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.