# Aave

> Manage Aave V3 DeFi positions on Base — supply, borrow, repay, withdraw, view markets, and check account health. Supports a no-broadcast --simulate request preview. Includes liquidation safety checks.

- Skill: `fibrous-finance/aave` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fibrous-finance/aave`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fibrous-finance/aave/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: Fibrous-Finance (https://skillmd.com/u/fibrous-finance)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fibrous-finance/aave

---


# Aave V3 Management

Interact with the Aave V3 lending protocol on **Base only**. View market data, supply assets to earn yield, borrow against collateral, repay debt, or withdraw.

## Prerequisites

- Active session required for `status`, `supply`, `borrow`, `repay`, `withdraw`.
- `markets` does **not** require authentication — it is a public on-chain query.
- Sufficient ETH on Base for gas fees (transactional actions only).

## Rules

1. This skill ONLY works on **Base**. NEVER attempt Aave operations on HyperEVM or Monad. If requested, refuse and explain.
2. BEFORE any action, run `npx fibx@latest balance` to verify enough ETH for gas.
3. BEFORE `borrow`, you MUST run `npx fibx@latest aave status` to check the Health Factor:
    - Health Factor < **1.5** → WARN the user about liquidation risk.
    - Health Factor < **1.1** → DO NOT proceed without explicit double-confirmation from the user.
4. When the user wants to fully close a position, ALWAYS use `max` as the amount for `repay` and `withdraw`. This sends `MAX_UINT256` to the contract.
5. **Auto-Wrap/Unwrap**: When supplying, repaying, or withdrawing ETH, the CLI automatically handles the ETH ↔ WETH conversion. You can safely use `ETH` as the token symbol for these actions.

## Commands

```bash
npx fibx@latest aave <action> [amount] [token] [--simulate] [--json]
```

## Actions

| Action     | Description                                | Example                                 |
| ---------- | ------------------------------------------ | --------------------------------------- |
| `status`   | Account health, LTV, net worth             | `npx fibx@latest aave status`           |
| `markets`  | List all active reserves with APY & TVL    | `npx fibx@latest aave markets`          |
| `supply`   | Deposit assets (auto-wraps ETH)            | `npx fibx@latest aave supply 1 ETH`     |
| `borrow`   | Borrow against collateral                  | `npx fibx@latest aave borrow 50 USDC`   |
| `repay`    | Repay debt (auto-wraps ETH)                | `npx fibx@latest aave repay max ETH`    |
| `withdraw` | Withdraw assets (auto-unwraps WETH -> ETH) | `npx fibx@latest aave withdraw max ETH` |

## Parameters

| Parameter  | Type   | Description                                                     | Required                        |
| ---------- | ------ | --------------------------------------------------------------- | ------------------------------- |
| `action`   | string | `status`, `markets`, `supply`, `borrow`, `repay`, or `withdraw` | Yes                             |
| `amount`   | string | Amount or `max` (for full repay/withdraw)                       | Yes (except `status`/`markets`) |
| `token`    | string | Token symbol (`USDC`, `ETH`, `DAI`, etc.)                       | Yes (except `status`/`markets`) |
| `simulate` | flag   | Preview the requested action without executing it               | No                              |
| `json`     | flag   | Output as JSON                                                  | No                              |

## Dust Handling

When repaying or withdrawing, **always prefer `max`** if the user wants to fully close a position.

Passing `max` sends `MAX_UINT256` to the Aave contract, which covers all accrued interest and prevents tiny residual balances (e.g. `0.000001 USDC`) from remaining.

```bash
npx fibx@latest aave repay max USDC      # Repays all debt including accrued interest
npx fibx@latest aave withdraw max USDC   # Withdraws entire supplied position
```

## Examples

**User:** "What markets are available on Aave?"

```bash
npx fibx@latest aave markets
```

**User:** "How is my Aave position doing?"

```bash
npx fibx@latest aave status
```

**User:** "Supply 1 ETH to Aave"

```bash
npx fibx@latest balance
npx fibx@latest aave supply 1 ETH
```

**User:** "Preview supplying 1 ETH without executing it"

```bash
npx fibx@latest aave supply 1 ETH --simulate
```

This preview validates the amount, resolves the requested token, and shows the
action. It does not perform an on-chain gas estimate or prove that the action
will succeed.

**User:** "Borrow 100 USDC"

```bash
npx fibx@latest aave status
# If Health Factor > 1.5:
npx fibx@latest aave borrow 100 USDC
```

**User:** "Repay my ETH debt"

```bash
npx fibx@latest aave repay max ETH
```

## Error Handling

| Error                     | Action                                                         |
| ------------------------- | -------------------------------------------------------------- |
| `Health Factor too low`   | Blocked to prevent liquidation. Suggest repaying or supplying. |
| `Insufficient collateral` | Cannot borrow without supplying first.                         |
| `Insufficient balance`    | Check `balance` — user may need to swap for the token first.   |
| `Not authenticated`       | Run `authenticate-wallet` skill first.                         |
| `Rate limit / 429`        | Use `config` skill to set a custom RPC.                        |

## Related Skills

- Use `trade` to swap tokens before supplying (e.g. swap ETH → USDC, then supply USDC).
- Use `balance` to verify available assets before any Aave operation.
- Use `portfolio` to see Aave positions alongside all token holdings with USD values.
- Use `config` to set a custom RPC if you encounter rate limit errors.