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 códigos de erro HTTP mais comuns com que se pode deparar, o que significam e o que pode fazer para os evitar.
400Erro de pedido
Tipo de pedido HTTP incorreto (por exemplo, utilização de GET em vez de POST) ou caracteres inválidos
401Não autorizado
Isto pode acontecer quando um ou vários requisitos de segurança não são cumpridos, tais como uma autenticação por token incorreta, um endereço IP que não consta da lista de endereços autorizados, um JWT inválido, etc.
403Acesso proibido
Terminal desativado (uma das razões para isso poderá ser um pagamento em atraso)
403Acesso proibido - rastreio personalizado não encontrado
O código de rastreio personalizado não consta da lista de permissões (Envie um pedido de assistência para que seja submetido ao processo de aprovação)
404Não encontrado
URL incorreta ou método incorreto
413Conteúdo demasiado grande
O corpo do pedido é demasiado grande
413Entidade da solicitação demasiado grande
As funções `eth_getLogs` e `eth_newFilter` estão limitadas a um intervalo de 10 000 blocos. Aplicamos um limite de 10 000 blocos ao solicitar registos e eventos.
429Demasiadas solicitações
O número de pedidos por segundo (RPS) das suas solicitações é superior ao permitido pelo seu plano. Saiba mais sobre os erros 429 na nossa documentação de apoio.
500Erro interno do servidor
Envie um pedido de assistência para que a equipa de apoio analise os erros o mais rapidamente possível
503Serviço indisponível
Envie um pedido de assistência para que a equipa de apoio analise os erros o mais rapidamente possível
Exemplo de código de erro HTTP
O fragmento de código abaixo é um exemplo do Código de Erro 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.
-32700Erro de análise
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 não 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
O trecho de código abaixo é um exemplo do código de erro -32601.
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:
Pontos finais na barra lateral
Selecionar o seu terminal
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.