@continuumdao/ctm-mpc-defi 0.1.3

package/dist/protocols/evm/uniswap-v4/index.js

@@ -0,0 +1,1659 @@
+import { getAddress, zeroAddress, formatUnits, parseUnits, encodeFunctionData, erc20Abi, defineChain, createPublicClient, http, parseGwei, serializeTransaction, keccak256, decodeFunctionData } from 'viem';
+
+// src/core/registry.ts
+var modules = [];
+function registerProtocolModule(mod) {
+  const existing = modules.findIndex((m) => m.id === mod.id);
+  if (existing >= 0) {
+    modules[existing] = mod;
+  } else {
+    modules.push(mod);
+  }
+}
+
+// src/chains/evm/chainIdParse.ts
+function parseEvmChainIdToNumber(chainId) {
+  if (chainId == null) return Number.NaN;
+  if (typeof chainId === "bigint") {
+    const n = Number(chainId);
+    return Number.isSafeInteger(n) && n >= 0 ? n : Number.NaN;
+  }
+  if (typeof chainId === "number") {
+    return Number.isInteger(chainId) && chainId >= 0 ? chainId : Number.NaN;
+  }
+  const t = String(chainId).trim();
+  if (!t) return Number.NaN;
+  const low = t.toLowerCase();
+  if (low.startsWith("eip155:")) {
+    const rest = t.slice("eip155:".length).trim();
+    const n = Number.parseInt(rest, 10);
+    return Number.isNaN(n) || n < 0 ? Number.NaN : n;
+  }
+  if (low.startsWith("0x")) {
+    return Number.parseInt(t, 16);
+  }
+  return Number.parseInt(t, 10);
+}
+
+// src/protocols/evm/uniswap-v4/constants.ts
+var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+var UNIVERSAL_ROUTER_SPENDER = {
+  1: "0x66a9893cc07d91d95644aedd05d03f95e1dba8af",
+  5: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  11155111: "0x3a9d48ab9751398bbfa63ad67599bb04e4bdf98b",
+  137: "0x1095692a6237d83c6a72f3f5efedb9a670c49223",
+  80001: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  10: "0x851116d9223fabed8e56c0e6b8ad0c31d98b3507",
+  420: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  42161: "0xa51afafe0263b40edaef0df8781ea9aa03e381a3",
+  421613: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  42220: "0xcb695bc5D3Aa22cAD1E6DF07801b061a05A0233A",
+  44787: "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
+  56: "0x1906c1d672b88cd1b9ac7593301ca990f94eae07",
+  43114: "0x94b75331ae8d42c1b61065089b7d48fe14aa73b7",
+  84531: "0xd0872d928672ae2ff74bdb2f5130ac12229cafaf",
+  8453: "0x6fF5693b99212da76ad316178a184ab56d299b43",
+  81457: "0xeabbcb3e8e415306207ef514f660a3f820025be3",
+  7777777: "0x3315ef7ca28db74abadc6c44570efdf06b04b020",
+  324: "0x28731BCC616B5f51dD52CF2e4dF0E78dD1136C06",
+  480: "0x8ac7bee993bb44dab564ea4bc9ea67bf9eb5e743",
+  1301: "0xf70536b3bcc1bd1a972dc186a2cf84cc6da6be5d",
+  130: "0xef740bf23acae26f6492b10de645d6b98dc8eaf3",
+  10143: "0x3ae6d8a282d67893e17aa70ebffb33ee5aa65893",
+  84532: "0x492e6456d9528771018deb9e87ef7750ef184104",
+  1868: "0x0e2850543f69f678257266e0907ff9a58b3f13de",
+  143: "0x0d97dc33264bfc1c226207428a79b26757fb9dc3",
+  59144: "0x661e93cca42afacb172121ef892830ca3b70f08d",
+  4217: "0x1febb76be10aaf3a1402f04e8e835f2c382f7914",
+  196: "0x5507749f2c558bb3e162c6e90c314c092e7372ff"
+};
+function isUniswapV4ChainSupported(chainId) {
+  if (chainId == null) return false;
+  const n = parseEvmChainIdToNumber(chainId);
+  if (Number.isNaN(n) || n < 0) return false;
+  const a = UNIVERSAL_ROUTER_SPENDER[n];
+  return typeof a === "string" && a.startsWith("0x");
+}
+function getUniswapUniversalRouterSpenderOrThrow(chainId) {
+  const raw = UNIVERSAL_ROUTER_SPENDER[chainId];
+  if (!raw || !raw.startsWith("0x")) {
+    throw new Error(
+      `No Uniswap Universal Router (spender) is configured for chainId ${chainId}. Add this chain to uniswap-v4/constants or use a chain supported by the Uniswap SDK.`
+    );
+  }
+  return getAddress(raw);
+}
+var MAX_UINT160 = (1n << 160n) - 1n;
+var MAX_UINT48 = (1n << 48n) - 1n;
+var UNISWAP_UNIVERSAL_ROUTER_DEFAULT_GAS_UNITS = 1500000n;
+var UNISWAP_TRADE_BASE_DEFAULT = "https://trade-api.gateway.uniswap.org/v1";
+var UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT = "2.0";
+var UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES = 30;
+var UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET = UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES * 60;
+
+// 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/protocols/evm/uniswap-v4/quote.ts
+var DEFAULT_TRADE_BASE = "https://trade-api.gateway.uniswap.org/v1";
+var UNISWAP_QUOTE_HEADERS_BASE = {
+  "Content-Type": "application/json",
+  "User-Agent": "ctm-mpc-defi uniswapTradeQuote/1.0 (TS)"
+};
+function parseUniswapChainId(value) {
+  if (typeof value === "number") {
+    if (!Number.isInteger(value) || value < 0) {
+      throw new TypeError("chainId number must be a non-negative integer");
+    }
+    return value;
+  }
+  const t = value.trim();
+  if (t.toLowerCase().startsWith("0x")) {
+    return Number.parseInt(t, 16);
+  }
+  return Number.parseInt(t, 10);
+}
+function trimAddr(a) {
+  return a.trim();
+}
+function isUniswapTokenInAddressNative(tokenIn) {
+  const t = (tokenIn ?? "").toString().trim();
+  if (!t) return false;
+  try {
+    return getAddress(t) === zeroAddress;
+  } catch {
+    return t.toLowerCase() === "0x0000000000000000000000000000000000000000";
+  }
+}
+function isUniswapFullQuoteResponseNativeIn(stored) {
+  if (!stored) return false;
+  const q = stored.quote;
+  if (!q || typeof q !== "object" || Array.isArray(q)) return false;
+  const input = q.input;
+  if (!input) return false;
+  const raw = (input.address ?? input.token ?? "").toString().trim();
+  return isUniswapTokenInAddressNative(raw);
+}
+async function fetchEthereumAddressForKeyGen(managementNodeUrl, keyGenId, readAuth = { bearerOnGet: true, jwt: null }, init) {
+  const base = managementNodeUrl.trim().replace(/\/$/, "");
+  if (!base) {
+    throw new Error("managementNodeUrl is required to resolve keyGen");
+  }
+  const id = (keyGenId || "").trim();
+  if (!id) {
+    throw new Error("keyGen is required");
+  }
+  const url = `${base}/getKeyGenResultById?id=${encodeURIComponent(id)}`;
+  const res = await nodeFetchWithReadAuth(url, { ...init, method: "GET", cache: "no-store" }, readAuth);
+  if (!res.ok) {
+    const t = await res.text().catch(() => "");
+    throw new Error(
+      `getKeyGenResultById HTTP ${res.status}: ${t || res.statusText}`.trim()
+    );
+  }
+  const raw = await res.json();
+  const d = raw.Data ?? raw.data;
+  const eth = d?.ethereumaddress;
+  if (typeof eth !== "string" || !eth.trim()) {
+    throw new Error("getKeyGenResultById: ethereumaddress missing for this keyGen");
+  }
+  return eth.trim();
+}
+function resolveInputChainId(p) {
+  if (p.chainId !== void 0 && p.chainId !== null && String(p.chainId).trim() !== "") {
+    return p.chainId;
+  }
+  if (p.tokenInChainId !== void 0 && p.tokenInChainId !== null && String(p.tokenInChainId).trim() !== "") {
+    return p.tokenInChainId;
+  }
+  if (p.tokenOutChainId !== void 0 && p.tokenOutChainId !== null && String(p.tokenOutChainId).trim() !== "") {
+    return p.tokenOutChainId;
+  }
+  throw new Error("Set chainId, tokenInChainId, or tokenOutChainId (same-chain) for the input side");
+}
+function buildUniswapQuoteRequestBody(args) {
+  const cIn = parseUniswapChainId(resolveInputChainId(args));
+  const cOut = args.tokenOutChainId !== void 0 && args.tokenOutChainId !== null && String(args.tokenOutChainId).trim() !== "" ? parseUniswapChainId(args.tokenOutChainId) : cIn;
+  const body = {
+    type: args.type,
+    amount: String(args.amount).trim(),
+    tokenInChainId: cIn,
+    tokenOutChainId: cOut,
+    tokenIn: trimAddr(args.tokenIn),
+    tokenOut: trimAddr(args.tokenOut),
+    swapper: trimAddr(args.swapper)
+  };
+  if (args.slippage !== void 0 && args.slippage !== null && String(args.slippage).trim() !== "") {
+    const s = typeof args.slippage === "number" ? args.slippage : Number.parseFloat(String(args.slippage).trim());
+    if (Number.isNaN(s)) {
+      throw new TypeError("slippage must be a number or a numeric string");
+    }
+    body.slippageTolerance = s;
+  } else {
+    body.autoSlippage = "DEFAULT";
+  }
+  return body;
+}
+function errorMessageFromUniswapJsonBody(value) {
+  if (value == null) return null;
+  if (typeof value === "string") {
+    const t = value.trim();
+    return t || null;
+  }
+  if (typeof value !== "object") return null;
+  if (Array.isArray(value)) {
+    if (value.length === 0) return null;
+    return errorMessageFromUniswapJsonBody(value[0]);
+  }
+  const o = value;
+  if (typeof o.detail === "string" && o.detail.trim()) {
+    const base = o.detail.trim();
+    const code = typeof o.errorCode === "string" && o.errorCode.trim() ? o.errorCode.trim() : "";
+    const req = typeof o.requestId === "string" && o.requestId.trim() ? o.requestId.trim() : "";
+    if (code) {
+      return req ? `${base} (${code}) [${req}]` : `${base} (${code})`;
+    }
+    return req ? `${base} [${req}]` : base;
+  }
+  if (typeof o.errorCode === "string" && o.errorCode.trim()) {
+    return o.errorCode.trim();
+  }
+  for (const k of ["message", "detail", "description", "title", "reason"]) {
+    const v = o[k];
+    if (typeof v === "string" && v.trim()) return v.trim();
+  }
+  if (typeof o.error === "string" && o.error.trim()) return o.error.trim();
+  if (o.error != null && typeof o.error === "object") {
+    const inner = errorMessageFromUniswapJsonBody(o.error);
+    if (inner) return inner;
+  }
+  if (Array.isArray(o.errors) && o.errors.length > 0) {
+    const inner = errorMessageFromUniswapJsonBody(o.errors[0]);
+    if (inner) return inner;
+  }
+  if (typeof o.code === "string" && o.code.trim()) return o.code.trim();
+  return null;
+}
+function bodyLooksLikeHtml(t) {
+  const s = t.slice(0, 256).trimStart();
+  return s.startsWith("<!") || s.toLowerCase().startsWith("<html");
+}
+function titleFromHtml(t) {
+  const m = t.match(/<title[^>]*>([^<]+)<\/title>/i);
+  if (!m?.[1]) return null;
+  const s = m[1].replace(/\s+/g, " ").trim();
+  return s || null;
+}
+function messageFromUniswapHttpResponseBody(text, status, statusText = "") {
+  const raw = (text ?? "").trim();
+  const st = (statusText ?? "").trim();
+  if (!raw) {
+    if (status > 0) {
+      return st ? `HTTP ${status} (${st})` : `HTTP ${status}`;
+    }
+    return "Empty response";
+  }
+  if (bodyLooksLikeHtml(raw)) {
+    const title = titleFromHtml(raw);
+    if (title) {
+      return status > 0 ? `HTTP ${status}: ${title}` : title;
+    }
+    return status > 0 ? "HTTP " + String(status) + ": response was not JSON (HTML or error page). Check API key, token pair, and network." : "Response was not JSON (HTML or error page).";
+  }
+  const forParse = raw.replace(/^\uFEFF/, "");
+  try {
+    const j = JSON.parse(forParse);
+    if (j && typeof j === "object") {
+      const msg = errorMessageFromUniswapJsonBody(j);
+      if (msg) {
+        if (status >= 400) {
+          return st ? `${msg} (HTTP ${status} ${st})` : `${msg} (HTTP ${status})`;
+        }
+        return msg;
+      }
+    }
+  } catch {
+  }
+  const oneLine = raw.replace(/\s+/g, " ").trim();
+  const short = oneLine.length > 500 ? `${oneLine.slice(0, 500)}\u2026` : oneLine;
+  if (status > 0) {
+    return st && !short ? `HTTP ${status} (${st})` : st ? `HTTP ${status}: ${short} (${st})` : `HTTP ${status}: ${short}`;
+  }
+  return short;
+}
+async function uniswapTradeQuote(args) {
+  const apiKey = (args.uniswapApiKey || "").trim();
+  if (!apiKey) {
+    throw new Error("uniswapApiKey (x-api-key) is required");
+  }
+  const keyGen = (args.keyGen || "").trim();
+  let swapper;
+  if ((args.swapper || "").trim()) {
+    swapper = trimAddr(args.swapper);
+  } else {
+    if (!keyGen) {
+      throw new Error("keyGen is required when swapper is not provided");
+    }
+    const mpc = (args.managementNodeUrl || "").trim();
+    if (!mpc) {
+      throw new Error("managementNodeUrl is required when swapper is not provided (to resolve keyGen)");
+    }
+    swapper = await fetchEthereumAddressForKeyGen(
+      mpc,
+      keyGen,
+      args.nodeReadAuth ?? { bearerOnGet: true, jwt: null }
+    );
+  }
+  const base = args.baseUrl && args.baseUrl.trim() ? args.baseUrl.trim().replace(/\/$/, "") : DEFAULT_TRADE_BASE;
+  const quoteUrl = `${base}/quote`;
+  const urv = args.universalRouterVersion && args.universalRouterVersion.trim() || "2.0";
+  const body = buildUniswapQuoteRequestBody({ ...args, swapper });
+  const nativeIn = isUniswapTokenInAddressNative(args.tokenIn);
+  const headers = {
+    ...UNISWAP_QUOTE_HEADERS_BASE,
+    "x-api-key": apiKey,
+    "x-universal-router-version": urv,
+    "x-permit2-disabled": args.permit2Disabled === true ? "true" : "false",
+    /** Native (0x0) as token in: Trade API needs this for classic routes and payable /swap. */
+    "x-erc20eth-enabled": nativeIn ? "true" : "false"
+  };
+  const fetchFn = args.fetchImpl ?? globalThis.fetch;
+  const res = await fetchFn(quoteUrl, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(body),
+    signal: args.signal
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    throw new Error(messageFromUniswapHttpResponseBody(text, res.status, res.statusText));
+  }
+  const forParse = text.replace(/^\uFEFF/, "");
+  try {
+    return JSON.parse(forParse);
+  } catch {
+    throw new Error(
+      `Trade API: ${messageFromUniswapHttpResponseBody(text, res.status, res.statusText)}`
+    );
+  }
+}
+function uniswapQuoteToJsonQuoteOneLine(quote) {
+  return JSON.stringify(quote);
+}
+function parseUniswapQuoteClassicInOut(res) {
+  const inner = res.quote;
+  if (!inner || typeof inner !== "object" || Array.isArray(inner)) return null;
+  const q = inner;
+  const input = q.input;
+  const output = q.output;
+  const inAm = input?.amount;
+  const outAm = output?.amount;
+  if (typeof inAm !== "string" || !inAm || typeof outAm !== "string" || !outAm) return null;
+  try {
+    return { inputWei: BigInt(inAm), outputWei: BigInt(outAm) };
+  } catch {
+    return null;
+  }
+}
+function parseUniswapQuoteSlippageInfo(res) {
+  const inner = res.quote;
+  if (!inner || typeof inner !== "object" || Array.isArray(inner)) {
+    return { slippageTolerancePercent: null, priceImpactPercent: null };
+  }
+  const q = inner;
+  const sRaw = q.slippage ?? q.slippageTolerance;
+  let slippageTolerancePercent = null;
+  if (typeof sRaw === "number" && Number.isFinite(sRaw)) {
+    slippageTolerancePercent = sRaw;
+  } else if (typeof sRaw === "string" && sRaw.trim()) {
+    const p = Number.parseFloat(sRaw.trim().replace(/,/g, ""));
+    if (Number.isFinite(p)) slippageTolerancePercent = p;
+  }
+  const piRaw = q.priceImpact;
+  let priceImpactPercent = null;
+  if (typeof piRaw === "number" && Number.isFinite(piRaw)) {
+    priceImpactPercent = piRaw;
+  } else if (typeof piRaw === "string" && piRaw.trim()) {
+    const p = Number.parseFloat(piRaw.trim().replace(/,/g, ""));
+    if (Number.isFinite(p)) priceImpactPercent = p;
+  }
+  return { slippageTolerancePercent, priceImpactPercent };
+}
+function formatUniswapPercentForUi(n) {
+  if (!Number.isFinite(n)) return "\u2014";
+  const t = n.toFixed(4).replace(/\.?0+$/, "");
+  return t || "0";
+}
+function formatUniswapAmountFieldFromWei(wei, decimals) {
+  const s = formatUnits(wei, decimals);
+  if (!s.includes(".")) return s;
+  const t = s.replace(/0+$/, "");
+  return t.endsWith(".") ? t.slice(0, -1) : t;
+}
+function buildUniswapV4PurposePrefill(args) {
+  const symIn = (args.tokenInSymbol || "").trim() || "token in";
+  const symOut = (args.tokenOutSymbol || "").trim() || "token out";
+  const rawS = String(args.slippageInput || "0.5").trim().replace(/,/g, "");
+  const parsedSlip = Number.parseFloat(rawS);
+  const slip = Number.isFinite(parsedSlip) ? parsedSlip : 0.5;
+  const slipText = (Math.round(slip * 100) / 100).toString();
+  const p = args.quote != null ? parseUniswapQuoteClassicInOut(args.quote) : null;
+  let inPart = "\u2026";
+  let outPart = "\u2026";
+  if (p) {
+    inPart = `${formatUniswapAmountFieldFromWei(p.inputWei, args.tokenInDecimals)} ${symIn}`.replace(/\s+/g, " ").trim();
+    outPart = `${formatUniswapAmountFieldFromWei(p.outputWei, args.tokenOutDecimals)} ${symOut}`.replace(/\s+/g, " ").trim();
+  } else if (args.tradeType === "EXACT_INPUT" && args.amountInput.trim()) {
+    try {
+      const w = parseUnits(args.amountInput.trim(), args.tokenInDecimals);
+      inPart = `${formatUniswapAmountFieldFromWei(w, args.tokenInDecimals)} ${symIn}`.replace(/\s+/g, " ").trim();
+      outPart = `\u2026 ${symOut}`;
+    } catch {
+    }
+  }
+  const cname = (args.chainName || "").trim() || "chain";
+  return `Swap ${inPart} for ${outPart} with a slippage of ${slipText}% on ${cname} (chainId ${args.chainId})`;
+}
+function formatUniswapQuoteForDisplay(res, args) {
+  const { tradeType, tokenInDecimals, tokenOutDecimals, tokenInSymbol, tokenOutSymbol } = args;
+  const rawJson = JSON.stringify(res, null, 2);
+  const routing = typeof res.routing === "string" ? res.routing : void 0;
+  const requestId = typeof res.requestId === "string" ? res.requestId : void 0;
+  const inner = res.quote;
+  if (inner && typeof inner === "object" && !Array.isArray(inner)) {
+    const q = inner;
+    const input = q.input;
+    const output = q.output;
+    const inAm = input?.amount;
+    const outAm = output?.amount;
+    if (typeof inAm === "string" && inAm && typeof outAm === "string" && outAm) {
+      try {
+        const inH = formatUnits(BigInt(inAm), tokenInDecimals);
+        const outH = formatUnits(BigInt(outAm), tokenOutDecimals);
+        const title = tradeType === "EXACT_INPUT" ? `\u2248 ${outH} ${tokenOutSymbol} for ${inH} ${tokenInSymbol} (est.)` : `\u2248 ${inH} ${tokenInSymbol} for ${outH} ${tokenOutSymbol} (est.)`;
+        const lines2 = [
+          `Input:  ${inH} ${tokenInSymbol} (${inAm} wei)`,
+          `Output: ${outH} ${tokenOutSymbol} (${outAm} wei)`
+        ];
+        if (routing) lines2.push(`Route: ${routing}`);
+        if (requestId) lines2.push(`Request: ${requestId.slice(0, 24)}\u2026`);
+        return { title, lines: lines2, rawJson };
+      } catch {
+      }
+    }
+  }
+  const lines = ["(Could not parse classic input/output; see raw JSON below.)"];
+  if (routing) lines.push(`Route: ${routing}`);
+  if (requestId) lines.push(`Request: ${requestId}`);
+  return { title: "Quote received", lines, rawJson };
+}
+
+// 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;
+}
+
+// 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;
+}
+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/protocols/evm/uniswap-v4/swapMultisign.ts
+function parseOptionalGasLimitString(raw) {
+  if (raw == null) return null;
+  const s = String(raw).trim();
+  if (!s) return null;
+  try {
+    if (/^0x[0-9a-fA-F]+$/.test(s)) return BigInt(s);
+    return BigInt(s);
+  } catch {
+    return null;
+  }
+}
+function parseExtraJsonObject(detail) {
+  if (!detail) return null;
+  const raw = detail.ExtraJSON ?? detail.extraJSON;
+  if (raw == null) return null;
+  if (typeof raw === "object" && !Array.isArray(raw)) return raw;
+  if (typeof raw === "string" && raw.trim()) {
+    try {
+      const p = JSON.parse(raw);
+      if (p && typeof p === "object" && !Array.isArray(p)) return p;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+function isUniswapV4SwapEvmSignRequest(detail, batchIndex) {
+  const ex = parseExtraJsonObject(detail);
+  if (batchIndex != null && batchIndex >= 0 && ex) {
+    const bm = ex.batchMeta;
+    if (Array.isArray(bm) && bm[batchIndex] && typeof bm[batchIndex] === "object" && !Array.isArray(bm[batchIndex])) {
+      const evm0 = bm[batchIndex].evm;
+      if (evm0 && typeof evm0 === "object" && !Array.isArray(evm0)) {
+        if (String(evm0.type ?? "") === "uniswap_v4_swap_tx") return true;
+      }
+    }
+  }
+  const evm = ex?.evm;
+  if (!evm || typeof evm !== "object" || Array.isArray(evm)) return false;
+  return String(evm.type ?? "") === "uniswap_v4_swap_tx";
+}
+function resolveRouterSwapGasUnitsFromSignRequest(detail, batchIndex) {
+  if (!detail) return null;
+  const propBatch = detail.proposal_tx_params ?? detail.proposalTxParams ?? detail.ProposalTxParams;
+  const index = batchIndex != null && batchIndex >= 0 ? batchIndex : 0;
+  if (Array.isArray(propBatch) && propBatch.length > index) {
+    const row = propBatch[index];
+    if (row && typeof row === "object" && !Array.isArray(row)) {
+      const r = row;
+      const gl = parseOptionalGasLimitString(
+        r.gas_limit ?? r.gasLimit ?? r.GasLimit
+      );
+      if (gl != null && gl > 0n) return gl;
+    }
+  }
+  if (batchIndex == null || batchIndex === 0) {
+    const tp = detail.txParams ?? detail.TxParams;
+    if (tp && typeof tp === "object") {
+      const gl = parseOptionalGasLimitString(
+        tp.gasLimit ?? tp.GasLimit ?? tp.txGasLimit
+      );
+      if (gl != null && gl > 0n) return gl;
+    }
+  }
+  const ex = parseExtraJsonObject(detail);
+  const u4 = ex?.uniswapV4;
+  if (u4 && typeof u4 === "object") {
+    const uc = u4.uniswapCreateSwap;
+    const gb = uc?.gasBuild;
+    const base = parseOptionalGasLimitString(gb?.baseGasUnits);
+    if (base != null && base > 0n) return base;
+    const snap = u4.fullQuoteFromPermitSnapshot;
+    const quote = snap?.quote;
+    const gue = parseOptionalGasLimitString(quote?.gasUseEstimate);
+    if (gue != null && gue > 0n) return gue;
+  }
+  return null;
+}
+var DEFAULT_UNIVERSAL_ROUTER_GAS_FALLBACK = UNISWAP_UNIVERSAL_ROUTER_DEFAULT_GAS_UNITS;
+function swapTransactionDeadlineUnixFromExpiryMinutes(expiryMinutes, nowSec = Math.floor(Date.now() / 1e3)) {
+  const m = Number.isFinite(expiryMinutes) && expiryMinutes > 0 ? expiryMinutes : UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES;
+  return nowSec + Math.floor(m * 60);
+}
+function swapDeadlineUnixSeconds(args) {
+  const now = Math.floor(Date.now() / 1e3);
+  if (args.swapTransactionDeadlineUnix != null && Number.isFinite(args.swapTransactionDeadlineUnix) && args.swapTransactionDeadlineUnix > now) {
+    return Math.floor(args.swapTransactionDeadlineUnix);
+  }
+  return swapTransactionDeadlineUnixFromExpiryMinutes(UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES, now);
+}
+function getClassicQuoteFromStoredUniswapResponse(stored) {
+  if (!stored) return null;
+  const q = stored.quote;
+  return q != null && typeof q === "object" ? q : null;
+}
+async function uniswapCreateSwap(args) {
+  const deadline = swapDeadlineUnixSeconds(args);
+  const useProxy = args.useServerProxy !== false && typeof globalThis !== "undefined" && typeof globalThis.window !== "undefined";
+  if (useProxy) {
+    const proxyPayload = {
+      uniswapApiKey: args.uniswapApiKey,
+      fullQuoteFromPermit: args.fullQuoteFromPermit,
+      universalRouterVersion: args.universalRouterVersion,
+      baseUrl: args.baseUrl,
+      swapTransactionDeadlineUnix: deadline
+    };
+    const res2 = await (args.fetchImpl ?? globalThis.fetch)("/api/uniswap/swap", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(proxyPayload),
+      credentials: "same-origin"
+    });
+    const text2 = await res2.text();
+    if (!res2.ok) {
+      let errMsg = res2.statusText;
+      try {
+        const j = JSON.parse(text2);
+        if (j && typeof j.error === "string" && j.error.trim()) errMsg = j.error.trim();
+      } catch {
+        if (text2.trim()) errMsg = text2.slice(0, 500);
+      }
+      throw new Error(`Uniswap swap proxy failed: ${errMsg}`);
+    }
+    const parsed2 = JSON.parse(text2);
+    if (!parsed2?.swap || typeof parsed2.swap !== "object") {
+      throw new Error("Uniswap /swap (proxy): missing `swap` in response.");
+    }
+    return parsed2;
+  }
+  const base = (args.baseUrl ?? UNISWAP_TRADE_BASE_DEFAULT).replace(/\/$/, "");
+  const url = `${base}/swap`;
+  const classic = getClassicQuoteFromStoredUniswapResponse(args.fullQuoteFromPermit);
+  if (!classic) {
+    throw new Error("Stored Uniswap quote is missing a classic `quote` object; cannot build swap calldata.");
+  }
+  const body = {
+    quote: classic,
+    deadline
+  };
+  const urv = (args.universalRouterVersion ?? UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT).trim() || "2.0";
+  const fn = args.fetchImpl ?? globalThis.fetch;
+  const nativeIn = isUniswapFullQuoteResponseNativeIn(args.fullQuoteFromPermit);
+  const res = await fn(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": args.uniswapApiKey.trim(),
+      "x-universal-router-version": urv,
+      "x-erc20eth-enabled": nativeIn ? "true" : "false",
+      "x-permit2-disabled": "true"
+    },
+    body: JSON.stringify(body)
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    throw new Error(
+      `Uniswap POST /swap failed: ${messageFromUniswapHttpResponseBody(text, res.status, res.statusText)}`
+    );
+  }
+  const parsed = JSON.parse(text);
+  if (!parsed?.swap || typeof parsed.swap !== "object") {
+    throw new Error("Uniswap /swap: missing `swap` in response.");
+  }
+  return parsed;
+}
+var permit2ApproveRouterAbi = [
+  {
+    name: "approve",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint160" },
+      { name: "expiration", type: "uint48" }
+    ],
+    outputs: []
+  }
+];
+var uniswapDispatchExecuteAbi = [
+  {
+    name: "execute",
+    type: "function",
+    stateMutability: "payable",
+    inputs: [
+      { name: "router", type: "address" },
+      { name: "token", type: "address" },
+      { name: "amount", type: "uint256" },
+      { name: "commands", type: "bytes" },
+      { name: "inputs", type: "bytes[]" },
+      { name: "deadline", type: "uint256" }
+    ],
+    outputs: []
+  }
+];
+function parseSwapTxValueWei(swap) {
+  const raw = swap.value ?? swap.Value;
+  if (raw == null || raw === "") return 0n;
+  if (typeof raw === "bigint") return raw > 0n ? raw : 0n;
+  if (typeof raw === "number" && Number.isFinite(raw)) {
+    try {
+      return BigInt(Math.max(0, Math.trunc(raw)));
+    } catch {
+      return 0n;
+    }
+  }
+  const s = String(raw).trim();
+  if (!s) return 0n;
+  try {
+    if (/^0x[0-9a-fA-F]+$/.test(s)) return BigInt(s);
+    return BigInt(s.replace(/^0x/i, ""));
+  } catch {
+    return 0n;
+  }
+}
+function nativeEthInPayableValueWei(args) {
+  const fromApi = parseSwapTxValueWei(args.swap);
+  if (fromApi > 0n) return fromApi;
+  try {
+    const d = decodeFunctionData({ abi: uniswapDispatchExecuteAbi, data: args.dataHex });
+    if (d.functionName === "execute") {
+      const rawAmt = d.args[2];
+      const amount = typeof rawAmt === "bigint" ? rawAmt : BigInt(String(rawAmt));
+      if (amount > 0n) return amount;
+    }
+  } catch {
+  }
+  return args.quoteInputWei > 0n ? args.quoteInputWei : 0n;
+}
+function applySlippagePercentToApproveWei(baseWei, slippagePercent) {
+  if (baseWei <= 0n) return baseWei;
+  const s = slippagePercent == null ? NaN : Number(slippagePercent);
+  if (!Number.isFinite(s) || s <= 0) return baseWei;
+  const bps = Math.min(1e5, Math.round(s * 100));
+  if (bps <= 0) return baseWei;
+  return (baseWei * BigInt(1e4 + bps) + 9999n) / 10000n;
+}
+function permit2SpenderAndApproveWeiFromSwapCalldata(dataHex, tokenIn, quoteInputWei, chainId) {
+  const canonical = getUniswapUniversalRouterSpenderOrThrow(chainId);
+  try {
+    const d = decodeFunctionData({ abi: uniswapDispatchExecuteAbi, data: dataHex });
+    if (d.functionName !== "execute") {
+      return { permit2Spender: canonical, approveWei: quoteInputWei, calldataAmountWei: null };
+    }
+    const router = getAddress(d.args[0]);
+    const token = getAddress(d.args[1]);
+    const rawAmt = d.args[2];
+    const amount = typeof rawAmt === "bigint" ? rawAmt : BigInt(String(rawAmt));
+    if (token.toLowerCase() !== tokenIn.toLowerCase()) {
+      throw new Error(
+        `Swap calldata token ${token} does not match token in ${tokenIn}. Refresh quote and /swap.`
+      );
+    }
+    const calldataAmountWei = amount > 0n ? amount : null;
+    let approveWei = quoteInputWei;
+    if (calldataAmountWei != null && calldataAmountWei > approveWei) {
+      approveWei = calldataAmountWei;
+    }
+    return { permit2Spender: router, approveWei, calldataAmountWei };
+  } catch (e) {
+    if (e instanceof Error && e.message.includes("does not match token")) throw e;
+    return { permit2Spender: canonical, approveWei: quoteInputWei, calldataAmountWei: null };
+  }
+}
+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()}`
+  );
+  const dataHex = (() => {
+    const d = (args.swap.data ?? "0x").toString().trim();
+    return d.startsWith("0x") ? d : `0x${d}`;
+  })();
+  const valueWei = nativeEthInPayableValueWei({
+    swap: args.swap,
+    dataHex,
+    quoteInputWei
+  });
+  if (valueWei <= 0n) {
+    throw new Error(
+      "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({
+        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;
+        })()
+      }
+    },
+    fullQuoteFromPermitSnapshot: args.fullQuoteSnapshot,
+    originalPurpose: args.purposeText
+  };
+  const batchMeta = [
+    {
+      destinationAddress: toRouter,
+      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) };
+}
+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;
+  if (quoteInputWei == null || quoteInputWei <= 0n) {
+    throw new Error(
+      "Could not read a positive input amount from the quote. Refresh the quote and ensure the Trade API returned classic quote.input.amount."
+    );
+  }
+  if (tokenIn === zeroAddress) {
+    return buildEvmMultisignBodyUniswapV4NativeInOnly(args, quoteInputWei);
+  }
+  const toRouter = getAddress(
+    (args.swap.to ?? "").trim().startsWith("0x") ? args.swap.to.trim() : `0x${args.swap.to.trim()}`
+  );
+  const dataHex = (() => {
+    const d = (args.swap.data ?? "0x").toString().trim();
+    return d.startsWith("0x") ? d : `0x${d}`;
+  })();
+  const canonicalUniversalRouter = getUniswapUniversalRouterSpenderOrThrow(args.chainId);
+  const { permit2Spender, approveWei: baseApproveWei, calldataAmountWei } = permit2SpenderAndApproveWeiFromSwapCalldata(
+    dataHex,
+    tokenIn,
+    quoteInputWei,
+    args.chainId
+  );
+  const approveAmountWei = applySlippagePercentToApproveWei(baseApproveWei, args.slippagePercent);
+  const usePermit2Triple = toRouter.toLowerCase() === permit2Spender.toLowerCase();
+  if (usePermit2Triple && approveAmountWei > MAX_UINT160) {
+    throw new Error("Approved transfer amount exceeds allowance-hub uint160 max; reduce trade size.");
+  }
+  let expiration48 = 0n;
+  if (usePermit2Triple) {
+    const deadlineSec = Math.floor(Number(args.swapDeadlineUnix));
+    if (!Number.isFinite(deadlineSec) || deadlineSec <= 0) {
+      throw new Error("Invalid swapDeadlineUnix for allowance-hub approve expiration.");
+    }
+    expiration48 = BigInt(deadlineSec);
+    if (expiration48 > MAX_UINT48) expiration48 = MAX_UINT48;
+  }
+  const erc20ApproveSpender = usePermit2Triple ? PERMIT2_ADDRESS : toRouter;
+  const approveData = encodeFunctionData({
+    abi: erc20Abi,
+    functionName: "approve",
+    args: [erc20ApproveSpender, approveAmountWei]
+  });
+  const valueWei = (() => {
+    const v = args.swap.value;
+    if (v == null || v === "") return 0n;
+    try {
+      return BigInt(String(v).replace(/^0x/i, ""));
+    } catch {
+      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()
+    });
+  }
+  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()
+    });
+  }
+  const swapMsgIndex = usePermit2Triple ? 2 : 1;
+  const audit = {
+    skipPermit2Batch: true,
+    approvalPath: usePermit2Triple ? "permit2_triple" : "dispatcher",
+    approveAmount: {
+      baseWeiBeforeSlippage: baseApproveWei.toString(),
+      finalWei: approveAmountWei.toString(),
+      slippagePercent: args.slippagePercent,
+      quoteInputWei: quoteInputWei.toString(),
+      ...calldataAmountWei != null ? { swapCalldataAmountWei: calldataAmountWei.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 d = args.createSwapResponse.swap.data ?? "";
+          const t = d.toString().trim();
+          return t.startsWith("0x") ? t.length - 2 : t.length;
+        })()
+      }
+    },
+    fullQuoteFromPermitSnapshot: args.fullQuoteSnapshot,
+    originalPurpose: args.purposeText,
+    innerRouterFromCalldata: permit2Spender,
+    swapToEqualsInnerRouter: usePermit2Triple,
+    ...usePermit2Triple ? {
+      permit2Erc20Approve: {
+        token: tokenIn,
+        spender: PERMIT2_ADDRESS,
+        amountWei: approveAmountWei.toString(),
+        note: "ERC-20 \u2192 allowance hub before hub approve(router)."
+      },
+      permit2ApproveUniversalRouter: {
+        permit2: PERMIT2_ADDRESS,
+        token: tokenIn,
+        spender: permit2Spender,
+        canonicalUniversalRouterFromAppMap: canonicalUniversalRouter,
+        spenderMatchesCanonicalMap: permit2Spender.toLowerCase() === canonicalUniversalRouter.toLowerCase(),
+        amountWei: approveAmountWei.toString(),
+        expiration: expiration48.toString(),
+        note: "Allowance-hub spender must match the router in swap calldata."
+      }
+    } : {
+      erc20ApproveDispatcher: {
+        token: tokenIn,
+        spender: toRouter,
+        amountWei: approveAmountWei.toString(),
+        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 }
+      }
+    }
+  ];
+  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
+      }
+    });
+  }
+  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;
+    }
+  }
+  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/support.ts
+function computeUniswapV4Session(args) {
+  const chainIdNum = typeof args.assetsChainId === "number" ? args.assetsChainId : parseInt(String(args.assetsChainId).trim(), 10);
+  const rpcUrl = (args.rpcUrl ?? "").trim();
+  const chainSupported = args.protocolEnabled && Number.isFinite(chainIdNum) && chainIdNum > 0 && rpcUrl.length > 0 && isUniswapV4ChainSupported(chainIdNum);
+  let universalRouter;
+  if (chainSupported) {
+    try {
+      universalRouter = getUniswapUniversalRouterSpenderOrThrow(chainIdNum);
+    } catch {
+      universalRouter = void 0;
+    }
+  }
+  return {
+    chainId: chainIdNum,
+    rpcUrl,
+    chainSupported,
+    universalRouter
+  };
+}
+
+// src/protocols/evm/uniswap-v4/swap.ts
+async function swapFromQuote(args) {
+  const deadline = args.swapTransactionDeadlineUnix ?? swapTransactionDeadlineUnixFromExpiryMinutes(30);
+  return buildEvmMultisignBodyUniswapV4SkipPermit2Batch({
+    keyGen: args.keyGen,
+    chainId: args.chainId,
+    rpcUrl: args.rpcUrl,
+    chainDetail: args.chainDetail,
+    useCustomGas: args.useCustomGas,
+    customGasChainDetails: args.customGasChainDetails,
+    tokenIn: args.tokenIn,
+    executorAddress: args.executorAddress,
+    swap: args.swap.swap,
+    createSwapResponse: args.swap,
+    fullQuoteSnapshot: args.fullQuote,
+    purposeText: args.purposeText,
+    swapDeadlineUnix: deadline,
+    slippagePercent: args.slippagePercent
+  });
+}
+async function quoteSwap(args) {
+  return uniswapTradeQuote(args);
+}
+async function createSwap(args) {
+  return uniswapCreateSwap(args);
+}
+async function swapExactInput(args) {
+  const swap = await uniswapCreateSwap({
+    uniswapApiKey: args.uniswapApiKey,
+    fullQuoteFromPermit: args.fullQuote,
+    baseUrl: args.baseUrl,
+    swapTransactionDeadlineUnix: args.swapTransactionDeadlineUnix,
+    useServerProxy: false
+  });
+  return swapFromQuote({ ...args, swap });
+}
+
+// src/protocols/evm/uniswap-v4/index.ts
+var UNISWAP_V4_PROTOCOL_ID = "uniswap-v4";
+var uniswapV4ProtocolModule = {
+  id: UNISWAP_V4_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    if (ctx.chainCategory !== "evm") return false;
+    return isUniswapV4ChainSupported(ctx.chainId);
+  },
+  isTokenSupported(token) {
+    if (token.category !== "evm") return false;
+    return token.kind === "native" || token.kind === "erc20";
+  },
+  actions: [
+    {
+      id: "uniswap-v4.swap-exact-input",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Swap ERC-20 or native token via Uniswap V4 Universal Router (classic allowance path)",
+      commonParams: ["keyGen", "purposeText", "useCustomGas"],
+      params: {
+        tokenIn: { type: "address", required: true, description: "Input token (0x0 for native)" },
+        tokenOut: { type: "address", required: true, description: "Output token address" },
+        amount: { type: "string", required: true, description: "Human or wei amount per trade type" },
+        slippagePercent: { type: "number", required: true, description: "Slippage tolerance percent" },
+        swapTransactionDeadlineUnix: {
+          type: "number",
+          required: false,
+          description: "On-chain swap deadline (unix seconds)"
+        },
+        uniswapApiKey: { type: "string", required: true, description: "Uniswap Trade API key" }
+      }
+    },
+    {
+      id: "uniswap-v4.quote",
+      protocolId: UNISWAP_V4_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Fetch Uniswap Trade API quote",
+      commonParams: ["keyGen"],
+      params: {
+        tokenIn: { type: "address", required: true, description: "Input token" },
+        tokenOut: { type: "address", required: true, description: "Output token" },
+        amount: { type: "string", required: true, description: "Amount for quote" },
+        type: { type: "EXACT_INPUT | EXACT_OUTPUT", required: true, description: "Trade type" }
+      }
+    }
+  ]
+};
+registerProtocolModule(uniswapV4ProtocolModule);
+var uniswapV4 = {
+  quoteSwap,
+  createSwap,
+  swapExactInput,
+  swapFromQuote,
+  buildSwapMultisignBody: buildEvmMultisignBodyUniswapV4SkipPermit2Batch,
+  quote: uniswapTradeQuote,
+  isChainSupported: isUniswapV4ChainSupported
+};
+
+export { MAX_UINT160, MAX_UINT48, PERMIT2_ADDRESS, UNISWAP_SWAP_DEFAULT_DEADLINE_SEC_OFFSET, UNISWAP_SWAP_DEFAULT_EXPIRY_MINUTES, UNISWAP_TRADE_BASE_DEFAULT, UNISWAP_UNIVERSAL_ROUTER_DEFAULT_GAS_UNITS, UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT, UNISWAP_V4_PROTOCOL_ID, applySlippagePercentToApproveWei, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildUniswapQuoteRequestBody, buildUniswapV4PurposePrefill, computeUniswapV4Session, createSwap, errorMessageFromUniswapJsonBody, fetchEthereumAddressForKeyGen, formatUniswapAmountFieldFromWei, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, isUniswapFullQuoteResponseNativeIn, isUniswapTokenInAddressNative, isUniswapV4ChainSupported, isUniswapV4SwapEvmSignRequest, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, quoteSwap, resolveRouterSwapGasUnitsFromSignRequest, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, uniswapCreateSwap, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4ProtocolModule };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map