Ga naar de hoofdinhoud

X Layer Error Code Reference

Bijgewerkt op
15 april 2026
Quicknode biedt foutlogboeken voor uw RPC-eindpunten. U kunt problemen eenvoudig opsporen en oplossen door gedetailleerde foutinformatie rechtstreeks vanuit uw dashboard te bekijken.

HTTP-foutcodes

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

400Ongeldig verzoek

Onjuist type HTTP-verzoek (bijvoorbeeld GET in plaats van POST) of ongeldige tekens

401Niet-geautoriseerd

Dit kan gebeuren wanneer aan één of meerdere beveiligingsvereisten niet wordt voldaan, zoals onjuiste token-authenticatie, een IP-adres dat niet op de whitelist staat, een ongeldig JWT, enzovoort.

403Toegang geweigerd

Eindpunt uitgeschakeld (een van de redenen hiervoor zou een achterstallige betaling kunnen zijn)

403Toegankelijk - aangepaste trace niet gevonden

Aangepaste tracecode staat niet op de witte lijst (Dien een ticket in om het goedkeuringsproces te doorlopen)

404Niet gevonden

Onjuiste URL of onjuiste methode

413Inhoud te groot

De inhoud van het verzoek is te groot

413Verzoekentiteit te groot

eth_getLogs en eth_newFilter zijn beperkt tot een bereik van 10.000 blokken. Bij het opvragen van logbestanden en gebeurtenissen hanteren we een limiet van 10.000 blokken.

429Te veel verzoeken

Het aantal verzoeken per seconde (RPS) ligt hoger dan wat volgens uw abonnement is toegestaan. Lees meer over de 429-fouten in onze ondersteuningsdocumentatie.

500Interne serverfout

Dien een ticket in, zodat het ondersteuningsteam de fouten zo snel mogelijk kan bekijken

503Dienst niet beschikbaar

Dien een ticket in, zodat het ondersteuningsteam de fouten zo snel mogelijk kan bekijken

Voorbeeld van een HTTP-foutcode

Het onderstaande codefragment is een voorbeeld van foutcode 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.

-32000Koptekst niet gevonden / Blok niet gevonden

Het opgevraagde blok bestaat niet op het knooppunt. Het bloknummer is ongeldig of het knooppunt dat je benadert, is nog niet gesynchroniseerd. Gebruik een herhalingsmechanisme met een oplopende time-out.

-32000Stapellimiet bereikt

Meestal een fout/bug in een smart contract – stacklimiet bereikt: 1024 (1023)

-32000De method handler is gecrasht

Interne fout van de blockchain-client; dit kan een bug in de client zijn. Dien een ticket in, zodat we de nodes nog eens kunnen controleren

-32000Time-out bij uitvoering

Voeg de parameter `timeout` toe aan je verzoek om de standaard time-out van de client te overschrijven.

-32000Nonce te laag

De nonce-waarde die in je transactie is opgegeven, is lager dan de volgende geldige nonce voor de rekening van de afzender.

-32000Filter niet gevonden

De time-out voor het filter is overschreden; je moet het filter opnieuw aanmaken.

-32001Bron niet gevonden

De opgevraagde bron bestaat niet of is niet beschikbaar.

-32002Bron niet beschikbaar

De opgevraagde bron is tijdelijk of permanent niet beschikbaar.

-32003Transactie geweigerd

De transactie kon niet worden aangemaakt vanwege een validatiefout of onvoldoende middelen.

-32004Methode wordt niet ondersteund

De gevraagde methode is niet geïmplementeerd of wordt niet ondersteund door de server.

-32005Limiet overschreden

Het verzoek overschrijdt de toegestane limiet of het toegestane quotum.

-32006JSON-RPC-versie wordt niet ondersteund

De opgegeven JSON-RPC-versie wordt niet ondersteund door de server.

-32009Beperkt aantal traceerverzoeken

We hebben de debug- en trace-methode beperkt tot een bepaald aantal verzoeken per seconde (RPS) om te voorkomen dat de knooppunten overbelast raken

-32010De transactiekosten overschrijden de gaslimiet

De gaslimiet is te laag ingesteld

-32011Netwerkfout

Deze fout treedt op wanneer er een probleem is met de verbinding tussen de client en de server, zoals een time-out of een verbroken verbinding

-32015Fout bij het uitvoeren van een VM

Fout bij de uitvoering van een smart contract

-32600Ongeldig verzoek

Het JSON-verzoek is onjuist opgebouwd of er ontbreken verplichte velden. Zorg ervoor dat het aan de vereiste indeling voldoet.

-32601Methode niet gevonden

Meestal gaat het om een typefout in de naam van de methode; controleer op spelfouten

-32601Het verzoek kon niet worden geparseerd

Onjuiste inhoud van het verzoek; controleer de parameters van de methode nogmaals

-32602Ongeldige parameters - 0x-voorvoegsel ontbreekt

Onjuist verzoek; de 0x ontbreekt in het adres. De hex

-32602Grens van blokbereik overschreden

eth_getLogs en eth_newFilter zijn beperkt tot een bereik van 10.000 blokken. Lees een uitgebreide uitleg hierover in onze ondersteuningsdocumentatie.

-32603Interne JSON-RPC-fout

Deze fout wordt meestal veroorzaakt door een beschadigde of ongeldige payload

-32612Aangepaste sporen worden geblokkeerd

Dien een verzoek in om aangepaste tracings in te schakelen.

-32613Aangepaste trace is niet toegestaan

Aangepaste trace niet gevonden in de lijst met toegestane aangepaste traces. Dien een verzoek in om deze trace op de witte lijst te laten plaatsen.

-32700Parseerfout

Er is ongeldige JSON ontvangen. De server heeft een fout vastgesteld bij het parseren van de JSON-tekst

3Uitvoering ongedaan gemaakt

De transactie is tijdens de uitvoering teruggedraaid, waarschijnlijk als gevolg van niet-voldane voorwaarden, onvoldoende gas of een fout in het contract

EVM RPC Error Code Example

Het onderstaande codefragment is een voorbeeld van foutcode -32601.

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

De hierboven gedefinieerde RPC-fouten vormen een overzicht van veelvoorkomende fouten die je kunt tegenkomen tijdens het ontwikkelen op blockchains zoals ETH, BSC, Polygon, enz. Deze blockchains draaien op meerdere clients met hun eigen foutdefinities. Je kunt de fouten die in de broncode van de node-client worden genoemd ook hier bekijken:


Mocht u andere foutcodes tegenkomen, laat het ons dan weten door een ticket in te dienen. We helpen u graag verder

Deel dit document