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과 상호 배타적입니다. 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 레퍼런스에서 확인할 수 있습니다.