agent-credit

¿Qué es agent-credit?

agent-credit es un kit de herramientas de delegación de crédito para agentes de IA que permite a un agente pedir prestado fondos de una posición en Aave y luego devolverlos en nombre del delegador. La idea principal es separar el permiso de préstamo del agente de su devolución de deuda, para que puedas definir qué activos puede pedir prestado el agente y cuánto, mientras que la capacidad de préstamo proviene de tu colateral.

El repositorio proporciona scripts bash (invocados por un agente) para configurar el estado de delegación, realizar préstamos delegados, devolver deuda delegada y verificar permisos/salud antes de ejecutar. Está diseñado para funcionar con Aave V2 y Aave V3 en cadenas EVM donde Aave está desplegado, con ejemplos del repositorio preconfigurados para Base, Ethereum, Polygon y Arbitrum.

Características clave

• Préstamo delegado vía Aave: El agente pide prestado de Aave cuando necesita fondos, y la deuda resultante se acumula en la posición Aave del delegador.
• Aprobaciones de delegación por activo: Apruebas la delegación de forma independiente para cada contrato de token de deuda (p. ej., USDC vs WETH), para que el agente no pueda pedir prestado activos que no hayas permitido explícitamente.
• Capacidad de préstamo holística desde el colateral: El poder de préstamo deriva de tu posición completa de colateral y LTV configurado, pero el préstamo disponible para cada activo está limitado por las aprobaciones de delegación específicas que establezcas.
• Flujo de trabajo scriptado para ejecución del agente: Los scripts proporcionados manejan verificaciones de configuración, llamadas de préstamo delegado, reembolsos delegados y reportes de estado, con abortos en verificaciones de seguridad fallidas.
• Verificaciones de seguridad antes de prestar: Cada préstamo realiza verificaciones que incluyen un límite por transacción, suficiencia de permiso de delegación, factor de salud después del préstamo y si la billetera del agente tiene suficiente ETH para gas.
• Manejo de claves diseñado para evitar exposición de clave privada: El agente nunca recibe la clave privada del delegador; mantiene su propia clave para firmar transacciones de préstamo/reembolso y usa la dirección pública del delegador para dirigirse a la posición Aave correcta.
• Parámetros de seguridad configurables: Los scripts de préstamo referencian valores de configuración como safety.maxBorrowPerTx y safety.minHealthFactor (predeterminado mencionado como 1.5).

Cómo usar agent-credit

1. Configura la delegación desde tu billetera: Usando la UI de Aave o un explorador de bloques, configura tu colateral y luego establece aprobaciones de delegación para los tokens de deuda específicos que el agente puede pedir prestado (p. ej., token de deuda USDC → cantidad del agente).
2. Prepara la configuración: Usa config.example.json como punto de partida para definir valores usados por los scripts, incluyendo parámetros de seguridad y objetivos de préstamo.
3. Ejecuta los scripts proporcionados desde el agente: Los scripts del repositorio están pensados para la ejecución del agente, no del delegador. El flujo típico de scripts incluye:
   • aave-setup.sh para verificar config/dependencies y estado de delegación
   • aave-borrow.sh <SYMBOL> <AMOUNT> para pedir prestado vía delegación (después de verificaciones de seguridad)
   • aave-repay.sh <SYMBOL> <AMOUNT|max> para devolver deuda en nombre del delegador
   • aave-status.sh [SYMBOL] [--health-only] [--json] para verificar permisos y factor de salud
4. Revoca cuando sea necesario: Puedes revocar la delegación estableciendo la delegación en 0 para los tokens de deuda relevantes en cualquier momento.

Casos de uso

• Operaciones de agente bajo demanda sin fondeo manual: Un agente pide prestado stablecoins o tokens vía delegación solo cuando necesita cubrir costos operativos, en lugar de requerir que fondees su billetera repetidamente.
• Swaps periódicos gestionados por agente vía kit DeFi: Combinado con habilidades de Bankr (como se describe en el repositorio), el agente puede pedir prestado USDC vía delegación y luego swap/bridge/deploy usando flujos de Bankr.
• DCA autónomo usando USDC delegado: El agente puede pedir prestado USDC periódicamente y usarlo para adquirir ETH (vía swap) como parte de un flujo tipo DCA.
• Autosuficiencia de gas para ejecución: La configuración describe pedir prestado una pequeña cantidad de WETH para cubrir el gas del agente cuando su saldo de ETH se agota.
• Acceso a liquidez protegido por salud: Antes de cada préstamo, los scripts verifican el factor de salud del delegador y abortan la transacción si la salud post-préstamo violaría el umbral configurado.

Preguntas frecuentes

¿El agente tiene acceso a la clave privada del delegador? No. La sección de seguridad indica que el agente nunca tiene acceso a la clave privada del delegador; posee su propia clave para firmar transacciones de préstamo/devolución y solo usa la dirección pública del delegador para seleccionar la posición correcta.

¿Cómo decide el agente cuánto puede pedir prestado? La capacidad de préstamo proviene de la posición total de colateral del delegador (holística), pero las cantidades prestables del agente para cada activo están limitadas por aprobaciones de delegación por debt-token configuradas mediante approveDelegation().

¿Qué impide préstamos inseguros? Para cada préstamo, los scripts ejecutan verificaciones que incluyen un límite por transacción (safety.maxBorrowPerTx), suficiencia de allowance de delegación, una restricción de health factor (safety.minHealthFactor, por defecto 1.5), y asegurar que el agente tenga suficiente ETH para gas. Si alguna verificación falla, el préstamo se aborta con un error.

¿Qué redes y versiones de Aave son compatibles? El repositorio indica que funciona en Aave V2 y Aave V3, y que está preconfigurado para Base, Ethereum, Polygon y Arbitrum, además de estar diseñado para cualquier cadena EVM donde esté desplegado Aave.

¿Puede el agente ejecutar estos flujos dentro de diferentes frameworks de agentes? El contenido señala que los scripts son bash puro más cast de Foundry, por lo que se pueden usar en cualquier entorno con shell. El repo también menciona compatibilidad con OpenClaw (instalando como skill) y ejecución directa de scripts desde una sesión de Claude Code.

Alternativas

• Interacción manual con Aave vía wallet/UI: En lugar de delegar préstamos a un agente, tú (o un servicio backend) puedes suministrar colateral, pedir prestado y devolver manualmente en Aave; esto mantiene el control pero requiere intervención humana más frecuente o integración personalizada.
• Conectores de agentes a DeFi de terceros: Las alternativas en esta categoría proporcionan una interfaz amigable para agentes a protocolos DeFi, pero pueden no usar delegación de crédito de Aave y restricciones de aprobación por debt-token de la misma manera.
• Préstamos de “wallet de agente” basados directamente en contratos on-chain: Algunos sistemas enrutan acciones de agentes a través de contratos inteligentes dedicados; esto difiere porque el modelo de permisos se aplica mediante lógica de contrato en lugar de aprobaciones de delegación de Aave por debt token.
• Construir una capa personalizada de delegación + seguridad: Podrías reimplementar la gestión de delegación y verificaciones de seguridad de préstamo tú mismo usando contratos de Aave y guards de transacción; esto difiere de usar los scripts bash listos y convenciones de config de este repositorio.