Aave変動債務トークン残高: 返済義務を読み取る

Aave V3の変動債務トークン残高は、発生済み利息を含め、そのアカウントが返済すべき額を表します。ポートフォリオ合計に加える別の資産ではありません。 最初に借りた額だけと比較せず、同じネットワーク、市場、アカウントの対応する借入ポジションと並べて確認します。

借りた原資産トークンがウォレットに残っていても、別の場所で使われても、債務は残り得ます。一方、追加の借入がなくても利息の発生で債務トークンの行は増えます。ウォレットのプラス残高や見慣れないトークン名だけでは、返済義務を説明できません。

このガイドは標準的なEVM版Aave V3にある既存の変動金利ポジションを照合するものです。借入の推奨、返済額の選定、取引の実行は行いません。別バージョンのプロトコル、特殊な市場、別種のトークンには、それぞれの会計ルールが必要です。

金額を読む前に返済義務を特定する

確認対象のネットワーク、Aave市場、債務を持つアカウントを記録します。次に変動債務トークンのコントラクトと、借りた原資産を特定します。Aaveのトークン化リファレンスには、この対応を調べるUNDERLYING_ASSET_ADDRESS()が記載されています。コピーされたシンボルではなく、プロトコルの公式市場情報でデプロイ先を確認します。

借入トークンの受取アカウントと、債務を負うアカウントは常に同じとは限りません。同じリファレンスでは、信用委任の流れで原資産トークンを受け取るアカウントと、債務トークンを受け取るアカウントを区別しています。別のアカウントやサービスが代理で借りた場合は、実際の債務記録をたどります。送金の受取人だけから債務者を判断してはいけません。

原資産トークン、供給した保有分を表すaToken、返済義務を表す変動債務トークンの3つを分けて扱います。aToken残高ガイドは供給側を説明しています。原資産名が一致しても、これらの記録が交換可能な資産になるわけではありません。

現在の債務を現在の読み取り値と比較する

Aaveは変動債務トークンのbalanceOf(account)を、元本と利息を含む現在の累積債務として説明しています。totalSupply()はそのトークンが全ユーザーに対して表す債務総額であり、1つのアカウントの借入ではありません。アカウントごとの読み取り値を選びます。

借入ガイドによると利息は直ちに発生し始め、借入金利は変わることがあります。履歴の項目は、その取引で借りた額を示します。過去の借入額だけを足しても、利息やその後の操作を経た現在の債務は再現できません。

仮の例として、あるアカウントが最初に原資産トークン100枚を借りたとします。後日の現在債務の読み取り値は100.8枚で、表示形式を整えた対応する変動債務トークンの数量も100.8です。債務を変える他の操作がなければ、差の0.8枚は発生済み利息です。これらは仮の数値であり、実在するアカウント、金利、特定期間の予測を示しません。

100.8という値には、その利息がすでに含まれています。0.8をさらに加えると債務を過大計上します。同様に、債務トークンの行とプロトコルの100.8枚の借入行は、別々の2件の借入ではなく1つの負債を表します。小さな差を誤りと判断する前に、観測したブロックや時刻を比較します。

債務トークンは送金できるウォレット資産ではない

標準的なV3変動債務トークンでは、未対応操作のリファレンスにあるとおり、通常のtransferとapproveは無効です。債務トークンを別アドレスに送ったり、取引可能な受領証のように扱ったりして借入を消そうとしてはいけません。

借りた原資産トークンを送るのは別の操作です。ウォレットで使える残高が減っても、借入は未返済のまま残ることがあります。トークンをウォレットに戻すだけでも決済にはなりません。返済手続きによってプロトコルの債務記録が変わる必要があります。

記録	意味	会計上の扱い
ウォレットの原資産トークン	そのアドレスで使えるトークン	借入とは別の資産残高
標準的なaToken	供給利息を含む供給ポジション	供給記録に一度だけ関連付ける
変動債務トークン残高	借入利息を含む現在の返済義務	債務記録に一度だけ関連付ける
借入取引の数量	その過去の操作で借りた額	現在の債務ではなく履歴

資産だけを表示するトラッカーでは、完全な純ポジションは確定できません。数値を組み合わせる前に、すでに何が集計されているか確認します。ポートフォリオ照合ガイドでは、負債の欠落と表現の重複を扱っています。この記事は、Owlioがすべての債務トークンを読み取ることや、Aaveの純エクスポージャーを計算することを約束するものではありません。

読み取り専用の債務記録を作る

公開されたプロトコル情報か、信頼できるコントラクト読み取りツールを使います。これは文書に基づく確認です。この記事のために実際の借入を照会したり返済したりはしていません。一次資料は2026年11月1日に確認しました。

1. 正確なアカウントと市場を選ぶ。 ネットワーク、市場、債務を負うアカウントを記録します。異なるデプロイ先やアカウントは別の項目にします。
2. トークン種別と原資産を対応させる。 変動債務トークンのコントラクトと原資産アドレスを省略せず記録します。aToken、ラッパー、名前の似た無関係なトークンで代用してはいけません。
3. 現在の数量を読む。 balanceOf(account)と対応するプロトコルの借入数量を取得します。文書にあるトークンの小数桁数で生の整数値を換算します。画面ですでに整形された数量を再び換算してはいけません。
4. 観測時点をそろえる。 ツールが対応していれば同じブロックを使います。それができなければ観測時刻を保存し、個別の読み取りの間に利息や取引で結果が変わり得ることを記録します。
5. 1つの負債として照合する。 債務トークンとプロトコルの借入表示を関連付けておきます。ウォレットの原資産トークン残高は別に記録します。取得不能や失敗した読み取りはゼロにせず不明のまま残します。

公開残高の読み取りに、取引への署名、承認、リカバリーフレーズは不要です。画面の接続手順と、コントラクトの公開状態を読むことは別です。表示を調べるだけのために返済を送信したり、利用許可額を変更したりしてはいけません。

トークン数量が一致して法定通貨価値が違う場合は、価格の通貨単位と時刻を確認します。トークン単位の債務数量は、そのままドル額にはなりません。推測した市場価格でも、プロトコルの評価をすべて再現できるわけではありません。

資金の保有と返済の確認を分ける

Aaveの返済ガイドは、返済対象の選択、必要な場合の利用許可、返済の確定を区別しています。必要な原資産トークンを持つこと自体は返済ではありません。承認があっても、そのトークンで債務が減った証明にはなりません。

すでに返済した場合は、確定した結果を確認し、その後で対象アカウントと市場の現在の返済義務を再び読み取ります。一部返済では債務が残ることがあり、見積もりから実行までの間にも利息が発生し得ます。過去の金額を使い回して、残高がない保証にしてはいけません。

債務残高だけでは清算リスクは決まりません。担保としての適格性、価格、市場パラメーターも関係します。この別の問題はAaveヘルスファクターガイドで扱います。債務が少ないことや資産合計がプラスであることは、あらゆる場合に使える安全性の判定基準ではありません。

アカウント、市場、原資産、現在の債務数量、観測ブロックまたは時刻が特定され、負債が一度だけ計上されれば記録はそろいます。解決していない読み取りには未確認の印を残します。返済するか、どのように返済するかは、別の取引判断です。