ERC-7695 ERC-721 소유권 위임과 컨텍스트 (Ownership Delegation and Context for ERC-721)
Draft · NFT·멀티토큰 · 2024-04-02 작성
NFT를 다른 곳으로 전송하지 않고도 용도별 컨텍스트에 연결해 빌려주거나 잠글 수 있게 하고 소유권 행사 권한만 정해진 기간 다른 계정에 위임할 수 있게 하는 ERC-721 확장 표준입니다.
왜 필요한가
기존 ERC-721에는 소유자(Owner)라는 역할 하나만 있습니다. 그래서 NFT를 스테이킹하거나 담보로 맡기거나 빌려주려면 토큰 자체를 해당 컨트랙트로 전송해 잠가야 합니다. 그런데 많은 앱이 지갑에 토큰이 있다는 사실을 보유 증명으로 삼아 에어드랍이나 등급별 보상 같은 혜택을 줍니다. 토큰이 컨트랙트에 잠겨 있으면 원래 주인은 이런 혜택을 받지 못하고 보상 시스템이 가능한 한 많은 잠금 컨트랙트를 일일이 지원해 주어야만 구제가 됩니다. 또 대여나 위임처럼 소유자는 그대로 두고 쓰는 사람만 바꾸는 용도를 표준 차원에서 표현할 방법이 없어 ERC-721 위에 이런 서비스를 만드는 일이 늘 어려웠습니다. 이 표준은 용도를 컨텍스트(Context)로 나누어 컨트롤러가 다루게 하고 소유자와 소유권 행사 권한을 분리하는 소유권 위임을 표준에 넣어 이 문제를 풀려고 합니다.
구현해야 하는 것
event ContextUpdated(bytes32 indexed ctxHash, address indexed controller, uint64 detachingDuration);: 컨텍스트가 생성되거나 컨트롤러, 분리 대기 시간이 바뀔 때 발생합니다.event ContextAttached(bytes32 indexed ctxHash, uint256 indexed tokenId);: 토큰이 컨텍스트에 연결될 때 발생합니다.event ContextDetachmentRequested(bytes32 indexed ctxHash, uint256 indexed tokenId);: 토큰의 컨텍스트 분리가 요청될 때 발생합니다.event ContextDetached(bytes32 indexed ctxHash, uint256 indexed tokenId);: 토큰이 컨텍스트에서 분리될 때 발생합니다.event ContextUserAssigned(bytes32 indexed ctxHash, uint256 indexed tokenId, address indexed user);: 컨텍스트에서 토큰을 쓸 사용자가 지정될 때 발생합니다.event ContextLockUpdated(bytes32 indexed ctxHash, uint256 indexed tokenId, bool locked);: 컨텍스트 안에서 토큰이 잠기거나 풀릴 때 발생합니다.event OwnershipDelegationStarted(uint256 indexed tokenId, address indexed delegatee, uint64 until);: 소유권 위임이 시작(제안)될 때 발생합니다.event OwnershipDelegationAccepted(uint256 indexed tokenId, address indexed delegatee, uint64 until);: 수임자가 소유권 위임을 수락할 때 발생합니다.event OwnershipDelegationStopped(uint256 indexed tokenId, address indexed delegatee);: 소유권 위임이 만료 전에 중단될 때 발생합니다.function maxDetachingDuration() external view returns (uint64);: 컨텍스트 분리에 걸릴 수 있는 최대 대기 시간을 조회합니다.function getContext(bytes32 ctxHash) external view returns (address controller, uint64 detachingDuration);: 컨텍스트의 컨트롤러 주소와 분리 대기 시간을 조회합니다. 없는 컨텍스트면 되돌립니다.function createContext(address controller, uint64 detachingDuration, bytes calldata ctxMsg) external returns (bytes32 ctxHash);: 새 컨텍스트를 만들고 해시를 돌려줍니다. 컨트롤러가 0 주소이거나 대기 시간이 최대값을 넘으면 되돌립니다.function updateContext(bytes32 ctxHash, address newController, uint64 newDetachingDuration) external;: 기존 컨텍스트의 컨트롤러와 분리 대기 시간을 바꿉니다. 현재 컨트롤러만 호출할 수 있습니다.function isAttachedWithContext(bytes32 ctxHash, uint256 tokenId) external view returns (bool);: 토큰이 해당 컨텍스트에 연결되어 있는지 조회합니다.function attachContext(bytes32 ctxHash, uint256 tokenId, bytes calldata data) external;: 토큰을 컨텍스트에 연결합니다. 컨트롤러가 컨트랙트면 onAttached 콜백이 호출되고 실패 시 연결이 거부됩니다.function requestDetachContext(bytes32 ctxHash, uint256 tokenId, bytes calldata data) external;: 컨텍스트 분리를 요청합니다. 잠기지 않은 토큰은 즉시 분리되고 잠긴 토큰은 요청 상태가 됩니다.function execDetachContext(bytes32 ctxHash, uint256 tokenId, bytes calldata data) external;: 분리 요청 후 대기 시간이 지난 토큰의 분리를 실행합니다.function getContextUser(bytes32 ctxHash, uint256 tokenId) external view returns (address user);: 해당 컨텍스트에서 토큰을 쓰도록 지정된 사용자를 조회합니다.function setContextUser(bytes32 ctxHash, uint256 tokenId, address user) external;: 컨텍스트 사용자를 지정합니다. 컨트롤러만 호출할 수 있고 토큰이 그 컨텍스트에 연결되어 있어야 합니다.function isTokenContextLocked(bytes32 ctxHash, uint256 tokenId) external view returns (bool);: 토큰이 해당 컨텍스트에서 잠겨 있는지 조회합니다.function setContextLock(bytes32 ctxHash, uint256 tokenId, bool lock) external;: 컨텍스트 안에서 토큰을 잠그거나 풉니다. 컨트롤러만 호출할 수 있습니다.function getOwnershipManager(uint256 tokenId) external view returns(address manager);: 현재 소유권 행사 권한을 가진 계정(위임이 없으면 소유자, 있으면 수임자)을 조회합니다.function getOwnershipDelegatee(uint256 tokenId) external view returns (address delegatee, uint64 until);: 현재 유효한 소유권 수임자와 만료 시각을 조회합니다. 위임이 없거나 만료되었으면 되돌립니다.function pendingOwnershipDelegatee(uint256 tokenId) external view returns (address delegatee, uint64 until);: 아직 수락되지 않은 대기 중 수임자와 만료 시각을 조회합니다.function startDelegateOwnership(uint256 tokenId, address delegatee, uint64 until) external;: 지정 시각까지 소유권을 위임하는 절차를 시작합니다. 대기 중인 이전 제안이 있으면 대체합니다.function acceptOwnershipDelegation(uint256 tokenId) external;: 수임자가 위임 제안을 수락합니다. 수락하면 만료 시각까지 수임자가 소유권 관리자가 됩니다.function stopOwnershipDelegation(uint256 tokenId) external;: 수임자가 만료 전에 위임을 중단하고 소유권 행사 권한을 소유자에게 돌려줍니다.function getContext(uint256 index) external view returns(bytes32 ctxHash);: 선택 확장(열거)에서 index 위치의 컨텍스트 해시를 돌려줍니다.function getContextCount() external view returns(uint256);: 컨트랙트에 만들어진 컨텍스트 수를 돌려줍니다.function getAttachedContext(uint256 tokenId, uint256 index) external view returns(bytes32 ctxHash);: 토큰에 연결된 컨텍스트 중 index 위치의 해시를 돌려줍니다.function getAttachedContextCount(uint256 tokenId) external view returns(uint256);: 토큰에 연결된 컨텍스트 수를 돌려줍니다.function onAttached(bytes32 ctxHash, uint256 tokenId, address operator, bytes calldata data) external;: 토큰이 컨텍스트에 연결될 때 컨트롤러 쪽에서 호출되는 콜백입니다. 되돌리면 연결이 거부됩니다.function onDetachRequested(bytes32 ctxHash, uint256 tokenId, address operator, bytes calldata data) external;: 분리가 요청될 때 호출되는 콜백입니다. 결과는 무시되므로 분리를 막을 수 없습니다.function onExecDetachContext(bytes32 ctxHash, uint256 tokenId, address user, address operator, bytes calldata data) external;: 분리가 실행될 때 호출되는 콜백입니다. 결과는 무시되므로 분리를 막을 수 없습니다.
심층 설명
컨텍스트와 역할 구조
컨텍스트는 토큰의 특정 용도를 나타내는 단위이고, 토큰과 컨텍스트의 조합마다 컨트롤러 1명과 사용자 1명이 있습니다. 컨트롤러는 컨트롤러 이전, 사용자 지정, 토큰 잠금과 해제를 할 수 있고 사용자는 그 컨텍스트 안에서 토큰을 쓸 권한을 가집니다. 소유권 권리(Ownership Rights)는 토큰 전송, 컨텍스트 연결, 컨텍스트 분리 세 가지로 정의됩니다. 소유권 관리자(Ownership Manager)는 소유권 권리를 실제로 행사하는 주체로, 위임이 없으면 소유자를, 위임 중이면 수임자를 가리킵니다. 토큰 하나에 소유자와 수임자, 소유권 관리자는 각각 1명이고 컨텍스트 역할은 n개까지 붙을 수 있습니다.
2단계 소유권 위임
startDelegateOwnership은 소유자나 그 운영자(operator), 승인 주소가 호출하며 이미 수락된 위임이 있으면 안 되고 만료 시각은 미래여야 하며 수임자가 소유자 본인이나 0 주소면 되돌립니다. 대기 중인 이전 제안은 대체됩니다. 효력은 수임자(또는 그 운영자)가 acceptOwnershipDelegation을 호출해야 생기고 그때부터 만료까지 수임자가 소유권 관리자로 기록됩니다. stopOwnershipDelegation은 수락된 위임에 대해 수임자 쪽만 호출할 수 있고 성공하면 소유자가 다시 소유권 관리자가 됩니다. approve나 setApprovalForAll이 소유자 지위를 유지한 채 권한만 추가하는 것과 달리, 위임은 소유자의 권리 자체를 수임자에게 넘기고 만료되면 자동으로 되돌립니다. 소유자가 권리를 계속 쥔 채 담보를 받고 토큰을 딴 계정으로 빼돌리는 식의 악용을 막기 위한 설계이고 2단계(제안과 수락) 절차는 수임자 지정 실수를 막기 위한 것입니다.
잠금과 분리 규칙
setContextLock은 컨트롤러만 호출할 수 있고 분리 요청이 이미 들어온 토큰에는 호출할 수 없습니다. 분리는 두 갈래입니다. 잠기지 않은 토큰이나 컨트롤러 본인이 요청하는 경우는 requestDetachContext 한 번으로 즉시 분리되어 ContextDetached가 발생합니다. 잠긴 토큰은 요청 시 ContextDetachRequested가 발생하고 분리 대기 시간(detachingDuration)이 지난 뒤 execDetachContext를 호출해야 분리됩니다. 두 함수 모두 호출 자격은 소유권 관리자와 그 운영자, 그리고 위임 중이 아닐 때의 승인 주소입니다. 분리 과정의 onDetachRequested와 onExecDetachContext 콜백은 호출하되 결과를 무시하도록 정해져 있어 컨트롤러가 분리를 막을 수 없습니다. 반대로 연결 시의 onAttached는 실패하면 전체가 되돌려져 컨트롤러가 원치 않는 연결을 거부할 수 있습니다. 컨트롤러가 통제력을 잃어도 소유자가 스스로 토큰을 풀 수 있게 하려는 설계입니다.
전송 시 자동 정리
전송은 소유권 관리자나 그 운영자, 위임 중이 아닐 때의 승인 주소만 할 수 있습니다. 전송이 일어나면 진행 중인 소유권 위임은 반드시 해제되고 연결된 모든 컨텍스트가 분리됩니다. 잠긴 컨텍스트가 있으면 먼저 분리 요청을 하고 대기 시간이 지난 상태여야 전송할 수 있습니다. 분리 시 컨트롤러가 컨트랙트면 onExecDetachContext를 빈 data 인자로 호출하되 결과는 무시합니다. 가스 효율을 위해 이 과정에서 OwnershipDelegationStopped와 ContextDetached 이벤트는 의도적으로 발생시키지 않습니다.
ERC-165 식별자와 선택 확장
이 표준을 구현하는 컨트랙트는 IERC7695의 모든 함수를 구현해야 하고 supportsInterface에 0x486b6fba가 들어오면 true를 돌려줘야 합니다. 컨텍스트 목록을 조회할 수 있게 하는 열거(Enumerable) 확장은 선택 사항이며 식별자는 0xcebf44b7입니다. 컨트롤러는 컨트랙트로 두고 연결과 분리 요청을 받는 콜백(IERC7695ContextCallback)을 구현하는 것이 권장되며 이 인터페이스의 식별자는 0xad0491f1입니다.
Draft 상태의 제안
이 제안은 2024년 4월에 만들어진 Draft(초안) 상태입니다. 아직 확정된 표준이 아니므로 인터페이스와 규칙이 앞으로 바뀔 수 있고 구현 전에 최신 원문을 확인해야 합니다.
쓸 때 주의할 점
- 분리 대기 시간 설정: 배포자는 maxDetachingDuration으로 분리 지연의 상한을 적절히 정하고 컨텍스트를 만드는 쪽은 그 상한을 넘지 않는 기간을 용도에 맞게 정해야 합니다. 소유자가 짧은 시간에 매물 등록을 남발하고 토큰을 다른 소유자에게 넘겨 버리는 식의 악용을 막기 위한 장치입니다.
- 토큰 중복 사용: 새 컨텍스트를 만들 때 컨트롤러는 같은 NFT 컨트랙트의 다른 컨텍스트들을 추적해야 합니다. 예를 들어 한 게임이 대여용 컨텍스트로 토큰을 잠근 상태에서 위임용 컨텍스트를 따로 만들면, 용도는 다르지만 같은 게임 안에서 토큰이 중복 사용될 수 있습니다. 대여와 위임을 묶은 공유 컨텍스트를 쓰거나 새 컨텍스트에 재사용 제한을 두는 방법을 고려해야 합니다.
- 위임 요청 시 버퍼 시간: 소유권 위임에 의존하는 시스템은 위임을 요청할 때 최소 maxDetachingDuration초 이상의 버퍼 시간을 더해야 합니다. 예를 들어 최대 분리 대기 시간이 7일인데 필요한 위임 기간이 3일뿐인 담보 컨트랙트라면, 버퍼가 없을 때 소유자가 자금을 빼낸 뒤 다른 컨텍스트로 토큰을 잠가 해제와 전송을 막는 식으로 악용할 수 있습니다.
- 콜백 호출자 검증: IERC7695ContextCallback을 구현할 때는 콜백의 msg.sender가 기대한 컨트랙트 주소(보통 토큰 컨트랙트나 지정된 컨트롤러 컨트랙트)인지 반드시 검증해야 합니다. 정상 컨트랙트로 위장한 악의적 주체의 무단 동작을 막기 위해 필요합니다.
- 피싱과 소유권 상실 위험: 소유자가 속아서 startDelegateOwnership으로 악의적 계정을 수임자로 지정하면 그 계정이 토큰 전송까지 할 수 있습니다. 이 위험은 approve나 setApprovalForAll과 같은 수준으로 봐야 합니다. 또 담보 같은 컨트랙트에 위임할 때는 위임 기간이 지나치게 길지 않은지, 조건 충족 시 위임을 해제하는 조항이 있는지 확인해야 하며 컨트랙트 소유자나 그 운영자가 탈취되면 토큰 소유권이 바뀔 수 있다는 점도 알아야 합니다.