ERC-6864 업그레이드 가능 토큰 (Upgradable Fungible Token)
Draft · 토큰 · 2023-04-05 작성
이미 배포된 ERC-20 토큰을 사용자 잔액을 유지한 채 새 컨트랙트로 업그레이드하고, 원하면 다시 원래 토큰으로 되돌릴 수 있게 하는 ERC-20 확장 표준입니다.
왜 필요한가
스마트 컨트랙트는 한 번 배포하면 코드를 바꿀 수 없습니다. 그래서 토큰에 버그가 발견되거나, 새 기능과 표준을 받아들여야 하거나, 바뀐 규제에 맞춰야 할 때 기존 ERC-20 토큰을 고칠 방법이 마땅치 않습니다. 흔히 쓰는 해법인 프록시 패턴(proxy pattern)은 처음 배포할 때부터 프록시 구조로 만들어 두어야만 쓸 수 있어서 이미 프록시 없이 배포된 토큰에는 적용할 수 없습니다. 또 프록시 업그레이드는 사용자 모르게 조용히 일어나고 되돌릴 수도 없어서 사용자가 업그레이드를 거부할 선택지가 없습니다. 이 표준은 범위를 ERC-20 토큰으로 좁혀서 기존에 배포된 어떤 ERC-20에도 새 컨트랙트를 얹어 업그레이드할 수 있게 하고, 사용자가 직접 동의해야만 토큰이 옮겨지며, 마음이 바뀌면 되돌릴 수 있는 길을 표준으로 정합니다.
구현해야 하는 것
event Upgrade(address indexed from, address indexed to, uint256 amount);: 토큰이 업그레이드될 때 반드시 발생하는 이벤트입니다. 기본 ERC-20 토큰을 내놓은 주소, 새 토큰을 받은 주소, 수량을 기록합니다.event Downgrade(address indexed from, address indexed to, uint256 amount);: 토큰이 다운그레이드될 때 반드시 발생하는 이벤트입니다. 새 토큰을 내놓은 주소, 기본 토큰을 받은 주소, 수량을 기록합니다.function upgrade(address to, uint256 amount) external;: 호출자가 가진 기본 ERC-20 토큰 amount만큼을 to 주소의 ERC-6864 토큰으로 바꿉니다.function downgrade(address from, address to, uint256 amount) external;: from이 가진 ERC-6864 토큰 amount만큼을 to 주소의 기본 ERC-20 토큰으로 되돌립니다. 호출자는 from 본인이거나 지출을 승인받은 주소여야 합니다.function baseToken() external view returns (address);: 이 컨트랙트가 업그레이드 대상으로 삼는 기본 ERC-20 컨트랙트의 주소를 돌려줍니다.function combinedTotalSupply() external view returns (uint256);: 이 컨트랙트와 기본 ERC-20을 합친 전체 토큰 공급량을 돌려줍니다. 선택 확장입니다.function combinedBalanceOf(address account) external view returns (uint256);: account가 두 컨트랙트에 걸쳐 가진 합산 잔액을 돌려줍니다. 선택 확장입니다.function combinedAllowance(address owner, address spender) external view returns (uint256);: spender가 owner를 대신해 두 컨트랙트에 걸쳐 쓸 수 있는 합산 허용량을 돌려줍니다. 선택 확장입니다.
심층 설명
ERC-20 확장이라는 설계
IERC6864는 IERC20을 상속하는 인터페이스입니다. 업그레이드된 토큰도 transfer, balanceOf 같은 ERC-20 함수를 그대로 제공하므로, 다른 컨트랙트는 토큰 주소만 바꾸면 아무 수정 없이 계속 상호작용할 수 있습니다. 원문은 사용자 잔액에 영향을 주지 않고 업그레이드하는 것이 목표이므로 기존 데이터 구조와 메서드를 재활용하는 것이 공학적 수고가 가장 적고 상호운용성이 가장 높은 길이라고 설명합니다. 핵심 인터페이스는 upgrade, downgrade 두 함수와 Upgrade, Downgrade 두 이벤트, 그리고 기본 토큰 주소를 알려 주는 baseToken 조회 함수로 구성됩니다.
upgrade 함수의 요구 사항
upgrade(to, amount)는 msg.sender가 가진 기본 ERC-20 토큰 amount만큼을 to 앞으로 ERC-6864 토큰으로 바꿉니다. to가 제로 주소이면 반드시 되돌려야 하고(MUST revert), msg.sender가 기본 토큰을 amount 이상 직접 보유하지 않아도 반드시 되돌려야 합니다. 실행 시 Upgrade 이벤트를 반드시 발생시켜야 합니다. 참조 구현은 transferFrom으로 기본 토큰을 컨트랙트에 옮긴 뒤 같은 수량을 _mint로 발행합니다. 즉 기본 토큰은 사라지지 않고 ERC-6864 컨트랙트가 보관하며, 발행 시점은 업그레이드가 호출되는 바로 그때입니다.
downgrade 함수와 되돌리기
downgrade(from, to, amount)는 from이 가진 ERC-6864 토큰 amount만큼을 없애고 to에게 기본 ERC-20 토큰을 돌려줍니다. to가 제로 주소이거나, from의 보유량이 amount보다 적거나, msg.sender가 from 본인이 아니면서 amount 이상을 지출하도록 승인받지 못한 경우에는 반드시 되돌려야 합니다. 실행 시 Downgrade 이벤트를 반드시 발생시켜야 합니다. 원문은 다운그레이드 덕분에 같은 기본 토큰 위의 여러 ERC-6864 구현 사이를 오갈 수 있고, 새 컨트랙트에서 버그나 한계가 발견되거나 사용자가 단순히 마음을 바꿨을 때 빠져나올 길이 생긴다고 설명합니다.
선택 사항인 시스루 확장
시스루(see-through) 확장 IERC6864SeeThrough는 ERC-6864 컨트랙트와 기본 ERC-20 컨트랙트의 상태를 합산해 보여 주는 세 함수 combinedTotalSupply, combinedBalanceOf, combinedAllowance를 정의합니다. 원문은 이 함수들이 여러 상황에서 유용하지만 구현이 쉽고 다른 공개 함수로도 같은 값을 계산할 수 있어서 핵심 인터페이스가 아닌 선택 확장으로 두었다고 설명합니다. 구현 여부는 OPTIONAL입니다.
프록시 패턴, ERC-4931과의 비교
delegatecall을 쓰는 프록시 패턴은 범용 업그레이드 해법이지만 처음부터 프록시로 배포된 컨트랙트에만 쓸 수 있고 업그레이드가 조용히 일어나며 되돌릴 수 없어 사용자가 거부할 수 없습니다. 반면 이 표준은 기존과 미래의 어떤 ERC-20에도 적용되고 구현과 유지가 더 단순하며, 되돌리거나 중첩할 수 있고 사용자가 명시적으로 동의하는 이중 확인 기회를 줍니다. 같은 문제를 다루는 ERC-4931은 별도의 브리지 컨트랙트를 두어 토큰 로직과 업그레이드 로직을 분리하지만 목적지 컨트랙트에 토큰을 미리 발행해 브리지가 보유하게 해야 하고, 전송 중 업그레이드와 시스루 함수를 지원하지 못한다고 원문은 비교합니다.
하위 호환성과 합산 잔액 방식 transfer
이 표준은 ERC-20과 대체로 호환됩니다. 다만 일부 구현은 사용자 편의를 위해 transfer가 표준 balanceOf 수량이 아니라 두 컨트랙트의 합산 잔액 전체를 대상으로 동작하게 만들 수 있습니다. 참조 구현이 그 예로, transfer 시 ERC-6864 잔액이 부족하면 모자란 만큼을 자동으로 업그레이드한 뒤 보냅니다. 이런 방식을 택한 컨트랙트는 totalSupply와 balanceOf도 두 컨트랙트의 합산 수량을 돌려주도록 구현할 것이 권장됩니다(RECOMMENDED). 참조 구현의 totalSupply는 자체 공급량과 기본 토큰 공급량을 더한 뒤 컨트랙트가 보관 중인 기본 토큰 수량을 빼서 이중 집계를 막습니다.
변환 비율은 구현이 정합니다
업그레이드와 다운그레이드의 변환 함수는 구현이 자유롭게 정할 수 있습니다. 원문은 1대1, 선형, 비선형 변환이 모두 가능하다고 명시합니다. 참조 구현은 1대1 방식으로, 받은 기본 토큰과 같은 수량을 발행하고 소각 시 같은 수량을 돌려줍니다. 비선형 변환을 쓰면 별도의 보안 고려가 따릅니다.
Draft 단계의 제안입니다
이 제안은 2023년 4월 5일에 만들어졌고 현재 상태가 Draft입니다. 아직 확정된 표준이 아니므로 명세가 바뀌거나 제안이 멈출 수 있다는 점을 염두에 두어야 합니다.
쓸 때 주의할 점
- approve에 따르는 책임: 기본 토큰을 업그레이드하려는 사용자는 먼저 ERC-6864 컨트랙트에 지출을 승인해야 합니다. 그 컨트랙트가 건전하고 안전한지, 승인하는 수량이 적절한지 확인하는 것은 사용자 책임이며, 이는 모든 approve 작업과 같은 보안 고려 사항입니다.
- 비선형 변환과 선행매매 위험: 구현은 1대1, 선형, 비선형 등 어떤 변환 함수든 쓸 수 있습니다. 비선형 변환을 쓰면 upgrade와 downgrade가 선행매매(front running)나 샌드위치 공격에 취약해질 수 있습니다. 이는 비슷한 비선형 곡선을 쓰는 자동화 마켓 메이커(AMM)와 같은 보안 고려 사항입니다.
- 무제한 승인과 자동 업그레이드: 컨트랙트가 무제한 허용량 승인을 요구하거나 transfer 중에 자동으로 업그레이드하도록 만들 수 있습니다. 이 경우 approve가 이중 확인이라면 업그레이드 의사를 한 번 더 확인하는 삼중 확인 기회가 사라집니다.
- 다중 구현과 중첩에 따른 혼란: 같은 기본 ERC-20 토큰에 여러 ERC-6864 구현을 적용할 수 있고 ERC-6864 컨트랙트끼리 중첩할 수도 있습니다. 이는 토큰 구조를 복잡하게 만들어 기존 대시보드가 잘못되거나 일관성 없는 수치를 보여 줄 수 있습니다.