agent-credit

Qu'est-ce qu'agent-credit ?

agent-credit est un kit d'outils de délégation de crédit pour agents IA qui permet à un agent d'emprunter des fonds depuis une position Aave et de rembourser plus tard au nom du délégateur. L'idée principale est de séparer la permission d'emprunt de l'agent de son remboursement de dette, afin de définir quels actifs l'agent peut emprunter et combien, tandis que la capacité d'emprunt provient de votre collatéral.

Le dépôt fournit des scripts bash (invoqués par un agent) pour configurer le statut de délégation, effectuer des emprunts délégués, rembourser les dettes déléguées, et vérifier les autorisations/santé avant exécution. Il est conçu pour fonctionner avec Aave V2 et Aave V3 sur les chaînes EVM où Aave est déployé, avec des exemples du dépôt préconfigurés pour Base, Ethereum, Polygon et Arbitrum.

Fonctionnalités clés

• Emprunt délégué via Aave : L'agent emprunte sur Aave quand il a besoin de fonds, et la dette résultante s'accumule sur la position Aave du délégateur.
• Approbations de délégation par actif : Vous approuvez la délégation indépendamment pour chaque contrat de jeton de dette (ex. : USDC vs WETH), afin que l'agent ne puisse pas emprunter des actifs non explicitement autorisés.
• Capacité d'emprunt globale depuis le collatéral : La puissance d'emprunt provient de votre position de collatéral complète et du LTV configuré, mais l'emprunt disponible pour chaque actif est limité par les approbations de délégation spécifiques que vous définissez.
• Flux scripté pour exécution par l'agent : Les scripts fournis gèrent les vérifications de configuration, les appels d'emprunt délégué, les remboursements délégués et les rapports de statut, avec arrêts en cas d'échec des vérifications de sécurité.
• Vérifications de sécurité avant emprunt : Chaque emprunt effectue des contrôles incluant un plafond par transaction, suffisance de l'autorisation de délégation, facteur de santé après emprunt, et si le portefeuille de l'agent a assez d'ETH pour le gas.
• Gestion des clés évitant l'exposition de clé privée : L'agent ne reçoit jamais la clé privée du délégateur ; il utilise sa propre clé pour signer les transactions d'emprunt/remboursement et l'adresse publique du délégateur pour cibler la bonne position Aave.
• Paramètres de sécurité configurables : Les scripts d'emprunt référencent des valeurs de configuration comme safety.maxBorrowPerTx et safety.minHealthFactor (par défaut 1.5).

Comment utiliser agent-credit

1. Configurer la délégation depuis votre portefeuille : Via l'interface Aave ou un explorateur de blocs, configurez votre collatéral puis définissez les approbations de délégation pour les jetons de dette spécifiques que l'agent est autorisé à emprunter (ex. : jeton de dette USDC → montant agent).
2. Préparer la configuration : Utilisez config.example.json comme point de départ pour définir les valeurs utilisées par les scripts, incluant les paramètres de sécurité et les cibles d'emprunt.
3. Exécuter les scripts fournis depuis l'agent : Les scripts du dépôt sont destinés à l'exécution par l'agent, non par le délégateur. Flux typique des scripts :
   • aave-setup.sh pour vérifier config/dépendances et statut de délégation
   • aave-borrow.sh <SYMBOL> <AMOUNT> pour emprunter via délégation (après vérifications de sécurité)
   • aave-repay.sh <SYMBOL> <AMOUNT|max> pour rembourser la dette au nom du délégateur
   • aave-status.sh [SYMBOL] [--health-only] [--json] pour vérifier autorisations et facteur de santé
4. Révoquer si nécessaire : Vous pouvez révoquer la délégation en la fixant à 0 pour le(s) jeton(s) de dette concerné(s) à tout moment.

Cas d'usage

• Opérations d'agent à la demande sans financement manuel : Un agent emprunte des stablecoins ou jetons via délégation seulement quand il doit couvrir ses coûts opérationnels, au lieu de nécessiter un préfinancement répété de son portefeuille.
• Swaps périodiques gérés par agent via kit DeFi : Combiné aux compétences Bankr (comme décrit dans le dépôt), l'agent peut emprunter USDC via délégation puis swapper/bridger/déployer via les flux Bankr.
• DCA autonome avec USDC délégué : L'agent peut emprunter périodiquement USDC et l'utiliser pour acquérir ETH (via swap) dans un flux de type DCA.
• Autosuffisance gas pour exécution : La configuration décrit l'emprunt d'un petit montant de WETH pour couvrir le gas de l'agent quand son solde ETH est bas.
• Accès à liquidité protégé par santé : Avant chaque emprunt, les scripts vérifient le facteur de santé du délégateur et annulent la transaction si la santé post-emprunt violerait le seuil configuré.

FAQ

L’agent a-t-il accès à la clé privée du délégateur ? Non. La section sécurité indique que l’agent n’a jamais accès à la clé privée du délégateur ; il détient sa propre clé pour signer les transactions d’emprunt/remboursement et n’utilise que l’adresse publique du délégateur pour sélectionner la bonne position.

Comment l’agent décide-t-il du montant qu’il peut emprunter ? La capacité d’emprunt provient de la position de collatéral totale du délégateur (holistique), mais les montants empruntables par l’agent pour chaque actif sont limités par les approbations de délégation par debt token configurées via approveDelegation().

Qu’est-ce qui empêche les emprunts risqués ? Pour chaque emprunt, les scripts exécutent des vérifications incluant un plafond par transaction (safety.maxBorrowPerTx), la suffisance de l’autorisation de délégation, une contrainte de health factor (safety.minHealthFactor, défaut 1.5 mentionné), et la garantie que l’agent dispose de suffisamment d’ETH pour le gas. Si une vérification échoue, l’emprunt s’annule avec une erreur.

Quels réseaux et versions d’Aave sont prises en charge ? Le dépôt indique qu’il fonctionne sur Aave V2 et Aave V3, préconfiguré pour Base, Ethereum, Polygon et Arbitrum, et conçu pour toute chaîne EVM où Aave est déployé.

L’agent peut-il exécuter ces flux dans différents frameworks d’agents ? Le contenu note que les scripts sont en bash pur avec cast de Foundry, utilisables dans tout environnement avec un shell. Le dépôt mentionne aussi la compatibilité avec OpenClaw (installation en tant que skill) et l’exécution directe des scripts depuis une session Claude Code.

Alternatives

• Interaction manuelle avec Aave via wallet/UI : Au lieu de déléguer l’emprunt à un agent, vous (ou un service backend) pouvez manuellement fournir du collatéral, emprunter et rembourser sur Aave ; cela conserve le contrôle mais nécessite plus d’interventions humaines ou d’intégrations personnalisées.
• Connecteurs agent-DeFi tiers : Les alternatives de cette catégorie fournissent une interface adaptée aux agents pour les protocoles DeFi, mais n’utilisent pas la délégation de crédit Aave et les contraintes d’approbation par debt token de la même manière.
• Emprunt “agent wallet” basé sur contrats on-chain directs : Certains systèmes routent les actions d’agent via des smart contracts dédiés ; cela diffère car le modèle de permission est appliqué par la logique du contrat plutôt que par les approbations de délégation Aave par debt token.
• Construire une couche personnalisée de délégation + sécurité : Vous pourriez réimplémenter la gestion de délégation et les vérifications de sécurité d’emprunt vous-même avec les contrats Aave et des gardes de transactions ; cela diffère de l’utilisation des scripts bash prêts à l’emploi et des conventions de config de ce dépôt.