ERC-7564 컨트랙트 지갑 NFT 관리 (Contract wallet management NFT)
Draft · 계정·지갑 · 2023-11-21 작성
스마트 컨트랙트 지갑이 NFT 승인과 전송을 지갑 안에서 직접 관리하게 하는 인터페이스입니다. NFT 하나, 한 컨트랙트의 전체, 모든 NFT 단위로 승인을 설정할 수 있습니다.
왜 필요한가
지금은 NFT 승인과 전송 규칙을 각 NFT 컨트랙트가 정합니다. 일반 지갑(외부 소유 계정, EOA)은 상태나 코드를 저장할 수 없어서 사용자는 NFT 컨트랙트에 직접 승인(approve)을 호출하고 그 컨트랙트가 정한 방식을 그대로 따라야 합니다. 이 구조에서는 필요 이상으로 넓게 승인하는 과다 승인 같은 기존 ERC-721 컨트랙트의 위험을 사용자가 통제하기 어렵습니다. 또 조건이나 기한을 붙인 승인, 전송 앞뒤에 원하는 검사를 끼워 넣는 일, 여러 건을 한 번에 승인하거나 전송하는 일도 표준적인 방법이 없습니다. 이 제안은 상태와 코드를 가질 수 있는 스마트 컨트랙트 지갑 안에 NFT 승인과 전송 기능을 두어, 승인 관리의 주도권을 NFT 컨트랙트가 아니라 사용자 지갑으로 옮기려고 합니다.
구현해야 하는 것
function nftApprove(address _asset, address _operator, uint256 _tokenId) external;: 오퍼레이터가 지갑에서 특정 NFT 하나를 가져갈 수 있도록 승인합니다. NftApproval 이벤트를 냅니다.function nftSetApprovalForOneAll(address _asset, address _operator, bool _approved) external;: 한 자산 컨트랙트의 모든 NFT에 대해 오퍼레이터 승인을 설정하거나 해제합니다. NftApprovalForOneAll 이벤트를 냅니다.function nftSetApprovalForAllAll(address _operator, bool _approved) external;: 지갑이 가진 모든 NFT에 대해 오퍼레이터 승인을 설정하거나 해제합니다. NftApprovalForAllAll 이벤트를 냅니다.function nftGetApproved(address _asset, address _operator, uint256 _tokenId) external view returns (bool _approved);: 오퍼레이터가 특정 NFT 하나에 대해 승인받았는지 조회합니다.function nftIsApprovedForOneAll(address _asset, address _operator) external view returns (bool _approved);: 오퍼레이터가 한 자산 컨트랙트의 모든 NFT에 대해 승인받았는지 조회합니다.function nftIsApprovedForAllAll(address _operator) external view returns (bool _approved);: 오퍼레이터가 모든 NFT에 대해 승인받았는지 조회합니다.function nftTransfer(address _asset, address _to, uint256 _tokenId) external returns (bool _success);: 지갑이 보유한 NFT를 지정한 주소로 전송하고 성공 여부를 반환합니다. 함수 안에서 해당 NFT 컨트랙트의 transfer()를 호출해야 합니다.
심층 설명
승인 주도권을 지갑으로 옮기는 구조
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 식별자 값도 비어 있는 등 미완성 부분이 남아 있습니다.