ERC-5604 NFT 유치권 표준 (NFT Lien)
Draft · NFT·멀티토큰 · 2022-09-05 작성
ERC-721 NFT에 유치권(lien)을 설정하고 해제하며 조회할 수 있는 공통 인터페이스를 정합니다. 채무 회수나 의무 이행을 담보하기 위한 권리를 NFT 위에 기록할 수 있게 합니다.
왜 필요한가
유치권은 자동차나 부동산처럼 금융에서 널리 쓰이는 장치입니다. 어떤 재산에 대해 빚을 갚거나 의무를 이행할 때까지 다른 사람이 권리를 걸어 두는 방식입니다. NFT가 부동산 권리증서(deed) 같은 자산을 나타내게 되면 NFT에도 같은 장치가 필요해집니다. 그런데 공통 표준이 없으면 서비스마다 유치권을 제각각의 방식으로 기록하게 되고 어떤 NFT에 누가 권리를 걸어 두었는지 다른 앱이나 지갑이 일관되게 확인할 방법이 없습니다. 이 표준은 유치권을 거는 함수, 해제하는 함수, 조회하는 함수와 이벤트를 하나의 인터페이스로 정해 누구나 같은 방식으로 유치권 보유 관계를 구현하고 읽을 수 있게 합니다.
구현해야 하는 것
event OnLienPlaced(uint256 tokenId, address holder, bytes calldata extraParams);: 새 유치권이 성공적으로 설정되었을 때 반드시 발생해야 하는 이벤트입니다. 대상 토큰, 유치권 보유자, 원래 요청의 extraParams를 담습니다.event OnLienRemoved(uint256 tokenId, address holder, bytes calldata extraParams);: 기존 유치권이 성공적으로 해제되었을 때 반드시 발생해야 하는 이벤트입니다. 대상 토큰, 유치권 보유자, 원래 요청의 extraParams를 담습니다.function addLienHolder(uint256 tokenId, address holder, bytes calldata extraParams) public;: 토큰에 유치권을 설정하는 함수입니다. 같은 보유자가 같은 토큰에 이미 유치권을 갖고 있으면 오류를 던져야 합니다.function removeLienHolder(uint256 tokenId, address holder, bytes calldata extraParams) public;: 토큰에 걸린 유치권을 해제하는 함수입니다. 조건을 어기면 오류를 던져야 합니다.function hasLien(uint256 tokenId, address holder, bytes calldata extraParams) public view returns (bool);: 특정 보유자가 해당 토큰에 활성 유치권을 갖고 있는지 조회하는 함수입니다.
심층 설명
준수 조건: ERC-721과 ERC-165 구현
준수 컨트랙트는 ERC-721과 ERC-165를 반드시(MUST) 구현해야 하고 위의 IERC_LIEN 인터페이스도 반드시 구현해야 합니다. 이 표준은 ERC-721의 확장으로 설계되었기 때문에 준수 컨트랙트는 ERC-721을 완전히 따라야 합니다. 즉 기존 NFT의 소유와 전송 기능은 그대로 둔 채 유치권 관련 함수와 이벤트를 덧붙이는 구조입니다. 명세의 MUST, SHOULD 같은 핵심 단어는 RFC 2119에 따라 해석합니다.
addLienHolder: 유치권 설정
tokenId가 가리키는 토큰에 holder 주소를 유치권 보유자로 추가합니다. 같은 보유자가 같은 토큰에 이미 유치권을 갖고 있으면 반드시 오류를 던져야 합니다. extraParams는 향후 확장을 위한 추가 데이터입니다. 설정이 성공하면 OnLienPlaced 이벤트가 반드시 발생해야 하며 이벤트에는 tokenId, holder, 그리고 원래 요청의 extraParams가 담깁니다.
removeLienHolder: 유치권 해제
tokenId가 가리키는 토큰에서 holder의 유치권을 해제합니다. 해제가 성공하면 OnLienRemoved 이벤트가 반드시 발생해야 합니다. 원문 주석은 이 함수에 대해 "보유자가 이미 유치권을 갖고 있으면(already has a lien) 오류를 던져야 한다"고 적고 있습니다. 설정 함수와 조건 서술이 같은 형태여서 의미가 분명하지 않은 부분이며 이 제안이 Draft 단계라는 점과 함께 읽을 필요가 있습니다.
hasLien: 유치권 조회
특정 holder가 해당 토큰에 활성(active) 유치권을 갖고 있는지 bool로 돌려주는 view 함수입니다. tokenId가 존재하지 않거나 소유되지 않은(not owned) 토큰이면 반드시 오류를 던져야 합니다. 조회 함수에도 extraParams가 있어 향후 확장에 쓸 수 있습니다.
설계 선택: ERC-721만 지원하고 함수를 분리한 이유
단순성과 가스 효율을 위해 ERC-721 NFT만 지원합니다. ERC-20이나 ERC-1155 같은 다른 표준은 고려하지 않았고 향후 확장으로 남겨 두었습니다. 또 changeLienholder 하나로 합치는 대신 addLienHolder와 removeLienHolder를 분리했는데, 추가와 해제는 성격이 크게 다르고 보통 서로 다른 접근 제어(Access Control)가 필요하다고 보았기 때문입니다. 예를 들어 토큰 보유자는 다른 사람을 유치권 보유자로 추가할 수 있어야 한다는 점을 듭니다.
이 표준이 다루지 않는 것
부채 금액(amount of debt)은 이 인터페이스에서 규정하지 않습니다. 그 자체로 충분히 복잡해 별도 ERC로 다룰 가치가 있다고 보았기 때문입니다. 유치권 보유자가 토큰의 전송이나 교환을 승인한다는 신호를 보내는 방법(endorsement)도 같은 이유로 규정하지 않았습니다. 보안 고려 사항 절은 "논의 필요(Needs discussion)"로만 적혀 있어 아직 구체적인 주의점이 정리되지 않았습니다.
제안 상태: Draft
이 제안은 2022년 9월 5일에 만들어졌고 현재 상태가 Draft입니다. 아직 확정되지 않아 인터페이스와 규칙이 바뀔 수 있는 단계입니다.