O Quicknode disponibiliza registos de erros para os seus pontos finais RPC. Identifique e resolva facilmente os problemas, consultando informações detalhadas sobre os erros diretamente a partir do seu painel de controlo.

Códigos de erro HTTP

Vamos ver os erros HTTP mais comuns com que se pode deparar, o que significam e o que pode fazer para os evitar.

400Erro de pedido

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

401Não autorizado

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

403Acesso proibido

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

404Não encontrado

Incorrect URL or incorrect method

413Conteúdo demasiado grande

O corpo do pedido é demasiado grande

429Demasiadas solicitações

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

500Erro interno do servidor

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

503Serviço indisponível

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

Exemplo de código de erro 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
}

Registos dos terminais

O Quicknode disponibiliza registos dos seus pontos finais RPC para o ajudar a diagnosticar problemas. Pode visualizar os registos diretamente no seu painel de controlo do Quicknode, acedendo a:

1. Pontos finais na barra lateral
2. Selecionar o seu terminal
3. Abrir o separador «Registos »

Pode filtrar os registos por intervalo de tempo, tipo de resposta, método e rede.

O que é registado

Pedidos ao ponto final
Pedidos efetuados ao seu ponto final, incluindo o estado HTTP, o método de pedido, o método ou caminho RPC e a data e hora.

Detalhes do erro
Sempre que disponíveis, os pedidos com falha incluem detalhes do erro, tais como códigos de erro RPC, corpos dos pedidos e das respostas e links para documentação relacionada.

Limitações da exploração florestal

A disponibilidade dos registos pode variar consoante o método, o tipo de resposta, a rede e o plano. Para manter um desempenho ideal do terminal, o registo funciona com base no princípio do «melhor esforço». Alguns registos podem ser descartados durante períodos de tráfego intenso, a fim de preservar uma baixa latência.

Conservação e acesso

Os planos «Build» e «Scale» incluem acesso ao painel de controlo com retenção padrão de registos. Os planos «Enterprise» oferecem períodos de retenção alargados e acesso programático via API para a recuperação de registos.

Se estiver a receber outros códigos de erro, informe-nos enviando um pedido de assistência. Teremos todo o prazer em ajudá-lo