ERC-7739 스마트 계정 읽기 쉬운 타입 서명 (Readable Typed Signatures for Smart Accounts)
Draft · 서명·인증 · 2024-05-28 작성
하나의 EOA가 여러 스마트 계정을 소유할 때 같은 서명이 다른 계정에서 재사용되는 것을 막는 방어적 재해싱 표준입니다. 중첩 EIP-712 구조를 써서 지갑 화면에 서명 내용이 그대로 보이게 합니다.
왜 필요한가
스마트 계정은 ERC-1271의 isValidSignature 함수로 서명을 검증합니다. 그런데 검증할 해시(hash)에 스마트 계정의 주소가 들어 있지 않으면, 한 외부 소유 계정(EOA)이 여러 스마트 계정을 소유할 때 같은 서명을 다른 계정에서 그대로 재사용하는 리플레이 공격이 가능합니다. Permit2처럼 널리 쓰이는 애플리케이션이 실제로 이런 경우에 해당합니다. 그래서 많은 스마트 계정 구현이 최소한 해시, 자기 주소, 체인 ID를 합쳐 다시 해시하는 방어적 재해싱(defensive rehashing)을 수행합니다. 다만 이것을 EIP-712로 단순하게 구현하면 서명할 내용이 불투명해져서 사용자가 지갑에서 무엇에 서명하는지 볼 수 없게 되는 문제가 있습니다. 이 표준은 리플레이를 막으면서도 EIP-712를 지원하는 모든 지갑에서 서명 내용이 보이도록 하는 재해싱 방식을 정의합니다.
구현해야 하는 것
isValidSignature(bytes32 hash, bytes calldata signature): ERC-1271이 정의한 컨트랙트 서명 검증 함수입니다. 이 표준은 이 함수 안에서 TypedDataSign 또는 PersonalSign 워크플로로 서명을 검증하는 동작을 규정합니다.eip712Domain(): ERC-5267이 정의한 함수로, 스마트 계정의 EIP-712 도메인 정보를 돌려줍니다. 최종 해시를 계산하는 데 필요합니다.
심층 설명
TypedDataSign 최종 해시
원래 해시가 EIP-712로 계산된 경우에 쓰는 워크플로입니다. 최종 해시는 keccak256(\x19\x01 ‖ APP_DOMAIN_SEPARATOR ‖ hashStruct(TypedDataSign))로 정의됩니다. TypedDataSign 구조에는 contents(원래 구조체의 hashStruct)와 eip712Domain()의 name, version, chainId, verifyingContract, salt가 들어갑니다. typedDataSignTypehash는 contentsType을 이용해 온체인에서 즉석으로 만듭니다. 서명 요청에 내용이 반드시 보이도록 contents를 사용자 정의 타입으로 강제하기 위한 설계입니다. 도메인 필드를 EIP712Domain 타입이 아니라 평탄하게 펼친 것은 검증 컨트랙트의 도메인 타입과 충돌을 피하기 위해서입니다. ERC-5267의 fields 비트맵과 extensions 배열은 온체인 재해싱에 보안상 이득이 없어 뺐습니다.
contentsName 추출과 검증 권장 규칙
contentsName은 contentsType에서 첫 "(" 직전까지의 부분 문자열입니다. 예를 들어 contentsType이 "Mail(address from,address to,string message)"이면 contentsName은 "Mail"입니다. 안전을 위해 contentsName이 빈 문자열인 경우, abcdefghijklmnopqrstuvwxyz( 중 하나로 시작하는 경우, ", )\x00" 바이트를 포함하는 경우에는 서명을 무효로 처리하는 것이 권장(RECOMMENDED)됩니다. 소문자 시작을 거부하는 것은 다른 언어에서 uint256이 u256처럼 다르게 불릴 수 있어 표준을 언어 중립적이고 미래 호환적으로 유지하기 위한 선택입니다.
TypedDataSign 서명 형식
isValidSignature에 전달되는 signature는 originalSignature ‖ APP_DOMAIN_SEPARATOR ‖ contents ‖ contentsDescription ‖ uint16(contentsDescription.length)로 바뀝니다. contents는 원래 구조체의 bytes32 구조체 해시입니다. contentsDescription은 contentsType만 쓰는 암시 모드(implicit)와 contentsType ‖ contentsName을 쓰는 명시 모드(explicit)가 있습니다. contents 구조에 중첩 타입이 있으면 EIP-712의 사전순 정렬 때문에 contentsName이 contentsType의 맨 앞에 오지 않을 수 있어 명시 모드가 필요합니다. 덧붙인 APP_DOMAIN_SEPARATOR와 contents로 hash == keccak256(\x19\x01 ‖ APP_DOMAIN_SEPARATOR ‖ contents)를 확인해 전달받은 hash가 올바른지 검증합니다. 일치하지 않으면 이 워크플로에서 무효입니다.
PersonalSign 워크플로
원래 해시가 EIP-191로 계산된 경우에 쓰는 워크플로입니다. 최종 해시는 keccak256(\x19\x01 ‖ ACCOUNT_DOMAIN_SEPARATOR ‖ hashStruct(PersonalSign))이며, 타입해시는 keccak256("PersonalSign(bytes prefixed)")입니다. ACCOUNT_DOMAIN_SEPARATOR는 스마트 계정 자신의 도메인 구분자로 eip712Domain()으로 계산할 수 있습니다. hash는 "\x19Ethereum Signed Message:\n"과 메시지 길이, 원문 메시지로 애플리케이션 쪽에서 계산되어 전달됩니다. 스마트 계정은 그 계산 방법을 알 필요가 없습니다. 이 워크플로는 signature에 추가 데이터를 덧붙일 필요가 없습니다.
워크플로 판별
isValidSignature의 함수 시그니처는 그대로이므로, 구현이 어느 워크플로로 검증할지 스스로 판별해야 합니다(MUST). signature에 들어 있는 APP_DOMAIN_SEPARATOR와 contents로 hash를 재구성했을 때 전달받은 hash와 일치하면 TypedDataSign 워크플로를, 일치하지 않으면 PersonalSign 워크플로를 수행해야 합니다.
지원 감지와 매직 넘버
스마트 계정은 isValidSignature(0x7739773977397739773977397739773977397739773977397739773977397739, "") 호출에 bytes4(0x77390001)을 돌려줘 이 표준 지원을 알리는 것이 권장(SHOULD)됩니다. 이 매직 넘버는 표준이 갱신되면 올라갈 수 있습니다(MAY). 새 함수를 정의하지 않고 isValidSignature를 활용한 것은 모듈러 스마트 계정에서 구현을 쉽게 하기 위해서입니다. 이전 드래프트에서는 supportsNestedTypedDataSign() 함수가 bytes4(0xd620c85a)를 돌려주는 방식을 썼습니다.
재해싱을 건너뛸 수 있는 조건
isValidSignature가 오프체인에서 호출되거나, 전달된 hash에 이미 스마트 계정 주소가 포함되어 있으면 방어적 재해싱 워크플로를 건너뛸 수 있습니다(MAY). 많은 개발자가 중첩 EIP-712 워크플로를 지원하도록 앱을 고치지 않을 수 있으므로, 스마트 계정 구현은 안전한 경우 재해싱을 생략해 기존 앱을 수용하는 것이 권장(SHOULD)됩니다. 지갑이나 앱 프런트엔드가 업데이트되지 않아도 사용자가 클라이언트 측 JavaScript를 주입해 쓸 수 있도록 도입 마찰을 최소화한 설계입니다.
참조 구현과 제안 상태
제작 환경에 바로 쓸 수 있는 최적화된 참조 구현이 제공됩니다. 참조 구현은 의도적으로 최소주의가 아닌데, 최소한의 참조 구현이 제작 환경에서도 안전하다고 잘못 가정되었던 ERC-1271의 실수를 반복하지 않기 위해서입니다. 이 제안은 아직 Draft 상태라서 내용이 바뀔 수 있습니다.
쓸 때 주의할 점
- 잘못된 contentsName 거부: 현재 주요 eth_signTypedData 구현들은 커스텀 타입 이름을 정화하지 않습니다. 피싱 사이트가 제어 문자를 넣은 contentsName으로 PersonalSign 타입 인코딩을 깨뜨리면 지갑이 사용자에게 불투명한 해시 서명을 요청하게 됩니다. contentsName을 온체인에서 정화하도록 요구하면 이 피싱 공격 경로가 차단됩니다.
- 같은 방식 서명자의 체이닝 불가: 이 방식을 ERC-1271 리플레이 방지에 쓰는 계정은 같은 방식을 쓰는 서명자를 자기 서명자로 둘 수 없습니다. 서명되는 메시지가 또 다른 TypedDataSign 구조이면, 결과 EIP-712 메시지 본문에 내용이 호환되지 않는 TypedDataSign 타입 두 개가 생겨 EIP-712 요청으로 표현할 수 없기 때문입니다.