ERC-7964 크로스체인 EIP-712 서명 (Crosschain EIP-712 Signatures)

Draft · 서명·인증 · 2025-06-05 작성

서명 하나로 여러 체인에서 동시에 유효한 EIP-712 서명을 만들어 체인마다 따로 서명하지 않고도 크로스체인 거래·투표·계정 관리를 승인할 수 있게 하는 표준입니다.

왜 필요한가

현재 계정 추상화 방식에서는 체인마다 따로 서명해야 해서 여러 체인에 걸친 거래, 멀티체인 DAO 투표, 여러 체인에 배포된 같은 계정 관리, 크로스체인 소셜 복구 같은 작업이 번거롭습니다. 이를 해결하려는 기존 방안은 머클트리를 써서 작업들을 하나의 루트로 묶지만 표준 지갑은 머클트리 리프를 보여줄 수 없어 사용자가 실제로 무엇에 서명하는지 지갑 화면에서 확인할 수 없고 지갑이 모든 리프를 요청해 트리를 검증하는 별도 로직을 구현해야 합니다. 또는 비표준 인코딩 방식을 쓰는데, 이는 지갑들이 채택하지 않아 실제로 쓰이기 어렵습니다.

심층 설명

chainId를 생략한 크로스체인 도메인

EIP-712 도메인에서 최상위 chainId 필드를 생략하면 지갑이 도메인의 chainId가 현재 체인과 다르면 서명을 거부하는 규칙이 적용되지 않아 같은 서명을 여러 체인에서 재사용할 수 있습니다. 대신 서명자 보호를 유지하기 위해 체인별 작업(operation) 구조체마다 목표 chainId를 반드시 포함시켜 지갑이 보여주는 타입드 데이터 안에서 사용자가 실제로 서명할 체인 목록을 확인하게 합니다. 컨트랙트 주소와 chainId는 체인별로 검증해야 하므로 메인 도메인에는 보통 name과 version만 남습니다. verifyingContract는 모든 체인에서 같은 주소로 배포된 애플리케이션을 서명에 묶을 때 메인 도메인에 넣을 수 있고 이 경우 체인별 구조체에서는 주소를 생략할 수 있습니다.

작업 배열 인코딩과 chainId 필드

크로스체인 작업들은 메시지 구조체의 배열로 인코딩합니다. 배열의 각 원소는 정확히 chainId라는 이름의 필드를 구조체 안 어느 깊이에든 포함해야 하며 이를 통해 오프체인 툴이 애플리케이션별 구조를 몰라도 현재 체인에 해당하는 작업을 찾을 수 있습니다. 같은 작업 안에 chainId 필드가 여러 번 등장하면, 구조체를 깊이 우선·입력 순서로 스캔했을 때 처음 만나는 필드가 목표 chainId로 간주됩니다. 컨트랙트가 체인마다 다른 주소에 배포되어 있다면, 메인 도메인에 verifyingContract가 없는 경우 각 작업에도 verifyingContract(또는 동등한 필드)를 포함해야 합니다. 구현자는 EIP712Domain과 이름이 충돌하지 않도록 EIP712ChainDomain 같은 이름의 구조체를 만들어 chainId와 verifyingContract를 중첩시킬 수 있습니다.

전체 메시지 구조체 해시

EIP-712 서명은 작업 배열만이 아니라 CrossChainIntent나 MultiChainVote 같은 전체 메시지 구조체 전체에 대해 계산합니다. 애플리케이션은 작업 배열을 포함하는 전체 구조체의 typehash를 정의해야 하고 nonce나 deadline 같은 다른 메시지 필드도 이 구조체에 함께 담을 수 있습니다. 배열 자체는 EIP-712 규칙대로 각 원소(구조체)를 hashStruct로 재귀적으로 해시한 뒤, 그 32바이트 해시들을 이어붙여 keccak256으로 한 번 더 해시해서 하나의 배열 해시를 만듭니다. 같은 애플리케이션이 배포된 모든 체인에서는 반드시 동일한 typehash를 사용해야 합니다.

서명 인코딩과 온체인 검증 절차

크로스체인 서명은 (bytes32 header, bytes32[] structsArray, bytes crossChainSignature) 튜플로 ABI 인코딩합니다. header 한 워드만 abi.encodePacked로 세 값을 눌러 담는데, 10바이트 매직값 0x79647964796479647964(크로스체인 서명 식별용), 2바이트 structIndex(현재 체인 작업이 배열 중 몇 번째인지), 20바이트 application 주소(ERC-5267을 구현해 EIP-712 도메인 정보를 제공하는 컨트랙트)입니다. 애플리케이션은 서명 앞 10바이트가 매직값과 같으면 크로스체인 서명으로 인식하고 structsArray[structIndex]가 현재 체인 메시지의 구조체 해시와 일치하는지 확인한 뒤, application 컨트랙트의 eip712Domain()을 호출해 도메인 정보를 얻고 메인 도메인 필드를 계산해 전체 해시를 재구성한 뒤 crossChainSignature를 검증합니다.

메인 도메인 필드 계산

검증자(verifier)는 체인별 구조체에 어떤 도메인 필드를 포함시킬지 미리 고정하고 이를 ERC-5267의 fields 비트맵 형식인 chainFields 상수로 표현합니다. 모든 체인별 구조체는 목표 chainId를 포함하므로 chainFields는 항상 chainId 비트(0x04)를 포함해야 합니다. 메인 도메인에 들어갈 필드는 application 컨트랙트가 돌려주는 applicationFields에서 chainFields를 뺀 나머지(mainFields = applicationFields & ~chainFields)입니다. 이 집합은 서명이 아니라 검증자가 정하는 것이며 서명에 인코딩하지 않습니다. 하나의 크로스체인 메시지를 검증하는 모든 체인은 같은 typehash와 chainFields를 써야 하고 application이 모든 목표 체인에서 같은 메인 도메인 값을 돌려줘야 서명이 전부 유효합니다.

배열 방식과 머클트리 방식 비교

이 표준은 머클트리 대신 배열 인코딩을 선택했습니다. 머클트리는 체인이 많을 때 온체인 데이터를 줄일 수 있지만 표준 EIP-712 지갑은 머클트리 리프를 보여줄 수 없어 사용자가 서명하는 머클루트 안에 어떤 작업이 들어있는지 지갑 UI로 확인할 방법이 없고 지갑이 모든 리프를 요청해 트리 구성을 검증하는 별도 로직을 만들어야 합니다. 배열 방식은 모든 체인별 작업이 표준 EIP-712 메시지 구조의 일부로 그대로 보이기 때문에 숨겨진 작업이 있을 수 없습니다. 온체인 비용 차이도 2~5개 체인 범위에서는 32~64바이트(해시 1~2개) 정도로 작아 투명성을 희생할 만큼 크지 않습니다.

기존 지갑·앱과의 호환성

이 표준은 EIP-712를 수정 없이 그대로 사용하므로, 기존에 EIP-712를 지원하는 지갑과 앱은 별다른 변경 없이 크로스체인 서명 메시지를 바로 표시할 수 있습니다. 다만 크로스체인 의미(여러 체인에서 재사용 가능하다는 점)까지 인식하지는 못합니다. 도메인에 특정 chainId를 포함해 검증하는 기존 애플리케이션은 chainId가 생략된 크로스체인 서명을 자동으로 거부하므로, 기본값으로 안전하게 실패합니다. 크로스체인 서명을 지지하려는 애플리케이션은 이 표준이 설명하는 검증 절차를 직접 구현해야 합니다.

제안 상태

이 제안은 아직 Draft 상태로, 커뮤니티 논의와 구현 과정에서 세부 내용이 바뀌거나 멈출 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs