ERC-6806 ERC-721 보유 시간 추적 (ERC-721 Holding Time Tracking)

Draft · NFT·멀티토큰 · 2023-03-30 작성

NFT(대체 불가능 토큰)를 현재 계정이 얼마나 오래 보유했는지 초 단위로 조회할 수 있게 ERC-721을 확장하는 표준입니다.

왜 필요한가

기존 ERC-721 표준에는 어떤 계정이 NFT를 얼마나 오래 들고 있었는지 기록하는 장치가 없습니다. 그런데 장기 보유자에게 보상을 주거나, 일정 기간 이상 보유한 사람에게만 특별 콘텐츠를 열어 주거나, 보유 기간에 따라 다른 비즈니스 로직을 적용하려는 서비스에는 이 정보가 꼭 필요합니다. 표준이 없으면 프로젝트마다 제각기 다른 방식으로 보유 시간을 기록하게 되고 외부 앱이나 컨트랙트는 각 구현마다 다른 방법으로 데이터를 읽어야 합니다. 이 제안은 보유 시간을 조회하는 공통 함수 하나를 ERC-721에 더해, 어떤 컨트랙트든 같은 방식으로 보유 시간 정보를 제공하고 읽을 수 있게 하려는 것입니다.

구현해야 하는 것

심층 설명

getHoldingInfo 함수 명세

이 표준의 인터페이스 IERC6806은 함수 하나를 정의합니다. getHoldingInfo는 tokenId(NFT의 고유 식별자)를 받아 현재 보유자의 주소(holder)와 현재 계정이 이 NFT를 보유한 시간(holdingTime)을 튜플로 반환합니다. 보유 시간의 단위는 초입니다. 원문은 초 단위를 쓰는 이유로 정밀성과 스마트 컨트랙트의 다른 시간 기반 함수와의 호환성을 듭니다.

holder를 함께 반환하는 이유

getHoldingInfo가 holdingTime만이 아니라 holder도 함께 반환하는 것은, 구현이 정한 일부 토큰 소유자를 보유 시간 계산에서 무시할 수 있게 하기 위해서입니다. 예를 들어 대출 담보로 NFT 소유권을 가져가는 컨트랙트가 있을 때, 그 대출 컨트랙트를 무시하도록 하면 실제 소유자의 보유 시간이 끊기지 않고 제대로 늘어납니다.

참조 구현의 동작 방식

참조 구현은 토큰별 보유자(_holder)와 보유 시작 시각(_holdStart), 주소별 화이트리스트(_holdingTimeWhitelist)를 저장합니다. 전송 후 호출되는 _afterTokenTransfer에서 from이나 to가 화이트리스트에 있으면 아무것도 하지 않습니다. 그렇지 않고 보유자가 바뀌면 _holder를 새 주소로, _holdStart를 현재 block.timestamp로 갱신합니다. getHoldingInfo는 block.timestamp에서 _holdStart를 뺀 값을 보유 시간으로 반환합니다. 화이트리스트 등록은 setHoldingTimeWhitelistedAddress 함수로 하며 onlyOwner 제한이 걸려 컨트랙트 소유자만 호출할 수 있습니다.

기존 ERC-721과의 호환성

이 제안은 핵심 기능에 영향을 주지 않는 새 함수를 더하는 방식이라 기존 ERC-721 표준과 완전히 하위 호환됩니다. 이미 배포된 ERC-721 구현과의 호환성을 유지하면서 새로운 사용 사례를 위한 기능을 추가하는 확장입니다.

제안 상태

이 문서는 2023년 3월 30일에 만들어진 Draft(초안) 상태의 제안입니다. 내용이 앞으로 바뀌거나 진행이 멈출 수 있으므로, 구현 전에 최신 상태를 확인하는 것이 좋습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs