ERC-7629 ERC-20/721 통합 토큰 인터페이스 (ERC-20/ERC-721 Unified Token Interface)

Draft · 토큰 · 2024-02-18 작성

하나의 컨트랙트가 ERC-20의 유동성과 ERC-721의 고유성을 함께 갖도록, 두 표준의 기능을 단일 인터페이스로 묶고 두 모드 사이 전환 기능을 정의한 표준입니다.

왜 필요한가

이더리움에는 서로 바꿔 쓸 수 있는 토큰 표준(ERC-20)과 하나하나가 고유한 NFT 표준(ERC-721)이 따로 있습니다. 지금은 이 둘이 완전히 분리되어 있어서 쪼개서 사고팔기 쉬운 유동성과 고유한 소유권이라는 두 특성을 모두 원하는 자산을 만들려면 둘 중 하나를 골라야 합니다. 개발자도 토큰 종류마다 다른 함수와 로직을 따로 구현해야 해서 통합 작업이 번거롭고 앱 사이의 상호 운용성도 떨어집니다. 이 표준은 두 토큰 유형에 공통으로 쓰이는 함수 집합을 하나의 인터페이스로 정의하고 ERC-20 상태와 ERC-721 상태를 오가는 전환을 지원해서 이 공백을 메우려고 합니다.

구현해야 하는 것

심층 설명

하나의 컨트랙트에 두 표준을 결합

이 표준을 따르는 컨트랙트는 ERC-20과 ERC-721의 기능을 한 컨트랙트에 함께 구현하고 제시된 IERC7629 인터페이스를 반드시(MUST) 구현해야 합니다. 인터페이스는 IERC165를 상속하며 두 표준의 전송·승인·조회 함수와 전환 함수, 관련 이벤트를 모두 담습니다. ERC-20 모드에서는 일반 ERC-20 전송과 비슷한 수준의 낮은 가스 소비를 구현하도록 명시하고 있습니다. requires 필드에 ERC-20, ERC-165, ERC-721이 올라 있습니다.

amountOrId: 하나의 인자로 수량과 토큰 ID를 겸용

approve(spender, amountOrId)와 transferFrom(from, to, amountOrId)는 인자 하나로 두 표준을 겸합니다. 값이 ERC-20 수량으로 해석되면 수량 승인·전송이 되고 ERC-721 토큰 ID로 해석되면 해당 NFT의 승인·전송이 됩니다. 반면 transfer(to, amount)는 ERC-20 전용, safeTransferFrom 두 종류는 ERC-721 전용으로 분리되어 있습니다. safeTransferFrom은 받는 주소가 컨트랙트(코드 크기 > 0)면 onERC721Received를 호출해 정해진 반환값이 아니면 실패하도록 명세되어 있습니다.

모드 전환: erc20ToERC721과 erc721ToERC20

erc20ToERC721(amount)는 지정한 수량의 ERC-20 토큰을 ERC-721 토큰으로 바꾸고 erc721ToERC20(tokenId)는 NFT 하나를 ERC-20 토큰으로 되돌립니다. getUnit()은 토큰에 연결된 단위 값을 돌려주는 조회 함수입니다. 전환은 ERC20ToERC721 이벤트로 알리는데, 원문 인터페이스에는 같은 이름의 이벤트가 두 개 선언되어 있고 두 번째(uint256[] tokenIds를 담는 쪽)는 주석상 ERC-721에서 ERC-20으로 전환하는 용도로 표시되어 있습니다.

잔액 조회의 이중화와 하위 호환성

ERC-20의 balanceOf는 수량 잔액을, ERC-721의 balanceOf는 보유 토큰 개수를 돌려주므로 같은 이름이 서로 다른 의미로 쓰입니다. 원문은 이것을 하위 호환성의 핵심 충돌 지점으로 꼽고 표준별 관례에 맞춘 별도 함수를 두는 방안을 제시합니다. 인터페이스에는 erc20BalanceOf, erc721BalanceOf, erc20TotalSupply, erc721TotalSupply가 따로 있고 공용 balanceOf와 totalSupply는 주석상 ERC-20 기준으로 기술되어 있습니다. owned(owner)는 주소가 가진 NFT ID 배열을 돌려주는 보조 조회 함수입니다.

설계 근거: 공통 함수로 파편화 해소

원문 Rationale은 transferFrom, mint, burn 같은 함수를 표준화해 개발자가 토큰 유형별로 다른 로직을 구현하지 않아도 되게 하는 것을 목표로 듭니다. 토큰 공급과 수명 주기 관리를 위한 mint·burn, 잔액·소유권 조회를 위한 balanceOf·ownerOf를 핵심 구성으로 설명하고 기존 ERC-20·ERC-721 구현과의 호환성과 향후 함수·이벤트 확장 가능성도 언급합니다. 다만 mint와 burn은 Rationale에서 언급될 뿐 인터페이스 코드에는 선언되어 있지 않습니다.

Draft 단계의 제안

이 문서는 2024년 2월 18일에 만들어진 Draft 상태의 제안입니다. 아직 내용이 바뀔 수 있고 확정된 표준이 아니므로, 구현하거나 통합할 때는 최신 원문을 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs