ERC-7564 컨트랙트 지갑 NFT 관리 (Contract wallet management NFT)

Draft · 계정·지갑 · 2023-11-21 작성

스마트 컨트랙트 지갑이 NFT 승인과 전송을 지갑 안에서 직접 관리하게 하는 인터페이스입니다. NFT 하나, 한 컨트랙트의 전체, 모든 NFT 단위로 승인을 설정할 수 있습니다.

왜 필요한가

지금은 NFT 승인과 전송 규칙을 각 NFT 컨트랙트가 정합니다. 일반 지갑(외부 소유 계정, EOA)은 상태나 코드를 저장할 수 없어서 사용자는 NFT 컨트랙트에 직접 승인(approve)을 호출하고 그 컨트랙트가 정한 방식을 그대로 따라야 합니다. 이 구조에서는 필요 이상으로 넓게 승인하는 과다 승인 같은 기존 ERC-721 컨트랙트의 위험을 사용자가 통제하기 어렵습니다. 또 조건이나 기한을 붙인 승인, 전송 앞뒤에 원하는 검사를 끼워 넣는 일, 여러 건을 한 번에 승인하거나 전송하는 일도 표준적인 방법이 없습니다. 이 제안은 상태와 코드를 가질 수 있는 스마트 컨트랙트 지갑 안에 NFT 승인과 전송 기능을 두어, 승인 관리의 주도권을 NFT 컨트랙트가 아니라 사용자 지갑으로 옮기려고 합니다.

구현해야 하는 것

심층 설명

승인 주도권을 지갑으로 옮기는 구조

EOA 지갑은 상태와 코드 저장이 없지만 스마트 컨트랙트 지갑은 있습니다. 이 제안은 그 프로그래머빌리티를 이용해 NFT 자산의 할당과 관리, 특히 승인 설정을 NFT 자산 컨트랙트가 아니라 사용자의 컨트랙트 지갑이 하도록 합니다. 원문은 이를 통해 기존 ERC-721 컨트랙트의 일부 위험을 피하는 것을 목표로 제시합니다. 또 이 ERC는 계정 추상화(Account Abstraction) 방향에서 ERC-4337 기반 확장이나 지갑 플러그인으로 쓸 수 있다고 설명합니다.

세 단계 승인 함수

승인 범위가 세 단계로 나뉩니다. nftApprove(_asset, _operator, _tokenId)는 특정 NFT 하나를 승인합니다. nftSetApprovalForOneAll(_asset, _operator, _approved)는 한 자산 컨트랙트의 모든 NFT를 승인하거나 해제합니다. nftSetApprovalForAllAll(_operator, _approved)는 지갑의 모든 NFT 자산을 한 번에 승인하거나 해제합니다. 각각 NftApproval, NftApprovalForOneAll, NftApprovalForAllAll 이벤트를 내야 하며 이벤트에는 자산 주소, 소유자, 오퍼레이터와 tokenId 또는 승인 여부가 담깁니다.

승인 조회 함수

설정과 짝을 이루는 조회 함수가 세 개 있습니다. nftGetApproved(_asset, _operator, _tokenId)는 특정 NFT 하나에 대한 승인 여부를, nftIsApprovedForOneAll(_asset, _operator)는 한 자산 컨트랙트 전체에 대한 승인 여부를, nftIsApprovedForAllAll(_operator)는 모든 NFT에 대한 승인 여부를 각각 bool 값(_approved)으로 반환합니다. 모두 view 함수입니다.

nftTransfer의 동작 규칙

nftTransfer(_asset, _to, _tokenId)는 함수 안에서 반드시 해당 NFT 자산 컨트랙트의 transfer()를 호출해야 합니다. 호출자가 지갑 자신이 아니면 반드시 승인을 검증하고 갱신해야 하며 성공 여부를 bool(_success)로 반환합니다. 사용자는 nftTransfer 앞뒤에 훅 함수를 추가해 기능을 넓힐 수 있고 nftReceive 함수 구현도 선택 사항입니다. 배치 승인과 배치 전송도 지갑이 선택적으로 지원할 수 있습니다.

설계 근거

기존 ERC-721에서는 EOA가 NFT 컨트랙트와 직접 상호작용해 approve를 호출하지만 이 제안의 함수들은 지갑 컨트랙트 안에서 NFT 사용을 더 정밀하게 통제하게 합니다. 승인 통제를 사용자 지갑으로 옮겨 과다 승인 같은 위험을 줄이고 조건부 승인이나 기한부 승인 같은 고급 승인 전략을 설정할 수 있게 합니다. 여러 승인·전송을 동시에 처리하는 배치 작업으로 효율을 높이고 전송 앞뒤에 사용자 정의 로직(훅)을 넣어 추가 보안 검사나 맞춤 동작을 붙일 수 있다고 설명합니다.

호환성과 요구 사항

준수 컨트랙트는 반드시 ERC-165 인터페이스를 구현해야 합니다. 이 ERC는 ERC-4337의 확장으로 쓸 수 있고 ERC-4337과 하위 호환됩니다. 원문은 이 지갑 인터페이스가 별도의 단순 NFT 표준(원문에서 번호가 미정인 ERC-X)을 지원하고 ERC-721이 그와 하위 호환되므로 기존 시장의 모든 NFT 관리와 호환될 수 있다고 설명합니다.

Draft 단계의 제안

이 ERC는 2023년 11월 21일에 만들어진 Draft 상태의 제안입니다. 아직 내용이 바뀔 수 있는 초안이므로 함수 이름이나 세부 규칙이 달라질 수 있습니다. 원문 코드 주석의 ERC-165 식별자 값도 비어 있는 등 미완성 부분이 남아 있습니다.

ERC 원문 · ← ERCs