Aaveclaw provides CLI access to the Aave V3 lending protocol on the Base Sepolia testnet, managing deposits, borrows, repayments, withdrawals, health checks, and faucet minting.

How do I get test tokens?

Use faucet.sh with the token name (weth or usdc) and amount to mint testnet tokens before deploying or borrowing.

What if my private key config is missing?

Create the file ~/.x402-config.json with a private_key, for example {"private_key": "0x..."}, and re-run setup to initialize the wallet.

aaveclaw

Scanned

@chainyoda

npx machina-cli add skill @chainyoda/aaveclaw --openclaw

Files (1)

SKILL.md

2.9 KB

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

Source

git clone https://clawhub.ai/chainyoda/aaveclawView on GitHub

Overview

Interact with Aave V3 on Base Sepolia testnet to manage a lending position. Deposit WETH as collateral, borrow USDC, repay debt, withdraw collateral, and mint test tokens via faucet. It uses the wallet from ~/.x402-config.json to drive the workflow.

How This Skill Works

Setup.sh installs ethers v6 and prepares a suite of scripts (health.sh, faucet.sh, deposit.sh, borrow.sh, repay.sh, withdraw.sh) to manage the full lending lifecycle. The CLI flows operate from your wallet defined in ~/.x402-config.json, auto-wrap ETH to WETH when needed, and report the health factor after each action.

When to Use It

Check your current lending position and health factor for a wallet on Base Sepolia
Mint testnet tokens (WETH or USDC) via the faucet before starting
Deposit WETH as collateral into Aave
Borrow USDC against the deposited collateral
Repay debt or withdraw collateral and review health after each operation

Quick Start

Step 1: Run bash scripts/setup.sh to install dependencies (ethers v6)
Step 2: Use faucet.sh to mint test tokens if needed, then perform deposit.sh, borrow.sh, repay.sh, and withdraw.sh as required
Step 3: Run health.sh after each state-changing action to verify your position

Best Practices

Always run health.sh before making any deposits, borrows, or withdrawals
Ask the user for exact amounts before executing an action
Monitor the health factor and alert when it drops below 1.5
Guide new users to the faucet to obtain test tokens first
After each state-changing action, verify the updated health and balances

Example Use Cases

Check health factor for a specific address on Base Sepolia
Mint 1 WETH and 1000 USDC to seed a test lending position
Deposit 0.5 WETH, then borrow 100 USDC
Repay 50 USDC and withdraw 0.25 WETH
Run health.sh to verify position after each operation

Frequently Asked Questions

Add this skill to your agents