ERC-7590 NFT의 ERC-20 보관 확장 (ERC-20 Holder Extension for NFTs)

Review · NFT·멀티토큰 · 2024-01-05 작성

NFT(ERC-721) 하나가 ERC-20 토큰을 받아 보관하고 NFT 소유자가 그 토큰을 꺼내 보낼 수 있게 하는 확장 표준입니다.

왜 필요한가

NFT는 본래 그림이나 게임 아이템 같은 고유한 자산 하나만 나타낼 뿐, 그 안에 다른 토큰을 담아 두는 방법이 표준으로 정해져 있지 않습니다. 그래서 게임처럼 고유 자산과 교환 가능한 토큰을 한 묶음으로 다뤄야 하는 서비스는 프로젝트마다 제각각의 방식을 만들어야 했습니다. 또 ERC-20 토큰에는 받는 쪽에 도착을 알려 주는 표준 방법이 없어서 토큰을 NFT 컨트랙트 주소로 그냥 보내면 어느 NFT에 넣으려던 것인지 알 길이 없습니다. 게다가 토큰을 담은 NFT를 파는 사람이 판매가 체결되기 직전에 안에 든 토큰만 몰래 빼내는 속임수를 막을 공통 장치도 없었습니다. 이 표준은 ERC-20 토큰을 특정 NFT에 넣고 꺼내는 공통 함수와, 꺼낼 때마다 올라가는 번호표(논스)를 정의해 이런 문제를 풀고자 합니다.

심층 설명

풀(pull) 방식으로 토큰을 넣는 이유

이 표준은 토큰을 NFT 컨트랙트로 직접 보내는 대신, NFT 컨트랙트가 호출자의 토큰을 끌어오는 풀 방식을 씁니다. 근거는 두 가지입니다. 첫째, 컨트랙트가 전송 과정을 직접 시작하므로 개발자가 전송 전후에 원하는 로직(훅)을 넣을 수 있습니다. 둘째, ERC-20에는 ERC-721의 safeTransfer 같은 콜백 있는 전송 방법이 표준으로 없어서 받는 쪽에 전송 성공을 알리거나 어느 NFT가 목적지인지 전달할 신뢰할 만한 방법이 없습니다. 대신 이 방식은 토큰을 넣기 전에 먼저 NFT 컨트랙트에 토큰 사용 승인(approve)을 해 두어야 한다는 단점이 있습니다.

입금 함수 transferERC20ToToken의 규칙

transferERC20ToToken은 erc20Contract 주소의 토큰 amount만큼을 tokenId가 가리키는 NFT에 넣습니다. 잔액은 반드시 msg.sender에게서 옮겨야 하고(MUST), 이를 위해 해당 ERC-20 컨트랙트에서 이 컨트랙트가 토큰을 옮길 수 있도록 승인이 되어 있어야 합니다. data 필드는 형식이 정해지지 않은 추가 데이터로, 구현체가 자체 로직을 붙일 때 씁니다. 토큰을 받으면 ReceivedERC20 이벤트로 어느 ERC-20 토큰이, 누구에게서, 어느 NFT로, 얼마나 들어왔는지 알립니다.

출금 함수 transferHeldERC20FromToken의 규칙

transferHeldERC20FromToken은 tokenId가 보유한 ERC-20 토큰 amount만큼을 to 주소로 보냅니다. 잔액은 반드시 이 컨트랙트에서 옮겨야 하고(MUST), 호출할 때마다 해당 tokenId의 전송 논스(transfer-out-nonce)를 반드시 올려야 하며(MUST), msg.sender가 NFT의 소유자도 아니고 관리 승인을 받은 계정도 아니면 반드시 되돌려야 합니다(MUST revert). 전송이 이루어지면 TransferredERC20 이벤트로 알립니다.

erc20TransferOutNonce와 판매 직전 빼돌림 방지

erc20TransferOutNonce는 해당 NFT에서 ERC-20 토큰이 밖으로 나갈 때마다 1씩 증가하는 값입니다. 토큰을 담은 NFT를 마켓플레이스에 올려 두고 구매가 체결되기 직전에 판매자가 안의 토큰만 빼내는 선행매매(front-running)를 막기 위한 장치입니다. 마켓플레이스는 판매 등록 시점의 논스를 기억해 두었다가, 체결 시점에 논스가 달라져 있으면 반드시 거래를 되돌려야 합니다(MUST).

토큰 종류별 세분형 설계를 택한 이유

설계 과정에서 토큰 종류마다 별도 인터페이스를 두는 세분형(granular)과, ERC-721과 ERC-1155까지 담는 범용형(universal) 두 가지를 비교했습니다. 세분형 구현은 가스가 조금 더 싸고 한두 종류만 쓸 때는 컨트랙트 크기도 작습니다. 범용형은 전체 크기가 작고 보내고 받는 함수가 하나씩이지만 ERC-20에는 필요 없는 id와 ERC-721에는 필요 없는 amount를 항상 요구해 복잡해집니다. 또 ERC-721과 ERC-1155에는 이미 safe transfer와 IERC721Receiver, IERC1155Receiver 같은 수신 인터페이스가 있어 추가 인터페이스가 크게 필요하지 않은 반면, ERC-20에는 수신자에게 알리는 콜백이 없습니다. 이런 이유로 세분형을 택했습니다.

아직 검토(Review) 단계인 제안

이 제안의 상태는 Review로, 아직 확정되지 않았고 내용이 바뀔 수 있는 단계입니다. 테스트 코드와 참조 구현(ERC7590Mock.sol)이 제안 자료로 함께 제공되며 ERC-20, ERC-165, ERC-721을 전제로 합니다. 실제 채택 전에는 최신 원문을 확인하는 것이 좋습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs