agent-credit

O que é agent-credit?

agent-credit é um kit de ferramentas de delegação de crédito para agentes de IA que permite que um agente empreste fundos de uma posição no Aave e depois pague em nome do delegador. A ideia central é separar a permissão de empréstimo do agente do pagamento da dívida, para que você possa definir quais ativos o agente pode emprestar e quanto, enquanto a capacidade de empréstimo vem do seu colateral.

O repositório fornece scripts bash (invocados por um agente) para configurar o status de delegação, realizar empréstimos delegados, pagar dívidas delegadas e verificar permissões/saúde antes de executar. É projetado para funcionar com Aave V2 e Aave V3 em chains EVM onde o Aave está implantado, com exemplos do repositório pré-configurados para Base, Ethereum, Polygon e Arbitrum.

Principais Recursos

• Empréstimo delegado via Aave: O agente empresta do Aave quando precisa de fundos, e a dívida resultante acumula na posição Aave do delegador.
• Aprovações de delegação por ativo: Você aprova a delegação independentemente para cada contrato de token de dívida (ex.: USDC vs WETH), para que o agente não possa emprestar ativos que você não autorizou explicitamente.
• Capacidade de empréstimo holística do colateral: O poder de empréstimo deriva da sua posição completa de colateral e LTV configurado, mas o empréstimo disponível para cada ativo é limitado pelas aprovações específicas de delegação que você define.
• Fluxo de trabalho scriptado para execução do agente: Os scripts fornecidos lidam com verificações de configuração, chamadas de empréstimo delegado, pagamentos delegados e relatórios de status, com abortos em verificações de segurança falhas.
• Verificações de segurança antes do empréstimo: Cada empréstimo realiza verificações incluindo um limite por transação, suficiência de permissão de delegação, fator de saúde após o empréstimo e se a carteira do agente tem ETH suficiente para gas.
• Gerenciamento de chaves para evitar exposição de chave privada: O agente nunca recebe a chave privada do delegador; ele usa sua própria chave para assinar transações de empréstimo/pagamento e o endereço público do delegador para mirar a posição Aave correta.
• Parâmetros de segurança configuráveis: Os scripts de empréstimo referenciam valores de configuração como safety.maxBorrowPerTx e safety.minHealthFactor (padrão mencionado como 1.5).

Como Usar agent-credit

1. Configure a delegação da sua carteira: Usando a UI do Aave ou um explorador de blocos, configure seu colateral e depois defina aprovações de delegação para os tokens de dívida específicos que o agente pode emprestar (ex.: token de dívida USDC → agente quantidade).
2. Prepare a configuração: Use config.example.json como ponto de partida para definir valores usados pelos scripts, incluindo parâmetros de segurança e alvos de empréstimo.
3. Execute os scripts fornecidos pelo agente: Os scripts do repositório são destinados à execução do agente, não do delegador. O fluxo típico de script inclui:
   • aave-setup.sh para verificar config/dependências e status de delegação
   • aave-borrow.sh <SYMBOL> <AMOUNT> para emprestar via delegação (após verificações de segurança)
   • aave-repay.sh <SYMBOL> <AMOUNT|max> para pagar dívida em nome do delegador
   • aave-status.sh [SYMBOL] [--health-only] [--json] para verificar permissões e fator de saúde
4. Revogue quando necessário: Você pode revogar a delegação definindo-a como 0 para o(s) token(s) de dívida relevante(s) a qualquer momento.

Casos de Uso

• Operações de agente sob demanda sem financiamento manual: Um agente empresta stablecoins ou tokens via delegação apenas quando precisa cobrir custos operacionais, em vez de exigir que você pré-financie sua carteira repetidamente.
• Swaps periódicos gerenciados por agente via kit DeFi: Combinado com skills do Bankr (como descrito no repositório), o agente pode emprestar USDC via delegação e depois swap/bridge/deploy usando fluxos do Bankr.
• DCA autônomo usando USDC delegado: O agente pode periodicamente emprestar USDC e usá-lo para adquirir ETH (via swap) como parte de um fluxo tipo DCA.
• Autossuficiência em gas para execução: A configuração descreve o empréstimo de uma pequena quantidade de WETH para cobrir o gas do agente quando seu saldo de ETH fica baixo.
• Acesso a liquidez protegido por saúde: Antes de cada empréstimo, os scripts verificam o fator de saúde do delegador e abortam a transação se a saúde pós-empréstimo violar o limite configurado.

FAQ

O agente tem acesso à chave privada do delegador? Não. A seção de segurança afirma que o agente nunca tem acesso à chave privada do delegador; ele possui sua própria chave para assinar transações de empréstimo/pagamento e usa apenas o endereço público do delegador para selecionar a posição correta.

Como o agente decide quanto pode emprestar? A capacidade de empréstimo vem da posição total de colateral do delegador (holística), mas os valores emprestáveis do agente para cada ativo são limitados pelas aprovações de delegação por debt-token configuradas via approveDelegation().

O que impede empréstimos inseguros? Para cada empréstimo, os scripts executam verificações incluindo um limite por transação (safety.maxBorrowPerTx), suficiência da delegação, restrição de health factor (safety.minHealthFactor, padrão 1.5 mencionado), e garantia de ETH suficiente para gas no agente. Se alguma verificação falhar, o empréstimo é abortado com erro.

Quais redes e versões do Aave são suportadas? O repositório afirma que funciona no Aave V2 e Aave V3, pré-configurado para Base, Ethereum, Polygon e Arbitrum, e destinado a qualquer chain EVM onde o Aave esteja implantado.

O agente pode executar esses fluxos em diferentes frameworks de agente? O conteúdo observa que os scripts são bash puro mais cast do Foundry, podendo ser usados em qualquer ambiente com shell. O repo também menciona compatibilidade com OpenClaw (instalando como skill) e execução direta de scripts de uma sessão Claude Code.

Alternativas

• Interação manual no Aave via wallet/UI: Em vez de delegar empréstimos a um agente, você (ou um serviço backend) pode fornecer colateral, emprestar e pagar manualmente no Aave; isso mantém o controle, mas exige intervenção humana ou integração personalizada mais frequente.
• Conectores de agente-para-DeFi de terceiros: Alternativas nessa categoria fornecem uma interface amigável a agentes para protocolos DeFi, mas podem não usar delegação de crédito do Aave e restrições de aprovação por debt-token da mesma forma.
• Empréstimo de “wallet de agente” baseado em contrato on-chain direto: Alguns sistemas roteiam ações de agente por smart contracts dedicados; isso difere porque o modelo de permissão é imposto pela lógica do contrato, não por aprovações de delegação do Aave por debt token.
• Construir camada personalizada de delegação + segurança: Você poderia reimplementar gerenciamento de delegação e verificações de segurança de empréstimo usando contratos do Aave e guards de transação; isso difere do uso dos scripts bash prontos e convenções de config deste repositório.