ERC-7795 지갑 호출 토큰 사전 요건 (Wallet Call Token Capabilities)
Draft · 계정·지갑 · 2024-10-22 작성
dApp이 거래를 보내기 전에 필요한 토큰 조건(잔액, 허용량, NFT 소유 등)을 지갑에 알리는 표준입니다. 지갑은 사용자가 이 조건을 먼저 채우도록 돕습니다.
왜 필요한가
대부분의 dApp은 하나의 네트워크(체인) 위에서만 돌아갑니다. 그런데 사용자의 자금은 소수의 네트워크에만 있는 경우가 많아 네트워크가 늘어날수록 dApp이 있는 곳과 사용자의 돈이 있는 곳이 겹칠 가능성은 점점 줄어듭니다. 지금까지 dApp은 지갑에 최종 목적을 전달할 방법이 없어서 사용자가 마지막으로 실행해야 할 거래 하나만 요청할 수 있었습니다. 그 거래를 실행하려면 어떤 준비 작업이 필요한지, 예를 들어 여러 네트워크에 흩어진 자금을 한곳으로 모으거나 dApp이 받는 자산으로 교환하는 일은 전부 사용자가 스스로 추측해서 해내야 했습니다. 이 과정이 번거로워 사용 경험이 크게 나빠지는 문제가 있었습니다.
심층 설명
EIP-5792 확장 구조
이 표준은 새 RPC 메서드를 만들지 않고 EIP-5792의 wallet_sendCalls와 wallet_getCapabilities 메서드에 새로운 캐퍼빌리티를 추가하는 방식으로 동작합니다. dApp은 wallet_getCapabilities 응답으로 지갑이 어떤 조건 유형을 지원하는지(supported, versions 필드) 확인하고 wallet_sendCalls 요청의 capabilities 필드에 조건을 담아 보냅니다. dApp이 조건 충족을 직접 처리하고 싶으면 이 기능을 쓰지 않아도 됩니다(MAY opt out).
ERC-20 조건: erc20MinBalance와 erc20MinAllowance
erc20MinBalance는 owner 주소가 chainId에서 token의 잔액을 최소 minAmount 이상 보유해야 한다는 요건입니다. 필드는 version, chainId, owner, token, minAmount이며 체인 ID와 수량은 16진수 문자열로 적습니다. erc20MinAllowance는 owner가 operator에게 token을 최소 minAmount만큼 쓸 수 있도록 허용량(allowance)을 설정해야 한다는 요건으로, operator 필드가 추가됩니다. 허용량 조건은 owner가 실제로 잔액을 갖고 있다는 뜻은 아니라는 점을 원문이 명시합니다.
ERC-721 조건: erc721Ownership과 erc721Approval
erc721Ownership은 owner 주소가 chainId에서 token 컨트랙트의 tokenId를 소유해야 한다는 요건입니다. 필드는 version, chainId, owner, token, tokenId입니다. erc721Approval은 owner가 operator에게 해당 tokenId의 전송 권한을 승인해야 한다는 요건으로, operator 필드가 추가됩니다. 승인 조건 역시 owner가 토큰을 보유하고 있다는 것을 뜻하지는 않습니다.
ERC-1155 조건: erc1155MinBalance와 erc1155MinAllowance
erc1155MinBalance는 owner가 chainId에서 token 컨트랙트의 특정 tokenId 잔액을 최소 minAmount 이상 보유해야 한다는 요건입니다. ERC-1155는 한 컨트랙트에 여러 종류의 토큰이 있으므로 tokenId와 minAmount를 함께 적습니다. erc1155MinAllowance는 owner가 operator에게 해당 tokenId를 최소 minAmount만큼 허용해야 한다는 요건이며 마찬가지로 잔액 보유를 의미하지는 않습니다.
지갑이 지켜야 할 의무 수준
각 조건에 대해 지갑은 본 거래 실행 전에 요건이 충족되는 것을 반드시 보장해야 합니다(MUST). 요건을 채울 해결 방법을 계산하는 것은 권장 사항이고(SHOULD), 사용자에게 사전 거래 서명을 요청하는 방식은 지갑이 선택할 수 있습니다(MAY). 스마트 컨트랙트 지갑의 예시에서는 모든 거래를 한 번에 서명받아 순서대로 실행하고 서명된 거래를 번들러에게 동시에 보내 지갑 연결이 끊겨도 작업이 완료되게 할 수 있다고 설명합니다.
설계 근거: 왜 캐퍼빌리티를 나눴는가
EIP-5792를 확장한 이유로 원문은 기존 캐퍼빌리티 발견 메커니즘 활용(일관성), 다른 EIP-5792 캐퍼빌리티와의 조합(조합성), 지갑이 지원하는 요건만 구현 가능(유연성), 새 요건 유형을 캐퍼빌리티로 추가 가능(확장성)의 네 가지를 듭니다. 요건을 하나의 캐퍼빌리티로 묶지 않고 여섯 개로 나눈 것은 지갑의 세분화된 지원, 명확한 지원 여부 확인, 요건 유형별 독립적인 버전 관리, 기본 지갑의 단순한 구현을 가능하게 하기 위해서입니다.
제안 상태
이 ERC는 2024년 10월 22일에 만들어진 Draft(초안) 상태의 제안입니다. EIP-20, 721, 1155, 5792가 필요합니다. 초안 단계이므로 내용이 앞으로 바뀌거나 진행이 멈출 수 있습니다.
쓸 때 주의할 점
- 새로운 보안 위험을 추가하지 않음: 원문은 이 표준이 새로운 보안 위험이나 신뢰 가정을 도입하지 않는다고 밝힙니다. 사용자는 이미 지갑 제공자가 자신을 대신해 거래를 만들고 조정하고 보내는 것을 신뢰하고 있으며 이 표준은 지갑이 거래 구성을 더 잘 판단하도록 돕는 필드를 요청에 추가할 뿐입니다.