eth_getLogs: limite de intervalo de blocos, parâmetros e CU

Consulte logs de eventos com eth_getLogs: parâmetros de filtro, valores de retorno, pesos de CU, limites de intervalo de blocos por rede e tratamento de logs_range_too_large.

Visão geral

Consulte logs de eventos dentro de um intervalo de blocos que correspondam a um filtro.

Unidades de computação (CU) e preços

CU por chamada

30 CU

Preço por 1M de chamadas (USD)

$3.00

Parâmetros

Parâmetro	Tipo	Descrição
`filter`	`object`	Objeto de filtro: fromBlock e toBlock (número de bloco ou tag, padrão latest), address (um endereço ou array de endereços), topics (um array onde cada item é null, um tópico de 32 bytes ou um array de tópicos), ou blockHash para direcionar a um único bloco.

Retornos

Tipo: ARRAY
Descrição: Array de objetos de log na ordem dos blocos; um array vazio quando não houver correspondências.

Observações

blockHash é mutuamente exclusivo com fromBlock/toBlock; os tópicos são comparados por posição, e null representa qualquer valor nessa posição. Um intervalo de blocos maior que max_logs_block_range da rede (consulte GET /v1/chains) retorna -32602.

Exemplo de requisição

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "address": "0x0000000000000000000000000000000000000000",
        "fromBlock": "latest",
        "toBlock": "latest"
      }
    ],
    "id": 1
  }'

Redes suportadas

Disponível em todas as 9 redes compatíveis.

Para consultas amplas, siga o guia de limite de intervalo de blocos do eth_getLogs e consultas em partes. Detalhes do erro e ações recomendadas estão na referência de logs_range_too_large.