@continuumdao/ctm-mpc-defi 0.2.4 → 0.2.6

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

@@ -0,0 +1,45 @@
+# GMX V2 (classic mode)
+
+Perpetuals on Arbitrum (42161) and Avalanche (43114) via `@gmx-io/sdk` v2 **classic** orders only.
+
+## Constraints
+
+- **No express mode** — MPC multi-sign requires on-chain calldata (`prepareOrder({ mode: "classic" })`).
+- **No subaccounts (1CT)** — incompatible with threshold MPC; executor is always `keyGen.ethereumaddress`.
+- **No spot swaps** in v1 — perps only (increase, decrease, limit, cancel).
+- Orders are **keeper-executed asynchronously** after broadcast; poll `fetchOrders` for status.
+
+## Typical agent flow
+
+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)
+5. `ctm_gmx_fetch_positions({ chainId, executorAddress })` — for close flows
+6. `ctm_gmx_build_increase_multisign` or `ctm_gmx_build_decrease_multisign` with `keyGenId`, `chainId`, `purposeText`
+7. Base MPC: agree → trigger sign → broadcast
+
+## Limit orders
+
+Set `orderType: "limit"` and `triggerPriceUsdHuman` on increase/decrease builders.
+
+## Cancel
+
+Use `orderId` from `fetchOrders` with `ctm_gmx_build_cancel_multisign`.
+
+## GM liquidity (phase 2)
+
+GM pool deposit/withdraw uses **ExchangeRouter multicall** (not `prepareOrder`):
+
+1. `ctm_gmx_fetch_gm_markets({ chainId })` — GM markets + long/short collateral symbols + estimated APY
+2. `ctm_gmx_fetch_gm_apy({ chainId })` — same APY data sorted by yield (highest first)
+3. `ctm_gmx_build_gm_deposit_multisign` — approve + `multicall(sendWnt + sendTokens + createDeposit)`
+4. `ctm_gmx_build_gm_withdraw_multisign` — approve GM token + `multicall(sendWnt + sendTokens + createWithdrawal)`
+
+Keeper execution is asynchronous (same as perp orders). Execution fee is paid in native gas token via `sendWnt`.
+
+## GMX token staking (phase 2)
+
+1. `ctm_gmx_fetch_staking_power({ chainId, executorAddress })`
+2. `ctm_gmx_build_stake_gmx_multisign` — approve GMX + `RewardRouter.stakeGmx`
+3. `ctm_gmx_build_unstake_gmx_multisign` — `RewardRouter.unstakeGmx`

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

@@ -164,6 +164,7 @@ MCP uses **classic ERC-20 approve** batches (Permit2 disabled), matching swaps.
 
 | Action | Prep tool | Build multisign |
 |--------|-----------|-----------------|
+| List standard pools | `ctm_uniswap_v4_list_lp_pools` | — |
 | Mint new position | `ctm_uniswap_v4_lp_create_position` | `ctm_uniswap_v4_build_mint_liquidity_multisign` |
 | Increase | `ctm_uniswap_v4_lp_increase` | `ctm_uniswap_v4_build_increase_liquidity_multisign` |
 | Decrease | `ctm_uniswap_v4_lp_decrease` | `ctm_uniswap_v4_build_decrease_liquidity_multisign` |
@@ -172,9 +173,16 @@ MCP uses **classic ERC-20 approve** batches (Permit2 disabled), matching swaps.
 | Register position NFT | `ctm_uniswap_v4_register_position_nft` | — (management-signed) |
 | Register from mint tx | `ctm_uniswap_v4_register_position_from_mint_tx` | — (after mint execute) |
 
+### Standard pools (no manual pool id hunt)
+
+1. `ctm_uniswap_v4_list_lp_pools` with `chainId` (optional `pair` filter, e.g. `eth-usdc`).
+2. Pick a row — use `presetId` as `poolPreset` on `ctm_uniswap_v4_lp_create_position`, or copy `existingPool` fields (`token0Address`, `token1Address`, `poolReference`).
+3. `poolReference` is the V4 **bytes32 pool id**, derived from token addresses + `fee` + `tickSpacing` + `hooks` (no-hook pools use `0x0`).
+4. If LP create fails, the pool may not be initialized on-chain — try another preset, pass a custom `poolReference`, or use `newPool`.
+
 ### Mint workflow
 
-1. Resolve pool (`existingPool` with `poolReference` = V4 pool id, or `newPool` to initialize).
+1. Resolve pool: `poolPreset` from list tool, `existingPool` (`poolReference` or `fee`+`tickSpacing` to derive id), or `newPool` to initialize.
 2. Set price range via `priceBounds` (human prices) or `tickBounds`.
 3. `independentToken`: one token + amount in base units; API computes the other.
 4. `ctm_uniswap_v4_lp_create_position` → full JSON with `create` tx + `token0`/`token1` amounts.

package/dist/index.cjs

@@ -1336,6 +1336,7 @@ async function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args) {
     }
   });
 }
+var UNISWAP_V4_LP_POOL_LOOKUP_HINT = "Pool may not be initialized on this chain. Call ctm_uniswap_v4_list_lp_pools for other presets, pass a custom existingPool.poolReference, or use newPool to initialize a pool.";
 
 // src/protocols/evm/uniswap-v4/liquidityApi.ts
 var LP_HEADERS_BASE = {
@@ -1400,9 +1401,9 @@ async function postUniswapLpApi(args) {
   });
   const text = await res.text();
   if (!res.ok) {
-    throw new Error(
-      `Uniswap LP POST /${args.path} failed: ${messageFromUniswapHttpResponseBody(text, res.status, res.statusText)}`
-    );
+    const base2 = messageFromUniswapHttpResponseBody(text, res.status, res.statusText);
+    const hint = args.path === "create" && args.body.existingPool ? ` ${UNISWAP_V4_LP_POOL_LOOKUP_HINT}` : "";
+    throw new Error(`Uniswap LP POST /${args.path} failed: ${base2}${hint}`);
   }
   return JSON.parse(text);
 }