ERC-5173 NFT 미래 보상(nFR) (NFT Future Rewards (nFR))
Draft · NFT·멀티토큰 · 2022-05-08 작성
NFT를 판 뒤에도 그 NFT의 값이 오르면 이전 소유자들이 실현 이익의 일부를 나눠 받을 수 있게 하는 ERC-721 확장 표준입니다.
왜 필요한가
지금의 NFT 표준(ERC-721)에서는 NFT를 팔고 나면 그 자산과의 관계가 완전히 끊어집니다. 이후 가격이 아무리 올라도 이전 소유자에게 돌아오는 몫은 없습니다. 원문은 전통 금융 시장이 비효율과 불투명한 관행, 구조적 불균형 때문에 다수 참여자에게 불리하게 작동한다고 지적합니다. 블록체인이 거래 투명성은 제공하지만 현재 구현만으로는 가치를 공평하게 나누거나 참여자의 이해관계를 맞추기 어렵다는 것입니다. 이 표준은 소유권과 가격 변동 기록을 토큰에 남기고, 판매 이익이 생길 때마다 일정 비율을 이전 소유자들에게 나누는 구조를 정의합니다. 이렇게 하면 소유자들은 판 뒤에도 자산의 성장에 이해관계가 남아 모든 소유 단계의 기여를 인정하는 협력적 거래 모델이 만들어진다고 설명합니다.
구현해야 하는 것
event FRClaimed(address indexed account, uint256 indexed amount);: 어떤 주소가 쌓인 미래 보상을 성공적으로 수령했을 때 발생하는 이벤트입니다.event FRDistributed(uint256 indexed tokenId, uint256 indexed soldPrice, uint256 indexed allocatedFR);: 토큰이 이익을 내고 팔려 미래 보상이 이전 소유자들에게 배분되었을 때 발생하는 이벤트입니다.event Listed(uint256 indexed tokenId, uint256 indexed salePrice);: 토큰이 특정 가격으로 판매 등록되었음을 알리는 이벤트입니다.event Unlisted(uint256 indexed tokenId);: 토큰의 판매 등록이 취소되었음을 알리는 이벤트입니다.event Bought(uint256 indexed tokenId, uint256 indexed salePrice);: 토큰이 해당 가격에 구매되었음을 알리는 이벤트입니다.function list(uint256 tokenId, uint256 salePrice) external;: 토큰 소유자나 승인된 주소가 토큰을 지정한 가격으로 판매 등록합니다.function unlist(uint256 tokenId) external;: 소유자 확인을 거친 뒤 해당 토큰의 판매 등록 정보를 삭제합니다.function buy(uint256 tokenId) payable external;: 보낸 금액이 등록 가격과 일치하는지 확인하고 토큰을 구매합니다. 지불 가능(payable) 함수여야 합니다.function releaseFR(address payable account) external;: 지정한 주소에 쌓여 있는 미래 보상을 끌어가기(풀 페이먼트) 방식으로 지급합니다.function retrieveFRInfo(uint256 tokenId) external returns(uint8, uint256, uint256, uint256, uint256, address[] memory);: 토큰의 FR 정보(세대 수, 이익 배분 비율, 공비, 마지막 판매 가격, 소유자 수, FR 대상 주소 목록)를 조회합니다.function retrieveAllottedFR(address account) external returns(uint256);: 특정 주소에 배정되어 아직 수령하지 않은 미래 보상 금액을 조회합니다.function retrieveListInfo(uint256 tokenId) external returns(uint256, address, bool);: 토큰의 판매 등록 정보(가격, 등록자, 등록 여부)를 조회합니다.
심층 설명
FRInfo와 ListInfo 저장 요건
컨트랙트는 토큰 ID마다 FRInfo를 구현하고 갱신해야 합니다. FRInfo는 numGenerations(세대 수, uint8), percentOfProfit(1e18 스케일의 이익 배분 비율), successiveRatio(기하수열 공비), lastSoldPrice(ETH 만티사 기준 마지막 판매 가격), ownerAmount(거쳐 간 소유자 수), addressesInFR(현재 FR 사이클에 있는 주소 배열)로 구성됩니다. 하나의 매핑에 통째로 넣거나 여러 매핑으로 나눌 수 있지만 클라이언트가 조회하고 검증할 수 있도록 public 매핑이거나 접근 함수를 제공해야 합니다. ListInfo(salePrice, lister, isListed)도 토큰 ID별 매핑에 저장하고 공개 조회 수단을 제공해야 하며 주소별 배정액을 담는 _allottedFR 매핑도 public이거나 조회 함수가 있어야 합니다.
비율은 1e18 고정소수점
allocatedFR 계산에 쓰는 비율은 1e18을 스케일 팩터로 하는 고정소수점(X/1e18)이어야 합니다. 예를 들어 5%는 5e16입니다. 표준 전체의 일관성을 위해 필수(REQUIRED)이며 최대·최소값은 1e18 - 1입니다. Rationale에서는 1e18이 100%, 1e16이 1%를 나타내는 방식이 고정소수점 연산을 다루는 여러 Solidity 라이브러리에서 흔히 쓰인다고 설명합니다.
ERC-721 함수 재정의
_mint, _transfer, _burn을 반드시 재정의해야 합니다. _mint는 nFR 전용 민트가 아닌 ERC-721 _mint 호출로도 성공하도록 기본 FR 모델을 설정하고 소유자 수를 갱신하며 수령자를 FR 사이클에 바로 추가합니다. _transfer는 FR 우회를 막기 위해 0 ETH에 판매된 것으로 간주해 상태를 갱신하고 자기 자신이나 FR 슬라이딩 윈도 안의 주소로 보내는 전송을 require로 막아야 합니다. 그렇지 않으면 자기 주소나 중복 주소로 FR 순서를 채울 수 있기 때문입니다. _burn은 소각 후 해당 토큰의 FRInfo와 ListInfo를 삭제해야 합니다.
list, unlist, buy
세 함수는 토큰 판매 기능을 제공하므로 반드시 구현해야 합니다. list는 msg.sender가 소유자이거나 승인된 주소인지 확인한 뒤 ListInfo를 갱신하고 Listed 이벤트를 내는 것이 좋습니다. unlist는 소유자 검증 후 ListInfo를 삭제합니다. buy는 payable이어야 하고 msg.value가 salePrice와 일치하는지와 토큰이 등록 상태인지 검증한 뒤 FR _transferFrom을 호출합니다. 또한 구매자가 이미 FR 슬라이딩 윈도 안에 있지 않은지 반드시 확인해야 합니다.
FR _transferFrom과 분배 로직
FR 버전 transferFrom(from, to, tokenId, soldPrice)은 저장된 lastSoldPrice와 비교해 이익 여부를 판정합니다. 이익이 없으면 lastSoldPrice 갱신, 소유자 수 증가, 세대 이동 후 msg.value 전액을 lister에게 보냅니다. 이익이 있으면 _distributeFR을 호출합니다. _distributeFR은 자기 자신에게 지급하는 것을 막기 위해 addressesInFR의 마지막 주소를 제외한 대상을 정하고 첫 판매라 대상이 없으면 0을 반환하거나 msg.value를 lister에게 보냅니다. 판매가와 lastSoldPrice의 차액에 _calculateFR을 적용해 분배하고 분배 총액(allocatedFR)과 soldPrice의 차액을 lister에게 돌려준 뒤 FRDistributed 이벤트를 냅니다. 작업이 끝나면 ListInfo를 비워야 합니다.
슬라이딩 윈도와 기하수열 계산
분배 대상은 고정 크기 슬라이딩 윈도(n)로 정합니다. 소유자를 최초 소유자부터 현재 직전 소유자까지 줄 세우고 윈도 안에 있는 이전 소유자만 분배에 참여합니다. 실제 참여 소유자 수는 n = min(m, w)로, m은 현재 소유자 수, w는 윈도 크기입니다. 실현 이익 P에 구매자 보상 비율 R과 공비 g를 적용한 기하수열로 나누며 일찍 산 소유자일수록 더 큰 몫을 받아 1세대 소유자가 가장 큰 보상을 받습니다. 손해를 보고 판 소유자는 나눌 이익이 없으므로 FR을 낼 의무가 없지만 이후 세대가 이익을 내면 분배는 계속 받습니다.
수령은 풀 페이먼트, 세대 이동은 항상
FR 지급은 OpenZeppelin PaymentSplitter처럼 받는 쪽이 직접 찾아가는 풀 페이먼트 모델을 쓰는 것이 좋습니다. releaseFR로 수령에 성공하면 FRClaimed 이벤트가 발생합니다. Rationale에 따르면 수령인이 2차 판매를 지켜보고 있지 않을 수 있으므로, 지급 이벤트를 남겨야 ERC-2981처럼 컨트랙트를 조회해 입금을 확인할 수 있습니다. _shiftGenerations는 판매 이익 여부와 무관하게 호출되어야 하며 배열 길이와 해당 토큰의 전체 세대 수를 고려해 _addressesInFR에서 가장 오래된 계정을 제거합니다.
호환성과 제안 상태
이 제안은 ERC-721, ERC-2981과 완전히 호환되며 ERC-1155에도 쉽게 적용할 수 있다고 밝힙니다. ERC-165 지원이 필요합니다. 참조 구현은 OpenZeppelin 컨트랙트와 고정소수점 연산용 PRB Math 라이브러리를 사용합니다. 이 제안은 현재 Draft(초안) 상태이므로 내용이 앞으로 바뀔 수 있습니다.
쓸 때 주의할 점
- 지급 관련 공격: 로열티와 실현 이익 보상의 수집, 분배, 지급이 추가되면서 공격 표면이 넓어집니다. 원문은 지급을 다루는 모든 함수에 재진입(reentrancy) 보호를 적용할 것을 권장합니다.
- 워시 트레이딩을 통한 FR 독점: 한 주체가 여러 지갑으로 손해를 보며 자신에게 되파는 일을 반복해 여러 세대의 소유자가 되면 이후 FR 분배를 독차지할 수 있습니다. 지갑 점수나 보유 기간 기반 인센티브로 새 지갑이나 짧은 보유에 대한 보상을 줄여 부분적으로 완화할 수 있습니다.
- 마켓플레이스 운영자의 워시 트레이딩: 운영자가 직접 또는 특정 사용자와 결탁해 워시 트레이딩을 하고 로열티와 FR을 뒤로 돌려주는 사례가 지적됩니다. 거래소는 자기 거래 방지 기능을 갖추고 온체인 거래 모니터링 서비스 접근을 제공해야 한다고 권고합니다.
- 지나치게 길거나 순환하는 세대 목록: 악의적 컨트랙트가 과도하게 길거나 순환하는 FR 세대 목록을 만들면 분배나 세대 이동 시 가스가 고갈되어 동작하지 않을 수 있습니다. 클라이언트는 상호작용할 컨트랙트의 세대 수가 적절한지 직접 확인해야 합니다.
- 로열티 우회와 비용 기준: 장외 거래로 로열티를 피하면 새 구매자의 매입 원가가 0으로 기록되어 다음 판매 때 전체 판매가가 이익으로 잡혀 FR 부담이 커집니다. 구매자가 자기 이익을 위해 우회 제안을 거부하게 되는 구조입니다.