ERC-1261 멤버십 인증 토큰(MVT) (Membership Verification Token (MVT))
Stagnant · 서명·인증 · 2018-07-14 작성
양도할 수 없고 발행자가 회수할 수 있는 멤버십 토큰(MVT)으로, 조직 소속과 자격을 온체인에서 증명하고 관리하는 표준입니다.
왜 필요한가
블록체인 투표와 거버넌스는 대체로 토큰 잔액에 비례한 투표권에 의존해 왔습니다. 이 방식으로는 유연한 거버넌스 구조를 만들기 어렵습니다. 또한 여권 발급, 운전면허, 회원권, 투자자 적격성 심사처럼 소속이나 자격을 증명해야 하는 서비스는 양도 가능한 토큰으로 표현하면 적합하지 않습니다. 자격을 사고팔 수 있게 되면 본래 목적이 무너지기 때문입니다. 기존 ERC-725/735 클레임 레지스트리는 클레임의 소유권이 보유자에게 있어, 발행자가 사실이 바뀐 클레임을 취소하려 해도 보유자의 컨트랙트가 removeClaim 호출을 무시하면 강제할 방법이 없습니다. 멤버십을 온체인에서 검증하면서도 발행자가 자격을 취소하거나 수정할 수 있는 표준이 그동안 없었습니다.
구현해야 하는 것
event Assigned(address indexed _to, uint[] attributeIndexes);: 회원에게 토큰(멤버십)이 배정될 때 발생하는 이벤트입니다.event Revoked(address indexed _to);: 멤버십이 회수될 때 발생하는 이벤트입니다.event Forfeited(address indexed _to);: 사용자가 스스로 멤버십을 포기할 때 발생하는 이벤트입니다.event ApprovedMembership(address indexed _to, uint[] attributeIndexes);: 멤버십 신청이 승인될 때 발생하는 이벤트입니다.event RequestedMembership(address indexed _to);: 사용자가 멤버십을 신청할 때 발생하는 이벤트입니다.event ModifiedAttributes(address indexed _to, uint attributeIndex, uint attributeValueIndex);: 회원의 속성 값이 수정될 때 발생하는 이벤트입니다(신규 배정 시에는 발생하지 않음).function addAttributeSet(bytes32 _name, bytes32[] calldata values) external;: 새로운 속성(키와 값 목록)을 기존 속성 집합 끝에 추가합니다.function modifyAttributeByIndex(address _to, uint _attributeIndex, uint _modifiedValueIndex) external;: 특정 주소의 특정 속성 값을 다른 값으로 변경합니다.function requestMembership(uint[] calldata _attributeIndexes) external payable;: 어떤 주소든 속성 데이터를 첨부해 멤버십을 신청할 수 있습니다.function forfeitMembership() external payable;: 회원이 자신의 멤버십을 스스로 포기합니다.function approveRequest(address _user) external;: 소유자가 대기 중인 멤버십 신청을 승인해 토큰을 배정합니다.function discardRequest(address _user) external;: 소유자가 대기 중인 멤버십 신청을 폐기합니다.function assignTo(address _to, uint[] calldata _attributeIndexes) external;: 소유자가 신청 절차 없이 특정 주소에 멤버십을 직접 배정합니다.function revokeFrom(address _from) external;: 소유자가 특정 주소의 멤버십을 회수합니다.function isCurrentMember(address _to) external view returns (bool);: 해당 주소가 현재 조직의 회원인지 조회합니다.function getAttributeExhaustiveCollection(bytes32 _name) external view returns (bytes32[] memory);: 특정 속성 이름이 가질 수 있는 전체 값 목록을 조회합니다.function getAllMembers() external view returns (address[]);: 과거와 현재의 모든 회원 주소 목록을 조회합니다.function getCurrentMemberCount() external view returns (uint);: 현재 회원 수를 조회합니다.function getAttributeNames() external view returns (bytes32[] memory);: 등록된 모든 속성 이름 목록을 조회합니다.function getAttributes(address _to) external view returns (bytes32[]);: 특정 주소가 가진 모든 속성 값을 조회합니다.function getAttributeByIndex(address _to, uint _attributeIndex) external view returns (bytes32);: 특정 주소의 특정 속성 값을 조회합니다.function name() external view returns (string _name);: 이 컨트랙트가 발행하는 MVT 모음을 설명하는 이름을 반환합니다.function symbol() external view returns (string _symbol);: 이 컨트랙트가 발행하는 MVT의 축약된 심볼을 반환합니다.
심층 설명
속성(attribute)의 배타적·포괄적 구조
속성 헤더는 서로 배타적이면서 전체를 포괄하는(exclusive and exhaustive) 값 배열에 매핑됩니다. 예를 들어 혈액형 알파벳 헤더는 [o, a, b, ab] 값 배열에, 혈액형 Rh 헤더는 [+, -] 값 배열에 매핑됩니다. 반대로 비디오 구독 서비스처럼 사용자가 정확히 하나만 갖도록 강제되지 않는 항목(넷플릭스, HBO, 아마존 중 none이거나 복수 선택 가능)은 적합한 예가 아니라고 명시되어 있습니다. 이 구조는 조직을 투표 자격 등 세부 하위 그룹으로 나누는 데 쓰입니다.
가입 흐름: requestMembership과 승인/폐기
사용자는 requestMembership에 속성 인덱스를 담아 호출해 가입을 신청하며, 이미 토큰을 가진 msg.sender가 호출하면 실패합니다. 신청 시 RequestedMembership 이벤트가 발생합니다. 소유자는 approveRequest로 대기 중인 신청을 승인하면 ApprovedMembership과 Assigned 이벤트가 함께 발생하고, discardRequest로 신청을 폐기할 수 있습니다. 두 함수 모두 해당 사용자의 대기 신청이 없거나 호출자가 소유자가 아니면 실패해야 합니다. 명세는 오라클라이즈(oraclize) 콜백이 이 함수들을 호출해 승인/거부를 자동화하는 구현도 가능하다고 언급합니다.
assignTo/revokeFrom과 forfeitMembership의 실패 조건
assignTo는 소유자가 신청 절차를 거치지 않고 바로 멤버십을 부여하는 함수로, 대상이 이미 토큰을 가졌거나 영(0) 주소이거나 호출자가 소유자가 아니면 실패해야 합니다. revokeFrom은 _from이 토큰 소유자가 아니거나 영 주소이거나 호출자가 소유자가 아니면 실패해야 합니다. forfeitMembership은 msg.sender가 토큰을 갖고 있지 않으면 실패합니다. 명세는 이 함수들이 실패해야 하는 최소 조건만 규정하므로, 구현체는 가입 마감 시점 도달, 블랙리스트 주소, 수수료 미납 등 추가 조건을 걸어 더 많은 경우에 실패시킬 수 있다고 설명합니다.
양도 불가(non-transferable) 설계
MVT에는 전송 함수가 없습니다. 주소를 바꾸고 싶은 회원은 발행자에게 기존 주소의 토큰을 회수하고 새 주소에 다시 배정해 달라고 요청해야 합니다. 명세는 이를 사용자를 쪼개어 나눠줄 수는 없지만 사용자를 새 개인키로 옮기는 것은 가능하다고 설명하며, 이 양도 불가성 때문에 토큰이 회원증(membership card)처럼 기능하고, 이것이 명칭(Membership Verification Token)의 근거가 되었다고 밝힙니다.
ERC-173/ERC-165 의존 구조
모든 ERC-1261 준수 컨트랙트는 ERC1261, ERC173, ERC165 인터페이스를 함께 구현해야 합니다. ERC-173(소유권 표준)은 assignTo, revokeFrom, addAttributeSet 등 관리 함수를 호출자가 소유자인지 검사하는 데 쓰이며, ERC-165(인터페이스 감지 표준)는 컨트랙트가 지원하는 인터페이스를 조회하는 데 쓰입니다. 이 표준의 ERC-165 식별자는 0x1d8362cf로 명시되어 있습니다.
선택적 메타데이터 확장
name()과 symbol() 함수는 ERC-1261 스마트 컨트랙트에 선택적(OPTIONAL)인 확장으로, ERC-20 등 기존 토큰 표준들의 관례를 따릅니다. 빈 문자열도 두 함수의 유효한 응답이며, 다른 컨트랙트가 동일한 name/symbol을 쓸 수도 있어 어떤 컨트랙트가 공식(canonical)인지 판별하는 것은 이 표준의 범위 밖이라고 명시되어 있습니다. 별도의 조직 메타데이터 JSON 스키마에는 name과 description 필드가 정의되어 있습니다.
ERC-725/735 클레임 레지스트리와의 차이
ERC-725/735 클레임 레지스트리는 클레임의 소유권이 클레임을 받은 보유자에게 있어, 발행자가 removeClaim을 호출해도 보유자의 컨트랙트가 이를 무시하면 취소를 강제할 수 없는 문제가 있다고 설명합니다. 예시로 신원 조회 회사가 발급한 무범죄 증명 클레임이 사실과 달라져도, 보유자가 removeClaim 호출을 무시하면 그대로 남는 상황을 듭니다. ERC-1261은 뱃지/클레임의 소유권을 발행하는 엔티티 컨트랙트 쪽에 두어, 발행자가 임의로 회수하거나 변경할 수 있도록 설계해 이 문제를 피합니다.
제안 상태: Stagnant
이 제안은 현재 Stagnant 상태로 표기되어 있으며, 활발히 논의되거나 진행되지 않고 멈춰 있는 제안입니다.