ERC-7303 토큰으로 제어하는 토큰 유통(TCTC) (Token-Controlled Token Circulation)

Draft · 서명·인증 · 2023-07-09 작성

민트나 소각 같은 특권을 ERC-721이나 ERC-1155 토큰(컨트롤 토큰)으로 표현해, 그 토큰을 발행하고 태우는 것만으로 역할을 주고 뺏을 수 있게 하는 접근 제어 표준입니다.

왜 필요한가

컨트랙트에서 토큰을 새로 찍거나 없애는 특권 동작은 흔히 역할 기반 접근 제어(ERC-5982)로 관리합니다. 그런데 이 방식은 역할을 주거나 뺏을 때 체인 밖 관리 도구의 화면을 거쳐야 합니다. 또 대부분의 지갑에는 역할로 받은 권한을 보여 주는 화면이 없어서 사용자는 자기에게 어떤 권한이 있는지 지갑만으로 알기 어렵습니다. 권한 구조가 컨트랙트 안에만 숨어 있으면 문제가 더 커집니다. 권한을 위임받아 움직이는 자율 에이전트나 외부 도구는 권한 구조를 설계한 당사자가 아니므로, 어떤 역할에 어떤 자격이 필요한지 기계적으로 알아낼 방법이 없습니다. 이 표준은 권한 자체를 지갑에 보이는 토큰으로 만들고 역할 구조를 조회할 수 있는 인터페이스를 컨트랙트에 두어 이런 문제를 풉니다.

구현해야 하는 것

심층 설명

권한을 컨트롤 토큰으로 표현합니다

이 표준을 구현하는 컨트랙트는 역할에 필요한 권한을 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 상태입니다. 아직 검토 중이라 명세와 인터페이스가 앞으로 바뀔 수 있으므로, 구현하려면 최신 원문을 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs