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

# 赎回

用 USDHN 赎回抵押品、了解费用，以及管理赎回对 Trove 的影响

赎回通过 Hann Finance 将 USDHN 换成抵押品。协议减少借款人的债务，将抵押品转给赎回人，并销毁使用的 USDHN。赎回直接缩小相关借款人的仓位。

![持有人的 USDHN 换为 KAIA 抵押品；借款人的 Trove 同时减少债务和抵押品，费用留在 Trove。](https://2468384826-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNSloZoJik3NAsr6vrfDs%2Fuploads%2Fgit-blob-fa6b4cad576823445feaf11a2a8c8fbf08f452c5%2Fredemption-overview.svg?alt=media)

*债务和抵押品同时减少，赎回费留在相关 Trove。*

## 赎回、还款与清算

| 操作 | 发起人       | 结果                                  |
| -- | --------- | ----------------------------------- |
| 还款 | 借款人       | USDHN 减少本人的债务，关闭 Trove 后返还抵押品。      |
| 赎回 | USDHN 持有人 | 协议选择 Trove，减少其债务，向持有人转移扣费后的抵押品。     |
| 清算 | 清算调用者     | 关闭低于最低抵押率的 Trove，债务和抵押品进入稳定池及再分配路径。 |

普通赎回也会影响高于清算阈值的 Trove。

## 持有人为何赎回

在低于 $1 时买入 USDHN 并赎回，可将折价 USDHN 换成按协议定价的抵押品。买入增加需求，销毁减少供应。

交易结果取决于赎回费、Gas 和抵押品市场卖价。协议估值与市场可成交价可能不同。

## 协议如何选择 Trove

选择分两个阶段：

1. **跨分支分配**：CollateralRegistry 按合格分支债务超出其稳定池存款的部分分配赎回。若所有合格分支超额债务均为零，则按总债务分配。
2. **分支内选择**：TroveManager 先检查上次赎回留下并记录的小额债务 Trove，再按**年利率从低到高**遍历。按普通预言机价格计算，抵押率低于 100% 的 Trove 会被跳过。

接受普通赎回分配的分支须处于启用状态、没有关闭记录，且总抵押率至少达到关闭阈值 `SCR`。

赎回人按分配结果接收抵押品，种类由协议分配决定。应用表单统一处理各分支输出。

## 借款人的变化

每笔被赎回部分：

* 债务按用于该 Trove 的 USDHN 数量减少。
* 抵押品按发送给赎回人的数量减少。
* 作为赎回费的抵押品留在 Trove。
* 年利率保持原值。

债务低于最低要求时，合约将 Trove 标为 `zombie` 并从普通赎回列表移除。剩余抵押品继续留在 Trove，债务为零时也一样。借款人可关闭仓位取回。

提高利率会把 Trove 排到普通赎回顺序后面，同时增加借款成本。调息和管理人设置影响这项取舍。赎回后，抵押品价格和继续借款仍会改变抵押率。

## 在应用中赎回

1. 钱包准备 USDHN 和支付 Gas 的 KAIA。
2. 打开**资产转换**（`/convert`），选择**赎回**。
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，其余保留在钱包。成功后查看实际处理数量。

## 手动赎回与辅助合约

使用[智能合约](/zh/developers/smart-contracts.md)中所选网络的地址和 ABI。Kaia 主网与 Kairos 测试网使用独立链和地址。

直接调用 `CollateralRegistry.redeemCollateral` 遵循上述流程。`RedemptionHelper.redeemCollateral` 还接受 `_minCollRedeemed`，按辅助合约分支顺序排列最低抵押品输出。Helper 从钱包转入 USDHN，因此需要授权额度；它将抵押品转给调用者并退回未用 USDHN。

两条路径各有输入和授权要求。[赎回详解](/zh/mechanics/deep-dives/redemptions.md)提供费率公式、分支分配和抵押率数值示例。

## 执行条件

普通赎回需要合格分支和正常价格源。低于 `SCR` 或已关闭的分支排除在普通分配之外。关闭分支有独立的 `urgentRedemption` 路径。

卖出所得抵押品取决于市场流动性。[借款与清算](/zh/protocol/borrowing-and-liquidation.md)说明仓位管理，[风险披露](/zh/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hann.finance/zh/protocol/redemptions-and-risk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
