ERC-7603 ERC-1155 멀티에셋 확장 (ERC-1155 Multi-Asset extension)
Draft · NFT·멀티토큰 · 2024-01-25 작성
하나의 토큰 컬렉션에 여러 에셋(파일)을 붙이고 우선순위를 매겨 전자책 리더·마켓플레이스·게임 등 접근하는 환경에 맞는 형식으로 보여 줄 수 있게 하는 ERC-1155 호환 확장입니다.
왜 필요한가
ERC-1155 토큰은 보통 하나의 출력물만 가리키기 때문에, 같은 토큰을 전자책 리더에서 열든 마켓플레이스에서 열든 게임에서 불러오든 똑같은 파일을 보여 줄 수밖에 없습니다. 게임 A용 치장 아이템은 프레임워크가 다른 게임 B에서는 쓸 수 없고 게임 개발자는 에셋 정보를 코드에 직접 박아 넣어야 합니다. 또 많은 토큰이 급하게 발행되면서 메타데이터를 중앙 서버나 특정 IPFS 게이트웨이 한 곳에만 올려 두는데, 그곳이 멈추면 토큰이 가리키는 정보 전체가 끊어집니다. 이 표준은 한 토큰 컬렉션에 서로 다른 형식의 에셋 여러 개를 붙이고 우선순위로 정렬할 수 있게 해 맥락별 출력과 저장 중복화를 가능하게 합니다.
구현해야 하는 것
event AssetSet(uint64 assetId);: 에셋 객체가 assetId로 초기화되었음을 알립니다.event AssetPrioritySet(uint256 indexed tokenId);: 토큰의 우선순위 배열이 재정렬되었음을 알립니다.function setPriority(uint256 tokenId, uint64[] calldata priorities) external;: 토큰의 에셋 우선순위 배열을 새로 설정합니다. 값이 낮을수록 우선순위가 높습니다.function getAssets(uint256 tokenId) external view returns (uint64[] memory);: 토큰에 붙은 에셋들의 ID 배열을 돌려줍니다.function getAssetPriorities(uint256 tokenId) external view returns (uint64[] memory);: 토큰 에셋들의 우선순위 배열을 돌려줍니다.function getAssetMetadata(uint256 tokenId, uint64 assetId) external view returns (string memory);: 지정한 토큰의 특정 에셋에 해당하는 메타데이터 문자열을 돌려줍니다.
심층 설명
에셋 모델: 이름공간이 붙은 tokenURI
토큰 컬렉션은 여러 에셋(출력물)을 가질 수 있고 에셋은 어떤 파일이어도 되며 우선순위로 정렬합니다. 에셋끼리 MIME 타입이나 tokenURI가 일치할 필요가 없고 서로 의존하지도 않습니다. 원문은 에셋을 독립된 개체가 아니라 이름공간이 붙은 tokenURI(namespaced tokenURIs)로 보아야 한다고 설명합니다. 이렇게 하면 토큰이 전자책 리더에서 열리면 PDF, 마켓플레이스에서는 PNG나 SVG, 게임 안에서는 3D 모델, IoT 허브에서는 주소와 사양 정보를 담은 에셋이 선택되는 식으로, 접근 방식에 따라 알맞은 형식이 표시됩니다.
setPriority와 우선순위 규칙
setPriority(tokenId, priorities)는 토큰의 우선순위 배열을 새로 설정합니다. 우선순위는 비연속적인 값의 목록이며 값이 낮을수록 우선순위가 높고 0은 초기화되지 않음을 뜻하는 특수 값입니다. tokenId가 존재해야 하고 priorities의 길이가 에셋 배열의 길이와 같아야 하며 실행 시 AssetPrioritySet 이벤트를 냅니다. 참고로 주석은 우선순위를 uint16 목록으로 설명하지만 함수 시그니처의 인자와 getAssetPriorities의 반환 타입은 uint64[]로 선언되어 있습니다.
조회 함수 세 가지
getAssets(tokenId)는 토큰에 붙은 에셋 ID 배열(uint64[])을 돌려줍니다. 에셋 데이터는 참조 방식으로 저장되므로 실제 내용은 getAssetMetadata(tokenId, assetId)를 호출해 가져옵니다. getAssetPriorities(tokenId)는 에셋 우선순위 배열을 돌려줍니다. getAssetMetadata는 지정한 에셋의 메타데이터 문자열을 반환하며 열거(enumerate)나 폴백 같은 커스텀 로직을 넣도록 오버라이드할 수 있다고 명시되어 있습니다. assetId는 해당 토큰의 에셋 배열에 있어야 합니다.
세 가지 이벤트
AssetSet(assetId)은 에셋 객체가 초기화될 때 발생합니다. AssetAddedToToken(tokenId, assetId, replacesId)은 에셋이 토큰의 에셋 배열에 추가될 때 발생하며 replacesId는 교체될 에셋의 ID를 가리킵니다. 이 이벤트의 tokenId 인자는 uint256 배열(uint256[])로 선언되어 있습니다. AssetPrioritySet(tokenId)은 토큰의 우선순위 배열이 재정렬될 때 발생합니다.
세 가지 활용 동기
원문은 세 가지 개선 영역을 듭니다. 첫째, 크로스 메타버스 호환성입니다. 게임 A용 치장 에셋 파일, 게임 B용 에셋 파일, 카탈로그·마켓플레이스·포트폴리오 트래커용 일반 에셋(스타일화된 썸네일, 애니메이션 데모 등)을 한 토큰에 담아 게임 개발자가 하드코딩 대신 사용자의 토큰에서 에셋 데이터를 직접 가져올 수 있습니다. 둘째, 멀티미디어 출력입니다. 전자책 토큰을 전자책 리더에서는 PDF로, 오디오북 앱에서는 MP3로 표시할 수 있습니다. 셋째, 미디어 중복 저장입니다. 같은 메타데이터와 이미지 조합을 Arweave, Sia, IPFS 등 여러 프로토콜에 각각 에셋으로 등록하면 모든 프로토콜이 동시에 멈출 가능성이 낮아져 복원력이 커집니다.
ERC-1155 호환성
이 표준은 ERC-1155와 호환되도록 만들어졌습니다. ERC-1155 구현에 쓰이는 탄탄한 도구들을 그대로 활용하고 기존 ERC-1155 인프라와의 호환성을 보장하기 위해서입니다. 서문의 requires 항목에 따라 ERC-165와 ERC-1155를 전제로 하며, 인터페이스 주석에도 ERC-165를 상속하는 것으로 표시되어 있습니다.
Draft 상태의 미완성 제안
이 제안은 Draft 상태입니다. 원문의 Rationale 절은 TBD(추후 작성)로 비어 있고 Security Considerations 절도 논의가 필요하다고만 되어 있어 보안 지침이 아직 없습니다. 내용이 앞으로 바뀔 수 있는 초안이므로 구현하거나 참고할 때 이 점을 고려해야 합니다.