grimoire-morpho-blue

Fetches Morpho Blue public deployment metadata using the Grimoire venue CLI. Use when you need contract addresses or adapter info.

By franalgaba · 1,049 installs

npx skills add franalgaba/grimoire --skill grimoire-morpho-blue

Source repository · Upstream listing

Grimoire Morpho Blue Skill Use this skill to query Morpho Blue deployment metadata and vault snapshots for spell params. Preferred invocations: grimoire venue morpho blue ... npx y @grimoirelabs/cli venue morpho blue ... (no install) bun run packages/cli/src/index.ts venue morpho blue ... (repo local) grimoire morpho blue ... (direct binary from @grimoirelabs/venues ) Recommended preflight: grimoire venue doctor adapter morpho blue chain 8453 rpc url <rpc json Use format spell to emit a params: snapshot block. The snapshot includes provenance fields ( snapshot at , snapshot source ) and APY data. Use vault liquidity for Morpho Vault V2 vault wide withdrawal liquidity. It reads onchain Vault V2 fields, caps Morpho Market V1 liquidity adapter assets by available underlying market cash, and does not use ERC 4626 maxWithdraw / maxRedeem , which Vault V2 intentionally returns as 0 . APY semantics: apy / net apy are decimal rates (for example 0.0408 = 4.08% ). When reporting, include both decimal and percent display when possible. Commands grimoire venue morpho blue info — adapter metadata grimoire venue morpho blue addresses [ chain <id ] — contract addresses per chain 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 ] — list and filter vaults 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 ] — generate spell params: block for vaults (agent only) grimoire venue morpho blue vault liquidity [ chain <id ] vault <address [ rpc url <url ] [ format json table spell] — read Morpho Vault V2 withdrawable liquidity in asset units and integer bps Examples Use vaults snapshot to emit a params: block for spell inputs. This is an agent only command (output suppressed in interactive mode). vault liquidity format spell emits payload ready JSON params for protocol: morpho vault v2 , metric: withdrawable liquidity bps , withdrawable liquidity assets , total assets , idle assets , liquidity adapter , and liquidity adapter assets . Example provenance output fields to preserve: snapshot at snapshot source units (for example net apy=decimal , net apy pct=percent , tvl usd=usd ) Metric Surface (Spell Comparisons) Morpho exposes the apy metric surface and supports selector based market targeting: Use apy(morpho, asset[, selector]) for Morpho Blue market APY comparisons. Use metric("utilization bps", morpho, asset[, selector]) for Morpho Blue market utilization checks. Use metric("vault apy", morpho, asset, selector) or metric("vault net apy", morpho, asset, selector) for MetaMorpho vault comparisons. Use metric("withdrawable liquidity bps", morpho, asset, selector) for Morpho Vault V2 live withdrawal liquidity checks. Selector behavior: market no selector ( apy ): resolves by asset on the active chain and picks the highest TVL match config market selector: use known market ids from adapter config (for example weth usdc 86 ) onchain market id selector: use raw market id ( 0x... ) vault selectors ( vault apy / vault net apy ): vault=<address name symbol or bare vault address/name/symbol vault apy / vault net apy require explicit selector (no implicit fallback) When multiple vaults/markets exist for one asset, pass an explicit selector for deterministic comparisons. Spell Constraints Morpho Blue actions do not support runtime constraints ( max slippage , etc.). Value moving actions require an explicit market id . Use with (market id=...) when positional args are not convenient: Use grimoire venue morpho blue vaults to discover available market IDs. Action Selection Guide Choose actions by strategy intent: Supply only strategy (no borrowing planned): prefer vault deposit / vault withdraw . Borrowing strategy (or future borrow/repay/collateral management): use market actions with explicit market id . Hard rules: vault deposit / vault withdraw require explicit vault address and do not use market id . lend , withdraw , borrow , repay , supply collateral , withdraw collateral require explicit market id . If vault address is missing for a vault action, do not guess: list candidate vaults and require user selection before authoring/executing. Action Semantics lend(asset, amount, market id) : lend the market loan asset (lender side). withdraw(asset, amount, market id) : withdraw previously lent loan asset. supply collateral(asset, amount, market id) : post collateral for borrowing (borrower side). withdraw collateral(asset, amount, market id) : remove posted collateral. borrow(asset, amount, collateral?, market id) : borrow the market loan asset. repay(asset, amount, market id) : repay borrowed loan asset. vault deposit(asset, amount, vault address) : deposit into MetaMorpho vault. vault withdraw(asset, amount, vault address) : withdraw from MetaMorpho vault. lend and supply collateral are not interchangeable: lend targets lender yield on loan asset. supply collateral is collateral management for borrowing capacity. APY expectations: lend accrues market supply APY (plus possible incentives). supply collateral does not earn market lender APY; it is risk buffer for borrow. Collateral token may have its own native yield behavior (for example wstETH), separate from Morpho supply APY. Workflow Patterns Supply only via vault: If vault is not provided, run discovery first and ask user to pick: Then use the selected vault address in vault deposit / vault withdraw . Borrow workflow (market): Unwind borrow workflow: Lend only via market (when explicit market control is desired): Default Markets The adapter ships with pre configured markets for Ethereum (chain 1) and Base (chain 8453): Ethereum (chain 1) Market Loan Collateral LLTV cbbtc usdc 1 USDC cbBTC 86% wbtc usdc 1 USDC WBTC 86% wsteth weth 1 WETH wstETH 96.5% Base (chain 8453) Market Loan Collateral LLTV cbbtc usdc 86 USDC cbBTC 86% weth usdc 86 USDC WETH 86% Notes Outputs JSON/table; vaults also supports format spell . Uses the SDK's chain address registry. Prefer format json in automation and format table for quick triage.