ERC-7498 NFT 교환권(리디머블) 표준 (NFT Redeemables)
Draft · NFT·멀티토큰 · 2023-07-28 작성
NFT를 온체인 토큰이나 실물 상품으로 바꿀 수 있는 교환 캠페인을 표준 방식으로 만들고 지갑과 앱이 그 조건을 자동으로 찾아 쓸 수 있게 합니다.
왜 필요한가
창작자는 NFT를 디지털 상품이나 실물 상품의 교환권으로 자주 씁니다. 예를 들어 특정 NFT를 태우면 새 NFT를 주거나, NFT 보유자에게 굿즈를 배송하는 식입니다. 그런데 공통 인터페이스가 없으면 이런 교환 행사가 있는지, 무엇을 내야 하고 무엇을 받는지, 언제까지 할 수 있는지를 지갑이나 마켓플레이스가 예측 가능한 방법으로 알아낼 수 없습니다. 프로젝트마다 제각각인 컨트랙트를 일일이 분석해야 하고 사용자는 공식 웹사이트에 가야만 교환에 참여할 수 있습니다. 실물 상품 교환은 더 어렵습니다. 온체인에서 NFT를 태우는 일과 오프체인 주문(상품 선택, 배송지 입력)을 묶어 줄 표준 연결 고리가 없어서 NFT를 먼저 태웠는데 배송이 안 되는 지역이라는 사실을 뒤늦게 아는 문제까지 생길 수 있습니다. 이 표준은 ERC-721과 ERC-1155를 확장해 교환 캠페인의 공개(이벤트·조회 함수), 온체인 발행, 오프체인 주문 연결을 하나의 인터페이스로 정의합니다.
구현해야 하는 것
event CampaignUpdated(uint256 indexed campaignId, Campaign campaign, string metadataURI);: 캠페인이 새로 만들어지거나 수정될 때 발생하는 이벤트입니다. 앱이 캠페인 내용을 발견하는 기준이 됩니다.event Redemption(uint256 indexed campaignId, uint256 requirementsIndex, bytes32 redemptionHash, uint256[] considerationTokenIds, uint256[] traitRedemptionTokenIds, address redeemedBy);: 유효한 교환이 일어날 때마다 발생하는 이벤트입니다. 어떤 캠페인에서 누가 어떤 토큰으로 교환했는지 기록합니다.function getCampaign(uint256 campaignId) external view returns (Campaign memory campaign, string memory metadataURI, uint256 totalRedemptions);: 캠페인 내용과 메타데이터 URI, 지금까지의 총 교환 횟수를 조회합니다.function createCampaign(Campaign calldata campaign, string calldata metadataURI) external returns (uint256 campaignId);: 새 캠페인을 만들고 새로 부여된 campaignId를 반환합니다.function updateCampaign(uint256 campaignId, Campaign calldata campaign, string calldata metadataURI) external;: 기존 캠페인을 수정합니다. manager 주소만 호출할 수 있습니다.function redeem(uint256[] calldata considerationTokenIds, address recipient, bytes calldata extraData) external payable;: 지정한 토큰들을 내고 교환을 실행합니다. extraData에 캠페인 번호, 조건 인덱스, 해시, 서명 등을 담습니다.
심층 설명
캠페인 구조: offer, consideration, traitRedemptions
캠페인(Campaign)은 params와 requirements 배열로 구성됩니다. CampaignParams에는 startTime, endTime, maxCampaignRedemptions, 캠페인을 수정할 수 있는 manager, 서명 요구 여부를 정하는 signer가 들어갑니다. CampaignRequirements는 Seaport의 용어를 빌려 offer(교환으로 받는 것), consideration(교환을 위해 내야 하는 것), traitRedemptions(특성 변경 조건)로 구성되며 requirements 배열 중 하나만 완전히 충족하면 교환이 성립합니다. consideration의 recipient는 토큰을 받을 주소이며 소각이 목적이면 0x000000000000000000000000000000000000dEaD로 보내거나, 토큰이 자체 소각과 totalSupply 감소를 처리할 수 있으면 직접 소각해도 됩니다. 토큰 구현은 ERC-165 supportsInterface에서 interfaceId 0x1ac61e13에 대해 true를 반환해야 합니다.
캠페인 생성과 수정 규칙
새 캠페인은 반드시 createCampaign으로 만들고 새 campaignId를 반환하며 CampaignUpdated 이벤트를 내야 합니다. campaignId는 캠페인마다 1씩 증가하는 카운터이고 첫 캠페인은 반드시 1입니다. 수정은 updateCampaign을 쓸 수 있으며 역시 CampaignUpdated 이벤트를 내야 합니다. manager가 아닌 주소가 수정을 시도하면 NotManager()로 되돌려야 합니다. 캠페인을 더 이상 바꿀 수 없게 만들려면 manager를 널 주소로 설정하면 됩니다.
offer 토큰과 IRedemptionMintable
params의 offer에 토큰이 지정되면 그 토큰은 새 아이템 발행을 지원하기 위해 IRedemptionMintable 인터페이스를 구현해야 하며 ERC-165 supportsInterface에서 interfaceId 0x81fe13c2에 대해 true를 반환해야 합니다. redeem이 실행되면 모든 offer 아이템에 대해 mintRedemption()이 호출되는데, 이때 campaignId, recipient, offer, consideration, traitRedemptions가 인자로 전달돼 발행 컨트랙트가 무엇이 교환됐는지 알 수 있습니다. mintRedemption 호출 시에는 consideration과 trait redemption의 토큰 식별자를 실제로 교환된 아이템으로 바꿔 전달하는 것이 권장됩니다.
redeem 실행 순서와 extraData 레이아웃
redeem 함수는 campaignId와 requirementsIndex로 정해지는 requirements의 consideration 이전 실행, ERC-7496에 따른 traitRedemptions 특성 변경, 모든 offer 아이템에 대한 mintRedemption() 호출을 수행하고 유효한 교환마다 Redemption 이벤트를 내야 합니다. extraData는 0-32바이트 campaignId, 32-64 requirementsIndex, 64-96 redemptionHash(오프체인 주문 ID의 해시), 96바이트부터 uint256[] traitRedemptionTokenIds, 이어서 signer가 널 주소가 아닐 때만 salt와 서명(EIP-712 또는 ERC-1271)이 옵니다. traitRedemptionTokenIds의 순서는 캠페인 requirement의 TraitRedemption 구조체 배열에서 기대하는 토큰 주소 순서와 같아야 합니다. 캠페인 활성 여부는 Seaport와 같은 경계 조건 startTime <= block.timestamp < endTime으로 검사하고 비활성이면 NotActive()로 되돌려야 합니다. maxCampaignRedemptions를 초과하는 교환은 MaxCampaignRedemptionsReached(uint256 total, uint256 max)로 되돌려야 합니다.
특성 교환(trait redemption) 서브스탠더드
토큰을 태우거나 이전하지 않고 ERC-7496 동적 특성 값을 바꾸는 방식의 교환도 지원합니다. 특성 교환을 쓰려면 토큰이 ERC-7496을 반드시 포함해야 합니다. TraitRedemption의 substandard는 4가지입니다. 1은 특성 값을 traitValue로 설정(substandardValue는 사전에 요구되는 값이며 비어 있으면 이미 traitValue인 상태는 허용되지 않음), 2는 traitValue만큼 증가(substandardValue는 최대값), 3은 traitValue만큼 감소(substandardValue는 최소값), 4는 값이 traitValue인지 확인입니다. 이 방식은 2차 시장 주문에서 특성 값을 온체인으로 강제할 수 있게 하기 위한 것입니다.
서명자(signer)와 오프체인 교환 보호
캠페인에 signer를 지정하면 교환 처리에 서명이 필요합니다. signer가 널 주소가 아니면 서명은 EIP-712 또는 ERC-1271로 signer 주소로 복원돼야 합니다. EIP-712 서명 구조체는 SignedRedeem(address owner,uint256[] considerationTokenIds,uint256[] traitRedemptionTokenIds,uint256 campaignId,uint256 requirementsIndex, bytes32 redemptionHash, uint256 salt)로 고정입니다. 이 장치는 주로 오프체인 교환에서 제공자가 온체인 실행 전에 교환을 미리 승인하기 위한 것입니다. 예를 들어 사용자의 배송 국가가 지원되지 않으면 서명을 발급하지 않음으로써, NFT를 이미 태우거나 특성을 바꾼 뒤에야 배송 불가를 알게 되는 상황을 막습니다.
메타데이터 URI와 ERC-1155 적용
캠페인 메타데이터 URI는 정해진 JSON 스키마를 따라야 합니다. 필수 필드는 campaignId, name, description, imageUrls, isBurn이고, 그 외에 상세 설명(details), 배너 이미지, FAQ, 콘텐츠 언어(contentLocale), 토큰당 최대 교환 횟수(maxRedemptionsPerToken), 한 번의 교환에서 고를 수 있는 상품 수(productLimitForRedemption), 상품 목록(products) 등을 담을 수 있습니다. imageUrls는 최대 5개이며 첫 이미지가 썸네일로 쓰입니다. 이 표준은 ERC-1155에도 적용할 수 있지만 교환이 특정 토큰 식별자의 모든 수량에 적용됩니다. ERC-1155 컨트랙트의 토큰 수량이 전부 1이라면 명세를 그대로 쓸 수 있습니다.
표준 상태: Draft
이 제안은 2023년 7월 28일에 만들어졌고 현재 상태가 Draft입니다. 아직 내용이 바뀔 수 있는 초안 단계이므로, 구현 전에 최신 명세를 확인해야 합니다.
쓸 때 주의할 점
- ERC-7496 동적 특성의 올바른 구현: 특성 교환 기능을 쓰려는 토큰은 ERC-7496 동적 특성을 올바르게 구현해야 합니다. 구현이 잘못되면 특성 변경을 전제로 한 교환 로직이 깨질 수 있습니다.
- mintRedemption 호출 권한 제한: params의 offer로 발행되는 토큰에서 IRedemptionMintable의 mintRedemption 함수는 반드시 권한이 제한돼야 하며 지정된 주소만 호출할 수 있어야 합니다. 누구나 호출할 수 있으면 교환 없이 토큰이 발행될 수 있습니다.