@continuumdao/ctm-mpc-defi 0.2.4 → 0.2.5

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);
 }