@continuumdao/ctm-mpc-defi 0.2.42 → 0.2.44

package/dist/agent/skills/aave-v4/SKILL.md

@@ -38,6 +38,8 @@ Do **not** web-search Aave APRs, APYs, or reserves. Load the protocol and use th
 | Withdraw supplied balance | `ctm_aave_v4_build_withdraw_multisign` |
 | Borrow against collateral | `ctm_aave_v4_build_borrow_multisign` |
 | Repay debt | `ctm_aave_v4_build_repay_multisign` |
+| List wallet-wide Merkl claimables | `ctm_aave_v4_fetch_merkl_rewards` |
+| Claim Merkl rewards | `ctm_aave_v4_build_merkl_claim_multisign` |
 
 ## Common write inputs
 
@@ -103,6 +105,12 @@ Example: “How do Aave lending APRs compare to Compound on Ethereum?”
 2. **Borrow debt asset:** `ctm_aave_v4_build_borrow_multisign` with `underlying` = debt token (USDC), `amountHuman`, optional `collateralUnderlying` = collateral address.
 3. Explain: health factor must stay above liquidation thresholds; server may refuse or ask for risk acknowledgment.
 
+### Claim Merkl rewards
+
+1. Activate `defi:aave-v4:rewards` (or alias `aave:rewards`) after `load_defi_protocol aave-v4`.
+2. `ctm_aave_v4_fetch_merkl_rewards({ keyGenId, chainId })`.
+3. If `firstRootClaimableCount` > 0: `ctm_aave_v4_build_merkl_claim_multisign({ keyGenId, chainId })`. Repeat when `additionalRoots` > 0.
+
 ### Repay and withdraw
 
 1. **Repay:** reduce debt with repay tool (`underlying` = debt token).
@@ -154,4 +162,4 @@ After stETH is supplied:
 
 - Native supply uses wrapped native from `get_defi_protocol_supported_tokens` (`nativeWrapped`).
 - Token filter: `api_underlyings` — only API-listed underlyings are valid per chain.
-- Merkl rewards and advanced position actions are available in the node app UI, not as separate MCP tools today.
+- Wallet-wide Merkl: `ctm_aave_v4_fetch_merkl_rewards` then `ctm_aave_v4_build_merkl_claim_multisign({ keyGenId, chainId })`. Not Aave-only — other venues’ campaigns on the same distributor can appear. Server fetches proofs; do not invent `claimData`. Call again if `additionalRoots` > 0. rEUL is omitted (Euler unlock). Advanced Aave position actions besides this claim stay in the node app UI.

package/dist/agent/skills/aerodrome/SKILL.md

@@ -86,7 +86,7 @@ Skip emissions when `claimEmissions` is `null` (no gauge). Slipstream unstaked f
 
 Loaded from official GitHub (`velodrome-finance/sugar` `deployments/base.env` and `aerodrome-finance/docs` security.mdx) with baked fallbacks. Do not invent addresses.
 
-Coinbase B20 stocks (AAPLc, NVDAc, METAc, GOOGLc, SPCXc, …) trade on **Slipstream 3** (`clFactory3`) vs USDC. New official names are picked up from the [Base tokenized-stocks docs](https://docs.base.org/base-chain/asset-issuance/tokenized-stocks-on-base) and from Sugar tokens whose address uses the B20 ASSET prefix `0xb200…`. The docs fetch is optional: if that page is gone or unusable, discovery continues from the seed list + Sugar. `issued` is live `totalSupply() > 0` — do not hard-code unissued tickers. Quotes use factory `getPool` discovery + MixedRouteQuoterV3 (path bitmasks). Sugar `forSwaps` alone misses these pools. Native ETH → stock is typically WETH → USDC → stock.
+Coinbase B20 stocks (AAPLc, NVDAc, METAc, GOOGLc, SPCXc, …) trade on **Slipstream 3** (`clFactory3`) vs USDC. Stock-backed **loans** (lend/borrow USDC against B20 collateral) are Morpho — `load_defi_protocol morpho` and `ctm_morpho_fetch_stock_markets`, not Aerodrome LP. New official names are picked up from the [Base tokenized-stocks docs](https://docs.base.org/base-chain/asset-issuance/tokenized-stocks-on-base) and from Sugar tokens whose address uses the B20 ASSET prefix `0xb200…`. The docs fetch is optional: if that page is gone or unusable, discovery continues from the seed list + Sugar. `issued` is live `totalSupply() > 0` — do not hard-code unissued tickers. Quotes use factory `getPool` discovery + MixedRouteQuoterV3 (path bitmasks). Sugar `forSwaps` alone misses these pools. Native ETH → stock is typically WETH → USDC → stock.
 
 ## Out of scope
 

package/dist/agent/skills/arcus/SKILL.md

@@ -33,7 +33,7 @@ Withdraw: `ctm_arcus_build_withdraw_multisign` with `product: perp|spot` (EIP-71
 
 ## USDG yield (Robinhood Earn — not Arcus)
 
-**Arcus deposit does not earn yield** — it moves USDG into perp/spot trading collateral. For **Robinhood Earn** (~variable APY on USDG via Morpho on chain 4663), use **`load_defi_protocol morpho`** and `ctm_morpho_build_vault_deposit_multisign` with `robinhoodEarn: true` or fetch `query: "robinhood earn"`. See morpho SKILL § Robinhood Earn.
+**Arcus deposit does not earn yield** — it moves USDG into perp/spot trading collateral. For **Robinhood Earn** (~variable APY on USDG via Morpho on chain 4663), use **`load_defi_protocol morpho`** and `ctm_morpho_build_vault_deposit_multisign` with `robinhoodEarn: true` or fetch `query: "robinhood earn"`. See morpho SKILL § Robinhood Earn. Coinbase B20 **stock-backed loans** (USDC against AAPLc on Base) are also Morpho (`ctm_morpho_fetch_stock_markets`), not Arcus trading.
 
 ## Perp leverage
 

package/dist/agent/skills/euler-v2/SKILL.md

@@ -8,3 +8,12 @@ description: Euler v2 isolated lend/borrow, vault withdraw, and collateral opera
 Supported chains from `get_defi_protocol_supported_chains` (Euler V3 API, Goldsky `euler-simple-*` fallback). Underlyings from `get_defi_protocol_supported_tokens` (V3 EVK / Earn vaults). Isolated lend: `ctm_euler_v2_fetch_lend_vaults`. Earn vaults (curated APY): `ctm_euler_v2_fetch_earn_vaults`. Do **not** web-search Euler APYs. Copy `evaultAddress` onto build tools.
 
 Tools include isolated lend/borrow, collateral deposit/withdraw, vault withdraw, borrow repay. All `ctm_euler_v2_build_*_multisign` tools return `{ requestId }` on success (shared gas/submit section appended by the server).
+
+## Merkl rewards
+
+Activate **`defi:euler-v2:rewards`** (alias `euler:rewards` / `euler-v2:rewards`) after `load_defi_protocol euler-v2`.
+
+1. `ctm_euler_v2_fetch_merkl_rewards({ keyGenId, chainId })` — wallet-wide on that chain, not Euler-only.
+2. If `firstRootClaimableCount` > 0: `ctm_euler_v2_build_merkl_claim_multisign({ keyGenId, chainId })`. Server fetches proofs. Do not invent `claimData`. Repeat when `additionalRoots` > 0.
+
+rEUL is omitted (`skippedReulCount`). Unlock vested EUL in the node app Euler Rewards tab — there is no MCP unlock tool.

package/dist/agent/skills/morpho/SKILL.md

@@ -1,6 +1,8 @@
 # Morpho
 
-Morpho integration: **listed earn vaults** (V1 + V2, unified), **Blue** variable-rate borrow, **Midnight** fixed-rate/fixed-term books, and **Merkl** rewards.
+Morpho integration: **listed earn vaults** (V1 + V2, unified), **Lend** (Blue USDC supply + Midnight lend/offers + stock-backed books), **Blue borrow** (collateral/borrow/repay), **Midnight borrow**, **Coinbase B20 stock-backed loans** on Base, and **Merkl** rewards.
+
+Tool families after `load_defi_protocol morpho` (then `activate_tool_group` / search): `defi:morpho:vault` (Earn), `defi:morpho:lend` (lend USDC / stock-backed supply), `defi:morpho:blue` (borrow against collateral), `defi:morpho:midnight` (fixed-rate borrow), `defi:morpho:rewards`. Alias `morpho:lend` → `defi:morpho:lend`.
 
 ## Data
 
@@ -23,7 +25,7 @@ Morpho integration: **listed earn vaults** (V1 + V2, unified), **Blue** variable
 `underlying` accepts **symbol** (e.g. `USDC`, `WETH`) or **ERC-20 address**.  
 `query` is **case-insensitive** on vault name, symbol, address, and underlying symbol.
 
-Use returned `vaultAddress` and `underlyingAddress` for deposit multisign. Each row includes `totalDepositsUsd`, `liquidityUsd`, `netApy` / `netApy7d` / `netApy30d` / `netApy90d`, `performanceFee`, `rewards[]` (extra incentive APR from Morpho `allRewards`), and `exposure[]` (allocated markets/strategies with % of TVL). Blue rows also include `netSupplyApyLabel` and `rewards[]`. Incentive APR is extra and variable.
+Use returned `vaultAddress` and `underlyingAddress` for deposit multisign. Each row includes `totalDepositsUsd`, `liquidityUsd`, `netApy` / `netApy7d` / `netApy30d` / `netApy90d`, `performanceFee`, `rewards[]` (extra incentive APR from Morpho `allRewards`), and `exposure[]` (allocated markets/strategies with % of TVL). Blue rows include `netSupplyApyLabel`, `lltvLabel`, TVL, `utilizationLabel`, and `rewards[]`. Incentive APR is extra and variable — do not add `rewards[]` on top of `netApy` / `netSupplyApy` a second time.
 
 ## Arc (Circle, USDC-native gas)
 
@@ -75,6 +77,30 @@ Aliases `robinhood earn`, `robinhood`, and `steakhouse usdg` resolve to the Stea
 
 Do **not** use `ctm_arcus_build_deposit_multisign` for yield — that funds perp/spot margin, not Morpho lending.
 
+## Stock-backed loans (Base)
+
+Activate **`defi:morpho:lend`** (alias `morpho:lend`) for stock-market reads plus Blue supply and Midnight lend. Borrow against stock stays on `defi:morpho:blue` / `defi:morpho:midnight`.
+
+Curators deployed isolated **Blue** (variable) and **Midnight** (fixed) markets on **Base (8453)** that take **Coinbase B20 tokenized stocks** as collateral and lend **USDC**. Morpho is the credit layer — not Aerodrome swap/LP, not Hyperliquid/Arcus trading, not Robinhood Earn (USDG on 4663).
+
+| Goal | Tool |
+|------|------|
+| List stock-collateral books | `ctm_morpho_fetch_stock_markets({ chainId: 8453 })` or omit chainId (defaults to Base) |
+| One ticker | `ctm_morpho_fetch_stock_markets({ collateral: "AAPLc" })` |
+| Variable only / fixed only | `rate: "variable"` or `rate: "fixed"` |
+| Blue by ticker | `ctm_morpho_fetch_blue_markets({ chainId: 8453, collateral: "AAPLc" })` |
+| Blue USDC loan books | `ctm_morpho_fetch_blue_markets({ chainId: 8453, loan: "USDC" })` |
+| All B20 Blue | `ctm_morpho_fetch_blue_markets({ chainId: 8453, query: "stock" })` |
+
+Tickers (`AAPLc`, `NVDAc`, `METAc`, `GOOGLc`, `SPCXc`, …) are enough — do **not** ask the user for a 0x address. Pick a `marketId` and `lltvLabel` (same stock can have 62.5% and 77% markets). Then:
+
+- **Borrow USDC against stock:** `ctm_morpho_build_blue_collateral_deposit_multisign` then `ctm_morpho_build_blue_borrow_multisign` (or Midnight borrow).
+- **Lend USDC (variable):** `ctm_morpho_build_blue_supply_multisign` — withdraw with `ctm_morpho_build_blue_withdraw_multisign`.
+- **Lend/borrow fixed:** Midnight tools with `marketId` from the stock fetch `books[]`.
+- **Positions:** `ctm_morpho_fetch_positions` (vault + Blue supply/borrow/collateral). Midnight stays on `ctm_morpho_fetch_midnight_positions`.
+
+Compliance (notes only — no KYC in these tools): Coinbase B20 is Regulation S / **not for U.S. persons**. Chainlink equity feeds are **24/5** and hold last close off cash hours — do not treat a weekend `updatedAt` as a live mark. Liquidity is still thin.
+
 ## Morpho Midnight (fixed rate / fixed term)
 
 Midnight is a separate order-book primitive (not Blue). Users can **take** existing offers via MidnightBundles, or **post a lend offer** that parks the loan token in Morpho Blue (variable yield) until a borrower fills it. Launch liquidity is strongest on **Base (8453)** (e.g. cbBTC/USDC maturities).
@@ -108,14 +134,19 @@ Server re-quotes at build time and fills `taker` / `maker` / `onBehalf` from the
 | Tool | Action |
 |------|--------|
 | `ctm_morpho_fetch_earn_vaults` | List/search Morpho-listed earn vaults |
-| `ctm_morpho_fetch_blue_markets` | List Blue markets |
+| `ctm_morpho_fetch_blue_markets` | List Blue markets (tickers OK; `query: "stock"` = B20 collateral) |
+| `ctm_morpho_fetch_stock_markets` | Base B20 stock-backed Blue + Midnight |
+| `ctm_morpho_fetch_positions` | Vault + Blue supply/borrow/collateral positions |
 | `ctm_morpho_fetch_midnight_books` | List Midnight books |
 | `ctm_morpho_fetch_midnight_quote` | Quote Midnight fill |
 | `ctm_morpho_fetch_midnight_positions` | Midnight positions |
 | `ctm_morpho_fetch_midnight_offers` | Open Midnight lend offers |
+| `ctm_morpho_fetch_merkl_rewards` | Wallet-wide Merkl claimables (`keyGenId` or `user` + `chainId`) |
 | `ctm_morpho_build_vault_deposit_multisign` | Vault deposit (listed V1 or V2) |
 | `ctm_morpho_build_vault_withdraw_multisign` | Vault withdraw |
 | `ctm_morpho_build_blue_collateral_deposit_multisign` | Blue supplyCollateral |
+| `ctm_morpho_build_blue_supply_multisign` | Blue supply (lend loan token) |
+| `ctm_morpho_build_blue_withdraw_multisign` | Blue withdraw supplied loan token |
 | `ctm_morpho_build_blue_borrow_multisign` | Blue borrow |
 | `ctm_morpho_build_blue_repay_multisign` | Blue repay |
 | `ctm_morpho_build_blue_collateral_withdraw_multisign` | Blue withdrawCollateral |
@@ -124,7 +155,7 @@ Server re-quotes at build time and fills `taker` / `maker` / `onBehalf` from the
 | `ctm_morpho_build_midnight_cancel_lend_offer_multisign` | Cancel Midnight lend offer |
 | `ctm_morpho_build_midnight_borrow_multisign` | Midnight borrow |
 | `ctm_morpho_build_midnight_repay_multisign` | Midnight repay + withdraw |
-| `ctm_morpho_build_merkl_claim_multisign` | Merkl claim |
+| `ctm_morpho_build_merkl_claim_multisign` | Wallet-wide Merkl claim (`keyGenId` + `chainId`; server fetches proofs) |
 
 Pass `marketId` from Morpho API for Blue/Midnight tools (not recomputed on-chain).  
 **Deposits** require a **Morpho-listed** vault (`ctm_morpho_fetch_earn_vaults`). Unlisted/test vaults are rejected.
@@ -134,8 +165,10 @@ Pass `marketId` from Morpho API for Blue/Midnight tools (not recomputed on-chain
 1. `get_preferred_key_gen` → note `keyGenId` (or use the conversation KeyGen id).
 2. `ctm_morpho_fetch_earn_vaults` — pick `vaultAddress` and `underlyingAddress` by asset and/or name.
 3. `ctm_morpho_build_vault_deposit_multisign` — use each tool’s **input schema** (`keyGenId`, fetch output addresses, `amountHuman`, etc.). Server resolves `keyGen`, `executorAddress`, `rpcUrl`, `chainDetail`; agents must not pass those.
-4. Blue borrow/collateral: `marketId` from Morpho API; server resolves `marketParams`.
-5. Midnight: books → quote → lend now, lend offer (earn until filled), borrow, or cancel/repay as above.
+4. Blue: `marketId` from fetch; server resolves `marketParams`. Collateral + borrow, or supply/withdraw loan token (USDC).
+5. Stock-backed on Base: `ctm_morpho_fetch_stock_markets` then the same Blue/Midnight build tools.
+6. Midnight: books → quote → lend now, lend offer (earn until filled), borrow, or cancel/repay as above.
+7. Merkl: `ctm_morpho_fetch_merkl_rewards` then `ctm_morpho_build_merkl_claim_multisign({ keyGenId, chainId })`. Wallet-wide on that chain — not Morpho-only. Do not invent `claimData`. Call again if `additionalRoots` > 0.
 
 ## Troubleshooting
 

package/dist/agent/skills/yield-compare/SKILL.md

@@ -13,7 +13,9 @@ Do **not** web-search rates. Do **not** use DefiLlama. HIP-3 / Arcus stock tradi
 
 If the operator started **Best yield** / plan mode `yield`: this thread **authors the plan file**. Ask for the asset first. Then `get_defi_protocol_skill({ protocolId: "yield-compare" })` **once** and write workstreams — do **not** `load_defi_protocol`, search Continuum tools, or spawn specialists on the parent. Execute runs one specialist per listed protocol. Research-only — no `ctm_*_build_*_multisign`. Table categories: `idle` / `lp` / `vault` / `perp_funding`. GMX and Hyperliquid only if they asked. Catalog MCP is context only.
 
-Each Execute protocol leaf must list `toolGroups: ["defi_discovery", "defi:<protocol>:market-data", "keygen", "keygen_messaging"]` (canonical ids: `aave-v4`, `compound-v3`, `euler-v2`, `morpho`, `maple-syrup`, `curve-dao`, `aerodrome`, `pendle`) and `budget: { maxRounds: 16, maxWallClockMs: 240000 }`. Slim leaves cannot search/activate packs — without `defi_discovery` they never see `load_defi_protocol` or official `ctm_*` fetch tools. Do **not** use `agent_bash` / `agent_read_file` / `agent_grep` on a yield leaf — call the official fetch (`ctm_aave_v4_fetch_markets`, `ctm_compound_v3_fetch_markets`, `ctm_aerodrome_fetch_lp_yields` on Base `8453`, `ctm_pendle_fetch_markets` / `ctm_pendle_search_assets`, …) then post `mpc-task-result`. Ticker filters (`underlying: "USDT"`) are valid on Aave/Maple/Morpho fetches — do not invent ERC-20 addresses. Aave v4 is Ethereum-first (`1`; also 10 / 43114). Maple is Ethereum (`1`). Aerodrome is Base (`8453`) only. Pendle is any Core `chainId` ∩ node registry — research-only fetch, no build.
+For **USDC / USDT**, the authored plan notes **must** mention Morpho stock-backed USDC loans as an **optional extra** (isolated Blue/Midnight books against Coinbase B20 collateral such as AAPLc/NVDAc; thin liquidity; 24/5 oracles; Regulation S / non-US). Do **not** add a Morpho stock Execute workstream or call `ctm_morpho_fetch_stock_markets` unless the operator says yes or already asked about stocks / tokenized stocks / stock-backed loans.
+
+Each Execute protocol leaf must list `toolGroups: ["defi_discovery", "defi:<protocol>:market-data", "keygen", "keygen_messaging"]` (canonical ids: `aave-v4`, `compound-v3`, `euler-v2`, `morpho`, `maple-syrup`, `curve-dao`, `aerodrome`, `pendle`) and `budget: { maxRounds: 16, maxWallClockMs: 240000 }`. Slim leaves cannot search/activate packs — without `defi_discovery` they never see `load_defi_protocol` or official `ctm_*` fetch tools. Do **not** use `agent_bash` / `agent_read_file` / `agent_grep` on a yield leaf — call the official fetch (`ctm_aave_v4_fetch_markets`, `ctm_compound_v3_fetch_markets`, `ctm_morpho_fetch_earn_vaults`, `ctm_morpho_fetch_blue_markets` with `loan: "USDC"` / `"USDT"`, `ctm_aerodrome_fetch_lp_yields` on Base `8453`, `ctm_pendle_fetch_markets` / `ctm_pendle_search_assets`, …) then post `mpc-task-result`. Ticker filters (`underlying: "USDT"`, Morpho `loan: "USDC"`) are valid on Aave/Maple/Morpho fetches — do not invent ERC-20 addresses. Morpho leaf: report vault `netApy` and Blue `netSupplyApyLabel`; footnote `rewards[]` as variable extras — do not add them on top of net APY a second time. Skip empty Blue books (no supply TVL). `ctm_morpho_fetch_stock_markets` only after the operator says yes. Aave v4 is Ethereum-first (`1`; also 10 / 43114). Maple is Ethereum (`1`). Aerodrome is Base (`8453`) only. Pendle is any Core `chainId` ∩ node registry — research-only fetch, no build.
 
 ## Units and caveats
 
@@ -45,10 +47,11 @@ Call `get_defi_protocol_skill({ protocolId: "yield-compare" })` for this map, th
 
 ### USDC / USDT
 
-1. Aave / Compound / Euler lend / Morpho earn / Maple (`ctm_maple_fetch_markets`)
+1. Aave / Compound / Euler lend / Morpho earn (`ctm_morpho_fetch_earn_vaults`) / Morpho Blue loan markets (`ctm_morpho_fetch_blue_markets({ loan: "USDC" })`) / Maple (`ctm_maple_fetch_markets`). Morpho: rank on `netApy` / `netSupplyApyLabel`; footnote `rewards[]` as variable extras.
 2. `ctm_aerodrome_fetch_lp_yields` (Base) and `ctm_curve_dao_fetch_lp_yields` if they want DEX LP
 3. `ctm_pendle_fetch_markets` — optional PT / YT / LP implied APY if they asked about Pendle (research-only)
 4. `ctm_gmx_fetch_gm_apy` / `ctm_hyperliquid_fetch_vault_apys` / perp funding — **only if they asked** about GMX, HL vaults, or funding
+5. Morpho stock-backed USDC loans — **optional extra in plan notes only**. Call `ctm_morpho_fetch_stock_markets` only if they say yes.
 
 ### USDS
 
@@ -73,6 +76,7 @@ Aave / Morpho / Euler / `ctm_curve_dao_fetch_lp_yields`
 
 - Main-pair LP only: Aerodrome `fetch_lp_yields`, Curve `fetch_lp_yields` (~100 each). Optional Pendle LP implied APY via `ctm_pendle_fetch_markets` (research-only).
 - Stock LP: `ctm_aerodrome_fetch_stock_lp_yields` (B20) **only if the user asked about stocks**.
+- Morpho stock-backed loans: `ctm_morpho_fetch_stock_markets` **only after they say yes** (or already asked about stocks / stock-backed loans). Isolated equity credit, not idle stables. Always mention as an optional extra in USDC/USDT Best Yield plan notes.
 - Hyperliquid HIP-3: `ctm_hyperliquid_fetch_stock_markets` is **trading**, not idle savings. Include HIP-3 **funding** only if they asked about stocks.
 
 ## Euler earn vs isolated lend