ERC-6960 듀얼 레이어 토큰(DLT) (Dual Layer Token)

Draft · NFT·멀티토큰 · 2023-04-30 작성

하나의 컨트랙트에서 토큰을 mainId(주 자산 유형)와 subId(세부 속성·변형)의 두 단계로 분류해 관리하는 표준입니다. 실물자산의 분할 소유처럼 세부 구분이 필요한 자산을 체계적으로 다룰 수 있게 합니다.

왜 필요한가

기존 멀티토큰 표준인 ERC-1155는 이더리움 생태계에서 널리 쓰이지만 토큰에 여러 단계의 분류가 필요한 경우에는 설계상 한계가 있습니다. 특히 실물자산(RWA, Real World Assets)을 토큰으로 만들고 그 소유권을 여러 조각으로 나누는 상황이 그렇습니다. 예를 들어 인보이스, 회사 주식, 디지털 수집품, 부동산 같은 자산은 하나의 큰 범주 아래 서로 다른 속성을 가진 세부 항목이 여럿 존재하는데, 한 단계의 ID만으로는 이런 구조를 정리해 담기 어렵습니다. 이 표준은 주 자산을 가리키는 mainId와 그 아래 세부 항목을 가리키는 subId라는 두 단계 분류를 도입해 토큰 종류를 더 세밀하게 조직하고 추적할 수 있게 하자는 제안입니다. 또한 대체가능(fungible) 자산과 대체불가능(non-fungible) 자산을 같은 컨트랙트 안에서 함께 관리할 수 있게 합니다.

구현해야 하는 것

심층 설명

mainId와 subId의 이중 분류 구조

이 표준은 ERC-20, ERC-721, ERC-1155의 기능을 결합하면서 분류 계층을 하나 더 얹습니다. mainId는 주 자산 유형의 식별자이고 subId는 그 주 자산의 고유 속성이나 변형을 가리킵니다. 하나의 주 자산(1층)이 여러 하위 자산(2층)으로 나뉘는 계층 구조라서 이름도 듀얼 레이어입니다. 각 계정에 대해 주 자산의 mainBalance와 하위 자산의 subBalance를 각각 추적할 수 있습니다. 원문은 이 구조로 분할 소유를 표현할 수 있는 자산의 예로 인보이스, 회사 주식, 디지털 수집품, 부동산을 듭니다. subId 운용 방식은 두 가지로 확장할 수 있는데, 모든 mainId가 같은 subId 집합을 공유하는 Shared SubIds 방식과 mainId마다 고유한 subId 집합을 갖는 Mixed SubIds 방식입니다.

전송 규칙과 이벤트

safeTransferFrom은 허용 한도(allowance) 방식으로 sender의 토큰 amount만큼을 recipient로 옮기고 그만큼 호출자의 한도에서 차감합니다. sender나 recipient가 0 주소이면 반드시 되돌려야(revert) 하고 보유자의 해당 subId 잔액이 보내려는 amount보다 적어도 반드시 되돌려야 합니다. 성공 시 Transfer 이벤트를 반드시 발생시켜야 하며 반환값으로 성공 여부를 bool로 알립니다. 배열 단위 전송이 일어날 때는 TransferBatch 이벤트를 반드시 발생시켜야 합니다. data 매개변수는 형식이 정해지지 않은 추가 데이터입니다. 명세의 MUST, SHOULD 등 요구 수준 용어는 RFC 2119와 RFC 8174의 정의를 따릅니다.

두 종류의 승인 체계

승인은 두 수준으로 나뉩니다. approve는 특정 (mainId, subId) 조합에 대해 운영자(operator)가 쓸 수 있는 수량 한도를 설정합니다. operator는 호출자 자신이어서는 안 되고, 0 주소이면 반드시 되돌려야 하며 성공 시 Approval 이벤트를 반드시 발생시켜야 합니다. setApprovalForAll은 호출자가 가진 모든 subId 토큰에 대한 전송 권한을 운영자에게 통째로 주거나 회수하며 ApprovalForAll 이벤트를 반드시 발생시켜야 합니다. 남은 한도는 allowance로 조회하는데 이 값은 approve나 transferFrom 호출 시 바뀌고 기본값은 0입니다. 전체 승인 상태는 isApprovedForAll로 확인합니다.

잔액 조회 함수

subBalanceOf는 특정 계정이 특정 mainId와 subId 조합으로 보유한 토큰 수량을 돌려줍니다. balanceOfBatch는 계정 배열, mainId 배열, subId 배열을 받아 여러 잔액을 한 번의 호출로 배열로 돌려줍니다. 참조 구현은 잔액 저장에 mapping(uint256 mainId => mapping(address => mapping(uint256 subId => uint256))) 형태의 중첩 매핑을 사용해 어떤 (계정, mainId, subId) 조합이든 O(1)로 조회할 수 있게 합니다. 허용 한도도 같은 패턴에 지출자(spender) 차원을 하나 더해 저장합니다.

수신 컨트랙트 인터페이스 DLTReceiver

스마트 컨트랙트가 이 표준의 전송을 받으려면 DLTReceiver 인터페이스의 모든 함수를 반드시 구현해야 합니다. safeTransferFrom으로 토큰이 컨트랙트에 전송되면 단일 전송은 onDLTReceived가, 배열 전송은 onDLTBatchReceived가 호출됩니다. 두 함수 모두 전송을 확정하려면 자신의 Solidity 셀렉터를 반드시 반환해야 하고 다른 값이 반환되거나 수신자가 인터페이스를 구현하지 않았다면 반드시 되돌려야 합니다. 셀렉터는 Solidity에서 IDLTReceiver.onDLTReceived.selector로 얻을 수 있습니다. 이 장치는 토큰을 처리할 수 없는 컨트랙트로 토큰이 들어가 묶이는 일을 막는 역할을 합니다.

메타데이터 URI 이벤트

주 자산 유형별 메타데이터는 URI 이벤트로 알립니다. 특정 mainId의 URI가 갱신되면 이전 값(oldValue)과 새 값(newValue), 해당 mainId를 담은 URI 이벤트를 반드시 발생시켜야 합니다. URI는 RFC 3986에 정의된 형식을 따르고 DLT Metadata URI JSON Schema에 맞는 JSON 파일을 가리켜야 합니다. 메타데이터가 subId 단위가 아니라 mainId 단위로 묶인다는 점이 이 표준의 분류 구조와 맞물리는 부분입니다.

설계 결정: 왜 2단계이고 왜 독립 구현인가

원문 Rationale은 설계 과정의 질문 세 가지를 밝힙니다. 첫째, 분류를 2단계로 제한한 이유입니다. 구현은 각 하위 자산의 총공급량을 매핑으로 추적하는데, 하위 자산이 다시 자식을 갖게 허용하면 각 하위 자산을 추적할 추가 메서드가 필요해져 비실용적이고 컨트랙트가 복잡해집니다. 둘째, ERC-1155를 확장하지 않은 이유입니다. ERC-1155는 계층 분류를 지원하도록 설계되지 않아 상당한 수정이 필요하므로, 확장보다 독립 구현이 적합하다고 판단했습니다. 셋째, 이름은 주 자산이 여러 하위 자산으로 나뉘는 계층 구조를 반영해 듀얼 레이어 토큰으로 정했습니다. 하위 호환성 문제는 발견되지 않았다고 적고 있습니다.

제안 상태: Draft

이 제안은 아직 Draft(초안) 상태입니다. 내용이 앞으로 바뀔 수 있고 확정된 표준이 아니라는 뜻입니다. 원문에는 IDLT와 IDLTReceiver 인터페이스, 핵심 토큰 컨트랙트 DLT.sol로 구성된 참조 구현이 제공되며 발행과 소각, 배열 전송, 승인 흐름, 0 주소 검증, type(uint256).max를 쓰는 무제한 승인 패턴 등을 다루는 테스트 묶음이 포함되어 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs