@continuumdao/ctm-mpc-defi 0.2.2 → 0.2.4

package/dist/agent/catalog.js

@@ -130,6 +130,52 @@ var uniswapV4ProtocolModule = {
         amount: { type: "string", required: true, description: "Amount for quote" },
         type: { type: "EXACT_INPUT | EXACT_OUTPUT", required: true, description: "Trade type" }
       }
+    },
+    {
+      id: "uniswap-v4.mint-liquidity",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Mint a new Uniswap V4 concentrated liquidity position (Position Manager NFT)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        lpResponse: { type: "object", required: true, description: "Full LP API create response" },
+        nativeWrapped: { type: "address", required: false, description: "WETH when pool uses native ETH" },
+        poolReference: { type: "string", required: false, description: "V4 pool id" },
+        uniswapApiKey: { type: "string", required: true, description: "Uniswap API key" }
+      }
+    },
+    {
+      id: "uniswap-v4.increase-liquidity",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Increase liquidity on an existing Uniswap V4 position NFT",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        nftTokenId: { type: "string", required: true, description: "Position NFT token id" },
+        lpResponse: { type: "object", required: true, description: "Full LP API increase response" }
+      }
+    },
+    {
+      id: "uniswap-v4.decrease-liquidity",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Decrease liquidity on an existing Uniswap V4 position NFT",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        nftTokenId: { type: "string", required: true, description: "Position NFT token id" },
+        lpResponse: { type: "object", required: true, description: "Full LP API decrease response" }
+      }
+    },
+    {
+      id: "uniswap-v4.collect-fees",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Collect accrued fees from a Uniswap V4 position NFT",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        nftTokenId: { type: "string", required: true, description: "Position NFT token id" },
+        lpResponse: { type: "object", required: true, description: "Full LP API claim response" }
+      }
     }
   ]
 };
@@ -212,44 +258,64 @@ function swappableCurveGraphNodeKeys(adj) {
 }
 
 // src/protocols/evm/curve-dao/apiSession.ts
+var CURVE_SESSION_CACHE_TTL_MS = 5 * 60 * 1e3;
+var curveSessionCache = /* @__PURE__ */ new Map();
 async function fetchAllCurvePools(curve) {
   const run = (p) => p.catch(() => void 0);
-  await Promise.all([
-    run(curve.factory.fetchPools()),
-    run(curve.crvUSDFactory.fetchPools()),
-    run(curve.EYWAFactory.fetchPools()),
-    run(curve.cryptoFactory.fetchPools()),
-    run(curve.twocryptoFactory.fetchPools()),
-    run(curve.tricryptoFactory.fetchPools()),
-    run(curve.stableNgFactory.fetchPools())
-  ]);
+  const tasks = [];
+  for (const key of [
+    "factory",
+    "crvUSDFactory",
+    "EYWAFactory",
+    "cryptoFactory",
+    "twocryptoFactory",
+    "tricryptoFactory",
+    "stableNgFactory"
+  ]) {
+    const f = curve[key];
+    if (f?.fetchPools) {
+      tasks.push(run(f.fetchPools()));
+    }
+  }
+  await Promise.all(tasks);
 }
 async function loadFullCurveSessionForRpc(rpcUrl) {
   const url = (rpcUrl ?? "").trim();
-  if (!url) return null;
+  if (!url) {
+    throw new Error("rpcUrl is required.");
+  }
+  const cached = curveSessionCache.get(url);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached.session;
+  }
   try {
     const { default: curve } = await import('@curvefi/api');
     await curve.init("JsonRpc", { url }, {});
     const wrapped = curve.getNetworkConstants().NATIVE_COIN?.wrappedAddress;
     if (!curve.hasRouter || !curve.hasRouter()) {
-      return {
+      const session2 = {
         curve,
         adj: /* @__PURE__ */ new Map(),
         swappableNodeKeys: /* @__PURE__ */ new Set(),
         wrappedNative: wrapped
       };
+      curveSessionCache.set(url, { session: session2, expiresAt: Date.now() + CURVE_SESSION_CACHE_TTL_MS });
+      return session2;
     }
     await fetchAllCurvePools(curve);
     const adj = buildCurveLiquidityGraphFromApi(curve);
     addNativeWethBridge(adj, wrapped);
-    return {
+    const session = {
       curve,
       adj,
       swappableNodeKeys: swappableCurveGraphNodeKeys(adj),
       wrappedNative: wrapped
     };
-  } catch {
-    return null;
+    curveSessionCache.set(url, { session, expiresAt: Date.now() + CURVE_SESSION_CACHE_TTL_MS });
+    return session;
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(`Curve session init failed for RPC: ${msg}`);
   }
 }
 
@@ -500,6 +566,133 @@ var mcpUniswapV4BuildSwapMultisignInputSchema = evmMultisignCommonInputSchema.ex
   swapDeadlineUnix: z.number().describe("Same deadline passed to create_swap"),
   slippagePercent: z.number().optional().describe("Extra approve headroom for EXACT_OUTPUT")
 });
+var lpExistingPoolSchema = z.object({
+  token0Address: evmAddressSchema,
+  token1Address: evmAddressSchema,
+  poolReference: z.string().min(1).describe("V4 pool id (bytes32 hex)")
+});
+var lpNewPoolSchema = z.object({
+  token0Address: evmAddressSchema,
+  token1Address: evmAddressSchema,
+  fee: z.number().int().nonnegative(),
+  tickSpacing: z.number().int().positive(),
+  hooks: evmAddressSchema.optional(),
+  initialPrice: z.string().min(1).describe("sqrtRatioX96 string for new pool")
+});
+var lpIndependentTokenSchema = z.object({
+  tokenAddress: evmAddressSchema.describe("0x0 for native ETH"),
+  amount: z.string().min(1).describe("Amount in token base units (wei)")
+});
+var lpPriceBoundsSchema = z.object({
+  minPrice: z.string().min(1),
+  maxPrice: z.string().min(1)
+});
+var lpTickBoundsSchema = z.object({
+  tickLower: z.number().int(),
+  tickUpper: z.number().int()
+});
+var lpCommonApiInputSchema = z.object({
+  uniswapApiKey: z.string().min(1),
+  walletAddress: evmAddressSchema.optional(),
+  chainId: z.union([z.number().int().positive(), z.string().min(1)]),
+  slippageTolerance: z.number().optional(),
+  simulateTransaction: z.boolean().optional(),
+  baseUrl: z.string().optional(),
+  keyGen: z.string().optional(),
+  managementNodeUrl: z.string().optional()
+});
+var mcpUniswapV4LpCreatePositionInputSchema = lpCommonApiInputSchema.extend({
+  existingPool: lpExistingPoolSchema.optional(),
+  newPool: lpNewPoolSchema.optional(),
+  independentToken: lpIndependentTokenSchema,
+  priceBounds: lpPriceBoundsSchema.optional(),
+  tickBounds: lpTickBoundsSchema.optional()
+});
+var mcpUniswapV4LpCreatePositionOutputSchema = jsonObjectSchema;
+var mcpUniswapV4LpIncreaseInputSchema = lpCommonApiInputSchema.extend({
+  token0Address: evmAddressSchema,
+  token1Address: evmAddressSchema,
+  nftTokenId: z.union([z.string(), z.number()]),
+  independentToken: lpIndependentTokenSchema
+});
+var mcpUniswapV4LpIncreaseOutputSchema = jsonObjectSchema;
+var mcpUniswapV4LpDecreaseInputSchema = lpCommonApiInputSchema.extend({
+  token0Address: evmAddressSchema,
+  token1Address: evmAddressSchema,
+  nftTokenId: z.union([z.string(), z.number()]),
+  liquidityPercentageToDecrease: z.number().int().min(1).max(100)
+});
+var mcpUniswapV4LpDecreaseOutputSchema = jsonObjectSchema;
+var mcpUniswapV4LpClaimInputSchema = lpCommonApiInputSchema.extend({
+  tokenId: z.union([z.string(), z.number()])
+});
+var mcpUniswapV4LpClaimOutputSchema = jsonObjectSchema;
+var mcpUniswapV4LpListPositionsInputSchema = z.object({
+  chainId: z.union([z.number().int().positive(), z.string().min(1)]),
+  keyGenId: z.string().min(1).optional(),
+  walletAddress: evmAddressSchema.optional(),
+  positionManagerAddress: evmAddressSchema.optional()
+});
+var mcpUniswapV4LpListPositionsOutputSchema = z.object({
+  source: z.literal("token_registry"),
+  positions: z.array(
+    z.object({
+      tokenId: z.string(),
+      positionManager: evmAddressSchema,
+      owner: evmAddressSchema,
+      name: z.string().optional(),
+      symbol: z.string().optional()
+    })
+  )
+});
+var mcpUniswapV4RegisterPositionNftInputSchema = z.object({
+  chainId: z.union([z.number().int().positive(), z.string().min(1)]),
+  tokenId: z.union([z.string(), z.number()]),
+  keyGenId: z.string().min(1).optional(),
+  positionManagerAddress: evmAddressSchema.optional(),
+  name: z.string().optional(),
+  symbol: z.string().optional(),
+  tokenURI: z.string().optional()
+});
+var mcpUniswapV4RegisterPositionNftOutputSchema = z.object({
+  message: z.string(),
+  tokenId: z.string(),
+  positionManager: evmAddressSchema
+});
+var mcpUniswapV4RegisterPositionFromMintTxInputSchema = z.object({
+  chainId: z.union([z.number().int().positive(), z.string().min(1)]),
+  txHash: z.string().min(1),
+  keyGenId: z.string().min(1).optional(),
+  walletAddress: evmAddressSchema.optional(),
+  rpcUrl: z.string().optional(),
+  positionManagerAddress: evmAddressSchema.optional()
+});
+var mcpUniswapV4RegisterPositionFromMintTxOutputSchema = z.object({
+  message: z.string(),
+  tokenId: z.string(),
+  positionManager: evmAddressSchema,
+  registered: z.boolean()
+});
+var lpBuildCommonSchema = {
+  lpResponse: jsonObjectSchema.describe("Full LP API response (create/increase/decrease/claim)"),
+  nativeWrapped: evmAddressSchema.optional(),
+  poolReference: z.string().optional()
+};
+var mcpUniswapV4BuildMintLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend(
+  lpBuildCommonSchema
+);
+var mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend({
+  ...lpBuildCommonSchema,
+  nftTokenId: z.union([z.string(), z.number()])
+});
+var mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema = evmMultisignCommonInputSchema.extend({
+  ...lpBuildCommonSchema,
+  nftTokenId: z.union([z.string(), z.number()])
+});
+var mcpUniswapV4BuildCollectFeesMultisignInputSchema = evmMultisignCommonInputSchema.extend({
+  ...lpBuildCommonSchema,
+  nftTokenId: z.union([z.string(), z.number()])
+});
 var mcpCurveDaoQuoteInputSchema = z.object({
   chainId: z.number().int().positive().describe("EVM chain id (rpcUrl resolved from get_chain_registry rpcGateway)"),
   rpcUrl: z.string().min(1).optional().describe("JSON-RPC URL; continuum-mcp-server injects from chain registry \u2014 do not pass a public RPC URL"),
@@ -588,29 +781,44 @@ var mcpSkySusdsDepositInputSchema = mcpMultisignInput({
 var mcpSkySusdsRedeemInputSchema = mcpMultisignInput({
   sharesHuman: z.string().min(1)
 });
+var mcpAaveV4MarketIdSchema = z.string().min(1).optional().describe("UI market segment: main (Plus), core, or bluechip (Prime). Default main.");
+var mcpAaveV4HealthPreviewSchema = {
+  skipHealthPreview: z.boolean().optional().describe("Skip Aave v4 health-factor preview before withdraw/borrow/repay (not recommended)."),
+  acknowledgeHealthRisk: z.boolean().optional().describe(
+    "Required true when preview returns a confirm-level health risk (withdraw/borrow/repay)."
+  )
+};
 var mcpAaveV4DepositInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
+  spoke: evmAddressSchema.optional().describe("Omit \u2014 continuum-mcp-server resolves spoke from Aave v4 API."),
+  underlying: evmAddressSchema.describe(
+    "Asset to supply. Native ETH: 0x0 or wrapped native with isNativeIn true."
+  ),
   amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
+  marketId: mcpAaveV4MarketIdSchema,
+  isNativeIn: z.boolean().optional().describe("Wrap native to wrapped native before supply (e.g. ETH \u2192 WETH)."),
+  enableAsCollateralAfterSupply: z.boolean().optional().describe("Append setUsingAsCollateral after supply in the same batch.")
 });
 var mcpAaveV4WithdrawInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
+  spoke: evmAddressSchema.optional().describe("Omit \u2014 server resolves from Aave v4 API."),
+  underlying: evmAddressSchema.describe("Supplied asset to withdraw."),
   amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
+  marketId: mcpAaveV4MarketIdSchema,
+  ...mcpAaveV4HealthPreviewSchema
 });
 var mcpAaveV4BorrowInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
+  spoke: evmAddressSchema.optional().describe("Omit \u2014 server resolves from Aave v4 API."),
+  underlying: evmAddressSchema.describe("Debt asset to borrow (e.g. USDC), not collateral."),
   amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
+  marketId: mcpAaveV4MarketIdSchema,
+  collateralUnderlying: evmAddressSchema.optional().describe("Collateral token already supplied; helps pick hub when debt exists on multiple hubs."),
+  ...mcpAaveV4HealthPreviewSchema
 });
 var mcpAaveV4RepayInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
+  spoke: evmAddressSchema.optional().describe("Omit \u2014 server resolves from Aave v4 API."),
+  underlying: evmAddressSchema.describe("Debt token to repay."),
   amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
+  marketId: mcpAaveV4MarketIdSchema,
+  ...mcpAaveV4HealthPreviewSchema
 });
 var mcpEulerV2IsolatedLendInputSchema = mcpMultisignInput({
   vault: evmAddressSchema,
@@ -857,8 +1065,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "aave-v4.deposit",
     protocolId: "aave-v4",
     chainCategory: "evm",
-    description: "Build Aave v4 Spoke supply/deposit batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
+    description: "Build Aave v4 Spoke supply/deposit batch (wrap native, approve, supply).",
+    prerequisites: ["keyGenId", "chainId", "underlying", "amountHuman", "get_defi_protocol_skill for hubs/spokes"],
     followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4DepositBatch" },
     inputZod: mcpAaveV4DepositInputSchema
@@ -868,8 +1076,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "aave-v4.withdraw",
     protocolId: "aave-v4",
     chainCategory: "evm",
-    description: "Build Aave v4 Spoke withdraw batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
+    description: "Build Aave v4 Spoke withdraw; health-factor preview when user has borrow debt.",
+    prerequisites: ["keyGenId", "chainId", "underlying (supplied asset)", "amountHuman"],
     followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeWithdraw" },
     inputZod: mcpAaveV4WithdrawInputSchema
@@ -879,8 +1087,14 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "aave-v4.borrow",
     protocolId: "aave-v4",
     chainCategory: "evm",
-    description: "Build Aave v4 Spoke borrow batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
+    description: "Build Aave v4 Spoke borrow; underlying is debt asset; collateral must be supplied first.",
+    prerequisites: [
+      "keyGenId",
+      "chainId",
+      "underlying (debt token)",
+      "amountHuman",
+      "collateral supplied via deposit"
+    ],
     followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeBorrow" },
     inputZod: mcpAaveV4BorrowInputSchema
@@ -890,8 +1104,8 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "aave-v4.repay",
     protocolId: "aave-v4",
     chainCategory: "evm",
-    description: "Build Aave v4 Spoke repay batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
+    description: "Build Aave v4 Spoke repay (approve if needed + repay).",
+    prerequisites: ["keyGenId", "chainId", "underlying (debt token)", "amountHuman"],
     followUp: ["Sign messageToSign", "POST /multiSignRequest"],
     handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeRepay" },
     inputZod: mcpAaveV4RepayInputSchema
@@ -981,7 +1195,11 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     protocolId: "uniswap-v4",
     chainCategory: "evm",
     description: "Fetch a Uniswap V4 Trade API quote (POST /v1/quote). Returns classic quote JSON including quote.input/output amounts and routing. Does NOT create a sign request \u2014 use ctm_uniswap_v4_create_swap and ctm_uniswap_v4_build_swap_multisign after quoting. Requires uniswapApiKey and swapper (MPC executor address) or keyGen + managementNodeUrl to resolve swapper.",
-    prerequisites: ["Chain must be supported by Uniswap V4 (Universal Router map)."],
+    prerequisites: [
+      "UNISWAP_API_KEY in node Variables",
+      "get_defi_protocol_skill for full quote \u2192 create_swap \u2192 build flow",
+      "keyGenId (resolves swapper)"
+    ],
     followUp: ["ctm_uniswap_v4_create_swap", "ctm_uniswap_v4_build_swap_multisign"],
     handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapTradeQuote" },
     inputZod: mcpUniswapV4QuoteInputSchema,
@@ -993,7 +1211,10 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     protocolId: "uniswap-v4",
     chainCategory: "evm",
     description: "Call Uniswap Trade API POST /v1/swap to build Universal Router calldata from a prior quote. Returns { swap: { to, data, value, gasLimit? }, requestId? }. Does NOT produce a multiSignRequest \u2014 call ctm_uniswap_v4_build_swap_multisign next.",
-    prerequisites: ["ctm_uniswap_v4_quote output (fullQuoteFromPermit)"],
+    prerequisites: [
+      "ctm_uniswap_v4_quote output (fullQuoteFromPermit)",
+      "get_defi_protocol_skill for deadline and field alignment"
+    ],
     followUp: ["ctm_uniswap_v4_build_swap_multisign"],
     handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapCreateSwap" },
     inputZod: mcpUniswapV4CreateSwapInputSchema,
@@ -1006,16 +1227,171 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build mpc-auth multiSignRequest body for a Uniswap V4 swap. May batch 1\u20133 EVM txs: ERC-20 approve(s) to Permit2/router path + Universal Router swap (or 1 tx for native-in). Estimates gas, serializes unsigned txs, sets proposalTxParams. Output must be signed and POSTed to /multiSignRequest by the caller.",
     prerequisites: [
-      "ctm_uniswap_v4_create_swap output",
-      "keyGen with pubkeyhex",
-      "executorAddress matching MPC wallet",
-      "RPC URL and chainDetail from node chain config"
+      "ctm_uniswap_v4_create_swap output + matching quote snapshot and swapDeadlineUnix",
+      "keyGenId + chainId + purposeText"
     ],
     followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
     handler: { importPath: "protocols/evm/uniswap-v4", exportName: "buildEvmMultisignBodyUniswapV4SkipPermit2Batch" },
     inputZod: mcpUniswapV4BuildSwapMultisignInputSchema,
     outputZod: multisignOutputSchema
   }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_lp_create_position",
+    actionId: "uniswap-v4.lp-create",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Call Uniswap LP API POST /lp/create for a new V4 position. Returns token amounts and `create` transaction calldata. Does NOT create a sign request \u2014 call ctm_uniswap_v4_build_mint_liquidity_multisign next.",
+    prerequisites: ["UNISWAP_API_KEY", "get_defi_protocol_skill for LP flow"],
+    followUp: ["ctm_uniswap_v4_build_mint_liquidity_multisign"],
+    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapLpCreatePosition" },
+    inputZod: mcpUniswapV4LpCreatePositionInputSchema,
+    outputZod: mcpUniswapV4LpCreatePositionOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_build_mint_liquidity_multisign",
+    actionId: "uniswap-v4.mint-liquidity",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest for minting a Uniswap V4 LP position. Batches ERC-20 approve(s) + Position Manager tx from LP create response.",
+    prerequisites: ["ctm_uniswap_v4_lp_create_position output", "keyGenId + chainId + purposeText"],
+    followUp: [
+      "Sign messageToSign",
+      "POST /multiSignRequest",
+      "After execute: ctm_uniswap_v4_register_position_from_mint_tx (mint tx hash)"
+    ],
+    handler: {
+      importPath: "protocols/evm/uniswap-v4",
+      exportName: "buildEvmMultisignBodyUniswapV4MintLiquidityBatch"
+    },
+    inputZod: mcpUniswapV4BuildMintLiquidityMultisignInputSchema,
+    outputZod: multisignOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_lp_increase",
+    actionId: "uniswap-v4.lp-increase",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Call Uniswap LP API POST /lp/increase. Returns `increase` transaction calldata.",
+    prerequisites: ["UNISWAP_API_KEY", "nftTokenId from ctm_uniswap_v4_lp_list_positions"],
+    followUp: ["ctm_uniswap_v4_build_increase_liquidity_multisign"],
+    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapLpIncreasePosition" },
+    inputZod: mcpUniswapV4LpIncreaseInputSchema,
+    outputZod: mcpUniswapV4LpIncreaseOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_build_increase_liquidity_multisign",
+    actionId: "uniswap-v4.increase-liquidity",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest to increase Uniswap V4 position liquidity.",
+    prerequisites: ["ctm_uniswap_v4_lp_increase output"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: {
+      importPath: "protocols/evm/uniswap-v4",
+      exportName: "buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch"
+    },
+    inputZod: mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema,
+    outputZod: multisignOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_lp_decrease",
+    actionId: "uniswap-v4.lp-decrease",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Call Uniswap LP API POST /lp/decrease. Returns `decrease` transaction calldata.",
+    prerequisites: ["UNISWAP_API_KEY", "nftTokenId"],
+    followUp: ["ctm_uniswap_v4_build_decrease_liquidity_multisign"],
+    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapLpDecreasePosition" },
+    inputZod: mcpUniswapV4LpDecreaseInputSchema,
+    outputZod: mcpUniswapV4LpDecreaseOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_build_decrease_liquidity_multisign",
+    actionId: "uniswap-v4.decrease-liquidity",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest to decrease Uniswap V4 position liquidity.",
+    prerequisites: ["ctm_uniswap_v4_lp_decrease output"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: {
+      importPath: "protocols/evm/uniswap-v4",
+      exportName: "buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch"
+    },
+    inputZod: mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema,
+    outputZod: multisignOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_lp_collect",
+    actionId: "uniswap-v4.lp-claim",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Call Uniswap LP API POST /lp/claim to collect accrued fees from a V4 position.",
+    prerequisites: ["UNISWAP_API_KEY", "nftTokenId"],
+    followUp: ["ctm_uniswap_v4_build_collect_fees_multisign"],
+    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapLpClaimFees" },
+    inputZod: mcpUniswapV4LpClaimInputSchema,
+    outputZod: mcpUniswapV4LpClaimOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_build_collect_fees_multisign",
+    actionId: "uniswap-v4.collect-fees",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Build mpc-auth multiSignRequest to collect fees from a Uniswap V4 position.",
+    prerequisites: ["ctm_uniswap_v4_lp_collect output"],
+    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
+    handler: {
+      importPath: "protocols/evm/uniswap-v4",
+      exportName: "buildEvmMultisignBodyUniswapV4CollectFeesBatch"
+    },
+    inputZod: mcpUniswapV4BuildCollectFeesMultisignInputSchema,
+    outputZod: multisignOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_lp_list_positions",
+    actionId: "uniswap-v4.lp-list-positions",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "List Uniswap V4 position NFTs from the node token registry (ERC721 entries for the Position Manager on this chain). Does not scan blockchain logs. Pass keyGenId + chainId.",
+    prerequisites: ["keyGenId + chainId", "Positions saved via register_position_nft or add_to_token_registry"],
+    followUp: ["ctm_uniswap_v4_lp_increase", "ctm_uniswap_v4_lp_decrease", "ctm_uniswap_v4_lp_collect"],
+    handler: {
+      importPath: "protocols/evm/uniswap-v4",
+      exportName: "uniswapV4ListPositionsRegistryMcpPlaceholder"
+    },
+    inputZod: mcpUniswapV4LpListPositionsInputSchema,
+    outputZod: mcpUniswapV4LpListPositionsOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_register_position_nft",
+    actionId: "uniswap-v4.register-position-nft",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Add a Uniswap V4 position NFT to the node token registry (ERC721, management-signed). Call after mint execute when tokenId is known.",
+    prerequisites: ["chainId", "tokenId", "keyGenId for management signing"],
+    followUp: ["ctm_uniswap_v4_lp_list_positions", "ctm_uniswap_v4_lp_increase"],
+    handler: {
+      importPath: "protocols/evm/uniswap-v4",
+      exportName: "uniswapV4RegisterPositionNftPlaceholder"
+    },
+    inputZod: mcpUniswapV4RegisterPositionNftInputSchema,
+    outputZod: mcpUniswapV4RegisterPositionNftOutputSchema
+  }),
+  defineMcpTool({
+    name: "ctm_uniswap_v4_register_position_from_mint_tx",
+    actionId: "uniswap-v4.register-position-from-mint-tx",
+    protocolId: "uniswap-v4",
+    chainCategory: "evm",
+    description: "Parse a completed mint transaction receipt for the new position tokenId and add it to the node token registry (management-signed).",
+    prerequisites: ["chainId", "txHash from mint batch execute", "keyGenId"],
+    followUp: ["ctm_uniswap_v4_lp_list_positions"],
+    handler: {
+      importPath: "protocols/evm/uniswap-v4",
+      exportName: "uniswapV4RegisterPositionFromMintTxPlaceholder"
+    },
+    inputZod: mcpUniswapV4RegisterPositionFromMintTxInputSchema,
+    outputZod: mcpUniswapV4RegisterPositionFromMintTxOutputSchema
+  }),
   defineMcpTool({
     name: "ctm_curve_dao_quote",
     actionId: "curve-dao.quote",
@@ -1023,8 +1399,9 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Fetch a Curve Router NG quote via @curvefi/api getBestRouteAndOutput. Returns output amount, route, and optional priceImpactPercent. Does NOT create a sign request \u2014 call ctm_curve_dao_build_swap_multisign after quoting. Pass chainId only; rpcUrl is resolved from get_chain_registry rpcGateway.",
     prerequisites: [
-      "Chain must be supported by Curve (@curvefi/api network constants).",
-      "Configure rpcGateway for chainId in get_chain_registry."
+      "get_defi_protocol_skill for native placeholder vs wrapped native on build",
+      "chainId + tokenIn + tokenOut + amountHuman",
+      "rpcGateway in get_chain_registry"
     ],
     followUp: ["ctm_curve_dao_build_swap_multisign"],
     handler: { importPath: "protocols/evm/curve-dao", exportName: "curveDaoQuote" },
@@ -1038,9 +1415,9 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     chainCategory: "evm",
     description: "Build mpc-auth multiSignRequest for a Curve Router NG swap via @curvefi/api populateSwap. Optionally batches ERC-20 approve txs when allowance is insufficient, then exchange. Requires JSON-RPC and Curve-supported chain.",
     prerequisites: [
-      "ctm_curve_dao_quote (recommended) or known-good route",
-      "keyGenId + chainId + purposeText",
-      "tokenIn/tokenOut/amountHuman/slippagePercent"
+      "ctm_curve_dao_quote (recommended)",
+      "keyGenId + chainId + purposeText + slippagePercent (0\u2013100 exclusive)",
+      "get_defi_protocol_skill for tokenIn address rules"
     ],
     followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
     handler: { importPath: "protocols/evm/curve-dao", exportName: "buildEvmMultisignBodyCurveDaoBatch" },
@@ -1733,6 +2110,6 @@ function getAgentCatalog() {
   };
 }
 
-export { EVM_COMMON_PARAM_DOCS, MANAGEMENT_SIG_DOC, MCP_NON_SUBMIT_TOOL_NAMES, MCP_TOOL_DEFINITIONS, MCP_TOOL_INPUT_SCHEMAS, MCP_TOOL_OUTPUT_SCHEMAS, MULTISIGN_OUTPUT_DOC, PROTOCOL_SUPPORT_ADVISORS, chainDetailSchema, evmAddressSchema, evmMultisignCommonInputSchema, getActionsByChainCategory, getAgentCatalog, getAgentCatalogForMcp, getMcpToolByName, getMcpToolDefinitions, getMcpToolInputSchema, getMcpToolOutputSchema, getProtocolDiscoverySummary, getProtocolModules, getProtocolSkill, getProtocolSupportAdvisor, getToolsForProtocol, jsonObjectSchema, keyGenSchema, listProtocolSupportAdvisorIds, listProtocolsWithSkills, mcpAaveV4BorrowInputSchema, mcpAaveV4DepositInputSchema, mcpAaveV4RepayInputSchema, mcpAaveV4WithdrawInputSchema, mcpCurveDaoBuildSwapMultisignInputSchema, mcpCurveDaoQuoteInputSchema, mcpCurveDaoQuoteOutputSchema, mcpEthenaClaimInputSchema, mcpEthenaCooldownInputSchema, mcpEthenaRedeemInputSchema, mcpEthenaStakeInputSchema, mcpEulerV2BorrowRepayInputSchema, mcpEulerV2CollateralDepositInputSchema, mcpEulerV2CollateralWithdrawInputSchema, mcpEulerV2IsolatedBorrowInputSchema, mcpEulerV2IsolatedLendInputSchema, mcpEulerV2VaultWithdrawInputSchema, mcpLidoClaimWithdrawalInputSchema, mcpLidoRequestWithdrawalsInputSchema, mcpLidoSubmitInputSchema, mcpLidoUnwrapWstEthInputSchema, mcpLidoWrapStEthInputSchema, mcpMapleDepositInputSchema, mcpMapleRequestRedeemInputSchema, mcpMultisignInput, multisignOutputSchema as mcpMultisignOutputSchema, mcpServerCommonInputSchema, mcpServerMultisignInput, mcpServerSubmitOutputSchema, mcpSkyLockstakeCloseInputSchema, mcpSkyLockstakeDrawInputSchema, mcpSkyLockstakeGetRewardInputSchema, mcpSkyLockstakeStakeInputSchema, mcpSkyLockstakeWipeInputSchema, mcpSkySusdsDepositInputSchema, mcpSkySusdsRedeemInputSchema, mcpUniswapV4BuildSwapMultisignInputSchema, mcpUniswapV4CreateSwapInputSchema, mcpUniswapV4CreateSwapOutputSchema, mcpUniswapV4QuoteInputSchema, mcpUniswapV4QuoteOutputSchema, multisignOutputSchema, parseMcpToolInput, parseMcpToolOutput, uniswapQuoteTradeTypeSchema, zodSchemaToMcpJsonSchema };
+export { EVM_COMMON_PARAM_DOCS, MANAGEMENT_SIG_DOC, MCP_NON_SUBMIT_TOOL_NAMES, MCP_TOOL_DEFINITIONS, MCP_TOOL_INPUT_SCHEMAS, MCP_TOOL_OUTPUT_SCHEMAS, MULTISIGN_OUTPUT_DOC, PROTOCOL_SUPPORT_ADVISORS, chainDetailSchema, evmAddressSchema, evmMultisignCommonInputSchema, getActionsByChainCategory, getAgentCatalog, getAgentCatalogForMcp, getMcpToolByName, getMcpToolDefinitions, getMcpToolInputSchema, getMcpToolOutputSchema, getProtocolDiscoverySummary, getProtocolModules, getProtocolSkill, getProtocolSupportAdvisor, getToolsForProtocol, jsonObjectSchema, keyGenSchema, listProtocolSupportAdvisorIds, listProtocolsWithSkills, mcpAaveV4BorrowInputSchema, mcpAaveV4DepositInputSchema, mcpAaveV4RepayInputSchema, mcpAaveV4WithdrawInputSchema, mcpCurveDaoBuildSwapMultisignInputSchema, mcpCurveDaoQuoteInputSchema, mcpCurveDaoQuoteOutputSchema, mcpEthenaClaimInputSchema, mcpEthenaCooldownInputSchema, mcpEthenaRedeemInputSchema, mcpEthenaStakeInputSchema, mcpEulerV2BorrowRepayInputSchema, mcpEulerV2CollateralDepositInputSchema, mcpEulerV2CollateralWithdrawInputSchema, mcpEulerV2IsolatedBorrowInputSchema, mcpEulerV2IsolatedLendInputSchema, mcpEulerV2VaultWithdrawInputSchema, mcpLidoClaimWithdrawalInputSchema, mcpLidoRequestWithdrawalsInputSchema, mcpLidoSubmitInputSchema, mcpLidoUnwrapWstEthInputSchema, mcpLidoWrapStEthInputSchema, mcpMapleDepositInputSchema, mcpMapleRequestRedeemInputSchema, mcpMultisignInput, multisignOutputSchema as mcpMultisignOutputSchema, mcpServerCommonInputSchema, mcpServerMultisignInput, mcpServerSubmitOutputSchema, mcpSkyLockstakeCloseInputSchema, mcpSkyLockstakeDrawInputSchema, mcpSkyLockstakeGetRewardInputSchema, mcpSkyLockstakeStakeInputSchema, mcpSkyLockstakeWipeInputSchema, mcpSkySusdsDepositInputSchema, mcpSkySusdsRedeemInputSchema, mcpUniswapV4BuildCollectFeesMultisignInputSchema, mcpUniswapV4BuildDecreaseLiquidityMultisignInputSchema, mcpUniswapV4BuildIncreaseLiquidityMultisignInputSchema, mcpUniswapV4BuildMintLiquidityMultisignInputSchema, mcpUniswapV4BuildSwapMultisignInputSchema, mcpUniswapV4CreateSwapInputSchema, mcpUniswapV4CreateSwapOutputSchema, mcpUniswapV4LpClaimInputSchema, mcpUniswapV4LpClaimOutputSchema, mcpUniswapV4LpCreatePositionInputSchema, mcpUniswapV4LpCreatePositionOutputSchema, mcpUniswapV4LpDecreaseInputSchema, mcpUniswapV4LpDecreaseOutputSchema, mcpUniswapV4LpIncreaseInputSchema, mcpUniswapV4LpIncreaseOutputSchema, mcpUniswapV4LpListPositionsInputSchema, mcpUniswapV4LpListPositionsOutputSchema, mcpUniswapV4QuoteInputSchema, mcpUniswapV4QuoteOutputSchema, mcpUniswapV4RegisterPositionFromMintTxInputSchema, mcpUniswapV4RegisterPositionFromMintTxOutputSchema, mcpUniswapV4RegisterPositionNftInputSchema, mcpUniswapV4RegisterPositionNftOutputSchema, multisignOutputSchema, parseMcpToolInput, parseMcpToolOutput, uniswapQuoteTradeTypeSchema, zodSchemaToMcpJsonSchema };
 //# sourceMappingURL=catalog.js.map
 //# sourceMappingURL=catalog.js.map