Skill

Review

Audit score 70

grimoire-aave

franalgaba/grimoire

Query Aave V3 market data, health metrics, and reserve snapshots via Grimoire CLI.

What is grimoire-aave?

Fetches Aave V3 public metadata and reserve information using the Grimoire venue CLI. Use this skill when you need protocol health checks, supported chain listings, market details, reserve information, or spell-ready reserve snapshots for strategy inputs.

Check Aave protocol health status across all markets
List supported chains and their Aave V3 market addresses
Query market listings with optional user position data
Retrieve detailed reserve information with filtering by asset or market
Generate spell-ready `params:` blocks for reserve snapshots
Support multiple output formats (JSON, table, spell)

How to install grimoire-aave

npx skills add https://github.com/franalgaba/grimoire --skill grimoire-aave

Prerequisites

Grimoire CLI installed (via `npx skills add` or direct installation)
RPC URL for the target chain (Ethereum or Base)
Optional: user wallet address for position queries

Claude Code

Cursor

Windsurf

Cline

How to use grimoire-aave

1.Run `grimoire venue aave health` to check protocol status
2.Run `grimoire venue aave chains` to list supported chains and market addresses
3.Run `grimoire venue aave markets --chain <id>` to list all markets on a chain
4.Run `grimoire venue aave reserves --chain <id> --asset <symbol>` to filter reserves by asset
5.Run `grimoire venue aave reserves-snapshot --chain <id> --asset <symbol>` to generate spell-ready params blocks
6.Use `--format json` for automation or `--format table` for interactive inspection

Use cases

Good for

Verify Aave protocol health before executing lending/borrowing strategies
Discover available markets and reserves across Ethereum and Base chains
Fetch current reserve APY and utilization metrics for comparison logic
Generate reserve snapshots to populate spell parameters for automated transactions
Filter reserves by asset symbol or address to find specific lending opportunities

Who it's for

DeFi strategy developers using Grimoire spells
Agents automating Aave lending/borrowing workflows
Developers building Aave analytics or monitoring tools
Traders comparing Aave APY against other lending protocols

grimoire-aave FAQ

Which chains does Aave V3 support in Grimoire?

Ethereum (chain ID 1) and Base (chain ID 8453) are currently supported, each with their own market address.

What is the difference between `reserves` and `reserves-snapshot`?

`reserves` lists reserve data in JSON, table, or spell format; `reserves-snapshot` generates a `params:` block specifically for agent spell inputs.

Do Aave V3 actions support runtime constraints like slippage?

No, Aave V3 actions do not currently support runtime constraints. The adapter handles approvals and amount conversion automatically.

What output formats are available?

JSON, table, and spell formats are supported. Use `--format json` for automation and `--format table` for quick interactive checks.

How do I check if my RPC is working before querying Aave?

Run `grimoire venue doctor --adapter aave --chain <id> --rpc-url <rpc> --json` as a preflight check.

Full instructions (SKILL.md)

Source of truth, from franalgaba/grimoire.

name: grimoire-aave description: Fetches Aave V3 public market data using the Grimoire venue CLI. Use when you need Aave health checks, chain listings, market metadata, or reserve info.

Grimoire Aave Skill

Use this skill to query Aave V3 metadata and reserve snapshots for strategy inputs.

Preferred invocations:

grimoire venue aave ...
npx -y @grimoirelabs/cli venue aave ... (no-install)
bun run packages/cli/src/index.ts venue aave ... (repo-local)
grimoire-aave ... (direct binary from @grimoirelabs/venues)

Recommended preflight:

grimoire venue doctor --adapter aave --chain 1 --rpc-url <rpc> --json

Commands

grimoire venue aave health — check Aave protocol health
grimoire venue aave chains — list supported chains
grimoire venue aave markets --chain <id> [--user <address>] — list markets on a chain (optionally with user positions)
grimoire venue aave market --chain <id> --address <market> [--user <address>] — single market details
grimoire venue aave reserve --chain <id> --market <address> --token <address> — single reserve details
grimoire venue aave reserves --chain <id> [--market <address>] [--asset <symbol|address>] — list reserves with optional filters
grimoire venue aave reserves-snapshot --chain <id> [--market <address>] [--asset <symbol|address>] — generate spell params: block for reserves (agent-only)

Examples

grimoire venue aave health
grimoire venue aave health --format table
grimoire venue aave chains
grimoire venue aave markets --chain 1 --format table
grimoire venue aave market --chain 1 --address 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2
grimoire venue aave reserve --chain 1 --market 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
grimoire venue aave reserves --chain 1 --asset USDC --format table
grimoire venue aave reserves --chain 1 --asset USDC --format spell
grimoire venue aave reserves-snapshot --chain 1 --asset USDC

Use reserves-snapshot to emit a params: block for spell inputs. This is an agent-only command (output suppressed in interactive mode).

Supported Chains

Chain	Market Address
Ethereum (1)	`0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2`
Base (8453)	`0xA238Dd80C259a72e81d7e4664a9801593F98d1c5`

Spell Constraints

Aave V3 actions do not currently support runtime constraints (max_slippage, min_output, etc.). The adapter handles approvals and amount conversion automatically.

aave_v3.lend(USDC, params.amount)
aave_v3.withdraw(USDC, params.amount)
aave_v3.borrow(USDC, params.amount)
aave_v3.repay(USDC, params.amount)

Metric Surface (Spell Comparisons)

Aave exposes the apy metric surface for comparisons:

aave_apy = apy(aave, USDC)
aave_apy_generic = metric("apy", aave, USDC)

Use this in conditional logic (for example, compare against Morpho APY before reallocating).

Amount Format

The @aave/client SDK uses different amount formats per action:

Action	Format	Example (0.1 USDC)
supply	`value: "0.1"`	Human-readable BigDecimal
borrow	`value: "0.1"`	Human-readable BigDecimal
withdraw	`value: { exact: "100000" }`	Raw amount in `exact` wrapper
repay	`value: { exact: "100000" }`	Raw amount in `exact` wrapper