Zum Hauptinhalt springen

X Layer Error Code Reference

Aktualisiert am
Aug 28, 2026
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​

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

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
}

EVM RPC Error Codes​

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

-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.

-32009Trace requests limitedRPC

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

-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.

EVM 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:


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

Zuletzt aktualisiert auf