Que fait Délégation de Crédit Aave ?
Empruntez des fonds depuis Aave en utilisant du crédit délégué. Votre portefeuille principal fournit une garantie et délègue le pouvoir d'emprunt au portefeuille de l'agent. L'agent peut alors emprunter des tokens de manière autonome lorsque nécessaire — la dette est accumulée contre la position du délégateur.
Protocole : Fonctionne sur Aave V3 et Aave V2 — les signatures de fonctions pour la délégation de crédit (
borrow,repay,approveDelegation,borrowAllowance) sont identiques entre les deux versions. Il suffit d'échanger les adresses du LendingPool et du ProtocolDataProvider de la V2. La seule différence cosmétique : la V3 retourne la garantie/la dette en USD (8 décimales), la V2 en ETH (18 décimales). La vérification du facteur de santé fonctionne correctement sur les deux.
Compatible Avec
- OpenClaw — Installez comme une compétence, l'agent emprunte de manière autonome
- Claude Code — Exécutez les scripts directement depuis une session Claude Code
- Tout framework d'agent — Bash simple +
castde Foundry, fonctionne partout avec un shell
Se combine avec les compétences Bankr pour des flux emprunt-puis-échange : empruntez USDC via délégation, puis utilisez Bankr pour échanger, pontifier ou déployer.
Comment Fonctionne la Délégation de Crédit
La délégation de crédit dans Aave V3 sépare deux choses : le pouvoir d'emprunt et l'approbation de délégation.
Le pouvoir d'emprunt est holistique. Il provient de l'ensemble de votre position de garantie sur tous les actifs. Si vous déposez 10 000 $ d'ETH avec un LTV de 80%, vous avez 8 000 $ de pouvoir d'emprunt — point final. Ce pouvoir d'emprunt n'est pas lié à un actif spécifique.
L'approbation de délégation est isolée par token de dette. Vous contrôlez quels actifs l'agent peut emprunter et combien de chacun en appelant approveDelegation() sur des VariableDebtTokens individuels. Chaque actif a son propre contrat de token de dette, et chaque approbation est indépendante.
Cela signifie que vous pouvez, par exemple :
- Déposer de l'ETH comme garantie (vous donne un large pouvoir d'emprunt)
- Approuver l'agent pour emprunter jusqu'à 500 USDC (via le VariableDebtToken USDC)
- Approuver l'agent pour emprunter jusqu'à 0,1 WETH (via le VariableDebtToken WETH)
- Laisser cbETH non approuvé (l'agent ne peut pas l'emprunter du tout)
L'agent ne peut emprunter que les actifs que vous avez explicitement approuvés, jusqu'aux montants que vous avez définis — mais la capacité d'emprunt provient de votre garantie totale, pas d'un seul dépôt.
Votre Garantie (holistique) Approbations de Délégation (isolées)
┌─────────────────────────┐ ┌──────────────────────────────┐
│ $5k ETH │ │ USDC DebtToken → agent : 500 │
│ $3k USDC │ ───LTV───▶ │ WETH DebtToken → agent : 0,1 │
│ $2k cbETH │ = $8k │ cbETH DebtToken → agent : 0 │
│ Total : $10k @ 80% LTV │ capacité └──────────────────────────────┘
└─────────────────────────┘
Flux
Délégateur (votre portefeuille) Portefeuille Agent (délégataire)
│ │
│ 1. fournir une garantie à Aave │
│ 2. approveDelegation(agent, montant) │
│ sur le VariableDebtToken │
│ │
│ ┌─── 3. borrow(actif, │
│ │ montant, onBehalfOf │
│ │ = délégateur) │
│ │ │
│ [dette sur VOTRE position] [tokens dans le portefeuille agent]
│ │ │
│ └─── 4. repay(actif, │
│ montant, onBehalfOf │
│ = délégateur) │
Démarrage Rapide
Prérequis
-
Foundry doit être installé (CLI
cast) :curl -L https://foundry.paradigm.xyz | bash && foundryup -
Configuration du délégateur (effectuée UNE FOIS par l'utilisateur, PAS par l'agent) :
- Fournir une garantie à Aave V3 (via app.aave.com ou contrat)
- Appeler
approveDelegation(agentAddress, maxAmount)sur le VariableDebtToken de l'actif que vous voulez que l'agent emprunte - L'adresse du VariableDebtToken peut être trouvée via :
cast call $DATA_PROVIDER "getReserveTokensAddresses(address)(address,address,address)" $ASSET --rpc-url $RPC
-
Configurer la compétence :
mkdir -p ~/.openclaw/skills/aave-delegation cat > ~/.openclaw/skills/aave-delegation/config.json << 'EOF' { "chain": "base", "rpcUrl": "https://mainnet.base.org", "agentPrivateKey": "0xVOTRE_CLE_PRIVEE_AGENT", "delegatorAddress": "0xVOTRE_PORTEFEUILLE_PRINCIPAL", "poolAddress": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5", "dataProviderAddress": "0x2d8A3C5677189723C4cB8873CfC9C8976FDF38Ac", "assets": { "USDC": { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "WETH": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18 } }, "safety": { "minHealthFactor": "1.5", "maxBorrowPerTx": "1000", "maxBorrowPerTxUnit": "USDC" } } EOF -
Vérifier la configuration :
scripts/aave-setup.sh
Utilisation Principale
Vérifier l'état (allocation, santé, dette)
# Rapport d'état complet
scripts/aave-status.sh
# Vérifier la délégation d'un actif spécifique
scripts/aave-status.sh USDC
# Juste le facteur de santé
scripts/aave-status.sh --health-only
Emprunter via Délégation
# Emprunter 100 USDC
scripts/aave-borrow.sh USDC 100
# Emprunter 0,5 WETH
scripts/aave-borrow.sh WETH 0.5
Le script d'emprunt automatise :
- Vérifie l'allocation de délégation (suffisante ?)
- Vérifie le facteur de santé du délégateur (sûr d'emprunter ?)
- Exécute l'emprunt
- Rapporte le résultat
Rembourser la Dette
# Rembourser 100 USDC
scripts/aave-repay.sh USDC 100
# Rembourser toute la dette USDC
scripts/aave-repay.sh USDC max
Le script de remboursement automatise :
- Approuve le Pool à dépenser le token (si nécessaire)
- Exécute le remboursement
- Rapporte la dette restante
Système de Sécurité
Chaque opération d'emprunt effectue ces vérifications AVANT l'exécution :
- Allocation de délégation — L'allocation restante est-elle >= au montant demandé ?
- Facteur de santé — Le facteur de santé du délégateur est-il >
minHealthFactor(défaut 1.5) APRÈS cet emprunt ? - Plafond par transaction — Le montant est-il <=
maxBorrowPerTx? - Confirmation — Enregistre les détails complets de l'opération avant l'envoi
Si l'une des vérifications échoue, l'emprunt est annulé avec un message d'erreur clair.
⚠️ L'agent ne doit JAMAIS contourner les vérifications de sécurité. Si l'utilisateur demande à l'agent d'emprunter et que le facteur de santé est trop bas, l'agent doit refuser et expliquer pourquoi.
Capacités
Opérations de Lecture (pas de gaz nécessaire)
- Vérifier l'allocation de délégation — Combien l'agent peut-il encore emprunter ?
- Vérifier le facteur de santé — La position du délégateur est-elle sûre ?
- Vérifier la dette impayée — Combien le délégateur doit-il par actif ?
- Vérifier la liquidité disponible — Y a-t-il assez dans le pool Aave pour emprunter ?
- Résoudre les adresses des tokens de dette — Rechercher le VariableDebtToken pour tout actif
Opérations d'Écriture (nécessite du gaz dans le portefeuille de l'agent)
- Emprunter — Retirer des fonds d'Aave contre du crédit délégué
- Rembourser — Retourner les fonds empruntés pour réduire la dette du délégateur
- Approuver — Approuver le Pool à dépenser des tokens pour le remboursement
Chaînes Supportées
| Chaîne | Adresse du Pool | Coût en Gaz |
|---|---|---|
| Base | 0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 | Très Bas |
| Ethereum | 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 | Élevé |
| Polygon | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | Très Bas |
| Arbitrum | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | Bas |
Voir deployments.md pour la liste complète des adresses incluant les tokens de dette.
Modèles Courants
Auto-Financement de l'Agent pour le Gaz
# Vérifier si nous avons assez de gaz
SOLDE=$(cast balance $AGENT_ADDRESS --rpc-url $RPC)
if [ "$SOLDE" -lt "1000000000000000" ]; then # < 0.001 ETH
# Emprunter une petite quantité de WETH pour le gaz
aave-borrow.sh WETH 0.005
fi
Emprunter + Échanger via Bankr
# Emprunter USDC depuis le crédit délégué
aave-borrow.sh USDC 100
# Échanger en ETH en utilisant Bankr
bankr.sh "Échange 100 USDC pour ETH sur Base"
DCA Périodique
# L'agent emprunte USDC chaque semaine et échange en ETH
aave-borrow.sh USDC 100
bankr.sh "Échange 100 USDC pour ETH sur Base"
Rééquilibrage de Portefeuille Axé sur la Sécurité
# Toujours vérifier la santé d'abord
aave-status.sh
# N'emprunter que si sain
aave-borrow.sh USDC 500
Référence de Configuration
Champs config.json
| Champ | Requis | Description |
|---|---|---|
chain | Oui | Nom de la chaîne (base, ethereum, polygon, arbitrum) |
rpcUrl | Oui | URL du point de terminaison JSON-RPC |
agentPrivateKey | Oui | Clé privée du portefeuille de l'agent (préfixe 0x) |
delegatorAddress | Oui | Portefeuille principal de l'utilisateur qui a délégué le crédit |
poolAddress | Oui | Adresse du contrat Pool Aave V3 |
dataProviderAddress | Oui | Adresse du PoolDataProvider Aave V3 |
assets | Oui | Map symbole → {address, decimals} |
safety.minHealthFactor | Non | HF minimal après emprunt (défaut : 1.5) |
safety.maxBorrowPerTx | Non | Emprunt max par transaction (défaut : 1000) |
safety.maxBorrowPerTxUnit | Non | Unité pour maxBorrowPerTx (défaut : USDC) |
Variables d'Environnement (remplacent config)
| Variable | Remplace |
|---|---|
AAVE_RPC_URL | rpcUrl |
AAVE_AGENT_PRIVATE_KEY | agentPrivateKey |
AAVE_DELEGATOR_ADDRESS | delegatorAddress |
AAVE_POOL_ADDRESS | poolAddress |
AAVE_MIN_HEALTH_FACTOR | safety.minHealthFactor |
Gestion des Erreurs
| Erreur | Cause | Correctif |
|---|---|---|
INSUFFICIENT_ALLOWANCE | Montant de délégation dépassé | Le délégateur doit rappeler approveDelegation() |
HEALTH_FACTOR_TOO_LOW | L'emprunt risquerait la liquidation | Réduire le montant ou ajouter de la garantie |
AMOUNT_EXCEEDS_CAP | Plafond de sécurité par transaction atteint | Réduire le montant ou mettre à jour la config |
INSUFFICIENT_LIQUIDITY | Pas assez dans le pool Aave | Essayer un montant plus petit ou un actif différent |
INSUFFICIENT_GAS | Le portefeuille de l'agent n'a pas de token natif | Envoyer du gaz au portefeuille de l'agent |
EMODE_MISMATCH | Actif incompatible avec l'eMode du délégateur | Emprunter un actif dans la même catégorie eMode |
Sécurité
Voir safety.md pour le modèle de menace complet et les procédures d'urgence.
Règles critiques :
- La clé privée du délégateur ne doit JAMAIS être dans ce dépôt, configuration ou scripts — c'est l'espace de travail de l'agent. Le délégateur gère son côté via l'interface Aave ou un explorateur de blocs.
- Ne jamais commettre config.json dans le contrôle de version — il contient la clé privée de l'agent
- Ne jamais définir
minHealthFactoren dessous de 1.2 — la liquidation se produit à 1.0 - Toujours plafonner les montants de délégation — ne jamais approuver
type(uint256).max - Surveiller la santé du délégateur — configurer des alertes si le HF descend en dessous de 2.0
- L'agent doit refuser d'emprunter si les vérifications de sécurité échouent, même si on lui ordonne de le faire
Ressources
- Documentation Aave V3 : https://docs.aave.com/developers
- Guide de Délégation de Crédit : https://docs.aave.com/developers/guides/credit-delegation
- Carnet d'Adresses Aave : https://github.com/bgd-labs/aave-address-book
- Documentation Foundry : https://book.getfoundry.sh/
- Référence DebtToken : https://docs.aave.com/developers/tokens/debttoken