# HannFinance

## English

- [Hann Finance](https://docs.hann.finance/readme.md)
- [Product overview](https://docs.hann.finance/overview.md)
- [About Hann Finance](https://docs.hann.finance/overview/about-hann-finance.md): Lending, USDHN borrowing, staking, and asset conversion on Kaia
- [Accounts and product questions](https://docs.hann.finance/overview/general.md): Wallet accounts, collateral choices, fees, points, and transaction results
- [Glossary](https://docs.hann.finance/overview/glossary.md): Assets, positions, ratios, deposits, and transaction terms
- [Getting started](https://docs.hann.finance/getting-started.md)
- [Use Hann Finance](https://docs.hann.finance/protocol.md)
- [Lending markets](https://docs.hann.finance/protocol/lending.md): Supply assets, borrow against collateral, repay loans, and manage Lending health factor and E-Mode
- [Borrowing and liquidation](https://docs.hann.finance/protocol/borrowing-and-liquidation.md): Open a USDHN loan, manage collateral and debt, and reclaim collateral after repayment or liquidation.
- [USDHN and Earn](https://docs.hann.finance/protocol/usdhn-and-earn.md): USDHN issuance, redemption, and the deposits and rewards in Hann Finance Earn
- [Convert and StableSwap](https://docs.hann.finance/protocol/stableswap-dex.md): Swap USDHN and USDT, bridge assets to Kaia, and provide or stake StableSwap liquidity.
- [bKAIA and HNKAIA](https://docs.hann.finance/protocol/bkaia-and-hnkaia.md): Stake KAIA for bKAIA, claim unstaking requests, and wrap or unwrap HNKAIA
- [Leverage](https://docs.hann.finance/protocol/loops.md): Open, adjust, or close leveraged Troves and understand changes to collateral, debt, and liquidation exposure.
- [Zappers](https://docs.hann.finance/protocol/zapper.md): Combined liquidity and Trove actions, token approvals, manager permissions, and flash settlement.
- [Redemptions](https://docs.hann.finance/protocol/redemptions-and-risk.md): Redeem USDHN for collateral, understand the fee, and manage the effect on a Trove
- [Protocol mechanics](https://docs.hann.finance/mechanics.md)
- [Detailed explanations](https://docs.hann.finance/mechanics/deep-dives.md): Trove structure, liquidation, redemption, leverage, and pool mechanics
- [Trove concepts](https://docs.hann.finance/mechanics/deep-dives/trove-concepts.md): How a Trove holds collateral and USDHN debt, how ownership works, and what collateral branches share.
- [CDP collateral conditions](https://docs.hann.finance/mechanics/deep-dives/cdp-safety.md): Calculate collateral ratio, LTV, liquidation price, and the USDHN needed to repay a Trove.
- [Liquidations and Earn](https://docs.hann.finance/mechanics/deep-dives/liquidations-and-earn.md): Liquidation debt offsets, collateral distribution, and Stability Pool deposit accounting
- [Redemptions](https://docs.hann.finance/mechanics/deep-dives/redemptions.md): Redemption allocation, interest-rate ordering, fee calculations, and changes to collateral ratios
- [Leverage](https://docs.hann.finance/mechanics/deep-dives/looping-and-leverage.md): Derivations for leveraged collateral exposure, equity, CR, liquidation price, and repayment cost.
- [StableSwap](https://docs.hann.finance/mechanics/deep-dives/stableswap.md): The two-asset StableSwap curve, dynamic fees, execution limits, and LP value during a depeg.
- [Yield-bearing receipt tokens](https://docs.hann.finance/mechanics/deep-dives/yield-bearing-stables.md): earnUSDT shares, the wEarnUSDT collateral wrapper, valuation, and USDT withdrawal
- [Developers](https://docs.hann.finance/developers.md)
- [Technical overview](https://docs.hann.finance/developers/technical-overview.md): Public contracts, asset accounting, and wallet transactions for lending, USDHN, staking, and swaps
- [Integrator guide](https://docs.hann.finance/developers/integrator-kit.md): Contract selection, wallet transactions, and indexing for Hann Finance integrations
- [Smart contracts](https://docs.hann.finance/developers/smart-contracts.md): Networks, contract addresses, public functions, events, and account state
- [Trove lifecycle](https://docs.hann.finance/developers/trove-manager.md): TroveManager accounting, position states, branch restrictions, read methods, and events for integrations.
- [Security](https://docs.hann.finance/security.md)
- [Audits and vulnerability reporting](https://docs.hann.finance/security/audits-and-security.md): Vulnerability reporting, contract references, and security announcements
- [Position conditions and losses](https://docs.hann.finance/security/risks.md)
- [Risk disclosure](https://docs.hann.finance/security/risk-disclosure.md): Liquidation, asset-value, withdrawal, execution, and bridge conditions
- [Resources](https://docs.hann.finance/resources.md)
- [Brand assets](https://docs.hann.finance/resources/brand-assets.md): Hann Finance logos, blue-and-lime palette, and typography
- [Legal](https://docs.hann.finance/legal.md)
- [Privacy Policy](https://docs.hann.finance/legal/privacy-policy.md): Last Updated: November 1, 2025
- [Terms of Service](https://docs.hann.finance/legal/terms-of-service.md): Last Updated: November 1, 2025


---

# 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
This site has an agentic ask interface you may use to query the documentation dynamically 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/index.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.
