ERC-7621 바스켓 토큰 (Basket Token)

Draft · 금고·DeFi · 2024-02-11 작성

여러 ERC-20 토큰을 목표 가중치로 묶어 하나의 토큰으로 만드는 표준입니다. 바스켓 토큰 보유자는 담긴 자산 전체에 비례 지분을 가지며 지정된 소유자가 구성과 비중을 조정할 수 있습니다.

왜 필요한가

지수 펀드처럼 여러 토큰을 정해진 비율로 담아 운용하는 상품을 만들려는 프로젝트는 지금까지 각자 다른 방식의 컨트랙트를 만들어 왔습니다. 단일 자산 금고 표준인 ERC-4626이나 이를 여러 입구로 확장한 ERC-7575가 있지만 운용자가 구성 토큰과 목표 비중을 바꿔 가며 관리하는 가중치 바스켓은 두 표준 어디에도 맞지 않습니다. 표준이 없으니 지갑, 애그리게이터, DeFi 프로토콜은 바스켓 상품마다 따로 연동 작업을 해야 합니다. 이 표준은 자산을 넣고 지분을 받는 기여, 지분을 태우고 자산을 비례로 돌려받는 인출, 구성과 목표 비중의 조회, 소유자의 리밸런싱(rebalancing, 구성 재조정)을 하나의 공통 인터페이스로 정의합니다. 바스켓 컨트랙트 자체가 ERC-20 토큰이므로 기존 토큰 인프라와 그대로 호환됩니다.

구현해야 하는 것

심층 설명

필수 인터페이스와 기본 구조

준수 컨트랙트는 ERC-20과 메타데이터 확장(name, symbol, decimals), ERC-165, ERC-173, IERC7621을 모두 구현해야 합니다. 컨트랙트의 ERC-20 공급량 자체가 지분이며 보유자는 바스켓 적립금에 대한 비례 청구권을 가집니다. 컨트랙트 하나가 정확히 바스켓 하나를 관리합니다. ERC-165로 IERC7621 식별자 0xc9c80f73과 ERC-173 식별자 0x7f5828d0에 true를 반환해야 합니다. 가스 없는 승인을 위한 EIP-2612 구현은 선택 사항입니다.

가중치는 베이시스 포인트로 표현된 목표치

가중치는 베이시스 포인트(10000 = 100%)로 표현하고 전체 합이 반드시 10000이어야 합니다. 가중치 0인 구성 토큰은 허용되지 않으며 대신 제거해야 합니다. 가중치는 정보성 목표일 뿐 현재 적립금 비율을 보장하지 않습니다. 실제 적립금은 리밸런스 사이, 기여와 인출 중에 목표에서 벗어날 수 있습니다. getConstituents()는 목표 가중치를, getReserve()는 구현이 인정하는 회계상 적립금을 반환하며 내부 회계를 쓰는 구현에서는 getReserve()가 실제 balanceOf(address(this))와 다를 수 있습니다.

기여 메커니즘과 가치 평가

contribute의 amounts 배열은 getConstituents 순서를 따라야 하고 호출 전에 각 구성 토큰의 approve가 필요합니다. 배열 길이가 totalConstituents()와 다르면 LengthMismatch, 전부 0이면 ZeroAmount, 발행 지분이 minShares 미만이면 InsufficientShares로 되돌립니다. 더 많이 기여했는데 지분이 줄어드는 일이 없도록 발행량은 기여량에 대해 단조 비감소여야 하고 반올림은 바스켓에 유리하게 내림합니다. 구현은 적립금을 전체 가치로 환산하는 결정적 가치 평가 함수를 정의해 totalBasketValue()로 보고해야 하며 지분 발행은 이 전체 가치 대비 기여 가치에 비례해야 합니다. 평가 방식 자체(잔액 합산, 오라클, 시간가중 가격 등)는 표준이 정하지 않습니다.

인출 메커니즘

인출 수량은 소각 지분에 비례하며 구성 토큰별로 amount_i = reserve_i * lpAmount / totalSupply 공식을 따르고 내림으로 반올림합니다. lpAmount가 0이면 ZeroAmount로, 호출자 보유 지분이 부족하면 되돌리고 minAmounts 길이가 구성 수와 다르면 LengthMismatch, 어느 토큰이라도 반환량이 minAmounts 미만이면 InsufficientAmount로 되돌립니다. totalSupply()가 0이면 withdraw는 반드시 되돌립니다. 재진입을 막기 위해 지분 소각이 구성 토큰 전송보다 먼저 일어나야 합니다.

rebalance의 표준화된 의미

rebalance는 ERC-173의 owner()만 호출할 수 있고 배열 길이 불일치는 LengthMismatch, 가중치 합이 10000이 아니면 InvalidWeights, 중복 주소는 DuplicateConstituent, 영주소는 ZeroAddress로 되돌리며 Rebalanced 이벤트를 발생시켜야 합니다. 표준화된 효과는 구성 집합과 목표 가중치의 갱신뿐입니다. 실제 자산을 새 가중치에 맞춰 교환하는지는 구현의 몫이므로, 통합자는 rebalance 호출만으로 적립금이 새 가중치와 일치한다고 가정해서는 안 됩니다. 소유권을 transferOwnership(address(0))으로 포기하면 rebalance는 영구히 호출할 수 없게 되므로, 잠김을 막으려는 구현은 포기 동작을 제한하는 것이 권장됩니다. 소유권 변경이 지분 보유자의 청구권에 영향을 주어서는 안 됩니다.

초기화 규칙과 엣지 케이스

totalSupply()가 0인 빈 바스켓에서는 결정적 초기화 규칙으로 지분을 발행해야 하고 그 규칙은 같은 상태의 previewContribute와 동일해야 하며 호출자에 따라 달라져서는 안 됩니다. 첫 예치자 인플레이션 공격을 막기 위해 데드 셰어나 가상 셰어 같은 완화책이 권장됩니다. previewContribute와 previewWithdraw는 입력이 0이면 되돌리지 않고 0을 반환해야 하고 getReserve는 구성 토큰이 아닌 주소에 0을 반환하며 getWeight는 구성 토큰이 아니면 NotConstituent로 되돌립니다.

표준이 다루지 않는 범위와 제안 상태

이 표준은 리밸런싱 중의 스왑 실행과 라우팅, 오라클 설계와 가격 산정 방식, 수수료 모델, 구현 간 가치 비교, 다중 바스켓 조회 레지스트리, 지분 토큰을 외부로 분리한 구조는 다루지 않습니다. totalBasketValue()는 해당 구현의 회계 모델 안에서만 의미가 있습니다. 이 제안은 현재 Draft 상태이므로 내용이 앞으로 바뀔 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs