EIP-2255 지갑 권한 시스템 (Wallet Permissions System)

최종 확정 · 보안·프라이버시 · 원문 상태 Final · 2019-08-22 작성

지갑에 wallet_getPermissions와 wallet_requestPermissions 두 RPC 메서드를 추가해 앱이 민감한 기능의 사용 권한을 표준 방식으로 요청하고 확인할 수 있게 합니다.

왜 필요한가

지갑은 신뢰할 수 없는 앱과 사용자의 키 사이에서 사용자 동의를 받아 상호작용을 중개합니다. 지금의 지갑은 모든 동작마다 확인 창을 띄웁니다. 보안은 지켜지지만 사용자가 겪는 번거로움이 큽니다. 실제로 많은 웹3 앱은 세션을 시작할 때 지갑 주소 공개, 네트워크 전환, 암호 챌린지 서명, 토큰 허용량 승인, 컨트랙트 트랜잭션 전송 같은 요청을 연달아 보냅니다. 이 제안은 이런 요청을 사람이 읽을 수 있는 권한 목록으로 묶어 처음 로그인 화면에서 한 번에 동의받고 추가 권한은 필요할 때만 요청하자는 것입니다. 웹에서 널리 쓰이는 OAuth2식 권한 요청과 같은 패턴이라 사용자에게 익숙합니다. 사용자는 각 권한을 개별적으로 거절하거나 조건을 조정(attenuate)할 수도 있습니다. 예를 들어 로그인에 만료일을 붙이거나 토큰 허용량을 직접 고치는 식입니다.

무엇이 바뀌나

지금

EIP-2255 이후

누구에게 영향이 있나

심층 설명

wallet_getPermissions: 현재 권한 조회

파라미터 없이 호출하며 Permission 객체 배열을 반환합니다(기본값은 빈 배열). Permission은 invoker, parentCapability, caveats 세 필드로 구성됩니다. invoker는 요청한 댑의 출처를 식별하는 URI입니다(예: https://your-site.com/). parentCapability는 허용된 메서드 이름입니다(예: eth_accounts). caveats는 그 메서드에 적용된 제약 목록으로, 각 Caveat는 type(문자열)과 value(임의의 JSON 값)를 가지며 value의 의미는 type의 맥락 안에서만 해석됩니다.

wallet_requestPermissions: 권한 요청

PermissionRequest 객체 하나를 유일한 파라미터로 받아야 하며(MUST) RequestedPermission 객체 배열을 반환해야 합니다(MUST). PermissionRequest는 methodName을 키로, 그 아래 caveatName과 caveat 값을 담는 중첩 객체입니다(예: eth_accounts 아래 requiredMethods: ["signTypedData_v3"]). 반환되는 RequestedPermission은 parentCapability와 선택적 date 필드를 가지며 date는 요청 시각의 Unix 타임스탬프입니다. 제한된 메서드에 대한 호출은 wallet_requestPermissions 요청이 이뤄지고 사용자가 수락하기 전까지 오류로 실패해야 합니다. 요청이 거절되면 EIP-1193에 따라 code 값이 4001인 오류를 던져야 합니다.

caveat: 권한에 붙는 제약 조건

caveat은 허용된 메서드에 적용되는 구체적 제한입니다. 사용자는 권한을 통째로 승인하거나 거절하는 것뿐 아니라 조건을 조정(attenuate)할 수 있습니다. 원문이 드는 예는 두 가지입니다. 로그인 요청에 사용자가 만료일을 추가하는 것, 그리고 토큰 허용량 요청 시 사용자가 그 양을 직접 조정하는 것입니다. Caveat의 type이 문자열이고 value가 임의의 JSON 값이라는 열린 구조 덕분에 다양한 제약을 표현할 수 있습니다.

확장 가능성: 계정 능력 지정

requestPermissions는 요청하는 권한에 관한 다른 옵션을 포함하도록 확장할 여지가 있습니다. 예를 들어 signTypedData_v3가 필요한 거래소 같은 사이트는 그 요구 사항을 명시할 수 있습니다. 이 메서드는 일부 하드웨어 지갑이 지원하지 않기 때문입니다. 그러면 지갑은 호환되는 계정만 골라 보여 주면서도 사용자가 키를 어떻게 보관하는지에 대한 프라이버시와 선택권은 지킬 수 있습니다. 테스트 케이스에도 eth_accounts 권한에 requiredMethods: ['signTypedData_v3'] caveat을 붙여 요청하는 예가 들어 있습니다.

보안 고려 사항: SSRF

웹사이트의 파비콘을 표시하는 경우에 해당하는 고려 사항입니다. 지갑은 임의의 URL로 요청을 보내는 일에 주의해야 합니다. 특정 스킴과 포트만 허용하는 화이트리스트 방식으로 URI를 정제하는 것이 권장됩니다. 취약한 지갑은 예를 들어 로컬에서 실행 중인 redis 데이터베이스의 데이터를 변조하도록 속을 수 있습니다. 이 EIP는 상태가 Final로 확정된 인터페이스 표준이며 EIP-1193 프로바이더 API 위에 두 메서드를 추가하는 형태입니다.

EIP 원문 · ← EIPs