Delegação de Crédito Aave
Pegue fundos emprestados do Aave usando crédito delegado. Sua carteira principal fornece garantia e delega poder de empréstimo para a carteira do agente. O agente pode então pegar tokens emprestados de forma autônoma quando necessário — a dívida é acumulada contra a posição do delegador.
Protocolo: Funciona no Aave V3 e Aave V2 — as assinaturas de função para delegação de crédito (
borrow,repay,approveDelegation,borrowAllowance) são idênticas em ambas as versões. Basta trocar os endereços do LendingPool V2 e do ProtocolDataProvider. A única diferença cosmética: V3 retorna garantia/dívida em USD (8 decimais), V2 em ETH (18 decimais). A verificação de segurança do fator de saúde funciona corretamente em ambos.
Compatível Com
- OpenClaw — Instale como skill, o agente pega emprestado autonomamente
- Claude Code — Execute scripts diretamente de uma sessão do Claude Code
- Qualquer framework de agente — Bash simples +
castdo Foundry, funciona em qualquer lugar com um shell
Combine com skills do Bankr para fluxos de emprestar-e-trocar: pegue USDC emprestado via delegação, depois use o Bankr para trocar, fazer bridge ou implantar.
Como Funciona a Delegação de Crédito
A delegação de crédito no Aave V3 separa duas coisas: poder de empréstimo e aprovação de delegação.
O poder de empréstimo é holístico. Ele vem de toda a sua posição de garantia em todos os ativos. Se você depositar $10k em ETH com LTV de 80%, você tem $8k de poder de empréstimo — ponto final. Esse poder de empréstimo não está vinculado a nenhum ativo específico.
A aprovação de delegação é isolada por token de dívida. Você controla quais ativos o agente pode pegar emprestado e quanto de cada um, chamando approveDelegation() em VariableDebtTokens individuais. Cada ativo tem seu próprio contrato de token de dívida, e cada aprovação é independente.
Isso significa que você pode, por exemplo:
- Depositar ETH como garantia (dá a você amplo poder de empréstimo)
- Aprovar o agente para pegar emprestado até 500 USDC (via o VariableDebtToken USDC)
- Aprovar o agente para pegar emprestado até 0.1 WETH (via o VariableDebtToken WETH)
- Deixar cbETH não aprovado (o agente não pode pegá-lo emprestado de forma alguma)
O agente só pode pegar emprestado ativos que você aprovou explicitamente, até os valores que você definiu — mas a capacidade de pegar emprestado vem do seu colateral total, não de um único depósito.
Seu Colateral (holístico) Aprovações de Delegação (isoladas)
┌─────────────────────────┐ ┌──────────────────────────────┐
│ $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 │ capacidade └──────────────────────────────┘
└─────────────────────────┘
Fluxo
Delegador (sua carteira) Carteira do Agente (delegatário)
│ │
│ 1. fornecer garantia ao Aave │
│ 2. approveDelegation(agente, quantia) │
│ no VariableDebtToken │
│ │
│ ┌─── 3. borrow(ativo, │
│ │ quantia, onBehalfOf │
│ │ = delegador) │
│ │ │
│ [dívida na SUA posição] [tokens na carteira do agente]
│ │ │
│ └─── 4. repay(ativo, │
│ quantia, onBehalfOf │
│ = delegador) │
Início Rápido
Pré-requisitos
-
Foundry deve estar instalado (CLI
cast):curl -L https://foundry.paradigm.xyz | bash && foundryup -
Configuração do delegador (feita UMA VEZ pelo usuário, NÃO pelo agente):
- Forneça garantia ao Aave V3 (via app.aave.com ou contrato)
- Chame
approveDelegation(enderecoDoAgente, quantiaMaxima)no VariableDebtToken do ativo que você quer que o agente pegue emprestado - O endereço do VariableDebtToken pode ser encontrado via:
cast call $DATA_PROVIDER "getReserveTokensAddresses(address)(address,address,address)" $ASSET --rpc-url $RPC
-
Configure a skill:
mkdir -p ~/.openclaw/skills/aave-delegation cat > ~/.openclaw/skills/aave-delegation/config.json << 'EOF' { "chain": "base", "rpcUrl": "https://mainnet.base.org", "agentPrivateKey": "0xSUA_CHAVE_PRIVADA_DO_AGENTE", "delegatorAddress": "0xSEU_ENDERECO_PRINCIPAL", "poolAddress": "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5", "dataProviderAddress": "0x2d8A3C5677189723C4cB8873CfC9C8976FDF38Ac", "assets": { "USDC": { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "WETH": { "address": "0x4200000000000000000000000000000000000006", "decimals": 18 } }, "safety": { "minHealthFactor": "1.5", "maxBorrowPerTx": "1000", "maxBorrowPerTxUnit": "USDC" } } EOF -
Verifique a configuração:
scripts/aave-setup.sh
Uso Principal
Verificar Status (permissão, saúde, dívida)
# Relatório de status completo
scripts/aave-status.sh
# Verificar delegação de um ativo específico
scripts/aave-status.sh USDC
# Apenas fator de saúde
scripts/aave-status.sh --health-only
Pegar Empréstimo via Delegação
# Pegar 100 USDC emprestado
scripts/aave-borrow.sh USDC 100
# Pegar 0.5 WETH emprestado
scripts/aave-borrow.sh WETH 0.5
O script de empréstimo automaticamente:
- Verifica a permissão de delegação (suficiente?)
- Verifica o fator de saúde do delegador (seguro para pegar emprestado?)
- Executa o empréstimo
- Informa o resultado
Pagar Dívida
# Pagar 100 USDC
scripts/aave-repay.sh USDC 100
# Pagar toda a dívida em USDC
scripts/aave-repay.sh USDC max
O script de pagamento automaticamente:
- Aprova o Pool para gastar o token (se necessário)
- Executa o pagamento
- Informa a dívida restante
Sistema de Segurança
Cada operação de empréstimo executa estas verificações ANTES de executar:
- Permissão de delegação — A permissão restante é >= quantia solicitada?
- Fator de saúde — O fator de saúde do delegador é >
minHealthFactor(padrão 1.5) APÓS este empréstimo? - Limite por transação — A quantia é <=
maxBorrowPerTx? - Confirmação — Registra os detalhes completos da operação antes de enviar
Se QUALQUER verificação falhar, o empréstimo é abortado com uma mensagem de erro clara.
⚠️ O agente NUNCA deve ignorar as verificações de segurança. Se o usuário pedir ao agente para pegar emprestado e o fator de saúde estiver muito baixo, o agente deve recusar e explicar o motivo.
Capacidades
Operações de Leitura (sem gás)
- Verificar permissão de delegação — Quanto o agente ainda pode pegar emprestado?
- Verificar fator de saúde — A posição do delegador está segura?
- Verificar dívida pendente — Quanto o delegador deve em cada ativo?
- Verificar liquidez disponível — Há o suficiente no pool do Aave para pegar emprestado?
- Resolver endereços de tokens de dívida — Consultar o VariableDebtToken para qualquer ativo
Operações de Escrita (precisa de gás na carteira do agente)
- Empréstimo — Sacar fundos do Aave contra crédito delegado
- Pagamento — Devolver fundos emprestados para reduzir a dívida do delegador
- Aprovação — Aprovar o Pool para gastar tokens para pagamento
Redes Suportadas
| Rede | Endereço do Pool | Custo de Gás |
|---|---|---|
| Base | 0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 | Muito Baixo |
| Ethereum | 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 | Alto |
| Polygon | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | Muito Baixo |
| Arbitrum | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | Baixo |
Veja deployments.md para a lista completa de endereços, incluindo tokens de dívida.
Padrões Comuns
Autofinanciamento do Agente para Gás
# Verificar se temos gás suficiente
BALANCE=$(cast balance $AGENT_ADDRESS --rpc-url $RPC)
if [ "$BALANCE" -lt "1000000000000000" ]; then # < 0.001 ETH
# Pegar uma pequena quantia de WETH emprestada para gás
aave-borrow.sh WETH 0.005
fi
Empréstimo + Troca via Bankr
# Pegar USDC emprestado do crédito delegado
aave-borrow.sh USDC 100
# Trocar para ETH usando Bankr
bankr.sh "Trocar 100 USDC por ETH na Base"
DCA Periódico
# Agente pega USDC emprestado semanalmente e troca para ETH
aave-borrow.sh USDC 100
bankr.sh "Trocar 100 USDC por ETH na Base"
Rebalanceamento de Portfólio com Segurança em Primeiro Lugar
# Sempre verificar a saúde primeiro
aave-status.sh
# Só pegar emprestado se estiver saudável
aave-borrow.sh USDC 500
Referência de Configuração
Campos do config.json
| Campo | Obrigatório | Descrição |
|---|---|---|
chain | Sim | Nome da rede (base, ethereum, polygon, arbitrum) |
rpcUrl | Sim | URL do endpoint JSON-RPC |
agentPrivateKey | Sim | Chave privada da carteira do agente (prefixo 0x) |
delegatorAddress | Sim | Carteira principal do usuário que delegou crédito |
poolAddress | Sim | Endereço do contrato Pool Aave V3 |
dataProviderAddress | Sim | Endereço do Aave V3 PoolDataProvider |
assets | Sim | Mapa de símbolo → {address, decimals} |
safety.minHealthFactor | Não | HF mínimo após empréstimo (padrão: 1.5) |
safety.maxBorrowPerTx | Não | Máximo de empréstimo por transação (padrão: 1000) |
safety.maxBorrowPerTxUnit | Não | Unidade para maxBorrowPerTx (padrão: USDC) |
Variáveis de Ambiente (substituem config)
| Variável | Substitui |
|---|---|
AAVE_RPC_URL | rpcUrl |
AAVE_AGENT_PRIVATE_KEY | agentPrivateKey |
AAVE_DELEGATOR_ADDRESS | delegatorAddress |
AAVE_POOL_ADDRESS | poolAddress |
AAVE_MIN_HEALTH_FACTOR | safety.minHealthFactor |
Tratamento de Erros
| Erro | Causa | Correção |
|---|---|---|
INSUFFICIENT_ALLOWANCE | Quantia de delegação excedida | Delegador deve chamar approveDelegation() novamente |
HEALTH_FACTOR_TOO_LOW | Empréstimo arriscaria liquidação | Reduza a quantia ou adicione garantia |
AMOUNT_EXCEEDS_CAP | Limite de segurança por transação atingido | Reduza a quantia ou atualize a configuração |
INSUFFICIENT_LIQUIDITY | Não há o suficiente no pool do Aave | Tente uma quantia menor ou um ativo diferente |
INSUFFICIENT_GAS | Carteira do agente sem token nativo | Envie gás para a carteira do agente |
EMODE_MISMATCH | Ativo incompatível com eMode do delegador | Pegue emprestado um ativo na mesma categoria eMode |
Segurança
Veja safety.md para o modelo de ameaça completo e procedimentos de emergência.
Regras críticas:
- A chave privada do delegador NUNCA deve estar neste repositório, configuração ou scripts — este é o espaço de trabalho do agente. O delegador gerencia seu lado via interface do Aave ou um explorador de blocos.
- Nunca commite config.json no controle de versão — ele contém a chave privada do agente
- Nunca defina
minHealthFactorabaixo de 1.2 — a liquidação ocorre em 1.0 - Sempre limite as quantias de delegação — nunca aprove
type(uint256).max - Monitore a saúde do delegador — configure alertas se o HF cair abaixo de 2.0
- O agente deve recusar pegar emprestado se as verificações de segurança falharem, mesmo que instruído a fazê-lo
Recursos
- Documentação Aave V3: https://docs.aave.com/developers
- Guia de Delegação de Crédito: https://docs.aave.com/developers/guides/credit-delegation
- Livro de Endereços Aave: https://github.com/bgd-labs/aave-address-book
- Livro do Foundry: https://book.getfoundry.sh/
- Referência DebtToken: https://docs.aave.com/developers/tokens/debttoken