ERC-2019 토큰 충전 요청 표준 (Fundable Token)
Stagnant · 금고·DeFi · 2019-05-10 작성
이 표준은 토큰 지갑 소유자가 블록체인에서 직접 자금 충전(펀딩)을 요청하고, 발행자가 이를 승인하거나 거부해 토큰을 발행하는 절차를 ERC-20에 추가합니다.
왜 필요한가
법정화폐 기반 결제로 토큰을 발행받으려면 보통 은행 송금 같은 중앙화된 절차가 먼저 필요하고, 그 결제와 온체인 발행이 어떻게 연결되는지 추적하기 어렵습니다. 이 표준이 없으면 지갑 소유자는 발행자에게 별도 채널로 결제 사실을 알려야 하고, 발행자는 수동으로 확인한 뒤 토큰을 발행(민팅)합니다. 이 과정은 기록이 체인 밖에 흩어져 있어 요청, 처리, 거부 같은 상태 변화를 추적하거나 감사하기 어렵고, 동일한 요청이 중복 처리되거나 분실될 위험도 있습니다. 또한 누가 충전을 요청할 권한이 있는지도 표준화된 방법으로 관리할 수 없습니다.
구현해야 하는 것
function authorizeFundOperator(address orderer) external returns (bool);: 지갑 소유자가 특정 주소를 자신의 충전 요청 대리 주문자로 승인합니다.function revokeFundOperator(address orderer) external returns (bool);: 이전에 승인한 대리 주문자의 권한을 회수합니다.function orderFund(string calldata operationId, uint256 value, string calldata instructions) external returns (bool);: 고유 operationId와 금액, 결제 지시사항을 담아 자신의 지갑에 대한 충전을 요청합니다. 이미 쓰인 operationId면 되돌립니다(revert).function orderFundFrom(string calldata operationId, address walletToFund, uint256 value, string calldata instructions) external returns (bool);: 권한을 받은 주문자가 다른 지갑 소유자를 대신해 충전을 요청합니다.function cancelFund(string calldata operationId) external returns (bool);: 처리중 상태가 되기 전인 충전 요청을 토큰 보유자 또는 요청을 낸 주문자가 취소합니다.function processFund(string calldata operationId) external returns (bool);: 운영자가 요청을 처리중 상태로 바꿉니다. 이후에는 취소할 수 없습니다.function executeFund(string calldata operationId) external returns (bool);: 운영자가 토큰을 발행해 요청을 집행 완료 상태로 바꿉니다.function rejectFund(string calldata operationId, string calldata reason) external returns (bool);: 운영자가 이유를 밝히고 요청을 거부합니다.function isFundOperatorFor(address walletToFund, address orderer) external view returns (bool);: 특정 주소가 특정 지갑에 대해 충전 요청 권한이 있는지 확인합니다.function retrieveFundData(address orderer, string calldata operationId) external view returns (address walletToFund, uint256 value, string memory instructions, FundStatusCode status);: 운영자, 토큰 보유자, 주문자만 조회할 수 있는 충전 요청의 상세 데이터를 반환합니다.event FundInProcess(address indexed orderer, string indexed operationId);: 운영자가 지시사항을 확인하고 요청을 처리중 상태로 바꿨을 때 발생합니다.event FundExecuted(address indexed orderer, string indexed operationId);: 운영자가 요청을 집행해 토큰을 발행했을 때 발생합니다.event FundRejected(address indexed orderer, string indexed operationId, string reason);: 운영자가 이유와 함께 요청을 거부했을 때 발생합니다.event FundCancelled(address indexed orderer, string indexed operationId);: 운영자가 처리를 시작하기 전에 요청이 취소됐을 때 발생합니다.event FundOperatorAuthorized(address indexed walletToFund, address indexed orderer);: 어떤 주소가 특정 지갑의 대리 주문자로 승인됐을 때 발생합니다.event FundOperatorRevoked(address indexed walletToFund, address indexed orderer);: 대리 주문자 권한이 회수됐을 때 발생합니다.
심층 설명
세 가지 역할
이 표준은 토큰 지갑 소유자, 토큰 컨트랙트 운영자(발행자나 그 대리인), 주문자(orderer) 세 역할을 구분합니다. 지갑 소유자는 자신의 지갑에 충전을 요청하는 당사자이고, 운영자는 모든 충전 요청을 읽고 실제 결제 내역과 대조해 승인 또는 거부를 결정하는 주체입니다. 주문자는 지갑 소유자에게서 권한을 받아 대신 충전을 요청할 수 있는 제3자입니다.
대리 권한 관리
authorizeFundOperator는 지갑 소유자가 특정 주소를 자신의 대리 주문자로 지정하는 함수이고, revokeFundOperator는 그 권한을 거둬들입니다. isFundOperatorFor로 특정 주소가 특정 지갑에 대한 권한이 있는지 조회할 수 있습니다. 권한이 부여되거나 회수될 때마다 FundOperatorAuthorized, FundOperatorRevoked 이벤트가 각각 발생합니다.
충전 요청 생성과 operationId
orderFund는 자신의 지갑에, orderFundFrom은 권한을 받은 주문자가 다른 지갑 소유자를 대신해 충전을 요청할 때 씁니다. 두 함수 모두 operationId, 금액(value), 결제 지시사항(instructions) 문자열을 받습니다. 이미 사용된 operationId로 다시 요청하면 함수는 반드시 되돌려져야(revert) 합니다.
상태 전이
FundStatusCode는 Nonexistent, Ordered, InProcess, Executed, Rejected, Cancelled 여섯 가지 상태를 정의합니다. 요청은 orderFund(Ordered)로 시작해 processFund(InProcess)를 거쳐 executeFund(Executed)로 끝나거나 rejectFund(Rejected)로 거부됩니다. cancelFund(Cancelled)는 운영자가 처리중 상태로 바꾸기 전까지만 토큰 보유자나 주문자가 쓸 수 있습니다.
데이터 조회 권한 제한
retrieveFundData는 operationId로 충전 요청의 지갑, 금액, 지시사항, 상태를 모두 반환하지만, 운영자, 토큰 보유자, 해당 주문자만 호출할 수 있습니다. 이는 결제 관련 민감한 정보가 누구에게나 공개되지 않도록 조회 권한을 제한하는 설계입니다.
operationId를 문자열로 둔 이유
operationId는 가스 효율이 더 좋은 형식 대신 문자열로 정의되어 있습니다. 이는 사람이 읽을 수 있는 식별자로 추적성을 높이기 위한 선택이며, 구현자는 문자열 전체를 체인에 저장할지 해시만 저장할지 선택할 수 있습니다. operationId는 경쟁 자원이므로 요청자가 고유한 접두사를 쓰는 것이 충돌 방지에 권장됩니다.
결제 지시사항을 다루는 방식
instructions 필드의 형식은 정해져 있지 않으며 ISO 결제 표준 같은 형식을 참고할 수 있습니다. 다만 실제 자금을 어디서 인출할지 알려주는 구체적인 라우팅 정보를 체인에 그대로(평문으로) 적는 것은 권장되지 않으며, 비공개 채널이나 암호화된 저장소 같은 체인 바깥의 수단을 쓰거나, 꼭 체인에 적어야 한다면 암호화된 형태로 넣는 것이 권장됩니다.
제안 상태
이 ERC는 Stagnant 상태로, 더 이상 활발히 논의되지 않고 멈춰 있는 제안입니다. 내용이 앞으로 바뀌거나 채택되지 않을 수 있습니다.