JSON-RPC總覽

eth_getLogs:區塊範圍限制、參數與 CU

使用 eth_getLogs 查詢事件日誌:過濾參數、傳回值、CU 權重、各鏈區塊範圍限制與 logs_range_too_large 報錯處理。

用途

按過濾條件查詢區塊範圍內的日誌(事件)。

計算單位(CU)與價格

單次呼叫 CU

30 CU

每百萬次呼叫價格(USD)

$3.00

參數

參數名類型說明
filterobject過濾物件: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 錯誤參考。

最後更新: