ERC-7621 바스켓 토큰 (Basket Token)
Draft · 금고·DeFi · 2024-02-11 작성
여러 ERC-20 토큰을 목표 가중치로 묶어 하나의 토큰으로 만드는 표준입니다. 바스켓 토큰 보유자는 담긴 자산 전체에 비례 지분을 가지며 지정된 소유자가 구성과 비중을 조정할 수 있습니다.
왜 필요한가
지수 펀드처럼 여러 토큰을 정해진 비율로 담아 운용하는 상품을 만들려는 프로젝트는 지금까지 각자 다른 방식의 컨트랙트를 만들어 왔습니다. 단일 자산 금고 표준인 ERC-4626이나 이를 여러 입구로 확장한 ERC-7575가 있지만 운용자가 구성 토큰과 목표 비중을 바꿔 가며 관리하는 가중치 바스켓은 두 표준 어디에도 맞지 않습니다. 표준이 없으니 지갑, 애그리게이터, DeFi 프로토콜은 바스켓 상품마다 따로 연동 작업을 해야 합니다. 이 표준은 자산을 넣고 지분을 받는 기여, 지분을 태우고 자산을 비례로 돌려받는 인출, 구성과 목표 비중의 조회, 소유자의 리밸런싱(rebalancing, 구성 재조정)을 하나의 공통 인터페이스로 정의합니다. 바스켓 컨트랙트 자체가 ERC-20 토큰이므로 기존 토큰 인프라와 그대로 호환됩니다.
구현해야 하는 것
event Rebalanced(address[] newTokens, uint256[] newWeights);: 구성 토큰 집합이나 가중치가 바뀔 때 반드시 발생하는 이벤트입니다. 새 구성 토큰 주소와 새 목표 가중치를 기록합니다.function getConstituents() external view returns (address[] memory tokens, uint256[] memory weights);: 구성 토큰 주소들과 각각의 목표 가중치(베이시스 포인트, 합계 10000)를 반환합니다. 반환 순서는 rebalance 호출 사이에 안정적으로 유지됩니다.function totalConstituents() external view returns (uint256 count);: 구성 토큰의 개수를 반환합니다.function getReserve(address token) external view returns (uint256 balance);: 지분 회계에 인정되는 해당 구성 토큰의 적립금을 반환합니다. 내부 회계를 쓰는 구현에서는 실제 balanceOf와 다를 수 있습니다.function getWeight(address token) external view returns (uint256 weight);: 특정 구성 토큰의 목표 가중치를 베이시스 포인트로 반환합니다. 구성 토큰이 아니면 NotConstituent로 되돌립니다.function isConstituent(address token) external view returns (bool);: 해당 주소가 현재 구성 토큰인지 여부를 반환합니다.function totalBasketValue() external view returns (uint256 value);: 구현이 정한 회계 단위로 바스켓 전체 가치를 반환합니다. 결정적이어야 하고 previewContribute와 일관되어야 하며 서로 다른 구현 사이에서 비교할 수 없습니다.function contribute(uint256[] calldata amounts, address receiver, uint256 minShares) external returns (uint256 lpAmount);: 구성 토큰들을 예치하고 receiver에게 지분을 발행합니다. 발행 지분이 minShares보다 적으면 되돌립니다.function withdraw(uint256 lpAmount, address receiver, uint256[] calldata minAmounts) external returns (uint256[] memory amounts);: 지분을 소각하고 적립금을 비례로 receiver에게 보냅니다. 어느 토큰이라도 minAmounts보다 적게 돌려주게 되면 되돌립니다.function rebalance(address[] calldata newTokens, uint256[] calldata newWeights) external;: 구성 토큰 집합과 목표 가중치를 갱신합니다. ERC-173의 owner()만 호출할 수 있습니다.function previewContribute(uint256[] calldata amounts) external view returns (uint256 lpAmount);: 주어진 수량을 예치하면 발행될 지분을 추정합니다. 같은 트랜잭션에서 contribute가 반환할 값과 같아야 합니다.function previewWithdraw(uint256 lpAmount) external view returns (uint256[] memory amounts);: 지분을 소각하면 돌려받을 구성 토큰 수량을 추정합니다. 같은 트랜잭션에서 withdraw가 반환할 값과 같아야 합니다.
심층 설명
필수 인터페이스와 기본 구조
준수 컨트랙트는 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 상태이므로 내용이 앞으로 바뀔 수 있습니다.
쓸 때 주의할 점
- 재진입 공격: contribute, withdraw, rebalance는 외부 ERC-20 컨트랙트를 호출합니다. 재진입 가드나 검사-효과-상호작용 순서를 반드시 지켜야 하며 특히 withdraw에서는 지분 소각이 토큰 전송보다 먼저 일어나야 합니다.
- 첫 기여자의 환율 조작: 빈 바스켓의 첫 기여자는 초기 지분 대 적립금 환율을 통제해 이후 기여자의 가치를 빼앗을 수 있습니다. ERC-4626에서 알려진 인플레이션 공격과 같으며 데드 주소로 최소 지분을 발행하거나 가상 셰어를 쓰는 것이 권장됩니다.
- 리밸런싱 프런트러닝: 리밸런싱 트랜잭션은 멤풀에서 보이므로 의도한 가중치 변경이 노출되고 rebalance 중 스왑을 실행하는 구현은 샌드위치 공격을 당할 수 있습니다. 프라이빗 멤풀, 커밋-리빌, 서명 검증을 쓴 오프체인 라우팅과 슬리피지 제한이 권장됩니다.
- 소유자에 대한 신뢰: 지분 보유자는 소유자가 책임 있게 리밸런싱한다고 신뢰해야 합니다. 소유자는 구성 토큰을 유동성이 없거나 가치 없는 토큰으로 바꾸거나 불리한 가격에 리밸런싱을 일으킬 수 있습니다. 타임락, 거버넌스 투표, 최대 슬리피지 제약으로 이 신뢰 가정을 줄일 수 있지만 표준이 요구하지는 않습니다.
- 전송이 막히는 구성 토큰: 블랙리스트나 일시정지 같은 전송 제한 기능이 있는 구성 토큰은 바스켓 인출 전체를 멈출 수 있습니다. 구성 토큰 하나라도 전송이 불가능하면 모든 보유자의 withdraw가 되돌려지므로, 허용 목록 유지나 전송 불가 토큰을 건너뛰는 부분 인출 메커니즘을 고려하는 것이 권장됩니다.