> 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/ja/protocol/redemptions-and-risk.md).

# 償還

USDHNを担保に償還する手順、手数料、Troveへの影響

償還はHann Financeを通じてUSDHNを担保と交換する取引です。プロトコルは借り手の負債を減らし、償還者に担保を送り、使ったUSDHNをバーンします。借り手が返済取引を行わなくてもポジションが小さくなります。

![ウォレットからUSDHNを送り、KAIAの担保を受け取ります。借り手のTroveでは負債と担保がともに減り、手数料分の担保が残ります。](https://3703202746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FijRIWLhwa2WiTrn7wCdn%2Fuploads%2Fgit-blob-eff5489aa0b1d1b5dceff8a49cca57359ff0a37d%2Fredemption-overview.png?alt=media)

*負債と担保が同時に減ります。償還手数料に相当する担保は対象のTroveに残ります。*

## 返済・償還・清算

| 操作 | 実行する人    | 結果                                                     |
| -- | -------- | ------------------------------------------------------ |
| 返済 | 借り手      | USDHNで自分の負債を減らします。Troveを閉じると担保を受け取れます。                 |
| 償還 | USDHN保有者 | プロトコルがTroveを選び、その負債を減らして、手数料差引後の担保を保有者に送ります。           |
| 清算 | 清算の呼び出し者 | 担保比率が最低基準を下回るTroveを閉じます。負債と担保はスタビリティプールの相殺と再分配で処理されます。 |

通常の償還は清算基準を上回るTroveにも適用されます。

## 保有者が償還する理由

市場で$1を下回るUSDHNを購入して償還すると、割安なUSDHNをプロトコル価格で計算した担保と交換します。購入は需要を生み、償還に使ったUSDHNのバーンは供給量を減らします。

取引の結果は償還手数料、ガス代、担保の売却価格で決まります。プロトコルの担保価格と市場で取引できる価格は異なることがあります。

## 対象Troveの選択

対象は2段階で選ばれます。

1. **ブランチ間の配分:** CollateralRegistryは、各対象ブランチの負債がスタビリティプールの預入額を超える分に比例して償還を配分します。すべての対象ブランチでこの超過負債がゼロの場合は、総負債に比例して配分します。
2. **ブランチ内の順序:** TroveManagerは前の償還から残った記録済みの少額負債Troveを先に確認し、その後、**年利が低いTroveから**順に処理します。通常のオラクル価格で担保比率が100%未満のTroveは飛ばします。

通常の償還が配分されるブランチは、アクティブで、停止記録がなく、総担保比率が停止基準の`SCR`以上である必要があります。

償還者はこの配分に応じた担保を受け取ります。アプリの償還画面では単一の担保を指定できません。

## 借り手のポジションの変化

各償還では次の変化が生じます。

* Troveに対して使われたUSDHNの数量だけ負債が減ります。
* 償還者に送った数量だけ担保が減ります。
* 償還手数料に相当する担保はTroveに残ります。
* 年利は変わりません。

負債がブランチの最低負債を下回ると、コントラクトはTroveを`zombie`状態にし、通常の償還リストから取り除きます。負債がゼロになっても残りの担保はTroveに保持されます。借り手はTroveを閉じて担保を回収できます。

年利を高くすると通常の償還順序が後ろに移り、借入費用が増えます。金利変更とマネージャー設定はこの関係に影響します。償還後も担保価格や追加借入に応じて担保比率が変わります。

## アプリで償還する

1. ウォレットにUSDHNとガス代用のKAIAを用意します。
2. **Swap**で**償還**を選びます。
3. USDHNの数量と**最大償還手数料**を入力します。
4. 予想手数料と受け取る担保トークンを確認します。
5. 取引を送信し、ウォレットで署名します。
6. 取引確定後に実際にバーンされたUSDHNと受け取った担保を確認します。

現在のアプリはCollateralRegistryを直接呼び出します。

```solidity
redeemCollateral(
    uint256 _usdhnAmount,
    uint256 _maxIterationsPerCollateral,
    uint256 _maxFeePercentage
)
```

アプリは反復上限に`0`を渡し、ブランチごとの走査回数の上限を解除します。Registryが呼び出し者のUSDHNを直接バーンするため、この経路には**USDHNの利用承認はありません**。

手数料率は小数点以下18桁の固定小数点値で渡します。例えば最大1%は`10_000_000_000_000_000`です。最大手数料はコントラクトの手数料下限以上、100%以下である必要があります。取引で計算された手数料が上限を超えると、取引はリバートします。

ブランチへの配分、対象Troveの負債、反復上限によって、実行数量が要求数量より少なくなることがあります。直接呼び出す経路では実際に償還した分だけバーンするため、未使用のUSDHNはウォレットに残ります。取引の成功と要求数量の全量処理はそれぞれ確認します。

## 手動呼び出しとHelper

選択したネットワークのアドレスとABIは[スマートコントラクト](/ja/developers/smart-contracts.md)で確認します。KaiaとKairosではチェーンとデプロイプロファイルが異なります。

`CollateralRegistry.redeemCollateral`を直接呼び出すとアプリと同じ経路を使います。`RedemptionHelper.redeemCollateral`には、Helperのブランチ順に並べた担保別の最低受取数量配列`_minCollRedeemed`も渡します。HelperはウォレットからUSDHNを受け取るため、USDHNの利用承認が必要です。受け取った担保と未使用のUSDHNは呼び出し者へ送ります。

HelperとRegistryの直接呼び出しでは、入力値と承認要件が異なります。[償還の詳細](/ja/mechanics/deep-dives/redemptions.md)では手数料の式、ブランチ配分、担保比率の数値変化を説明しています。

## 実行条件

通常の償還には対象ブランチと動作する価格フィードが必要です。総担保比率が`SCR`未満、または既に停止したブランチは通常の配分から除外されます。停止したブランチには別の`urgentRedemption`経路があります。

受け取った担保の売却は市場の流動性に左右されます。[借り入れと清算](/ja/protocol/borrowing-and-liquidation.md)ではポジション管理、[リスク開示](/ja/security/risk-disclosure.md)では市場・コントラクト・オラクルのリスクを説明しています。


---

# 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/ja/protocol/redemptions-and-risk.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.
