eth_getLogs: giới hạn phạm vi khối, tham số và CU

Truy vấn log sự kiện với eth_getLogs: tham số bộ lọc, giá trị trả về, trọng số CU, giới hạn phạm vi khối theo chuỗi và cách xử lý logs_range_too_large.

Tổng quan

Truy vấn log sự kiện trong phạm vi khối khớp với một bộ lọc.

Compute Units (CU) và bảng giá

CU mỗi lệnh gọi

30 CU

Giá cho mỗi 1M lệnh gọi (USD)

$3.00

Tham số

Tham số	Kiểu	Mô tả
`filter`	`object`	Đối tượng bộ lọc: fromBlock và toBlock (số hiệu khối hoặc thẻ, mặc định latest), address (một địa chỉ hoặc mảng địa chỉ), topics (mảng trong đó mỗi phần tử là null, topic 32 byte hoặc mảng các topic), hoặc blockHash để nhắm mục tiêu vào một khối duy nhất.

Giá trị trả về

Kiểu: ARRAY
Mô tả: Mảng các đối tượng log theo thứ tự khối; mảng rỗng khi không có kết quả khớp.

Ghi chú

blockHash loại trừ lẫn nhau với fromBlock/toBlock; topic được khớp theo vị trí, và null biểu thị bất kỳ giá trị nào tại vị trí đó. Phạm vi khối lớn hơn max_logs_block_range của chuỗi (xem GET /v1/chains) sẽ trả về -32602.

Ví dụ yêu cầu

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

Chuỗi được hỗ trợ

Khả dụng trên tất cả 9 chuỗi được hỗ trợ.

Đối với các truy vấn phạm vi rộng, hãy làm theo hướng dẫn về giới hạn phạm vi khối eth_getLogs và truy vấn theo phân đoạn. Chi tiết lỗi và các hành động được khuyến nghị có trong tài liệu tham khảo logs_range_too_large.