eth_getLogs: лимит диапазона блоков, параметры и CU

Запрос логов событий с помощью eth_getLogs: параметры фильтра, возвращаемые значения, веса в CU, лимиты диапазона блоков по сетям и обработка logs_range_too_large.

Сводка

Запрашивает логи событий в диапазоне блоков, соответствующие фильтру.

Вычислительные единицы (CU) и цены

CU за вызов

30 CU

Цена за 1M вызовов (USD)

$3.00

Параметры

Параметр	Тип	Описание
`filter`	`object`	Объект фильтра: fromBlock и toBlock (номер блока или тег, по умолчанию latest), address (один адрес или массив адресов), topics (массив, где каждый элемент — null, 32-байтовый топик или массив топиков) или blockHash для обращения к одному блоку.

Возвращаемое значение

Тип: ARRAY
Описание: Массив объектов логов в порядке следования блоков; пустой массив, если совпадений нет.

Примечания

blockHash является взаимоисключающим с fromBlock/toBlock; топики сопоставляются по позиции, а null означает любое значение в этой позиции. Диапазон блоков, превышающий max_logs_block_range сети (см. GET /v1/chains), возвращает -32602.

Пример запроса

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

Поддерживаемые сети

Доступно во всех 9 поддерживаемых сетях.

Для запросов с широким диапазоном блоков обратитесь к руководству по лимиту диапазона блоков eth_getLogs и составным запросам. Сведения об ошибке и рекомендуемые действия приведены в справочнике по logs_range_too_large.