ERC-7303 토큰으로 제어하는 토큰 유통(TCTC) (Token-Controlled Token Circulation)
Draft · 서명·인증 · 2023-07-09 작성
민트나 소각 같은 특권을 ERC-721이나 ERC-1155 토큰(컨트롤 토큰)으로 표현해, 그 토큰을 발행하고 태우는 것만으로 역할을 주고 뺏을 수 있게 하는 접근 제어 표준입니다.
왜 필요한가
컨트랙트에서 토큰을 새로 찍거나 없애는 특권 동작은 흔히 역할 기반 접근 제어(ERC-5982)로 관리합니다. 그런데 이 방식은 역할을 주거나 뺏을 때 체인 밖 관리 도구의 화면을 거쳐야 합니다. 또 대부분의 지갑에는 역할로 받은 권한을 보여 주는 화면이 없어서 사용자는 자기에게 어떤 권한이 있는지 지갑만으로 알기 어렵습니다. 권한 구조가 컨트랙트 안에만 숨어 있으면 문제가 더 커집니다. 권한을 위임받아 움직이는 자율 에이전트나 외부 도구는 권한 구조를 설계한 당사자가 아니므로, 어떤 역할에 어떤 자격이 필요한지 기계적으로 알아낼 방법이 없습니다. 이 표준은 권한 자체를 지갑에 보이는 토큰으로 만들고 역할 구조를 조회할 수 있는 인터페이스를 컨트랙트에 두어 이런 문제를 풉니다.
구현해야 하는 것
event ERC721ControlTokenAdded(bytes32 indexed role, address indexed contractId);: 역할에 ERC-721 컨트롤 토큰이 연결될 때 발생하는 이벤트입니다.event ERC1155ControlTokenAdded(bytes32 indexed role, address indexed contractId, uint256 indexed typeId);: 역할에 ERC-1155 컨트롤 토큰이 연결될 때 발생하는 이벤트입니다.function hasRole(bytes32 role, address account) external view returns (bool);: 이 표준의 잔액 검사 방식에 따라 계정이 지금 해당 역할을 갖고 있는지 돌려줍니다.function getERC721ControlTokens(bytes32 role) external view returns (address[] memory contractIds);: 역할에 연결된 ERC-721 컨트롤 토큰 컨트랙트 주소 목록을 돌려줍니다.function getERC1155ControlTokens(bytes32 role) external view returns (address[] memory contractIds, uint256[] memory typeIds);: 역할에 연결된 ERC-1155 컨트롤 토큰의 컨트랙트 주소와 typeId 목록을 돌려줍니다.
심층 설명
권한을 컨트롤 토큰으로 표현합니다
이 표준을 구현하는 컨트랙트는 역할에 필요한 권한을 ERC-721 또는 ERC-1155 토큰으로 표현해야 합니다(MUST). 이 토큰을 컨트롤 토큰이라고 부릅니다. 역할과 컨트롤 토큰을 연결할 때는 미리 배포된 컨트롤 토큰 컨트랙트의 주소를 사용해야 합니다. 컨트롤 토큰은 어떤 종류의 토큰이어도 되고 그 토큰의 거래 자체를 또 다른 컨트롤 토큰으로 재귀적으로 제어할 수도 있습니다. 원문이 드는 활용 예는 티켓·쿠폰·멤버십 토큰의 민트·소각 권한, 특정 기관에만 허용하는 전송 권한, 오배송을 막는 주소 확인 증명, 자율 에이전트에 대한 권한 위임입니다.
역할 확인은 balanceOf, 역할 이름은 keccak256입니다
계정이 역할을 갖고 있는지는 ERC-721 또는 ERC-1155에 정의된 balanceOf 값이 0을 넘는지로 확인하는 것이 권장됩니다(SHOULD). ERC-1155 토큰을 쓸 때는 balanceOf에 typeId를 함께 지정해야 합니다. 역할은 bytes32 형식으로 표현하며 역할 이름 문자열의 keccak256 해시로 계산하는 것이 권장됩니다. 예를 들어 bytes32 role = keccak256("MINTER") 형식입니다.
부여는 민트, 회수는 소각입니다
역할을 주려면 권한을 나타내는 컨트롤 토큰을 ERC-5679에 정의된 safeMint 메서드로 해당 계정에 민트하는 것이 권장됩니다(SHOULD). 역할을 뺏으려면 같은 표준의 burn 메서드로 그 토큰을 소각합니다. 대상 컨트랙트에 별도의 권한 관리 함수를 두는 대신, 따로 배포된 컨트롤 토큰 컨트랙트에서 토큰을 발행하고 태우는 행위 자체가 권한 관리가 됩니다. 에이전트 활용 사례에서는 소각이 체인 밖 권한 서버 없이 작동하는 온체인 중단 장치가 되고 에이전트의 권한은 balanceOf로 누구나 검증할 수 있습니다.
IERC7303 인터페이스로 역할 구조를 공개해야 합니다
규격을 따르는 컨트랙트는 IERC7303 인터페이스를 구현해 역할과 컨트롤 토큰의 연결을 제3자와 도구가 온체인에서 조회할 수 있게 해야 합니다(MUST). hasRole은 역할 보유 여부를, getERC721ControlTokens와 getERC1155ControlTokens는 역할에 연결된 컨트롤 토큰 목록을 돌려줍니다. 역할에 컨트롤 토큰이 연결될 때는 ERC721ControlTokenAdded 또는 ERC1155ControlTokenAdded 이벤트를 반드시 발생시켜 인덱서가 역할 구조를 추적할 수 있게 합니다. 또 ERC-165를 구현하고 IERC7303 인터페이스 식별자에 true를 반환해야 합니다. 테스트 케이스 절에 따르면 이 식별자는 세 함수 셀렉터의 XOR인 0x4ee69337입니다.
인터페이스 설계의 이유
초기 버전은 인터페이스를 일부러 정의하지 않았습니다. 역할을 설정한 쪽이 그 구조를 이미 안다고 가정했기 때문입니다. 그러나 위임받은 권한으로 움직이는 자율 에이전트는 자신이 따르는 권한 구조의 설계자가 아니므로, 컨트랙트가 스스로 역할 구조를 기계가 읽을 수 있게 설명해야 한다는 이유로 IERC7303이 추가됐습니다. hasRole(bytes32, address) 시그니처는 OpenZeppelin AccessControl 같은 널리 배포된 구현의 같은 이름 함수와 일부러 일치시켜, 호출자가 답이 내부 매핑에서 오는지 토큰 잔액에서 오는지 몰라도 조회할 수 있게 했습니다. 반면 grantRole과 revokeRole은 의도적으로 뺐습니다. 부여와 회수는 별도로 배포된 컨트롤 토큰 컨트랙트에서 이뤄지는 민트·소각이라 대상 컨트랙트가 가져서는 안 되는 권한이기 때문입니다. 열거 함수를 표준별로 나눈 것은 ERC-721 항목에 typeId가 없어서, 어떤 대체 값을 써도 정당한 ERC-1155 typeId와 구분되지 않기 때문입니다.
참조 구현의 동작
참조 구현은 onlyHasToken(role, account) 수정자를 제공합니다. 내부 함수 _checkHasToken이 역할에 등록된 ERC-721 목록과 ERC-1155 목록을 차례로 돌며 balanceOf가 0보다 큰 항목이 하나라도 있으면 통과시킵니다. 역할과 컨트롤 토큰의 연결은 내부 함수 _grantRoleByERC721과 _grantRoleByERC1155로 하며 등록 전에 해당 주소가 ERC-165로 IERC721 또는 IERC1155 인터페이스를 지원하는지 require로 확인하고 이벤트를 발생시킵니다. 같은 역할에 여러 번 호출하면 등록된 토큰 중 하나만 가져도 되는 OR 조건이 됩니다. 예제 MyToken은 MINTER_ROLE과 BURNER_ROLE을 keccak256으로 정의하고 safeMint와 burn 함수에 수정자를 붙입니다.
왜 ERC-721·1155이고, 전송 가능 여부는 선택입니다
컨트롤 토큰을 ERC-721이나 ERC-1155로 정한 것은 지갑 안에서 권한이 보이게 해 사용자의 권한 관리를 쉽게 하려는 선택입니다. 권한을 토큰으로 만들 때는 보통 소울바운드 토큰(예: ERC-5192) 같은 규격을 쓰는데, ERC-5192가 ERC-721을 상속하므로 이 표준도 ERC-721을 요건으로 삼았습니다. 컨트롤 토큰을 전송 가능하게 만들면 조직에서 담당자가 교체되거나 휴가일 때 다른 구성원에게 권한을 넘기는 위임이 가능합니다. 전송 가능 여부는 응용의 필요에 따라 정합니다.
호환성과 제안 상태
이 표준은 ERC-721, ERC-1155, ERC-5679와 각각 호환되도록 설계됐습니다. 다만 이 제안은 현재 Draft 상태입니다. 아직 검토 중이라 명세와 인터페이스가 앞으로 바뀔 수 있으므로, 구현하려면 최신 원문을 확인해야 합니다.
쓸 때 주의할 점
- 컨트롤 토큰의 보안이 전체를 좌우합니다: 유통되는 토큰의 보안은 컨트롤 토큰의 보안에 크게 의존합니다. 컨트롤 토큰의 관리 권한, 민트·전송·소각 권한, 컨트랙트 업데이트 가능성에 관한 설정을 신중히 검토해야 합니다.
- 컨트롤 토큰은 원칙적으로 전송 불가로 둡니다: 전송 가능하게 하면 관리 권한의 임시 위임 같은 유연한 운영이 가능하지만 토큰 유통 권한이 부적절한 제3자에게 넘어갈 수 있습니다. 일반적으로 전송 불가로 만들고, 전송 가능하게 한다면 최소한 소각 권한은 신뢰할 수 있는 관리자가 보유해야 합니다.
- 에이전트에게 줄 때는 발행자가 소각할 수 있어야 합니다: 자율 에이전트에게 주는 컨트롤 토큰은 전송 불가여야 하고(SHOULD), 보유자의 협조 없이 발행자나 위임자의 다른 계정이 소각할 수 있어야 합니다(MUST). 그렇지 않으면 위임자가 일방적으로 권한을 회수할 수 없어 중단 장치가 사라집니다. 보유자가 직접 태우는 burn 기능만으로는 에이전트의 협조에 의존하게 되어 요건을 충족하지 못합니다.
- 검사는 키가 아니라 계정 단위입니다: 이 검사는 msg.sender인 계정만 봅니다. 세션 키로 운영되는 스마트 계정(예: ERC-4337)에서는 통과 시점에 그 계정을 쥔 키가 무엇이든 허가됩니다. 운영 지갑 주소가 바뀔 수 있는 경우에는 운영 지갑 대신 신원에서 파생된 안정적인 계정(예: 신원 NFT의 ERC-6551 토큰 바운드 계정)에 컨트롤 토큰을 묶는 것이 권장됩니다.
- 역할 검사는 행위 종류만 허가합니다: 역할 검사는 계정이 어떤 종류의 행위를 할 수 있는지만 판단하고 개별 호출이 타당한지는 판단하지 않습니다. 금액이 지나치게 크거나 오래된 입력에 기반했거나 악의적이어도 역할 범위 안이면 통과합니다. 에이전트에 권한을 위임하는 배포에서는 지출 한도 같은 계정 쪽 실행 정책, 사전 검증, 사람의 개입 절차 같은 개별 호출 수준 통제를 함께 둬야 합니다(SHOULD).