eth_getLogs：ブロック範囲制限、パラメータと CU

eth_getLogs によるイベントログのクエリ：フィルタパラメータ、戻り値、CU 重み付け、チェーンごとのブロック範囲制限、および logs_range_too_large のエラーハンドリング。

用途

フィルターに一致するブロック範囲内のイベントログを照会します。

Compute Unit（CU）と料金

呼び出しあたりの CU

30 CU

100 万回呼び出しあたりの料金（USD）

$3.00

パラメータ

パラメータ名	型	説明
`filter`	`object`	フィルターオブジェクト：fromBlock および toBlock（ブロック番号またはタグ、デフォルトは latest）、address（単一のアドレスまたはアドレス配列）、topics（各要素が null、32 バイトのトピック、またはトピック配列である配列）、または単一のブロックを対象とする blockHash。

戻り値

型: ARRAY
説明: ブロック順のログオブジェクト配列。一致するものがない場合は空の配列。

注意事項

blockHash は fromBlock/toBlock と排他です。topics は位置によって一致判定され、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 リファレンスに記載されています。