ERC-7721 ERC-1155 잠금 확장 (Lockable Extension for ERC-1155)
Draft · NFT·멀티토큰 · 2023-05-25 작성
ERC-1155 토큰을 소유자 지갑에 둔 채 특정 수량만큼 잠글 수 있게 하는 확장입니다. 잠긴 동안 전송은 막히고 지정된 잠금 해제 권한자(locker)만 잠금을 풀 수 있습니다.
왜 필요한가
지금은 NFT를 대출 담보로 맡기거나 빌려주려면 토큰을 해당 서비스의 컨트랙트로 옮겨야 합니다. 이렇게 맡겨 둔 보관 계정(에스크로)으로 옮기면 세 가지 문제가 생깁니다. 첫째, 토큰이 소유자의 손을 떠나므로 디스코드 서버 입장 인증이나 게임 내 사용 같은 활용 가치가 사라집니다. 둘째, 하나의 NFT로 대출과 대여를 동시에 하는 식으로 여러 금융 도구를 조합해 쓸 수 없습니다. 셋째, 맡긴 컨트랙트에 버그나 취약점이 있으면 NFT를 도난당하거나 잃을 수 있습니다. 이 표준은 토큰을 옮기는 대신 소유자 지갑 안에서 잠그는 방식을 ERC-1155에 추가합니다. 잠금 기간에는 전송만 제한되고 나머지 속성은 그대로 유지되므로, 집을 담보로 잡힌 상태에서도 계속 거주할 수 있는 것처럼 소유자는 토큰의 활용을 이어갈 수 있습니다.
구현해야 하는 것
event Lock(uint256 indexed tokenId, address account, address _locker, uint256 amount);: 토큰이 잠길 때 발생하는 이벤트입니다.event Unlock (uint256 indexed tokenId, address account, address _locker, uint256 amount);: 토큰 잠금이 해제될 때 발생하는 이벤트입니다.function lock(uint256 tokenId, address account, uint256 amount) external;: 호출자가 소유자나 승인받은 주소일 때 토큰을 잠그고 잠금 해제 권한자를 호출자 자신으로 설정합니다.function lock(uint256 tokenId, address account, address _locker, uint256 amount) external;: 호출자가 소유자일 때 토큰을 잠그고 잠금 해제 권한자를 _locker로 설정합니다.function unlock(uint256 tokenId, address account, uint256 amount) external;: 호출자가 잠금 해제 권한자일 때 잠금을 해제합니다.function transferAndLock(address from, address to, uint256 tokenId, uint256 amount, bool setApprove) external;: 토큰을 전송하면서 받는 쪽 주소에서 바로 잠급니다. setApprove가 참이면 호출자에게 승인도 함께 부여합니다.function getLocked(uint256 tokenId, address account, address operator) external view returns (uint256);: operator가 account에서 잠근 수량을 반환합니다. 0이면 잠기지 않은 상태입니다.function setApprovalForId(uint256 tokenId, address operator, uint256 amount) external;: 특정 tokenId에 대해 operator가 쓸 수 있는 수량을 승인합니다.
심층 설명
두 가지 lock 함수와 locker 지정
lock은 두 형태가 있습니다. lock(uint256 tokenId, address account, address _locker, uint256 amount)는 소유자가 호출하며 locker를 _locker로 설정해야 합니다(MUST). lock(uint256 tokenId, address account, uint256 amount)는 소유자 또는 승인받은 주소가 호출하며 locker를 msg.sender로 설정해야 합니다. lock은 account의 잔액이 부족하거나 호출자가 tokenId의 소유자도 승인받은 주소도 아니면 되돌려야 합니다(revert). 토큰이 전송되면 이 권한들은 소멸합니다.
수량 단위 잠금과 전송 제한
ERC-1155는 하나의 tokenId에 여러 개의 토큰이 있을 수 있으므로 잠금도 수량(amount) 단위로 동작합니다. getLocked(uint256 tokenId, address account, address operator)는 operator가 account에서 잠근 수량을 반환해야 하고 잠기지 않은 토큰에 대해서는 0을 반환해야 합니다. ERC-1155의 safeTransferFrom은 잠긴 수량을 전송하려 하면 되돌려야 하며 전송 가능한 최대 수량은 balance - getLocked여야 합니다. unlock(uint256 tokenId, address account, uint256 amount)는 해당 수량이 잠겨 있지 않으면 되돌려야 합니다.
tokenId 단위 승인
소유자는 setApprovalForId(uint256 tokenId, address operator, uint256 amount)로 특정 tokenId에 대해서만 operator에게 수량 한도를 승인할 수 있습니다. 이렇게 하면 승인받은 tokenId만 operator가 쓸 수 있습니다. getApprovalForId(uint256 tokenId, address account, address operator)는 승인된 수량을 반환합니다. 승인받은 주소는 토큰 승인을 보유한 상태에서 자산을 잠글 수 있고 이때 locker는 자신이 됩니다.
transferAndLock과 전송 후 회수
transferAndLock(address from, address to, uint256 tokenId, uint256 amount, bool setApprove)는 토큰을 전송하면서 받는 쪽 주소에서 잠급니다. setApprove가 true면 locker에게 승인이 함께 부여되어 locker가 나중에 토큰을 회수(revoke)할 수 있습니다. 회수 조건은 컨트랙트에서 정의하고 그 컨트랙트에 승인을 주는 방식입니다. 이렇게 하면 받는 사람에게 전송 권한 없는 조건부 소유권을 줄 수 있어 전송 후 회수가 필요한 분할 결제(BNPL) 같은 용도에 권장됩니다.
다른 잠금 제안과의 차이
이 제안은 lock과 unlock의 최소 구현만 정의합니다. 시간 제한 잠금 같은 조건은 토큰 컨트랙트에 넣지 않아도 별도 스마트 컨트랙트로 구현할 수 있다고 보고 상환이나 만료 등 어떤 조건으로든 잠금과 해제를 걸 수 있게 열어 둡니다. 또 locker와 승인받은 주소의 권리를 분리합니다. 승인과 함께 잠그면 승인받은 쪽이 해제와 인출까지 할 수 있어 대여, 대출, 분할 결제에 쓸 수 있고 회수 권한 없이 잠그면 해제만 가능해 계정 귀속(account-bound) 토큰에 쓸 수 있습니다.
ERC-1155 호환성
이 표준은 ERC-1155와 호환되며 ERC-165와 ERC-1155를 필요로 합니다. 기존의 업그레이드 가능한 ERC-1155 컨트랙트는 이 표준으로 업그레이드해 잠금 기능을 내장하고 유동성 기능을 열 수 있습니다. 인터페이스 IERCLockable1155는 IERC1155를 상속합니다.
제안 상태
이 제안은 현재 Draft(초안) 상태입니다. 내용이 앞으로 바뀔 수 있는 단계이므로 구현 전에 최신 원문을 확인하는 것이 좋습니다.
쓸 때 주의할 점
- 잠긴 수량은 전송 불가: 일정 수량이 잠기면 그 수량은 잠긴 계정에서 전송할 수 없습니다. 이를 다루는 컨트랙트는 전송 가능 수량을 따로 계산해야 합니다.
- locker와 승인을 모두 가진 경우: 토큰이 잠긴 상태에서 호출자가 locker이면서 승인받은 주소이기도 하면, 그 호출자는 토큰을 전송할 수 있습니다.
- 영구 잠금 위험: 접근할 수 없는 계정이나 검증되지 않은 컨트랙트 주소를 locker로 지정해 잠그면 토큰이 영구히 잠길 수 있습니다.