ERC-7715 지갑 실행 권한 요청 (Request Permissions from Wallets)
Draft · 계정·지갑 · 2024-05-24 작성
디앱이 지갑에 권한을 미리 요청해 두고 사용자가 승인한 범위 안에서 사용자 대신 트랜잭션을 실행할 수 있게 하는 JSON-RPC 메서드를 정의합니다.
왜 필요한가
지금 대부분의 디앱(DApp, 탈중앙 앱)은 사용자가 무언가를 할 때마다 지갑을 열어 거래에 하나하나 서명하게 합니다. 게임처럼 상호작용이 잦은 앱에서는 매번 승인하는 일이 번거롭고 사용 흐름이 계속 끊깁니다. 더 큰 문제도 있습니다. 사용자가 지갑을 연결해 두지 않으면 디앱이 거래를 보낼 방법이 아예 없습니다. 그래서 정기 구독, 소극적 투자, 지정가 주문처럼 사용자가 자리에 없을 때 실행되어야 하는 기능은 만들 수 없습니다. 이 표준은 디앱이 지갑에 범위가 정해진 권한을 요청하고 사용자가 한 번 승인하면 그 범위 안에서 디앱이 사용자를 대신해 거래를 실행할 수 있게 하는 JSON-RPC 메서드를 정의해 이 문제를 풉니다.
구현해야 하는 것
function redeemDelegation(bytes[] calldata _permissionContexts, bytes32[] calldata _modes, bytes[] calldata _executionCallData) external;: 권한을 받은 쪽이 위임 관리자 컨트랙트에서 호출하는 함수입니다. 응답으로 받은 context와 실행할 내용을 넘겨 사용자 계정이 그 거래를 실행하게 합니다.
심층 설명
권한과 규칙의 공통 구조
이 표준은 권한(permission)과 규칙(rule)의 전체 목록을 정하지 않습니다. 디앱과 지갑이 모두 지원하면 어떤 타입이든 쓸 수 있고 새 타입은 별도 ERC로 정의하되 BasePermission 또는 BaseRule 구조를 따라야 합니다. BasePermission은 type, isAdjustmentAllowed, data 필드를 가집니다. isAdjustmentAllowed는 지갑이 사용자의 승인 조건에 맞춰 권한의 범위를 줄이거나 늘려도 되는지를 디앱이 지정하는 불리언 값입니다. BaseRule은 type과 data를 가지며 예시로 정의된 expiry 규칙은 data.timestamp에 적은 유닉스 타임스탬프 이후 권한을 무효로 만듭니다. 서로 다른 두 권한이나 두 규칙이 같은 type 이름을 쓰면 디앱이 요청한 것과 지갑이 부여한 것이 어긋날 수 있으므로 타입 이름은 겹치지 않아야 합니다.
wallet_requestExecutionPermissions 요청
요청 params는 PermissionRequest 객체의 배열입니다. chainId는 EIP-155 기준으로 이 요청이 적용되는 체인을 지정합니다. from은 권한을 부여할 사용자 계정으로, 생략하면 사용자가 계정을 고를 수 있습니다. to는 권한과 연결된 디앱 세션 계정입니다. permission은 to 계정이 from 계정을 대신해 할 수 있는 행동을 정의하고 rules는 그 권한을 쓸 때 to 계정이 지켜야 하는 제한 조건을 정의합니다. 원문 예시는 native-token-allowance 타입 권한에 expiry 규칙을 붙여 요청합니다.
응답 필드: context, dependencies, delegationManager
응답은 원래 요청의 모든 필드를 담지만 값이 요청과 같다는 보장은 없습니다. 지갑이 조정했을 수 있기 때문입니다. context는 권한을 취소하거나 사용할 때 그 권한을 식별하는 값으로, ERC-7710에서 요구하는 필드입니다. dependencies는 ERC-4337에 정의된 factory와 factoryData 쌍의 배열로, 권한을 사용하려면 먼저 배포되어야 하는 계정을 알려 줍니다. 한 항목에서 두 필드는 둘 다 있거나 둘 다 없어야 하고 관련 계정이 모두 배포되어 있으면 지갑은 빈 배열을 반환해야 합니다. 디앱은 factory를 factoryData로 호출해 각 계정을 배포해야 합니다. delegationManager도 ERC-7710에서 요구하는 필드입니다. 요청이 잘못되었거나 지갑이 권한을 줄 수 없으면 ERC-1193에 정의된 코드로 오류를 반환해야 합니다.
권한 조회와 취소 메서드
wallet_getSupportedExecutionPermissions는 지갑이 지원하는 권한 타입을 키로 하는 객체를 반환하며 각 타입에 지원 체인 목록(chainIds)과 적용 가능한 규칙 타입 목록(ruleTypes)을 담는 것이 권장됩니다. wallet_getGrantedExecutionPermissions는 아직 취소되지 않은 모든 부여된 권한을 반환해야 합니다. wallet_revokeExecutionPermission은 permissionContext를 받아 권한을 취소하며 성공하면 빈 응답을 돌려줍니다.
권한 사용: redeemDelegation 호출
권한 응답은 to 필드의 계정이 ERC-7710 인터페이스로 사용합니다. 권한을 받은 쪽은 외부 소유 계정(EOA)이든 컨트랙트든 어떤 계정 타입으로도, 원하는 결제나 중계 인프라를 써서 거래나 UserOp을 만들 수 있습니다. 응답의 delegationManager에 메시지를 보내 redeemDelegation 함수를 호출하되 _permissionContexts에 응답의 context를, _executionCallData에 사용자 계정이 실행할 내용을 넣습니다. 실행 내용은 target(주소), value(uint256), callData(bytes)로 이루어진 Execution 구조체로 정의됩니다. 원문 예시 코드는 target, value, callData를 인코딩하고 실행 모드(SingleDefault)를 골라 delegationManager에 트랜잭션을 보냅니다.
설계 의도: 불투명한 permissionsContext
이 ERC는 디앱과 지갑 사이의 상호작용만 정하고 지갑이 권한을 어떻게 집행하는지는 정하지 않습니다. 그래서 지갑이 디앱에 정보를 유연하게 전달할 방법이 필요하고 permissionsContext는 서로 다른 권한 체계의 임의 정보를 담을 수 있는 불투명한 문자열로 설계되었습니다. 권한과 규칙 타입에 UUID를 의무화하는 방안도 검토했지만 새 타입을 ERC로 정의하도록 요구하는 더 단순한 방식을 택했습니다. 이 메서드를 지원하지 않는 지갑은 호출 시 오류 메시지를 반환하는 것이 권장됩니다.
초안 단계의 제안
이 ERC는 2024년 5월에 만들어진 Draft(초안) 상태입니다. 내용이 아직 바뀔 수 있으므로 구현할 때는 최신 원문을 확인해야 합니다. 이 표준은 ERC-4337과 ERC-7710을 전제로 합니다.
쓸 때 주의할 점
- 권한 범위 최소화: 디앱은 필요한 권한만, 합리적인 만료 시간과 함께 요청해야 합니다. 지갑은 권한을 정확히 집행해야 하며 결국 사용자는 지갑 소프트웨어가 올바르게 구현되었다는 것을 신뢰해야 합니다. 권한 집행은 지갑 구현의 일부로 보아야 합니다.
- 피싱 공격: 악의적인 디앱이 정상 앱처럼 꾸며 사용자가 넓은 권한을 주도록 속일 수 있습니다. 지갑은 요청된 권한을 사용자에게 명확히 보여 주고 위험한 권한을 줄 때 경고해야 합니다.