Para consultar el índice completo de la documentación, consulta el archivo llms.txt. Para obtener una versión en Markdown de esta página, añade la extensión .md a la URL.
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 códigos de error 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
}
Fantom RPC Error Codes
Let's look at the common Fantom RPC Error Codes you can encounter, what they mean and what you can do to prevent them.
-32000Encabezado no encontrado / Bloque no encontrado
El bloque solicitado no existe en el nodo. El número de bloque es incorrecto o el nodo al que te estás conectando aún no está sincronizado. Utiliza un mecanismo de reintento con un tiempo de espera incremental.
-32 000Se ha alcanzado el límite de la pila
Normalmente se trata de un error o fallo en un contrato inteligente: se ha alcanzado el límite de la pila, 1024 (1023).
-32000Se ha producido un error en el controlador del método
Error interno del cliente de la cadena de bloques, que podría deberse a un fallo del cliente. Envía un ticket para que podamos comprobar los nodos.
-32 000Tiempo de espera de ejecución agotado
Añade el parámetro «timeout» en tu solicitud para anular el tiempo de espera predeterminado del cliente.
-32 000El nonce es demasiado bajo
El valor de nonce especificado en tu transacción es inferior al siguiente nonce válido para la cuenta del remitente.
-32 000Filtro no encontrado
Se ha superado el tiempo de espera del filtro; tendrás que volver a crearlo.
-32001Recurso no encontrado
El recurso solicitado no existe o no está disponible.
-32002Recurso no disponible
El recurso solicitado no está disponible, ya sea de forma temporal o permanente.
-32003Transacción rechazada
No se ha podido crear la transacción debido a un error de validación o a una falta de recursos.
-32004Método no compatible
El método solicitado no está implementado ni es compatible con el servidor.
-32005Límite superado
La solicitud supera el límite o la cuota permitida.
-32006Versión de JSON-RPC no compatible
El servidor no admite la versión de JSON-RPC especificada.
-32009Solicitudes de rastreo limitadas
Hemos limitado el método de depuración y seguimiento a un RPS específico para evitar que los nodos se sobrecarguen.
-32010El coste de la transacción supera el límite de gas
El límite de gas está fijado en un valor demasiado bajo
-32011Error de red
Este error se produce cuando hay un problema con la conexión entre el cliente y el servidor, como un tiempo de espera agotado o una conexión interrumpida.
-32015Error de ejecución de la máquina virtual
Error en la ejecución del contrato inteligente
-32600Solicitud no válida
La solicitud JSON tiene un formato incorrecto o le faltan campos obligatorios. Asegúrate de que siga el formato esperado.
-32601Método no encontrado
Normalmente se trata de un error tipográfico en el nombre del método; comprueba si hay errores ortográficos.
-32601No se ha podido analizar la solicitud
El cuerpo de la solicitud es incorrecto; comprueba de nuevo los parámetros del método
-32602Parámetros no válidos: falta el prefijo 0x
Solicitud incorrecta; falta el 0x en la dirección. El valor hexadecimal
-32602Se ha superado el límite del rango de bloques
Las funciones `eth_getLogs` y `eth_newFilter` tienen un límite de 10 000 bloques. Consulta una explicación detallada en nuestra documentación de soporte técnico.
-32603Error interno de JSON-RPC
Este error suele deberse a una carga útil errónea o no válida.
-32612Las trazas personalizadas están bloqueadas
Envía una solicitud para que se activen los trazos personalizados.
-32613No se permite el seguimiento personalizado
No se ha encontrado el rastreo personalizado entre los rastreos personalizados permitidos. Envía una solicitud para que este rastreo se incluya en la lista blanca.
-32700Error de análisis
Se ha recibido un JSON no válido. El servidor ha detectado un error al analizar el texto JSON.
3Ejecución revertida
La transacción se ha revertido durante su ejecución, probablemente debido a que no se cumplían las condiciones, a una cantidad insuficiente de gas o a un error en el contrato.
Fantom RPC Error Code Example
El fragmento de código que aparece a continuación es un ejemplo del código de error -32601.
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32601,
"message": "the method eth_randomMethod does not exist/is not available"
}
}
Los errores de RPC definidos anteriormente son una recopilación de errores habituales con los que te puedes encontrar al desarrollar en cadenas como ETH, BSC, Polygon, etc. Estas cadenas se ejecutan en múltiples clientes, cada uno con sus propias definiciones de error. También puedes consultar aquí los errores mencionados en el código fuente del cliente del nodo:
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:
Elementos de la barra lateral
Seleccionar tu dispositivo
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.