ERC-7871 지갑 서명 요청 통합 API (Wallet Signing API)

Draft · 서명·인증 · 2024-01-29 작성

앱이 지갑에 서명을 요청할 때 쓰던 여러 메서드를 wallet_sign 하나로 통합해, 새 서명 방식이 나와도 새 메서드 없이 지원할 수 있게 합니다.

왜 필요한가

지금은 지갑과 앱이 서명을 요청할 때 personal_sign, eth_signTypedData_v4처럼 상황에 따라 서로 다른 JSON-RPC 메서드를 각각 호출합니다. 지갑과 개발 도구는 이 여러 메서드를 모두 구현하고 유지해야 하고, EIP-191에 새로운 signed_data 버전이 추가될 때마다 그에 대응하는 새 메서드까지 따로 만들어야 합니다. 또한 지갑이 서명에서 어떤 부가 기능을 지원하는지 앱에 표준적으로 알릴 방법도 마땅치 않습니다. 이런 중복과 파편화 때문에 지갑 구현이 복잡해지고, 앱 개발자도 지갑마다 다른 메서드를 신경 써야 합니다.

구현해야 하는 것

심층 설명

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로 남아 있어 아직 구체적인 내용이 채워지지 않았습니다. 세부 설계와 보안 분석이 추가되면서 명세가 바뀔 수 있습니다.

ERC 원문 · ← ERCs