ERC-5115 표준화 수익 토큰(SY) (SY Token)

Draft · 금고·DeFi · 2022-05-30 작성

이자나 보상이 쌓이는 수익 자산을 감싸서 입금, 환매, 환율 조회를 하나의 표준 인터페이스로 다룰 수 있게 하는 ERC-20 확장 표준입니다. ERC-4626이 담지 못하는 LP 토큰 같은 자산까지 포괄하는 것을 목표로 합니다.

왜 필요한가

이더리움에는 맡겨 두면 이자나 보상이 쌓이는 수익 자산이 많습니다. 대출 예치, 유동성 공급, 스테이킹 등 방식이 제각각이라, 다른 프로토콜의 수익 구조 위에 서비스를 만들려면 매번 수동으로 연동 작업을 해야 합니다. 금고(vault) 표준인 ERC-4626이 이 파편화를 상당 부분 해결했지만 모든 수익 구조를 담지는 못합니다. 예를 들어 자동화 마켓 메이커(AMM)의 유동성 토큰은 풀의 가치가 유동성 단위로 측정되는데, 이 단위는 토큰이 아니라서 직접 예치할 수 없습니다. 입금에 쓰는 토큰과 풀 가치를 재는 기준이 서로 다른 자산, 컴파운드의 COMP처럼 기본적으로 별도 보상 토큰이 나오는 자산도 범위 밖에 있습니다. 이 표준은 이런 자산까지 감싸서 하나의 인터페이스로 다룰 수 있게 하여, 여러 형태의 수익 자산과 상호작용할 때 맞춤형 어댑터 사용을 최소화하거나 없애는 것을 목표로 합니다.

구현해야 하는 것

심층 설명

GYGP 모델: 모든 수익 구조를 하나의 틀로

명세는 먼저 범용 수익 생성 풀(Generic Yield Generating Pool, GYGP) 모델을 정의합니다. 풀의 가치는 asset 단위로 재고 풀의 소유권은 shares 단위로 나눕니다. 시간이 지나면 풀의 가치가 늘어 지분 하나가 더 많은 자산 가치를 갖게 되고 그 비율이 ExchangeRate(t) = TotalAsset(t) / TotalShares(t)입니다. 풀은 n_rewards 종류(0개 이상)의 보상 토큰을 벌 수 있고 일정한 규칙(예: 지분 비례)에 따라 사용자에게 분배됩니다. 원문은 컴파운드의 cUSDC, 리도의 wstETH, 스시스왑 LP 토큰 등 이 모델에 들어맞는 사례를 표로 제시합니다. SY 토큰 하나는 GYGP의 shares를 나타내며 표준 인터페이스로 그 풀과 상호작용하게 합니다.

ERC-20 요건과 선택 사항

모든 SY 토큰은 기초 GYGP의 지분을 나타내기 위해 ERC-20을 반드시 구현해야 하고 balanceOf, transfer, totalSupply 등은 지분 단위로 동작해야 합니다. 메타데이터 확장인 name, symbol, decimals도 반드시 구현해야 하며 기초 풀의 회계 자산을 반영해야 합니다. 승인 UX를 개선하기 위해 ERC-2612를 구현할 수 있고 양도 불가능한 SY로 만들려면 transfer와 transferFrom 호출을 되돌리게 할 수도 있습니다. 통합 감지를 위해 ERC-165를 선택적으로 구현할 수 있습니다.

deposit: 두 가지 입금 경로

deposit은 amountTokenToDeposit만큼의 tokenIn을 자산으로 변환해 풀에 넣고 receiver에게 SY 지분을 발행합니다. depositFromInternalBalance가 false면 호출자가 먼저 입금 토큰을 SY 컨트랙트에 보내 둔 상태에서 변환이 일어나고 true면 호출자에게서 직접 토큰을 가져옵니다. 받는 지분 amountSharesOut이 minSharesOut보다 적으면 반드시 되돌려야 합니다(입금 한도 도달, 슬리피지, 승인 부족 등). Deposit 이벤트를 반드시 기록해야 하고 ERC-20의 approve/transferFrom 흐름을 지원해야 합니다. tokenIn이 체인의 기본 통화(예: ETH)라면 payable로 만들 수 있습니다.

redeem: 지분을 출력 토큰으로

redeem은 d_s 지분을 환율에 따라 d_a = d_s × ExchangeRate(t)만큼의 자산으로 계산해 풀에서 빼고 이를 tokenOut으로 변환해 지급합니다. burnFromInternalBalance가 false면 사용자가 먼저 지분을 SY 컨트랙트에 넣어 두고 컨트랙트 안의 유동 수량을 태우는 방식으로, 원문은 이것이 유니스왑V2와 비슷한 가스 효율적 패턴이라고 설명합니다. true면 사용자에게서 직접 지분을 태웁니다. 받는 토큰이 minTokenOut보다 적으면 반드시 되돌려야 하고 Redeem 이벤트를 반드시 기록해야 합니다.

exchangeRate의 정밀도와 수수료 규칙

exchangeRate는 SY 토큰 수량을 자산 수량으로 바꾸는 최신 환율을 갱신해 반환하며 1e18의 고정 배율로 스케일됩니다. ExchangeRate(t_now) × syBalance / 1e18 = assetBalance가 성립해야 합니다. SY 컨트랙트 안에서 기초 수익 토큰에 부과되는 수수료는 이 값에 포함하면 안 됩니다. 통합하는 쪽은 이 함수 하나로 지분의 자산 가치를 일관되게 계산할 수 있습니다.

입출력 토큰 목록과 yieldToken

getTokensIn은 입금에 쓸 수 있는 토큰 목록을, getTokensOut은 환매로 받을 수 있는 토큰 목록을 반환합니다. 둘 다 ERC-20 주소를 최소 한 개 이상 반환해야 하고 절대 되돌리면 안 됩니다. 입금 토큰과 가치 측정 단위를 분리한 것이 이 표준의 핵심 유연성으로, 예를 들어 ETH 금고가 가스 효율이나 UX를 위해 cETH 직접 입금을 받을 수 있습니다. yieldToken은 감싸고 있는 기초 수익 토큰 주소를 반환하며 감싼 형태라면 정확한 기초 토큰 주소를 반영해야 합니다. 감싸지 않고 자체적으로 GYGP 지분을 구현한 경우에만 0 주소를 반환할 수 있습니다.

preview 함수의 보수적 추정 규칙

previewDeposit은 tokenIn을 입금했을 때 받을 지분을, previewRedeem은 지분을 환매했을 때 받을 tokenOut 수량을 미리 계산합니다. 두 함수 모두 실제 deposit, redeem의 반환값보다 작거나 같은 값을 반환해야 하며 실제 값보다 큰 값을 반환하지 않아야 합니다. 되돌리는 경우는 해당 조건으로 발행이나 소각이 금지될 때(예: 공급 한도 초과)로 한정해야 합니다. 추정치가 실제보다 커 보이지 않게 하여 통합하는 쪽이 안전하게 쓸 수 있도록 한 규칙입니다.

ERC-4626과의 관계

원문은 ERC-4626이 잘 설계된 표준이고 대부분의 금고는 그것을 채택해야 한다고 봅니다. SY는 그 바깥에 있는 자산, 즉 입금 토큰과 회계 단위가 다른 자산(AMM 유동성 토큰 등)과 기본적으로 보상 토큰이 나오는 자산(컴파운드의 COMP 등)까지 감싸기 위한 표준입니다. SY는 ERC-4626 금고 자체를 감쌀 수도 있고 쌓인 여러 보상 토큰의 청구 같은 보상 처리는 SY에서 확장해 다룰 수 있다고 설명합니다. 원문이 드는 사용 사례는 대출 예치, AMM 유동성 공급, 금고, 리퀴드 스테이킹, 유동성 마이닝, 리베이스 토큰 등입니다.

아직 초안 단계입니다

이 제안의 상태는 Draft입니다. 내용이 앞으로 바뀔 수 있고 명세의 함수 서명이나 요구 사항이 확정된 것이 아니므로 구현하거나 통합할 때 최신 원문을 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs