ERC-2009 토큰 컴플라이언스 검사 서비스 (Compliance Service)
Stagnant · 토큰 · 2019-05-09 작성
규제 토큰이 전송·발행·소각을 실행하기 전에 KYC·AML 같은 준법성 요건을 온체인에서 자동으로 검사하고 기록하도록 하는 컴플라이언스 서비스 표준입니다.
왜 필요한가
KYC나 AML처럼 법적으로 요구되는 준법성 검사를 오프체인에서 처리하면 토큰 전송이 특정 기관의 확인에 의존하게 되어 중앙화됩니다. 또한 검사와 승인이 별도 단계로 나뉘기 때문에 전송이 한 번의 트랜잭션으로 끝나지 않고, 두 번째 확인 절차를 기다려야 해서 시간이 오래 걸립니다. ERC-1462가 transfer, mint, burn의 허용 여부를 확인하는 기본 함수 집합을 제안했지만, 그 검사를 실제로 어떻게 구현할지는 정하지 않았습니다. 그래서 토큰마다 구현 방식이 제각각이 되고, 제3자 개발자가 특정 계정의 토큰 이동이 허용되는지 확인할 표준화된 방법도 없었습니다.
구현해야 하는 것
function checkTransferAllowed(bytes32 tokenId, address from, address to, uint256 value) external view returns (byte);: transfer 함수가 주어진 파라미터로 실행 가능한지 검사합니다.function checkTransferFromAllowed(bytes32 tokenId, address sender, address from, address to, uint256 value) external view returns (byte);: transferFrom 함수가 주어진 파라미터로 실행 가능한지 검사합니다.function checkMintAllowed(bytes32 tokenId, address to, uint256 value) external view returns (byte);: mint 함수가 주어진 파라미터로 실행 가능한지 검사합니다.function checkBurnAllowed(bytes32 tokenId, address from, uint256 value) external view returns (byte);: burn 함수가 주어진 파라미터로 실행 가능한지 검사합니다.function updateTransferAccumulated(bytes32 tokenId, address from, address to, uint256 value) external;: transfer 또는 transferFrom과 같은 트랜잭션에서 호출되어야 하며, 컴플라이언스 규칙을 위반하면 되돌립니다.function updateMintAccumulated(bytes32 tokenId, address to, uint256 value) external;: mint와 같은 트랜잭션에서 호출되어야 하며, 규칙을 위반하면 되돌립니다.function updateBurnAccumulated(bytes32 tokenId, address from, uint256 value) external;: burn과 같은 트랜잭션에서 호출되어야 하며, 규칙을 위반하면 되돌립니다.function addToken(bytes32 tokenId, address token) external;: 서비스에 토큰을 등록해 누적 갱신 함수를 호출할 수 있게 합니다. 이미 쓰이는 tokenId면 되돌립니다.function replaceToken(bytes32 tokenId, address token) external;: 등록된 토큰의 주소를 다른 주소로 교체합니다.function removeToken(bytes32 tokenId) external;: 서비스에서 토큰을 제거해 더 이상 누적 갱신 함수를 호출할 수 없게 합니다.function isToken(address token) external view returns (bool);: 해당 주소가 서비스에 등록된 토큰인지 여부를 반환합니다.function getTokenId(address token) external view returns (bytes32);: 토큰의 tokenId를 반환합니다. 등록되지 않았다면 0을 반환합니다.function authorizeAccumulatedOperator(address operator) external returns (bool);: msg.sender의 tokenId를 대신해 누적을 갱신할 수 있는 오퍼레이터를 승인합니다.function revokeAccumulatedOperator(address operator) external returns (bool);: msg.sender의 tokenId를 대신해 누적을 갱신하던 오퍼레이터의 승인을 취소합니다.function isAccumulatedOperatorFor(address operator, bytes32 tokenId) external view returns (bool);: 특정 오퍼레이터가 해당 tokenId를 대신해 누적을 갱신할 권한이 있는지 반환합니다.event TokenAdded(bytes32 indexed tokenId, address indexed token);: 토큰이 서비스에 추가된 후 발생합니다.event TokenReplaced(bytes32 indexed tokenId, address indexed previousAddress, address indexed newAddress);: 토큰의 주소가 교체된 후 발생합니다.event TokenRemoved(bytes32 indexed tokenId);: 토큰이 서비스에서 제거된 후 발생합니다.event AuthorizedAccumulatedOperator(address indexed operator, bytes32 indexed tokenId);: 오퍼레이터가 토큰을 대신해 누적 갱신 권한을 승인받았을 때 발생합니다.event RevokedAccumulatedOperator(address indexed operator, bytes32 indexed tokenId);: 오퍼레이터가 토큰을 대신한 누적 갱신 권한을 취소당했을 때 발생합니다.
심층 설명
상태 코드와 필수 검사
허용되는 경우 0x11(Allowed) 또는 이와 동등하지만 더 구체적인 의미의 발행자별 코드를 반환해야 합니다. 허용되지 않는 경우 0x10(Disallowed) 또는 이에 상응하는 발행자별 코드를 반환해야 합니다. 이 코드는 ERC-1066을 따릅니다. check 함수가 Allowed를 반환하지 않으면 해당 동작(transfer, transferFrom, mint, burn)은 반드시 실패(revert)해야 하며, 검사는 해당 동작과 함께 반드시 수행되어야 합니다.
네 가지 검사 함수
checkTransferAllowed(tokenId, from, to, value)는 transfer 실행 가능 여부를, checkTransferFromAllowed(tokenId, sender, from, to, value)는 transferFrom 실행 가능 여부를, checkMintAllowed(tokenId, to, value)는 mint 실행 가능 여부를, checkBurnAllowed(tokenId, from, value)는 burn 실행 가능 여부를 각각 검사합니다. 모두 view 함수로, 상태를 바꾸지 않고 상태 코드만 조회합니다.
누적 갱신 함수
updateTransferAccumulated, updateMintAccumulated, updateBurnAccumulated는 각각 transfer/transferFrom, mint, burn과 같은 트랜잭션 안에서 반드시 호출되어야 합니다. 갱신이 컴플라이언스 규칙을 위반하면 반드시 되돌려야(revert) 하며, 구체적으로 어떤 로직을 실행할지는 구현자에게 맡겨져 있습니다. 이 갱신 자체에 대해서는 별도 이벤트를 내지 않는데, 이미 연관된 transfer, mint, burn이 자체 이벤트를 내기 때문입니다.
토큰 등록 관리와 tokenId
addToken(tokenId, token)으로 토큰을 등록해야만 해당 주소가 누적 갱신 함수를 호출할 수 있고, 이미 쓰인 tokenId면 되돌립니다. replaceToken(tokenId, token)으로 등록된 토큰의 주소를 교체할 수 있으며, 적어도 토큰 자신은 자기 주소를 교체할 수 있어야 합니다. removeToken(tokenId)으로 등록을 해제하면 더는 누적 갱신 함수를 호출할 수 없습니다. isToken과 getTokenId는 등록 여부와 tokenId를 조회하는 읽기 전용 함수로, 등록되지 않은 토큰의 getTokenId는 0을 반환합니다. 주소 대신 tokenId를 쓰는 이유는, 토큰 컨트랙트 주소가 바뀌어도 그동안 쌓인 누적 데이터를 마이그레이션 없이 그대로 유지하기 위해서입니다.
누적 갱신 오퍼레이터
authorizeAccumulatedOperator(operator)는 msg.sender의 tokenId를 대신해 누적을 갱신할 오퍼레이터를 승인하고, revokeAccumulatedOperator(operator)는 그 승인을 취소합니다. isAccumulatedOperatorFor(operator, tokenId)는 해당 오퍼레이터가 그 tokenId를 대신할 권한이 있는지 조회합니다. 이 세 함수의 이름은 필수는 아니지만 ERC-777의 오퍼레이터 명명 규칙을 따릅니다.
여러 토큰을 아우르는 공용 서비스
컴플라이언스 서비스는 하나 이상의 토큰을 지원하도록 설계되어, 입법 기관이 관할 내 규제 토큰들의 준법성 규칙을 하나의 스마트컨트랙트에서 관리하고 해당 관할의 모든 토큰이 이를 함께 쓸 수 있습니다. 또한 표준화된 검사 함수가 있으므로 제3자 개발자도 특정 계정의 토큰 이동이 허용되는지 조회해 그에 따라 동작을 결정할 수 있습니다.
지역화와 호환성, 참조 표준
상태 코드 메시지의 지역화(localization)는 이 제안의 범위가 아니지만, ERC-1066과 ERC-1444를 함께 쓰면 구현할 수 있습니다. check* 함수들의 이름은 필수는 아니지만 ERC-1462의 명명을 따랐습니다. 이 제안은 requires로 ERC-1066을 명시하지만 기존 제안의 기능 자체를 확장하는 것은 아니어서, 고려해야 할 하위 호환성 문제는 없습니다.
제안 상태
이 제안은 Stagnant 상태로 등록되어 있어, 더 이상 논의가 이어지지 않고 멈춰 있는 제안입니다. 내용이 앞으로 바뀌거나 채택되지 않을 수 있습니다.