EIP-234 JSON-RPC 필터에 blockHash 옵션 추가 (Add `blockHash` to JSON-RPC filter options.)

최종 확정 · 네트워크·노드 · 원문 상태 Final · 2017-03-24 작성

로그 조회(eth_getLogs, eth_newFilter)의 필터 옵션에 blockHash를 추가해 블록 번호 대신 블록 해시로 특정 블록의 로그를 정확히 조회할 수 있게 합니다.

왜 필요한가

탈중앙 앱은 노드에 필터를 걸어 새 로그를 받아봅니다. 그런데 네트워크가 끊기거나 노드가 재시작되면 필터 상태가 사라지고 그 사이에 체인 재구성(reorg, 최근 블록이 다른 블록으로 교체되는 일)이 일어나면 앱은 삭제된 로그를 영영 알지 못합니다. 이를 피하려고 앱이 최근 블록을 직접 들고 있다가 블록 번호로 로그를 조회하는 방법도 있지만 조회하는 순간 재구성이 일어나면 같은 번호의 다른 블록 로그를 받게 됩니다. 특히 결과가 빈 배열이면 원래 블록에 로그가 없었던 것인지, 엉뚱한 블록을 조회한 것인지 구분할 방법이 없어 복구를 보장할 수 없습니다. 이 EIP는 블록 해시로 로그를 조회하게 해서 이 불확실성을 없앱니다.

무엇이 바뀌나

지금

EIP-234 이후

누구에게 영향이 있나

심층 설명

blockHash 파라미터 명세

eth_newFilter가 쓰는 필터 옵션(eth_getLogs도 같은 옵션을 씁니다)에 선택 파라미터 blockHash를 추가합니다. 값은 블록 해시 하나입니다. 요청을 받은 노드는 해당 해시의 블록을 찾지 못하면 오류를 돌려주고 찾으면 평소처럼 필터 조건에 맞는 로그를 그 블록 하나로 제한해 돌려줍니다. 내부적으로는 fromBlock과 toBlock 옵션과 비슷하게 동작할 것으로 원문은 설명합니다.

fromBlock·toBlock과 상호 배타

블록 해시와 블록 번호 범위를 같이 지정하는 것은 의미가 없습니다. 그래서 blockHash는 fromBlock, toBlock과 함께 쓸 수 없는 상호 배타 관계로 두는 것이 맞다고 원문은 정리합니다. 기존 필드를 바꾸지 않고 옵션을 추가하는 방식이라 하위 호환성 문제는 이 점이 전부입니다.

번호 기반 조회의 한계

구독과 필터에만 의존하면 로그 추가와 삭제를 모두 안정적으로 받을 수 없습니다. 웹소켓이 끊긴 사이에 재구성이 일어나면 삭제 알림을 받을 수 없고, HTTP 폴링에서도 폴링 사이에 노드가 재시작되고 재구성이 겹치면 같은 문제가 생깁니다. 번호로 로그를 조회하면 그 사이에 재구성된 다른 블록의 로그를 받을 수 있는데, 로그가 있으면 로그 안의 블록 해시로 걸러낼 수라도 있지만 빈 배열이 오면 블룸 필터의 거짓 양성으로 원래 빈 것인지, 모르는 블록의 빈 결과인지 구분할 수 없습니다. 어느 쪽으로 가정해도 복구를 보장하는 선택지가 없다는 것이 원문의 핵심 논증입니다.

권장 클라이언트 설계

원문이 제시하는 견고한 설계는 이렇습니다. 클라이언트가 최근 n개 블록을 내부에 유지하고 새 블록만 구독하거나 폴링합니다. 새 블록을 받으면 내부 모델과 대조해 부모를 채우거나 블록을 되돌려 동기화합니다. 이 방식은 어떤 단절, 재구성, 장애 조합도 감당할 수 있습니다. 단일 노드에 묶이지 않고 여러 노드를 라운드로빈으로 쓸 수 있다는 부수 이점도 있습니다. 여기에 해시 기반 로그 조회가 더해지면 결과를 받았을 때 그 블록의 결과임이 보장되고 오류를 받으면 해당 블록을 되돌리고 최신을 다시 받는 식으로 명확히 대응할 수 있습니다.

오류 응답 형식

요청한 해시의 블록이 없으면 code가 -32000, message가 "Block not found.", data가 요청한 블록 해시인 오류를 돌려줍니다. 블록이 있으면 그 블록의 모든 로그를 돌려주고 필터 옵션에 topics를 추가하면 조건에 맞게 걸러진 로그만 돌려줍니다.

상태와 구현

이 EIP는 2017년 3월 24일에 만들어졌고 상태는 Final로 확정되었습니다. 인터페이스(Interface) 범주의 표준이며 EIP-1474를 전제로 합니다. 구현으로는 Geth가 완료된 것으로 원문에 표시되어 있습니다.

EIP 원문 · ← EIPs