ERC-2018 클리어링 가능 토큰 (Clearable Token)
Stagnant · 토큰 · 2019-04-30 작성
규제 토큰에서 전송을 즉시 체결하지 않고 먼저 주문해 금액을 묶어둔 뒤, 클리어링 에이전트가 오프체인 검사를 거쳐 실행하거나 거부하게 하는 표준입니다.
왜 필요한가
규제 토큰은 KYC와 AML 같은 법적 요건을 지켜야 하는데, 이런 검사는 온체인에서 바로 처리하기 어려운 경우가 많습니다. 기존 전송 방식은 요청과 동시에 체결이 끝나버리기 때문에, 그 사이에 오프체인 검사를 끼워 넣을 여지가 없습니다. 검사를 마치기 전에 돈이 이미 옮겨지거나 다른 전송에 이중으로 쓰이면 사고가 생길 수 있고 반대로 검사를 기다리느라 전송을 아예 보류하면 그 금액이 다른 용도로도 쓰이지 못해 불확실성이 커집니다. 이 표준이 없으면 규제가 필요한 토큰은 전송을 한 번에 처리하는 ERC-20 방식과 오프체인 승인 절차를 함께 쓸 표준화된 방법이 없었습니다.
구현해야 하는 것
function orderTransfer(string calldata operationId, address to, uint256 value) external returns (bool);: msg.sender를 대신해 to에게 보낼 클리어링 전송을 주문합니다. 이미 사용된 operationId면 되돌립니다.function orderTransferFrom(string calldata operationId, address from, address to, uint256 value) external returns (bool);: 승인된 오퍼레이터가 from을 대신해 to에게 보낼 클리어링 전송을 주문합니다. 이미 사용된 operationId면 되돌립니다.function cancelTransfer(string calldata operationId) external returns (bool);: 클리어링 전송 주문을 취소합니다. 주문자만 가능하며 InProcess 상태가 되면 취소할 수 없습니다.function processClearableTransfer(string calldata operationId) external returns (bool);: 클리어링 전송을 InProcess 상태로 바꿉니다. 클리어링 에이전트만 실행할 수 있습니다.function executeClearableTransfer(string calldata operationId) external returns (bool);: 클리어링 전송을 실행해 지불인에서 수취인으로 토큰을 옮깁니다. 클리어링 에이전트만 실행할 수 있습니다.function rejectClearableTransfer(string calldata operationId, string calldata reason) external returns (bool);: 클리어링 전송을 거부해 묶인 금액을 지불인이 다시 쓸 수 있게 합니다. 클리어링 에이전트만 실행할 수 있습니다.function retrieveClearableTransferData(string calldata operationId) external view returns (address from, address to, uint256 value, ClearableTransferStatusCode status);: 특정 클리어링 전송의 지불인, 수취인, 금액, 상태 정보를 조회합니다.function authorizeClearableTransferOperator(address operator) external returns (bool);: msg.sender를 대신해 전송을 주문할 수 있는 오퍼레이터를 승인합니다.function revokeClearableTransferOperator(address operator) external returns (bool);: msg.sender를 대신해 전송을 주문할 수 있는 오퍼레이터 권한을 취소합니다.function isClearableTransferOperatorFor(address operator, address from) external view returns (bool);: 특정 오퍼레이터가 from을 대신해 전송을 주문할 권한이 있는지 확인합니다.event ClearableTransferOrdered(address indexed orderer, string operationId, address indexed from, address indexed to, uint256 value);: 클리어링 전송이 주문되었을 때 발생합니다.event ClearableTransferInProcess(address indexed orderer, string operationId);: 클리어링 전송이 InProcess 상태가 되었을 때 발생합니다.event ClearableTransferExecuted(address indexed orderer, string operationId);: 클리어링 전송이 실행되었을 때 발생합니다.event ClearableTransferRejected(address indexed orderer, string operationId, string reason);: 클리어링 전송이 거부되었을 때 사유와 함께 발생합니다.event ClearableTransferCancelled(address indexed orderer, string operationId);: 주문자가 클리어링 전송을 취소했을 때 발생합니다.event AuthorizedClearableTransferOperator(address indexed operator, address indexed account);: 오퍼레이터가 다른 계정을 대신해 전송을 주문할 수 있도록 승인되었을 때 발생합니다.event RevokedClearableTransferOperator(address indexed operator, address indexed account);: 오퍼레이터의 전송 주문 권한이 취소되었을 때 발생합니다.
심층 설명
전송 상태 머신
ClearableTransferStatusCode는 Nonexistent, Ordered, InProcess, Executed, Rejected, Cancelled 여섯 단계로 구성됩니다. 전송은 주문되면 Ordered가 되고 클리어링 에이전트가 processClearableTransfer를 호출하면 InProcess로 바뀝니다. 이후 executeClearableTransfer를 거치면 Executed, rejectClearableTransfer를 거치면 Rejected가 되며 InProcess가 되기 전이라면 주문자가 cancelTransfer로 Cancelled로 만들 수 있습니다. retrieveClearableTransferData로 현재 상태를 조회할 수 있습니다.
orderTransfer와 orderTransferFrom
orderTransfer는 msg.sender 본인의 토큰을, orderTransferFrom은 승인된 오퍼레이터가 다른 계정(from)의 토큰을 대신 주문할 때 사용합니다. 두 함수 모두 operationId, 수취인(to), 금액(value)을 받고 value는 지불인의 잔액보다 작거나 같아야 합니다. 이미 사용된 operationId로 다시 호출하면 반드시 되돌립니다. 주문된 금액은 지불인 잔액에서 바로 빠지지는 않지만 다른 전송에는 쓸 수 없게 묶입니다.
cancelTransfer와 processClearableTransfer
cancelTransfer는 오직 주문자만 호출할 수 있고 전송이 이미 InProcess 상태가 되면 성공하지 못합니다. processClearableTransfer는 전송을 InProcess로 바꾸는 선택적 단계로, 클리어링 에이전트만 실행할 수 있습니다. 이 단계를 건너뛰면 주문자가 언제든 전송을 취소할 수 있다는 점에서, 처리 중 상태는 주문자의 취소 권한을 차단하는 역할을 합니다.
executeClearableTransfer와 rejectClearableTransfer
executeClearableTransfer는 클리어링 에이전트가 검사를 통과한 전송에 대해 실제로 토큰을 지불인에서 수취인으로 옮기는 함수입니다. rejectClearableTransfer는 검사를 통과하지 못한 전송에 사용되며 묶여 있던 금액을 지불인이 다시 쓸 수 있게 풀어주고 reason 문자열로 거부 이유를 남깁니다. 두 함수 모두 클리어링 에이전트만 호출할 수 있습니다.
오퍼레이터 승인 구조
authorizeClearableTransferOperator와 revokeClearableTransferOperator로 계정 소유자는 다른 주소가 자신을 대신해 클리어링 전송을 주문할 수 있도록 승인하거나 취소할 수 있습니다. isClearableTransferOperatorFor로 특정 주소가 특정 계정의 오퍼레이터인지 조회할 수 있습니다. 이 세 함수의 이름은 ERC-777의 네이밍 컨벤션을 따릅니다.
operationId와 ERC-1996 의존성
operationId는 가스 효율보다 추적 용이성과 사람이 읽을 수 있는 식별자를 우선해 string 타입으로 정의됩니다. 온체인에 문자열 전체를 저장할지 해시만 저장할지는 구현자가 결정할 수 있습니다. operationId는 경쟁 자원이므로 충돌을 피하려면 발급자별로 고유한 접두사를 쓰는 것이 권장되지만 필수는 아닙니다. 이 표준은 ERC-1996의 홀드 기능을 이용해 주문된 금액을 묶어두며 ERC-1996의 기능을 확장하는 형태이므로 하위 호환성이 있습니다.
기존 transfer/transferFrom과의 관계
이 표준은 ERC-20의 transfer와 transferFrom 함수를 항상 되돌릴지, 특정 조건에서 허용할지를 명세하지 않고 구현자의 선택에 맡깁니다. 즉 클리어링 가능 토큰에서 즉시 체결되는 일반 전송을 완전히 막을지 일부 허용할지는 토큰마다 다를 수 있습니다.
제안 상태
이 제안은 Stagnant 상태로, 활발한 논의 없이 멈춰 있는 제안입니다. 참고용 구현은 io.builders의 저장소에 공개되어 있지만 표준 자체는 확정되지 않았습니다.