ERC-7681 이중 성격 멀티 토큰 프로토콜 (Dual Nature Multi Token Protocol)
Draft · NFT·멀티토큰 · 2024-04-08 작성
대체 가능 토큰 표준 ERC-20과 멀티 토큰 표준 ERC-1155를 한 컨트랙트에서 함께 구현하고 두 토큰의 잔액을 서로 맞춰 움직이게 하는 결합 표준입니다.
왜 필요한가
이더리움에서 하나의 토큰이 코인처럼 수량으로도, NFT처럼 개별 항목으로도 동작하게 하려는 시도가 있었습니다. 대체 가능 토큰 표준인 ERC-20과 NFT 표준인 ERC-721을 한 컨트랙트에 묶는 ERC-7631이 그 예입니다. 그런데 두 표준은 이름과 형태가 같은 Transfer(address, address, uint256) 이벤트를 각각 정의하고 있어서 한 컨트랙트가 두 표준을 동시에 완전하게 지키기 어렵다는 문제가 있었습니다. 반면 멀티 토큰 표준인 ERC-1155는 이벤트가 ERC-20과 겹치지 않으므로, 두 표준을 모두 온전히 지키면서 하나로 결합할 수 있습니다. 이렇게 하면 ERC-20 토큰을 취득할 때 보유량에 비례해 ERC-1155 토큰이 자동으로 발행되는, NFT 분할 소유(fractionalization) 같은 기능을 컨트랙트 안에서 기본으로 구현할 수 있습니다. ERC-7681은 이 결합 방식과 함께, 동기화 과정에서 ERC-1155 토큰을 받지 않도록 사용자가 선택하는 방법까지 표준으로 정합니다.
구현해야 하는 것
event Transfer(address indexed _from, address indexed _to, uint256 _value);: ERC-20 토큰이 이동할 때 발생하는 이벤트입니다.event Approval(address indexed _owner, address indexed _spender, uint256 _value);: ERC-20 토큰 사용 권한을 다른 주소에 허용할 때 발생하는 이벤트입니다.event TransferSingle(address indexed _operator, address indexed _from, address indexed _to, uint256 _id, uint256 _value);: ERC-1155 토큰 한 종류가 이동할 때 발생하는 이벤트입니다.event TransferBatch(address indexed _operator, address indexed _from, address indexed _to, uint256[] _ids, uint256[] _values);: ERC-1155 토큰 여러 종류가 한 번에 이동할 때 발생하는 이벤트입니다.event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);: ERC-1155 토큰 전체에 대한 운영자 권한을 설정하거나 해제할 때 발생하는 이벤트입니다.event URI(string _value, uint256 indexed _id);: 특정 ID의 ERC-1155 토큰 메타데이터 주소가 바뀔 때 발생하는 이벤트입니다.function name() public view returns (string);: 토큰 이름을 돌려줍니다. 선택 구현 항목입니다.function symbol() public view returns (string);: 토큰 기호를 돌려줍니다. 선택 구현 항목입니다.function decimals() public view returns (uint8);: ERC-20 토큰의 소수 자릿수를 돌려줍니다. 선택 구현 항목입니다.function totalSupply() public view returns (uint256);: ERC-20 토큰의 총발행량을 돌려줍니다.function balanceOf(address _owner) public view returns (uint256);: 특정 주소의 ERC-20 토큰 잔액을 돌려줍니다.function transfer(address _to, uint256 _value) public returns (bool);: 호출자의 ERC-20 토큰을 다른 주소로 보냅니다.function transferFrom(address _from, address _to, uint256 _value) public returns (bool);: 허용받은 범위 안에서 다른 주소의 ERC-20 토큰을 대신 옮깁니다.function approve(address _spender, uint256 _value) public returns (bool);: 다른 주소가 내 ERC-20 토큰을 일정량까지 쓰도록 허용합니다.function allowance(address _owner, address _spender) public view returns (uint256);: 한 주소가 다른 주소의 ERC-20 토큰을 쓸 수 있는 남은 한도를 돌려줍니다.function balanceOf(address _owner, uint256 _id) external view returns (uint256);: 특정 주소가 가진 특정 ID의 ERC-1155 토큰 잔액을 돌려줍니다.function balanceOfBatch(address[] calldata _owners, uint256[] calldata _ids) external view returns (uint256[] memory);: 여러 주소와 여러 ID 조합의 ERC-1155 잔액을 한 번에 조회합니다.function setApprovalForAll(address _operator, bool _approved) external;: 내 모든 ERC-1155 토큰을 다룰 수 있는 운영자 권한을 켜거나 끕니다.function isApprovedForAll(address _owner, address _operator) external view returns (bool);: 어떤 주소가 다른 주소의 ERC-1155 운영자로 승인되어 있는지 확인합니다.function safeTransferFrom(address _from, address _to, uint256 _id, uint256 _value, bytes calldata _data) external;: 특정 ID의 ERC-1155 토큰을 수신 확인 절차와 함께 안전하게 보냅니다.function safeBatchTransferFrom(address _from, address _to, uint256[] calldata _ids, uint256[] calldata _values, bytes calldata _data) external;: 여러 ID의 ERC-1155 토큰을 한 번에 안전하게 보냅니다.event SkipTokenSet(address indexed owner, bool status);: 어떤 주소의 ERC-1155 스킵 상태가 바뀔 때마다 발생하는 이벤트입니다.function getSkipToken(address owner) external view returns (bool);: 해당 주소가 동기화 과정의 ERC-1155 발행과 전송을 건너뛰도록 설정했는지 돌려줍니다.function setSkipToken(bool status) external;: 호출자 자신의 ERC-1155 스킵 상태를 설정합니다.
심층 설명
두 표준의 인터페이스를 모두 구현해야 합니다
모든 ERC-7681 컨트랙트는 ERC20과 ERC1155 인터페이스를 둘 다 구현해야 합니다(MUST). ERC-20 쪽은 totalSupply, balanceOf(address), transfer, transferFrom, approve, allowance가 필수이고 name, symbol, decimals는 선택(MAY)입니다. ERC-1155 쪽은 balanceOf(address, uint256), balanceOfBatch, setApprovalForAll, isApprovedForAll, safeTransferFrom, safeBatchTransferFrom이 필수입니다. 이벤트도 ERC-20의 Transfer와 Approval, ERC-1155의 TransferSingle, TransferBatch, ApprovalForAll, URI를 모두 포함해야 합니다. 같은 이름의 balanceOf가 인자 개수로 구분되어 공존하는 구조입니다.
ERC-721이 아니라 ERC-1155를 결합한 이유
ERC-20과 ERC-721을 연동하는 ERC-7631에서는 두 표준이 똑같은 형태의 Transfer(address, address, uint256) 이벤트를 정의하고 있어 완전한 호환이 어렵다는 과제가 드러났습니다. ERC-1155는 TransferSingle, TransferBatch처럼 이벤트가 겹치지 않으므로 두 표준 모두에 완전히 부합하는 결합이 가능합니다. 그러면서도 ERC-20 토큰을 취득하면 보유량에 비례해 ERC-1155 토큰이 자동 발행되는 식으로, NFT 분할 소유와 비슷한 이점을 기본으로 제공할 수 있습니다. ERC-7631과 마찬가지로 동기화 과정의 ERC-1155 발행과 전송을 사용자가 거부(옵트아웃)하는 것도 허용합니다.
동기화 로직은 일부러 정하지 않았습니다
이 제안은 두 토큰을 어떻게 맞출지에 대한 구체적인 동기화 로직을 의도적으로 규정하지 않습니다. 1대1 동기화를 할 수도 있고 ERC-20 보유량을 기준으로 ERC-1155 토큰을 분할하는 방식도 가능합니다. 구현자는 두 토큰 표준의 명세를 완전히 지키는 한에서 자신의 동기화 전략을 자유롭게 정할 수 있으며 이를 통해 다양한 구현 전략과 새로운 사용 사례를 수용하려는 것입니다.
스킵 인터페이스의 동작 규칙
IERC7681Skippable은 선택 구현(MAY)입니다. getSkipToken(owner)은 동기화 때 그 주소에 대한 ERC-1155 발행과 전송을 건너뛰어야 하는지(SHOULD)를 돌려줍니다. 이 함수는 revert할 수 있지만 한번 특정 owner에 대해 true나 false를 돌려줬다면 그 owner에 대해 다시는 revert해서는 안 됩니다(MUST NOT). revert하는 경우 호출하는 쪽은 setSkipToken 기능이 없는 것으로 보고 관련 기능을 숨기며 그 주소의 스킵 상태는 정해지지 않은 것으로 해석해야 합니다. setSkipToken(status)은 호출자 자신의 스킵 상태를 설정하며 권한 부족 등으로 revert할 수 있습니다. 초기 스킵 상태는 true든 false든 자유롭게 정할 수 있지만 상태가 어떤 방식으로든 바뀔 때는 반드시 SkipTokenSet 이벤트를 내보내야 합니다.
컨트랙트 주소는 기본 스킵이 유리합니다
토큰을 받는 주소가 스마트 컨트랙트인 경우 스킵 상태를 기본값 true로 두면, 탈중앙 거래소(DEX)나 대출 프로토콜 같은 컨트랙트와 상호작용할 때 불필요한 ERC-1155 발행을 막을 수 있습니다. 이런 컨트랙트는 ERC-1155 토큰이 필요 없는 경우가 많으므로 발행을 건너뛰면 가스 비용을 줄일 가능성이 있습니다.
하위 호환성과 제안 상태
이 제안은 기존 ERC-20, ERC-1155 표준과 완전히 하위 호환되므로, 두 표준에 의존하는 기존 컨트랙트는 그대로 동작합니다. 다만 ERC-7681은 2024년 4월 8일에 제출된 Draft(초안) 상태의 제안이므로, 내용이 아직 바뀔 수 있다는 점을 염두에 두어야 합니다.
쓸 때 주의할 점
- 가스 고갈로 인한 서비스 거부: 사용자가 ERC-20 토큰을 전송하면 여러 ERC-1155 토큰의 발행, 전송, 소각이 자동으로 일어날 수 있습니다. 이 때문에 가스 비용이 보통의 ERC-20 전송처럼 고정 비용 O(1)이 아니라 동작 수에 비례해 O(n)으로 늘어날 수 있고 ERC-1155 토큰 ID를 고르는 방식이 가스를 더 키울 수도 있습니다. 동기화 전략은 이런 비용 증가를 감안해 설계해야 가스 고갈로 전송이 막히는 서비스 거부 상황을 피할 수 있습니다.