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

Incorrect HTTP request type (e.g. using GET instead of POST) or invalid characters

401No autorizado

One or more security requirements not met such as incorrect token auth, IP not in whitelist, invalid JWT, etc

403Prohibido

Endpoint disabled (one reason could be a past due payment)

403Forbidden — custom trace not found in allowed custom traces

Custom trace code not whitelisted; submit a ticket to go through the approval process

404No encontrado

Incorrect URL or incorrect method

413Contenido demasiado grande

El cuerpo de la solicitud es demasiado grande

429Demasiadas solicitudes

The requests per second (RPS) of your requests are higher than your plan allows; see support docs for details

500Error interno del servidor

Submit a ticket for the support team to investigate as soon as possible

503Servicio no disponible

Submit a ticket for the support team to investigate as soon as possible

Ejemplo de código de error HTTP

{
  "jsonrpc": "2.0",
  "error": {
    "code": 429,
    "message": "The requests per second (RPS) of your requests are higher than your plan allows."
  },
  "id": 1
}

Solana RPC Error Codes

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

-32002Transaction simulation failed / preflight check error

The transaction being sent has errors; double check params, signatures, and message

-32002Blockhash not found

The blockhash sent is not known by the validator yet; implement a retry mechanism

-32003Transaction signature verification failure

One or more signatures are invalid; verify private/public keys and signatures

-32004Block not available for slot

Timeout or block not retrievable; use a retry mechanism

-32005Node is unhealthy / behind by slots

Node is behind the tip; retry with backoff or try another endpoint

-32007Slot was skipped or missing due to snapshot jump

Requested block does not exist; verify the slot in a block explorer

-32009Slot was skipped or missing in long-term storage

The requested slot is missing from long-term storage; see support FAQ for details

-32010Key excluded from account secondary indexes

Unexpected payload or incorrect data for the method; ensure request body matches validator expectations

-32013Transaction signature length mismatch

Signature length is not as expected; re-encode or rebuild the transaction

-32014Block status not yet available

Block is pending or not yet synced; retry later

-32015Transaction version not supported

Use "maxSupportedTransactionVersion": 0 or upgrade client to support versioned transactions

-32016Minimum context slot not reached

The required context slot is too far in the future; lower the minimum context slot or retry later

-32602Invalid params

Flags/params are invalid; double check method parameters against Solana docs

Solana RPC Error Code Example

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Invalid param: Invalid"
  },
  "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.