ERC-7720 예약형 토큰 전송 (Deferred Token Transfer)
Draft · 토큰 · 2024-06-09 작성
ERC-20 토큰을 수취인 앞으로 맡겨 두고 미리 정한 미래 시점이 지난 뒤에만 찾아갈 수 있게 하는 예약 전송(Deferred Transfer) 표준입니다.
왜 필요한가
토큰을 지금 보내되 받는 사람이 일정 시점 이후에만 쓸 수 있게 하고 싶은 경우가 많습니다. 직원에게 단계적으로 지급하는 베스팅(vesting), 조건이 갖춰질 때까지 제3자가 보관하는 에스크로(escrow), 일정 시간이 지나야 주는 보상 등이 대표적입니다. 그런데 기본 ERC-20 전송은 보내는 즉시 상대가 토큰을 받게 되어 시간 조건을 걸 수 없습니다. 이 표준이 없으면 서비스마다 제각각의 방식으로 시간 잠금 장치를 만들어야 하고 토큰이 정해진 시점 이후에만 전달된다는 보장을 공통된 방법으로 제공하기 어렵습니다. 이 표준은 맡긴 건마다 고유 번호를 붙이고 토큰 주소, 보낸 사람, 받는 사람, 수량, 잠금 해제 시각, 인출 여부를 기록해, 시간이 지나야만 찾을 수 있는 구조화된 지연 지급을 가능하게 합니다.
구현해야 하는 것
function withdraw(uint256 _txnId) external;: 거래 번호를 지정해 잠금 해제 시각이 지난 토큰을 인출합니다.
심층 설명
필수 인터페이스 구성
이 표준의 구현체는 ITokenTransfer 인터페이스의 모든 함수를 반드시(MUST) 갖춰야 합니다. 구성은 예약 전송을 만드는 transferFrom, 인출하는 withdraw, 상태를 조회하는 getTransaction 세 함수와 Transfer, Withdraw 두 이벤트입니다. 예치 건마다 고유 ID가 부여되고 토큰 주소, 보낸 사람, 받는 사람, 수량, 잠금 해제 시각, 인출 여부가 함께 기록됩니다. 수취인은 지정된 미래 타임스탬프 이후에만 토큰을 인출할 수 있습니다.
transferFrom의 동작과 txnId 반환
transferFrom은 _token, _from, _to, _amount, _unlockTime, _reference를 받아 예약 전송을 만들고 거래 번호 txnId를 반환합니다. 거래마다 고유 ID를 돌려주는 이유는 각 거래를 독립적으로 추적하고 참조하기 쉽게 하기 위해서입니다. 사용자는 이 ID로 특정 거래를 관리하고 지칭할 수 있어 혼동이 줄고 거래별 상태가 독립적으로 관리되므로 인출 절차도 단순해집니다. 참고 구현에서는 lastTxnId를 1씩 올려 ID를 발급하고 _amount가 0보다 커야 하며 토큰을 safeTransferFrom으로 보낸 사람에게서 컨트랙트로 옮긴 뒤 거래 내역을 저장하고 Transfer 이벤트를 발생시킵니다.
withdraw의 검증 조건
참고 구현의 withdraw는 세 가지를 검사합니다. 거래의 amount가 0보다 커야 유효한 거래 번호로 인정하고 block.timestamp가 unlockTime 이상이어야 하며 이미 인출된 거래(withdrawn이 참)는 다시 인출할 수 없습니다. 조건을 통과하면 예치 때 지정된 받는 사람 주소로 safeTransfer로 토큰을 보내고 withdrawn을 참으로 기록한 뒤 Withdraw 이벤트를 발생시킵니다. 토큰은 항상 거래에 기록된 to 주소로만 전송됩니다.
unlockTime에 uint40을 쓰는 이유
잠금 해제 시각 _unlockTime의 타입으로 uint40을 선택했습니다. uint40은 현실적인 시간 잠금 시나리오를 모두 덮을 만큼 범위가 충분히 크기 때문입니다. 이로써 베스팅 일정이나 장기 에스크로처럼 긴 기간에 걸쳐 정밀한 타이밍이 필요한 지연 지급도 처리할 수 있습니다.
ERC-20을 고치지 않는 별도 인터페이스 설계
이 표준은 ERC-20의 확장이 아니라 별도 인터페이스로 설계되었습니다. ERC-20 표준 자체를 수정하지 않기 때문에 이미 배포된 어떤 ERC-20 토큰과도 컨트랙트 변경 없이 함께 쓸 수 있습니다. 유통 중인 넓은 범위의 토큰에 그대로 적용할 수 있어 활용성과 채택 가능성이 높아집니다.
제안 상태 유의
이 제안은 2024년 6월 9일에 만들어진 Draft(초안) 상태입니다. 아직 확정되지 않아 내용이 바뀌거나 진행이 멈출 수 있으므로, 구현하거나 참고할 때는 최신 원문을 확인해야 합니다.
쓸 때 주의할 점
- 소유자 없는 컨트랙트 설계: 예치 후 토큰을 잃는 위험을 막기 위해 컨트랙트에는 소유자(owner)가 없어야 합니다. 이렇게 하면 컨트랙트가 보관한 토큰 잔액이 지정된 수취인 외의 다른 주소로 옮겨질 수 없습니다.
- 수취인 엄격 통제: 인출 시 컨트랙트는 예치할 때 지정한 수취인에게만 토큰이 전송되도록 엄격히 보장해야 합니다. 이렇게 하면 무단 접근을 막고 의도된 수취인만 토큰을 인출할 수 있습니다.