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 Citrea, 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

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 | Estimate gas without executing the transaction | 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.

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?"

npx fibx@latest aave markets

User: "How is my Aave position doing?"

npx fibx@latest aave status

User: "Supply 1 ETH to Aave"

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

User: "How much gas would supplying 1 ETH cost?"

npx fibx@latest aave supply 1 ETH --simulate

User: "Borrow 100 USDC"

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

User: "Repay my ETH debt"

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.