ERC-7726 공통 시세 오라클 인터페이스 (Common Quote Oracle)

Draft · 기타 · 2024-06-20 작성

자산의 상대 가치를 알려 주는 데이터 피드(오라클)를 하나의 공통 함수로 조회하게 하는 표준입니다. 가격 비율 대신 실제 토큰 수량으로 값을 돌려주는 getQuote 함수를 정의합니다.

왜 필요한가

스마트 컨트랙트가 자산의 가치를 알아내려면 외부 데이터 공급자(오라클)에 의존해야 하는데, 이 정보는 크고 작은 여러 출처에 흩어져 있고 출처마다 연동 방식과 보안상 따져야 할 점이 다릅니다. 그래서 많은 프로토콜이 저마다 어댑터 층을 만들어 이 복잡함을 감춰 왔고 같은 일을 여러 팀이 반복하는 낭비가 생겼습니다. 또 가격을 소수점 비율 형태로 다루면 토큰마다 다른 자릿수(decimals) 처리에서 실수가 나기 쉽습니다. 이 표준은 대다수 사용 사례를 감당할 수 있는 공통 API를 정해 연동을 쉽게 하고 지식과 자원이 적은 제품 팀도 안전하게 쓸 수 있게 하는 것을 목표로 합니다. 원문은 비율 대신 명시적인 토큰 수량을 쓰는 방식이 보안과 출시 속도 면에서 더 나은 결과로 이어졌다고 설명합니다.

심층 설명

base, quote, value의 정의

base 자산은 사용자가 가치를 알고 싶은 자산이고, quote 자산은 그 가치를 표현하는 기준 자산입니다. 예를 들어 "1e6 USDC가 ETH로 얼마인가"에서 USDC가 base, ETH가 quote입니다. value는 base의 수량을 quote 수량으로 나타낸 값입니다. 원문 예시로 1000e6 USDC의 ETH 기준 value는 283,969,794,427,307,000 ETH 단위이고 1000e18 ETH의 USDC 기준 value는 3,521,501,299,000 USDC 단위입니다. 이 값은 자산 수량이지 소수점 비율(decimal factor)이 아니라는 점이 이 표준의 핵심입니다.

getQuote의 동작 규칙

getQuote(baseAmount, base, quote)는 base 자산 baseAmount 수량의 가치를 quote 기준으로 돌려주는 view 함수입니다. 결과는 반드시(MUST) 0을 향해 내림해야 하고 결과가 uint256 범위를 넘치는 경우 반드시(MUST) 되돌려야(revert) 합니다. 입력은 baseAmount(uint256), base(address), quote(address) 세 개이고 출력은 quoteAmount(uint256) 하나입니다.

주소가 없는 자산을 위한 특수 주소

ETH, BTC, 각국 법정화폐처럼 컨트랙트 주소가 없는 자산도 이 표준의 범위에 들어갑니다. ETH는 ERC-7528에 따라 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE를 쓰고 BTC는 0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB를 씁니다. 주소는 없지만 ISO 4217 통화 코드가 있는 자산은 그 코드를 주소로 씁니다. 예를 들어 미국 달러(USD)는 address(840)입니다.

getPrice를 두지 않은 이유

이 명세에는 가격 비율을 돌려주는 getPrice 함수가 없습니다. 온체인에서 가격 비율이 필요한 경우는 드물고 소수가 되어 표현이 어렵기 때문입니다. getQuote는 base나 quote에 정의된 자릿수(decimals)를 소비자가 알 필요가 없게 하므로 대부분의 데이터 처리에서 이 방식을 우선해야 합니다. 그래도 흔히 쓰는 가격 표현이 필요하면 decimals가 있는 ERC-20에 대해 oracle.getQuote(base, quote, 10**base.decimals())로 base 한 단위의 quote 기준 가치를 얻는 식으로 구현할 수 있다고 원문은 설명합니다.

기존 데이터 피드와의 호환

자산 쌍의 상대 가치에 관한 기존 데이터 피드 대부분은 이 표준으로 표현할 수 있다고 원문은 밝힙니다. 즉 새 데이터 소스를 만들라는 요구가 아니라, 이미 있는 피드 위에 공통 인터페이스를 씌우는 방향입니다.

Draft 상태의 제안

이 ERC는 2024년 6월 20일에 만들어진 Draft(초안) 상태입니다. 내용이 앞으로 바뀔 수 있는 제안 단계이므로, 구현하거나 연동할 때는 최신 원문을 확인해야 합니다. ERC-7528(ETH 특수 주소)을 선행 표준으로 요구합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs