> For the complete documentation index, see [llms.txt](https://docs.hann.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hann.finance/ko/protocol/lending.md).

# Lending 마켓

자산 공급·담보 차입·상환과 Lending 건전성 지표 및 E-Mode 관리 방법

Lending 마켓에 자산을 공급하면 이자를 받습니다. 담보로 사용할 수 있는 공급 자산을 활성화하면 다른 자산을 빌릴 수 있습니다. 계정의 담보 가치, 부채, **건전성 지표**(health factor)가 추가 차입 가능액과 청산 여부를 결정합니다.

Lending은 유동성 풀과 변동금리 대출을 사용합니다. [USDHN 차입](/ko/protocol/borrowing-and-liquidation.md)은 별도의 담보부 부채 포지션과 규칙을 사용합니다.

## 마켓 열기

1. **마켓** 화면(`/market`)을 열고 앱이 선택한 네트워크에 지갑을 연결합니다.
2. 자산을 선택해 해당 마켓(`/market/<asset>`)을 엽니다.
3. 공급·차입 금리, 가용 유동성, 내 포지션, 마켓 한도를 확인합니다.
4. ERC-20 자산을 사용하더라도 가스용 네이티브 KAIA를 지갑에 남겨 둡니다.

KAIA 마켓은 Lending 풀 내부에서 WKAIA를 사용합니다. 앱의 네이티브 KAIA 거래는 **WKaiaGateway**를 통해 거래 안에서 래핑·언래핑합니다. 이 경로로 차입하거나 인출하면 지갑에 네이티브 KAIA가 들어옵니다.

| 화면 항목         | 의미                     |
| ------------- | ---------------------- |
| 내 공급액         | 누적 공급 이자를 포함한 공급 잔액    |
| 부채            | 누적 차입 이자를 포함한 미상환 잔액   |
| 가용 유동성        | 인출과 신규 차입에 사용할 수 있는 자산 |
| 최대 LTV        | 담보 가치에 적용하는 차입 한도 비율   |
| 청산 임계치        | 건전성 지표 계산에 사용하는 담보 가중치 |
| 공급 한도 / 차입 한도 | 마켓 전체의 공급량과 부채량 한도     |
| 리저브 팩터        | 차입 이자 중 프로토콜에 배분하는 비율  |

자산, 한도, 금리는 현재 마켓 설정을 따릅니다. 서명 전에 **마켓 세부 정보**에서 위험, 금리 모델, 마켓 규모, 한도를 확인할 수 있습니다.

## 공급하기

1. **공급** 탭을 선택하고 자산 수량을 입력합니다.
2. 거래 후 공급 잔액과 담보 사용 상태를 확인합니다.
3. **거래 검토**를 선택합니다. 확인 화면의 토큰 사용 승인을 진행한 뒤 공급 거래를 제출합니다.
4. 거래가 성공하면 **내 공급액**과 **담보 사용**을 확인합니다.

풀은 공급 잔액을 나타내는 영수증 토큰인 **aToken**을 발행합니다. aToken 잔액에 이자가 쌓이므로 공급 이자를 별도 거래로 수령할 필요가 없습니다. 최초 공급 자산이 담보 요건을 충족하면 해당 리저브와 계정의 담보 규칙에 따라 담보 사용이 자동으로 켜질 수 있습니다.

공급 수량은 지갑 잔액과 마켓의 남은 공급 한도로 제한됩니다. 네이티브 KAIA 입력에서는 앱이 가스 예비금도 남깁니다. 동결된 마켓은 신규 공급을 받지 않으며, 일시 중지되거나 비활성화된 마켓은 해당 거래를 막습니다.

## 인출하기

1. **인출** 탭을 선택하고 지갑으로 받을 수량을 입력합니다.
2. 남은 공급 잔액, 가용 유동성, 인출 후 건전성 지표를 확인합니다.
3. **거래 검토**를 선택하고 화면에 표시되는 승인과 인출 거래를 진행합니다.
4. 거래가 성공하면 수령한 자산과 남은 공급 잔액을 확인합니다.

인출은 보유 aToken을 사용합니다. 공급 잔액과 풀의 가용 유동성 범위 안에서 인출할 수 있습니다. 미상환 대출의 담보를 인출할 때는 남은 담보가 풀의 건전성 지표와 LTV 조건도 충족해야 합니다. 전액 인출하면 해당 자산의 담보 사용 설정이 해제됩니다.

## 차입하기

1. 담보로 사용할 수 있는 자산을 공급하고 **담보 사용**이 켜져 있는지 확인합니다.
2. 빌릴 자산의 마켓을 열고 **차입** 탭을 선택합니다.
3. 수량을 입력합니다. 거래 후 부채, 추가 차입 가능액, 현재 변동금리, 건전성 지표를 확인합니다.
4. **거래 검토**를 선택합니다. 네이티브 KAIA 차입에서 요청하는 차입 권한 위임 승인을 진행한 뒤 대출 거래를 승인합니다.
5. 지갑에 받은 자산과 갱신된 부채를 확인합니다.

앱은 **변동금리**로 차입합니다. 시간이 지나면 이자가 부채 잔액에 쌓입니다. 차입하려면 마켓이 활성 상태이고 일시 중지·동결 상태가 아니어야 하며, 차입 기능이 켜져 있어야 합니다. 가용 유동성, 차입 한도, 계정의 담보 한도도 충족해야 합니다. 선택한 자산에는 E-Mode와 격리 모드, 단독 차입 규칙도 적용됩니다.

차입 수량은 마켓의 수용 한도와 계정의 추가 차입 가능 가치 안에 들어가야 합니다. 서명 전에 수량 입력란의 최대값과 계정 전체의 차입 가능액을 함께 확인하세요.

## 상환하기

1. 빌린 자산의 마켓을 열고 **상환** 탭을 선택합니다.
2. 수량을 입력하고 **적용 수량**과 남은 부채를 확인합니다.
3. **거래 검토**를 선택하고 표시되는 토큰 사용 승인과 상환 거래를 진행합니다.
4. 갱신된 부채를 확인합니다. 전액 상환 후에는 부채 잔액이 0인지 확인합니다.

상환에는 빌린 자산을 사용합니다. 풀은 실행 시점의 미상환 변동금리 부채 범위에서 금액을 적용합니다. ERC-20 상환은 실제 적용 수량을 가져가며, Gateway를 통한 네이티브 KAIA 상환은 초과 지급한 KAIA를 송신자에게 돌려줍니다.

견적과 실행 사이에도 이자가 쌓입니다. 표시 부채와 최대 상환 수량은 시간에 따라 바뀌므로 상환 후 포지션을 새로 불러와 남은 잔액을 확인하세요.

## 지갑 승인

사용 권한 승인 뒤 공급·인출·대출 거래가 해당 작업을 실행합니다. 기존 승인 한도가 거래 수량을 충족하면 앱이 승인 거래를 생략합니다.

| 거래          | 네이티브 KAIA 경로                                                  | ERC-20 경로                      |
| ----------- | ------------------------------------------------------------- | ------------------------------ |
| 공급          | Gateway에 KAIA 전송. 사용자 토큰 승인 없음                                | 기초 토큰의 Lending Pool 사용 승인 후 공급 |
| 인출          | **aWKAIA**의 Gateway 사용 승인 후 KAIA 인출                           | Pool에서 인출. 새 토큰 승인 없음          |
| 차입          | 변동금리 부채 토큰의 `approveDelegation`으로 Gateway에 차입 권한 위임 후 KAIA 차입 | Pool에서 차입. 토큰 승인 없음            |
| 상환          | Gateway에 KAIA 전송. 사용자 토큰 승인 없음                                | 상환 토큰의 Lending Pool 사용 승인 후 상환 |
| 담보 / E-Mode | Pool 설정 변경 거래 승인                                              | Pool 설정 변경 거래 승인               |

네이티브 차입의 권한 위임은 Gateway가 승인 수량 안에서 내 계정의 부채를 만들도록 허용합니다. 변동금리 부채 토큰의 차입 승인 한도를 사용합니다. 네이티브 인출은 aWKAIA의 ERC-20 승인 한도로 공급 영수증 토큰을 Gateway에 옮깁니다.

## 담보와 건전성 지표

공급 포지션이 있는 자산의 **담보 사용** 설정을 켜면 담보 요건을 충족한 공급액이 계정 담보에 포함됩니다. 현재 앱은 Lending 계정에 부채가 남아 있는 동안 담보 사용 끄기를 막습니다. 담보 사용을 끄기 전에 부채를 상환하세요.

부채가 있는 계정의 건전성 지표는 다음과 같습니다.

```
건전성 지표 = 합계(사용 중인 담보 가치 × 적용 청산 임계치) / 전체 부채 가치
```

각 가치는 동일한 오라클 기준 통화를 사용합니다. 청산 임계치는 리저브의 값을 사용하며, 선택한 E-Mode 카테고리에 속하는 자산에는 해당 카테고리의 값을 적용합니다. 화면의 **건전성 지표**는 Lending 계정 전체를 반영합니다.

| 건전성 지표 | 포지션 상태                       |
| ------ | ---------------------------- |
| 1 초과   | 청산 가중치를 적용한 담보 가치가 부채 가치보다 큼 |
| 1      | 청산 경계에 도달                    |
| 1 미만   | 청산 대상                        |

담보 가격 하락, 부채 자산 가격 상승, 이자 누적은 건전성 지표를 낮춥니다. 담보 사용이 켜진 자산을 추가 공급하거나 부채를 상환하면 올라갑니다. 추가 차입이나 담보 인출은 지표를 낮춥니다. 거래마다 **이전**·**이후** 값을 확인하세요. 미리보기는 현재 계정 데이터를 바탕으로 거래의 영향을 추정합니다.

청산은 부채 일부를 상환하는 대가로 담보를 가져가며 마켓의 청산 패널티를 적용합니다. 이전 차입 거래가 성공해도 이후 건전성 지표가 고정되지는 않습니다. 부채가 남아 있는 동안 계정 상태를 확인하세요.

## E-Mode

**E-Mode**는 요건에 맞는 담보에 카테고리별 LTV와 청산 임계치를 적용합니다. 카테고리가 활성화되어 있으면 해당 카테고리의 자산을 새로 차입할 수 있습니다.

1. 마켓의 계정 요약에서 **E-Mode** 설정을 엽니다.
2. 카테고리를 선택하고 가능 자산, 제한 자산, 최대 LTV, 건전성 지표 변화를 확인합니다.
3. **E-Mode 활성화**를 선택하고 설정 변경 거래를 승인합니다.
4. 활성 카테고리에서 **E-Mode 변경**을 선택하거나 **E-Mode 비활성화**로 일반 리저브 조건으로 돌아갑니다.

기존 부채는 진입할 카테고리와 호환되어야 합니다. 활성 카테고리를 변경하거나 종료할 때는 변경 후 조건으로 건전성 지표 1 이상을 유지해야 합니다. 일반 청산 임계치로 부채를 지탱하지 못하면 종료 전에 부채를 상환하거나 담보를 추가하세요. 카테고리의 구성 자산과 수치는 현재 마켓 설정을 따릅니다.

## 금리·비용과 거래가 막힌 이유

공급·차입 금리는 마켓 사용률과 설정된 금리 모델에 따라 바뀝니다. 공급 금리에는 리저브 팩터가 이미 반영되어 있습니다. 변동 차입 금리는 최초 거래 이후에도 부채에 영향을 줍니다.

온체인 승인과 거래에는 KAIA 가스가 사용됩니다. 토큰 사용 승인과 차입 권한 위임은 해당 작업을 실행하는 거래와 별개입니다.

| 거래가 막힌 이유        | 확인할 내용                           |
| ---------------- | -------------------------------- |
| 잔액 부족            | 입력 자산 잔액과 가스용 KAIA 잔액            |
| 공급·차입 한도 도달      | **한도**에 표시된 남은 수용량               |
| 유동성 부족           | 가용 유동성과 요청한 인출·차입 수량             |
| 담보·건전성 지표 한도     | 계정 부채, 담보 사용 자산, 거래 미리보기         |
| E-Mode 자산 불일치    | 선택한 카테고리의 가능 자산과 제한 자산           |
| 동결·일시 중지·비활성 마켓  | 마켓 상태와 막힌 거래 종류                  |
| 포지션·거래 데이터 조회 실패 | 표시된 데이터 오류. 제출 전에 해당 데이터 다시 불러오기 |

지갑 요청을 거절하면 거래가 제출되지 않습니다. 사용 권한 승인이 성공한 뒤 본 거래가 실패하면 승인 권한은 남고, 실패한 본 거래로 포지션이 바뀌지는 않습니다. 본 거래의 성공 영수증은 실행 완료를 뜻합니다. 이후 갱신된 포지션과 자산 잔액을 확인하세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hann.finance/ko/protocol/lending.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.