EIP-712 타입 구조화 데이터의 해싱과 서명 (Typed structured data hashing and signing)
최종 확정 · 보안·프라이버시 · 원문 상태 Final · 2017-09-12 작성
단순 바이트 문자열이 아닌 구조화된 데이터를 안전하게 해싱하고 서명하는 표준입니다. 지갑이 서명할 내용을 사람이 읽을 수 있는 형태로 보여줄 수 있게 됩니다.
왜 필요한가
블록체인 밖에서 메시지에 서명하고 그 서명을 온체인에서 쓰는 방식은 가스를 아끼고 트랜잭션 수를 줄여 주기 때문에 점점 많이 쓰이고 있습니다. 그런데 사용자가 서명하는 순간에 보이는 화면이 문제입니다. 기존 방식에서는 서명할 메시지가 의미를 알 수 없는 16진수 문자열로만 표시되어, 사용자는 자기가 무엇에 동의하는지 확인할 방법이 없었습니다. 또 구조화된 데이터를 해시로 바꾸는 작업 자체가 까다로워서, 각 앱이 자체 방식을 만들다 실수하면 시스템의 보안 성질이 깨집니다. 이 표준은 데이터를 그 구조 정보와 함께 인코딩하는 검증된 공통 방법을 정의해서 서명 내용을 사용자에게 보여 줄 수 있게 하고 앱마다 자체 암호 기법을 만들다 생기는 사고를 막으려는 것입니다.
무엇이 바뀌나
지금
- 서명할 메시지가 의미를 알 수 없는 16진수 문자열로 표시됩니다
- 앱마다 구조화된 데이터를 해싱하는 방법을 직접 만들어야 합니다
- 서로 다른 앱이 같은 구조를 쓰면 서명이 다른 앱에서도 유효할 수 있습니다
EIP-712 이후
- 지갑이 서명할 데이터의 필드 이름과 값을 사람이 읽을 수 있게 보여 줍니다
- 표준화된 해싱 절차(hashStruct)와 RPC 호출(eth_signTypedData)을 공통으로 씁니다
- 도메인 구분자(domain separator)가 앱과 체인별로 서명을 분리해 다른 앱에서 재사용되는 것을 막습니다
누구에게 영향이 있나
- 사용자: 서명 요청 화면에서 보내는 사람, 받는 사람, 금액 같은 실제 내용을 확인한 뒤 서명할 수 있습니다.
- 지갑 개발자: eth_signTypedData 메서드를 구현하고 체인 ID가 다르면 서명을 거부하는 등 도메인 필드에 따른 검증을 넣어야 합니다.
- 댑·컨트랙트 개발자: 자체 해싱 방식 대신 표준 인코딩을 쓰고 컨트랙트에서는 typeHash를 컴파일 타임 상수로 두고 검증할 수 있습니다.
심층 설명
서명 가능 메시지 집합의 확장과 인코딩
서명 가능한 메시지 집합을 트랜잭션과 바이트 문자열(𝕋 ∪ 𝔹⁸ⁿ)에서 구조화 데이터 𝕊까지 넓힙니다. 구조화 데이터는 "\x19\x01" ‖ domainSeparator ‖ hashStruct(message)로 인코딩합니다. 세 경우는 첫 바이트가 항상 다르기 때문에(RLP 인코딩된 트랜잭션은 \x19로 시작하지 않습니다) 인코딩이 단사(injective)입니다. 이 인코딩은 ERC-191을 따르며 버전 바이트는 0x01, 버전별 데이터는 32바이트 domainSeparator, 서명 대상 데이터는 32바이트 hashStruct(message)입니다. domainSeparator나 typeHash로 바로 시작하지 않는 이유는, 어렵긴 해도 typeHash가 유효한 RLP 트랜잭션의 접두사가 되도록 조작될 가능성이 있기 때문입니다.
타입 체계: 원자·동적·참조 타입
구조체 타입은 유효한 식별자 이름과 0개 이상의 멤버 변수를 가집니다. 원자 타입(atomic types)은 bytes1~bytes32, uint8~uint256, int8~int256, bool, address입니다. uint, int 같은 별칭은 없고, 고정소수점은 지원하지 않습니다. 동적 타입(dynamic types)은 bytes와 string입니다. 참조 타입(reference types)은 배열(고정 크기 Type[n] 또는 동적 Type[])과 구조체입니다. 재귀적 구조체 타입도 지원합니다. 𝕊는 이런 구조체 타입들의 모든 인스턴스 집합입니다.
hashStruct와 typeHash, encodeType
hashStruct(s) = keccak256(typeHash ‖ encodeData(s))이고, typeHash = keccak256(encodeType(typeOf(s)))입니다. typeHash는 구조체 타입마다 상수이므로 런타임에 계산할 필요가 없고, Solidity에서 컴파일 타임 상수로 둘 수 있습니다. encodeType은 Mail(address from,address to,string contents)처럼 이름과 멤버 목록을 이어 붙입니다. 다른 구조체를 참조하면 참조된 구조체 타입들을 모아 이름순으로 정렬해 뒤에 붙입니다. typeHash를 앞에 두는 덕분에 encodeData는 같은 타입 안에서만 단사이면 됩니다. 256비트 해시를 쓰는 이유는 bytes4로는 충돌 저항이 부족하고 긴 해시를 써도 런타임 비용이 거의 없기 때문입니다.
encodeData: 값별 인코딩 규칙
구조체 인스턴스는 멤버 값을 타입에 나온 순서대로 인코딩해 이어 붙이며 각 값은 정확히 32바이트입니다. bool의 false와 true는 uint256 값 0과 1로, 주소는 uint160으로, 정수는 256비트로 부호 확장해 빅엔디언으로 인코딩합니다. bytes1~bytes31은 끝을 0으로 채워 bytes32로 만듭니다. 동적 타입 bytes와 string은 내용의 keccak256 해시로 인코딩합니다. 배열은 내용의 encodeData를 이어 붙인 것의 keccak256 해시로 인코딩하며 SomeType[5]의 인코딩은 SomeType 멤버 5개를 가진 구조체와 같습니다. 구조체 값은 재귀적으로 hashStruct(value)로 인코딩하고 순환 데이터에는 정의되지 않습니다. 이 설계는 Solidity의 abi.encode로 쉽게 구현할 수 있고 EVM에서 메모리 제자리(in-place) 계산도 가능합니다. 타이트 패킹이나 ABIv2 인코딩은 각각 복잡한 패킹 명령이 필요하거나 같은 데이터에 유효한 인코딩이 여럿 존재해 결정성 기준을 만족하지 못해서 기각됐습니다.
domainSeparator: 도메인 분리 메커니즘
domainSeparator = hashStruct(eip712Domain)입니다. EIP712Domain 구조체는 string name(댑이나 프로토콜 이름), string version(서명 도메인의 메이저 버전), uint256 chainId(EIP-155 체인 ID), address verifyingContract(서명을 검증할 컨트랙트 주소), bytes32 salt(최후 수단의 구분용 솔트) 중 해당 도메인에 맞는 필드만 골라 씁니다. 체인 ID가 현재 체인과 다르면 사용자 에이전트는 서명을 거부해야 하고(should), verifyingContract로는 피싱 방지를 할 수 있습니다(may). 필드 순서는 위 순서를 따르고 없는 필드는 건너뜁니다. 도메인 구분자는 서로 다른 댑이 Transfer(address from,address to,uint256 amount) 같은 동일한 구조를 쓰더라도 서명이 충돌하지 않게 보장하고 같은 댑 안에서 같은 구조체 인스턴스에 대해 용도가 다른 서명을 구분하는 데도 쓸 수 있습니다.
eth_signTypedData RPC와 Web3 API
JSON-RPC에 eth_sign과 유사한 eth_signTypedData 메서드를 추가합니다. 파라미터는 서명할 계정 주소(20바이트)와 TypedData입니다. TypedData는 types(EIP712Domain 포함 필수), primaryType, domain, message 네 필드가 모두 필요한 JSON 객체입니다. 반환값은 eth_sign과 같은 65바이트 16진수 서명으로, 바이트 0~32가 r, 32~64가 s, 마지막 바이트가 v이며 v에는 EIP-155 체인 ID가 포함됩니다. 서명할 주소는 잠금 해제돼 있어야 합니다. 계정 비밀번호를 마지막 인자로 받는 personal_signTypedData도 함께 둬야 하고 Web3.js 버전 1에는 web3.eth.signTypedData와 web3.eth.personal.signTypedData 메서드가 추가됩니다.
보안 고려사항: 리플레이와 프런트러닝은 앱 책임
이 표준은 메시지 서명과 검증만 다루며 리플레이 보호를 포함하지 않습니다. 서명된 메시지로 토큰 교환 같은 행동을 승인하는 애플리케이션은 같은 서명 메시지를 두 번 봤을 때 올바르게 동작해야 합니다. 예를 들어 반복된 메시지를 거부하거나 승인된 행동을 멱등하게 만들어야 하며 구현 방법은 앱마다 다르고 표준 범위 밖입니다. 공격자가 서명을 가로채 원래 의도된 사용보다 먼저 컨트랙트에 제출하는 프런트러닝 공격에도 앱이 안전해야 합니다. 한편 기존 Solidity에서 구조체 인스턴스에 keccak256(someInstance)를 쓰면 인스턴스의 메모리 주소를 해싱하는데, 이 동작에 의존하는 댑은 위험하게 망가진 것으로 봐야 합니다.