Quicknode met à votre disposition des journaux d'erreurs pour vos points de terminaison RPC. Identifiez et résolvez facilement les problèmes en consultant les informations détaillées sur les erreurs directement depuis votre tableau de bord.

Codes d'erreur HTTP

Voyons ensemble les erreurs HTTP les plus courantes que vous pouvez rencontrer, ce qu'elles signifient et comment les éviter.

400Erreur de requête

Type de requête HTTP incorrect (par exemple, utilisation de GET au lieu de POST) ou caractères non valides

401Non autorisé

Cela peut se produire lorsqu'une ou plusieurs conditions de sécurité ne sont pas remplies, par exemple en cas d'authentification par jeton incorrecte, d'adresse IP ne figurant pas sur la liste blanche, de JWT non valide, etc.

403Accès interdit

Terminal désactivé (cela peut notamment être dû à un paiement en retard)

403Accès interdit - trace personnalisée introuvable

Le code de suivi personnalisé ne figure pas sur la liste blanche (envoyez une demande d'assistance pour lancer la procédure de validation)

404Page introuvable

URL incorrecte ou méthode incorrecte

413Contenu trop volumineux

Le corps de la requête est trop volumineux

413Entité de requête trop volumineuse

Les fonctions `eth_getLogs` et `eth_newFilter` sont limitées à une plage de 10 000 blocs. Nous appliquons une limite de 10 000 blocs lors des requêtes de journaux et d'événements.

429Trop de requêtes

Le nombre de requêtes par seconde (RPS) dépasse la limite autorisée par votre forfait. Pour en savoir plus sur les erreurs 429, consultez notre documentation d'assistance.

500Erreur interne du serveur

Envoyez une demande d'assistance afin que l'équipe d'assistance puisse examiner ces erreurs dès que possible

503Service indisponible

Envoyez une demande d'assistance afin que l'équipe d'assistance puisse examiner ces erreurs dès que possible

Exemple de code d'erreur HTTP

L'extrait de code ci-dessous illustre le code d'erreur 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"
}

Journaux des terminaux

Quicknode fournit des journaux pour vos points de terminaison RPC afin de vous aider à diagnostiquer les problèmes. Vous pouvez consulter ces journaux directement dans votre tableau de bord Quicknode en accédant à :

1. Éléments de la barre latérale
2. Sélection de votre terminal
3. Ouvrir l'onglet « Journaux »

Vous pouvez filtrer les journaux par plage horaire, type de réponse, méthode et réseau.

Quelles sont les données enregistrées ?

Requêtes adressées au point de terminaison
: requêtes adressées à votre point de terminaison, y compris le statut HTTP, la méthode de requête, la méthode RPC ou le chemin d'accès, ainsi que l'horodatage.

Détails de l'erreur
Lorsque ces informations sont disponibles, les requêtes ayant échoué incluent des détails sur l'erreur, tels que les codes d'erreur RPC, le contenu des requêtes et des réponses, ainsi que des liens vers la documentation correspondante.

Restrictions en matière d'exploitation forestière

La disponibilité des journaux peut varier en fonction de la méthode, du type de réponse, du réseau et du forfait. Afin de garantir des performances optimales des terminaux, la journalisation fonctionne selon le principe du « meilleur effort ». Certains journaux peuvent être supprimés pendant les périodes de fort trafic afin de maintenir une faible latence.

Conservation et accès

Les formules « Build » et « Scale » incluent l'accès au tableau de bord avec une durée de conservation standard des journaux. Les formules « Enterprise » offrent des durées de conservation prolongées ainsi qu'un accès programmatique via API pour la récupération des journaux.

Si vous rencontrez d'autres codes d'erreur, n'hésitez pas à nous en faire part en créant un ticket. Nous serons ravis de vous aider.