Aave 신용 위임
Aave에서 위임된 신용을 사용하여 자금을 차입합니다. 사용자의 메인 지갑이 담보를 공급하고 차입 권한을 에이전트 지갑에 위임합니다. 에이전트는 필요할 때 자율적으로 토큰을 차입할 수 있으며, 부채는 위임자의 포지션에 누적됩니다.
프로토콜: Aave V3 및 Aave V2에서 작동합니다. 신용 위임 관련 함수 시그니처(
borrow,repay,approveDelegation,borrowAllowance)는 두 버전에서 동일합니다. V2의LendingPool및ProtocolDataProvider주소만 교체하면 됩니다. 유일한 차이점은 V3는 담보/부채를 USD(소수점 8자리)로 반환하고, V2는 ETH(소수점 18자리)로 반환한다는 점입니다. 건강 상태 비율 안전 검사는 두 버전 모두에서 올바르게 작동합니다.
호환 가능한 플랫폼
- OpenClaw — 스킬로 설치하면 에이전트가 자율적으로 차입합니다.
- Claude Code — Claude Code 세션에서 직접 스크립트를 실행합니다.
- 모든 에이전트 프레임워크 — 일반 bash + Foundry의
cast, 셸이 있는 곳 어디에서나 작동합니다.
Bankr 스킬과 결합하여 차입-후-스왑 흐름을 구성할 수 있습니다. 위임을 통해 USDC를 차입한 후 Bankr을 사용하여 스왑, 브리징 또는 배포합니다.
신용 위임 작동 방식
Aave V3의 신용 위임은 두 가지를 분리합니다. 차입 능력과 위임 승인입니다.
차입 능력은 전체적입니다. 모든 자산에 걸친 전체 담보 포지션에서 비롯됩니다. 80% LTV로 $10k 상당의 ETH를 예치하면 $8k의 차입 능력을 갖습니다. 이 차입 능력은 특정 자산에 고정되지 않습니다.
위임 승인은 부채 토큰별로 분리됩니다. 개별 VariableDebtToken에서 approveDelegation()을 호출하여 에이전트가 차입할 수 있는 자산과 각 자산의 양을 제어합니다. 각 자산에는 고유한 부채 토큰 계약이 있으며, 각 승인은 독립적입니다.
즉, 다음과 같이 설정할 수 있습니다.
- ETH를 담보로 예치 (광범위한 차입 능력 확보)
- 에이전트가 최대 500 USDC까지 차입하도록 승인 (USDC VariableDebtToken을 통해)
- 에이전트가 최대 0.1 WETH까지 차입하도록 승인 (WETH VariableDebtToken을 통해)
- cbETH는 승인하지 않음 (에이전트가 전혀 차입할 수 없음)
에이전트는 사용자가 명시적으로 승인한 자산만, 설정된 금액까지만 차입할 수 있습니다. 하지만 차입 능력은 단일 예치가 아닌 전체 담보에서 비롯됩니다.
사용자 담보 (전체적) 위임 승인 (분리됨)
┌─────────────────────────┐ ┌──────────────────────────────┐
│ $5k ETH │ │ USDC 부채토큰 → 에이전트: 500 │
│ $3k USDC │ ───LTV───▶ │ WETH 부채토큰 → 에이전트: 0.1 │
│ $2k cbETH │ = $8k │ cbETH 부채토큰 → 에이전트: 0 │
│ 합계: $10k @ 80% LTV │ 능력 └──────────────────────────────┘
└─────────────────────────┘
흐름
위임자 (사용자 지갑) 에이전트 지갑 (수임자)
│ │
│ 1. Aave에 담보 공급 │
│ 2. approveDelegation(agent, amount) │
│ VariableDebtToken에서 호출 │
│ │
│ ┌─── 3. borrow(asset, │
│ │ amount, onBehalfOf │
│ │ = delegator) │
│ │ │
│ [사용자 포지션에 부채] [에이전트 지갑에 토큰]
│ │ │
│ └─── 4. repay(asset, │
│ amount, onBehalfOf │
│ = delegator) │
빠른 시작
사전 요구 사항
-
Foundry가 설치되어 있어야 합니다 (
castCLI):curl -L https://foundry.paradigm.xyz | bash && foundryup -
위임자 설정 (사용자가 한 번 수행, 에이전트가 아님):
- Aave V3에 담보 공급 (app.aave.com 또는 계약을 통해)
- 에이전트가 차입할 자산의 VariableDebtToken에서
approveDelegation(agentAddress, maxAmount)호출 - VariableDebtToken 주소는 다음을 통해 확인 가능:
cast call $DATA_PROVIDER "getReserveTokensAddresses(address)(address,address,address)" $ASSET --rpc-url $RPC
-
스킬 구성:
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 -
설정 확인:
scripts/aave-setup.sh
핵심 사용법
상태 확인 (허용량, 건강 상태, 부채)
# 전체 상태 보고서
scripts/aave-status.sh
# 특정 자산 위임 확인
scripts/aave-status.sh USDC
# 건강 상태 비율만 확인
scripts/aave-status.sh --health-only
위임을 통한 차입
# 100 USDC 차입
scripts/aave-borrow.sh USDC 100
# 0.5 WETH 차입
scripts/aave-borrow.sh WETH 0.5
차입 스크립트는 자동으로:
- 위임 허용량 확인 (충분한가?)
- 위임자 건강 상태 비율 확인 (차입해도 안전한가?)
- 차입 실행
- 결과 보고
부채 상환
# 100 USDC 상환
scripts/aave-repay.sh USDC 100
# 모든 USDC 부채 상환
scripts/aave-repay.sh USDC max
상환 스크립트는 자동으로:
- 풀이 토큰을 사용하도록 승인 (필요한 경우)
- 상환 실행
- 남은 부채 보고
안전 시스템
모든 차입 작업은 실행 전에 다음 검사를 수행합니다:
- 위임 허용량 — 남은 허용량이 요청된 금액 이상인가?
- 건강 상태 비율 — 이 차입 후 위임자의 건강 상태 비율이
minHealthFactor(기본값 1.5)보다 큰가? - 거래당 한도 — 금액이
maxBorrowPerTx이하인가? - 확인 — 전송 전에 전체 작업 세부 정보를 기록합니다.
검사 중 하나라도 실패하면 차입은 명확한 오류 메시지와 함께 중단됩니다.
⚠️ 에이전트는 절대 안전 검사를 우회해서는 안 됩니다. 사용자가 건강 상태 비율이 너무 낮은데 차입을 요청하면 에이전트는 거부하고 이유를 설명해야 합니다.
기능
읽기 작업 (가스 불필요)
- 위임 허용량 확인 — 에이전트가 아직 얼마나 차입할 수 있는가?
- 건강 상태 비율 확인 — 위임자의 포지션이 안전한가?
- 미결제 부채 확인 — 위임자가 각 자산에 대해 얼마나 빚을 졌는가?
- 사용 가능한 유동성 확인 — Aave 풀에 차입할 충분한 자금이 있는가?
- 부채 토큰 주소 확인 — 모든 자산에 대한 VariableDebtToken 조회
쓰기 작업 (에이전트 지갑에 가스 필요)
- 차입(Borrow) — 위임된 신용을 통해 Aave에서 자금 인출
- 상환(Repay) — 차입한 자금을 반환하여 위임자의 부채 감소
- 승인(Approve) — 풀이 상환을 위해 토큰을 사용하도록 승인
지원 체인
| 체인 | 풀 주소 | 가스 비용 |
|---|---|---|
| Base | 0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 | 매우 낮음 |
| Ethereum | 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 | 높음 |
| Polygon | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | 매우 낮음 |
| Arbitrum | 0x794a61358D6845594F94dc1DB02A252b5b4814aD | 낮음 |
부채 토큰을 포함한 전체 주소 목록은 deployments.md를 참조하세요.
일반적인 패턴
가스비 자체 조달
# 충분한 가스가 있는지 확인
BALANCE=$(cast balance $AGENT_ADDRESS --rpc-url $RPC)
if [ "$BALANCE" -lt "1000000000000000" ]; then # < 0.001 ETH
# 가스비를 위해 소량의 WETH 차입
aave-borrow.sh WETH 0.005
fi
Bankr을 통한 차입 + 스왑
# 위임된 신용에서 USDC 차입
aave-borrow.sh USDC 100
# Bankr을 사용하여 ETH로 스왑
bankr.sh "Swap 100 USDC for ETH on Base"
정기 DCA
# 에이전트가 매주 USDC를 차입하여 ETH로 스왑
aave-borrow.sh USDC 100
bankr.sh "Swap 100 USDC for ETH on Base"
안전 우선 포트폴리오 재조정
# 항상 건강 상태를 먼저 확인
aave-status.sh
# 건강한 경우에만 차입
aave-borrow.sh USDC 500
구성 참조
config.json 필드
| 필드 | 필수 | 설명 |
|---|---|---|
chain | 예 | 체인 이름 (base, ethereum, polygon, arbitrum) |
rpcUrl | 예 | JSON-RPC 엔드포인트 URL |
agentPrivateKey | 예 | 에이전트 지갑 개인 키 (0x 접두사) |
delegatorAddress | 예 | 신용을 위임한 사용자의 메인 지갑 |
poolAddress | 예 | Aave V3 풀 계약 주소 |
dataProviderAddress | 예 | Aave V3 PoolDataProvider 주소 |
assets | 예 | 심볼 → {address, decimals} 매핑 |
safety.minHealthFactor | 아니오 | 차입 후 최소 HF (기본값: 1.5) |
safety.maxBorrowPerTx | 아니오 | 거래당 최대 차입액 (기본값: 1000) |
safety.maxBorrowPerTxUnit | 아니오 | maxBorrowPerTx의 단위 (기본값: USDC) |
환경 변수 (config 재정의)
| 변수 | 재정의 대상 |
|---|---|
AAVE_RPC_URL | rpcUrl |
AAVE_AGENT_PRIVATE_KEY | agentPrivateKey |
AAVE_DELEGATOR_ADDRESS | delegatorAddress |
AAVE_POOL_ADDRESS | poolAddress |
AAVE_MIN_HEALTH_FACTOR | safety.minHealthFactor |
오류 처리
| 오류 | 원인 | 해결 방법 |
|---|---|---|
INSUFFICIENT_ALLOWANCE | 위임 금액 초과 | 위임자가 approveDelegation()을 다시 호출해야 함 |
HEALTH_FACTOR_TOO_LOW | 차입 시 청산 위험 | 금액을 줄이거나 담보 추가 |
AMOUNT_EXCEEDS_CAP | 거래당 안전 한도 도달 | 금액을 줄이거나 config 업데이트 |
INSUFFICIENT_LIQUIDITY | Aave 풀에 자금 부족 | 더 작은 금액이나 다른 자산 시도 |
INSUFFICIENT_GAS | 에이전트 지갑에 네이티브 토큰 없음 | 에이전트 지갑에 가스 전송 |
EMODE_MISMATCH | 자산이 위임자의 eMode와 호환되지 않음 | 동일한 eMode 카테고리의 자산 차입 |
보안
전체 위협 모델 및 비상 절차는 safety.md를 참조하세요.
중요 규칙:
- 위임자의 개인 키는 절대 이 저장소, config, 또는 스크립트에 있어서는 안 됩니다 — 이는 에이전트의 작업 공간입니다. 위임자는 Aave UI 또는 블록 탐색기를 통해 자신의 측면을 관리합니다.
- 절대 config.json을 버전 관리에 커밋하지 마세요 — 에이전트의 개인 키가 포함되어 있습니다.
- 절대
minHealthFactor를 1.2 미만으로 설정하지 마세요 — 청산은 1.0에서 발생합니다. - 항상 위임 금액을 제한하세요 —
type(uint256).max를 승인하지 마세요. - 위임자 건강 상태를 모니터링하세요 — HF가 2.0 아래로 떨어지면 알림을 설정하세요.
- 안전 검사가 실패하면 에이전트는 차입을 거부해야 합니다. 지시를 받더라도 마찬가지입니다.
리소스
- Aave V3 문서: https://docs.aave.com/developers
- 신용 위임 가이드: https://docs.aave.com/developers/guides/credit-delegation
- Aave 주소록: https://github.com/bgd-labs/aave-address-book
- Foundry 북: https://book.getfoundry.sh/
- 부채토큰 참조: https://docs.aave.com/developers/tokens/debttoken