ERC-7871 지갑 서명 요청 통합 API (Wallet Signing API)
Draft · 서명·인증 · 2024-01-29 작성
앱이 지갑에 서명을 요청할 때 쓰던 여러 메서드를 wallet_sign 하나로 통합해, 새 서명 방식이 나와도 새 메서드 없이 지원할 수 있게 합니다.
왜 필요한가
지금은 지갑과 앱이 서명을 요청할 때 personal_sign, eth_signTypedData_v4처럼 상황에 따라 서로 다른 JSON-RPC 메서드를 각각 호출합니다. 지갑과 개발 도구는 이 여러 메서드를 모두 구현하고 유지해야 하고, EIP-191에 새로운 signed_data 버전이 추가될 때마다 그에 대응하는 새 메서드까지 따로 만들어야 합니다. 또한 지갑이 서명에서 어떤 부가 기능을 지원하는지 앱에 표준적으로 알릴 방법도 마땅치 않습니다. 이런 중복과 파편화 때문에 지갑 구현이 복잡해지고, 앱 개발자도 지갑마다 다른 메서드를 신경 써야 합니다.
구현해야 하는 것
type Capability = { [key: string]: unknown; optional?: boolean; }: 앱이 지갑에 전달하는 부가 기능 하나를 표현하는 타입으로, optional이 true면 지갑이 해당 기능을 지원하지 않아도 무방합니다.type SignParams = { version: string; address?: `0x${string}`; request: { type: `0x${string}`; // 1-byte EIP-191 version data: any; // data corresponding to the above version }; capabilities?: Record<string, Capability>; };: wallet_sign 호출에 전달하는 파라미터 묶음으로, 서명할 데이터의 종류(request)와 서명 주체(address), 부가 기능(capabilities)을 담습니다.type SignResult = { signature: `0x${string}`; capabilities?: Record<string, any>; };: 지갑이 wallet_sign 요청에 대해 반환하는 결과로, 실제 서명 값(signature)과 capabilities에 대한 응답을 담습니다.type ValidatorRequest = { type: '0x00'; data: { validator: `0x${string}`; // Intended validator address data: `0x${string}`; // Data to sign }; }: EIP-191의 0x00 버전인, 지정된 validator용 데이터에 대한 서명 요청 형식입니다.type TypedDataRequest = { type: '0x01'; data: { ...TypedData // TypedData as defined by EIP-712 } }: EIP-191의 0x01 버전인 EIP-712 구조화 데이터에 대한 서명 요청 형식입니다.type PersonalSignRequest = { type: '0x45'; data: { message: string; // UTF-8 message string } }: EIP-191의 0x45 버전인 personal_sign 방식 메시지에 대한 서명 요청 형식입니다.
심층 설명
wallet_sign 메서드의 역할
wallet_sign은 앱이 지갑에게 EIP-191 signed_data에 대한 서명을 요청하는 새 JSON-RPC 메서드입니다. 기존에 흩어져 있던 서명 요청 메서드들을 이 하나로 합쳐서, EIP-191의 어떤 signed_data 버전이든 동일한 인터페이스로 서명을 요청할 수 있게 합니다.
SignParams 구조
version은 wallet_sign 인터페이스 자체의 버전을 나타내는 최상위 파라미터입니다. address는 선택 항목으로, 포함되면 지갑은 반드시(MUST) 그 주소로부터만 서명을 반환해야 합니다. request는 type과 data로 구성되며, type은 EIP-191 signed_data의 1바이트 버전(예: 0x01, 0x45)을, data는 그 버전에 맞는 데이터를 담습니다. capabilities는 EIP-5792 방식으로 앱이 지갑에 부가 기능을 전달하는 선택 필드입니다.
SignResult 구조
지갑은 서명 요청에 대해 signature 필드에 서명 값을 담아 반환합니다. capabilities 필드는 선택이며, 요청에 담긴 capabilities에 대한 지갑의 응답을 담을 수 있습니다.
세 가지 request 인터페이스
이 ERC는 현재 EIP-191에 정의된 세 가지 signed_data 버전에 대한 request 스키마를 정의합니다. type이 0x00인 ValidatorRequest는 validator 주소와 서명할 data를 담습니다. type이 0x01인 TypedDataRequest는 EIP-712 TypedData 그대로를 data에 담습니다. type이 0x45인 PersonalSignRequest는 UTF-8 문자열인 message를 data에 담습니다. 앞으로 새로운 signed_data 버전이 추가되면, 그에 맞는 request 인터페이스는 별도의 ERC에서 정의하도록 권고(SHOULD)합니다.
capabilities와 기능 탐색
wallet_sign은 EIP-5792 방식의 capabilities를 지원합니다. 앱은 capabilities 필드를 통해 지갑에 부가 기능 사용을 요청할 수 있고, 지갑이 어떤 서명 관련 capabilities를 지원하는지는 EIP-5792가 정의하는 wallet_getCapabilities 메서드로 미리 확인할 수 있습니다.
address 파라미터로 서명 주체 지정
SignParams의 address는 선택 파라미터이지만, 포함되면 지갑은 이를 반드시 지켜야 하며(MUST) 지정된 주소로부터만 서명을 반환해야 합니다.
아직 비어 있는 근거 문서
이 제안은 현재 Draft 상태이며, Rationale(설계 근거), Backwards Compatibility(하위 호환성), Security Considerations(보안 고려사항) 항목이 모두 TODO로 남아 있어 아직 구체적인 내용이 채워지지 않았습니다. 세부 설계와 보안 분석이 추가되면서 명세가 바뀔 수 있습니다.