JSON-RPC總覽
eth_getLogs:區塊範圍限制、參數與 CU
使用 eth_getLogs 查詢事件日誌:過濾參數、傳回值、CU 權重、各鏈區塊範圍限制與 logs_range_too_large 報錯處理。
用途
按過濾條件查詢區塊範圍內的日誌(事件)。
計算單位(CU)與價格
單次呼叫 CU
30 CU
每百萬次呼叫價格(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 錯誤參考。
最後更新: