| name | aaveclaw |
| description | Aave V3 lending protocol on Base Sepolia testnet. Deposit WETH collateral, borrow USDC, repay loans, withdraw collateral, check health factor, and mint test tokens via faucet. Use when users want to interact with Aave lending, check their lending position health, or get testnet tokens. |
aaveclaw - Aave V3 Lending on Base Sepolia
Interact with Aave V3 lending protocol on Base Sepolia testnet. Manages the full lending lifecycle using the wallet from ~/.x402-config.json.
Setup
Run setup.sh on first use to install dependencies (ethers v6):
bash scripts/setup.sh
Commands
Check Health Factor
Check the current lending position. Safe to run anytime, read-only.
bash scripts/health.sh [address]
If no address is provided, uses the configured wallet address.
Mint Test Tokens (Faucet)
Get testnet WETH or USDC from the Aave faucet. Run this first if the wallet has no tokens.
bash scripts/faucet.sh weth 1 # Mint 1 WETH
bash scripts/faucet.sh usdc 1000 # Mint 1000 USDC
Deposit Collateral
Deposit WETH as collateral into Aave. Auto-wraps native ETH to WETH if needed.
bash scripts/deposit.sh 0.5 # Deposit 0.5 WETH
Borrow USDC
Borrow USDC against deposited collateral. Uses variable interest rate.
bash scripts/borrow.sh 100 # Borrow 100 USDC
Repay Debt
Repay borrowed USDC. Use "max" to repay entire debt.
bash scripts/repay.sh 50 # Repay 50 USDC
bash scripts/repay.sh max # Repay all debt
Withdraw Collateral
Withdraw WETH collateral. Use "max" to withdraw everything (only if no debt).
bash scripts/withdraw.sh 0.5 # Withdraw 0.5 WETH
bash scripts/withdraw.sh max # Withdraw all
Usage Guidelines
- Always run
health.sh first to see the current position before making changes.
- Ask the user for amounts before executing deposit, borrow, repay, or withdraw.
- Always show the health factor after any state-changing operation (the scripts do this automatically).
- Warn when health factor drops below 1.5 - the position is at risk of liquidation.
- Guide new users to the faucet to get test tokens before depositing.
- Typical flow: faucet (get tokens) -> deposit (add collateral) -> borrow (take loan) -> repay (pay back) -> withdraw (retrieve collateral).
Network Details
Error Handling
- If private key is missing: direct user to create
~/.x402-config.json with {"private_key": "0x..."}
- If insufficient balance: the scripts report exact balances and what is needed
- If health factor would drop too low after borrow: Aave reverts the transaction automatically
- If faucet fails: the faucet contract may have minting limits or may not be available
