ERC-5173 NFT 미래 보상(nFR) (NFT Future Rewards (nFR))

Draft · NFT·멀티토큰 · 2022-05-08 작성

NFT를 판 뒤에도 그 NFT의 값이 오르면 이전 소유자들이 실현 이익의 일부를 나눠 받을 수 있게 하는 ERC-721 확장 표준입니다.

왜 필요한가

지금의 NFT 표준(ERC-721)에서는 NFT를 팔고 나면 그 자산과의 관계가 완전히 끊어집니다. 이후 가격이 아무리 올라도 이전 소유자에게 돌아오는 몫은 없습니다. 원문은 전통 금융 시장이 비효율과 불투명한 관행, 구조적 불균형 때문에 다수 참여자에게 불리하게 작동한다고 지적합니다. 블록체인이 거래 투명성은 제공하지만 현재 구현만으로는 가치를 공평하게 나누거나 참여자의 이해관계를 맞추기 어렵다는 것입니다. 이 표준은 소유권과 가격 변동 기록을 토큰에 남기고, 판매 이익이 생길 때마다 일정 비율을 이전 소유자들에게 나누는 구조를 정의합니다. 이렇게 하면 소유자들은 판 뒤에도 자산의 성장에 이해관계가 남아 모든 소유 단계의 기여를 인정하는 협력적 거래 모델이 만들어진다고 설명합니다.

구현해야 하는 것

심층 설명

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(초안) 상태이므로 내용이 앞으로 바뀔 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs