agent-credit

Cos'è agent-credit?

agent-credit è un kit di delega di credito per agenti AI che permette a un agente di prendere in prestito fondi da una posizione Aave e ripagarli successivamente per conto del delegante. L'idea centrale è separare il permesso di borrowing dell'agente dal suo rimborso del debito, così puoi definire quali asset l'agente può prendere in prestito e quanto, mentre la capacità di borrowing deriva dal tuo collaterale.

Il repository fornisce script bash (invocati dall'agente) per impostare lo stato di delega, eseguire borrowing delegati, ripagare debiti delegati e verificare allowance/salute prima dell'esecuzione. È progettato per funzionare con Aave V2 e Aave V3 su chain EVM dove Aave è deployato, con esempi del repository preconfigurati per Base, Ethereum, Polygon e Arbitrum.

Caratteristiche Principali

• Borrowing delegato via Aave: L'agente prende in prestito da Aave quando ha bisogno di fondi, e il debito risultante si accumula sulla posizione Aave del delegante.
• Approvazioni di delega per asset: Approvi la delega indipendentemente per ogni contratto di debt token (es. USDC vs WETH), così l'agente non può prendere in prestito asset che non hai esplicitamente consentito.
• Capacità di borrowing olistica dal collaterale: Il potere di borrowing deriva dalla tua posizione collaterale completa e dall'LTV configurato, ma il borrowing disponibile per ogni asset è limitato dalle approvazioni di delega specifiche che imposti.
• Workflow scriptato per l'esecuzione dell'agente: Gli script forniti gestiscono controlli di setup, chiamate di borrow delegato, rimborsi delegati e report di stato, con abort su controlli di sicurezza falliti.
• Controlli di sicurezza prima del borrowing: Ogni borrow esegue controlli inclusi un cap per transazione, sufficienza dell'allowance di delega, health factor post-borrow e se il wallet dell'agente ha abbastanza ETH per il gas.
• Gestione chiavi progettata per evitare esposizione della private key: L'agente non riceve mai la private key del delegante; tiene la sua chiave per firmare transazioni di borrow/repay e usa l'indirizzo pubblico del delegante per targettizzare la posizione Aave corretta.
• Parametri di sicurezza configurabili: Gli script di borrow fanno riferimento a valori di configurazione come safety.maxBorrowPerTx e safety.minHealthFactor (default 1.5).

Come Usare agent-credit

1. Imposta la delega dal tuo wallet: Usando l'UI di Aave o un block explorer, configura il tuo collaterale e poi imposta approvazioni di delega per i debt token specifici che l'agente può prendere in prestito (es. debt token USDC → importo agente).
2. Prepara la configurazione: Usa config.example.json come punto di partenza per definire i valori usati dagli script, inclusi parametri di sicurezza e target di borrowing.
3. Esegui gli script forniti dall'agente: Gli script del repository sono pensati per l'esecuzione dell'agente, non del delegante. Flusso tipico degli script include:
   • aave-setup.sh per verificare config/dipendenze e stato di delega
   • aave-borrow.sh <SYMBOL> <AMOUNT> per borrowing via delega (dopo controlli di sicurezza)
   • aave-repay.sh <SYMBOL> <AMOUNT|max> per ripagare debito per conto del delegante
   • aave-status.sh [SYMBOL] [--health-only] [--json] per controllare allowance e health factor
4. Revoca quando necessario: Puoi revocare la delega impostandola a 0 per i debt token rilevanti in qualsiasi momento.

Casi d'Uso

• Operazioni agent on-demand senza funding manuale: Un agente prende in prestito stablecoin o token via delega solo quando serve per coprire costi operativi, invece di richiedere pre-funding ripetuto del suo wallet.
• Swap periodici gestiti dall'agente via toolkit DeFi: Combinato con skill Bankr (come descritto nel repository), l'agente può prendere in prestito USDC via delega e poi swap/bridge/deploy usando flussi Bankr.
• DCA autonomo usando USDC delegato: L'agente può prendere in prestito USDC periodicamente e usarlo per acquisire ETH (via swap) come parte di un workflow tipo DCA.
• Autosufficienza gas per l'esecuzione: Il setup prevede di prendere in prestito una piccola quantità di WETH per coprire il gas dell'agente quando il suo balance ETH si esaurisce.
• Accesso liquidità protetto da health: Prima di ogni borrow, gli script controllano l'health factor del delegante e abortiscono la transazione se il post-borrow violerebbe la soglia configurata.

FAQ

L'agente ha accesso alla chiave privata del delegante? No. La sezione sulla sicurezza afferma che l'agente non ha mai accesso alla chiave privata del delegante; possiede la propria chiave per firmare le transazioni di borrowing/repay e usa solo l'indirizzo pubblico del delegante per selezionare la posizione corretta.

Come decide l'agente quanto può prendere in prestito? La capacità di borrowing deriva dalla posizione totale di collaterale del delegante (olistica), ma gli importi prendibili in prestito dall'agente per ciascun asset sono limitati dalle approvazioni di delega per debt token configurate tramite approveDelegation().

Cosa impedisce borrowing non sicuri? Per ogni borrow, gli script eseguono controlli tra cui un cap per transazione (safety.maxBorrowPerTx), sufficienza dell'allowance di delega, un vincolo sul health factor (safety.minHealthFactor, default 1.5 menzionato), e verifica che l'agente abbia ETH sufficienti per il gas. Se un controllo fallisce, il borrow si interrompe con un errore.

Quali network e versioni di Aave sono supportate? Il repository indica che funziona su Aave V2 e Aave V3, ed è preconfigurato per Base, Ethereum, Polygon e Arbitrum, pur essendo destinato a qualsiasi chain EVM dove Aave è deployato.

L'agente può eseguire questi flow all'interno di diversi framework per agenti? Il contenuto nota che gli script sono plain bash più cast di Foundry, quindi utilizzabili in qualsiasi ambiente con shell. Il repo menziona anche compatibilità con OpenClaw (installabile come skill) e esecuzione diretta degli script da una sessione Claude Code.

Alternative

• Interazione manuale con Aave via wallet/UI: Invece di delegare il borrowing a un agente, tu (o un servizio backend) puoi fornire collaterale, prendere in prestito e ripagare manualmente su Aave; questo mantiene il controllo ma richiede interventi umani più frequenti o integrazioni custom.
• Connettori third-party agente-to-DeFi: Le alternative in questa categoria forniscono un'interfaccia agent-friendly ai protocolli DeFi, ma potrebbero non usare la credit delegation di Aave e i vincoli di approvazione per debt token allo stesso modo.
• Borrowing “agent wallet” basato su contratto on-chain diretto: Alcuni sistemi instradano le azioni dell'agente tramite smart contract dedicati; questo differisce perché il modello di permessi è enforced dalla logica del contratto anziché dalle approvazioni di delega Aave per debt token.
• Costruire un layer custom di delega + sicurezza: Potresti reimplementare tu stesso la gestione della delega e i controlli di sicurezza per il borrowing usando i contratti Aave e guardie alle transazioni; questo differisce dall'uso degli script bash pronti e delle convenzioni di config in questo repository.