eth_getLogs: límite de rango de bloques, parámetros y CU

Consulte logs de eventos con eth_getLogs: parámetros de filtro, valores de retorno, pesos de CU, límites de rango de bloques por cadena y gestión de logs_range_too_large.

Resumen

Consulta logs de eventos dentro de un rango de bloques que coincidan con un filtro.

Unidades de cómputo (CU) y precios

CU por llamada

30 CU

Precio por 1M de llamadas (USD)

$3.00

Parámetros

Parámetro	Tipo	Descripción
`filter`	`object`	Objeto de filtro: fromBlock y toBlock (número de bloque o etiqueta, por defecto latest), address (una dirección o array de direcciones), topics (un array donde cada elemento es null, un topic de 32 bytes o un array de topics), o blockHash para consultar un único bloque.

Devuelve

Tipo: ARRAY
Descripción: Array de objetos de log en el orden de los bloques; un array vacío cuando no hay coincidencias.

Notas

blockHash es mutuamente excluyente con fromBlock/toBlock; los topics se comparan por posición, y null representa cualquier valor en esa posición. Un rango de bloques superior a max_logs_block_range de la cadena (ver GET /v1/chains) devuelve -32602.

Ejemplo de solicitud

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
  }'

Cadenas compatibles

Disponible en las 9 cadenas compatibles.

Para consultas amplias, siga la guía de límite de rango de bloques y consultas fragmentadas de eth_getLogs. Los detalles del error y las acciones recomendadas se encuentran en la referencia de logs_range_too_large.