@continuumdao/ctm-mpc-defi 0.2.16 → 0.2.18

package/dist/agent/skills/_shared/multisign-mcp-gas.md

@@ -14,7 +14,10 @@ Before creating, call `get_multi_sign_gas_options({ chainId })` when gas prefere
 
 ### After submit (`{ requestId }`)
 
-1. `wait_for_sign_request_ready` (if needed)
-2. `sign_request_agree` (multi-agree)
-3. `trigger_sign_result`
-4. `broadcast_sign_result`
+Stop here unless the user asks to continue. **Do not** call `wait_for_sign_request_ready` — Join agreement (`sign_request_agree` on peers) may take **days**.
+
+When proceeding (user request or workflow, after quorum):
+
+1. `sign_request_agree` (multi-party Join)
+2. `trigger_sign_result` (originator Get Sig)
+3. `broadcast_sign_result`

package/dist/agent/skills/circle-cctp/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: circle-cctp
+description: Circle CCTP V2 cross-chain native USDC via Forwarding Service and Continuum MPC multisign.
+---
+
+# Circle CCTP (MCP)
+
+Cross-chain **native USDC** via Circle **CCTP V2** and the **Forwarding Service**. The MPC wallet signs **one source-chain batch** (`USDC.approve` + `TokenMessengerV2.depositForBurnWithHook` with `cctp-forward` hook data). Circle attests and submits the **destination mint** — no second sign request, no destination native gas from the KeyGen address.
+
+## Before any transfer
+
+1. `load_defi_protocol({ protocolId: "circle-cctp" })`
+2. `get_defi_protocol_skill`
+3. `get_chain_registry` — source chain needs `rpcGateway`
+4. `get_token_registry` — locate USDC on source chain
+
+## Tool flow
+
+| Step | Tool | Creates sign request? |
+|------|------|------------------------|
+| 1. Routes | `ctm_cctp_fetch_supported_routes` | No |
+| 2. Fees | `ctm_cctp_fetch_burn_fees` | No — **required before build** |
+| 3. Balance | `ctm_cctp_fetch_usdc_balance` | No — pre-check USDC ≥ transfer + maxFee |
+| 4. Submit | `ctm_cctp_build_burn_multisign` | Yes → `{ requestId, fees }` |
+| 5. (optional) Status | `ctm_cctp_fetch_transfer_status` | No — after source burn Execute |
+
+After `{ requestId }`: `sign_request_agree` → `trigger_sign_result` → `broadcast_sign_result`. **Do not** retry build on success. Fees refresh again at **trigger** on the node app.
+
+## `ctm_cctp_fetch_burn_fees`
+
+| Field | Required | Notes |
+|-------|----------|-------|
+| `sourceChainId` | yes | EIP-155 id where burn executes |
+| `destChainId` | yes | EIP-155 destination (mint chain) |
+| `transferAmountHuman` | no | USDC recipient receives (6 decimals); include for `totalBurn` / `totalBurnHuman` |
+| `feeTier` | no | `low` \| `med` (default) \| `high` |
+
+Returns `fees` object plus top-level fee fields: `maxFeeHuman`, `forwardFeeLowHuman` / `Med` / `High`, optional `totalBurnHuman`, and `feeSummary`. Pass the full output as `feeSnapshot` to build and balance tools.
+
+## `ctm_cctp_fetch_usdc_balance`
+
+Optional `transferAmountHuman` + `feeSnapshot` (from fetch_burn_fees) returns `requiredTotalBurnHuman`, `sufficientForTransfer`, and `feeSummary`.
+
+## `ctm_cctp_build_burn_multisign`
+
+| Field | Required | Notes |
+|-------|----------|-------|
+| `keyGenId` | yes | MPC KeyGen |
+| `chainId` | yes | **Source** chain (same as fee quote) |
+| `destChainId` | yes | Destination chain |
+| `purposeText` | yes | Human-readable purpose |
+| `transferAmountHuman` | yes | Same as fee quote |
+| `mintRecipient` | no | Destination address; default executor |
+| `feeSnapshot` | no | Pass `ctm_cctp_fetch_burn_fees` output |
+| `useCustomGas` | no | Chain registry custom gas |
+
+Returns `{ requestId, fees }` — `fees` echoes the proposed Forwarding Service max fee and total burn.
+
+## Important
+
+- **chainId** on build = **source** chain, not destination.
+- Manual `receiveMessage` on destination is **out of scope** — Forwarding Service only.
+- Solana/non-EVM recipients: follow Circle docs for `mintRecipient` encoding; UI v1 is EVM-only.

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

@@ -14,7 +14,7 @@ Perpetuals on Arbitrum (42161) and Avalanche (43114) via `@gmx-io/sdk` v2 **clas
 1. `load_defi_protocol({ protocolId: "gmx" })`
 2. `ctm_gmx_fetch_markets({ chainId })` — pick `symbol` e.g. `ETH/USD [WETH-USDC]`; each row includes `maxLeverageLabel`
 3. `ctm_gmx_fetch_market_prices({ chainId, symbol, collateralSymbol })` — index/collateral USD mark
-4. `ctm_gmx_fetch_ohlcv({ chainId, symbol, timeframe: "15m" })` — tabular OHLCV candles (USD index)
+4. `ctm_gmx_fetch_ohlcv({ chainId, symbol, timeframe: "15m" })` — tabular OHLCV candles (USD index); then **`continuum__prepare_chart_from_rows`** if the operator wants a chart
 5. `ctm_gmx_fetch_positions({ chainId, executorAddress })` — for close flows
 6. `get_multi_sign_gas_options({ chainId })` — confirm `useCustomGas` with the user
 7. `ctm_gmx_build_increase_multisign` or `ctm_gmx_build_decrease_multisign` with `keyGenId`, `chainId`, `purposeText`, `useCustomGas` → **`{ requestId }`**
@@ -63,6 +63,30 @@ Keeper execution is asynchronous (same as perp orders). Execution fee is paid in
 2. `ctm_gmx_build_stake_gmx_multisign` — approve GMX + `RewardRouter.stakeGmx`
 3. `ctm_gmx_build_unstake_gmx_multisign` — `RewardRouter.unstakeGmx`
 
+## Charting OHLCV (required second step)
+
+**Fetching candles does not render a chart.** When the operator asks to chart/graph/plot GMX perp OHLCV:
+
+1. **`ctm_gmx_fetch_ohlcv`** — returns `{ symbol, timeframe, candles }` (USD index; **no volume** on rows → volume pane omitted).
+2. **Same agent turn** — **`continuum__prepare_chart_from_rows`** with the **full fetch JSON** as **`toolResult`** and a **`title`** (symbol + timeframe + window).
+
+```json
+{
+  "title": "ETH/USD 1H — last 7d",
+  "toolResult": {
+    "symbol": "ETH/USD [WETH-USDC]",
+    "timeframe": "1h",
+    "candles": [
+      { "timestampMs": 1700000000000, "open": "3200", "high": "3250", "low": "3180", "close": "3225", "timeLabel": "..." }
+    ]
+  }
+}
+```
+
+Increase **`limit`** (max 500) or use a coarser **`timeframe`** for longer history. Default limit is small (~16 bars) — raise **`limit`** when charting a multi-day window.
+
+**Never** reply with markdown-only chart descriptions. The UI renders **`continuum/chart/v1`** only from the **`prepare_chart_from_rows`** MCP result. See node skills **`chart-defaults`** / **`chart-periods`**.
+
 ## Troubleshooting
 
 | Symptom | Likely cause |
@@ -70,3 +94,4 @@ Keeper execution is asynchronous (same as perp orders). Execution fee is paid in
 | Agent says custom gas "will fail" without baseFee | Wrong — empty registry fees are valid; use `get_multi_sign_gas_options` |
 | Multiple duplicate sign requests | Retried `ctm_gmx_build_*` after `{ requestId }` — do not retry on success |
 | Order pending after broadcast | Normal — GMX keeper executes asynchronously |
+| User asked to chart but only got prose / no widget | Call **`continuum__prepare_chart_from_rows`** with full **`ctm_gmx_fetch_ohlcv`** JSON as **`toolResult`** in the same turn |

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

@@ -58,7 +58,7 @@ Positions and orders from MCP reflect **live HyperCore state** after prior txs a
 | List all perp markets + HIP-3 dexes | `ctm_hyperliquid_fetch_markets` |
 | **Find market by ticker or name** (AAPL, Apple, BTC) | `ctm_hyperliquid_search_markets` |
 | **Live price** (mark/mid) + short recent bars | `ctm_hyperliquid_fetch_market_snapshot` — use **`snapshot.livePrice.midUsd`** |
-| **OHLCV history** (e.g. 15m for last 7 days) | `ctm_hyperliquid_fetch_ohlcv` — `lookbackDays: 7`, `interval: "15m"` |
+| **OHLCV history** (e.g. 15m for last 7 days) | `ctm_hyperliquid_fetch_ohlcv` — then **`continuum__prepare_chart_from_rows`** if user wants a chart |
 | Account + capacity for one coin | `ctm_hyperliquid_fetch_open_context` |
 | Open positions | `ctm_hyperliquid_fetch_positions` |
 | Open orders | `ctm_hyperliquid_fetch_open_orders` |
@@ -182,6 +182,66 @@ Use **`ctm_hyperliquid_fetch_ohlcv`** — not `fetch_market_snapshot` (snapshot
 - Check **`ohlcv.candleCount`** vs **`ohlcv.expectedBars`** to confirm the full range was returned.
 - Default lookback if none specified: **1 day**.
 
+Fetch returns:
+
+```json
+{
+  "ohlcv": {
+    "coin": "ETH",
+    "interval": "1h",
+    "candleCount": 73,
+    "candles": [
+      { "timestampMs": 1700000000000, "open": "1700", "high": "1710", "low": "1690", "close": "1705", "volume": "12345" }
+    ]
+  },
+  "resolvedCoin": "ETH"
+}
+```
+
+## Charting OHLCV (required second step)
+
+**Fetching candles does not render a chart.** The node app only draws candlesticks when **`continuum__prepare_chart_from_rows`** (or **`continuum__prepare_chart`**) returns `kind: continuum/chart/v1`. The widget appears under the **MCP result** row for that chart tool — **not** in the assistant text bubble.
+
+When the operator asks to **chart**, **graph**, or **plot** Hyperliquid OHLCV:
+
+1. **`ctm_hyperliquid_fetch_ohlcv`** — get history (same agent turn).
+2. **`continuum__prepare_chart_from_rows`** — **immediately after**, in the **same turn**. Pass the **full fetch JSON** as **`toolResult`** (entire object from step 1, not just `candles` alone). **`title` is required** — describe asset, interval, and window (e.g. `ETH-PERP 1H — last 3d`), not the user chat verbatim.
+
+```json
+{
+  "title": "ETH-PERP 1H — last 3d",
+  "toolResult": {
+    "ohlcv": {
+      "coin": "ETH",
+      "interval": "1h",
+      "candles": [ "... entire fetch output ..." ]
+    },
+    "resolvedCoin": "ETH"
+  }
+}
+```
+
+Or pass the **complete** step-1 tool result unchanged:
+
+```json
+{
+  "title": "ETH-PERP 1H — last 3d",
+  "toolResult": { "... paste full ctm_hyperliquid_fetch_ohlcv JSON ..." }
+}
+```
+
+**Never:**
+
+- Reply with markdown tables or prose (“chart prepared”, “EMA(50) overlay”, period high/low) **instead of** calling `prepare_chart_from_rows`.
+- Pass `{}` or truncated JSON to the chart tool.
+- Skip the chart tool because fetch already returned candles.
+
+**On success:** the MCP result shows `[Chart prepared: … · continuum/chart/v1]` and the interactive chart widget. If that line is missing, **no chart was rendered** — do not tell the user it was.
+
+Default overlays (EMA 50, RSI 14, volume pane) are applied inside `prepare_chart_from_rows` when rows include **`volume`**. See node skills **`chart-defaults`** and **`chart-periods`** (initial load). Optional: read MCP resource **`chart_docs`**.
+
+Trim to **≤ ~400 bars** for agent chat (`options.maxPoints: 400`) when the fetch returns more than needed — keep the **newest** bars.
+
 ## HIP-3 dexes
 
 HIP-3 builder perps (e.g. **XYZ** dex) are **not** in the default native meta alone. `fetch_markets` without `dex` returns **native + every listed HIP-3 dex** in one response.
@@ -196,6 +256,7 @@ HIP-3 builder perps (e.g. **XYZ** dex) are **not** in the default native meta al
 | Symptom | Likely cause |
 |---------|----------------|
 | Agent quotes stale price (e.g. old hourly close) | Use **`snapshot.livePrice.midUsd`**, not a random candle from truncated history; republish defi with live-price fix |
+| User asked to chart but only got prose / no widget | **`fetch_ohlcv` alone does not render** — call **`continuum__prepare_chart_from_rows`** with full fetch **`toolResult`** in the same turn; chart appears under MCP result, not assistant text |
 | `fetch_market_snapshot` throws on HIP-3 | Missing dex — pass `coin: "xyz:AAPL"` or `dex: "xyz"` |
 | `availableToBuy` / `availableToSell` is 0 | No perp margin, leverage too high, or USDC still in spot — transfer to perp |
 | Order succeeds on-chain but no position | Limit not filled yet; IoC may partially/fully reject |