¿Qué hace Delegación de Crédito Aave?
Pide prestado fondos de Aave usando crédito delegado. Tu monedero principal suministra colateral y delega poder de préstamo al monedero del agente. El agente puede tomar prestados tokens de forma autónoma cuando sea necesario — la deuda se acumula contra la posición del delegante.
Protocolo: Funciona en Aave V3 y Aave V2 — las firmas de funciones para delegación de crédito (
borrow,repay,approveDelegation,borrowAllowance) son idénticas en ambas versiones. Solo hay que intercambiar las direcciones de LendingPool y ProtocolDataProvider de V2. La única diferencia cosmética: V3 devuelve colateral/deuda en USD (8 decimales), V2 en ETH (18 decimales). La verificación de seguridad del factor de salud funciona correctamente en ambas.
Compatible con
- OpenClaw — Instálala como skill, el agente toma prestado de forma autónoma
- Claude Code — Ejecuta scripts directamente desde una sesión de Claude Code
- Cualquier framework de agente — Bash plano + Foundry's
cast, funciona en cualquier lugar con un shell
Se combina con las skills de Bankr para flujos de préstamo-intercambio: toma prestado USDC mediante delegación, luego usa Bankr para intercambiar, puentear o desplegarlo.
Cómo funciona la delegación de crédito
La delegación de crédito en Aave V3 separa dos cosas: poder de préstamo y aprobación de delegación.
El poder de préstamo es holístico. Proviene de toda tu posición de colateral en todos los activos. Si depositas $10k en ETH con un LTV del 80%, tienes $8k de poder de préstamo — punto. Ese poder de préstamo no está bloqueado a ningún activo específico.
La aprobación de delegación está aislada por token de deuda. Controlas qué activos puede tomar prestados el agente y cuánto de cada uno llamando a approveDelegation() en los VariableDebtTokens individuales. Cada activo tiene su propio contrato de token de deuda, y cada aprobación es independiente.
Esto significa que puedes, por ejemplo:
- Depositar ETH como colateral (te da un amplio poder de préstamo)
- Aprobar al agente para tomar prestado hasta 500 USDC (a través del VariableDebtToken de USDC)
- Aprobar al agente para tomar prestado hasta 0.1 WETH (a través del VariableDebtToken de WETH)
- Dejar cbETH sin aprobar (el agente no puede tomarlo prestado)
El agente solo puede tomar prestados activos que hayas aprobado explícitamente, hasta los montos que hayas establecido — pero la capacidad para tomar prestado proviene de tu colateral total, no de un solo depósito.
Tu Colateral (holístico) Aprobaciones de Delegación (aisladas)
┌─────────────────────────┐ ┌──────────────────────────────┐
│ $5k ETH │ │ USDC DebtToken → agente: 500 │
│ $3k USDC │ ───LTV───▶ │ WETH DebtToken → agente: 0.1 │
│ $2k cbETH │ = $8k │ cbETH DebtToken → agente: 0 │
│ Total: $10k @ 80% LTV │ capacidad └──────────────────────────────┘
└─────────────────────────┘
Flujo
Delegante (tu monedero) Monedero del Agente (delegatario)
│ │
│ 1. suministrar colateral a Aave │
│ 2. approveDelegation(agente, cantidad) │
│ en el VariableDebtToken │
│ │
│ ┌─── 3. borrow(activo, │
│ │ cantidad, onBehalfOf │
│ │ = delegante) │
│ │ │
│ [deuda en TU posición] [tokens en monedero del agente]
│ │ │
│ └─── 4. repay(activo, │
│ cantidad, onBehalfOf │
│ = delegante) │
Inicio rápido
Requisitos previos
-
Foundry debe estar instalado (
castCLI):curl -L https://foundry.paradigm.xyz | bash && foundryup -
Configuración del delegante (hecha UNA VEZ por el usuario, NO por el agente):
- Suministra colateral a Aave V3 (a través de app.aave.com o contrato)
- Llama a
approveDelegation(agentAddress, maxAmount)en el VariableDebtToken del activo que quieres que el agente tome prestado - La dirección del VariableDebtToken se puede encontrar mediante:
cast call $DATA_PROVIDER "getReserveTokensAddresses(address)(address,address,address)" $ASSET --rpc-url $RPC
-
Configura la skill:
mkdir -p ~/.openclaw/skills/aave-delegation cat > ~/.openclaw/skills/aave-delegation/config.json << 'EOF' { "chain": "base", "rpcUrl": "https://mainnet.base.org", "agentPrivateKey": "0xYOUR_AGENT_PRIVATE_KEY", "delegatorAddress": "0xYOUR_MAIN_WALLET", "poolAddress": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5", "dataProviderAddress": "0x2d8A3C5677189723C4cB8873CfC9C8976FDF38Ac", "assets": { "USDC": { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "WETH": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18 } }, "safety": { "minHealthFactor": "1.5", "maxBorrowPerTx": "1000", "maxBorrowPerTxUnit": "USDC" } } EOF -
Verifica la configuración:
scripts/aave-setup.sh
Uso básico
Verificar estado (asignación, salud, deuda)
# Informe de estado completo
scripts/aave-status.sh
# Verificar delegación de un activo específico
scripts/aave-status.sh USDC
# Solo factor de salud
scripts/aave-status.sh --health-only
Tomar prestado mediante delegación
# Tomar prestado 100 USDC
scripts/aave-borrow.sh USDC 100
# Tomar prestado 0.5 WETH
scripts/aave-borrow.sh WETH 0.5
El script de préstamo automáticamente:
- Verifica la asignación de delegación (¿es suficiente?)
- Verifica el factor de salud del delegante (¿es seguro tomar prestado?)
- Ejecuta el préstamo
- Reporta el resultado
Reembolsar deuda
# Reembolsar 100 USDC
scripts/aave-repay.sh USDC 100
# Reembolsar toda la deuda de USDC
scripts/aave-repay.sh USDC max
El script de reembolso automáticamente:
- Aprueba al Pool para gastar el token (si es necesario)
- Ejecuta el reembolso
- Reporta la deuda restante
Sistema de seguridad
Cada operación de préstamo ejecuta estas verificaciones ANTES de ejecutarse:
- Asignación de delegación — ¿La asignación restante es >= la cantidad solicitada?
- Factor de salud — ¿El factor de salud del delegante es >
minHealthFactor(por defecto 1.5) DESPUÉS de este préstamo? - Límite por transacción — ¿La cantidad es <=
maxBorrowPerTx? - Confirmación — Registra los detalles completos de la operación antes de enviarla
Si ALGUNA verificación falla, el préstamo se cancela con un mensaje de error claro.
⚠️ El agente NUNCA debe omitir las verificaciones de seguridad. Si el usuario pide al agente que tome prestado y el factor de salud es demasiado bajo, el agente debe rechazarlo y explicar por qué.
Capacidades
Operaciones de lectura (sin gas necesario)
- Verificar asignación de delegación — ¿Cuánto puede tomar prestado aún el agente?
- Verificar factor de salud — ¿Está segura la posición del delegante?
- Verificar deuda pendiente — ¿Cuánto debe el delegante por cada activo?
- Verificar liquidez disponible — ¿Hay suficiente en el pool de Aave para tomar prestado?
- Resolver direcciones de tokens de deuda — Buscar el VariableDebtToken de cualquier activo
Operaciones de escritura (necesitan gas en el monedero del agente)
- Tomar prestado — Retirar fondos de Aave contra crédito delegado
- Reembolsar — Devolver fondos prestados para reducir la deuda del delegante
- Aprobar — Aprobar al Pool para gastar tokens para el reembolso
Cadenas compatibles
| Cadena | Dirección del Pool | Costo de Gas |
|---|---|---|
| Base | 0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 | Muy Bajo |
| Ethereum | 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 | Alto |
| Polygon | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | Muy Bajo |
| Arbitrum | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | Bajo |
Consulta deployments.md para la lista completa de direcciones, incluyendo tokens de deuda.
Patrones comunes
Autofinanciamiento del agente para gas
# Verificar si tenemos suficiente gas
BALANCE=$(cast balance $AGENT_ADDRESS --rpc-url $RPC)
if [ "$BALANCE" -lt "1000000000000000" ]; then # < 0.001 ETH
# Tomar prestado una pequeña cantidad de WETH para gas
aave-borrow.sh WETH 0.005
fi
Tomar prestado + Intercambiar mediante Bankr
# Tomar prestado USDC del crédito delegado
aave-borrow.sh USDC 100
# Intercambiar a ETH usando Bankr
bankr.sh "Swap 100 USDC for ETH on Base"
DCA periódico
# El agente toma prestado USDC semanalmente y lo intercambia por ETH
aave-borrow.sh USDC 100
bankr.sh "Swap 100 USDC for ETH on Base"
Rebalanceo de cartera con seguridad primero
# Siempre verificar la salud primero
aave-status.sh
# Solo tomar prestado si está saludable
aave-borrow.sh USDC 500
Referencia de configuración
Campos de config.json
| Campo | Obligatorio | Descripción |
|---|---|---|
chain | Sí | Nombre de la cadena (base, ethereum, polygon, arbitrum) |
rpcUrl | Sí | URL del endpoint JSON-RPC |
agentPrivateKey | Sí | Clave privada del monedero del agente (prefijo 0x) |
delegatorAddress | Sí | Monedero principal del usuario que delegó crédito |
poolAddress | Sí | Dirección del contrato Pool de Aave V3 |
dataProviderAddress | Sí | Dirección del PoolDataProvider de Aave V3 |
assets | Sí | Mapa de símbolo → {address, decimals} |
safety.minHealthFactor | No | HF mínimo después del préstamo (por defecto: 1.5) |
safety.maxBorrowPerTx | No | Máximo préstamo por transacción (por defecto: 1000) |
safety.maxBorrowPerTxUnit | No | Unidad para maxBorrowPerTx (por defecto: USDC) |
Variables de entorno (anulan config)
| Variable | Anula |
|---|---|
AAVE_RPC_URL | rpcUrl |
AAVE_AGENT_PRIVATE_KEY | agentPrivateKey |
AAVE_DELEGATOR_ADDRESS | delegatorAddress |
AAVE_POOL_ADDRESS | poolAddress |
AAVE_MIN_HEALTH_FACTOR | safety.minHealthFactor |
Manejo de errores
| Error | Causa | Solución |
|---|---|---|
INSUFFICIENT_ALLOWANCE | Se excedió el monto de delegación | El delegante debe llamar a approveDelegation() de nuevo |
HEALTH_FACTOR_TOO_LOW | El préstamo pondría en riesgo liquidación | Reducir cantidad o agregar colateral |
AMOUNT_EXCEEDS_CAP | Se superó el límite de seguridad por tx | Reducir cantidad o actualizar config |
INSUFFICIENT_LIQUIDITY | No hay suficiente en el pool de Aave | Probar con una cantidad menor o un activo diferente |
INSUFFICIENT_GAS | El monedero del agente no tiene token nativo | Enviar gas al monedero del agente |
EMODE_MISMATCH | Activo incompatible con eMode del delegante | Tomar prestado un activo en la misma categoría eMode |
Seguridad
Consulta safety.md para el modelo de amenazas completo y procedimientos de emergencia.
Reglas críticas:
- La clave privada del delegante NUNCA debe estar en este repositorio, configuración o scripts — este es el espacio de trabajo del agente. El delegante gestiona su lado a través de la interfaz de Aave o un explorador de bloques.
- Nunca subir config.json al control de versiones — contiene la clave privada del agente
- Nunca establecer
minHealthFactorpor debajo de 1.2 — la liquidación ocurre en 1.0 - Siempre limitar los montos de delegación — nunca aprobar
type(uint256).max - Monitorear la salud del delegante — configurar alertas si el HF baja de 2.0
- El agente debe rechazar tomar prestado si las verificaciones de seguridad fallan, incluso si se le indica
Recursos
- Documentación de Aave V3: https://docs.aave.com/developers
- Guía de Delegación de Crédito: https://docs.aave.com/developers/guides/credit-delegation
- Directorio de Direcciones de Aave: https://github.com/bgd-labs/aave-address-book
- Foundry Book: https://book.getfoundry.sh/
- Referencia de DebtToken: https://docs.aave.com/developers/tokens/debttoken