ERC-7765 실물 자산 특권 NFT (Privileged Non-Fungible Tokens Tied To RWA)

Draft · NFT·멀티토큰 · 2024-08-20 작성

실물 자산(RWA)과 연결된 NFT에 보유자가 행사할 수 있는 특권을 붙이고 특권의 행사·조회를 표준화된 함수로 처리할 수 있게 하는 ERC-721 확장 표준입니다.

왜 필요한가

온체인에서 NFT로 판매된 상품을 현실에서 실제로 받으려면, 보유자에게 어떤 권리가 있고 그 권리를 행사했는지가 블록체인 위에서 확인되어야 합니다. 예를 들어 신발 한 켤레가 NFT로 팔렸다면 보유자는 오프체인에서 실물 신발로 교환할 권리를 행사할 수 있어야 합니다. 그런데 이런 권리를 표현하는 공통 규격이 없으면 프로젝트마다 특권을 기록하고 행사하는 방식이 제각각이 됩니다. 지갑이나 서비스는 각 컨트랙트의 고유한 방식을 일일이 알아야 하고 어떤 NFT에 어떤 특권이 남아 있는지, 이미 행사됐는지를 일관되게 보여 주기 어렵습니다. 이 표준은 특권의 행사, 행사 가능 여부와 행사 이력 조회, 특권 목록 조회를 하나의 인터페이스로 통일해 서비스, 클라이언트, UI, 컨트랙트 간 기능이 서로 맞물려 돌아갈 수 있게 합니다.

구현해야 하는 것

심층 설명

ERC-721을 그대로 상속하는 구조

이 표준은 전송과 승인 로직 전부를 ERC-721에서 변경 없이 상속합니다. 이름(name), 심벌(symbol), 메타데이터 URI 조회도 ERC-721 메타데이터 표준을 그대로 따릅니다. 호환 컨트랙트는 IERC7765 인터페이스를 반드시 구현해야 하며 이 인터페이스는 IERC721과 IERC165 위에 정의됩니다. 또한 ERC-721에서 흔히 쓰이는 선택 확장인 IERC721Metadata, IERC721Enumerable 둘 모두와 완전히 호환됩니다. 즉 기존 NFT 생태계의 전송, 조회, 열거 기능을 그대로 쓰면서 특권 관련 기능만 얹는 설계입니다.

exercisePrivilege와 PrivilegeExercised 이벤트

exercisePrivilege(_to, _tokenId, _privilegeId, _data)는 토큰의 특정 특권을 행사하는 함수입니다. _privilegeId가 유효하지 않으면 실패(throw)해야 하고 성공하면 PrivilegeExercised 이벤트를 발생시킬 것으로 기대됩니다. 이벤트에는 행사한 주소 _operator, 혜택을 받는 주소 _to, 토큰 ID, 특권 ID가 담깁니다. 이 이벤트가 온체인에 남으면 사용자가 특권 행사를 확정했다는 사실을 판별할 수 있고 이를 근거로 현실에서 해당 특권을 이행하게 됩니다. _data 필드는 추가 메시지나 향후 확장을 위한 것으로, 예를 들어 암호화폐 자산을 직접 분배하는 것처럼 온체인에서 바로 효력이 생기는 특권을 행사하는 데 쓸 수 있습니다.

특권 상태를 조회하는 세 가지 뷰 함수

isExercisable(_to, _tokenId, _privilegeId)은 특정 특권을 _to 주소에 대해 행사할 수 있는 상태인지, isExercised(_to, _tokenId, _privilegeId)는 이미 행사됐는지를 불리언으로 돌려줍니다. 두 함수 모두 유효하지 않은 _privilegeId에는 실패해야 합니다. getPrivilegeIds(_tokenId)는 토큰에 묶인 모든 특권 ID 배열을 돌려주며 NFT와 특권 ID 사이의 연결 관계를 관리하는 수단을 제공합니다. 지갑이나 서비스는 이 함수들만으로 특권의 존재, 행사 가능 여부, 행사 이력을 표준적인 방식으로 확인할 수 있습니다.

_to 주소를 따로 받는 이유

exercisePrivilege, isExercisable, isExercised 세 함수 모두 _to 주소를 매개변수로 받습니다. 이는 NFT 보유자나 트랜잭션을 보낸 사람이 아닌 다른 사람이 특권의 혜택을 받을 수 있게 하기 위한 설계입니다. 다만 이 표준은 누가 이 행사를 수행할 권한을 가지는지에 대해서는 아무것도 가정하지 않습니다. 어떤 외부 소유 계정(EOA)이나 컨트랙트 계정이 exercisePrivilege를 호출할 수 있는지는 전적으로 이 표준을 사용하는 개발자가 결정합니다.

선택 사항인 특권 메타데이터 확장

IERC7765Metadata는 선택(OPTIONAL) 확장으로, privilegeURI(_privilegeId) 함수를 통해 특권 ID별 고유한 URI를 제공합니다. 유효하지 않은 _privilegeId에는 실패해야 하며 URI는 RFC 3986에 따라 정의됩니다. 이 URI는 ERC-7765 메타데이터 JSON 스키마를 따르는 JSON 파일을 가리킬 수 있는데, 스키마에는 특권을 식별하는 name, 특권을 설명하는 description, 특권을 나타내는 자원을 가리키는 URI인 resource 세 속성이 있습니다. IERC7765Metadata를 구현하는 컨트랙트는 IERC7765도 구현해야 합니다(SHALL).

아직 초안 단계인 제안

이 제안의 상태는 Draft(초안)입니다. 내용이 앞으로 바뀔 수 있는 단계이므로, 구현하거나 참고할 때는 원문의 최신 상태를 확인하는 것이 좋습니다. 참조 구현(ERC7765Example.sol)이 원문에 링크되어 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs