EIP-1898 블록 해시로 상태를 조회하는 옵션 (Add `blockHash` to defaultBlock methods)
최종 확정 · 네트워크·노드 · 원문 상태 Final · 2019-04-01 작성
잔액이나 컨트랙트 상태를 조회하는 JSON-RPC 메서드의 블록 지정 파라미터에 블록 번호뿐 아니라 블록 해시도 쓸 수 있게 합니다. 어떤 블록을 기준으로 조회하는지 애매함이 사라집니다.
왜 필요한가
지갑이나 앱은 노드에 JSON-RPC 요청을 보내 잔액, 컨트랙트 코드, 저장소 값 같은 상태를 읽습니다. 그런데 기존에는 블록을 번호나 "latest" 같은 문자열로만 지정할 수 있었습니다. 블록 번호는 체인이 재구성(리오그, reorg)되면 같은 번호가 다른 블록을 가리킬 수 있어서 여러 번 나눠 조회하는 동안 기준 블록이 바뀌어 버릴 수도 있습니다. 예를 들어 송금 직후 지갑이 보낸 사람과 받는 사람의 잔액을 차례로 조회하는 사이에 리오그가 일어나면 두 잔액이 서로 맞지 않게 됩니다. 블록 해시는 블록마다 고유하므로, 해시로 지정하면 여러 번 조회해도 항상 정확히 같은 블록의 상태를 읽을 수 있습니다. 노드가 클라이언트별 상태를 저장하거나 지속 연결을 유지하지 않아도 됩니다.
무엇이 바뀌나
지금
- 상태 조회 시 블록을 번호나 "latest" 같은 문자열로만 지정할 수 있습니다
- 리오그가 일어나면 같은 블록 번호가 다른 블록을 가리켜 여러 조회 결과가 어긋날 수 있습니다
- 일관성을 지키려면 조회마다 eth_getBlockByNumber로 해시를 재확인하거나 비표준 확장에 의존해야 합니다
EIP-1898 이후
- 블록 파라미터에 blockHash를 담은 객체를 넣어 특정 블록을 정확히 지정할 수 있습니다
- 리오그가 일어나도 여러 번의 조회가 모두 같은 블록 상태를 읽습니다
- requireCanonical 옵션으로 그 블록이 현재 정규 체인에 있는지까지 확인할 수 있습니다
누구에게 영향이 있나
- 지갑·앱 개발자: 여러 상태를 나눠 조회할 때 리오그로 인한 불일치를 걱정하지 않아도 됩니다. 재확인과 재시도 로직이 필요 없어집니다.
- 클라이언트(노드) 팀: eth_getBalance 등 6개 메서드에서 새 블록 파라미터 형식과 두 가지 에러 응답을 구현해야 합니다.
- 사용자: 지갑이나 거래소 UI가 보여 주는 잔액, 주문 목록 같은 정보가 체인 재구성 중에도 서로 어긋나지 않게 됩니다.
심층 설명
적용 대상 메서드
defaultBlock 파라미터를 받는 상태 조회 메서드 6개가 대상입니다. eth_getBalance, eth_getStorageAt, eth_getTransactionCount, eth_getCode, eth_call, eth_getProof입니다. 기존 defaultBlock은 16진수 블록 번호(HEX String) 또는 "earliest", "latest", "pending", "safe", "finalized" 문자열만 허용했습니다.
새 블록 파라미터 형식: 객체
블록 해시(DATA)와 블록 번호(QUANTITY)는 둘 다 16진수 문자열이라 값만으로는 구분할 수 없습니다. 그래서 문자열에 해시를 바로 넣는 대신 OBJECT 형식을 새로 정의합니다. 객체에는 blockNumber(QUANTITY) 또는 blockHash(DATA) 필드를 넣습니다. 해당 블록을 찾지 못하면 JSON-RPC 에러를 내야 하며 권장 에러 코드는 -32001(Resource not found)입니다.
requireCanonical 플래그
blockHash를 쓸 때는 불리언 필드 requireCanonical을 추가로 줄 수 있고 기본값은 false입니다. false면 블록을 못 찾은 경우에만 에러를 냅니다. true면 블록이 노드 기준 정규 체인(canonical chain)에 없을 때도 에러를 내야 하며 권장 코드는 -32000(Invalid input)입니다. 두 에러는 호출자가 구분할 수 있도록 서로 다른 코드여야 합니다. 검사 순서는 블록 존재 확인이 먼저입니다. 블록이 없으면 정규 체인 여부 에러가 아니라 블록 없음 에러를 내야 합니다.
하위 호환과 동등 표현
기존 형식은 그대로 유지되고 새 객체 형식이 추가될 뿐이라 하위 호환됩니다. 블록 번호는 16진수 문자열로도, 새 객체 형식으로도 쓸 수 있습니다. 원문은 "earliest", "0x0", { "blockNumber": "0x0" }, 제네시스 블록 해시를 넣은 { "blockHash": "0xd4e5..." }, 그리고 requireCanonical을 true나 false로 붙인 형태가 모두 동등하다고 명시합니다.
기존 우회 전략의 한계
이 EIP 전에는 세 가지 전략이 쓰였습니다. 첫째, 블록 번호를 정해 두고 eth_call마다 eth_getBlockByNumber로 해시가 바뀌지 않았는지 확인하는 방식인데, 기본으로 O(n)번의 호출이 더 들고 재시도마다 또 O(n)번이 들며, 블록이 리오그로 빠졌다가 확인 전에 다시 들어오는 경우는 잡아내지 못합니다. 둘째, blockHash로 조회할 수 있는 로그에 의존하는 방식인데, 컨트랙트가 적절한 이벤트를 내보내지 않으면 쓸 수 없습니다. 셋째, parity_subscribe 같은 비표준 확장인데, 지속 연결이 필요하고 노드와의 결합이 커지며 링크드 리스트 순회처럼 호출 간 의존이 있는 경우를 처리하지 못합니다.
테스트 케이스가 정의하는 동작
eth_getStorageAt 기준으로 동작이 정의됩니다. 제네시스 블록은 blockNumber "0x0", 해시, requireCanonical true/false 어느 형태로 지정해도 같은 저장소 값을 돌려줍니다. 존재하지 않는 해시는 requireCanonical 값과 무관하게 항상 블록 없음 에러입니다. 정규 체인에 없는(non-canonical) 블록 해시는 requireCanonical이 없거나 false면 그 블록의 저장소 값을 돌려주고 true면 블록 비정규 에러를 냅니다.
상태와 EIP-234의 관계
이 EIP는 Final 상태로 확정된 표준입니다. eth_getLogs에 blockHash 파라미터를 도입한 EIP-234를 요구하며(requires: 234), 원문은 이 제안을 EIP-234의 일반화로 볼 수 있다고 설명합니다. 로그 조회에만 가능하던 해시 기반 지정을 상태 조회 전반으로 넓힌 것입니다. 보안 고려 사항은 없다고 명시되어 있습니다.