> ## Documentation Index
> Fetch the complete documentation index at: https://docs.batt.farm/llms.txt
> Use this file to discover all available pages before exploring further.

# 오라클 설계

> batt은 담보의 달러 가격과 원/달러 환율로 담보의 원화 가치를 계산합니다.

[Read in English](https://docs.batt.farm/en/price-and-oracles.md)

## 블록체인에서 오라클은 무엇을 하나요?

블록체인에서 정해진 규칙을 실행하는 프로그램을 스마트 컨트랙트라고 합니다. 이 프로그램은 체인에 기록된 정보를 읽을 수 있지만, 외부 거래소의 가격이나 환율을 인터넷에서 직접 조회하지는 못합니다.

[오라클](https://docs.batt.farm/glossary.md#오라클)은 이런 외부 정보를 스마트 컨트랙트가 사용할 수 있도록 전달하는 시스템입니다. 대출 프로토콜은 오라클이 제공하는 가격을 이용해 담보가치를 계산하고, 담보가 부채를 충분히 뒷받침하는지 판단합니다.

오라클은 판단에 필요한 정보를 제공합니다. 그 정보에 어떤 청산 기준과 규칙을 적용할지는 각 프로토콜의 설계에 따릅니다.

## batt에서는 오라클을 어떻게 활용하나요?

batt의 부채는 KRW\*로 표시되므로 담보가치도 원화로 계산해야 합니다. ETH의 수량만으로는 현재 원화 가치를 알 수 없기 때문에, ETH의 달러 가격과 원/달러 환율 정보가 함께 필요합니다.

batt은 오라클이 전달한 가격과 환율로 담보의 원화 가치를 계산합니다. 이 값을 부채와 비교해 담보비율을 구하고, 해당 포지션이 청산 대상인지 판단합니다.

## 달러 가격과 환율을 연결합니다

ETH를 예로 들면 **ETH/USD × USD/KRW = ETH/KRW**입니다. 여기서 USD/KRW는 달러 1개당 원화 금액입니다.

담보 한 개의 원화 가격에 맡긴 수량을 곱하면 해당 담보의 원화 평가액이 됩니다. 이 식으로 담보의 원화 가치를 계산할 수 있습니다. 실제로 사용하는 데이터 공급자와 피드 구성은 별도로 확인해야 합니다. 래핑 토큰이나 수익형 담보는 기초자산과의 교환비율, 자체 가격 이탈도 살펴야 합니다.

## ETH 가격이 같아도 원화 평가액은 바뀝니다

ETH 1개를 평가하는 예시입니다.

| 상황 | ETH/USD | USD/KRW | 원화 평가액 |
| - | - | - | - |
| 기준 | 2,000달러 | 1,400원 | 280만 원 |
| 원화 강세 | 2,000달러 | 1,300원 | 260만 원 |
| 원화 강세 + ETH 하락 | 1,800달러 | 1,300원 | 234만 원 |

원화가 강해져 원/달러 환율이 내려가면 담보의 원화 평가액이 줄어듭니다. ETH의 달러 가격까지 떨어지면 두 변화가 겹칩니다. 환율 때문에 KRW\* 부채의 개수가 늘어나는 것은 아닙니다.

이 평가액을 부채와 비교하는 계산과 대응 방법은 [KRW\* 대출 관리](https://docs.batt.farm/manage-position.md#담보비율과-청산)에서 설명합니다.

## 가격이 언제 갱신됐는지도 봅니다

담보가격이 방금 갱신됐어도 환율이 오래된 값이면 평가액이 현재 시장과 다를 수 있습니다. 차입자는 담보비율을 확인할 때 가격과 환율이 각각 언제 갱신됐는지도 확인해야 합니다.

환율 데이터의 제공 시간과 갱신 주기는 공급원마다 다릅니다. 피드가 멈췄다는 사실이 모든 시장의 원화 거래가 멈췄다는 뜻은 아닙니다. 오래된 가격이 한 번에 갱신되면 담보비율도 갑자기 달라질 수 있습니다.

## 평가가격은 매도가격이 아닙니다

오라클은 담보를 평가할 기준을 제공하지만 그 가격에 담보를 사주는 거래 상대는 아닙니다. 실제 매도에는 마켓의 유동성, 가격 영향, 수수료가 반영됩니다.

오라클로 계산한 담보가치와 KRW\*의 시장가격은 별개입니다. 차입자는 담보비율을 계산할 때의 기준가치와 상환할 KRW\*를 시장에서 사는 데 드는 비용을 구분해야 합니다.

## 아직 등록되지 않은 구현 정보

실제 피드 주소, 허용하는 가격 지연 시간, 장애 대응 규칙은 아직 이 문서에 등록되어 있지 않습니다. 위 설명만으로 대체 피드나 주말 처리, 자동 거래 중단 기능이 구현됐다고 판단할 수는 없습니다.

[담보비율 변화에 대응하기 →](https://docs.batt.farm/manage-position.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.