Aave Credit Delegation (Aave クレジット委任) は何をしますか?
Aaveのクレジット委任機能を使って資金を借り入れます。メインウォレットが担保を預け、エージェントウォレットに借入権限を委任します。エージェントは必要に応じて自律的にトークンを借り入れることができ、負債はデリゲーターのポジションに計上されます。
プロトコル: Aave V3 および Aave V2 で動作します。クレジット委任に関する関数シグネチャ(
borrow、repay、approveDelegation、borrowAllowance)は両バージョンで同一です。V2のLendingPoolおよびProtocolDataProviderのアドレスに差し替えるだけで利用可能です。唯一の違いは、V3が担保/負債をUSD(8桁精度)で返すのに対し、V2はETH(18桁精度)で返す点です。ヘルスファクターの安全チェックは両方で正しく動作します。
互換性
- OpenClaw — スキルとしてインストールすると、エージェントが自律的に借入を実行します
- Claude Code — Claude Codeセッションから直接スクリプトを実行
- 任意のエージェントフレームワーク — プレーンなbash + Foundryの
castで、シェルが使える環境ならどこでも動作
Bankr スキルと組み合わせると、借入→スワップのフローが実現できます。USDCをクレジット委任で借り入れ、Bankrを使ってスワップ、ブリッジ、展開などを行えます。
クレジット委任の仕組み
Aave V3のクレジット委任は、借入能力(Borrowing Power) と 委任承認(Delegation Approval) の2つを分離します。
借入能力は全体として扱われます。 これは全資産にわたる担保ポジション全体から生じます。たとえば、ETHを10,000ドル相当、LTV 80%で預ければ、借入能力は8,000ドルです。この借入能力は特定の資産に固定されません。
委任承認は負債トークンごとに独立しています。 各変動負債トークン(VariableDebtToken)に対してapproveDelegation()を呼び出すことで、エージェントが借り入れ可能な資産とその量を個別に制御します。各資産には独自の負債トークンコントラクトがあり、各承認は独立しています。
つまり、以下のようなことが可能です:
- ETHを担保として預ける(広範な借入能力を得る)
- エージェントに対して最大500 USDCの借入を承認(USDC VariableDebtToken経由)
- エージェントに対して最大0.1 WETHの借入を承認(WETH VariableDebtToken経由)
- cbETHは未承認のまま(エージェントは一切借りられない)
エージェントは、あなたが明示的に承認した資産のみを、設定された上限額まで借り入れることができます。ただし、借入の容量は単一の預入からではなく、総担保から生じます。
あなたの担保(全体) 委任承認(個別)
┌─────────────────────────────┐ ┌──────────────────────────────┐
│ $5k ETH │ │ USDC DebtToken → エージェント: 500 │
│ $3k USDC │ ───LTV───▶ │ WETH DebtToken → エージェント: 0.1 │
│ $2k cbETH │ = $8k │ cbETH DebtToken → エージェント: 0 │
│ 合計: $10k @ 80% LTV │ 容量 └──────────────────────────────┘
└─────────────────────────────┘
フロー
デリゲーター(あなたのウォレット) エージェントウォレット(委任先)
│ │
│ 1. Aaveに担保を預ける │
│ 2. approveDelegation(エージェント, 量) │
│ をVariableDebtToken上で実行 │
│ │
│ ┌─── 3. borrow(資産, │
│ │ 量, onBehalfOf │
│ │ = デリゲーター) │
│ │ │
│ [あなたのポジションに負債] [エージェントウォレットにトークン]
│ │ │
│ └─── 4. repay(資産, │
│ 量, onBehalfOf │
│ = デリゲーター) │
クイックスタート
前提条件
-
Foundry がインストールされていること(
castCLI):curl -L https://foundry.paradigm.xyz | bash && foundryup -
デリゲーターのセットアップ(ユーザーが1回だけ実行。エージェントは実行しません):
- Aave V3に担保を預ける(app.aave.comまたはコントラクト経由)
- エージェントに借り入れさせたい資産の VariableDebtToken 上で
approveDelegation(agentAddress, maxAmount)を呼び出す - VariableDebtTokenのアドレスは以下で確認可能:
cast call $DATA_PROVIDER "getReserveTokensAddresses(address)(address,address,address)" $ASSET --rpc-url $RPC
-
スキルの設定:
mkdir -p ~/.openclaw/skills/aave-delegation cat > ~/.openclaw/skills/aave-delegation/config.json << 'EOF' { "chain": "base", "rpcUrl": "https://mainnet.base.org", "agentPrivateKey": "0xYOUR_AGENT_PRIVATE_KEY", "delegatorAddress": "0xYOUR_MAIN_WALLET", "poolAddress": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5", "dataProviderAddress": "0x2d8A3C5677189723C4cB8873CfC9C8976FDF38Ac", "assets": { "USDC": { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "WETH": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18 } }, "safety": { "minHealthFactor": "1.5", "maxBorrowPerTx": "1000", "maxBorrowPerTxUnit": "USDC" } } EOF -
セットアップの確認:
scripts/aave-setup.sh
コア機能
ステータス確認(承認量、ヘルス、負債)
# 完全なステータスレポート
scripts/aave-status.sh
# 特定の資産の委任を確認
scripts/aave-status.sh USDC
# ヘルスファクターのみ表示
scripts/aave-status.sh --health-only
委任による借入
# 100 USDCを借り入れ
scripts/aave-borrow.sh USDC 100
# 0.5 WETHを借り入れ
scripts/aave-borrow.sh WETH 0.5
借入スクリプトは自動的に:
- 委任承認量を確認(十分か?)
- デリゲーターのヘルスファクターを確認(借入しても安全か?)
- 借入を実行
- 結果を報告
負債の返済
# 100 USDCを返済
scripts/aave-repay.sh USDC 100
# USDCの負債を全額返済
scripts/aave-repay.sh USDC max
返済スクリプトは自動的に:
- Poolがトークンを使用することを承認(必要な場合)
- 返済を実行
- 残りの負債を報告
安全システム
すべての借入操作は、実行前に以下のチェックを実行します:
- 委任承認量 — 残りの承認量が要求量以上か?
- ヘルスファクター — この借入後もデリゲーターのヘルスファクターが
minHealthFactor(デフォルト1.5)を超えているか? - 1取引あたりの上限 — 量が
maxBorrowPerTx以下か? - 確認 — 送信前に操作の詳細をすべてログ出力
いずれかのチェックが失敗した場合、借入は明確なエラーメッセージとともに中止されます。
⚠️ エージェントは絶対に安全チェックをバイパスしてはいけません。 ユーザーが借入を依頼してもヘルスファクターが低すぎる場合、エージェントは拒否し、その理由を説明しなければなりません。
機能一覧
読み取り操作(ガス不要)
- 委任承認量の確認 — エージェントがまだいくら借り入れ可能か?
- ヘルスファクターの確認 — デリゲーターのポジションは安全か?
- 未返済負債の確認 — 各資産でデリゲーターがいくら負債を抱えているか?
- 利用可能流動性の確認 — Aaveプールに借り入れ可能な十分な量があるか?
- 負債トークンアドレスの解決 — 任意の資産のVariableDebtTokenを検索
書き込み操作(エージェントウォレットにガスが必要)
- 借入 — 委任されたクレジットに対してAaveから資金を引き出す
- 返済 — 借り入れた資金を返却し、デリゲーターの負債を減らす
- 承認 — Poolが返済用トークンを使用することを承認
サポートチェーン
| チェーン | Poolアドレス | ガスコスト |
|---|---|---|
| Base | 0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 | 非常に低い |
| Ethereum | 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 | 高い |
| Polygon | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | 非常に低い |
| Arbitrum | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | 低い |
完全なアドレス一覧(負債トークン含む)は deployments.md を参照してください。
よくあるパターン
エージェントの自己ガス調達
# 十分なガスがあるか確認
BALANCE=$(cast balance $AGENT_ADDRESS --rpc-url $RPC)
if [ "$BALANCE" -lt "1000000000000000" ]; then # < 0.001 ETH
# ガス代として少量のWETHを借り入れ
aave-borrow.sh WETH 0.005
fi
Bankrを使った借入+スワップ
# 委任クレジットからUSDCを借り入れ
aave-borrow.sh USDC 100
# Bankrを使ってETHにスワップ
bankr.sh "Swap 100 USDC for ETH on Base"
定期的DCA
# エージェントが毎週USDCを借り入れ、ETHにスワップ
aave-borrow.sh USDC 100
bankr.sh "Swap 100 USDC for ETH on Base"
安全第一のポートフォリオリバランス
# まず常にヘルスを確認
aave-status.sh
# 健全な場合のみ借り入れ
aave-borrow.sh USDC 500
設定リファレンス
config.json フィールド
| フィールド | 必須 | 説明 |
|---|---|---|
chain | はい | チェーン名(base, ethereum, polygon, arbitrum) |
rpcUrl | はい | JSON-RPCエンドポイントURL |
agentPrivateKey | はい | エージェントウォレットの秘密鍵(0xプレフィックス) |
delegatorAddress | はい | クレジットを委任したユーザーのメインウォレット |
poolAddress | はい | Aave V3 Poolコントラクトアドレス |
dataProviderAddress | はい | Aave V3 PoolDataProviderアドレス |
assets | はい | シンボル→{address, decimals}のマップ |
safety.minHealthFactor | いいえ | 借入後の最小HF(デフォルト: 1.5) |
safety.maxBorrowPerTx | いいえ | 1取引あたりの最大借入額(デフォルト: 1000) |
safety.maxBorrowPerTxUnit | いいえ | maxBorrowPerTxの単位(デフォルト: USDC) |
環境変数(configを上書き)
| 変数 | 上書き対象 |
|---|---|
AAVE_RPC_URL | rpcUrl |
AAVE_AGENT_PRIVATE_KEY | agentPrivateKey |
AAVE_DELEGATOR_ADDRESS | delegatorAddress |
AAVE_POOL_ADDRESS | poolAddress |
AAVE_MIN_HEALTH_FACTOR | safety.minHealthFactor |
エラーハンドリング
| エラー | 原因 | 修正方法 |
|---|---|---|
INSUFFICIENT_ALLOWANCE | 委任量を超過 | デリゲーターが再度approveDelegation()を呼び出す |
HEALTH_FACTOR_TOO_LOW | 借入により清算リスクが発生 | 量を減らすか、担保を追加する |
AMOUNT_EXCEEDS_CAP | 1取引あたりの安全上限に到達 | 量を減らすか、設定を更新する |
INSUFFICIENT_LIQUIDITY | Aaveプールに十分な流動性がない | より少ない量か、別の資産を試す |
INSUFFICIENT_GAS | エージェントウォレットにネイティブトークンがない | エージェントウォレットにガス代を送金する |
EMODE_MISMATCH | 資産がデリゲーターのeModeと互換性がない | 同じeModeカテゴリの資産を借り入れる |
セキュリティ
完全な脅威モデルと緊急手順については safety.md を参照してください。
重要なルール:
- デリゲーターの秘密鍵は絶対にこのリポジトリ、設定、スクリプトに含めてはいけません — これはエージェントの作業領域です。デリゲーターはAave UIまたはブロックエクスプローラ経由で自身の操作を行います。
- config.jsonをバージョン管理にコミットしてはいけません — エージェントの秘密鍵が含まれています
minHealthFactorを1.2未満に設定してはいけません — 清算は1.0で発生します- 常に委任量に上限を設けてください —
type(uint256).maxを承認しないでください - デリゲーターのヘルスを監視してください — HFが2.0を下回った場合にアラートを設定してください
- 安全チェックに失敗した場合、エージェントは指示されても借入を拒否しなければなりません
リソース
- Aave V3 ドキュメント: https://docs.aave.com/developers
- クレジット委任ガイド: https://docs.aave.com/developers/guides/credit-delegation
- Aave アドレスブック: https://github.com/bgd-labs/aave-address-book
- Foundry ブック: https://book.getfoundry.sh/
- DebtToken リファレンス: https://docs.aave.com/developers/tokens/debttoken