ERC-6865 온체인 EIP-712 서명 시각화 (On-Chain EIP-712 Visualization)
Draft · 서명·인증 · 2023-04-10 작성
EIP-712 서명 요청이 내 자산에 어떤 영향을 주는지, 컨트랙트가 직접 알려 주는 표준 조회 함수를 정의합니다. 지갑은 그 결과를 받아 나가는 자산과 들어오는 자산을 일관되게 보여 줄 수 있습니다.
왜 필요한가
많은 프로토콜이 저마다 다른 구조의 EIP-712 서명 메시지(사람이 읽을 수 있게 설계된 구조화 서명 데이터)를 쓰기 때문에, 지갑이 모든 프로토콜의 메시지를 해석해 보여 주기는 어렵습니다. 그래서 지금 대부분의 지갑은 서명 요청을 원시 데이터에 가깝게 보여 주고, 사용자는 서명하면 무슨 일이 생기는지 알기 어려워 피싱 같은 보안 위협에 노출됩니다. 제안자들이 지갑용 오프체인 SDK로 각 프로토콜을 해석하는 방법을 시도했지만 모든 프로토콜을 파악하기 어렵고(확장성), 프로토콜의 동작을 잘못 이해해 틀린 화면을 보여 줄 위험이 있으며(신뢰성), 프로토콜이 업그레이드되면 해석이 낡아 버리는(유지보수) 문제가 있었습니다. 이 표준은 시각화 책임을 지갑이 아니라 프로토콜 자신에게 옮겨 컨트랙트가 체인 위에서 직접 영향을 설명하게 합니다.
심층 설명
호출 규칙
이 제안을 구현하는 컨트랙트는 verifyingContract 구현에 visualizeEIP712Message 함수를 반드시 포함해야 합니다. 지갑은 eth_signTypedData 서명 요청을 받으면 EIP-712 도메인 구분자의 verifyingContract와 chainId 필드가 가리키는 체인의 그 컨트랙트에서 이 함수를 호출할 수 있습니다. 도메인 구분자에 verifyingContract나 chainId 필드가 없으면 지갑은 이 제안을 무시해야 합니다. 입력 encodedMessage는 abi.encode(types, params)로 인코딩한 EIP-712 메시지이고 abi.decode로 해석할 수 있으며 domainHash는 EIP-712 도메인 구분자의 bytes32 해시입니다.
반환값 Result 구조체
함수는 Result 구조체를 반드시 돌려줘야 합니다. Result는 UserAssetMovement[] 타입의 assetsIn과 assetsOut, 그리고 Liveness 구조체로 이루어집니다. assetsIn은 메시지가 서명되고 이행될 때 사용자가 반드시 받게 되는 최소한의 자산이고, assetsOut은 사용자가 내놓는 최대한의 자산입니다. 받는 쪽은 최소, 주는 쪽은 최대로 표현해 사용자에게 가장 보수적인 영향을 보여 줍니다.
Liveness: 유효 기간
Liveness는 메시지가 유효한 시간 구간을 정의하는 구조체로, uint256 타입의 from과 to를 가집니다. from은 시작 타임스탬프, to는 만료 타임스탬프이며 from은 to보다 반드시 작아야 합니다.
UserAssetMovement: 자산 이동 표현
UserAssetMovement는 assetTokenAddress, id, amounts 세 필드로 자산을 정의합니다. assetTokenAddress는 토큰(ERC-20, ERC-721, ERC-1155) 컨트랙트 주소이고 제로 주소는 반드시 네이티브 코인(이더리움에서는 네이티브 ETH)을 나타냅니다. id는 NFT ID로, NFT가 아닌 자산에서는 반드시 무시해야 하며 해당 id의 토큰이 NFT 컬렉션에 없으면 그 컬렉션 안의 아무 토큰이나 뜻하는 것으로 보아야 합니다. amounts는 uint256 배열로 liveness 구간 안에서 시간에 따른 수량 곡선을 정의합니다. amounts[0]은 liveness.from 시점의 수량, 마지막 원소는 liveness.to 시점의 수량이어야 하고 대부분의 경우 원소 하나짜리 배열로 그 자산의 최소 수량을 담습니다.
왜 온체인인가
오프체인으로도 비슷한 일을 할 수 있지만 제안자들이 오프체인 TypeScript SDK를 만들어 본 경험에서 한계가 드러났습니다. 프로토콜을 만든 개발자가 직접 시각화를 구현해야 가장 정확하고(신뢰성), 지갑이나 제3자가 새 프로토콜을 일일이 파악하는 방식으로는 빠르게 커지는 생태계를 따라갈 수 없으며(확장성), 업그레이드 가능한 컨트랙트가 많아 오프체인 해석이 실제 동작과 어긋나기 쉽습니다(유지보수). 그래서 시각화 구현을 프로토콜의 온체인 컨트랙트에 두는 방식을 택했습니다.
domainHash와 amounts 배열의 설계 이유
domainHash는 프로토콜이 지원하지 않는 버전의 EIP-712 구현에 대해 되돌리기(revert) 위해 필요합니다. 프로토콜이 여러 EIP-712 구현(name)을 쓸 때 어느 구현인지 식별하거나, 다른 프로토콜의 domainHash라면 거부하는 데 쓰입니다. 또 앞으로 업그레이드할 수 없는 기존 배포 컨트랙트를 위해 이 표준 구현을 연결해 주는 레지스트리가 생긴다면, domainHash로 프로토콜을 식별할 수 있습니다. amounts를 단일 uint256이 아니라 배열로 둔 것은 NFT 프로토콜에서 흔한 경매처럼 시간에 따라 수량이 변하는 경우를 담기 위해서입니다.
참조 구현과 제안 상태
오픈씨(openSea)의 Seaport NFT 마켓플레이스에 대한 구현 예시(SeaPortEIP712Visualizer.sol)가 원문 자료로 제공됩니다. 이 제안은 Draft 상태로, 아직 내용이 바뀔 수 있는 초안 단계입니다.
쓸 때 주의할 점
- 구현의 정확성에 대한 신뢰: visualizeEIP712Message 함수는 EIP-712 메시지가 사용자 자산에 미치는 영향을 신뢰할 수 있고 정확하게 나타내야 합니다. 지갑 제공자와 사용자는 프로토콜이 이 함수를 정확하고 최신 상태로 구현했다고 믿어야 합니다.
- verifyingContract 평판 기준으로 판단: 함수 결과는 verifyingContract의 평판에 따라 다뤄야 합니다. 이 제안의 구현이 verifyingContract와 같은 주소에 있으므로, verifyingContract를 신뢰할 수 있다면 visualizeEIP712Message의 결과도 신뢰할 수 있다는 뜻이 됩니다.