aaveclaw

# 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