EIP-1898 블록 해시로 상태를 조회하는 옵션 (Add `blockHash` to defaultBlock methods)

최종 확정 · 네트워크·노드 · 원문 상태 Final · 2019-04-01 작성

잔액이나 컨트랙트 상태를 조회하는 JSON-RPC 메서드의 블록 지정 파라미터에 블록 번호뿐 아니라 블록 해시도 쓸 수 있게 합니다. 어떤 블록을 기준으로 조회하는지 애매함이 사라집니다.

왜 필요한가

지갑이나 앱은 노드에 JSON-RPC 요청을 보내 잔액, 컨트랙트 코드, 저장소 값 같은 상태를 읽습니다. 그런데 기존에는 블록을 번호나 "latest" 같은 문자열로만 지정할 수 있었습니다. 블록 번호는 체인이 재구성(리오그, reorg)되면 같은 번호가 다른 블록을 가리킬 수 있어서 여러 번 나눠 조회하는 동안 기준 블록이 바뀌어 버릴 수도 있습니다. 예를 들어 송금 직후 지갑이 보낸 사람과 받는 사람의 잔액을 차례로 조회하는 사이에 리오그가 일어나면 두 잔액이 서로 맞지 않게 됩니다. 블록 해시는 블록마다 고유하므로, 해시로 지정하면 여러 번 조회해도 항상 정확히 같은 블록의 상태를 읽을 수 있습니다. 노드가 클라이언트별 상태를 저장하거나 지속 연결을 유지하지 않아도 됩니다.

무엇이 바뀌나

지금

EIP-1898 이후

누구에게 영향이 있나

심층 설명

적용 대상 메서드

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의 일반화로 볼 수 있다고 설명합니다. 로그 조회에만 가능하던 해시 기반 지정을 상태 조회 전반으로 넓힌 것입니다. 보안 고려 사항은 없다고 명시되어 있습니다.

EIP 원문 · ← EIPs