Aaveclaw

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