@continuumdao/ctm-mpc-defi 0.2.43 → 0.2.45

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/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/hyperliquid/SKILL.md

@@ -22,8 +22,9 @@ The MPC **executor address** (`keyGen.ethereumaddress`) is the Hyperliquid **use
 - **Spot ↔ Perp:** USDC is one asset split between **spot** and **perp margin** ledgers (not separate ERC20s). Move with `usdClassTransfer`.
 - **Vaults:** Deposit/withdraw USD into protocol vaults (withdraw includes accrued PnL).
 - **Staking:** Stake/unstake **HYPE** and delegate to validators.
+- **Borrow / lend:** Manual HyperCore money market. Collateralize **HYPE** / **UBTC**; borrow or supply quote assets (**USDC**, **USDT0**, **USDH**). Current **supply APR** and **borrow APR** come from `ctm_hyperliquid_fetch_lend_markets`.
 
-Trading reads use Hyperliquid **REST `/info`**. Writes use **CoreWriter** on HyperEVM (not the signed `/exchange` API).
+Trading reads use Hyperliquid **REST `/info`**. Most writes use **CoreWriter** on HyperEVM. Leverage, bridge withdraw, TP/SL brackets, and **borrow/lend** use signed **L1 `/exchange`** (EIP-712).
 
 ## Getting started (funding)
 
@@ -45,7 +46,7 @@ Positions and orders from MCP reflect **live HyperCore state** after prior txs a
 5. `ctm_hyperliquid_fetch_market_snapshot({ chainId, coin: "AAPL" })` — **`livePrice.midUsd`** is the current price; **`funding`** is official hourly HyperCore funding; `latestCandle` is the most recent bar; `candles` is capped (default 48). Throws if live price cannot be fetched.
 6. `ctm_hyperliquid_fetch_open_context({ chainId, executorAddress, coin: "Apple" })` — same resolution
 7. `ctm_hyperliquid_fetch_usd_class_balances({ chainId, executorAddress })` — spot vs perp USD if needed
-8. **Gas** — `get_multi_sign_gas_options({ chainId })` + `useCustomGas` for **CoreWriter** tools only (plain limit, close, cancel, transfers, vault, stake). **Skip gas** for `build_update_leverage_multisign`, `build_bridge_withdraw_multisign`, and limit orders **with TP/SL triggers** (EIP-712 `/exchange`).
+8. **Gas** — `get_multi_sign_gas_options({ chainId })` + `useCustomGas` for **CoreWriter** tools only (plain limit, close, cancel, transfers, vault, stake). **Skip gas** for `build_update_leverage_multisign`, `build_bridge_withdraw_multisign`, `build_lend_multisign`, and limit orders **with TP/SL triggers** (EIP-712 `/exchange`).
 9. `ctm_hyperliquid_build_limit_order_multisign` → **`{ requestId }`**
 10. Base MPC lifecycle (shared gas/submit section below)
 
@@ -69,6 +70,8 @@ Positions and orders from MCP reflect **live HyperCore state** after prior txs a
 | User vault equity | `ctm_hyperliquid_fetch_user_vault_equities` |
 | HYPE stake summary | `ctm_hyperliquid_fetch_staking_summary` |
 | Validator delegations | `ctm_hyperliquid_fetch_delegations` |
+| Core lend markets + **current supply/borrow APR** | `ctm_hyperliquid_fetch_lend_markets` — activate `hyperliquid:lend` |
+| Core lend positions + health + manual-borrow gate | `ctm_hyperliquid_fetch_lend_positions` |
 
 ### Multi-sign (writes)
 
@@ -87,6 +90,7 @@ Positions and orders from MCP reflect **live HyperCore state** after prior txs a
 | Delegate to validator | `ctm_hyperliquid_build_delegate_multisign` |
 | Undelegate | `ctm_hyperliquid_build_undelegate_multisign` |
 | Update per-market leverage | `ctm_hyperliquid_build_update_leverage_multisign` (EIP-712 — no gas) |
+| Supply / withdraw / borrow / repay | `ctm_hyperliquid_build_lend_multisign` (EIP-712 — no gas) |
 
 ### EIP-712 vs CoreWriter (critical for agents)
 
@@ -95,6 +99,7 @@ Positions and orders from MCP reflect **live HyperCore state** after prior txs a
 | Plain limit / close / cancel / USD transfer / vault / stake | CoreWriter EVM tx | **Yes** — `get_multi_sign_gas_options`, pass `useCustomGas` |
 | `build_update_leverage_multisign` | EIP-712 → `/exchange` | **No** — trigger without txParams |
 | `build_bridge_withdraw_multisign` | EIP-712 → `/exchange` | **No** |
+| `build_lend_multisign` | EIP-712 → `/exchange` | **No** — trigger without txParams |
 | Limit with `takeProfitTriggerPxHuman` and/or `stopLossTriggerPxHuman` | EIP-712 normalTpsl → `/exchange` | **No** — re-build if entry/TP/SL change |
 
 ## Common multisign inputs (all `build_*` tools)
@@ -203,6 +208,31 @@ Use `isLong: true` for a **long** position (submits sell reduce-only IoC):
 
 Check balances first with `ctm_hyperliquid_fetch_usd_class_balances`.
 
+## Borrow / lend (HyperCore)
+
+Activate **`hyperliquid:lend`** (`activate_tool_group`). Do not fold this into vaults or perp market-data.
+
+1. `ctm_hyperliquid_fetch_lend_markets` — current **`supplyYearlyRate` / `borrowYearlyRate`** are **APR** (decimal; `0.05` = 5%). Also `supplyAprPercent` / `borrowAprPercent`. `role` is `collateral` (LTV > 0) or `quote`.
+2. `ctm_hyperliquid_fetch_lend_positions` — supplied/borrowed, `health`, `manualBorrowEnabled`. If `userAbstraction` is `portfolioMargin`, **do not** call `operation: "borrow"`.
+3. `ctm_hyperliquid_build_lend_multisign` with `operation`: `supply` | `withdraw` | `borrow` | `repay`.
+
+Rules:
+
+- **HYPE / UBTC** (`BTC` aliases to UBTC) supplied as collateral **do not earn interest**.
+- **USDC / USDT0** (`USDT` aliases to USDT0) / **USDH** supplied earn utilization APR but **do not increase borrow capacity**.
+- `amountMax: true` (or `amountHuman: "max"`) sends wire `amount: null` — full withdraw/repay.
+- EIP-712 `/exchange` — **no `useCustomGas`**, trigger without txParams.
+
+```json
+{
+  "chainId": 999,
+  "purposeText": "HL supply 100 USDC",
+  "coin": "USDC",
+  "operation": "supply",
+  "amountHuman": "100"
+}
+```
+
 ## Vault / stake
 
 - **Vault deposit/withdraw:** `vaultAddress` from `fetch_vaults`; `usdHuman` amount. Mainnet vault catalog fetch can take ~10–15s (large stats feed). Testnet catalog is empty.

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

@@ -1,6 +1,8 @@
 # Morpho
 
-Morpho integration: **listed earn vaults** (V1 + V2, unified), **Blue** variable-rate supply/borrow, **Midnight** fixed-rate/fixed-term books, **Coinbase B20 stock-backed loans** on Base, 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
 
@@ -77,6 +79,8 @@ Do **not** use `ctm_arcus_build_deposit_multisign` for yield — that funds perp
 
 ## 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 |
@@ -137,6 +141,7 @@ Server re-quotes at build time and fills `taker` / `maker` / `onBehalf` from the
 | `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 |
@@ -150,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.
@@ -163,6 +168,7 @@ Pass `marketId` from Morpho API for Blue/Midnight tools (not recomputed on-chain
 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

@@ -11,10 +11,12 @@ Do **not** web-search rates. Do **not** use DefiLlama. HIP-3 / Arcus stock tradi
 
 ## Plan Mode
 
-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.
+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 vaults/funding only if they asked. Hyperliquid **Core lend** (USDC/USDT supply APR) is an **optional extra** for stables — mention in plan notes; add an Execute leaf only if they say yes or already asked about Hyperliquid / HL lend / Core lending. Catalog MCP is context only.
 
 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.
 
+For **USDC / USDT**, plan notes **must** also mention Hyperliquid Core lend as an **optional extra**: supply USDC/USDT0 on HyperCore to earn utilization **APR** (`ctm_hyperliquid_fetch_lend_markets`); HYPE/UBTC collateral earns nothing. Do **not** add a Hyperliquid Execute workstream or call `ctm_hyperliquid_fetch_lend_markets` unless the operator says yes or already asked about Hyperliquid / HL lend / Core lending. That leaf is research-only (`toolGroups: ["defi_discovery", "defi:hyperliquid:lend", "keygen", "keygen_messaging"]`) — report quote-token `supplyYearlyRate` as **APR** plus `borrowYearlyRate` as context; skip collateral rows; category `idle`. Do not treat Core lend as vault APR or perp funding.
+
 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
@@ -52,6 +54,7 @@ Call `get_defi_protocol_skill({ protocolId: "yield-compare" })` for this map, th
 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.
+6. Hyperliquid Core lend (`ctm_hyperliquid_fetch_lend_markets`) — **optional extra in plan notes**. Call only if they say yes or already asked about Hyperliquid / HL lend. Quote tokens only (USDC / USDT0); **APR** not APY. HYPE/UBTC collateral is not idle yield.
 
 ### USDS
 

package/dist/merklDistributor-CdqtZC9N.d.ts

@@ -0,0 +1,65 @@
+import { Address } from 'viem';
+
+declare const MERKL_API_BASE = "https://api.merkl.xyz";
+/**
+ * Canonical Merkl `Distributor.sol` on most EVM chains.
+ * https://docs.merkl.xyz/integrate-merkl/smart-contract-addresses
+ */
+declare const MERKL_DISTRIBUTOR_ADDRESS: Address;
+declare const MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK = 500000n;
+declare const MERKL_REWARDS_NOTES = "Wallet-wide Merkl on this chain (not protocol-filtered). Other venues\u2019 campaigns can appear. Claims the first Merkle root batch; call again if additionalRoots > 0. rEUL is omitted (Euler unlock flow). Merkl updates every 8\u201312 hours.";
+type MerklDistributorClaimLeaf = {
+    root: string;
+    token: Address;
+    amountWei: bigint;
+    proofs: readonly `0x${string}`[];
+    symbol: string;
+    decimals: number;
+};
+type MerklRewardRow = {
+    symbol: string;
+    token: string;
+    amountHuman: string;
+    amountWei: string;
+    decimals: number;
+    root: string;
+};
+type MerklRewardsSummary = {
+    chainId: number;
+    user: string;
+    distributor: string;
+    claimable: MerklRewardRow[];
+    claimableCount: number;
+    firstRootClaimableCount: number;
+    additionalRoots: number;
+    skippedReulCount: number;
+    notes: string;
+};
+declare function merklUserRewardsUrl(addr: Address, chainId: number): string;
+declare function loadMerklUserRewardsJson(args: {
+    chainId: number;
+    user: Address;
+}): Promise<unknown>;
+declare function parseMerklUserRewardsToLeaves(raw: unknown, args: {
+    chainId: number;
+    user: Address;
+}): MerklDistributorClaimLeaf[];
+declare function selectFirstRootMerklLeaves(collected: readonly MerklDistributorClaimLeaf[]): MerklDistributorClaimLeaf[];
+declare function isMerklRewardEulLeaf(leaf: MerklDistributorClaimLeaf): boolean;
+/** Non-rEUL leaves on the first remaining Merkle root (one Distributor.claim tx). */
+declare function selectWalletWideMerklClaimLeaves(collected: readonly MerklDistributorClaimLeaf[]): MerklDistributorClaimLeaf[];
+declare function fetchAllMerklDistributorClaimLeaves(args: {
+    chainId: number;
+    user: Address;
+}): Promise<MerklDistributorClaimLeaf[]>;
+declare function encodeMerklDistributorClaimData(args: {
+    user: Address;
+    leaves: readonly MerklDistributorClaimLeaf[];
+}): `0x${string}`;
+declare function merklLeafToRow(leaf: MerklDistributorClaimLeaf): MerklRewardRow;
+declare function fetchMerklRewardsSummary(args: {
+    user: string;
+    chainId: number;
+}): Promise<MerklRewardsSummary>;
+
+export { MERKL_API_BASE as M, MERKL_DISTRIBUTOR_ADDRESS as a, MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK as b, MERKL_REWARDS_NOTES as c, type MerklDistributorClaimLeaf as d, type MerklRewardRow as e, type MerklRewardsSummary as f, encodeMerklDistributorClaimData as g, fetchAllMerklDistributorClaimLeaves as h, fetchMerklRewardsSummary as i, isMerklRewardEulLeaf as j, merklUserRewardsUrl as k, loadMerklUserRewardsJson as l, merklLeafToRow as m, selectWalletWideMerklClaimLeaves as n, parseMerklUserRewardsToLeaves as p, selectFirstRootMerklLeaves as s };