Quicknode proporciona registros de errores para tus puntos finales RPC. Identifica y resuelve fácilmente los problemas consultando información detallada sobre los errores directamente desde tu panel de control.

Códigos de error HTTP

Veamos cuáles son los errores HTTP más habituales con los que te puedes encontrar, qué significan y qué puedes hacer para evitarlos.

400Solicitud incorrecta

Tipo de solicitud HTTP incorrecto (por ejemplo, se ha utilizado GET en lugar de POST) o caracteres no válidos

401No autorizado

Esto puede ocurrir cuando no se cumplen uno o varios requisitos de seguridad, como una autenticación mediante token incorrecta, una dirección IP que no figura en la lista blanca, un JWT no válido, etc.

403Prohibido

Terminal desactivado (una de las razones podría ser un pago atrasado)

403Prohibido: no se ha encontrado el seguimiento personalizado

El código de seguimiento personalizado no figura en la lista blanca (envía una solicitud para iniciar el proceso de aprobación)

404No encontrado

URL incorrecta o método incorrecto

413Contenido demasiado grande

El cuerpo de la solicitud es demasiado grande

413Entidad de solicitud demasiado grande

Las funciones `eth_getLogs` y `eth_newFilter` están limitadas a un rango de 10 000 bloques. Aplicamos un límite de 10 000 bloques al solicitar registros y eventos.

429Demasiadas solicitudes

El número de solicitudes por segundo (RPS) supera el límite permitido por tu plan. Obtén más información sobre los errores 429 en nuestra documentación de soporte técnico.

500Error interno del servidor

Envía una solicitud para que el equipo de asistencia revise los errores lo antes posible.

503Servicio no disponible

Envía una solicitud para que el equipo de asistencia revise los errores lo antes posible.

Ejemplo de código de error HTTP

El fragmento de código que aparece a continuación es un ejemplo del código de error 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"
}

Registros de los terminales

Quicknode proporciona registros de tus puntos finales RPC para ayudarte a diagnosticar problemas. Puedes consultar los registros directamente en tu panel de control de Quicknode accediendo a:

1. Elementos de la barra lateral
2. Seleccionar tu dispositivo
3. Abrir la pestaña «Registros »

Puedes filtrar los registros por intervalo de tiempo, tipo de respuesta, método y red.

Qué datos se registran

Solicitudes al punto final
: solicitudes realizadas a tu punto final, incluyendo el estado HTTP, el método de solicitud, el método o la ruta RPC y la marca de tiempo.

Detalles del error
Cuando están disponibles, las solicitudes fallidas incluyen detalles del error, como códigos de error RPC, el contenido de las solicitudes y las respuestas, y enlaces a documentación relacionada.

Restricciones en la tala

La disponibilidad de los registros puede variar en función del método, el tipo de respuesta, la red y el plan. Para mantener un rendimiento óptimo de los terminales, el registro de datos funciona según el principio de «mejor esfuerzo». Es posible que algunos registros se descarten durante los periodos de mucho tráfico para mantener una baja latencia.

Conservación y acceso

Los planes «Build» y «Scale» incluyen acceso al panel de control con retención estándar de registros. Los planes «Enterprise» ofrecen períodos de retención ampliados y acceso programático mediante API para la recuperación de registros.

Si te aparecen otros códigos de error, háznoslo saber enviando un ticket. Estaremos encantados de ayudarte.