> 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/mechanics/deep-dives/yield-bearing-stables.md). # 利回りを持つ受領トークン earnUSDTの持分、wEarnUSDT担保ラッパー、評価額とUSDTの引き出し earnUSDTはボールトの持分を表すSuperEarnの預入証明トークンです。Hann Financeはこの持分をwEarnUSDTにラップしてCDPの担保を計算します。持分の価値は1口が表す資産から生まれ、ラッピングはトークンの小数点桁数を変えます。 ## 3つの資産の役割 | 資産 | 表すもの | 役割 | | --------- | ------------------------- | ----------------------------------------- | | USDT | 原資産のステーブルコイン | 外部のSuperEarnシステムに預ける、またはそこから引き出す資産 | | earnUSDT | SuperEarnボールトの持分 | EarnUSDT担保の預入手順で受け付けるトークン | | wEarnUSDT | 小数点以下18桁にラップしたearnUSDTの持分 | EarnUSDT Troveブランチが保有し、スタビリティプールと償還で支払う担保 | アプリはearnUSDTの預入に小数点以下6桁、wEarnUSDTの担保計算に小数点以下18桁を使います。 ```mermaid flowchart LR U[USDT] -->|SuperEarnに預ける| E[earnUSDTの持分] E -->|ラップ| W[wEarnUSDT] W -->|担保として預ける| T[Trove] T -->|担保を回収| W W -->|アンラップ| E E -->|引き出しを申請して受け取る| U ``` *Troveの担保回収、持分のアンラップ、USDTの受け取りはそれぞれ別の資産変換です。* ## 持分数量と1口当たりの価値 持分数量が変わらなくても、1口が表す資産量は変わります。1口当たりのUSDT換算量を`NAV`とすると、次のとおりです。 $$ \text{USDTValue} \approx \text{Shares} \times \text{NAV} $$ 1,000口のNAVが1.00 USDTから1.03 USDTになると、原資産の見積もりは1,000 USDTから1,030 USDTになります。持分数量は1,000口のままです。最終的な受取額には、引出手数料、実現損失、利用可能な流動性が反映されます。 預入証明トークンはそれぞれの持分換算関数を使います。Hann FinanceのearnUSDT NAVプロバイダーは`SuperEarnRouter.previewRedeem(earnUSDT, oneShare)`を読み、結果を小数点以下18桁にそろえます。 ## 預け入れ・保有・資産の回収 ### 1. earnUSDTの持分を用意する 外部SuperEarn Routerの`deposit(earnVault, amount, receiver, minSharesOut)`は、USDTを預かり持分を発行します。Preview関数は預け入れ、発行、償還の数量を見積もります。 Hann Financeの通常のEarnUSDT担保預入は、**earnUSDTの持分**を受け付けます。この手順に入力するトークン数量は持分数量です。 ### 2. 持分を担保として使う EarnUSDTZapperは受け取ったearnUSDTをwEarnUSDTにラップしてTroveに渡します。USDHNを借りると別の負債が発生し、利息が蓄積されます。 ラッパーの換算比率はトークンの小数点桁数で決まります。 $$ \text{WrappedRaw} = \text{EarnRaw} \times 10^{18-d} $$ `d`はearnUSDTの小数点桁数です。6桁の1 earnUSDTは生整数で1,000,000に相当し、wEarnUSDTの生整数1,000,000,000,000,000,000に変換されます。通常の表示単位では、どちらも1口を表します。 ### 3. 担保を回収する Troveの終了や担保を減らす取引は、ローンの条件に応じて担保を返します。EarnUSDTZapperは担保の払い出し時にearnUSDTへアンラップします。統合レバレッジの終了経路では、SuperEarnのUSDT引き出しを開始せず、wEarnUSDTまたはearnボールトのトークンを支払います。 スタビリティプールの担保報酬とプロトコルの償還はwEarnUSDTで支払われます。ラッパーの`withdraw`または`withdrawTo`でearnUSDTへ変換できます。 アンラップはearnUSDTの生整数単位まで切り捨てます。それより小さいwEarnUSDTの残額は保有者の残高に残ります。`previewWithdraw`はバーンするラップ数量、原資産トークン数量、残額を返し、`maxWithdrawable`はアカウントが単位をそろえてアンラップできる最大数量を見積もります。 ### 4. USDTの引き出しを申請し、受け取る SuperEarnの`redeem(earnVault, shares, receiver, minAssetsOut)`は引出リクエストIDを返します。クールダウンボールトには受取人、資産数量、申請時刻、そのリクエストの待機期間、受取状態が記録されます。 リクエストの準備が整ったら、`claim(requestId, maxLossBps)`で資産を受け取ります。ボールトは`cooldownPeriod()`と`maxLossThresholdBps()`を公開しています。受取取引には、リクエストに記録された待機期間と許容損失の上限が適用されます。 市場で預入証明トークンを売る取引も別の回収経路です。売却結果は市場価格と流動性に応じて変わります。 ## プロトコルの担保価格 WEarnUSDTPriceFeedは`EarnUSDTNavProviderRouter`からNAVを読み、設定された評価額の割引率であるhaircutを適用します。Haircutはクールダウンボールトが報告する不足資産と受取損失を、ロック済み資産と待機資産の合計に対する比率で計算し、設定された倍率と上限を反映します。 通常の担保価格はNAVからhaircutを差し引いた値です。償還価格では、NAVをUSDTの生整数単位の間隔まで先に切り上げ、その後にhaircutを適用します。 価格フィードは、設定されたクロスチェーンKeeperのスナップショット経過時間も確認します。古いスナップショットでは`SnapshotStale`により価格読み取りをリバートします。NAVがゼロ、NAV読み取りが失敗、またはhaircutの会計読み取りが失敗すると、ブランチを停止し、最後の正常価格へ切り替えます。 ## 市場価値と担保比率 持分トークンの市場価値は、USDTの米ドル価格にも影響されます。 $$ \text{MarketValue} \approx \text{Shares} \times \text{NAV} \times \text{USDTMarketPrice} $$ 1,000口、NAVが1.03 USDT、USDT価格が$1.00なら、市場価値は$1,030です。USDTが$0.97で取引されると、同じ持分の価値は次のとおりです。 $$ 1{,}000 \times 1.03 \times 0.97 = 999.1\ \text{USD} $$ この数量には回収手数料と価格への影響は含まれていません。 現在のwEarnUSDT価格フィードはNAVとhaircutを使い、別のUSDT/USD市場価格入力はありません。そのため、USDTの市場価格下落はこの入力を通じて表示上の担保比率へ自動的に反映されません。 プロトコルの担保比率は次の値で計算します。 $$ CR\_{protocol} = \frac{\text{wEarnUSDTAmount} \times \text{PriceFeedValue}}{\text{USDHNDebt}} $$ 持分価値の変化、損失、haircutの変更、負債の利息はこの比率に影響します。クールダウンと市場の流動性は、担保をUSDTへ変える方法と時期に影響します。 ## 署名前に確認する値 預けるトークン、持分の換算見積もり、取引後に受け取る資産を確認します。Trove取引では現在の負債と担保比率も確認します。USDTの引き出しでは、リクエストの待機期間と受取損失設定を確認します。クロスチェーンの資産会計と外部のSuperEarnコントラクトも、持分トークンの依存先です。 [Zapperガイド](/ja/protocol/zapper.md)では担保変換の経路、[技術概要](/ja/developers/technical-overview.md)ではコントラクトの役割を説明しています。[CDPの安全性](/ja/mechanics/deep-dives/cdp-safety.md)、[清算とEarn](/ja/mechanics/deep-dives/liquidations-and-earn.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/mechanics/deep-dives/yield-bearing-stables.md?ask=&goal= ``` `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.