mcpField
G
grimoire-aave

grimoire-aave

github.com/franalgaba其他61.1k 次安装25 周前更新
代码仓库

关于 grimoire-aave

grimoire-aave 是用于查询 Aave V3 元数据和储备数据的命令行技能，可为策略输入提供数据。它支持链、市场和储备查询，并能生成适用于 spell 的快照。

主要功能

  1. 01检查 Aave 协议健康状况
  2. 02列出支持的链和市场
  3. 03查看市场与储备详情
  4. 04按市场或资产筛选储备
  5. 05生成 spell 储备快照

适用场景

  1. 01查询前检查 Aave 协议健康状况
  2. 02查看某条链的市场和用户持仓
  3. 03检查指定资产的储备
  4. 04为 spell 准备储备参数

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/grimoire-aave确认已加载。

详细介绍

Grimoire Aave 技能

使用此技能查询 Aave V3 元数据和储备快照，为策略提供输入。

推荐调用方式：

  • grimoire venue aave ...
  • npx -y @grimoirelabs/cli venue aave ...（无需安装）
  • bun run packages/cli/src/index.ts venue aave ...（仓库本地运行）
  • grimoire-aave ...（来自 @grimoirelabs/venues 的直接二进制文件）

建议的预检：

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

命令

  • grimoire venue aave health — 检查 Aave 协议运行状况
  • grimoire venue aave chains — 列出支持的链
  • grimoire venue aave markets --chain <id> [--user <address>] — 列出某条链上的市场（可选显示用户持仓）
  • grimoire venue aave market --chain <id> --address <market> [--user <address>] — 查看单个市场的详情
  • grimoire venue aave reserve --chain <id> --market <address> --token <address> — 查看单个储备的详情
  • grimoire venue aave reserves --chain <id> [--market <address>] [--asset <symbol|address>] — 列出储备，可选添加筛选条件
  • grimoire venue aave reserves-snapshot --chain <id> [--market <address>] [--asset <symbol|address>] — 为储备生成 spell params: 块（仅限 Agent）

示例

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

使用 reserves-snapshot 为 spell 输入生成 params: 块。此命令仅限 Agent 使用（交互模式下会抑制输出）。

支持的链

链市场地址
Ethereum (1)0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2
Base (8453)0xA238Dd80C259a72e81d7e4664a9801593F98d1c5

Spell 约束

Aave V3 操作目前不支持运行时约束（max_slippage、min_output 等）。适配器会自动处理授权和金额转换。

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

指标范围（Spell 比较）

Aave 提供用于比较的 apy 指标范围：

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

在条件逻辑中使用此指标（例如，在重新分配前与 Morpho APY 进行比较）。

金额格式

@aave/client SDK 针对不同操作使用不同的金额格式：

操作格式示例（0.1 USDC）
supplyvalue: "0.1"人类可读的 BigDecimal
borrowvalue: "0.1"人类可读的 BigDecimal
withdrawvalue: { exact: "100000" }exact 包装器中的原始金额
repayvalue: { exact: "100000" }exact 包装器中的原始金额

适配器会自动处理此转换。

说明

  • 仅提供只读元数据端点。
  • 输出为 JSON 或表格；reserves 还支持 --format spell。
  • 自动化场景优先使用 --format json；快速交互式检查可使用表格。

评论

支持 Markdown