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

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
}

Starknet RPC Error Codes

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

1Failed to receive transaction

Sequencer rejected the transaction during validation. Verify transaction format and required fields

10No trace available

Trace data not available for the transaction. Verify the transaction hash is correct and exists on the network

20Contract not found

The specified contract address does not exist on the network

21Invalid message selector

Function selector does not exist in the contract ABI

22Invalid call data

Calldata is malformed or contains invalid parameters. Verify parameter types and encoding

24Block not found

The requested block does not exist. Check block number/hash or wait for sync

26Invalid block hash

Block hash format is invalid. Ensure it's a valid hexadecimal string with correct length

27Invalid transaction index

Transaction index is out of range for this block

28Class hash not found

The specified class hash has not been declared on the network

29Transaction hash not found

No transaction found with the provided hash

31Page size too big

Page size exceeds the maximum allowed limit.

32No blocks

No blocks available in the specified range

33Invalid continuation token

The continuation token is invalid or has expired

34Too many keys in filter

Filter contains more keys than the maximum allowed

40Contract error

An error occurred during contract execution

41Transaction execution error

Transaction failed to execute. Check contract logic and resource limits

51Class already declared

Class already exists on the network. Duplicate declarations are not allowed

52Invalid transaction nonce

Invalid nonce for the account. Use the correct sequential nonce value

53Insufficient max fee

Max fee too low. Increase the fee to cover transaction costs

54Insufficient account balance

Account balance too low. Ensure sufficient funds to cover the transaction fee

55Validation failure

Account validation failed. Check your signature and account contract logic

56Compilation failed

Contract compilation failed. Fix Cairo code syntax and compilation errors

57Contract class size is too large

Contract class too large. Reduce the contract size to fit within network limits

58Non account

Sender is not an account contract. Only account contracts can send transactions

59Duplicate transaction

Transaction already exists in mempool. Avoid submitting duplicate transactions

60Compiled class hash mismatch

The compiled class hash does not match the declared hash

61Unsupported transaction version

Transaction version not supported. Use a compatible transaction version

62Unsupported contract class version

Contract class version not supported. Use a compatible Cairo compiler version

63Unexpected error

Unexpected server error occurred. Submit a ticket if the issue persists

Starknet RPC Error Code Example

The code snippet below is an example of Error Code 20.

{
  "error": {
    "code": 20,
    "message": "Contract not found"
  },
  "id": 1,
  "jsonrpc": "2.0"
}

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