Ethereum Error Code Reference

Quicknode Fehlerprotokolle für Ihre RPC-Endpunkte Quicknode . 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 wie man sie vermeiden kann.

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

Endpoint (Ein möglicher Grund hierfür könnte eine überfällige Zahlung sein)

403Zugriff verweigert – benutzerdefinierte Ablaufverfolgung nicht gefunden

Benutzerdefinierter Trace-Code ist nicht auf der Whitelist (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 Blöcke 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

Submit a ticket for the support team to take a look at the errors asap

503Dienst nicht verfügbar

Submit a ticket for the support team to take a look at the errors asap

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
}

Ethereum RPC Error Codes

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

-32000Header not found / Block not foundRPC

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.

-32000Stack limit reachedRPC

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

-32000Method handler crashedRPC

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

-32000Execution timeoutRPC

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

-32000Nonce too lowRPC

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

-32000Filter not foundRPC

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

-32001Resource Not FoundRPC

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

-32002Resource UnavailableRPC

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

-32003Transaction RejectedRPC

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

-32004Method Not SupportedRPC

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

-32005Limit ExceededRPC

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

-32006JSON-RPC Version Not SupportedRPC

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

-32010Transaction cost exceeds gas limitRPC

Der Gasgrenzwert ist zu niedrig eingestellt

-32011Network errorRPC

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

-32015VM execution errorRPC

Fehler bei der Ausführung eines Smart Contracts

-32600Invalid requestRPC

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

-32601Method not foundRPC

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

-32601Failed to parse requestRPC

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

-32602Invalid params - missing 0x prefixRPC

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

-32602Block range limit exceededRPC

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.

-32603Internal JSON-RPC errorRPC

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

-32700Parse errorRPC

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

3Execution revertedRPC

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

-32007Per-second request limit reachedQuicknode

You have exceeded your plan's per-second request limit. Reduce the number of calls per second or upgrade your plan at https://dashboard.quicknode.com/billing/plan.

-32008Per-minute request limit reachedQuicknode

You have exceeded your plan's per-minute request limit. Reduce the number of calls per minute or upgrade your plan at https://dashboard.quicknode.com/billing/plan.

-32011Method rate limit reachedQuicknode

You have exceeded a method-specific rate limit configured for the endpoint. Reduce calls to the method or adjust the method rate-limit rule.

-32604Unsupported request methodQuicknode

The request method is empty, missing, or unsupported. Provide a supported JSON-RPC method name.

-32611Request rejected by filter settingsQuicknode

The request was rejected by an endpoint security filter, such as a method allowlist or blocklist. Review the endpoint's request filter settings.

Ethereum 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 Sammlung 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:

Endpoint

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

Endpunkte in der Seitenleiste
Auswahl Ihres endpoint
Die Registerkarte „Protokolle “ öffnen

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

Was wird protokolliert?

Endpoint
An Ihren endpoint 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 endpoint optimale endpoint 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 aufrechtzuerhalten.

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 Support-Ticket mit. Wir helfen Ihnen gerne weiter.