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
}

Starknet RPC Error Codes

When working with Starknet, understanding its API error codes is essential for effective troubleshooting and smooth application operation.

1Failed to receive transaction

Sequencer rejected the transaction during validation. Verify transaction format and required fields

10No trace available

Trace data not available for the transaction. Verify the transaction hash is correct and exists on the network

20Contract not found

The specified contract address does not exist on the network

21Invalid message selector

Function selector does not exist in the contract ABI

22Invalid call data

Calldata is malformed or contains invalid parameters. Verify parameter types and encoding

24Block not found

The requested block does not exist. Check block number/hash or wait for sync

26Invalid block hash

Block hash format is invalid. Ensure it's a valid hexadecimal string with correct length

27Invalid transaction index

Transaction index is out of range for this block

28Class hash not found

The specified class hash has not been declared on the network

29Transaction hash not found

No transaction found with the provided hash

31Page size too big

Page size exceeds the maximum allowed limit.

32No blocks

No blocks available in the specified range

33Invalid continuation token

The continuation token is invalid or has expired

34Too many keys in filter

Filter contains more keys than the maximum allowed

40Contract error

An error occurred during contract execution

41Transaction execution error

Transaction failed to execute. Check contract logic and resource limits

51Class already declared

Class already exists on the network. Duplicate declarations are not allowed

52Invalid transaction nonce

Invalid nonce for the account. Use the correct sequential nonce value

53Insufficient max fee

Max fee too low. Increase the fee to cover transaction costs

54Insufficient account balance

Account balance too low. Ensure sufficient funds to cover the transaction fee

55Validation failure

Account validation failed. Check your signature and account contract logic

56Compilation failed

Contract compilation failed. Fix Cairo code syntax and compilation errors

57Contract class size is too large

Contract class too large. Reduce the contract size to fit within network limits

58Non account

Sender is not an account contract. Only account contracts can send transactions

59Duplicate transaction

Transaction already exists in mempool. Avoid submitting duplicate transactions

60Compiled class hash mismatch

The compiled class hash does not match the declared hash

61Unsupported transaction version

Transaction version not supported. Use a compatible transaction version

62Unsupported contract class version

Contract class version not supported. Use a compatible Cairo compiler version

63Unexpected error

Unexpected server error occurred. Submit a ticket if the issue persists

Starknet RPC Error Code Example

The code snippet below is an example of Error Code 20.

{
  "error": {
    "code": 20,
    "message": "Contract not found"
  },
  "id": 1,
  "jsonrpc": "2.0"
}

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