ERC-7417 토큰 표준 변환기 (Token Converter)
Review · 토큰 · 2023-07-27 작성
ERC-20 토큰을 언제든 1:1 비율로 ERC-223 버전으로 바꾸고 다시 ERC-20으로 되돌릴 수 있는 변환기 컨트랙트를 정의합니다. 하나의 토큰이 두 표준으로 동시에 존재하며 자유롭게 교환됩니다.
왜 필요한가
이더리움에는 여러 토큰 표준이 함께 쓰이지만 서로 호환되지 않습니다. 가장 널리 쓰이는 ERC-20은 이미 생태계가 자리 잡았기 때문에, 새 표준이 나와도 옮겨 갈 정해진 절차가 없어 채택이 막히는 병목이 생깁니다. 토큰 개발자는 배포 시점에 표준 하나를 골라 계속 써야 하고 다른 표준의 장점을 쓰고 싶어도 방법이 없습니다. 게다가 같은 ERC-20이라도 구현 편차가 큽니다. 원문은 transfer 함수의 반환값을 두고 성공 시 true를 반환하고 실패 시 되돌리는 토큰, false를 반환하는 토큰, 반환값이 아예 없는 토큰(대표적으로 USDT)이 섞여 있어 서로 호환되지 않는 현실을 지적합니다. 이 제안은 누구나 기존 토큰의 다른 표준 버전을 만들 수 있는 공용 변환 서비스를 두어 표준을 하나만 고를 필요 없이 두 버전이 공존하고 서로 교환되도록 하는 것을 목표로 합니다.
구현해야 하는 것
function getERC20WrapperFor(address _token) public view returns (address): 주어진 토큰 주소의 ERC-20 래퍼 주소를 반환합니다. 없으면 0x0을 반환합니다.function getERC223WrapperFor(address _token) public view returns (address): 주어진 토큰 주소의 ERC-223 래퍼 주소를 반환합니다. 없으면 0x0을 반환합니다.function getERC20OriginFor(address _erc223Token) public view returns (address): 주어진 ERC-223 래퍼의 원본 ERC-20 토큰 주소를 반환합니다. 변환기가 만든 래퍼가 아니면 0x0을 반환합니다.function getERC223OriginFor(address _erc20Token) public view returns (address): 주어진 ERC-20 래퍼의 원본 ERC-223 토큰 주소를 반환합니다. 변환기가 만든 래퍼가 아니면 0x0을 반환합니다.function predictWrapperAddress(address _token, bool _isERC20 // Is the provided _token a ERC-20 or not? // If it is set as ERC-20 then we will predict the address of a // ERC-223 wrapper for that token. // Otherwise we will predict ERC-20 wrapper address. ) view external returns (address): 아직 배포되지 않은 래퍼의 주소를 미리 계산해 반환합니다. _isERC20이 true면 ERC-223 래퍼, false면 ERC-20 래퍼 주소를 예측합니다.function createERC223Wrapper(address _erc20Token) public returns (address): 주어진 ERC-20 토큰의 ERC-223 래퍼를 새로 만들고 그 주소를 반환합니다. 래퍼가 이미 있거나 입력이 래퍼면 되돌립니다.function createERC20Wrapper(address _erc223Token) public returns (address): 주어진 ERC-223 토큰의 ERC-20 래퍼를 새로 만들고 그 주소를 반환합니다. 래퍼가 이미 있거나 입력이 래퍼면 되돌립니다.function wrapERC20toERC223(address _ERC20token, uint256 _amount) public returns (bool): transferFrom으로 보낸 사람의 ERC-20 토큰을 가져와 보관하고 같은 수량의 ERC-223 래퍼 토큰을 보내 줍니다. 래퍼가 없으면 먼저 만듭니다.function unwrapERC20toERC223(address _ERC20token, uint256 _amount) public returns (bool): ERC-20 래퍼 토큰을 가져와 원본으로 되돌리는 함수로, 원문에는 wrapERC20toERC223과 같은 동작 설명이 적혀 있습니다.function convertERC20(address _token, uint256 _amount) public returns (bool): 주어진 ERC-20 토큰이 래퍼인지 자동 판별해 래퍼면 unwrapERC20toERC223을, 원본이면 wrapERC20toERC223을 실행합니다.function isWrapper(address _token) public view returns (bool): 주어진 주소가 변환기가 만든 래퍼이면 true를 반환합니다. 토큰의 표준까지 식별하지는 않습니다.function tokenReceived(address _from, uint _value, bytes memory _data) public override returns (bytes4): ERC-223 토큰이 변환기로 전송될 때 호출되는 수신 처리 함수입니다. 보낸 토큰이 래퍼면 원본 ERC-20을 돌려주고 원본이면 ERC-20 래퍼를 발행해 보내 줍니다. 0x8943ec02를 반환합니다.function extractStuckERC20(address _token): transfer로 직접 잘못 보내져 갇힌 ERC-20 토큰을 꺼내는 함수입니다. 정식 예치 기록과 실제 잔액의 차액만큼 회수할 수 있습니다.
심층 설명
두 가지 구성 요소: 변환기와 래퍼
시스템은 변환기(Converter) 컨트랙트와 래퍼(wrapper) 컨트랙트로 구성됩니다. 원본 토큰 하나는 표준별로 정확히 하나의 래퍼만 가질 수 있고 ERC-20 토큰마다 ERC-223 래퍼가 정확히 하나 있어야 합니다(MUST). 래퍼는 CREATE2 opcode로 배포되므로 배포 전에도 predictWrapperAddress로 주소를 미리 계산할 수 있습니다. 래퍼 주소는 바이트코드에 따라 달라지므로 예측할 래퍼가 ERC-20인지 ERC-223인지 _isERC20 인자로 지정해야 합니다. 라셔널에 따르면 ERC-223 원본 토큰에 ERC-20 래퍼를 만들어 주는 양방향 설계를 택했는데, ERC-223으로 처음 배포한 개발자도 지원하고 탈중앙 거래소가 두 버전을 유효한 쌍으로 인식하게 하기 위해서입니다.
1:1 변환 규칙
변환기는 ERC-20 예치를 받으면 같은 수량의 ERC-223 토큰을 보내야 합니다(MUST). ERC20 token_A를 1234단위 예치하면 정확히 1234단위의 ERC223 token_A를 받습니다. 이때 ERC-223 토큰은 예치 시점에 새로 발행되고 원본 ERC-20은 변환기에 동결되어 나중에 되찾을 수 있어야 합니다. 반대로 ERC-223 예치를 받으면 보관 중인 원본 ERC-20을 1:1로 풀어 주며 받은 ERC-223 래퍼는 소각해야 합니다. ERC-223 래퍼를 ERC-20으로 되돌리는 별도 함수는 없으며 이 로직은 변환기의 tokenReceived 함수 안에 구현되어 있습니다.
래퍼 생성과 표준 미검증
createERC223Wrapper와 createERC20Wrapper는 래퍼가 없을 때만 새로 만들고 이미 있으면 되돌립니다. 래퍼에 대한 래퍼는 만들 수 없습니다. 이 함수들은 입력 토큰의 표준을 검증하지 않습니다. 특정 표준 구현을 보장할 신뢰할 만한 검사 방법이 없기 때문이며 그 결과 ERC-223 원본에 ERC-223 래퍼를 만드는 것 같은 조합도 가능합니다. 변환기가 만드는 ERC-223 래퍼는 모두 동일한 코드로, 기존 생태계 호환을 위해 approve와 transferFrom 함수를 구현하고 ERC-20식 Transfer 이벤트도 함께 내보냅니다. 기존 탐색기와 지갑이 전송 내역을 인식하도록 호환성을 우선한 선택입니다.
standard() 함수로 하는 표준 식별
ERC-165는 함수 시그니처만 검사하므로 transfer 내부 로직이 ERC-20식인지 ERC-223식인지 구별할 수 없고 ERC-165 자체를 구현하지 않은 토큰도 많습니다. 그래서 변환기가 배포하는 모든 ERC-223 래퍼는 223을 반환하는 standard() 함수를 구현하고 원본 ERC-223 토큰도 같은 함수로 스스로를 선언할 수 있다고 가정합니다. 이 함수가 없으면 ERC-20으로 간주합니다. 원문은 이 방식이 ERC-165보다 정밀한 표준 식별 방법이라고 설명합니다. 다만 원문 내에서 반환 타입 표기는 곳에 따라 bytes32, uint32, string으로 서로 다르게 적혀 있습니다.
직접 전송된 토큰의 구제
ERC-20 토큰은 transfer로 아무 컨트랙트에나 보낼 수 있고 받는 쪽은 이를 인식하지 못하므로, 변환기는 wrapERC20toERC223으로 정식 예치된 수량을 따로 기록해야 합니다. extractStuckERC20 함수는 토큰 컨트랙트의 balanceOf(address(this)) 값에서 기록된 예치량을 뺀 차액, 즉 실수로 직접 전송된 수량을 꺼낼 수 있게 해 사용자가 토큰을 영구히 잃는 일을 막습니다. 참조 구현에서는 지정된 추출자 주소만 이 함수를 호출할 수 있고 래퍼 컨트랙트에도 비슷한 목적의 rescueERC20 함수가 있습니다.
approve·transferFrom을 둘러싼 주의
ERC-223에서는 transfer만으로 컨트랙트에 예치할 수 있어 approve와 transferFrom이 불필요하지만 콜백 없이 토큰을 받는 것을 전제로 만들어진 멀티시그 등 기존 컨트랙트와의 호환을 위해 래퍼에 포함되었습니다. 다만 transferFrom은 오류 처리를 지원하지 않아 자기 자신에게 approve한 뒤 transferFrom으로 토큰을 받도록 설계되지 않은 컨트랙트에 넣으면 토큰이 영구히 갇힐 수 있습니다. 원문은 ERC-223 토큰에서는 가능한 한 approve·transferFrom 방식 전송을 피하라고 명시합니다.
제안 상태: Review
이 제안의 상태는 Review입니다. 아직 확정된 표준이 아니며 검토 과정에서 내용이 바뀔 수 있습니다. 원문은 배포된 변환기 주소를 본문에 명시해 신뢰 문제를 해소하겠다고 밝히고 있으나 현재 본문에 주소는 아직 적혀 있지 않습니다.
쓸 때 주의할 점
- ERC-20 직접 전송으로 인한 손실: ERC-20 토큰은 transfer로 아무 컨트랙트에나 직접 보낼 수 있고 받는 쪽이 이를 인식할 수 없어 영구 손실로 이어질 수 있습니다. ERC-20 래퍼 토큰도 같은 문제에 노출되며 이를 위해 rescueERC20 함수가 구현되어 있습니다.
- approve와 transferFrom은 별개 트랜잭션: 변환기는 approve와 transferFrom 방식 예치에 의존합니다. 두 호출은 별개의 트랜잭션이므로 transferFrom에 의존하기 전에 approve가 성공했는지 반드시 확인해야 합니다.
- 무제한 승인 관행의 위험: UI 서비스가 사용자에게 무제한 approve를 요구하는 것이 흔한 관행이지만 이는 사용자 자금을 위험에 빠뜨리므로 권장되지 않습니다.
- 표준 식별 불가와 하이브리드 토큰: 토큰이 특정 표준을 구현했다고 보장할 신뢰할 만한 검사 방법은 없습니다. ERC-20처럼 보이면서 ERC-223식 transfer 로직을 가진 하이브리드 토큰도 만들 수 있어 변환기에 ERC-223 래퍼가 있다는 사실이 원본의 ERC-20 완전 호환을 뜻하지는 않습니다.
- 소각·감소형 토큰은 사용 금지: 변환기는 보관 중인 원본 잔액이 저절로 줄지 않는다고 가정합니다. 소각 로직이나 공급 감소가 변환기 잔액에 영향을 줄 수 있는 토큰은 변환에 필요한 수량을 항상 보장할 수 없으므로 변환기로 대체 버전을 만들면 안 됩니다.