ERC-7527 함수 오라클 AMM 토큰 래핑 (Token Bound Function Oracle AMM)

Draft · 금고·DeFi · 2023-09-03 작성

ERC-20 토큰이나 ETH를 NFT로 감싸고(랩), NFT를 다시 토큰으로 되돌리는(언랩) 표준입니다. 컨트랙트에 내장된 함수 오라클 AMM이 발행과 소각 가격을 자동으로 정합니다.

왜 필요한가

NFT는 하나하나가 고유한 토큰이라 거래 상대를 찾기 어렵고 유동성이 부족하기 쉽습니다. 팔고 싶어도 사겠다는 사람이 나타날 때까지 기다려야 합니다. 기존 탈중앙 거래소 모델에서는 외부의 유동성 공급자(Liquidity Provider, LP)가 토큰을 풀에 예치해 유동성을 대는데, 이들이 갑자기 빠져나가면 시장에서 쓸 수 있는 유동성이 줄어 큰 변동성이 생깁니다. 이 표준은 미리 정한 수학 식으로 가격을 알려 주는 함수 오라클을 컨트랙트 안에 내장해, 거래 상대 없이도 정해진 가격에 토큰을 NFT로 바꾸고 NFT를 다시 토큰으로 되돌릴 수 있게 합니다. 유동성은 참여자들의 랩과 언랩으로 내부에서 계속 채워지므로 외부 유동성 공급자에 대한 의존과 급작스러운 이탈로 인한 변동성 위험이 줄어듭니다.

구현해야 하는 것

심층 설명

세 인터페이스와 상호 결속

표준은 Agency, App, Factory 세 인터페이스로 구성됩니다. Agency와 App은 같은 컨트랙트로 구현해도 되고 분리해도 되지만 분리 구현하면 서로 결속(mutually bounded)되어야 하고 초기화 후에는 업그레이드할 수 없어야 합니다. App은 onlyAgency() modifier를 구현해 mint와 burn에 적용해야 하며 이로써 발행과 소각은 결속된 Agency를 거친 호출만 효력이 있습니다. Agency의 onlyApp() 구현은 선택입니다. Agency는 모든 mint와 burn 전송의 단일 진입점 역할을 합니다. Rationale은 두 컨트랙트가 서로의 유일한 소유자가 되도록 구현하라고 설명합니다.

wrap과 mint의 동작

wrap을 실행하면 미리 정해 둔 전략 파라미터가 getWrapOracle에 전달되어 현재 프리미엄과 수수료를 받아 옵니다. 프리미엄은 Agency 인스턴스로 전송되고 mintFeePercent에 따른 수수료는 feeRecipient로 전송됩니다. 그 다음 App이 NFT를 사용자 주소로 발행합니다. Agency로 들어간 프리미엄은 언랩 과정 외에는 이동할 수 없고 wrap 실행이 mint를 일으키는 유일한 트리거입니다. 랩할 때마다 고유한 tokenId가 생성되어야 하며 이 ID는 언랩 때 검증 수단이자 토큰의 유일한 증표가 됩니다. 토큰 ID는 mint 함수의 data 파라미터로 지정할 수 있습니다.

unwrap과 burn의 동작

언랩은 NFT의 소유자나 승인받은 주소만 할 수 있습니다. unwrap을 실행하면 전략 파라미터가 getUnwrapOracle에 전달되어 현재 프리미엄과 수수료를 읽어 옵니다. App이 NFT를 소각하고 프리미엄에서 burnFeePercent에 따른 수수료를 뺀 금액이 사용자 주소로 전송되며 수수료는 feeRecipient로 갑니다. unwrap 실행이 burn을 일으키는 유일한 트리거입니다. 참고 구현의 wrap 함수는 발행 후 총공급량이 정확히 1 늘었는지 검사해 재진입을 막습니다.

함수 오라클과 가격 책정

getWrapOracle과 getUnwrapOracle은 함수에 정의된 파라미터와 수학 식을 바탕으로 프리미엄과 수수료를 온체인에서 계산해 알려 줍니다. 덕분에 거래 상대를 맞출 필요 없이 풀과 직접 거래할 수 있습니다. 랩과 언랩 과정에서만 쓰이는 것이 아니라 대출 컨트랙트 같은 다른 컨트랙트도 호출해 가격을 얻을 수 있습니다. 온체인과 오프체인 파라미터 기반의 함수 오라클을 모두 지원할 수 있지만 온체인 현실에 대한 합의를 위해 온체인 파라미터만 쓰기를 권장합니다. 참고 구현은 프리미엄을 basePremium + 판매량 x basePremium / 100으로, 수수료를 premium x 수수료율 / 10000으로 계산합니다.

Asset 구조체와 통화 종류

Agency의 설정은 Asset 구조체에 담깁니다. currency는 대체가능토큰의 주소이고 0이면 ETH를 뜻합니다. basePremium은 기본 프리미엄, feeRecipient는 수수료 수취 주소, mintFeePercent와 burnFeePercent는 각각 발행과 소각 수수료율입니다. 하나의 시스템에서 Asset은 한 종류의 currency만 대체가능토큰으로 정의할 수 있으며 ETH와 ERC-20을 포함한 다양한 대체가능토큰을 지원합니다. 구현자는 통화, 초기 가격, 수수료 수취 주소, 수수료율 등을 원하는 대로 정해 Agency를 초기화할 수 있습니다.

Factory 배포와 초기화 절차

Factory 인터페이스는 선택 사항으로, Agency와 App을 반복해서 배포해야 할 때 유용합니다. deployWrap은 두 구현의 클론을 만들고 결속한 뒤 초기화합니다. AgencySettings와 AppSettings의 immutableData는 생성되는 프록시 컨트랙트의 코드 영역에 저장되고 initData가 비어 있지 않으면 그 데이터로 프록시를 호출합니다. initData는 주로 파라미터가 있는 초기화 함수 호출에 쓰이고 iconstructor는 설정 파라미터 검증과 파라미터 없는 초기화에 쓰입니다. Factory로 배포하면 두 컨트랙트의 iconstructor가 자동으로 호출됩니다. 사용자는 서로 다른 Agency 구현과 App 구현을 Factory로 조합해 다양한 제품을 만들 수 있습니다.

기존 발행·소각 확장과의 차이

ERC-5679는 ERC-721의 발행과 소각을 일관되게 확장하는 IERC5679Ext721 인터페이스를 제안했습니다. 이 표준의 IERC7527App은 ERC721TokenReceiver를 구현하지 않은 컨트랙트와의 하위 호환을 고려해 safeMint 대신 mint를 씁니다. 또 결속의 안전성과 유일성을 위해 소각 주체가 결속된 Agency의 컨트랙트 주소여야 하므로, IERC5679Ext721과 달리 burn 함수에 _from 파라미터를 두지 않습니다. 한편 ERC7527App은 ERC721Metadata 인터페이스의 name을 상속해야 합니다.

제안 상태

이 제안은 아직 초안(Draft) 상태입니다. 명세와 인터페이스가 앞으로 바뀔 수 있으므로 구현 전에 최신 원문을 확인하는 것이 좋습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs