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

Laten we eens kijken naar de veelvoorkomende HTTP-foutcodes die je kunt tegenkomen, wat ze betekenen en wat je kunt doen om ze te voorkomen.

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
}

Bitcoin RPC Error Codes

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

-32700Parseerfout

Invalid JSON was received by the server; check JSON syntax and formatting

-32600Invalid Request

The JSON sent is not a valid Request object; verify the request structure matches JSON-RPC 2.0 specification

-32601Methode niet gevonden

The method does not exist or is not available; verify method name spelling or check if the method requires a specific marketplace add-on (e.g., Blockbook methods like bb_gettx require the Blockbook add-on to be enabled)

-32602Invalid params

Invalid method parameter(s); double check parameter types, values, and order against Bitcoin Core documentation

-32603Internal error

Internal JSON-RPC error; this typically indicates an issue with the Bitcoin node itself

-1Miscellaneous error

General error that doesn't fit other categories; check error message for specific details

-2Forbidden by safe mode

Server is in safe mode, and command is not allowed in safe mode

-3Type error

Unexpected type was passed as parameter; ensure parameter types match expected values

-4Wallet error

Unspecified problem with wallet (key not found etc.)

-5Invalid address or key

Invalid Bitcoin address or key format; verify address/key format and network (mainnet vs testnet)

-6Insufficient funds

Not enough funds in wallet or account

-7Out of memory

Ran out of memory during operation

-8Invalid parameter

Invalid, missing or duplicate parameter

-9Client not connected

Bitcoin is not connected

-10Client in initial download

Still downloading initial blocks

-11Invalid account name

Invalid account name

-12Keypool ran out

Keypool ran out, call keypoolrefill first

-13Wallet unlock needed

Enter the wallet passphrase with walletpassphrase first

-14Wallet passphrase incorrect

The wallet passphrase entered was incorrect

-15Wrong encryption state

Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.)

-16Wallet encryption failed

Failed to encrypt the wallet

-17Wallet already unlocked

Wallet is already unlocked

-18Wallet not found

Invalid wallet specified

-19Wallet not specified

No wallet specified (error when there are multiple wallets loaded)

-20Database error

Database read/write error; this may indicate corruption or disk issues

-22Deserialization error

Error parsing or validating structure in raw format; verify the raw transaction or block hex is properly formatted

-23Node already added

Node is already added

-24Node not added

Node has not been added before

-25Verify error

General error during transaction or block submission

-26Verify rejected

Transaction or block was rejected by network rules

-27Verify already in chain

Transaction already in chain

-28Client in warmup

Client still warming up

-29Node not connected

Node to disconnect not found in connected nodes

-30Invalid IP or subnet

Invalid IP/Subnet

-31P2P disabled

No valid connection manager instance found

Bitcoin RPC Error Code Example

Het onderstaande codefragment is een voorbeeld van foutcode -32601.

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32601,
    "message": "Method not found"
  },
  "id": 1
}

Eindpuntlogboeken

Quicknode biedt logbestanden voor je RPC-eindpunten om je te helpen bij het opsporen van problemen. Je kunt de logbestanden rechtstreeks in je Quicknode-dashboard bekijken door naar het volgende te gaan:

1. Eindpunten in de zijbalk
2. Uw eindpunt selecteren
3. Het tabblad 'Logs ' openen

Je kunt logbestanden filteren op tijdsperiode, reactietype, methode en netwerk.

Wat wordt geregistreerd

Verzoeken aan het eindpunt
Verzoeken die naar uw eindpunt zijn verzonden, inclusief de HTTP-status, de verzoekmethode, de RPC-methode of het pad, en de tijdstempel.

Foutdetails
Indien beschikbaar, bevatten mislukte verzoeken foutdetails zoals RPC-foutcodes, de inhoud van verzoeken en antwoorden, en links naar relevante documentatie.

Beperkingen bij het loggen

De beschikbaarheid van logbestanden kan variëren afhankelijk van de methode, het type reactie, het netwerk en het abonnement. Om optimale prestaties van de eindpunten te waarborgen, werkt het loggen op basis van ‘best effort’. Sommige logbestanden kunnen tijdens periodes met veel verkeer worden weggelaten om een lage latentie te behouden.

Bewaring en toegang

Bij de Build- en Scale-abonnementen is toegang tot het dashboard inbegrepen, met standaard bewaartermijnen voor logbestanden. Enterprise-abonnementen bieden langere bewaartermijnen en programmatische API-toegang voor het ophalen van logbestanden.

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