ERC-7417 토큰 표준 변환기 (Token Converter)

Review · 토큰 · 2023-07-27 작성

ERC-20 토큰을 언제든 1:1 비율로 ERC-223 버전으로 바꾸고 다시 ERC-20으로 되돌릴 수 있는 변환기 컨트랙트를 정의합니다. 하나의 토큰이 두 표준으로 동시에 존재하며 자유롭게 교환됩니다.

왜 필요한가

이더리움에는 여러 토큰 표준이 함께 쓰이지만 서로 호환되지 않습니다. 가장 널리 쓰이는 ERC-20은 이미 생태계가 자리 잡았기 때문에, 새 표준이 나와도 옮겨 갈 정해진 절차가 없어 채택이 막히는 병목이 생깁니다. 토큰 개발자는 배포 시점에 표준 하나를 골라 계속 써야 하고 다른 표준의 장점을 쓰고 싶어도 방법이 없습니다. 게다가 같은 ERC-20이라도 구현 편차가 큽니다. 원문은 transfer 함수의 반환값을 두고 성공 시 true를 반환하고 실패 시 되돌리는 토큰, false를 반환하는 토큰, 반환값이 아예 없는 토큰(대표적으로 USDT)이 섞여 있어 서로 호환되지 않는 현실을 지적합니다. 이 제안은 누구나 기존 토큰의 다른 표준 버전을 만들 수 있는 공용 변환 서비스를 두어 표준을 하나만 고를 필요 없이 두 버전이 공존하고 서로 교환되도록 하는 것을 목표로 합니다.

구현해야 하는 것

심층 설명

두 가지 구성 요소: 변환기와 래퍼

시스템은 변환기(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 원문 · ← ERCs