ERC-998 조합형 NFT(컴포저블 토큰) (Composable Non-Fungible Token)

Draft · NFT·멀티토큰 · 2018-07-07 작성

NFT(ERC-721 토큰)가 다른 NFT나 ERC-20 토큰을 직접 소유할 수 있게 하는 확장 표준입니다. 토큰들을 소유 관계로 묶어 트리 구조를 만들고 뿌리 소유자만 바꾸면 전체를 한 번에 이전할 수 있습니다.

왜 필요한가

기존 표준에서 토큰의 주인은 언제나 지갑 주소나 컨트랙트 주소입니다. NFT가 다른 NFT를 갖거나, NFT 안에 ERC-20 토큰을 담아 두는 일은 표준만으로는 불가능합니다. 그래서 서로 관련 있는 토큰 여러 개를 하나의 단위로 묶어서 관리하거나 거래하려면, 각 토큰을 따로따로 옮기는 수밖에 없습니다. 이 표준은 ERC-721을 확장해 토큰이 토큰을 소유하는 관계를 컨트랙트에 기록하는 방법을 정의합니다. 토큰들이 소유 관계로 연결된 목록이나 트리를 이루면, 그 구조의 맨 위에는 전체를 소유하는 주소 하나(루트 소유자)가 있습니다. 루트 소유자만 바꾸면 트랜잭션 한 번으로 묶음 전체가 함께 이전됩니다.

구현해야 하는 것

심층 설명

네 가지 컴포저블 종류

이 표준은 네 종류를 정의합니다. ERC998ERC721 탑다운은 다른 ERC-721 토큰을 받아 보관하는 ERC-721 토큰이고 ERC998ERC20 탑다운은 ERC-20 토큰을 보관하는 ERC-721 토큰입니다. ERC998ERC721 바텀업은 스스로 다른 ERC-721 토큰에 붙는 ERC-721 토큰이고 ERC998ERC20 바텀업은 ERC-721 토큰에 귀속될 수 있는 ERC-20 토큰입니다. 탑다운 컨트랙트는 각 토큰의 자식 토큰 목록을 저장하고 바텀업 컨트랙트는 각 토큰의 부모 토큰을 저장합니다. 한 토큰이 여러 종류를 겸할 수 있으며 네 인터페이스 중 하나 이상을 구현하면 이 표준을 따르는 것입니다. 사용하는 각 인터페이스에는 ERC-165를 적용해야 합니다. 일반 ERC-721 토큰에 다른 NFT를 붙이고 싶으면 바텀업을, NFT가 일반 ERC-721 토큰을 담게 하려면 탑다운을 씁니다.

루트 소유자 기준 인증

모든 권한 검사는 트리 맨 위의 rootOwner를 기준으로 합니다. rootOwnerOf(_tokenId)로 루트 소유자를 찾은 뒤 msg.sender, getApproved(tokenId)의 반환값, isApprovedForAll(rootOwner, msg.sender)의 반환값과 비교해 하나라도 일치하면 통과하고 아니면 throw합니다. approve와 getApproved도 rootOwner 기준으로 구현합니다. 승인 기록을 rootOwner와 tokenId의 쌍으로 저장하므로, 트리가 새 루트 소유자에게 넘어가면 이전 소유자가 해 둔 승인은 이전 소유자 몫으로만 남아 자식 컴포저블들의 승인 상태를 걱정할 필요가 없습니다.

순회와 매직 값 0xcd740db5

rootOwnerOf와 rootOwnerOfChild는 소유 관계를 따라 트리를 거슬러 올라갑니다. 바텀업 토큰에 부모가 있으면 부모에 rootOwnerOf를 호출하고 실패하면 rootOwnerOfChild를, 그것도 실패하면 토큰의 소유자 주소를 루트로 봅니다. 상대 컨트랙트에 해당 함수가 있는지 미리 알 수 없으므로 실제 호출은 어셈블리의 staticcall로 하여 실패 여부를 확인하고 상태 변경을 막아야 합니다. 반환값 bytes32의 앞 4바이트에는 매직 값 0xcd740db5가, 뒤 20바이트에는 주소가 들어갑니다. 이 값은 rootOwnerOf, rootOwnerOfChild, tokenOwnerOf, ownerOfChild 네 셀렉터의 XOR입니다. 함수 존재 여부가 불확실한 호출에서는 앞 4바이트를 반드시 이 값과 비교해 유효한 반환인지 확인합니다. 탑다운과 바텀업은 서로 호환되어 어떤 구성에서든 rootOwnerOf가 최상위 주소를 반환합니다.

탑다운에 토큰을 넣는 두 가지 경로

ERC-721 토큰을 넣는 방법은 두 가지입니다. 첫째, 원래 컨트랙트의 safeTransferFrom을 호출하면서 data에 받는 부모 tokenId를 정수로 담으면 컴포저블의 onERC721Received가 이를 읽어 기록합니다. 반환값은 매직 값 0x150b7a02입니다. 둘째, safeTransferFrom이 없는 오래된 컨트랙트(원문은 크립토키티를 예로 듭니다)는 approve나 setApprovalForAll로 컴포저블 컨트랙트를 승인한 뒤 getChild를 호출합니다. getChild는 msg.sender가 그 ERC-721 토큰의 소유자이거나 승인받은 자인지 인증해야 합니다. ERC-20도 같은 구조로, ERC-223의 transfer(address,uint256,bytes)를 지원하면 data에 tokenId를 담아 보내고 tokenFallback으로 통지받습니다. 아니면 approve 후 getERC20을 씁니다.

transferFrom 금지 규칙과 from:to:what 형식

탑다운이든 바텀업이든 다른 토큰이 소유한 토큰을 transferFrom이나 safeTransferFrom으로 직접 옮기려 하면 반드시 throw해야 합니다. 이 함수들은 어느 토큰이 소유자인지 명시하지 않기 때문입니다. transferFrom 계열은 주소가 소유한 토큰에만 씁니다. 대신 모든 전송 함수는 from:to:what 형식으로 보내는 쪽, 받는 쪽, 대상을 명시합니다. 원문은 from을 명시하지 않을 때의 문제를 예로 듭니다. 거래소 컨트랙트가 여러 사용자의 운영자(operator)일 때, 사용자 A가 토큰 1을 B에게 보낸 직후 거래소가 A에게서 받을 의도로 같은 토큰을 C에게 보내면, from이 없을 경우 B가 막 받은 토큰이 잘못 C에게 넘어갑니다. from을 명시하면 두 번째 전송이 실패합니다.

바텀업 컴포저블의 필수 검증

ERC-721 바텀업은 토큰마다 소유 주소와 부모 tokenId를 저장하며 tokenOwnerOf로 조회합니다. isParent가 참이면 tokenOwner는 소유 컨트랙트 주소이고 parentTokenId가 유효합니다. 거짓이면 사용자 주소이고 parentTokenId는 무시해야 합니다. transferToParent와 transferAsChild는 받는 토큰이 받는 컨트랙트에 존재하는지 확인하고 아니면 throw해야 합니다. transferFromParent와 transferAsChild는 보내는 컨트랙트와 tokenId가 실제로 그 토큰을 소유하는지 확인해야 합니다. ERC-20 바텀업은 주소 잔액 매핑에 더해 컨트랙트주소→tokenId→잔액 매핑 하나를 추가해 구현할 수 있습니다. transferToParent는 받는 컨트랙트가 ERC-165의 supportsInterface로 ERC-721을 구현하는지 확인해야 하고 ownerOf 호출로 받는 토큰의 존재를 확인하는 것이 좋습니다. 모든 전송에서 표준 ERC-20 Transfer 이벤트를 함께 발생시켜야 합니다. 토큰이 당사자인 경우 해당 파라미터에는 그 토큰의 컨트랙트 주소를 넣는 것이 좋습니다.

선택 사항인 열거 인터페이스

자식 목록 조회는 선택 인터페이스로 분리되어 있습니다. ERC998ERC721TopDownEnumerable(식별자 0xa344afe4)은 totalChildContracts, childContractByIndex, totalChildTokens, childTokenByIndex로 부모 토큰이 가진 자식 컨트랙트와 자식 토큰을 인덱스로 조회합니다. ERC998ERC20TopDownEnumerable(0xc5fd96cd)은 totalERC20Contracts와 erc20ContractByIndex를 제공합니다. ERC998ERC721BottomUpEnumerable(0x8318b539)은 부모 토큰이 가진 자식 토큰 수와 인덱스별 자식을 조회합니다. 핵심 인터페이스의 ERC-165 식별자는 ERC998ERC721TopDown이 0xcde244d9, ERC998ERC20TopDown이 0x7294ffed, ERC998ERC721BottomUp이 0xa1b23002, ERC998ERC20BottomUp이 0xffafa991입니다.

Draft 상태

이 제안은 2018년 7월에 만들어졌고 상태가 Draft(초안)입니다. 내용이 바뀔 수 있고 확정된 표준이 아닙니다. Security Considerations 절도 논의가 필요하다고만 적혀 있어 보안 분석이 정리되지 않은 상태입니다. 참조 구현은 원문에 링크된 composables-998 저장소에 있습니다.

ERC 원문 · ← ERCs