需要查询 Morpho Blue 部署元数据…

当需要通过 Grimoire CLI 查询 Morpho Blue/MetaMorpho/Vault V2 的合约地址、金库 APY、TVL、提现流动性并生成 Spell params 时使用。

适用场景

解决思路

1. 使用 Grimoire venue CLI 查询 Morpho Blue 部署元数据和金库快照，用于生成 spell 参数；优先调用形式包括：`grimoire venue morpho-blue ...`；`npx -y @grimoirelabs/cli venue morpho-blue ...`（免安装）；`bun run packages/cli/src/index.ts venue morpho-blue ...`（仓库本地）；`grimoire-morpho-blue ...`（来自 `@grimoirelabs/venues` 的直接二进制）。
2. 推荐预检：运行 `grimoire venue doctor --adapter morpho-blue --chain 8453 --rpc-url <rpc> --json`。
3. 使用 `--format spell` 生成 `params:` 快照块；快照包含来源字段 `snapshot_at`、`snapshot_source` 以及 APY 数据。
4. 对 Morpho Vault V2 的金库级提现流动性，使用 `vault-liquidity`。它读取链上 Vault V2 字段，将 Morpho Market V1 liquidity-adapter 资产按可用底层市场现金设上限，并且不使用 ERC-4626 的 `maxWithdraw` / `maxRedeem`（Vault V2 会有意将其返回为 `0`）。
5. APY 语义：`apy` / `net_apy` 是十进制利率（例如 `0.0408` = `4.08%`）。报告时尽可能同时给出十进制和百分比显示。
6. 命令：`grimoire venue morpho-blue info` 查询适配器元数据。
7. 命令：`grimoire venue morpho-blue addresses [--chain <id>]` 查询每条链的合约地址。
8. 命令：`grimoire venue morpho-blue vaults [--chain <id>] [--asset <symbol>] [--min-tvl <usd>] [--min-apy <decimal>] [--min-net-apy <decimal>] [--sort <netApy|apy|tvl|totalAssetsUsd|name>] [--order <asc|desc>] [--limit <n>]` 列出并筛选金库。
9. 命令：`grimoire venue morpho-blue vaults-snapshot [--chain <id>] [--asset <symbol>] [--min-tvl <usd>] [--min-apy <decimal>] [--min-net-apy <decimal>] [--sort <netApy|apy|tvl|totalAssetsUsd|name>] [--order <asc|desc>] [--limit <n>]` 为金库生成 spell `params:` 块（仅 agent 模式）。
10. 命令：`grimoire venue morpho-blue vault-liquidity [--chain <id>] --vault <address> [--rpc-url <url>] [--format json|table|spell]` 以资产单位和整数 bps 读取 Morpho Vault V2 可提现流动性。
11. 运行示例：`grimoire venue morpho-blue info --format table`；`grimoire venue morpho-blue addresses --chain 1`；`grimoire venue morpho-blue addresses --chain 8453`；`grimoire venue morpho-blue vaults --chain 8453 --asset USDC --min-tvl 5000000 --format table`；`grimoire venue morpho-blue vaults --chain 8453 --asset USDC --min-tvl 5000000 --format spell`；`grimoire venue morpho-blue vaults-snapshot --chain 8453 --asset USDC --min-tvl 5000000`；`grimoire venue morpho-blue vault-liquidity --chain 8453 --vault 0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9 --format json`；`grimoire venue morpho-blue vault-liquidity --chain 8453 --vault 0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9 --format spell`。
12. 使用 `vaults-snapshot` 生成 spell 输入的 `params:` 块；这是 agent-only 命令（交互模式下输出被抑制）。
13. `vault-liquidity --format spell` 会为 `protocol: morpho-vault-v2`、`metric: withdrawable_liquidity_bps`、`withdrawable_liquidity_assets`、`total_assets`、`idle_assets`、`liquidity_adapter`、`liquidity_adapter_assets` 生成可直接作为 payload 的 JSON 参数。
14. 保留示例来源输出字段：`snapshot_at`、`snapshot_source`、`units`（例如 `net_apy=decimal`、`net_apy_pct=percent`、`tvl_usd=usd`）。
15. Metric Surface（Spell 比较）：Morpho 暴露 `apy` metric surface，并支持基于 selector 的市场定向；在 Spell 中可使用以下表达式：`morpho_apy_default = apy(morpho, USDC)`；`morpho_apy_market = apy(morpho, USDC, "weth-usdc-86")`；`morpho_apy_market_id = apy(morpho, USDC, "0x...")`；`morpho_apy_generic = metric("apy", morpho, USDC, "wbtc-usdc-86")`；`morpho_utilization_bps = metric("utilization_bps", morpho, USDC, "wbtc-usdc-86")`；`vault_apy = metric("vault_apy", morpho, USDC, "vault=0xVaultAddress")`；`vault_net_apy = metric("vault_net_apy", morpho, USDC, "vault=0xVaultAddress")`；`vault_withdrawable_liquidity_bps = metric("withdrawable_liquidity_bps", morpho, USDC, "vault=0xVaultAddress")`。
16. 使用 `apy(morpho, asset[, selector])` 做 Morpho Blue 市场 APY 比较。
17. 使用 `metric("utilization_bps", morpho, asset[, selector])` 做 Morpho Blue 市场利用率检查。
18. 使用 `metric("vault_apy", morpho, asset, selector)` 或 `metric("vault_net_apy", morpho, asset, selector)` 做 MetaMorpho 金库比较。
19. 使用 `metric("withdrawable_liquidity_bps", morpho, asset, selector)` 做 Morpho Vault V2 实时提现流动性检查。
20. Selector 行为：市场无 selector（`apy`）时，按当前链上的 `asset` 解析并选择 TVL 最高的匹配项。
21. Selector 行为：配置市场 selector 时，使用适配器配置中的已知 market id（例如 `weth-usdc-86`）。
22. Selector 行为：链上 market id selector 时，使用原始 market id（`0x...`）。
23. Selector 行为：金库 selector（`vault_apy` / `vault_net_apy`）使用 `vault=<address|name|symbol>` 或裸 vault 地址/名称/符号。
24. Selector 行为：`vault_apy` / `vault_net_apy` 需要显式 selector（无隐式回退）。
25. 当一个资产存在多个金库/市场时，传入显式 selector 以进行确定性比较。
26. Spell 约束：Morpho Blue 动作不支持运行时约束（`max_slippage` 等）；转移价值的动作需要显式 `market_id`。示例：`morpho_blue.lend(USDC, params.amount, "cbbtc-usdc-86")`；`morpho_blue.withdraw(USDC, params.amount, "cbbtc-usdc-86")`；`morpho_blue.borrow(USDC, params.amount) with ( market_id="cbbtc-usdc-86", )`；`morpho_blue.supply_collateral(cbBTC, params.amount, "cbbtc-usdc-86")`；`morpho_blue.withdraw_collateral(cbBTC, params.amount, "cbbtc-usdc-86")`。
27. 当位置参数不方便时，使用 `with (market_id=...)`。示例：`morpho_blue.lend(USDC, params.amount) with ( market_id="0x1234...abcd", )`。
28. 使用 `grimoire venue morpho-blue vaults` 发现可用 market IDs。
29. 动作选择指南：只供应策略（不计划借款）优先使用 `vault_deposit` / `vault_withdraw`。
30. 动作选择指南：借款策略（或未来需要 borrow/repay/collateral 管理）使用带显式 `market_id` 的市场动作。
31. 硬规则：`vault_deposit` / `vault_withdraw` 需要显式 vault 地址，且不使用 `market_id`。
32. 硬规则：`lend`、`withdraw`、`borrow`、`repay`、`supply_collateral`、`withdraw_collateral` 需要显式 `market_id`。
33. 硬规则：如果 vault 动作缺少 vault 地址，不要猜测；先列出候选金库并要求用户选择，然后再编写/执行。
34. 动作语义：`lend(asset, amount, market_id)` 借出市场贷款资产（lender 侧）。
35. 动作语义：`withdraw(asset, amount, market_id)` 撤回之前借出的贷款资产。
36. 动作语义：`supply_collateral(asset, amount, market_id)` 为借款提交抵押品（borrower 侧）。
37. 动作语义：`withdraw_collateral(asset, amount, market_id)` 移除已提交的抵押品。
38. 动作语义：`borrow(asset, amount, collateral?, market_id)` 借入市场贷款资产。
39. 动作语义：`repay(asset, amount, market_id)` 偿还借入的贷款资产。
40. 动作语义：`vault_deposit(asset, amount, vault_address)` 存入 MetaMorpho 金库。
41. 动作语义：`vault_withdraw(asset, amount, vault_address)` 从 MetaMorpho 金库提取。
42. `lend` 与 `supply_collateral` 不可互换：`lend` 针对贷款资产的 lender 收益；`supply_collateral` 是用于借款额度的抵押品管理。
43. APY 预期：`lend` 累计市场 supply APY（外加可能的激励）；`supply_collateral` 不赚取市场 lender APY，它是借款的风险缓冲；抵押品代币可能有自己的原生收益行为（例如 wstETH），与 Morpho supply APY 分开。
44. 工作流模式：仅供应通过金库：`morpho_blue.vault_deposit(USDC, params.amount, "0xVaultAddress")`。
45. 如果未提供 vault，先运行发现并让用户选择：`grimoire venue morpho-blue vaults --chain <id> --asset <symbol> --sort netApy --order desc --limit 5 --format table`；然后在 `vault_deposit` / `vault_withdraw` 中使用选中的 vault 地址。
46. 借款工作流（市场）：`morpho_blue.supply_collateral(WETH, params.collateral_amount, "weth-usdc-86")`；`morpho_blue.borrow(USDC, params.borrow_amount, WETH, "weth-usdc-86")`。
47. 解除借款工作流：`morpho_blue.repay(USDC, params.repay_amount, "weth-usdc-86")`；`morpho_blue.withdraw_collateral(WETH, params.collateral_out, "weth-usdc-86")`。
48. 仅借出工作流（市场）：当需要显式市场控制时：`morpho_blue.lend(USDC, params.amount, "cbbtc-usdc-86")`。
49. 默认市场：适配器预配置 Ethereum（chain 1）和 Base（chain 8453）市场。Ethereum：`cbbtc-usdc-1`（Loan USDC, Collateral cbBTC, LLTV 86%）、`wbtc-usdc-1`（USDC/WBTC, 86%）、`wsteth-weth-1`（WETH/wstETH, 96.5%）。Base：`cbbtc-usdc-86`（USDC/cbBTC, 86%）、`weth-usdc-86`（USDC/WETH, 86%）。
50. 注意事项：输出 JSON/table；`vaults` 也支持 `--format spell`。使用 SDK 的 chain address registry。自动化中优先 `--format json`，快速分诊用 `--format table`。

适用边界 · 注意事项

• 未安装或无法运行 Grimoire CLI，或未配置 Morpho Blue adapter 时不可用。
• 需要标准 ERC-4626 `maxWithdraw`/`maxRedeem` 语义时不要用 `vault-liquidity`，Vault V2 有意返回 0。
• 非 Morpho Blue/MetaMorpho/Vault V2 的借贷或金库场景不适用。