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

• Network: Base Sepolia (chain ID 84532)
• Explorer: https://sepolia.basescan.org
• RPC: https://sepolia.base.org
• Tokens: WETH (18 decimals), USDC (6 decimals)

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