ERC-7832 지속 가능한 협업 NFT 컬렉션 (Sustainable collaborative NFT collections)
Review · NFT·멀티토큰 · 2024-12-04 작성
ERC-721 기반 협업 NFT 컬렉션에 동적 민팅 수수료, 역할 기반 권한, 기부 참여 모델을 더해 창작자와 커뮤니티가 경제적으로 지속 가능하게 운영하도록 하는 표준입니다.
왜 필요한가
NFT 시장이 커지면서 공급이 계속 늘어나는 인플레이션 문제와, 커뮤니티를 의미 있게 참여시킬 장치가 없다는 문제가 반복됩니다. 발행 수수료가 고정돼 있으면 소수가 토큰을 쌓아 두는 사재기와 편중된 소유가 생기기 쉽고 창작자는 커뮤니티의 후원을 받을 지속 가능한 방법이 없습니다. 또 관리자가 수수료 같은 핵심 조건을 아무 때나 바꿀 수 있으면 시장 안정성이 흔들리고 참여자의 신뢰가 깨집니다. 이 표준은 역할 기반 접근 제어, 사용자 활동에 따라 달라지는 동적 민팅 수수료, 창작자에게 직접 후원하는 기부 모델을 도입하고 운영 조건 변경을 일정 시간 간격으로만 허용해 이런 문제를 풀려고 합니다.
구현해야 하는 것
event DonationReceived(address from, address to, uint256 amount);: 사용자가 창작자에게 ETH를 기부했을 때 보낸 주소, 받은 주소, 금액을 기록하는 이벤트입니다.function currentTokenId() external view returns (uint256);: 현재 토큰 ID를 반환합니다. 지금까지 발행된 토큰 수를 가늠하는 데도 쓸 수 있습니다.function mintBaseFee() external view returns (uint256);: 새 토큰을 만들 때 사용자가 내는 기본 민팅 수수료를 반환합니다.function creatorSignatureFee() external view returns (uint256);: 크리에이터 서명을 얻어 창작자가 되는 데 필요한 수수료를 반환합니다.function maxMintsPerUserInCycle() external view returns (uint256);: 한 사용자가 점진 할인 사이클 안에서 민팅할 수 있는 최대 횟수를 반환합니다. 한도를 넘으면 횟수가 0으로 초기화됩니다.function lastUpdateTimestamp() external view returns (uint256);: 계약 조건이 마지막으로 갱신된 시각을 반환합니다. 다음 갱신 가능 시점을 판단하는 데 쓰입니다.function UPDATE_INTERVAL() external pure returns (uint256);: 계약 조건을 다시 바꾸기까지 기다려야 하는 시간 간격을 반환합니다.function getCreatorSignature() external payable;: 정해진 수수료를 내고 크리에이터 서명을 얻습니다. 결제 후 호출자는 CREATOR_ROLE을 받습니다.function CONTRIBUTOR_ROLE() external pure returns (bytes32);: 기여자 역할의 식별자를 반환합니다.function CREATOR_ROLE() external pure returns (bytes32);: 창작자 역할의 식별자를 반환합니다.function ADMIN_ROLE() external pure returns (bytes32);: 관리자 역할의 식별자를 반환합니다.function mintsPerUserInCycle(address user) external view returns (uint256);: 해당 사용자가 현재 할인 사이클에서 민팅한 횟수를 반환합니다. 사용자별 민팅 한도를 지키는 데 쓰입니다.function donate(address creator) external payable;: 특정 창작자에게 ETH를 기부합니다. 기부 후 기부자는 CONTRIBUTOR_ROLE을 받습니다.function mintFee() external view returns (uint256);: 호출자가 지금 내야 할 민팅 수수료를 사이클 내 민팅 횟수에 따라 계산해 반환합니다.function burn(uint256 tokenId) external;: 토큰 소유자가 자기 토큰을 소각합니다.function pause() external;: 관리자가 계약을 일시 중지해 일부 기능을 막습니다.function unpause() external;: 관리자가 일시 중지를 해제해 기능을 다시 켭니다.function safeMint(string memory uri) external payable;: CREATOR_ROLE을 가진 호출자가 수수료를 내고 지정한 URI로 새 토큰을 자기 주소에 발행합니다.function updateTerms( uint256 mintBaseFee, uint256 creatorSignatureFee, uint256 maxMintsPerUserInCycle ) external;: 관리자가 민팅 기본 수수료, 크리에이터 서명 수수료, 사이클당 최대 민팅 횟수를 갱신합니다.function withdraw(uint256 amount) external;: 관리자가 계약에 쌓인 ETH를 출금합니다.
심층 설명
세 가지 역할과 접근 제어
시스템은 ADMIN_ROLE, CREATOR_ROLE, CONTRIBUTOR_ROLE 세 역할 식별자(bytes32)를 둡니다. ADMIN_ROLE과 CREATOR_ROLE은 반드시 생성자에서 msg.sender에게 부여해야 합니다. 관리자는 조건 갱신(updateTerms), 일시 중지(pause, unpause), 출금(withdraw)을 맡고 창작자는 safeMint로 토큰을 발행하고 기부를 받습니다. 기여자는 donate로 기부한 사용자가 받는 역할입니다. 역할 기반 접근 제어로 민감한 기능을 신뢰된 주체만 실행하게 해 임의 변경으로 시장 안정성과 신뢰가 흔들리는 것을 막습니다.
동적 민팅 수수료 공식
mintFee는 호출자가 낼 수수료를 계산합니다. 호출자가 ADMIN_ROLE이면 0, 사이클 내 민팅 횟수(userMints)가 1 이하면 mintBaseFee 그대로, 1보다 크면 mintBaseFee를 userMints의 로그값으로 나눈 금액입니다. 수수료 감소는 로그 방식으로 완만하게 하도록 권장(RECOMMENDED)되며 Solidity가 소수를 다루지 못하므로 로그값은 항상 정수로 반올림됩니다. 참조 구현은 Math.log2를 나눗수로 씁니다. safeMint 호출자는 이 수수료를 반드시 내야 합니다.
민팅 사이클과 한도 초기화
mintsPerUserInCycle(address user)는 사용자가 현재 점진 할인 사이클에서 민팅한 횟수를 추적하고 maxMintsPerUserInCycle은 사이클당 최대 횟수를 정합니다. safeMint에서 한도를 초과하면 그 사용자의 민팅 횟수는 0으로 초기화(SHALL)됩니다. 할인이 민팅 횟수에 따라 붙는 구조이므로, 초기화는 할인 사이클을 처음부터 다시 시작하게 하는 장치입니다. safeMint는 CREATOR_ROLE만 호출할 수 있고 계약이 일시 중지 상태가 아닐 것을 요구하도록 권장됩니다.
조건 갱신 제한과 UPDATE_INTERVAL
updateTerms는 관리자만 호출해 mintBaseFee, creatorSignatureFee, maxMintsPerUserInCycle을 갱신하며 갱신 후 반드시 CreatorTermsUpdated 이벤트를 냅니다. 계약 생성자에서 첫 갱신으로 반드시 한 번 호출돼야 하고 이후에는 lastUpdateTimestamp를 기준으로 UPDATE_INTERVAL이 지나야 다시 갱신할 수 있습니다. UPDATE_INTERVAL은 시간 단위로 최소 720시간(30일)으로 정하도록 권장됩니다. 이 제한이 과도한 관리자 개입을 막아 가격 발견과 참여자 신뢰를 지키는 '경제적 지속 가능성'의 핵심입니다.
크리에이터 서명과 기부 규칙
getCreatorSignature는 호출자가 creatorSignatureFee를 내면 CREATOR_ROLE을 부여(SHALL)하는 함수로, 일시 중지 상태가 아닐 것을 요구하도록 권장됩니다. donate는 CREATOR_ROLE을 가진 유효한 주소에만 기부할 수 있고 자기 자신에게는 기부할 수 없으며 금액은 0보다 커야 합니다. 처리 후 반드시 DonationReceived 이벤트를 내고 기부자는 CONTRIBUTOR_ROLE을 받습니다. 원문 Rationale은 이 기부 기록을 이후 거래에서 혜택을 부여하는 데 쓸 수 있다고 설명합니다.
소각, 일시 중지, 출금
burn(tokenId)은 해당 토큰의 소유자만 호출할 수 있습니다. pause와 unpause는 ADMIN_ROLE만 호출해 비상시 계약 기능을 막거나 다시 켭니다(SHOULD). withdraw(amount)는 ADMIN_ROLE만 호출해 계약의 ETH를 출금합니다. 이 표준은 ERC-721과 완전히 호환되며 동적 수수료와 기부 같은 확장은 모듈 방식이어서 기존 NFT 기능에 영향을 주지 않습니다.
제안 상태
이 제안은 현재 Review 상태입니다. 아직 검토 중인 단계라 명세가 바뀔 수 있다는 점을 염두에 두어야 합니다.
쓸 때 주의할 점
- 재진입 보호: safeMint, withdraw, donate 함수는 재진입(reentrancy) 공격에 대비해 보호하도록 권장됩니다.
- 일시 중지 상태: 관리자는 비상 상황에서 계약을 일시 중지해 원치 않는 작업을 막고 위험을 줄일 수 있어야 합니다(MUST).
- 소각 보안: 토큰 소유자만 소각할 수 있게 해 악의적 컨트랙트나 무단 사용자가 남의 토큰을 파괴하는 위험을 줄이고 실수나 남용으로 인한 토큰 파괴를 막습니다.