ERC-5727 준대체 소울바운드 토큰 (Semi-Fungible Soulbound Token)
Draft · NFT·멀티토큰 · 2022-09-28 작성
신원, 자격, 소속, 평판을 나타내는 양도 불가 토큰(소울바운드 토큰, SBT)을 대체 가능형과 비대체형 모두로 발행하고 회수, 만료, 복구까지 한 인터페이스로 관리하게 합니다.
왜 필요한가
지금의 웹3 생태계는 사고팔 수 있는 금융화된 토큰에 치우쳐 있습니다. 그런데 자격, 소속, 평판처럼 사람에게 붙어 있어야 의미가 있는 속성은 양도할 수 없는 토큰으로 표현해야 합니다. 이더리움 커뮤니티에 그런 시도가 있었지만 유연성과 확장성이 부족했습니다. 멤버십 카드처럼 하나뿐인 토큰과 포인트처럼 수량으로 세는 토큰을 한 표준으로 함께 다루기 어렵고 발행한 자격을 회수하거나 만료시키는 방법, 지갑을 잃었을 때 토큰을 되찾는 방법, 공동체 투표로 발행을 결정하거나 발행 권한을 맡기는 방법도 표준에 없었습니다. ERC-5727은 이 공백을 메우기 위해 발행부터 회수, 검증, 만료, 복구, 거버넌스까지 아우르는 공통 인터페이스를 제안합니다.
구현해야 하는 것
event Revoked(address indexed from, uint256 indexed tokenId);: 토큰이 회수될 때 반드시 발생하는 이벤트입니다.event Verified(address indexed by, uint256 indexed tokenId, bool result);: 토큰 검증이 수행될 때 검증 주체와 결과를 알리는 이벤트입니다.function verifierOf(uint256 tokenId) external view returns (address);: 토큰의 검증자 주소를 조회합니다. 없는 tokenId면 리버트해야 합니다.function issuerOf(uint256 tokenId) external view returns (address);: 토큰의 발행자 주소를 조회합니다. 없는 tokenId면 리버트해야 합니다.function revoke(uint256 tokenId, bytes calldata data) external payable;: 주소에서 토큰을 회수합니다.function slotCountOfOwner(address owner) external view returns (uint256);: 소유자가 가진 슬롯의 수를 조회합니다.function removeApprovalRequest(uint256 approvalId) external;: 승인 요청을 제거합니다. 요청 작성자만 할 수 있고 이미 처리된 요청이면 리버트해야 합니다.event Delegate(address indexed operator, uint256 indexed slot);: 특정 슬롯의 발행 권한이 운영자에게 위임될 때 발생하는 이벤트입니다.event UnDelegate(address indexed operator, uint256 indexed slot);: 운영자에게 위임한 권한을 거둘 때 발생하는 이벤트입니다.function delegate(address operator, uint256 slot) external;: 특정 슬롯에 대한 권한을 운영자에게 위임합니다.function undelegate(address operator, uint256 slot) external;: 운영자에게 위임한 슬롯 권한을 거둡니다.event Recovered(address indexed from, address indexed to);: 소유자의 토큰들이 새 주소로 복구될 때 발생하는 이벤트입니다.function recover(address owner, bytes memory signature) external;: 소유자의 서명을 제시해 그 소유자의 토큰들을 복구합니다. 서명이 유효하지 않으면 리버트해야 합니다.
심층 설명
토큰과 슬롯 구조
토큰은 256비트 부호 없는 정수인 tokenId로 식별되고 액면을 나타내는 값(value)을 가질 수 있습니다. 슬롯은 256비트 정수 slotId로 식별되며 대체 가능 토큰과 비대체 토큰을 함께 묶어 토큰을 준대체(semi-fungible) 상태로 만드는 단위입니다. 하나의 토큰은 동시에 하나의 슬롯에만 속할 수 있습니다. 예를 들어 한 DAO가 멤버십 SBT, 역할 배지, 평판 점수 등을 슬롯별로 나눠 하나의 SBT 컬렉션 안에 담을 수 있습니다.
핵심 메서드와 이벤트
핵심 인터페이스 IERC5727은 IERC3525, IERC5192, IERC5484, IERC4906을 상속하며 모든 구현이 반드시 지원해야 합니다. issue는 두 형태입니다. 하나는 to, tokenId, slot, burnAuth, verifier를 지정해 토큰을 발행하는 것으로, to나 verifier가 0 주소면 리버트해야 합니다. 다른 하나는 기존 토큰에 amount만큼 크레딧을 추가 발행합니다. revoke도 토큰 자체를 회수하는 형태와 크레딧 일부를 회수하는 형태가 있고 회수 시 Revoked 이벤트를 내야 합니다. verify는 토큰 유효성을 확인해 불리언을 반환하며 Verified 이벤트를 냅니다. verifierOf와 issuerOf는 토큰의 검증자와 발행자 주소를 조회하고 존재하지 않는 tokenId면 리버트해야 합니다.
조회와 메타데이터 확장
모든 확장은 선택 사항(OPTIONAL)이며 일부만 구현해도 됩니다. Enumerable 확장은 소유자의 슬롯 수를 세는 slotCountOfOwner, 인덱스로 슬롯을 찾는 slotOfOwnerByIndex, 특정 슬롯에서의 잔액을 보는 ownerBalanceInSlot을 제공하며 핵심 인터페이스와 함께 구현하기를 권장합니다. Metadata 확장은 IERC3525Metadata를 상속해 토큰, 슬롯, 컨트랙트 자체의 메타데이터를 조회하게 하며 토큰과 컬렉션의 모양과 속성을 지정해야 할 때 구현을 권장합니다.
거버넌스와 위임
Governance 확장은 발행과 회수 권한을 투표로 관리합니다. requestApproval로 발행 승인 요청을 만들고 투표자는 voteApproval로 찬반을 표시하며 요청 작성자는 아직 처리되지 않은 요청을 removeApprovalRequest로 제거할 수 있습니다. 승인 상태는 Pending, Approved, Rejected, Removed 네 가지이고 approvalURI로 요청의 URI를 조회합니다. Delegate 확장은 특정 슬롯의 발행 권한을 운영자에게 delegate로 위임하고 undelegate로 거두며 isOperatorFor로 권한 여부를 확인합니다. 위임 권한이 없는 호출자, 0 주소 운영자, 유효하지 않은 슬롯이면 리버트해야 합니다.
복구와 만료
Recovery 확장은 소유자가 서명한 signature를 제시하면 그 소유자의 토큰을 되찾는 recover 함수를 제공하며 서명이 유효하지 않으면 리버트해야 합니다. 서명 방식은 가독성과 사용성을 위해 EIP-712와 호환되어야 하고 복구가 끝나면 Recovered 이벤트를 냅니다. 손상되거나 오래된 지갑에서 토큰을 되찾을 수 있도록 이 확장의 구현을 권장합니다. Expirable 확장은 IERC5643을 상속하며 setExpiration으로 토큰의 만료일(uint64 expiration)과 갱신 가능 여부(isRenewable)를 설정합니다. 존재하지 않는 토큰이거나 과거 날짜를 지정하면 리버트해야 합니다.
설계 이유와 호환성
저장 모델은 준대체 토큰 표준에서 영감을 받았습니다. ERC-1155에서는 대체 가능 토큰의 각 단위가 완전히 동일하지만 이 표준은 같은 슬롯에 속한 비슷한 토큰이라도 값, 효력, 유효 기간, 출처가 다를 수 있음을 구분합니다. 서로 다른 기관이 준 신용 점수가 같은 슬롯을 공유하면서도 성격이 다른 경우를 표현하기 위한 것입니다. 복구 메커니즘은 ERC-1271에서 영감을 받았으며 SBT는 주소에 귀속된 신원을 나타내 쪼갤 수 없으므로 복구를 소유자의 모든 토큰을 한꺼번에 옮기는 일로 간주합니다. 그래서 transferFrom이나 safeTransferFrom 대신 recover 함수를 씁니다. 이 표준은 ERC-721, ERC-3525, ERC-4906, ERC-5192, ERC-5484와 호환되고 ERC-165와도 호환됩니다.
제안 상태
이 제안은 원문 기준 초안(Draft) 상태입니다. 인터페이스와 세부 규칙이 앞으로 바뀔 수 있으므로 구현하기 전에 최신 원문을 확인하는 것이 좋습니다.
쓸 때 주의할 점
- 개인키 분실 시 전량 탈취 위험: 복구 메커니즘을 쓰는 경우, 사용자가 개인키를 잃으면 공격자가 서명을 만들어 피해자의 모든 SBT를 자기 주소로 복구해 갈 수 있습니다. 따라서 개인키를 항상 안전하게 보관해야 합니다.
- 다중 서명 복구 권장: 원문은 개발자에게 SBT 복구에 여러 개의 서명을 요구하는 방식으로 복구 메커니즘을 구현할 것을 권장합니다. 한편 이 표준은 일반적인 토큰 전송을 포함하지 않으므로 전송과 관련한 일반적인 보안 문제는 없다고 명시합니다.