ERC-1996 홀드 가능 토큰 (Holdable Token)
Stagnant · 금고·DeFi · 2019-04-10 작성
ERC-20 토큰에 홀드(보류) 기능을 추가해, 공증인이 집행하거나 해제할 때까지 일정 금액을 결제 상대방을 위해 미리 묶어 두는 표준입니다.
왜 필요한가
이더리움의 기본 토큰 표준인 ERC-20은 approve 함수로 다른 계정이 내 토큰을 대신 쓸 수 있도록 승인할 수 있지만 이 승인은 최대 사용 가능 금액을 정해둘 뿐 그 금액이 실제로 묶여서 보장되는 것은 아닙니다. 승인된 금액이라도 소유자가 다른 곳에 먼저 써버리면 나중에 실행하려던 전송은 실패할 수 있습니다. 그런데 규제된 토큰의 클리어링 절차처럼 모든 검증이 끝나기 전까지 전송을 확정할 수 없거나, 호텔 체크인처럼 정확한 금액을 모르는 채로 결제를 미리 보장해야 하는 상황에서는 단순 승인만으로는 부족합니다. 보류(홀드) 기능이 없으면 이런 사전 보장형 결제나 조건부 정산을 토큰 컨트랙트 자체에서 처리할 방법이 없습니다.
구현해야 하는 것
function hold(string calldata operationId, address to, address notary, uint256 value, uint256 timeToExpiration) external returns (bool);: msg.sender 명의로 수령자, 공증인, 최대 금액, 만료 시간을 지정해 새 보류를 생성합니다.function holdFrom(string calldata operationId, address from, address to, address notary, uint256 value, uint256 timeToExpiration) external returns (bool);: 사전에 승인받은 오퍼레이터가 from 계정을 대신해 보류를 생성합니다.function releaseHold(string calldata operationId) external returns (bool);: 전송 없이 보류를 해제해 묶인 금액을 결제자에게 다시 풀어줍니다.function executeHold(string calldata operationId, uint256 value) external returns (bool);: 공증인이 지정한 금액만큼 결제자에서 수령자로 실제 전송을 집행합니다.function renewHold(string calldata operationId, uint256 timeToExpiration) external returns (bool);: 아직 만료되지 않은 보류의 만료 시각을 새로 설정합니다.function retrieveHoldData(string calldata operationId) external view returns (address from, address to, address notary, uint256 value, uint256 expiration, HoldStatusCode status);: 특정 보류의 결제자, 수령자, 공증인, 금액, 만료 시각, 상태를 모두 조회합니다.function balanceOnHold(address account) external view returns (uint256);: 한 계정에 걸려 있는 보류 금액의 총합을 조회합니다.function netBalanceOf(address account) external view returns (uint256);: balanceOf와 balanceOnHold를 합한 순 잔액을 조회합니다.function totalSupplyOnHold() external view returns (uint256);: 전체 토큰 공급량 중 현재 보류 중인 총액을 조회합니다.function authorizeHoldOperator(address operator) external returns (bool);: msg.sender를 대신해 보류를 생성할 수 있는 오퍼레이터를 승인합니다.function revokeHoldOperator(address operator) external returns (bool);: 오퍼레이터의 보류 생성 권한을 거둬들입니다.function isHoldOperatorFor(address operator, address from) external view returns (bool);: 특정 주소가 from 계정의 오퍼레이터로 승인되어 있는지 조회합니다.event HoldCreated(address indexed holdIssuer, string operationId, address from, address to, address indexed notary, uint256 value, uint256 expiration);: 새 보류가 생성되었을 때 발생하는 이벤트입니다.event HoldExecuted(address indexed holdIssuer, string operationId, address indexed notary, uint256 heldValue, uint256 transferredValue);: 보류가 집행되어 실제 전송이 일어났을 때 발생하는 이벤트입니다.event HoldReleased(address indexed holdIssuer, string operationId, HoldStatusCode status);: 보류가 해제되었을 때 누가, 어떤 사유로 해제했는지 함께 기록되는 이벤트입니다.event HoldRenewed(address indexed holdIssuer, string operationId, uint256 oldExpiration, uint256 newExpiration);: 보류의 만료 시각이 갱신되었을 때 발생하는 이벤트입니다.event AuthorizedHoldOperator(address indexed operator, address indexed account);: 오퍼레이터가 보류 생성 권한을 승인받았을 때 발생하는 이벤트입니다.event RevokedHoldOperator(address indexed operator, address indexed account);: 오퍼레이터의 보류 생성 권한이 취소되었을 때 발생하는 이벤트입니다.
심층 설명
hold / holdFrom: 보류 생성
hold는 msg.sender 자신의 토큰을, holdFrom은 사전에 authorizeHoldOperator로 승인받은 오퍼레이터가 from 계정의 토큰을 대상으로 보류를 생성합니다. operationId(문자열), 수령자 to, 공증인 notary, 최대 전송 금액 value, 만료까지 남은 시간 timeToExpiration을 지정합니다. value는 결제자 잔액 이하여야 하고 이미 쓰인 operationId로는 다시 호출할 수 없습니다. timeToExpiration이 0이면 영구 홀드가 되어 만료로 풀리지 않습니다. 생성되면 HoldCreated 이벤트가 발생합니다.
executeHold: 부분 집행 가능한 확정 전송
공증인만 호출할 수 있고 지정한 value만큼 결제자에서 수령자에게 실제로 토큰을 전송합니다. value가 홀드에 걸린 최대 금액보다 작으면 나머지 금액은 결제자에게 다시 돌아가 사용 가능해집니다. 집행 후 HoldExecuted 이벤트에 홀드된 금액(heldValue)과 실제 전송된 금액(transferredValue)이 함께 기록됩니다.
releaseHold: 전송 없이 보류 해제
만료 전에는 공증인 또는 수령자만 releaseHold를 호출할 수 있고 만료 이후에는 누구나 호출할 수 있습니다. 해제되면 전송은 일어나지 않고 보류된 금액이 결제자에게 다시 풀립니다. HoldReleased 이벤트의 status 값으로 ReleasedByNotary, ReleasedByPayee, ReleasedOnExpiration 중 하나가 기록되어 누가, 왜 해제했는지 구분됩니다.
renewHold: 만료 시간 갱신
결제자 또는 오퍼레이터만 호출할 수 있으며 아직 만료되지 않은 홀드에 대해서만 적용됩니다. 새 만료 시각은 호출 시점 블록 타임스탬프에 새 timeToExpiration을 더한 값으로 재설정되고 timeToExpiration이 0이면 기존에 기간이 있던 홀드도 영구 홀드로 바뀝니다. 갱신 시 이전 만료 시각과 새 만료 시각이 HoldRenewed 이벤트로 기록됩니다.
조회 함수: 홀드 상태와 잔액 집계
retrieveHoldData는 특정 operationId의 결제자, 수령자, 공증인, 금액, 만료 시각, 상태(HoldStatusCode)를 모두 반환합니다. balanceOnHold는 한 계정에 걸려 있는 보류 총액, netBalanceOf는 balanceOf와 balanceOnHold를 합한 순 잔액, totalSupplyOnHold는 전체 토큰 공급량 중 보류 중인 총합을 돌려줍니다.
오퍼레이터 승인 체계
authorizeHoldOperator로 자신의 계정에 대해 다른 주소가 holdFrom을 호출할 수 있도록 승인하고 revokeHoldOperator로 그 권한을 거둘 수 있습니다. isHoldOperatorFor로 특정 주소가 특정 계정의 오퍼레이터인지 조회합니다. 이 세 함수의 이름은 필수 사항은 아니지만 ERC-777의 네이밍 규칙을 따랐다고 원문에 밝혀져 있습니다.
balanceOf / transfer / transferFrom 수정과 operationId 설계
이 표준을 구현하려면 기존 ERC-20의 balanceOf가 보류된 금액을 제외한 값을 반환하도록 바꿔야 하고 transfer와 transferFrom은 보류 중인 금액을 전송하지 못하도록 막아야 합니다. operationId는 가스 효율보다 추적과 가독성을 우선해 문자열로 정했고 온체인에 문자열 전체를 저장할지 해시만 저장할지는 구현자의 선택입니다. 발행자가 서로 겹치지 않는 고유 접두사를 쓰는 것이 권장되지만 필수는 아닙니다.
표준 상태
이 제안은 Stagnant 상태로, 더 이상 활발히 논의되거나 진전되지 않고 멈춰 있는 제안입니다. 향후 내용이 바뀌거나 채택되지 않을 수 있습니다.