@continuumdao/ctm-mpc-defi 0.2.0 → 0.2.1

package/dist/index.js

@@ -1,24 +1,8 @@
-import { getAddress, zeroAddress, defineChain, createPublicClient, http, formatUnits, parseGwei, serializeTransaction, keccak256, encodeFunctionData, erc20Abi, parseAbi, parseUnits, decodeFunctionData, isAddress } from 'viem';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { z } from 'zod';
+import { getClientIdFromKeyGenResult, gasLimitFromEstimateAndChainConfig, fetchChainFeeParams, gweiToDecimalString, proposalTxParamsToFeeSnapshot, alignEip1559FeesWithLatestBase, nodeFetchWithReadAuth } from '@continuumdao/continuum-node-sdk';
+export { getClientIdFromKeyGenResult as firstClientIdFromKeyGen } from '@continuumdao/continuum-node-sdk';
+import { getAddress, zeroAddress, defineChain, createPublicClient, http, parseGwei, serializeTransaction, keccak256, encodeFunctionData, erc20Abi, parseAbi, parseUnits, decodeFunctionData, isAddress } from 'viem';
 
-// src/core/keygen.ts
-function firstClientIdFromKeyGen(data) {
-  const map = data?.ClientKeys;
-  if (!map || typeof map !== "object") return null;
-  for (const v of Object.values(map)) {
-    if (typeof v === "string" && v.trim()) return v.trim();
-  }
-  return null;
-}
-function requirePubKeyHex(keyGen) {
-  const ph = (keyGen.pubkeyhex ?? "").trim();
-  if (!ph) throw new Error("keyGen pubKey (pubkeyhex) is required");
-  return ph;
-}
-function keyListFromKeyGen(keyGen) {
-  return keyGen.keylist ?? [];
-}
+// src/core/index.ts
 
 // src/core/purpose.ts
 function mergePurposeText(purposeText, purposeSuffix) {
@@ -29,8 +13,6 @@ function mergePurposeText(purposeText, purposeSuffix) {
 
 ${suffix}` : suffix;
 }
-
-// src/core/envelope.ts
 function finalizeMultisign(input) {
   const { keyGen, destinationChainID, legs } = input;
   if (legs.length === 0) {
@@ -39,7 +21,7 @@ function finalizeMultisign(input) {
   const ph = (keyGen.pubkeyhex ?? "").trim();
   if (!ph) throw new Error("keyGen pubKey (pubkeyhex) is required");
   const keyList = keyGen.keylist ?? [];
-  const clientId = firstClientIdFromKeyGen(keyGen);
+  const clientId = getClientIdFromKeyGenResult(keyGen);
   const first = legs[0];
   const messageHashes = legs.map((l) => l.msgHash);
   const messageRawBatch = legs.map((l) => l.msgRaw);
@@ -104,85 +86,6 @@ function getProtocolModule(id) {
 function getActionsByChainCategory(category) {
   return modules.filter((m) => m.chainCategory === category).flatMap((m) => m.actions);
 }
-
-// src/core/nodeRead.ts
-function nodeFetchWithReadAuth(url, init, auth) {
-  const method = (init?.method ?? "GET").toUpperCase();
-  const headers = new Headers(init?.headers);
-  if (auth.bearerOnGet && method === "GET" && auth.jwt && auth.jwt.trim()) {
-    headers.set("Authorization", `Bearer ${auth.jwt.trim()}`);
-  }
-  return fetch(url, { ...init, headers });
-}
-
-// src/core/managementPostSig.ts
-function normalizeManagementNodeKey(nodeKey) {
-  const nk = nodeKey?.trim().replace(/^0x/i, "");
-  if (!nk || !/^[0-9a-fA-F]{128}$/.test(nk)) {
-    throw new Error("nodeKey is required (128 hex from GET /getNodeKey).");
-  }
-  return nk.toLowerCase();
-}
-function managementSigFields(nonce, nodeKey) {
-  return { nonce, clientSig: "", nodeKey: normalizeManagementNodeKey(nodeKey) };
-}
-function buildManagementPostBody(nonce, nodeKey, fields = {}) {
-  return { ...managementSigFields(nonce, nodeKey), ...fields };
-}
-function messageToSignManagementBody(body) {
-  return JSON.stringify({ ...body, clientSig: "" });
-}
-function withManagementClientSig(body, clientSig) {
-  return { ...body, clientSig: clientSig.trim().replace(/^0x/i, "") };
-}
-
-// src/core/managementNonce.ts
-function mpcAuthData(raw) {
-  const code = raw.Code ?? raw.code;
-  if (code !== 0 && code !== void 0) return void 0;
-  return raw.Data ?? raw.data;
-}
-async function fetchNodeKey(nodeUrl, readAuth = { bearerOnGet: false, jwt: null }) {
-  const base = nodeUrl.trim().replace(/\/$/, "");
-  const res = await nodeFetchWithReadAuth(`${base}/getNodeKey`, { cache: "no-store" }, readAuth);
-  const text = await res.text();
-  let raw;
-  try {
-    raw = JSON.parse(text);
-  } catch {
-    return { nodeKey: "", ok: false };
-  }
-  const data = mpcAuthData(raw);
-  const nk = typeof data === "string" ? data : data != null && typeof data === "object" && !Array.isArray(data) ? String(data.nodeKey ?? data.NodeKey ?? "") : data != null ? String(data) : "";
-  const trimmed = nk.trim().replace(/^0x/i, "");
-  if (!/^[0-9a-fA-F]{128}$/.test(trimmed)) {
-    return { nodeKey: "", ok: false };
-  }
-  return { nodeKey: trimmed.toLowerCase(), ok: res.ok };
-}
-async function fetchManagementNonce(nodeUrl, useEd25519, ed25519PublicKey, readAuth = { bearerOnGet: false, jwt: null }) {
-  const base = nodeUrl.trim().replace(/\/$/, "");
-  const path = useEd25519 ? "/getPublicMgtKeyNonce" : "/getNodeMgtKeyNonce";
-  const url = useEd25519 && ed25519PublicKey && /^[0-9a-fA-F]{64}$/.test(ed25519PublicKey.trim()) ? `${base}${path}?publicKey=${encodeURIComponent(ed25519PublicKey.trim())}` : `${base}${path}`;
-  const res = await nodeFetchWithReadAuth(url, { cache: "no-store" }, readAuth);
-  const text = await res.text();
-  let raw;
-  try {
-    raw = JSON.parse(text);
-  } catch {
-    return { nonce: 0, ok: false, code: -1 };
-  }
-  const code = raw.Code ?? raw.code;
-  const payload = mpcAuthData(raw) ?? raw.Data ?? raw.data;
-  let nonce = 0;
-  if (typeof payload === "number" && !Number.isNaN(payload)) {
-    nonce = payload;
-  } else if (payload && typeof payload === "object") {
-    const n = payload.nonce ?? payload.Nonce;
-    nonce = typeof n === "number" && !Number.isNaN(n) ? n : Number(n) || 0;
-  }
-  return { nonce, ok: res.ok && (code === 0 || code === void 0), code: code ?? -1 };
-}
 function isEvmNativeToken(address) {
   try {
     return getAddress(address) === zeroAddress;
@@ -197,161 +100,12 @@ function matchEvmTokenKind(kind, address) {
   }
   return true;
 }
-
-// src/chains/evm/txParams.ts
-function gasLimitFromEstimateAndChainConfig(estimatedGas, chainGasLimit) {
-  if (chainGasLimit == null || !Number.isFinite(chainGasLimit) || chainGasLimit <= 0) {
-    return estimatedGas;
-  }
-  const cfg = BigInt(Math.floor(chainGasLimit));
-  return cfg > estimatedGas ? cfg : estimatedGas;
-}
 function routerSwapGasLimitFromEstimate(estimatedGas, chainGasLimit) {
   if (chainGasLimit != null && Number.isFinite(chainGasLimit) && chainGasLimit > 0) {
     return gasLimitFromEstimateAndChainConfig(estimatedGas, chainGasLimit);
   }
   return (estimatedGas * 12n + 9n) / 10n;
 }
-function composeFeePayloadToTxParams(p, legacy) {
-  const gl = p.txGasLimit ?? p.txgaslimit;
-  if (gl == null || String(gl).trim() === "") return void 0;
-  const n = p.txNonce ?? p.txnonce;
-  let nonce = 0;
-  if (typeof n === "bigint") nonce = Number(n);
-  else if (typeof n === "number") nonce = n;
-  else if (n != null) nonce = parseInt(String(n), 10);
-  if (!Number.isFinite(nonce)) nonce = 0;
-  const gasLimit = String(gl);
-  if (legacy) {
-    const gp = p.txGasPrice ?? p.txgasprice;
-    return {
-      nonce,
-      gasLimit,
-      txType: "legacy",
-      gasPrice: gp != null ? String(gp) : "0"
-    };
-  }
-  return {
-    nonce,
-    gasLimit,
-    txType: "eip1559",
-    maxFeePerGas: String(p.txMaxFeePerGas ?? ""),
-    maxPriorityFeePerGas: String(p.txMaxPriorityFeePerGas ?? "")
-  };
-}
-function triggerTxParamsFromComposeBody(body) {
-  const existing = body.txParams;
-  if (existing && typeof existing === "object" && !Array.isArray(existing)) {
-    const o = existing;
-    if (String(o.gasLimit ?? "").trim() !== "") {
-      return { ...o };
-    }
-  }
-  const pb = body.proposalTxParams;
-  if (Array.isArray(pb) && pb.length > 0 && typeof pb[0] === "object" && pb[0] !== null) {
-    const first = pb[0];
-    if (String(first.gasLimit ?? "").trim() !== "") {
-      return { ...first };
-    }
-  }
-  const fromSnapshot = composeFeePayloadToTxParams(
-    body,
-    body.txMaxFeePerGas == null && body.txMaxPriorityFeePerGas == null
-  );
-  if (fromSnapshot) return fromSnapshot;
-  return {
-    nonce: 0,
-    gasLimit: "",
-    txType: "legacy",
-    gasPrice: "0"
-  };
-}
-function proposalTxParamsToFeeSnapshot(params) {
-  if (params.txType === "legacy") {
-    return {
-      txNonce: params.nonce,
-      txGasLimit: params.gasLimit,
-      txGasPrice: params.gasPrice ?? "0"
-    };
-  }
-  return {
-    txNonce: params.nonce,
-    txGasLimit: params.gasLimit,
-    txMaxFeePerGas: params.maxFeePerGas ?? "",
-    txMaxPriorityFeePerGas: params.maxPriorityFeePerGas ?? ""
-  };
-}
-async function fetchChainFeeParams(rpcUrl, chainId) {
-  const url = rpcUrl.trim();
-  if (!url) return { isEip1559: false };
-  const chainIdNum = typeof chainId === "string" ? parseInt(chainId, 10) : chainId;
-  if (Number.isNaN(chainIdNum)) return { isEip1559: false };
-  const chain = defineChain({
-    id: chainIdNum,
-    name: "Discovery",
-    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
-    rpcUrls: { default: { http: [url] } }
-  });
-  const publicClient = createPublicClient({
-    chain,
-    transport: http(url)
-  });
-  const getGasPriceGwei = async () => {
-    const gasPriceWei = await publicClient.getGasPrice();
-    return parseFloat(formatUnits(gasPriceWei, 9));
-  };
-  try {
-    const block = await publicClient.getBlock({ blockTag: "latest" });
-    const baseFeePerGas = block?.baseFeePerGas;
-    if (baseFeePerGas == null || baseFeePerGas === void 0) {
-      const gasPriceGwei2 = await getGasPriceGwei();
-      return { isEip1559: false, gasPriceGwei: gasPriceGwei2 };
-    }
-    const baseFeeGwei = parseFloat(formatUnits(baseFeePerGas, 9));
-    let priorityFeeGwei;
-    try {
-      const priorityWei = await publicClient.estimateMaxPriorityFeePerGas();
-      priorityFeeGwei = parseFloat(formatUnits(priorityWei, 9));
-    } catch {
-    }
-    const gasPriceGwei = await getGasPriceGwei();
-    return {
-      isEip1559: true,
-      baseFeeGwei,
-      priorityFeeGwei,
-      gasPriceGwei
-    };
-  } catch {
-    try {
-      const gasPriceWei = await publicClient.getGasPrice();
-      const gasPriceGwei = parseFloat(formatUnits(gasPriceWei, 9));
-      return { isEip1559: false, gasPriceGwei };
-    } catch {
-      return { isEip1559: false };
-    }
-  }
-}
-function finalizeEip1559Fees(maxFeePerGas, maxPriorityFeePerGas, floor, baseWei) {
-  let maxP = maxPriorityFeePerGas;
-  let maxF = maxFeePerGas;
-  if (baseWei > 0n && maxF < baseWei + maxP) {
-    maxF = baseWei + maxP + parseGwei("0.001");
-  }
-  if (maxF < maxP) {
-    maxF = baseWei > 0n ? baseWei + maxP + parseGwei("0.001") : maxP * 2n;
-  }
-  return { maxFeePerGas: maxF, maxPriorityFeePerGas: maxP };
-}
-function alignEip1559FeesWithLatestBase(maxFeePerGas, maxPriorityFeePerGas, latestBlockBaseFeeWei) {
-  return finalizeEip1559Fees(maxFeePerGas, maxPriorityFeePerGas, null, latestBlockBaseFeeWei);
-}
-function gweiToDecimalString(n) {
-  if (!Number.isFinite(n)) return "0";
-  if (n === 0) return "0";
-  const s = String(n);
-  if (s.indexOf("e") !== -1 || s.indexOf("E") !== -1) return n.toFixed(9).replace(/\.?0+$/, "") || "0";
-  return s;
-}
 
 // src/chains/evm/buildBatch.ts
 async function buildEvmMultisignBatch(args) {
@@ -387,15 +141,19 @@ async function buildEvmMultisignBatch(args) {
     const step = steps[i];
     const currentNonce = baseNonce + i;
     let estimatedGas;
-    try {
-      estimatedGas = await publicClient.estimateGas({
-        to: step.to,
-        data: step.data,
-        value: step.value,
-        account: executor
-      });
-    } catch {
-      estimatedGas = step.fallbackGas ?? 100000n;
+    if (args.estimateGasForStep) {
+      estimatedGas = await args.estimateGasForStep({ step, index: i, publicClient, executor });
+    } else {
+      try {
+        estimatedGas = await publicClient.estimateGas({
+          to: step.to,
+          data: step.data,
+          value: step.value,
+          account: executor
+        });
+      } catch {
+        estimatedGas = step.fallbackGas ?? 100000n;
+      }
     }
     let gasLimitI;
     if (args.resolveGasLimit) {
@@ -517,30 +275,6 @@ var evmChainCategoryModule = {
   buildEvmMultisignBatch
 };
 
-// src/chains/evm/fees/customGas.ts
-function chainSnapshotForCustomGasExtraJSON(chainDetail) {
-  const lr = chainDetail.legacy;
-  const legacy = lr === true || typeof lr === "string" && lr.toLowerCase() === "true";
-  const push = (o, key, v) => {
-    if (v === void 0 || v === null) return;
-    if (typeof v === "string" && v.trim() === "") return;
-    o[key] = v;
-  };
-  const fields = {};
-  push(fields, "gasLimit", chainDetail.gasLimit);
-  if (legacy) {
-    push(fields, "gasMultiplier", chainDetail.gasMultiplier);
-    push(fields, "gasPrice", chainDetail.gasPrice);
-  } else {
-    push(fields, "gasMultiplier", chainDetail.gasMultiplier);
-    push(fields, "baseFee", chainDetail.baseFee);
-    push(fields, "priorityFee", chainDetail.priorityFee);
-    push(fields, "baseFeeMultiplier", chainDetail.baseFeeMultiplier);
-  }
-  push(fields, "legacy", legacy);
-  return fields;
-}
-
 // src/chains/evm/chainIdParse.ts
 function parseEvmChainIdToNumber(chainId) {
   if (chainId == null) return Number.NaN;
@@ -565,18 +299,6 @@ function parseEvmChainIdToNumber(chainId) {
   return Number.parseInt(t, 10);
 }
 
-// src/chains/evm/rpcUrl.ts
-function isValidRpcUrl(url) {
-  const t = url.trim();
-  if (!t) return false;
-  try {
-    const u = new URL(t);
-    return u.protocol === "http:" || u.protocol === "https:";
-  } catch {
-    return false;
-  }
-}
-
 // src/chains/solana/types.ts
 var solanaChainCategoryModule = {
   category: "solana"
@@ -1000,6 +722,35 @@ async function uniswapCreateSwap(args) {
   }
   return parsed;
 }
+async function estimateUniswapRouterSwapGas(args) {
+  const fromTradeApi = parseOptionalGasLimitString(args.swapRecord.gasLimit) ?? parseOptionalGasLimitString(args.swapRecord.gas);
+  if (fromTradeApi != null && fromTradeApi > 0n) {
+    return { baseGasUnits: fromTradeApi, source: "tradeApi" };
+  }
+  try {
+    const est = await args.publicClient.estimateGas({
+      to: args.to,
+      data: args.data,
+      value: args.value,
+      account: args.executor
+    });
+    return { baseGasUnits: est, source: "rpcEstimate" };
+  } catch (e) {
+    const estimateGasError = e instanceof Error ? e.message : String(e);
+    const minRouterGas = 500000n;
+    if (args.useCustomGas) {
+      const cfg = args.chainDetail?.gasLimit != null ? parseOptionalGasLimitString(String(args.chainDetail.gasLimit)) : null;
+      if (cfg != null && cfg >= minRouterGas) {
+        return { baseGasUnits: cfg, source: "estimateFailedFallback", estimateGasError };
+      }
+    }
+    return {
+      baseGasUnits: DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK,
+      source: "estimateFailedFallback",
+      estimateGasError
+    };
+  }
+}
 var permit2ApproveRouterAbi = [
   {
     name: "approve",
@@ -1100,10 +851,6 @@ function permit2SpenderAndApproveWeiFromSwapCalldata(dataHex, tokenIn, quoteInpu
   }
 }
 async function buildEvmMultisignBodyUniswapV4NativeInOnly(args, quoteInputWei) {
-  const ph = (args.keyGen.pubkeyhex ?? "").trim();
-  if (!ph) throw new Error("keyGen pubKey (pubkeyhex) is required");
-  const keyList = args.keyGen.keylist ?? [];
-  const clientId = firstClientIdFromKeyGen(args.keyGen);
   const toRouter = getAddress(
     (args.swap.to ?? "").trim().startsWith("0x") ? args.swap.to.trim() : `0x${args.swap.to.trim()}`
   );
@@ -1121,214 +868,90 @@ async function buildEvmMultisignBodyUniswapV4NativeInOnly(args, quoteInputWei) {
       "Native (ETH) in swap: could not determine payable value (no `swap.value`, no `execute` amount in calldata, and quote input is zero). Refresh the quote and request /swap again."
     );
   }
-  const ch = defineChain({
-    id: args.chainId,
-    name: "Destination",
-    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
-    rpcUrls: { default: { http: [args.rpcUrl] } }
-  });
-  const publicClient = createPublicClient({ chain: ch, transport: http(args.rpcUrl) });
-  const feeParams = await fetchChainFeeParams(args.rpcUrl, args.chainId);
-  const legacy = Boolean(args.chainDetail?.legacy) || !feeParams.isEip1559;
-  const latestBaseFeeWeiNativeIn = !legacy ? (await publicClient.getBlock({ blockTag: "latest" })).baseFeePerGas ?? 0n : 0n;
-  const useCustomGas = args.useCustomGas;
-  const chainGasLimitRouter = args.chainDetail?.gasLimit != null && Number.isFinite(Number(args.chainDetail.gasLimit)) && Number(args.chainDetail.gasLimit) > 0 ? Number(args.chainDetail.gasLimit) : void 0;
-  const gasFeeMultiplier = useCustomGas && args.chainDetail?.gasMultiplier != null ? Number(args.chainDetail.gasMultiplier) : void 0;
-  const nonce = await publicClient.getTransactionCount({ address: args.executorAddress, blockTag: "pending" });
-  const proposalTxParamsBatch = [];
-  const messageHashes = [];
-  const messageRawBatch = [];
   const swapRecord = args.swap;
-  const fromTradeApi = parseOptionalGasLimitString(swapRecord.gasLimit) ?? parseOptionalGasLimitString(swapRecord.gas);
   let gasBuildSource = "rpcEstimate";
   let estimateGasError;
-  let baseGasUnits1;
-  if (fromTradeApi != null && fromTradeApi > 0n) {
-    baseGasUnits1 = fromTradeApi;
-    gasBuildSource = "tradeApi";
-  } else {
-    try {
-      baseGasUnits1 = await publicClient.estimateGas({
+  let swapBaseGasUnits = DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK;
+  const dataNo0x = dataHex.startsWith("0x") ? dataHex.slice(2) : dataHex;
+  const purposeSuffix = "Uniswap V4: 1-tx batch \u2014 native gas token in (no ERC-20 approve) \u2014 single payable swap (Trade /swap).";
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: args.executorAddress,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps: [
+      {
         to: toRouter,
         data: dataHex,
         value: valueWei,
-        account: args.executorAddress
-      });
-      gasBuildSource = "rpcEstimate";
-    } catch (e) {
-      estimateGasError = e instanceof Error ? e.message : String(e);
-      const minRouterGas = 500000n;
-      if (useCustomGas) {
-        const cfg = args.chainDetail?.gasLimit != null ? parseOptionalGasLimitString(String(args.chainDetail.gasLimit)) : null;
-        if (cfg != null && cfg >= minRouterGas) {
-          baseGasUnits1 = cfg;
-        } else {
-          baseGasUnits1 = DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK;
-        }
-      } else {
-        baseGasUnits1 = DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK;
-      }
-      gasBuildSource = "estimateFailedFallback";
-    }
-  }
-  const gasLimit1 = routerSwapGasLimitFromEstimate(baseGasUnits1, chainGasLimitRouter);
-  const currentNonce0 = nonce;
-  let firstTxFeePayload = {};
-  if (legacy) {
-    let gasPriceWei1 = await publicClient.getGasPrice();
-    if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-      gasPriceWei1 = gasPriceWei1 * BigInt(100 + gasFeeMultiplier) / 100n;
-    }
-    if (useCustomGas && args.chainDetail?.gasPrice != null && args.chainDetail.gasPrice > 0) {
-      const configured = parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
-      if (configured > gasPriceWei1) gasPriceWei1 = configured;
-    }
-    firstTxFeePayload = { txNonce: nonce, txGasLimit: gasLimit1.toString(), txGasPrice: gasPriceWei1.toString() };
-    const ser0 = serializeTransaction({
-      type: "legacy",
-      to: toRouter,
-      data: dataHex,
-      value: valueWei,
-      gas: gasLimit1,
-      gasPrice: gasPriceWei1,
-      nonce: currentNonce0,
-      chainId: args.chainId
-    });
-    const h0 = keccak256(ser0);
-    messageHashes.push(h0.startsWith("0x") ? h0.slice(2) : h0);
-    messageRawBatch.push(ser0);
-    proposalTxParamsBatch.push({
-      nonce: currentNonce0,
-      gasLimit: gasLimit1.toString(),
-      txType: "legacy",
-      gasPrice: gasPriceWei1.toString()
-    });
-  } else {
-    const fetchedBase1 = feeParams.baseFeeGwei ?? 0;
-    const fetchedPriority1 = feeParams.priorityFeeGwei ?? 0;
-    const configuredBase1 = useCustomGas && args.chainDetail?.baseFee != null ? Number(args.chainDetail.baseFee) : 0;
-    const configuredPriority1 = useCustomGas && args.chainDetail?.priorityFee != null ? Number(args.chainDetail.priorityFee) : 0;
-    const effectiveBaseFeeGwei1 = Math.max(fetchedBase1, configuredBase1);
-    const effectivePriorityFeeGwei1 = Math.max(fetchedPriority1, configuredPriority1);
-    const baseFeeMultiplierPct1 = useCustomGas && args.chainDetail?.baseFeeMultiplier != null ? Math.max(100, Number(args.chainDetail.baseFeeMultiplier)) : 100;
-    const baseComponentGwei1 = effectiveBaseFeeGwei1 * baseFeeMultiplierPct1 / 100;
-    const maxFeePerGasGwei1 = baseComponentGwei1 + effectivePriorityFeeGwei1;
-    let maxPriorityFeePerGas1 = effectivePriorityFeeGwei1 > 0 ? parseGwei(gweiToDecimalString(effectivePriorityFeeGwei1)) : parseGwei("1");
-    let maxFeePerGas1 = parseGwei(gweiToDecimalString(maxFeePerGasGwei1));
-    if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-      maxPriorityFeePerGas1 = maxPriorityFeePerGas1 * BigInt(100 + gasFeeMultiplier) / 100n;
-      maxFeePerGas1 = maxFeePerGas1 * BigInt(100 + gasFeeMultiplier) / 100n;
-    }
-    ({ maxFeePerGas: maxFeePerGas1, maxPriorityFeePerGas: maxPriorityFeePerGas1 } = alignEip1559FeesWithLatestBase(maxFeePerGas1, maxPriorityFeePerGas1, latestBaseFeeWeiNativeIn));
-    firstTxFeePayload = {
-      txNonce: nonce,
-      txGasLimit: gasLimit1.toString(),
-      txMaxFeePerGas: maxFeePerGas1.toString(),
-      txMaxPriorityFeePerGas: maxPriorityFeePerGas1.toString()
-    };
-    const ser0 = serializeTransaction({
-      type: "eip1559",
-      to: toRouter,
-      data: dataHex,
-      value: valueWei,
-      gas: gasLimit1,
-      maxFeePerGas: maxFeePerGas1,
-      maxPriorityFeePerGas: maxPriorityFeePerGas1,
-      nonce: currentNonce0,
-      chainId: args.chainId
-    });
-    const h0 = keccak256(ser0);
-    messageHashes.push(h0.startsWith("0x") ? h0.slice(2) : h0);
-    messageRawBatch.push(ser0);
-    proposalTxParamsBatch.push({
-      nonce: currentNonce0,
-      gasLimit: gasLimit1.toString(),
-      txType: "eip1559",
-      maxFeePerGas: maxFeePerGas1.toString(),
-      maxPriorityFeePerGas: maxPriorityFeePerGas1.toString()
-    });
-  }
-  const dataNo0x = dataHex.startsWith("0x") ? dataHex.slice(2) : dataHex;
-  const audit = {
-    skipPermit2Batch: true,
-    inputKind: "native_eth",
-    noErc20Approve: true,
-    quoteInputWei: quoteInputWei.toString(),
-    swapValueWei: valueWei.toString(),
-    uniswapCreateSwap: {
-      requestId: args.createSwapResponse.requestId,
-      gasFee: args.createSwapResponse.gasFee,
-      gasBuildSwap: {
-        useCustomGas,
-        source: gasBuildSource,
-        baseGasUnits: baseGasUnits1.toString(),
-        ...estimateGasError != null && estimateGasError !== "" ? { estimateGasError } : {}
-      },
-      swap: {
-        to: args.createSwapResponse.swap.to,
-        value: args.createSwapResponse.swap.value,
-        dataNibbles: (() => {
-          const t = (args.createSwapResponse.swap.data ?? "").toString().trim();
-          return t.startsWith("0x") ? t.length - 2 : t.length;
-        })()
+        routerSwap: true,
+        fallbackGas: DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK
       }
+    ],
+    purposeSuffix,
+    firstMsgRawNo0x: dataNo0x,
+    destinationAddress: toRouter,
+    estimateGasForStep: async ({ publicClient, executor }) => {
+      const r = await estimateUniswapRouterSwapGas({
+        publicClient,
+        executor,
+        to: toRouter,
+        data: dataHex,
+        value: valueWei,
+        swapRecord,
+        useCustomGas: args.useCustomGas,
+        chainDetail: args.chainDetail
+      });
+      gasBuildSource = r.source;
+      estimateGasError = r.estimateGasError;
+      swapBaseGasUnits = r.baseGasUnits;
+      return r.baseGasUnits;
     },
-    fullQuoteFromPermitSnapshot: args.fullQuoteSnapshot,
-    originalPurpose: args.purposeText
-  };
-  const batchMeta = [
-    {
-      destinationAddress: toRouter,
+    buildBatchMeta: () => ({
       signatureText: JSON.stringify({
         kind: "UniswapV4",
         name: "UniversalRouter (payable, native in)",
         note: "Single tx from Trade POST /swap; no ERC-20 approve. Calldata in messageHashes[0] / messageRawBatch[0]."
       }),
       evm: { type: "uniswap_v4_swap_tx", version: 1, chainId: String(args.chainId) },
-      uniswapV4: audit
-    }
-  ];
-  const extraPayload = { batchMeta };
-  if (useCustomGas) {
-    const snap = args.customGasChainDetails;
-    if (snap && typeof snap === "object" && !Array.isArray(snap) && Object.keys(snap).length > 0) {
-      extraPayload.customGasChainDetails = snap;
-    }
-  }
-  const extraJSON = JSON.stringify(extraPayload);
-  const firstSigText = batchMeta[0].signatureText;
-  const bodyForSign = {
-    keyList,
-    pubKey: ph,
-    msgHash: messageHashes[0],
-    msgRaw: dataNo0x,
-    messageHashes,
-    messageRawBatch,
-    destinationChainID: String(args.chainId),
-    destinationAddress: toRouter,
-    extraJSON,
-    signatureText: firstSigText,
-    purpose: (() => {
-      const t = args.purposeText.trim();
-      const batchDesc = "Uniswap V4: 1-tx batch \u2014 native gas token in (no ERC-20 approve) \u2014 single payable swap (Trade /swap).";
-      return (t ? `${t}
-
-` : "") + batchDesc;
-    })(),
-    ...firstTxFeePayload,
-    proposalTxParams: proposalTxParamsBatch
-  };
-  if (valueWei > 0n) {
-    bodyForSign.value = valueWei.toString();
-  }
-  if (clientId) bodyForSign.clientId = clientId;
-  return { bodyForSign, messageToSign: JSON.stringify(bodyForSign) };
+      uniswapV4: {
+        skipPermit2Batch: true,
+        inputKind: "native_eth",
+        noErc20Approve: true,
+        quoteInputWei: quoteInputWei.toString(),
+        swapValueWei: valueWei.toString(),
+        uniswapCreateSwap: {
+          requestId: args.createSwapResponse.requestId,
+          gasFee: args.createSwapResponse.gasFee,
+          gasBuildSwap: {
+            useCustomGas: args.useCustomGas,
+            source: gasBuildSource,
+            baseGasUnits: swapBaseGasUnits.toString(),
+            ...estimateGasError != null && estimateGasError !== "" ? { estimateGasError } : {}
+          },
+          swap: {
+            to: args.createSwapResponse.swap.to,
+            value: args.createSwapResponse.swap.value,
+            dataNibbles: (() => {
+              const t = (args.createSwapResponse.swap.data ?? "").toString().trim();
+              return t.startsWith("0x") ? t.length - 2 : t.length;
+            })()
+          }
+        },
+        fullQuoteFromPermitSnapshot: args.fullQuoteSnapshot,
+        originalPurpose: args.purposeText
+      }
+    })
+  });
 }
 async function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args) {
-  const ph = (args.keyGen.pubkeyhex ?? "").trim();
-  if (!ph) throw new Error("keyGen pubKey (pubkeyhex) is required");
-  const keyList = args.keyGen.keylist ?? [];
-  const clientId = firstClientIdFromKeyGen(args.keyGen);
   const tokenIn = getAddress(args.tokenIn);
   const parsedInOut = parseUniswapQuoteClassicInOut(args.fullQuoteSnapshot);
   const quoteInputWei = parsedInOut?.inputWei;
@@ -1383,298 +1006,33 @@ async function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args) {
       return 0n;
     }
   })();
-  const ch = defineChain({
-    id: args.chainId,
-    name: "Destination",
-    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
-    rpcUrls: { default: { http: [args.rpcUrl] } }
-  });
-  const publicClient = createPublicClient({ chain: ch, transport: http(args.rpcUrl) });
-  const feeParams = await fetchChainFeeParams(args.rpcUrl, args.chainId);
-  const legacy = Boolean(args.chainDetail?.legacy) || !feeParams.isEip1559;
-  const latestBaseFeeWeiSkipBatch = !legacy ? (await publicClient.getBlock({ blockTag: "latest" })).baseFeePerGas ?? 0n : 0n;
-  const useCustomGas = args.useCustomGas;
-  const gasLimitConfig = useCustomGas && args.chainDetail?.gasLimit != null ? Number(args.chainDetail.gasLimit) : void 0;
-  const chainGasLimitRouter = args.chainDetail?.gasLimit != null && Number.isFinite(Number(args.chainDetail.gasLimit)) && Number(args.chainDetail.gasLimit) > 0 ? Number(args.chainDetail.gasLimit) : void 0;
-  const gasFeeMultiplier = useCustomGas && args.chainDetail?.gasMultiplier != null ? Number(args.chainDetail.gasMultiplier) : void 0;
-  const nonce = await publicClient.getTransactionCount({ address: args.executorAddress, blockTag: "pending" });
-  const proposalTxParamsBatch = [];
-  const messageHashes = [];
-  const messageRawBatch = [];
-  const approveMsgRawNo0x = approveData.startsWith("0x") ? approveData.slice(2) : approveData;
-  let firstTxFeePayload = {};
-  const approveGas = await publicClient.estimateGas({
-    to: tokenIn,
-    data: approveData,
-    value: 0n,
-    account: args.executorAddress
-  });
-  const gasLimit0 = useCustomGas ? gasLimitFromEstimateAndChainConfig(approveGas, gasLimitConfig) : approveGas;
-  const currentNonce0 = nonce;
-  if (legacy) {
-    let gasPriceWei = await publicClient.getGasPrice();
-    if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-      gasPriceWei = gasPriceWei * BigInt(100 + gasFeeMultiplier) / 100n;
-    }
-    if (useCustomGas && args.chainDetail?.gasPrice != null && args.chainDetail.gasPrice > 0) {
-      const configured = parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
-      if (configured > gasPriceWei) gasPriceWei = configured;
-    }
-    firstTxFeePayload = { txNonce: nonce, txGasLimit: gasLimit0.toString(), txGasPrice: gasPriceWei.toString() };
-    const ser0 = serializeTransaction({
-      type: "legacy",
-      to: tokenIn,
-      data: approveData,
-      value: 0n,
-      gas: gasLimit0,
-      gasPrice: gasPriceWei,
-      nonce: currentNonce0,
-      chainId: args.chainId
-    });
-    const h0 = keccak256(ser0);
-    messageHashes.push(h0.startsWith("0x") ? h0.slice(2) : h0);
-    messageRawBatch.push(ser0);
-    proposalTxParamsBatch.push({
-      nonce: currentNonce0,
-      gasLimit: gasLimit0.toString(),
-      txType: "legacy",
-      gasPrice: gasPriceWei.toString()
-    });
-  } else {
-    const fetchedBase = feeParams.baseFeeGwei ?? 0;
-    const fetchedPriority = feeParams.priorityFeeGwei ?? 0;
-    const configuredBase = useCustomGas && args.chainDetail?.baseFee != null ? Number(args.chainDetail.baseFee) : 0;
-    const configuredPriority = useCustomGas && args.chainDetail?.priorityFee != null ? Number(args.chainDetail.priorityFee) : 0;
-    const effectiveBaseFeeGwei = Math.max(fetchedBase, configuredBase);
-    const effectivePriorityFeeGwei = Math.max(fetchedPriority, configuredPriority);
-    const baseFeeMultiplierPct = useCustomGas && args.chainDetail?.baseFeeMultiplier != null ? Math.max(100, Number(args.chainDetail.baseFeeMultiplier)) : 100;
-    const baseComponentGwei = effectiveBaseFeeGwei * baseFeeMultiplierPct / 100;
-    const maxFeePerGasGwei = baseComponentGwei + effectivePriorityFeeGwei;
-    let maxPriorityFeePerGas = effectivePriorityFeeGwei > 0 ? parseGwei(gweiToDecimalString(effectivePriorityFeeGwei)) : parseGwei("1");
-    let maxFeePerGas = parseGwei(gweiToDecimalString(maxFeePerGasGwei));
-    if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-      maxPriorityFeePerGas = maxPriorityFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
-      maxFeePerGas = maxFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
-    }
-    ({ maxFeePerGas, maxPriorityFeePerGas } = alignEip1559FeesWithLatestBase(
-      maxFeePerGas,
-      maxPriorityFeePerGas,
-      latestBaseFeeWeiSkipBatch
-    ));
-    firstTxFeePayload = {
-      txNonce: nonce,
-      txGasLimit: gasLimit0.toString(),
-      txMaxFeePerGas: maxFeePerGas.toString(),
-      txMaxPriorityFeePerGas: maxPriorityFeePerGas.toString()
-    };
-    const ser0 = serializeTransaction({
-      type: "eip1559",
-      to: tokenIn,
-      data: approveData,
-      value: 0n,
-      gas: gasLimit0,
-      maxFeePerGas,
-      maxPriorityFeePerGas,
-      nonce: currentNonce0,
-      chainId: args.chainId
-    });
-    const h0 = keccak256(ser0);
-    messageHashes.push(h0.startsWith("0x") ? h0.slice(2) : h0);
-    messageRawBatch.push(ser0);
-    proposalTxParamsBatch.push({
-      nonce: currentNonce0,
-      gasLimit: gasLimit0.toString(),
-      txType: "eip1559",
-      maxFeePerGas: maxFeePerGas.toString(),
-      maxPriorityFeePerGas: maxPriorityFeePerGas.toString()
-    });
-  }
+  const swapRecord = args.swap;
+  const swapMsgIndex = usePermit2Triple ? 2 : 1;
+  let gasBuildSource = "rpcEstimate";
+  let estimateGasError;
+  let swapBaseGasUnits = DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK;
+  const steps = [
+    { to: tokenIn, data: approveData, value: 0n, fallbackGas: 100000n }
+  ];
   if (usePermit2Triple) {
     const permit2ApproveData = encodeFunctionData({
       abi: permit2ApproveRouterAbi,
       functionName: "approve",
       args: [tokenIn, permit2Spender, approveAmountWei, Number(expiration48)]
     });
-    const approveP2Gas = await publicClient.estimateGas({
-      to: PERMIT2_ADDRESS,
-      data: permit2ApproveData,
-      value: 0n,
-      account: args.executorAddress
-    });
-    const gasLimitP2 = useCustomGas ? gasLimitFromEstimateAndChainConfig(approveP2Gas, gasLimitConfig) : approveP2Gas;
-    const currentNonceP2 = nonce + 1;
-    if (legacy) {
-      let gasPriceWeiP2 = await publicClient.getGasPrice();
-      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-        gasPriceWeiP2 = gasPriceWeiP2 * BigInt(100 + gasFeeMultiplier) / 100n;
-      }
-      if (useCustomGas && args.chainDetail?.gasPrice != null && args.chainDetail.gasPrice > 0) {
-        const configured = parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
-        if (configured > gasPriceWeiP2) gasPriceWeiP2 = configured;
-      }
-      const serP2 = serializeTransaction({
-        type: "legacy",
-        to: PERMIT2_ADDRESS,
-        data: permit2ApproveData,
-        value: 0n,
-        gas: gasLimitP2,
-        gasPrice: gasPriceWeiP2,
-        nonce: currentNonceP2,
-        chainId: args.chainId
-      });
-      const hP2 = keccak256(serP2);
-      messageHashes.push(hP2.startsWith("0x") ? hP2.slice(2) : hP2);
-      messageRawBatch.push(serP2);
-      proposalTxParamsBatch.push({
-        nonce: currentNonceP2,
-        gasLimit: gasLimitP2.toString(),
-        txType: "legacy",
-        gasPrice: gasPriceWeiP2.toString()
-      });
-    } else {
-      const fetchedBaseP2 = feeParams.baseFeeGwei ?? 0;
-      const fetchedPriorityP2 = feeParams.priorityFeeGwei ?? 0;
-      const configuredBaseP2 = useCustomGas && args.chainDetail?.baseFee != null ? Number(args.chainDetail.baseFee) : 0;
-      const configuredPriorityP2 = useCustomGas && args.chainDetail?.priorityFee != null ? Number(args.chainDetail.priorityFee) : 0;
-      const effectiveBaseFeeGweiP2 = Math.max(fetchedBaseP2, configuredBaseP2);
-      const effectivePriorityFeeGweiP2 = Math.max(fetchedPriorityP2, configuredPriorityP2);
-      const baseFeeMultiplierPctP2 = useCustomGas && args.chainDetail?.baseFeeMultiplier != null ? Math.max(100, Number(args.chainDetail.baseFeeMultiplier)) : 100;
-      const baseComponentGweiP2 = effectiveBaseFeeGweiP2 * baseFeeMultiplierPctP2 / 100;
-      const maxFeePerGasGweiP2 = baseComponentGweiP2 + effectivePriorityFeeGweiP2;
-      let maxPriorityFeePerGasP2 = effectivePriorityFeeGweiP2 > 0 ? parseGwei(gweiToDecimalString(effectivePriorityFeeGweiP2)) : parseGwei("1");
-      let maxFeePerGasP2 = parseGwei(gweiToDecimalString(maxFeePerGasGweiP2));
-      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-        maxPriorityFeePerGasP2 = maxPriorityFeePerGasP2 * BigInt(100 + gasFeeMultiplier) / 100n;
-        maxFeePerGasP2 = maxFeePerGasP2 * BigInt(100 + gasFeeMultiplier) / 100n;
-      }
-      ({ maxFeePerGas: maxFeePerGasP2, maxPriorityFeePerGas: maxPriorityFeePerGasP2 } = alignEip1559FeesWithLatestBase(maxFeePerGasP2, maxPriorityFeePerGasP2, latestBaseFeeWeiSkipBatch));
-      const serP2 = serializeTransaction({
-        type: "eip1559",
-        to: PERMIT2_ADDRESS,
-        data: permit2ApproveData,
-        value: 0n,
-        gas: gasLimitP2,
-        maxFeePerGas: maxFeePerGasP2,
-        maxPriorityFeePerGas: maxPriorityFeePerGasP2,
-        nonce: currentNonceP2,
-        chainId: args.chainId
-      });
-      const hP2 = keccak256(serP2);
-      messageHashes.push(hP2.startsWith("0x") ? hP2.slice(2) : hP2);
-      messageRawBatch.push(serP2);
-      proposalTxParamsBatch.push({
-        nonce: currentNonceP2,
-        gasLimit: gasLimitP2.toString(),
-        txType: "eip1559",
-        maxFeePerGas: maxFeePerGasP2.toString(),
-        maxPriorityFeePerGas: maxPriorityFeePerGasP2.toString()
-      });
-    }
-  }
-  const swapRecord = args.swap;
-  const fromTradeApi = parseOptionalGasLimitString(swapRecord.gasLimit) ?? parseOptionalGasLimitString(swapRecord.gas);
-  let gasBuildSource = "rpcEstimate";
-  let estimateGasError;
-  let baseGasUnits1;
-  if (fromTradeApi != null && fromTradeApi > 0n) {
-    baseGasUnits1 = fromTradeApi;
-    gasBuildSource = "tradeApi";
-  } else {
-    try {
-      baseGasUnits1 = await publicClient.estimateGas({
-        to: toRouter,
-        data: dataHex,
-        value: valueWei,
-        account: args.executorAddress
-      });
-      gasBuildSource = "rpcEstimate";
-    } catch (e) {
-      estimateGasError = e instanceof Error ? e.message : String(e);
-      const minRouterGas = 500000n;
-      if (useCustomGas) {
-        const cfg = args.chainDetail?.gasLimit != null ? parseOptionalGasLimitString(String(args.chainDetail.gasLimit)) : null;
-        if (cfg != null && cfg >= minRouterGas) {
-          baseGasUnits1 = cfg;
-        } else {
-          baseGasUnits1 = DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK;
-        }
-      } else {
-        baseGasUnits1 = DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK;
-      }
-      gasBuildSource = "estimateFailedFallback";
-    }
-  }
-  const gasLimit1 = routerSwapGasLimitFromEstimate(baseGasUnits1, chainGasLimitRouter);
-  const currentNonce1 = nonce + (usePermit2Triple ? 2 : 1);
-  if (legacy) {
-    let gasPriceWei1 = await publicClient.getGasPrice();
-    if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-      gasPriceWei1 = gasPriceWei1 * BigInt(100 + gasFeeMultiplier) / 100n;
-    }
-    if (useCustomGas && args.chainDetail?.gasPrice != null && args.chainDetail.gasPrice > 0) {
-      const configured = parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
-      if (configured > gasPriceWei1) gasPriceWei1 = configured;
-    }
-    const ser1 = serializeTransaction({
-      type: "legacy",
-      to: toRouter,
-      data: dataHex,
-      value: valueWei,
-      gas: gasLimit1,
-      gasPrice: gasPriceWei1,
-      nonce: currentNonce1,
-      chainId: args.chainId
-    });
-    const h1 = keccak256(ser1);
-    messageHashes.push(h1.startsWith("0x") ? h1.slice(2) : h1);
-    messageRawBatch.push(ser1);
-    proposalTxParamsBatch.push({
-      nonce: currentNonce1,
-      gasLimit: gasLimit1.toString(),
-      txType: "legacy",
-      gasPrice: gasPriceWei1.toString()
-    });
-  } else {
-    const fetchedBase1 = feeParams.baseFeeGwei ?? 0;
-    const fetchedPriority1 = feeParams.priorityFeeGwei ?? 0;
-    const configuredBase1 = useCustomGas && args.chainDetail?.baseFee != null ? Number(args.chainDetail.baseFee) : 0;
-    const configuredPriority1 = useCustomGas && args.chainDetail?.priorityFee != null ? Number(args.chainDetail.priorityFee) : 0;
-    const effectiveBaseFeeGwei1 = Math.max(fetchedBase1, configuredBase1);
-    const effectivePriorityFeeGwei1 = Math.max(fetchedPriority1, configuredPriority1);
-    const baseFeeMultiplierPct1 = useCustomGas && args.chainDetail?.baseFeeMultiplier != null ? Math.max(100, Number(args.chainDetail.baseFeeMultiplier)) : 100;
-    const baseComponentGwei1 = effectiveBaseFeeGwei1 * baseFeeMultiplierPct1 / 100;
-    const maxFeePerGasGwei1 = baseComponentGwei1 + effectivePriorityFeeGwei1;
-    let maxPriorityFeePerGas1 = effectivePriorityFeeGwei1 > 0 ? parseGwei(gweiToDecimalString(effectivePriorityFeeGwei1)) : parseGwei("1");
-    let maxFeePerGas1 = parseGwei(gweiToDecimalString(maxFeePerGasGwei1));
-    if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
-      maxPriorityFeePerGas1 = maxPriorityFeePerGas1 * BigInt(100 + gasFeeMultiplier) / 100n;
-      maxFeePerGas1 = maxFeePerGas1 * BigInt(100 + gasFeeMultiplier) / 100n;
-    }
-    ({ maxFeePerGas: maxFeePerGas1, maxPriorityFeePerGas: maxPriorityFeePerGas1 } = alignEip1559FeesWithLatestBase(maxFeePerGas1, maxPriorityFeePerGas1, latestBaseFeeWeiSkipBatch));
-    const ser1 = serializeTransaction({
-      type: "eip1559",
-      to: toRouter,
-      data: dataHex,
-      value: valueWei,
-      gas: gasLimit1,
-      maxFeePerGas: maxFeePerGas1,
-      maxPriorityFeePerGas: maxPriorityFeePerGas1,
-      nonce: currentNonce1,
-      chainId: args.chainId
-    });
-    const h1 = keccak256(ser1);
-    messageHashes.push(h1.startsWith("0x") ? h1.slice(2) : h1);
-    messageRawBatch.push(ser1);
-    proposalTxParamsBatch.push({
-      nonce: currentNonce1,
-      gasLimit: gasLimit1.toString(),
-      txType: "eip1559",
-      maxFeePerGas: maxFeePerGas1.toString(),
-      maxPriorityFeePerGas: maxPriorityFeePerGas1.toString()
-    });
+    steps.push({ to: PERMIT2_ADDRESS, data: permit2ApproveData, value: 0n, fallbackGas: 100000n });
   }
-  const swapMsgIndex = usePermit2Triple ? 2 : 1;
-  const audit = {
+  steps.push({
+    to: toRouter,
+    data: dataHex,
+    value: valueWei,
+    routerSwap: true,
+    fallbackGas: DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK
+  });
+  const swapStepIndex = steps.length - 1;
+  const approveMsgRawNo0x = approveData.startsWith("0x") ? approveData.slice(2) : approveData;
+  const purposeSuffix = usePermit2Triple ? "Uniswap V4: 3-tx batch (classic allowance) \u2014 (1) ERC-20 approve allowance hub, (2) hub approve(Universal Router), (3) swap (Trade /swap)." : "Uniswap V4: 2-tx batch (classic allowance, dispatcher) \u2014 (1) ERC-20 approve swap.to (dispatcher pulls tokens), (2) swap (Trade /swap).";
+  const buildSwapAudit = () => ({
     skipPermit2Batch: true,
     approvalPath: usePermit2Triple ? "permit2_triple" : "dispatcher",
     approveAmount: {
@@ -1688,9 +1046,9 @@ async function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args) {
       requestId: args.createSwapResponse.requestId,
       gasFee: args.createSwapResponse.gasFee,
       gasBuildSwap: {
-        useCustomGas,
+        useCustomGas: args.useCustomGas,
         source: gasBuildSource,
-        baseGasUnits: baseGasUnits1.toString(),
+        baseGasUnits: swapBaseGasUnits.toString(),
         ...estimateGasError != null && estimateGasError !== "" ? { estimateGasError } : {}
       },
       swap: {
@@ -1732,92 +1090,98 @@ async function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args) {
         note: "Dispatcher pulls via ERC20.transferFrom(user, universalRouter, amount); allowance must be on swap.to (see cast trace TRANSFER_FROM_FAILED when only the hub is approved)."
       }
     }
-  };
-  const batchMeta = [
-    {
-      destinationAddress: tokenIn,
-      signatureText: JSON.stringify({
-        kind: "UniswapV4",
-        name: "ERC20.approve",
-        to: usePermit2Triple ? "allowance hub" : "dispatcher(swap.to)",
-        function: "approve(address spender, uint256 amount)",
-        spender: erc20ApproveSpender,
-        amountWei: approveAmountWei.toString()
-      }),
-      evm: {
-        type: usePermit2Triple ? "uniswap_v4_skip_permit2_approve" : "uniswap_v4_skip_permit2_dispatcher_approve",
-        version: 1,
-        chainId: String(args.chainId),
-        ...usePermit2Triple ? { permit2: PERMIT2_ADDRESS } : { dispatcher: toRouter }
+  });
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: args.executorAddress,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps,
+    purposeSuffix,
+    firstMsgRawNo0x: approveMsgRawNo0x,
+    destinationAddress: tokenIn,
+    payableValueWei: valueWei > 0n ? valueWei : void 0,
+    estimateGasForStep: async ({ step, index, publicClient, executor }) => {
+      if (index !== swapStepIndex) {
+        return publicClient.estimateGas({
+          to: step.to,
+          data: step.data,
+          value: step.value,
+          account: executor
+        });
       }
-    }
-  ];
-  if (usePermit2Triple) {
-    batchMeta.push({
-      destinationAddress: PERMIT2_ADDRESS,
-      signatureText: JSON.stringify({
-        kind: "UniswapV4",
-        name: "AllowanceHub.approve",
-        function: "approve(address token, address spender, uint160 amount, uint48 expiration)",
-        token: tokenIn,
-        spender: permit2Spender,
-        amountWei: approveAmountWei.toString(),
-        expiration: expiration48.toString()
-      }),
-      evm: {
-        type: "uniswap_v4_skip_permit2_permit2_approve",
-        version: 1,
-        chainId: String(args.chainId),
-        permit2: PERMIT2_ADDRESS,
-        permit2Spender
+      const r = await estimateUniswapRouterSwapGas({
+        publicClient,
+        executor,
+        to: toRouter,
+        data: dataHex,
+        value: valueWei,
+        swapRecord,
+        useCustomGas: args.useCustomGas,
+        chainDetail: args.chainDetail
+      });
+      gasBuildSource = r.source;
+      estimateGasError = r.estimateGasError;
+      swapBaseGasUnits = r.baseGasUnits;
+      return r.baseGasUnits;
+    },
+    buildBatchMeta: ({ index }) => {
+      if (index === 0) {
+        return {
+          signatureText: JSON.stringify({
+            kind: "UniswapV4",
+            name: "ERC20.approve",
+            to: usePermit2Triple ? "allowance hub" : "dispatcher(swap.to)",
+            function: "approve(address spender, uint256 amount)",
+            spender: erc20ApproveSpender,
+            amountWei: approveAmountWei.toString()
+          }),
+          evm: {
+            type: usePermit2Triple ? "uniswap_v4_skip_permit2_approve" : "uniswap_v4_skip_permit2_dispatcher_approve",
+            version: 1,
+            chainId: String(args.chainId),
+            ...usePermit2Triple ? { permit2: PERMIT2_ADDRESS } : { dispatcher: toRouter }
+          }
+        };
       }
-    });
-  }
-  batchMeta.push({
-    destinationAddress: toRouter,
-    signatureText: JSON.stringify({
-      kind: "UniswapV4",
-      name: "UniversalRouter.execute",
-      note: `Calldata from Trade API POST /swap; signed tx hash in messageHashes[${swapMsgIndex}].`
-    }),
-    evm: { type: "uniswap_v4_swap_tx", version: 1, chainId: String(args.chainId) },
-    uniswapV4: audit
-  });
-  const extraPayload = { batchMeta };
-  if (useCustomGas) {
-    const snap = args.customGasChainDetails;
-    if (snap && typeof snap === "object" && !Array.isArray(snap) && Object.keys(snap).length > 0) {
-      extraPayload.customGasChainDetails = snap;
+      if (usePermit2Triple && index === 1) {
+        return {
+          signatureText: JSON.stringify({
+            kind: "UniswapV4",
+            name: "AllowanceHub.approve",
+            function: "approve(address token, address spender, uint160 amount, uint48 expiration)",
+            token: tokenIn,
+            spender: permit2Spender,
+            amountWei: approveAmountWei.toString(),
+            expiration: expiration48.toString()
+          }),
+          evm: {
+            type: "uniswap_v4_skip_permit2_permit2_approve",
+            version: 1,
+            chainId: String(args.chainId),
+            permit2: PERMIT2_ADDRESS,
+            permit2Spender
+          }
+        };
+      }
+      return {
+        signatureText: JSON.stringify({
+          kind: "UniswapV4",
+          name: "UniversalRouter.execute",
+          note: `Calldata from Trade API POST /swap; signed tx hash in messageHashes[${swapMsgIndex}].`
+        }),
+        evm: { type: "uniswap_v4_swap_tx", version: 1, chainId: String(args.chainId) },
+        uniswapV4: buildSwapAudit()
+      };
     }
-  }
-  const extraJSON = JSON.stringify(extraPayload);
-  const firstSigText = batchMeta[0].signatureText;
-  const bodyForSign = {
-    keyList,
-    pubKey: ph,
-    msgHash: messageHashes[0],
-    msgRaw: approveMsgRawNo0x,
-    messageHashes,
-    messageRawBatch,
-    destinationChainID: String(args.chainId),
-    destinationAddress: tokenIn,
-    extraJSON,
-    signatureText: firstSigText,
-    purpose: (() => {
-      const t = args.purposeText.trim();
-      const batchDesc = usePermit2Triple ? "Uniswap V4: 3-tx batch (classic allowance) \u2014 (1) ERC-20 approve allowance hub, (2) hub approve(Universal Router), (3) swap (Trade /swap)." : "Uniswap V4: 2-tx batch (classic allowance, dispatcher) \u2014 (1) ERC-20 approve swap.to (dispatcher pulls tokens), (2) swap (Trade /swap).";
-      return (t ? `${t}
-
-` : "") + batchDesc;
-    })(),
-    ...firstTxFeePayload,
-    proposalTxParams: proposalTxParamsBatch
-  };
-  if (valueWei > 0n) {
-    bodyForSign.value = valueWei.toString();
-  }
-  if (clientId) bodyForSign.clientId = clientId;
-  return { bodyForSign, messageToSign: JSON.stringify(bodyForSign) };
+  });
 }
 
 // src/protocols/evm/uniswap-v4/swap.ts
@@ -2246,986 +1610,10 @@ var curveDao = {
   loadSession: loadFullCurveSessionForRpc
 };
 
-// src/agent/commonParamDocs.ts
-var EVM_COMMON_PARAM_DOCS = {
-  keyGen: {
-    type: "object",
-    required: true,
-    description: "MPC key slice: { pubkeyhex: string (required), keylist: string[], ClientKeys?: Record<string,string> }. Used for pubKey/keyList on POST /multiSignRequest."
-  },
-  purposeText: {
-    type: "string",
-    required: true,
-    description: "Human-readable purpose for the sign request. Stored in bodyForSign.purpose (may be appended with an automatic batch suffix)."
-  },
-  useCustomGas: {
-    type: "boolean",
-    required: true,
-    description: "When true, apply chain gas settings from chainDetail / customGasChainDetails instead of raw RPC estimates only."
-  },
-  chainId: {
-    type: "number",
-    required: true,
-    description: "EVM chain id (decimal). Becomes destinationChainID on the sign request."
-  },
-  rpcUrl: {
-    type: "string",
-    required: true,
-    description: "HTTPS JSON-RPC URL for gas estimation, nonce, and allowance reads."
-  },
-  executorAddress: {
-    type: "address",
-    required: true,
-    description: "MPC wallet address (from keyGen ethereumaddress) \u2014 tx sender for estimates and approvals."
-  },
-  chainDetail: {
-    type: "object",
-    required: true,
-    description: "Optional gas config: { legacy?, gasLimit?, gasMultiplier?, gasPrice?, baseFee?, priorityFee?, baseFeeMultiplier? }."
-  },
-  customGasChainDetails: {
-    type: "object",
-    required: false,
-    description: "Snapshot written to extraJSON.customGasChainDetails when useCustomGas is true."
-  }
-};
-var MULTISIGN_OUTPUT_DOC = {
-  description: "Unsigned mpc-auth multiSignRequest payload. The caller must sign messageToSign (MetaMask personal_sign or Ed25519) and POST { ...bodyForSign, clientSig, signedMessage: messageToSign } to /multiSignRequest.",
-  fields: {
-    bodyForSign: {
-      type: "object",
-      description: "POST body fields without clientSig: keyList, pubKey, msgHash, msgRaw, destinationChainID, purpose, extraJSON, proposalTxParams (batch), messageHashes/messageRawBatch when N>1 txs."
-    },
-    messageToSign: {
-      type: "string",
-      description: "JSON.stringify(bodyForSign) \u2014 exact string to sign before adding clientSig."
-    }
-  }
-};
-var MANAGEMENT_SIG_DOC = {
-  description: "Management POST bodies embed NodeMgtKeySig: { nonce, clientSig, nodeKey }. Sign JSON with clientSig cleared; POST with clientSig set to the Ed25519 128-hex or EIP-191 signature. Legacy Nonce/Sig/sig field names are not accepted.",
-  fields: {
-    nonce: {
-      type: "number",
-      description: "From GET /getPublicMgtKeyNonce (Ed25519) or GET /getNodeMgtKeyNonce (Ethereum NodeMgtKey)."
-    },
-    clientSig: {
-      type: "string",
-      description: "Management signature; empty string in the message to sign."
-    },
-    nodeKey: {
-      type: "string",
-      description: "Required. 128-hex MPC node id from GET /getNodeKey (no 0x prefix)."
-    }
-  },
-  helpers: {
-    managementSigFields: "Base envelope with clientSig cleared.",
-    buildManagementPostBody: "Spread managementSigFields then endpoint fields.",
-    messageToSignManagementBody: "Canonical JSON string to sign.",
-    withManagementClientSig: "Attach signature to POST body.",
-    fetchNodeKey: "GET /getNodeKey via nodeFetchWithReadAuth.",
-    fetchManagementNonce: "GET nonce for Ed25519 or Ethereum management key."
-  }
-};
-function zodSchemaToMcpJsonSchema(schema) {
-  const raw = zodToJsonSchema(schema, {
-    target: "openApi3",
-    $refStrategy: "none"
-  });
-  if (raw.type === "object" || raw.type === "array" || raw.type === "string") {
-    const { $schema: _s, ...rest } = raw;
-    return rest;
-  }
-  const defs = raw.definitions;
-  if (defs) {
-    const first = Object.values(defs)[0];
-    if (first?.type) {
-      const { $schema: _s, ...rest } = first;
-      return rest;
-    }
-  }
-  return raw;
-}
-var evmAddressSchema = z.string().min(1).describe("EVM address (0x-prefixed, 40 hex nibbles)");
-var keyGenSchema = z.object({
-  pubkeyhex: z.string().min(1).describe("MPC secp256k1 public key hex (required for multiSignRequest pubKey)"),
-  keylist: z.array(z.string()).optional().describe("Key list on the sign request"),
-  ClientKeys: z.record(z.string()).optional().describe("Optional client key map from keyGen")
-}).describe(
-  "MPC key slice: { pubkeyhex, keylist?, ClientKeys? }. Used for pubKey/keyList on POST /multiSignRequest."
-);
-var chainDetailSchema = z.object({
-  legacy: z.boolean().optional(),
-  gasLimit: z.number().optional(),
-  gasMultiplier: z.number().optional(),
-  gasPrice: z.number().optional(),
-  baseFee: z.number().optional(),
-  priorityFee: z.number().optional(),
-  baseFeeMultiplier: z.number().optional()
-}).passthrough().describe(
-  "Optional gas config: { legacy?, gasLimit?, gasMultiplier?, gasPrice?, baseFee?, priorityFee?, baseFeeMultiplier? }."
-);
-var evmMultisignCommonInputSchema = z.object({
-  keyGen: keyGenSchema,
-  purposeText: z.string().min(1).describe(
-    "Human-readable purpose for the sign request. Stored in bodyForSign.purpose (may be appended with an automatic batch suffix)."
-  ),
-  useCustomGas: z.boolean().describe(
-    "When true, apply chain gas settings from chainDetail / customGasChainDetails instead of raw RPC estimates only."
-  ),
-  chainId: z.number().int().positive().describe("EVM chain id (decimal). Becomes destinationChainID on the sign request."),
-  rpcUrl: z.string().min(1).describe("HTTPS JSON-RPC URL for gas estimation, nonce, and allowance reads."),
-  executorAddress: evmAddressSchema.describe(
-    "MPC wallet address (from keyGen ethereumaddress) \u2014 tx sender for estimates and approvals."
-  ),
-  chainDetail: chainDetailSchema,
-  customGasChainDetails: z.record(z.unknown()).optional().describe("Snapshot written to extraJSON.customGasChainDetails when useCustomGas is true.")
-});
-var multisignOutputSchema = z.object({
-  bodyForSign: z.record(z.unknown()).describe(
-    "POST body fields without clientSig: keyList, pubKey, msgHash, msgRaw, destinationChainID, purpose, extraJSON, proposalTxParams (batch), messageHashes/messageRawBatch when N>1 txs."
-  ),
-  messageToSign: z.string().describe("JSON.stringify(bodyForSign) \u2014 exact string to sign before adding clientSig.")
-}).describe(
-  "Unsigned mpc-auth multiSignRequest payload. Sign messageToSign and POST { ...bodyForSign, clientSig, signedMessage } to /multiSignRequest."
-);
-var jsonObjectSchema = z.record(z.unknown());
-var uniswapQuoteTradeTypeSchema = z.enum(["EXACT_INPUT", "EXACT_OUTPUT"]);
-var mcpUniswapV4QuoteInputSchema = z.object({
-  type: uniswapQuoteTradeTypeSchema.describe("EXACT_INPUT or EXACT_OUTPUT"),
-  amount: z.string().min(1).describe("Amount in token-in base units (wei string for ERC-20)"),
-  tokenIn: z.string().min(1).describe("Input token; 0x0 for native ETH"),
-  tokenOut: z.string().min(1).describe("Output token address"),
-  chainId: z.union([z.number().int().positive(), z.string().min(1)]).describe("tokenInChainId / same-chain default"),
-  uniswapApiKey: z.string().min(1).describe("Uniswap Trade API x-api-key"),
-  swapper: evmAddressSchema.optional().describe("MPC executor; omit if keyGen + managementNodeUrl provided"),
-  slippage: z.union([z.number(), z.string()]).optional().describe("Slippage percent; omit for API auto slippage"),
-  keyGen: z.string().optional().describe("KeyGen id \u2014 resolves swapper via GET /getKeyGenResultById when swapper omitted"),
-  managementNodeUrl: z.string().min(1).optional().describe("MPC node base URL; required with keyGen when swapper is omitted"),
-  tokenInChainId: z.union([z.number(), z.string()]).optional(),
-  tokenOutChainId: z.union([z.number(), z.string()]).optional(),
-  permit2Disabled: z.boolean().optional(),
-  baseUrl: z.string().optional(),
-  universalRouterVersion: z.string().optional()
-});
-var mcpUniswapV4QuoteOutputSchema = jsonObjectSchema.describe(
-  "Full Uniswap POST /quote JSON (includes nested quote object with input/output amounts)."
-);
-var mcpUniswapV4CreateSwapInputSchema = z.object({
-  uniswapApiKey: z.string().min(1).describe("Uniswap Trade API key"),
-  fullQuoteFromPermit: jsonObjectSchema.describe("Full quote JSON from ctm_uniswap_v4_quote"),
-  swapTransactionDeadlineUnix: z.number().int().positive().optional().describe("On-chain deadline unix seconds; default ~30 min from now"),
-  useServerProxy: z.boolean().optional().describe("Set false in Node/agents; true only in browser via Next API route"),
-  baseUrl: z.string().optional(),
-  universalRouterVersion: z.string().optional()
-});
-var mcpUniswapV4CreateSwapOutputSchema = z.object({
-  swap: jsonObjectSchema.describe("Universal Router tx: { to, data, value, gasLimit? }"),
-  requestId: z.string().optional(),
-  gasFee: z.string().optional()
-}).passthrough().describe("{ swap: TransactionRequest, requestId?, gasFee? }");
-var swapTxRequestSchema = jsonObjectSchema.describe("swap field from create_swap response (to, data, value)");
-var mcpUniswapV4BuildSwapMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  tokenIn: evmAddressSchema.describe("Token in; 0x0 for native ETH"),
-  swap: swapTxRequestSchema,
-  createSwapResponse: z.object({
-    swap: swapTxRequestSchema,
-    requestId: z.string().optional(),
-    gasFee: z.string().optional()
-  }).passthrough().describe("Full create_swap response"),
-  fullQuoteSnapshot: jsonObjectSchema.describe("Quote JSON used for the swap"),
-  swapDeadlineUnix: z.number().describe("Same deadline passed to create_swap"),
-  slippagePercent: z.number().optional().describe("Extra approve headroom for EXACT_OUTPUT")
-});
-var mcpCurveDaoBuildSwapMultisignInputSchema = evmMultisignCommonInputSchema.extend({
-  tokenIn: evmAddressSchema.describe("ERC-20 sold (native in uses WETH path in UI)"),
-  tokenOut: z.string().min(1).describe("Output token or 0xeeee\u2026 native placeholder"),
-  amountHuman: z.string().min(1).describe("Human-readable amount of tokenIn"),
-  slippagePercent: z.number().gt(0).lt(100).describe("Slippage 0\u2013100 exclusive")
-});
-function mcpMultisignInput(fields) {
-  return evmMultisignCommonInputSchema.extend(fields);
-}
-var mcpLidoSubmitInputSchema = mcpMultisignInput({
-  valueWei: z.string().min(1).describe("ETH to stake (wei decimal string)"),
-  referral: evmAddressSchema.optional()
-});
-var mcpLidoRequestWithdrawalsInputSchema = mcpMultisignInput({
-  stEthAmountsWei: z.array(z.string()).min(1).describe("stETH amounts per withdrawal request (wei strings)")
-});
-var mcpLidoClaimWithdrawalInputSchema = mcpMultisignInput({
-  requestId: z.union([z.string(), z.number()]).describe("Withdrawal queue request id")
-});
-var mcpLidoWrapStEthInputSchema = mcpMultisignInput({
-  stEthAmountWei: z.string().min(1)
-});
-var mcpLidoUnwrapWstEthInputSchema = mcpMultisignInput({
-  wstEthAmountWei: z.string().min(1)
-});
-var mcpEthenaStakeInputSchema = mcpMultisignInput({
-  usdeAmountHuman: z.string().min(1),
-  susdeVault: evmAddressSchema.optional()
-});
-var mcpEthenaRedeemInputSchema = mcpMultisignInput({
-  susdeSharesHuman: z.string().min(1),
-  susdeVault: evmAddressSchema.optional()
-});
-var mcpEthenaCooldownInputSchema = mcpMultisignInput({
-  susdeSharesHuman: z.string().min(1),
-  susdeVault: evmAddressSchema.optional()
-});
-var mcpEthenaClaimInputSchema = mcpMultisignInput({
-  susdeVault: evmAddressSchema.optional()
-});
-var mcpMapleDepositInputSchema = mcpMultisignInput({
-  syrupRouter: evmAddressSchema,
-  pool: evmAddressSchema,
-  asset: evmAddressSchema,
-  amountHuman: z.string().min(1),
-  authorizeSig: jsonObjectSchema.optional()
-});
-var mcpMapleRequestRedeemInputSchema = mcpMultisignInput({
-  pool: evmAddressSchema,
-  sharesHuman: z.string().min(1),
-  receiver: evmAddressSchema
-});
-var mcpSkyLockstakeStakeInputSchema = mcpMultisignInput({
-  skyAmountHuman: z.string().min(1),
-  usdsDrawHuman: z.string().optional(),
-  farmRef: z.string().optional()
-});
-var mcpSkyLockstakeDrawInputSchema = mcpMultisignInput({
-  usdsAmountHuman: z.string().min(1),
-  urnIndex: z.number().int().nonnegative()
-});
-var mcpSkyLockstakeWipeInputSchema = mcpMultisignInput({
-  usdsAmountHuman: z.string().min(1),
-  urnIndex: z.number().int().nonnegative()
-});
-var mcpSkyLockstakeCloseInputSchema = mcpMultisignInput({
-  urnIndex: z.number().int().nonnegative()
-});
-var mcpSkyLockstakeGetRewardInputSchema = mcpMultisignInput({
-  urnIndex: z.number().int().nonnegative()
-});
-var mcpSkySusdsDepositInputSchema = mcpMultisignInput({
-  usdsAmountHuman: z.string().min(1)
-});
-var mcpSkySusdsRedeemInputSchema = mcpMultisignInput({
-  sharesHuman: z.string().min(1)
-});
-var mcpAaveV4DepositInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
-  amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
-});
-var mcpAaveV4WithdrawInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
-  amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
-});
-var mcpAaveV4BorrowInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
-  amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
-});
-var mcpAaveV4RepayInputSchema = mcpMultisignInput({
-  spoke: evmAddressSchema,
-  underlying: evmAddressSchema,
-  amountHuman: z.string().min(1),
-  marketId: z.string().min(1)
-});
-var mcpEulerV2IsolatedLendInputSchema = mcpMultisignInput({
-  vault: evmAddressSchema,
-  assetAmountHuman: z.string().min(1)
-});
-var mcpEulerV2IsolatedBorrowInputSchema = mcpMultisignInput({
-  vault: evmAddressSchema,
-  collateralAsset: evmAddressSchema,
-  borrowAsset: evmAddressSchema,
-  collateralAmountHuman: z.string().min(1),
-  loopBorrowWeis: z.array(z.string()).min(1)
-});
-var mcpEulerV2VaultWithdrawInputSchema = mcpMultisignInput({
-  vault: evmAddressSchema,
-  sharesHuman: z.string().min(1)
-});
-var mcpEulerV2BorrowRepayInputSchema = mcpMultisignInput({
-  vault: evmAddressSchema,
-  amountHuman: z.string().min(1)
-});
-var mcpEulerV2CollateralDepositInputSchema = mcpMultisignInput({
-  vault: evmAddressSchema,
-  collateralAsset: evmAddressSchema,
-  amountHuman: z.string().min(1)
-});
-var mcpEulerV2CollateralWithdrawInputSchema = mcpMultisignInput({
-  vault: evmAddressSchema,
-  collateralAsset: evmAddressSchema,
-  amountHuman: z.string().min(1)
-});
-
-// src/agent/mcpProtocolTools.ts
-function defineProtocolMcpTool(def) {
-  return {
-    ...def,
-    outputZod: multisignOutputSchema,
-    inputSchema: zodSchemaToMcpJsonSchema(def.inputZod),
-    outputSchema: zodSchemaToMcpJsonSchema(multisignOutputSchema),
-    parseInput: (data) => def.inputZod.parse(data),
-    parseOutput: (data) => multisignOutputSchema.parse(data)
-  };
-}
-var MCP_PROTOCOL_TOOL_DEFINITIONS = [
-  defineProtocolMcpTool({
-    name: "ctm_lido_build_submit_multisign",
-    actionId: "lido.submit",
-    protocolId: "lido",
-    chainCategory: "evm",
-    description: "Build mpc-auth multiSignRequest for Lido ETH stake (submit).",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoSubmit" },
-    inputZod: mcpLidoSubmitInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_lido_build_request_withdrawals_multisign",
-    actionId: "lido.request-withdrawals",
-    protocolId: "lido",
-    chainCategory: "evm",
-    description: "Build batch for Lido withdrawal queue (approve + requestWithdrawals).",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoRequestWithdrawals" },
-    inputZod: mcpLidoRequestWithdrawalsInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_lido_build_claim_withdrawal_multisign",
-    actionId: "lido.claim-withdrawal",
-    protocolId: "lido",
-    chainCategory: "evm",
-    description: "Build tx for Lido claimWithdrawal.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoClaimWithdrawal" },
-    inputZod: mcpLidoClaimWithdrawalInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_lido_build_wrap_steth_multisign",
-    actionId: "lido.wrap-steth",
-    protocolId: "lido",
-    chainCategory: "evm",
-    description: "Build batch for wstETH wrap.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoWrapStEth" },
-    inputZod: mcpLidoWrapStEthInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_lido_build_unwrap_wsteth_multisign",
-    actionId: "lido.unwrap-wsteth",
-    protocolId: "lido",
-    chainCategory: "evm",
-    description: "Build tx for wstETH unwrap.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/lido", exportName: "buildEvmMultisignBodyLidoUnwrapWstEth" },
-    inputZod: mcpLidoUnwrapWstEthInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_ethena_build_stake_multisign",
-    actionId: "ethena.stake-usde",
-    protocolId: "ethena",
-    chainCategory: "evm",
-    description: "Build batch: USDe approve + sUSDe deposit.",
-    prerequisites: ["keyGen", "executorAddress", "Ethereum mainnet RPC"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaUsdeStakeToSusde" },
-    inputZod: mcpEthenaStakeInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_ethena_build_redeem_multisign",
-    actionId: "ethena.redeem-susde",
-    protocolId: "ethena",
-    chainCategory: "evm",
-    description: "Build sUSDe redeem when cooldown is off.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaSusdeRedeemToUsde" },
-    inputZod: mcpEthenaRedeemInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_ethena_build_cooldown_multisign",
-    actionId: "ethena.cooldown-shares",
-    protocolId: "ethena",
-    chainCategory: "evm",
-    description: "Build sUSDe cooldownShares batch step.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaSusdeCooldownShares" },
-    inputZod: mcpEthenaCooldownInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_ethena_build_claim_multisign",
-    actionId: "ethena.claim-unstake",
-    protocolId: "ethena",
-    chainCategory: "evm",
-    description: "Build unstake claim after cooldown.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/ethena", exportName: "buildEvmMultisignBodyEthenaUnstakeClaim" },
-    inputZod: mcpEthenaClaimInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_maple_build_deposit_multisign",
-    actionId: "maple-syrup.deposit",
-    protocolId: "maple-syrup",
-    chainCategory: "evm",
-    description: "Build Maple Syrup router deposit batch.",
-    prerequisites: ["keyGen", "executorAddress", "router + pool addresses"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/maple", exportName: "buildEvmMultisignBodyMapleSyrupDeposit" },
-    inputZod: mcpMapleDepositInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_maple_build_request_redeem_multisign",
-    actionId: "maple-syrup.request-redeem",
-    protocolId: "maple-syrup",
-    chainCategory: "evm",
-    description: "Build Maple PoolV2 requestRedeem batch.",
-    prerequisites: ["keyGen", "executorAddress", "pool address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/maple", exportName: "buildEvmMultisignBodyMaplePoolRequestRedeem" },
-    inputZod: mcpMapleRequestRedeemInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_sky_build_lockstake_stake_multisign",
-    actionId: "sky.lockstake-stake",
-    protocolId: "sky",
-    chainCategory: "evm",
-    description: "Build Sky Lockstake open/stake batch.",
-    prerequisites: ["keyGen", "executorAddress", "Ethereum mainnet RPC"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeStakePositionBatch" },
-    inputZod: mcpSkyLockstakeStakeInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_sky_build_lockstake_draw_multisign",
-    actionId: "sky.lockstake-draw",
-    protocolId: "sky",
-    chainCategory: "evm",
-    description: "Build Lockstake draw (borrow USDS).",
-    prerequisites: ["keyGen", "executorAddress", "open urn"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeDrawBatch" },
-    inputZod: mcpSkyLockstakeDrawInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_sky_build_lockstake_wipe_multisign",
-    actionId: "sky.lockstake-wipe",
-    protocolId: "sky",
-    chainCategory: "evm",
-    description: "Build Lockstake repay/wipe batch.",
-    prerequisites: ["keyGen", "executorAddress", "urn index"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeWipeBatch" },
-    inputZod: mcpSkyLockstakeWipeInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_sky_build_lockstake_close_multisign",
-    actionId: "sky.lockstake-close",
-    protocolId: "sky",
-    chainCategory: "evm",
-    description: "Build Lockstake close position batch.",
-    prerequisites: ["keyGen", "executorAddress", "urn index"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeCloseBatch" },
-    inputZod: mcpSkyLockstakeCloseInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_sky_build_lockstake_get_reward_multisign",
-    actionId: "sky.lockstake-get-reward",
-    protocolId: "sky",
-    chainCategory: "evm",
-    description: "Build Lockstake getReward batch.",
-    prerequisites: ["keyGen", "executorAddress", "urn index"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/sky", exportName: "buildSkyLockstakeGetRewardBatch" },
-    inputZod: mcpSkyLockstakeGetRewardInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_sky_build_susds_deposit_multisign",
-    actionId: "sky.susds-deposit",
-    protocolId: "sky",
-    chainCategory: "evm",
-    description: "Build USDS \u2192 sUSDS ERC-4626 deposit batch.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/sky", exportName: "buildSkySusdsDepositFromUsdsBatch" },
-    inputZod: mcpSkySusdsDepositInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_sky_build_susds_redeem_multisign",
-    actionId: "sky.susds-redeem",
-    protocolId: "sky",
-    chainCategory: "evm",
-    description: "Build sUSDS redeem to USDS batch.",
-    prerequisites: ["keyGen", "executorAddress", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/sky", exportName: "buildSkySusdsRedeemToUsdsBatch" },
-    inputZod: mcpSkySusdsRedeemInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_aave_v4_build_deposit_multisign",
-    actionId: "aave-v4.deposit",
-    protocolId: "aave-v4",
-    chainCategory: "evm",
-    description: "Build Aave v4 Spoke supply/deposit batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4DepositBatch" },
-    inputZod: mcpAaveV4DepositInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_aave_v4_build_withdraw_multisign",
-    actionId: "aave-v4.withdraw",
-    protocolId: "aave-v4",
-    chainCategory: "evm",
-    description: "Build Aave v4 Spoke withdraw batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeWithdraw" },
-    inputZod: mcpAaveV4WithdrawInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_aave_v4_build_borrow_multisign",
-    actionId: "aave-v4.borrow",
-    protocolId: "aave-v4",
-    chainCategory: "evm",
-    description: "Build Aave v4 Spoke borrow batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeBorrow" },
-    inputZod: mcpAaveV4BorrowInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_aave_v4_build_repay_multisign",
-    actionId: "aave-v4.repay",
-    protocolId: "aave-v4",
-    chainCategory: "evm",
-    description: "Build Aave v4 Spoke repay batch.",
-    prerequisites: ["keyGen", "executorAddress", "spoke + underlying"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/aave-v4", exportName: "buildEvmMultisignBodyAaveV4SpokeRepay" },
-    inputZod: mcpAaveV4RepayInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_euler_v2_build_isolated_lend_multisign",
-    actionId: "euler-v2.isolated-lend",
-    protocolId: "euler-v2",
-    chainCategory: "evm",
-    description: "Build Euler v2 vault deposit/lend batch.",
-    prerequisites: ["keyGen", "executorAddress", "vault address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2IsolatedLendDepositBatch" },
-    inputZod: mcpEulerV2IsolatedLendInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_euler_v2_build_isolated_borrow_multisign",
-    actionId: "euler-v2.isolated-borrow",
-    protocolId: "euler-v2",
-    chainCategory: "evm",
-    description: "Build Euler v2 isolated borrow loop batch.",
-    prerequisites: ["keyGen", "executorAddress", "vault + collateral"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2IsolatedBorrowBatch" },
-    inputZod: mcpEulerV2IsolatedBorrowInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_euler_v2_build_vault_withdraw_multisign",
-    actionId: "euler-v2.vault-withdraw",
-    protocolId: "euler-v2",
-    chainCategory: "evm",
-    description: "Build Euler v2 vault withdraw/redeem batch.",
-    prerequisites: ["keyGen", "executorAddress", "vault address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2VaultWithdrawBatch" },
-    inputZod: mcpEulerV2VaultWithdrawInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_euler_v2_build_borrow_repay_multisign",
-    actionId: "euler-v2.borrow-repay",
-    protocolId: "euler-v2",
-    chainCategory: "evm",
-    description: "Build Euler v2 borrow repay batch.",
-    prerequisites: ["keyGen", "executorAddress", "vault address"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2BorrowRepayBatch" },
-    inputZod: mcpEulerV2BorrowRepayInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_euler_v2_build_collateral_deposit_multisign",
-    actionId: "euler-v2.collateral-deposit",
-    protocolId: "euler-v2",
-    chainCategory: "evm",
-    description: "Build Euler v2 borrow collateral deposit batch.",
-    prerequisites: ["keyGen", "executorAddress", "vault + collateral asset"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2BorrowCollateralDepositBatch" },
-    inputZod: mcpEulerV2CollateralDepositInputSchema
-  }),
-  defineProtocolMcpTool({
-    name: "ctm_euler_v2_build_collateral_withdraw_multisign",
-    actionId: "euler-v2.collateral-withdraw",
-    protocolId: "euler-v2",
-    chainCategory: "evm",
-    description: "Build Euler v2 borrow collateral withdraw batch.",
-    prerequisites: ["keyGen", "executorAddress", "vault + collateral asset"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest"],
-    handler: { importPath: "protocols/evm/euler-v2", exportName: "buildEvmMultisignBodyEulerV2BorrowCollateralWithdrawBatch" },
-    inputZod: mcpEulerV2CollateralWithdrawInputSchema
-  })
-];
-
-// src/agent/mcpTools.ts
-function defineMcpTool(def) {
-  return {
-    ...def,
-    inputSchema: zodSchemaToMcpJsonSchema(def.inputZod),
-    outputSchema: zodSchemaToMcpJsonSchema(def.outputZod),
-    parseInput: (data) => def.inputZod.parse(data),
-    parseOutput: (data) => def.outputZod.parse(data)
-  };
-}
-var CORE_MCP_TOOL_DEFINITIONS = [
-  defineMcpTool({
-    name: "ctm_uniswap_v4_quote",
-    actionId: "uniswap-v4.quote",
-    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)."],
-    followUp: ["ctm_uniswap_v4_create_swap", "ctm_uniswap_v4_build_swap_multisign"],
-    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapTradeQuote" },
-    inputZod: mcpUniswapV4QuoteInputSchema,
-    outputZod: mcpUniswapV4QuoteOutputSchema
-  }),
-  defineMcpTool({
-    name: "ctm_uniswap_v4_create_swap",
-    actionId: "uniswap-v4.create-swap",
-    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)"],
-    followUp: ["ctm_uniswap_v4_build_swap_multisign"],
-    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "uniswapCreateSwap" },
-    inputZod: mcpUniswapV4CreateSwapInputSchema,
-    outputZod: mcpUniswapV4CreateSwapOutputSchema
-  }),
-  defineMcpTool({
-    name: "ctm_uniswap_v4_build_swap_multisign",
-    actionId: "uniswap-v4.swap-exact-input",
-    protocolId: "uniswap-v4",
-    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"
-    ],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
-    handler: { importPath: "protocols/evm/uniswap-v4", exportName: "buildEvmMultisignBodyUniswapV4SkipPermit2Batch" },
-    inputZod: mcpUniswapV4BuildSwapMultisignInputSchema,
-    outputZod: multisignOutputSchema
-  }),
-  defineMcpTool({
-    name: "ctm_curve_dao_build_swap_multisign",
-    actionId: "curve-dao.swap",
-    protocolId: "curve-dao",
-    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: ["keyGen", "executorAddress", "tokenIn/tokenOut/amountHuman/slippage", "RPC URL"],
-    followUp: ["Sign messageToSign", "POST /multiSignRequest with clientSig and signedMessage"],
-    handler: { importPath: "protocols/evm/curve-dao", exportName: "buildEvmMultisignBodyCurveDaoBatch" },
-    inputZod: mcpCurveDaoBuildSwapMultisignInputSchema,
-    outputZod: multisignOutputSchema
-  })
-];
-var MCP_TOOL_DEFINITIONS = [
-  ...CORE_MCP_TOOL_DEFINITIONS,
-  ...MCP_PROTOCOL_TOOL_DEFINITIONS
-];
-function buildToolSchemaMap(kind) {
-  const out = {};
-  for (const tool of MCP_TOOL_DEFINITIONS) {
-    out[tool.name] = kind === "input" ? tool.inputZod : tool.outputZod;
-  }
-  return out;
-}
-var MCP_TOOL_INPUT_SCHEMAS = buildToolSchemaMap("input");
-var MCP_TOOL_OUTPUT_SCHEMAS = buildToolSchemaMap("output");
-function getAgentCatalogForMcp() {
-  return {
-    tools: MCP_TOOL_DEFINITIONS,
-    protocols: getProtocolModules(),
-    commonParams: EVM_COMMON_PARAM_DOCS,
-    multisignOutput: MULTISIGN_OUTPUT_DOC,
-    managementSig: MANAGEMENT_SIG_DOC,
-    /** Zod schemas for MCP tool I/O — source of truth for continuum-mcp-server validation. */
-    inputSchemas: MCP_TOOL_INPUT_SCHEMAS,
-    outputSchemas: MCP_TOOL_OUTPUT_SCHEMAS,
-    workflow: {
-      evmSwapTypical: [
-        "1. Quote (protocol-specific API if needed)",
-        "2. Build protocol calldata (e.g. create_swap)",
-        "3. build_*_multisign \u2192 { bodyForSign, messageToSign }",
-        "4. Sign messageToSign (MetaMask or Ed25519)",
-        "5. POST /multiSignRequest with clientSig and signedMessage"
-      ],
-      managementPostTypical: [
-        "1. GET /getNodeKey \u2192 nodeKey (128 hex)",
-        "2. GET /getPublicMgtKeyNonce or /getNodeMgtKeyNonce \u2192 nonce",
-        "3. buildManagementPostBody(nonce, nodeKey, { \u2026endpoint fields })",
-        "4. messageToSignManagementBody(body) \u2192 sign \u2192 withManagementClientSig(body, sig)",
-        "5. POST management route with signed body"
-      ]
-    }
-  };
-}
-getAddress(
-  "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84"
-);
-getAddress(
-  "0x7f39C581F595B853cBbF37C12FfeeA971C5a5bEa"
-);
-getAddress("0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1");
-var LIDO_ETHEREUM_MAINNET_CHAIN_ID = 1;
-
-// src/protocols/evm/lido/index.ts
-var LIDO_PROTOCOL_ID = "lido";
-var lidoProtocolModule = {
-  id: LIDO_PROTOCOL_ID,
-  chainCategory: "evm",
-  isChainSupported(ctx) {
-    if (ctx.chainCategory !== "evm") return false;
-    return Number(ctx.chainId) === LIDO_ETHEREUM_MAINNET_CHAIN_ID;
-  },
-  isTokenSupported(token) {
-    return token.category === "evm" && (token.kind === "native" || token.kind === "erc20");
-  },
-  actions: [
-    { id: "lido.submit", protocolId: LIDO_PROTOCOL_ID, chainCategory: "evm", description: "Stake ETH via Lido submit()", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { valueWei: { type: "string", required: true, description: "ETH to stake (wei string)" } } },
-    { id: "lido.request-withdrawals", protocolId: LIDO_PROTOCOL_ID, chainCategory: "evm", description: "Queue stETH withdrawal", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "lido.claim-withdrawal", protocolId: LIDO_PROTOCOL_ID, chainCategory: "evm", description: "Claim finalized withdrawal", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "lido.wrap-steth", protocolId: LIDO_PROTOCOL_ID, chainCategory: "evm", description: "Wrap stETH to wstETH", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "lido.unwrap-wsteth", protocolId: LIDO_PROTOCOL_ID, chainCategory: "evm", description: "Unwrap wstETH to stETH", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
-  ]
-};
-registerProtocolModule(lidoProtocolModule);
-var USDE_ETHEREUM_MAINNET = "0x4c9edd5852cd905f086c759e8383e09bff1e68b3";
-var USDE_MOST_L2S = "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34";
-var USDE_ZKSYNC_ERA = "0x39Fe7a0DACcE31Bd90418e3e659fb0b5f0B3Db0d";
-var L2_SAME_ADDRESS_CHAIN_IDS = /* @__PURE__ */ new Set([
-  42161,
-  // Arbitrum One
-  10,
-  // Optimism
-  8453,
-  // Base
-  56,
-  // BNB Chain
-  59144,
-  // Linea
-  5e3,
-  // Mantle
-  81457,
-  // Blast
-  169,
-  // Manta Pacific
-  534352,
-  // Scroll
-  252,
-  // Fraxtal
-  34443,
-  // Mode
-  196,
-  // X Layer
-  1088,
-  // Metis
-  80084,
-  // Berachain
-  2222,
-  // Kava
-  2818,
-  // Morph
-  1923,
-  // Swell
-  48900
-  // Zircuit
-]);
-function usdeTokenAddressOnEvmChain(chainId) {
-  if (chainId === 1) return USDE_ETHEREUM_MAINNET;
-  if (chainId === 324) return USDE_ZKSYNC_ERA;
-  if (L2_SAME_ADDRESS_CHAIN_IDS.has(chainId)) return USDE_MOST_L2S;
-  return null;
-}
-function isEvmChainInEthenaUsdeList(chainId) {
-  return usdeTokenAddressOnEvmChain(chainId) != null;
-}
-
-// src/protocols/evm/ethena/index.ts
-var ETHENA_PROTOCOL_ID = "ethena";
-var ethenaProtocolModule = {
-  id: ETHENA_PROTOCOL_ID,
-  chainCategory: "evm",
-  isChainSupported(ctx) {
-    if (ctx.chainCategory !== "evm") return false;
-    const n = typeof ctx.chainId === "number" ? ctx.chainId : Number.parseInt(String(ctx.chainId), 10);
-    return isEvmChainInEthenaUsdeList(n);
-  },
-  isTokenSupported(token) {
-    return token.category === "evm" && token.kind === "erc20";
-  },
-  actions: [
-    { id: "ethena.stake-usde", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Stake USDe \u2192 sUSDe", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { amountHuman: { type: "string", required: true, description: "USDe amount" } } },
-    { id: "ethena.redeem-susde", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Redeem sUSDe \u2192 USDe (no cooldown)", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "ethena.cooldown-shares", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Start sUSDe cooldown", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "ethena.claim-unstake", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Claim after cooldown", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
-  ]
-};
-registerProtocolModule(ethenaProtocolModule);
-
-// src/protocols/evm/maple/constants.ts
-function isMapleSyrupSupportedChain(chainId) {
-  return chainId === 1 || chainId === 11155111;
-}
-
-// src/protocols/evm/maple/index.ts
-var MAPLE_PROTOCOL_ID = "maple-syrup";
-var mapleProtocolModule = {
-  id: MAPLE_PROTOCOL_ID,
-  chainCategory: "evm",
-  isChainSupported(ctx) {
-    if (ctx.chainCategory !== "evm") return false;
-    const n = typeof ctx.chainId === "number" ? ctx.chainId : Number.parseInt(String(ctx.chainId), 10);
-    return isMapleSyrupSupportedChain(n);
-  },
-  isTokenSupported(token) {
-    return token.category === "evm" && token.kind === "erc20";
-  },
-  actions: [
-    { id: "maple-syrup.deposit", protocolId: MAPLE_PROTOCOL_ID, chainCategory: "evm", description: "Deposit into Maple Syrup pool", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "maple-syrup.request-redeem", protocolId: MAPLE_PROTOCOL_ID, chainCategory: "evm", description: "Request redeem from pool", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
-  ]
-};
-registerProtocolModule(mapleProtocolModule);
-
-// src/protocols/evm/sky/mainnet.ts
-var SKY_ETHEREUM_MAINNET_CHAIN_ID = 1;
-
-// src/protocols/evm/sky/index.ts
-var SKY_PROTOCOL_ID = "sky";
-var skyProtocolModule = {
-  id: SKY_PROTOCOL_ID,
-  chainCategory: "evm",
-  isChainSupported(ctx) {
-    if (ctx.chainCategory !== "evm") return false;
-    return Number(ctx.chainId) === SKY_ETHEREUM_MAINNET_CHAIN_ID;
-  },
-  isTokenSupported(token) {
-    return token.category === "evm" && token.kind === "erc20";
-  },
-  actions: [
-    { id: "sky.lockstake-stake", protocolId: SKY_PROTOCOL_ID, chainCategory: "evm", description: "Open Lockstake position", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "sky.lockstake-draw", protocolId: SKY_PROTOCOL_ID, chainCategory: "evm", description: "Borrow USDS from Lockstake", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "sky.lockstake-wipe", protocolId: SKY_PROTOCOL_ID, chainCategory: "evm", description: "Repay Lockstake debt", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "sky.lockstake-close", protocolId: SKY_PROTOCOL_ID, chainCategory: "evm", description: "Close Lockstake position", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "sky.susds-deposit", protocolId: SKY_PROTOCOL_ID, chainCategory: "evm", description: "Deposit USDS into sUSDS vault", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "sky.susds-redeem", protocolId: SKY_PROTOCOL_ID, chainCategory: "evm", description: "Redeem sUSDS to USDS", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
-  ]
-};
-registerProtocolModule(skyProtocolModule);
-
-// src/protocols/evm/aave-v4/index.ts
-var AAVE_V4_PROTOCOL_ID = "aave-v4";
-var aaveV4ProtocolModule = {
-  id: AAVE_V4_PROTOCOL_ID,
-  chainCategory: "evm",
-  isChainSupported(ctx) {
-    return ctx.chainCategory === "evm";
-  },
-  isTokenSupported(token) {
-    return token.category === "evm" && (token.kind === "native" || token.kind === "erc20");
-  },
-  actions: [
-    { id: "aave-v4.deposit", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Supply to Aave v4 Spoke", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "aave-v4.withdraw", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Withdraw from Spoke", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "aave-v4.borrow", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Borrow from Spoke", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "aave-v4.repay", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Repay Spoke debt", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
-  ]
-};
-registerProtocolModule(aaveV4ProtocolModule);
-
-// src/protocols/evm/euler-v2/index.ts
-var EULER_V2_PROTOCOL_ID = "euler-v2";
-var eulerV2ProtocolModule = {
-  id: EULER_V2_PROTOCOL_ID,
-  chainCategory: "evm",
-  isChainSupported(ctx) {
-    return ctx.chainCategory === "evm";
-  },
-  isTokenSupported(token) {
-    return token.category === "evm" && (token.kind === "native" || token.kind === "erc20");
-  },
-  actions: [
-    { id: "euler-v2.isolated-lend", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Deposit into Euler vault", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "euler-v2.isolated-borrow", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Borrow from Euler vault", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "euler-v2.vault-withdraw", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Withdraw from Euler vault", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "euler-v2.borrow-repay", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Repay Euler borrow", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "euler-v2.collateral-deposit", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Deposit borrow collateral", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "euler-v2.collateral-withdraw", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Withdraw borrow collateral", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
-  ]
-};
-registerProtocolModule(eulerV2ProtocolModule);
-
-// src/agent/catalog.ts
-registerProtocolModule(uniswapV4ProtocolModule);
-registerProtocolModule(curveDaoProtocolModule);
-registerProtocolModule(lidoProtocolModule);
-registerProtocolModule(ethenaProtocolModule);
-registerProtocolModule(mapleProtocolModule);
-registerProtocolModule(skyProtocolModule);
-registerProtocolModule(aaveV4ProtocolModule);
-registerProtocolModule(eulerV2ProtocolModule);
-function getAgentCatalog() {
-  return {
-    protocols: getProtocolModules(),
-    byCategory: {
-      evm: getActionsByChainCategory("evm"),
-      solana: getActionsByChainCategory("solana"),
-      near: getActionsByChainCategory("near")
-    },
-    uniswapV4: uniswapV4ProtocolModule,
-    curveDao: curveDaoProtocolModule,
-    lido: lidoProtocolModule,
-    ethena: ethenaProtocolModule,
-    maple: mapleProtocolModule,
-    sky: skyProtocolModule,
-    aaveV4: aaveV4ProtocolModule,
-    eulerV2: eulerV2ProtocolModule,
-    /** Prefer getAgentCatalogForMcp() or getMcpToolDefinitions() for MCP servers. */
-    mcp: getAgentCatalogForMcp()
-  };
-}
-
 // src/index.ts
 registerProtocolModule(uniswapV4ProtocolModule);
 registerProtocolModule(curveDaoProtocolModule);
 
-export { NEAR_CHAIN_CATEGORY, SOLANA_CHAIN_CATEGORY, alignEip1559FeesWithLatestBase, buildEvmMultisignBatch, buildManagementPostBody, chainSnapshotForCustomGasExtraJSON, composeFeePayloadToTxParams, coreChainCategoryModule, curveDao, curveDaoProtocolModule, evmChainCategoryModule, fetchChainFeeParams, fetchManagementNonce, fetchNodeKey, finalizeMultisign, firstClientIdFromKeyGen, gasLimitFromEstimateAndChainConfig, getActionsByChainCategory, getAgentCatalog, getProtocolModule, getProtocolModules, gweiToDecimalString, isEvmNativeToken, isValidRpcUrl, keyListFromKeyGen, managementSigFields, matchEvmTokenKind, mergePurposeText, messageToSignManagementBody, nearChainCategoryModule, nodeFetchWithReadAuth, normalizeManagementNodeKey, parseEvmChainIdToNumber, proposalTxParamsToFeeSnapshot, registerProtocolModule, requirePubKeyHex, routerSwapGasLimitFromEstimate, solanaChainCategoryModule, triggerTxParamsFromComposeBody, uniswapV4, uniswapV4ProtocolModule, withManagementClientSig };
+export { NEAR_CHAIN_CATEGORY, SOLANA_CHAIN_CATEGORY, buildEvmMultisignBatch, coreChainCategoryModule, curveDao, curveDaoProtocolModule, evmChainCategoryModule, finalizeMultisign, getActionsByChainCategory, getProtocolModule, getProtocolModules, isEvmNativeToken, matchEvmTokenKind, mergePurposeText, nearChainCategoryModule, parseEvmChainIdToNumber, registerProtocolModule, routerSwapGasLimitFromEstimate, solanaChainCategoryModule, uniswapV4, uniswapV4ProtocolModule };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map