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
}

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.

-32700Error de análisis

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

-32601Método no encontrado

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

El fragmento de código que aparece a continuación es un ejemplo del código de error -32601.

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

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.