@continuumdao/ctm-mpc-defi 0.2.26 → 0.2.28

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

@@ -1,4 +1,4 @@
-import { parseAbi, parseAbiParameters, parseAbiItem, getAddress, zeroAddress, formatUnits, parseUnits, createPublicClient, http, defineChain, encodeFunctionData, keccak256, encodeAbiParameters, decodeEventLog, decodeFunctionData, parseGwei, serializeTransaction, erc20Abi, hashTypedData, stringToHex } from 'viem';
+import { parseAbi, parseAbiParameters, parseAbiItem, getAddress, createPublicClient, http, defineChain, zeroAddress, formatUnits, parseUnits, encodeFunctionData, keccak256, encodeAbiParameters, decodeEventLog, decodeFunctionData, parseGwei, serializeTransaction, erc20Abi, hashTypedData, stringToHex } from 'viem';
 import { nodeFetchWithReadAuth, fetchChainFeeParams, gasLimitFromEstimateAndChainConfig, gweiToDecimalString, proposalTxParamsToFeeSnapshot, alignEip1559FeesWithLatestBase, getClientIdFromKeyGenResult } from '@continuumdao/continuum-node-sdk';
 
 // src/core/registry.ts
@@ -70,11 +70,23 @@ var UNIVERSAL_ROUTER_SPENDER = {
   /** Robinhood Chain mainnet — Universal Router v2.1.1 (Trade API / interface) */
   4663: "0x8876789976decbfcbbbe364623c63652db8c0904"
 };
+var UNIVERSAL_ROUTER_V2_2_SPENDER = {
+  1: "0xCb640A86855f1A828c27241bA364348de28abe66",
+  11155111: "0xB0C89059d7190EDb17eFF19829cc009cEe923916"
+};
 var UNIVERSAL_ROUTER_VERSION_BY_CHAIN = {
   /** Robinhood has UR 2.1.1 only in the supported-chains table (no 2.0 Trade API column). */
   4663: "2.1.1"
 };
-function getUniswapUniversalRouterVersion(chainId) {
+var UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT = "2.0";
+var UNISWAP_UNIVERSAL_ROUTER_VERSION_PERMISSIONED = "2.2.0";
+function getUniswapUniversalRouterVersion(chainId, opts) {
+  if (opts?.permissioned) {
+    const v22 = UNIVERSAL_ROUTER_V2_2_SPENDER[chainId];
+    if (typeof v22 === "string" && v22.startsWith("0x")) {
+      return UNISWAP_UNIVERSAL_ROUTER_VERSION_PERMISSIONED;
+    }
+  }
   const v = UNIVERSAL_ROUTER_VERSION_BY_CHAIN[chainId];
   return typeof v === "string" && v.trim() ? v.trim() : UNISWAP_UNIVERSAL_ROUTER_VERSION_DEFAULT;
 }
@@ -85,7 +97,11 @@ function isUniswapV4ChainSupported(chainId) {
   const a = UNIVERSAL_ROUTER_SPENDER[n];
   return typeof a === "string" && a.startsWith("0x");
 }
-function getUniswapUniversalRouterSpenderOrThrow(chainId) {
+function getUniswapUniversalRouterSpenderOrThrow(chainId, opts) {
+  if (opts?.permissioned) {
+    const raw22 = UNIVERSAL_ROUTER_V2_2_SPENDER[chainId];
+    if (raw22 && raw22.startsWith("0x")) return getAddress(raw22);
+  }
   const raw = UNIVERSAL_ROUTER_SPENDER[chainId];
   if (!raw || !raw.startsWith("0x")) {
     throw new Error(
@@ -94,12 +110,16 @@ function getUniswapUniversalRouterSpenderOrThrow(chainId) {
   }
   return getAddress(raw);
 }
+function tryGetUniswapUniversalRouterV22(chainId) {
+  const raw = UNIVERSAL_ROUTER_V2_2_SPENDER[chainId];
+  if (!raw || !raw.startsWith("0x")) return null;
+  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_LP_API_BASE_DEFAULT = "https://api.uniswap.org";
-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;
 var UNISWAP_LP_DEFAULT_EXPIRY_MINUTES = 30;
@@ -118,6 +138,18 @@ var POSITION_MANAGER_BY_CHAIN = {
   /** Robinhood Chain mainnet */
   4663: "0x58daec3116aae6D93017bAAea7749052E8a04fA7"
 };
+var PERMISSIONED_POSITION_MANAGER_BY_CHAIN = {
+  1: "0x89628C9B4CE81951a9BC1F36F0688Fad6A6ee248",
+  11155111: "0x68fC145BB20b388965bED184Df5ef912215bb3C7"
+};
+var PERMISSIONED_HOOKS_BY_CHAIN = {
+  1: "0x69603ab16110Eb0bB5f5E9C8019749eE41A128C0",
+  11155111: "0x8B0E8d467af81D9F5B49165e104a2fe1b98328C0"
+};
+var PERMISSIONS_ADAPTER_FACTORY_BY_CHAIN = {
+  1: "0x38f9Ab57FBE2704EbB727cB20e33201aF0E5F961",
+  11155111: "0xEe258C31574fb59660C23534E76AF6497c2e5683"
+};
 var ROBINHOOD_CHAIN_ID = 4663;
 var ROBINHOOD_WETH_ADDRESS = "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73";
 function getUniswapV4PositionManagerOrThrow(chainId) {
@@ -136,6 +168,76 @@ function tryGetUniswapV4PositionManager(chainId) {
     return null;
   }
 }
+function getUniswapV4PermissionedPositionManagerOrThrow(chainId) {
+  const raw = PERMISSIONED_POSITION_MANAGER_BY_CHAIN[chainId];
+  if (!raw || !raw.startsWith("0x") || raw.length !== 42) {
+    throw new Error(
+      `No Uniswap V4 Permissioned PositionManager is configured for chainId ${chainId}.`
+    );
+  }
+  return getAddress(raw);
+}
+function tryGetUniswapV4PermissionedPositionManager(chainId) {
+  try {
+    return getUniswapV4PermissionedPositionManagerOrThrow(chainId);
+  } catch {
+    return null;
+  }
+}
+function getUniswapV4PermissionedHooksOrThrow(chainId) {
+  const raw = PERMISSIONED_HOOKS_BY_CHAIN[chainId];
+  if (!raw || !raw.startsWith("0x") || raw.length !== 42) {
+    throw new Error(`No Uniswap V4 PermissionedHooks is configured for chainId ${chainId}.`);
+  }
+  return getAddress(raw);
+}
+function tryGetUniswapV4PermissionedHooks(chainId) {
+  try {
+    return getUniswapV4PermissionedHooksOrThrow(chainId);
+  } catch {
+    return null;
+  }
+}
+function getUniswapV4PermissionsAdapterFactoryOrThrow(chainId) {
+  const raw = PERMISSIONS_ADAPTER_FACTORY_BY_CHAIN[chainId];
+  if (!raw || !raw.startsWith("0x") || raw.length !== 42) {
+    throw new Error(
+      `No Uniswap V4 PermissionsAdapterFactory is configured for chainId ${chainId}.`
+    );
+  }
+  return getAddress(raw);
+}
+function tryGetUniswapV4PermissionsAdapterFactory(chainId) {
+  try {
+    return getUniswapV4PermissionsAdapterFactoryOrThrow(chainId);
+  } catch {
+    return null;
+  }
+}
+function isUniswapV4PermissionedPositionManager(chainId, address) {
+  if (!address?.toString().trim()) return false;
+  const perm = tryGetUniswapV4PermissionedPositionManager(chainId);
+  if (!perm) return false;
+  try {
+    return getAddress(address) === perm;
+  } catch {
+    return false;
+  }
+}
+function isUniswapV4AnyPositionManager(chainId, address) {
+  if (!address?.toString().trim()) return false;
+  try {
+    const a = getAddress(address);
+    const std = tryGetUniswapV4PositionManager(chainId);
+    const perm = tryGetUniswapV4PermissionedPositionManager(chainId);
+    return std != null && a === std || perm != null && a === perm;
+  } catch {
+    return false;
+  }
+}
+function resolveUniswapV4PositionManager(chainId, kind = "standard") {
+  return kind === "permissioned" ? getUniswapV4PermissionedPositionManagerOrThrow(chainId) : getUniswapV4PositionManagerOrThrow(chainId);
+}
 var POSITION_MANAGER_DEPLOY_BLOCK_BY_CHAIN = {
   /** Ethereum mainnet — Uniswap v4 launch (Jan 2025). */
   1: 22938741n
@@ -151,6 +253,231 @@ var UNISWAP_V4_LP_DECREASE_DEFAULT_GAS_UNITS = 1200000n;
 var UNISWAP_V4_LP_COLLECT_DEFAULT_GAS_UNITS = 900000n;
 var UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK = 100000n;
 var UNISWAP_V4_LP_WETH_DEPOSIT_FALLBACK = 120000n;
+var UNISWAP_V4_LP_PERMIT2_APPROVE_FALLBACK = 100000n;
+var UNISWAP_V4_PERMISSION_FLAG_SWAP = 1;
+var UNISWAP_V4_PERMISSION_FLAG_LIQUIDITY = 2;
+var permissionsAdapterAbi = parseAbi([
+  "function isAllowed(address account, uint8 permission) view returns (bool)",
+  "function PERMISSIONED_TOKEN() view returns (address)"
+]);
+var factoryAbi = parseAbi([
+  "function verifiedPermissionsAdapterOf(address permissionsAdapter) view returns (address)"
+]);
+function normalizeTokenList(tokens) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of tokens) {
+    const t = (raw ?? "").toString().trim();
+    if (!t) continue;
+    if (isUniswapNativeTokenAddress(t)) continue;
+    let addr;
+    try {
+      addr = getAddress(t);
+    } catch {
+      continue;
+    }
+    if (addr === zeroAddress) continue;
+    const key = addr.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(addr);
+    if (out.length >= 2) break;
+  }
+  return out;
+}
+function parsePermissionRow(raw) {
+  const tokenRaw = (raw.token ?? raw.address ?? "").toString().trim();
+  if (!tokenRaw) return null;
+  let token;
+  try {
+    token = getAddress(tokenRaw);
+  } catch {
+    return null;
+  }
+  const isPermissioned = Boolean(raw.isPermissioned);
+  const isAllowlisted = isPermissioned ? Boolean(raw.isAllowlisted) : true;
+  let adapterTokenAddress;
+  const adapterRaw = (raw.adapterTokenAddress ?? "").toString().trim();
+  if (adapterRaw) {
+    try {
+      adapterTokenAddress = getAddress(adapterRaw);
+    } catch {
+    }
+  }
+  const kycUrl = typeof raw.kycUrl === "string" && raw.kycUrl.trim() ? raw.kycUrl.trim() : void 0;
+  const issuer = typeof raw.issuer === "string" && raw.issuer.trim() ? raw.issuer.trim() : void 0;
+  return { token, isPermissioned, isAllowlisted, adapterTokenAddress, kycUrl, issuer };
+}
+async function uniswapV4CheckPermissions(args) {
+  const apiKey = args.uniswapApiKey?.trim();
+  if (!apiKey) throw new Error("uniswapApiKey is required for POST /v1/permissions");
+  const walletAddress = getAddress(args.walletAddress.trim());
+  const chainId = parseUniswapChainId(args.chainId);
+  const tokens = normalizeTokenList(args.tokens);
+  if (tokens.length === 0) {
+    return {
+      results: [],
+      anyPermissioned: false,
+      allAllowlisted: true,
+      requiresUniversalRouterV22: false
+    };
+  }
+  const base = (args.baseUrl?.trim() || UNISWAP_TRADE_BASE_DEFAULT).replace(/\/$/, "");
+  const url = `${base}/permissions`;
+  const fetchFn = args.fetchImpl ?? globalThis.fetch;
+  const res = await fetchFn(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "User-Agent": "ctm-mpc-defi uniswapPermissions/1.0 (TS)",
+      "x-api-key": apiKey
+    },
+    body: JSON.stringify({
+      walletAddress,
+      tokens,
+      chainId
+    }),
+    signal: args.signal
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    throw new Error(
+      `Uniswap POST /permissions failed: ${messageFromUniswapHttpResponseBody(text, res.status, res.statusText)}`
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text.replace(/^\uFEFF/, ""));
+  } catch {
+    throw new Error(
+      `Uniswap POST /permissions: ${messageFromUniswapHttpResponseBody(text, res.status, res.statusText)}`
+    );
+  }
+  const rawResults = Array.isArray(parsed.results) ? parsed.results : [];
+  const results = [];
+  for (const row of rawResults) {
+    if (!row || typeof row !== "object" || Array.isArray(row)) continue;
+    const parsedRow = parsePermissionRow(row);
+    if (parsedRow) results.push(parsedRow);
+  }
+  for (const token of tokens) {
+    if (!results.some((r) => r.token === token)) {
+      results.push({ token, isPermissioned: false, isAllowlisted: true });
+    }
+  }
+  const anyPermissioned = results.some((r) => r.isPermissioned);
+  const allAllowlisted = results.every((r) => !r.isPermissioned || r.isAllowlisted);
+  return {
+    requestId: typeof parsed.requestId === "string" ? parsed.requestId : void 0,
+    results,
+    anyPermissioned,
+    allAllowlisted,
+    requiresUniversalRouterV22: anyPermissioned
+  };
+}
+var UniswapV4PermissionDeniedError = class extends Error {
+  code = "UNISWAP_V4_PERMISSION_DENIED";
+  permissions;
+  blocked;
+  constructor(permissions) {
+    const blocked = permissions.results.filter((r) => r.isPermissioned && !r.isAllowlisted);
+    const issuer = blocked.find((b) => b.issuer)?.issuer;
+    const kycUrl = blocked.find((b) => b.kycUrl)?.kycUrl;
+    const parts = [
+      "Wallet is not allowlisted for one or more permissioned Uniswap V4 tokens.",
+      issuer ? `Issuer: ${issuer}.` : null,
+      kycUrl ? `Complete KYC at: ${kycUrl}` : "Open the issuer KYC URL from check_permissions."
+    ].filter(Boolean);
+    super(parts.join(" "));
+    this.name = "UniswapV4PermissionDeniedError";
+    this.permissions = permissions;
+    this.blocked = blocked;
+  }
+};
+function assertUniswapV4PermissionsAllowlisted(permissions) {
+  if (!permissions.allAllowlisted) {
+    throw new UniswapV4PermissionDeniedError(permissions);
+  }
+}
+async function readUniswapV4OnChainPermissionFlags(args) {
+  const factory = tryGetUniswapV4PermissionsAdapterFactory(args.chainId);
+  if (!factory) return [];
+  const client = args.publicClient ?? createPublicClient({
+    chain: defineChain({
+      id: args.chainId,
+      name: `uniswap-perm-${args.chainId}`,
+      nativeCurrency: { name: "ETH", symbol: "ETH", decimals: 18 },
+      rpcUrls: { default: { http: [args.rpcUrl] } }
+    }),
+    transport: http(args.rpcUrl)
+  });
+  const wallet = getAddress(args.walletAddress);
+  const out = [];
+  for (const raw of args.currencyOrAdapterAddresses) {
+    let address;
+    try {
+      address = getAddress(raw);
+    } catch {
+      continue;
+    }
+    if (address === zeroAddress) continue;
+    let underlying;
+    try {
+      underlying = getAddress(
+        await client.readContract({
+          address: factory,
+          abi: factoryAbi,
+          functionName: "verifiedPermissionsAdapterOf",
+          args: [address]
+        })
+      );
+    } catch {
+      out.push({
+        address,
+        isVerifiedAdapter: false,
+        swapAllowed: true,
+        liquidityAllowed: true
+      });
+      continue;
+    }
+    if (underlying === zeroAddress) {
+      out.push({
+        address,
+        isVerifiedAdapter: false,
+        swapAllowed: true,
+        liquidityAllowed: true
+      });
+      continue;
+    }
+    const [swapAllowed, liquidityAllowed] = await Promise.all([
+      client.readContract({
+        address,
+        abi: permissionsAdapterAbi,
+        functionName: "isAllowed",
+        args: [wallet, UNISWAP_V4_PERMISSION_FLAG_SWAP]
+      }),
+      client.readContract({
+        address,
+        abi: permissionsAdapterAbi,
+        functionName: "isAllowed",
+        args: [wallet, UNISWAP_V4_PERMISSION_FLAG_LIQUIDITY]
+      })
+    ]);
+    out.push({
+      address,
+      isVerifiedAdapter: true,
+      underlyingToken: underlying,
+      swapAllowed: Boolean(swapAllowed),
+      liquidityAllowed: Boolean(liquidityAllowed)
+    });
+  }
+  return out;
+}
+async function uniswapV4CheckPermissionsMcp(args) {
+  return uniswapV4CheckPermissions(args);
+}
+
+// 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",
@@ -400,7 +727,25 @@ async function uniswapTradeQuote(args) {
   const base = args.baseUrl && args.baseUrl.trim() ? args.baseUrl.trim().replace(/\/$/, "") : DEFAULT_TRADE_BASE;
   const quoteUrl = `${base}/quote`;
   const chainIdForRouter = parseUniswapChainId(resolveInputChainId(args));
-  const urv = args.universalRouterVersion && args.universalRouterVersion.trim() || getUniswapUniversalRouterVersion(chainIdForRouter);
+  let permissions;
+  const shouldCheckPermissions = args.forcePermissionedRouter !== true && args.skipPermissionCheck !== true && args.checkPermissions !== false;
+  if (shouldCheckPermissions) {
+    try {
+      permissions = await uniswapV4CheckPermissions({
+        walletAddress: swapper,
+        tokens: [args.tokenIn, args.tokenOut],
+        chainId: chainIdForRouter,
+        uniswapApiKey: apiKey,
+        baseUrl: base,
+        signal: args.signal,
+        fetchImpl: args.fetchImpl
+      });
+    } catch {
+      permissions = void 0;
+    }
+  }
+  const permissionedRouter = args.forcePermissionedRouter === true || Boolean(permissions?.requiresUniversalRouterV22);
+  const urv = args.universalRouterVersion && args.universalRouterVersion.trim() || getUniswapUniversalRouterVersion(chainIdForRouter, { permissioned: permissionedRouter });
   const body = buildUniswapQuoteRequestBody({ ...args, swapper });
   const nativeIn = isUniswapNativeTokenAddress(args.tokenIn);
   const nativeOut = isUniswapNativeTokenAddress(args.tokenOut);
@@ -429,13 +774,27 @@ async function uniswapTradeQuote(args) {
   }
   const forParse = text.replace(/^\uFEFF/, "");
   try {
-    return JSON.parse(forParse);
+    const parsed = JSON.parse(forParse);
+    if (permissionedRouter || urv === UNISWAP_UNIVERSAL_ROUTER_VERSION_PERMISSIONED) {
+      parsed._continuumPermissioned = true;
+      parsed._continuumUniversalRouterVersion = urv;
+    }
+    if (permissions) {
+      parsed._continuumPermissions = permissions;
+    }
+    return parsed;
   } catch {
     throw new Error(
       `Trade API: ${messageFromUniswapHttpResponseBody(text, res.status, res.statusText)}`
     );
   }
 }
+function isUniswapStoredQuotePermissioned(stored) {
+  if (!stored) return false;
+  if (stored._continuumPermissioned === true) return true;
+  const v = stored._continuumUniversalRouterVersion;
+  return typeof v === "string" && v.trim() === UNISWAP_UNIVERSAL_ROUTER_VERSION_PERMISSIONED;
+}
 function uniswapQuoteToJsonQuoteOneLine(quote) {
   return JSON.stringify(quote);
 }
@@ -989,7 +1348,9 @@ async function uniswapCreateSwap(args) {
     quote: classic,
     deadline
   };
-  const urv = (args.universalRouterVersion ?? "").trim() || getUniswapUniversalRouterVersion(resolveChainIdFromStoredUniswapQuote(args.fullQuoteFromPermit));
+  const chainIdForRouter = resolveChainIdFromStoredUniswapQuote(args.fullQuoteFromPermit);
+  const permissioned = isUniswapStoredQuotePermissioned(args.fullQuoteFromPermit);
+  const urv = (args.universalRouterVersion ?? "").trim() || getUniswapUniversalRouterVersion(chainIdForRouter, { permissioned });
   const fn = args.fetchImpl ?? globalThis.fetch;
   const nativeIn = isUniswapFullQuoteResponseNativeIn(args.fullQuoteFromPermit);
   const nativeOut = isUniswapFullQuoteResponseNativeOut(args.fullQuoteFromPermit);
@@ -1117,8 +1478,8 @@ function applySlippagePercentToApproveWei(baseWei, slippagePercent) {
   if (bps <= 0) return baseWei;
   return (baseWei * BigInt(1e4 + bps) + 9999n) / 10000n;
 }
-function permit2SpenderAndApproveWeiFromSwapCalldata(dataHex, tokenIn, quoteInputWei, chainId) {
-  const canonical = getUniswapUniversalRouterSpenderOrThrow(chainId);
+function permit2SpenderAndApproveWeiFromSwapCalldata(dataHex, tokenIn, quoteInputWei, chainId, permissioned = false) {
+  const canonical = getUniswapUniversalRouterSpenderOrThrow(chainId, { permissioned });
   try {
     const d = decodeFunctionData({ abi: uniswapDispatchExecuteAbi, data: dataHex });
     if (d.functionName !== "execute") {
@@ -1254,6 +1615,27 @@ async function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args) {
       "Could not read a positive input amount from the quote. Refresh the quote and ensure the Trade API returned classic quote.input.amount."
     );
   }
+  const permissioned = isUniswapStoredQuotePermissioned(args.fullQuoteSnapshot);
+  if (args.skipPermissionCheck !== true) {
+    const cached = args.fullQuoteSnapshot._continuumPermissions;
+    if (cached && typeof cached === "object" && cached.allAllowlisted === false) {
+      assertUniswapV4PermissionsAllowlisted({
+        results: cached.results ?? [],
+        anyPermissioned: Boolean(cached.anyPermissioned),
+        allAllowlisted: false,
+        requiresUniversalRouterV22: Boolean(cached.requiresUniversalRouterV22)
+      });
+    } else if (args.uniswapApiKey?.trim() && (permissioned || args.tokenOut)) {
+      const tokens = [args.tokenIn, args.tokenOut].filter(Boolean);
+      const permissions = await uniswapV4CheckPermissions({
+        walletAddress: args.executorAddress,
+        tokens,
+        chainId: args.chainId,
+        uniswapApiKey: args.uniswapApiKey.trim()
+      });
+      assertUniswapV4PermissionsAllowlisted(permissions);
+    }
+  }
   if (tokenIn === zeroAddress) {
     return buildEvmMultisignBodyUniswapV4NativeInOnly(args, quoteInputWei);
   }
@@ -1264,12 +1646,15 @@ async function buildEvmMultisignBodyUniswapV4SkipPermit2Batch(args) {
     const d = (args.swap.data ?? "0x").toString().trim();
     return d.startsWith("0x") ? d : `0x${d}`;
   })();
-  const canonicalUniversalRouter = getUniswapUniversalRouterSpenderOrThrow(args.chainId);
+  const canonicalUniversalRouter = getUniswapUniversalRouterSpenderOrThrow(args.chainId, {
+    permissioned
+  });
   const { permit2Spender, approveWei: baseApproveWei, calldataAmountWei } = permit2SpenderAndApproveWeiFromSwapCalldata(
     dataHex,
     tokenIn,
     quoteInputWei,
-    args.chainId
+    args.chainId,
+    permissioned
   );
   const approveAmountWei = applySlippagePercentToApproveWei(baseApproveWei, args.slippagePercent);
   const usePermit2Triple = toRouter.toLowerCase() === permit2Spender.toLowerCase();
@@ -2319,6 +2704,9 @@ var erc20AllowanceAbi2 = parseAbi([
   "function allowance(address owner, address spender) view returns (uint256)",
   "function decimals() view returns (uint8)"
 ]);
+var permit2ApproveAbi = parseAbi([
+  "function approve(address token, address spender, uint160 amount, uint48 expiration)"
+]);
 function parseOptionalGasLimitString2(raw) {
   if (raw == null) return null;
   const s = String(raw).trim();
@@ -2442,7 +2830,9 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
   const dataHex = dataHexFromTx(tx);
   const valueWei = parseTxValueWei(tx);
   const executor = getAddress(args.executorAddress);
-  const spender = to;
+  const positionManagerKind = args.positionManagerKind === "permissioned" || args.positionManagerKind === "standard" ? args.positionManagerKind : isUniswapV4PermissionedPositionManager(args.chainId, to) ? "permissioned" : "standard";
+  const usePermit2 = args.usePermit2Approvals === true || args.usePermit2Approvals !== false && positionManagerKind === "permissioned";
+  const erc20Spender = usePermit2 ? PERMIT2_ADDRESS : to;
   const chain = defineChain({
     id: args.chainId,
     name: `uniswap-v4-lp-${args.chainId}`,
@@ -2450,15 +2840,21 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
     rpcUrls: { default: { http: [args.rpcUrl] } }
   });
   const publicClient = createPublicClient({ chain, transport: http(args.rpcUrl) });
-  const approveTargets = await resolveApproveTargets({
+  const needsTokenApproves = args.action === "mint" || args.action === "increase";
+  const approveTargets = needsTokenApproves ? await resolveApproveTargets({
     publicClient,
     executor,
-    spender,
+    spender: erc20Spender,
     token0: parsed.token0,
     token1: parsed.token1,
     nativeWrapped: args.nativeWrapped
-  });
+  }) : [];
   const steps = [];
+  let permit2Expiration48 = 0n;
+  if (usePermit2 && needsTokenApproves) {
+    permit2Expiration48 = BigInt(Math.floor(Date.now() / 1e3) + UNISWAP_LP_DEFAULT_DEADLINE_SEC_OFFSET);
+    if (permit2Expiration48 > MAX_UINT48) permit2Expiration48 = MAX_UINT48;
+  }
   for (const target of approveTargets) {
     if (target.kind === "weth_deposit") {
       steps.push({
@@ -2471,13 +2867,17 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
         address: target.token,
         abi: erc20AllowanceAbi2,
         functionName: "allowance",
-        args: [executor, spender]
+        args: [executor, erc20Spender]
       });
       if (wethAllowance < target.amount) {
-        if (wethAllowance > 0n) {
+        if (wethAllowance > 0n && !usePermit2) {
           steps.push({
             to: target.token,
-            data: encodeFunctionData({ abi: erc20Abi, functionName: "approve", args: [spender, 0n] }),
+            data: encodeFunctionData({
+              abi: erc20Abi,
+              functionName: "approve",
+              args: [erc20Spender, 0n]
+            }),
             value: 0n,
             fallbackGas: UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK
           });
@@ -2487,7 +2887,7 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
           data: encodeFunctionData({
             abi: erc20Abi,
             functionName: "approve",
-            args: [spender, target.amount]
+            args: [erc20Spender, target.amount]
           }),
           value: 0n,
           fallbackGas: UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK
@@ -2499,13 +2899,66 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
         data: encodeFunctionData({
           abi: erc20Abi,
           functionName: "approve",
-          args: [spender, target.amount]
+          args: [erc20Spender, target.amount]
         }),
         value: 0n,
         fallbackGas: UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK
       });
     }
   }
+  if (usePermit2 && needsTokenApproves) {
+    const pairs = [parsed.token0, parsed.token1].filter(Boolean);
+    for (const row of pairs) {
+      const amt = BigInt(row.amount);
+      if (amt <= 0n) continue;
+      let token;
+      if (isNativeUniswapLpTokenAddress(row.tokenAddress)) {
+        if (!args.nativeWrapped) {
+          throw new Error("nativeWrapped is required when LP uses native ETH (0x0) token.");
+        }
+        token = getAddress(args.nativeWrapped);
+        if (!approveTargets.some((a) => a.token === token && a.kind === "weth_deposit")) {
+          steps.push({
+            to: token,
+            data: encodeFunctionData({ abi: wethDepositAbi, functionName: "deposit" }),
+            value: amt,
+            fallbackGas: UNISWAP_V4_LP_WETH_DEPOSIT_FALLBACK
+          });
+          const wethAllowance = await publicClient.readContract({
+            address: token,
+            abi: erc20AllowanceAbi2,
+            functionName: "allowance",
+            args: [executor, PERMIT2_ADDRESS]
+          });
+          if (wethAllowance < amt) {
+            steps.push({
+              to: token,
+              data: encodeFunctionData({
+                abi: erc20Abi,
+                functionName: "approve",
+                args: [PERMIT2_ADDRESS, amt]
+              }),
+              value: 0n,
+              fallbackGas: UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK
+            });
+          }
+        }
+      } else {
+        token = getAddress(row.tokenAddress);
+      }
+      const amount160 = amt > MAX_UINT160 ? MAX_UINT160 : amt;
+      steps.push({
+        to: PERMIT2_ADDRESS,
+        data: encodeFunctionData({
+          abi: permit2ApproveAbi,
+          functionName: "approve",
+          args: [token, to, amount160, Number(permit2Expiration48)]
+        }),
+        value: 0n,
+        fallbackGas: UNISWAP_V4_LP_PERMIT2_APPROVE_FALLBACK
+      });
+    }
+  }
   const lpFallbackGas = defaultGasForAction(args.action);
   const fromTradeApi = parseOptionalGasLimitString2(tx.gasLimit) ?? parseOptionalGasLimitString2(tx.gas);
   steps.push({
@@ -2517,6 +2970,7 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
   const actionLabel = args.action === "mint" ? "mint liquidity" : args.action === "increase" ? "increase liquidity" : args.action === "decrease" ? "decrease liquidity" : "collect fees";
   const dataNo0x = dataHex.startsWith("0x") ? dataHex.slice(2) : dataHex;
   const lpIndex = steps.length - 1;
+  const purposeSuffix = usePermit2 ? `Uniswap V4 permissioned: ${steps.length}-tx batch \u2014 ${actionLabel} (ERC-20\u2192Permit2, Permit2\u2192PosM, Position Manager).` : `Uniswap V4: ${steps.length}-tx batch \u2014 ${actionLabel} (classic ERC-20 approve + Position Manager).`;
   return buildEvmMultisignBatch({
     context: {
       chainCategory: "evm",
@@ -2530,7 +2984,7 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
       customGasChainDetails: args.customGasChainDetails
     },
     steps,
-    purposeSuffix: `Uniswap V4: ${steps.length}-tx batch \u2014 ${actionLabel} (classic ERC-20 approve + Position Manager).`,
+    purposeSuffix,
     firstMsgRawNo0x: dataNo0x,
     destinationAddress: to,
     buildBatchMeta: ({ index }) => {
@@ -2540,13 +2994,17 @@ async function buildEvmMultisignBodyUniswapV4LiquidityBatchInternal(args) {
           kind: "UniswapV4Liquidity",
           action: args.action,
           step: index,
-          lpTx: isLpStep
+          lpTx: isLpStep,
+          positionManagerKind,
+          usePermit2
         }),
         ...isLpStep ? {
           evm: { type: "uniswap_v4_liquidity_tx", version: 1, chainId: String(args.chainId) },
           uniswapV4Liquidity: {
             action: args.action,
-            skipPermit2Batch: true,
+            skipPermit2Batch: !usePermit2,
+            usePermit2Approvals: usePermit2,
+            positionManagerKind,
             nftTokenId: args.nftTokenId != null ? String(args.nftTokenId) : void 0,
             poolReference: args.poolReference,
             lpResponseSnapshot: args.lpResponse,
@@ -2579,6 +3037,260 @@ async function buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch(args) {
 async function buildEvmMultisignBodyUniswapV4CollectFeesBatch(args) {
   return buildEvmMultisignBodyUniswapV4LiquidityBatchInternal({ ...args, action: "collect" });
 }
+var PERMISSIONED_LP_PRESETS = [
+  // No public launch-partner presets hard-coded yet — use custom existingPool with hooks.
+];
+function buildUniswapV4PermissionedLpPoolRow(args) {
+  const chainId = parseUniswapChainId(args.chainId);
+  const hooks = (args.hooks?.trim() ? getAddress(args.hooks.trim()) : tryGetUniswapV4PermissionedHooks(chainId)) ?? (() => {
+    throw new Error(`No PermissionedHooks for chainId ${chainId}; pass hooks explicitly.`);
+  })();
+  const positionManager = tryGetUniswapV4PermissionedPositionManager(chainId);
+  if (!positionManager) {
+    throw new Error(`No Permissioned PositionManager for chainId ${chainId}.`);
+  }
+  const adapter = getAddress(args.adapterAddress);
+  const other = getAddress(args.otherCurrencyAddress);
+  const sorted = sortUniswapV4PoolCurrencies(adapter, other);
+  const poolReference = computeUniswapV4PoolReference({
+    token0Address: sorted.currency0,
+    token1Address: sorted.currency1,
+    fee: args.fee,
+    tickSpacing: args.tickSpacing,
+    hooks
+  });
+  return {
+    presetId: args.presetId,
+    pairSlug: args.pairSlug,
+    pairLabel: args.pairLabel,
+    fee: args.fee,
+    feeLabel: args.feeLabel,
+    tickSpacing: args.tickSpacing,
+    token0Symbol: sorted.currency0 === adapter ? args.adapterSymbol ?? "v4PT" : args.otherSymbol ?? "TOKEN",
+    token1Symbol: sorted.currency1 === adapter ? args.adapterSymbol ?? "v4PT" : args.otherSymbol ?? "TOKEN",
+    token0Address: sorted.currency0,
+    token1Address: sorted.currency1,
+    poolReference,
+    hooks,
+    nativeWrapped: args.nativeWrapped ? getAddress(args.nativeWrapped) : void 0,
+    usesNativeEth: Boolean(args.usesNativeEth),
+    positionManagerKind: "permissioned",
+    positionManager,
+    underlyingPermissionedToken: args.underlyingPermissionedToken ? getAddress(args.underlyingPermissionedToken) : void 0,
+    adapterAddress: adapter,
+    issuer: args.issuer
+  };
+}
+function listUniswapV4PermissionedLpPools(args) {
+  const chainId = parseUniswapChainId(args.chainId);
+  const positionManager = tryGetUniswapV4PermissionedPositionManager(chainId);
+  const hooks = tryGetUniswapV4PermissionedHooks(chainId);
+  if (!positionManager || !hooks) {
+    return {
+      chainId,
+      chainLabel: `chain ${chainId}`,
+      pools: [],
+      positionManagerKind: "permissioned",
+      notes: "No Permissioned PositionManager / PermissionedHooks configured for this chain. Ethereum mainnet (1) and Sepolia (11155111) are supported. Pass custom existingPool with adapter currency + hooks."
+    };
+  }
+  let pools = PERMISSIONED_LP_PRESETS.filter(
+    (p) => p.chainId === chainId
+  ).map(
+    (p) => buildUniswapV4PermissionedLpPoolRow({
+      chainId,
+      presetId: p.presetId,
+      pairSlug: p.pairSlug,
+      pairLabel: p.pairLabel,
+      fee: p.fee,
+      feeLabel: p.feeLabel,
+      tickSpacing: p.tickSpacing,
+      adapterAddress: p.adapterAddress,
+      otherCurrencyAddress: p.otherCurrency,
+      adapterSymbol: p.adapterSymbol,
+      otherSymbol: p.otherSymbol,
+      underlyingPermissionedToken: p.underlyingPermissionedToken,
+      usesNativeEth: p.usesNativeEth,
+      nativeWrapped: p.nativeWrapped,
+      issuer: p.issuer,
+      hooks
+    })
+  );
+  const pairFilter = args.pair?.trim().toLowerCase();
+  if (pairFilter) {
+    pools = pools.filter(
+      (row) => row.pairSlug.includes(pairFilter) || row.pairLabel.toLowerCase().includes(pairFilter) || row.presetId.includes(pairFilter)
+    );
+  }
+  const chainLabel = PERMISSIONED_LP_PRESETS.find((p) => p.chainId === chainId)?.chainLabel ?? (chainId === 1 ? "Ethereum" : chainId === 11155111 ? "Sepolia" : `chain ${chainId}`);
+  return {
+    chainId,
+    chainLabel,
+    pools,
+    positionManagerKind: "permissioned",
+    notes: `Permissioned LP uses Permissioned Position Manager (UNI-V4-PERM-POSM) and PermissionedHooks. Pool currencies use the Permissions Adapter address, not the underlying token. Requires LIQUIDITY_ALLOWED on the wallet. Curated presets may be empty \u2014 pass existingPool with adapter + hooks + fee/tickSpacing. positionManager=${positionManager} hooks=${hooks}`
+  };
+}
+function resolveUniswapV4PermissionedLpPoolPreset(args) {
+  const listed = listUniswapV4PermissionedLpPools({ chainId: args.chainId });
+  const preset = args.presetId.trim().toLowerCase();
+  const row = listed.pools.find((p) => p.presetId.toLowerCase() === preset);
+  if (!row) {
+    throw new Error(
+      `Unknown permissioned LP pool preset "${args.presetId}" on chainId ${listed.chainId}. Call ctm_uniswap_v4_list_lp_pools with permissioned=true, or pass custom existingPool.`
+    );
+  }
+  return row;
+}
+function uniswapV4ListLpPools(args) {
+  if (args.permissioned) {
+    return listUniswapV4PermissionedLpPools(args);
+  }
+  const std = listUniswapV4StandardLpPools(args);
+  return {
+    ...std,
+    positionManagerKind: "standard"
+  };
+}
+function buildUniswapV4KycApplyLink(args) {
+  const walletAddress = getAddress(args.walletAddress.trim());
+  const chainId = parseUniswapChainId(args.chainId);
+  const kycUrl = args.kycUrl.trim();
+  if (!kycUrl) throw new Error("kycUrl is required");
+  let token;
+  let adapterTokenAddress;
+  if (args.token?.trim()) {
+    try {
+      token = getAddress(args.token.trim());
+    } catch {
+    }
+  }
+  if (args.adapterTokenAddress?.trim()) {
+    try {
+      adapterTokenAddress = getAddress(args.adapterTokenAddress.trim());
+    } catch {
+    }
+  }
+  let applyUrl = kycUrl;
+  try {
+    const u = new URL(kycUrl);
+    if (!u.searchParams.has("wallet") && !u.searchParams.has("address")) {
+      u.searchParams.set("wallet", walletAddress);
+      u.searchParams.set("address", walletAddress);
+    }
+    if (!u.searchParams.has("chainId")) u.searchParams.set("chainId", String(chainId));
+    if (token && !u.searchParams.has("token")) u.searchParams.set("token", token);
+    applyUrl = u.toString();
+  } catch {
+    applyUrl = kycUrl;
+  }
+  return {
+    walletAddress,
+    chainId,
+    issuer: args.issuer?.trim() || void 0,
+    kycUrl,
+    applyUrl,
+    token,
+    adapterTokenAddress
+  };
+}
+function pickUniswapV4KycTarget(results) {
+  return results.find((r) => r.isPermissioned && !r.isAllowlisted && r.kycUrl) ?? results.find((r) => r.isPermissioned && r.kycUrl) ?? null;
+}
+function uniswapV4KycApplyLinkMcp(args) {
+  return buildUniswapV4KycApplyLink(args);
+}
+var ALLOWLIST_FINALIZE_FALLBACK_GAS = 250000n;
+async function buildEvmMultisignBodyUniswapV4PermissionedAllowlistFinalize(args) {
+  const to = getAddress(args.to.trim());
+  let dataHex = (args.data ?? "0x").toString().trim();
+  if (!dataHex.startsWith("0x")) dataHex = `0x${dataHex}`;
+  if (dataHex.length < 10) {
+    throw new Error("allowlist finalize `data` must be non-empty ABI-encoded calldata");
+  }
+  let value = 0n;
+  if (args.valueWei != null && String(args.valueWei).trim() !== "") {
+    try {
+      value = BigInt(String(args.valueWei).trim());
+    } catch {
+      value = 0n;
+    }
+  }
+  const steps = [
+    {
+      to,
+      data: dataHex,
+      value,
+      fallbackGas: ALLOWLIST_FINALIZE_FALLBACK_GAS
+    }
+  ];
+  const dataNo0x = dataHex.slice(2);
+  const issuerLabel = args.issuer?.trim() || "issuer";
+  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: `Uniswap V4 permissioned: 1-tx allowlist finalize (${issuerLabel}).`,
+    firstMsgRawNo0x: dataNo0x,
+    destinationAddress: to,
+    buildBatchMeta: () => ({
+      signatureText: JSON.stringify({
+        kind: "UniswapV4PermissionedAllowlist",
+        issuer: args.issuer,
+        entityId: args.entityId != null ? String(args.entityId) : void 0
+      }),
+      evm: {
+        type: "uniswap_v4_permissioned_allowlist",
+        version: 1,
+        chainId: String(args.chainId)
+      },
+      uniswapV4PermissionedAllowlist: {
+        to,
+        dataNibbles: dataNo0x.length,
+        issuer: args.issuer,
+        entityId: args.entityId != null ? String(args.entityId) : void 0,
+        tokenAddress: args.tokenAddress,
+        originalPurpose: args.purposeText
+      }
+    })
+  });
+}
+function isUniswapV4PermissionedAllowlistEvmSignRequest(detail) {
+  if (!detail) return false;
+  const raw = detail.ExtraJSON ?? detail.extraJSON;
+  let ex = null;
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) ex = raw;
+  else if (typeof raw === "string" && raw.trim()) {
+    try {
+      const p = JSON.parse(raw);
+      if (p && typeof p === "object" && !Array.isArray(p)) ex = p;
+    } catch {
+      return false;
+    }
+  }
+  if (!ex) return false;
+  const bm = ex.batchMeta;
+  if (Array.isArray(bm) && bm[0] && typeof bm[0] === "object" && !Array.isArray(bm[0])) {
+    const evm0 = bm[0].evm;
+    if (evm0 && typeof evm0 === "object" && !Array.isArray(evm0)) {
+      if (String(evm0.type ?? "") === "uniswap_v4_permissioned_allowlist") {
+        return true;
+      }
+    }
+  }
+  const evm = ex.evm;
+  if (!evm || typeof evm !== "object" || Array.isArray(evm)) return false;
+  return String(evm.type ?? "") === "uniswap_v4_permissioned_allowlist";
+}
 
 // src/protocols/evm/uniswap-v4/support.ts
 function computeUniswapV4Session(args) {
@@ -2597,7 +3309,12 @@ function computeUniswapV4Session(args) {
     chainId: chainIdNum,
     rpcUrl,
     chainSupported,
-    universalRouter
+    universalRouter,
+    universalRouterV22: tryGetUniswapUniversalRouterV22(chainIdNum) ?? void 0,
+    positionManager: tryGetUniswapV4PositionManager(chainIdNum) ?? void 0,
+    permissionedPositionManager: tryGetUniswapV4PermissionedPositionManager(chainIdNum) ?? void 0,
+    permissionedHooks: tryGetUniswapV4PermissionedHooks(chainIdNum) ?? void 0,
+    permissionsAdapterFactory: tryGetUniswapV4PermissionsAdapterFactory(chainIdNum) ?? void 0
   };
 }
 
@@ -2888,6 +3605,28 @@ async function fetchUniswapV4PoolMeta(args) {
   );
   return data.pool ?? null;
 }
+var LATEST_SWAP_GQL = `
+query UniswapV4LatestSwap($pool: String!) {
+  swaps(
+    where: { pool: $pool }
+    orderBy: timestamp
+    orderDirection: desc
+    first: 1
+  ) {
+    token0Price
+    sqrtPriceX96
+  }
+}`;
+async function fetchUniswapV4LatestSwap(args) {
+  const pool = normalizePoolId(args.poolReference);
+  const data = await postUniswapV4SubgraphGql(
+    args.chainId,
+    LATEST_SWAP_GQL,
+    { pool },
+    args.theGraphApiKey
+  );
+  return data.swaps?.[0] ?? null;
+}
 
 // src/protocols/evm/uniswap-v4/bitqueryApiKey.ts
 var BITQUERY_API_KEY_ENV = "BITQUERY_API_KEY";
@@ -3176,7 +3915,7 @@ function parseDecimal(raw) {
   const n = Number(raw);
   return Number.isFinite(n) && n > 0 ? n : null;
 }
-function priceFromSwapRow(row) {
+function priceFromUniswapV4SwapRow(row) {
   const fromToken0 = parseDecimal(row.token0Price);
   if (fromToken0 != null) return fromToken0;
   const sqrt = row.sqrtPriceX96?.trim();
@@ -3198,7 +3937,7 @@ function bucketUniswapV4SwapsIntoCandles(args) {
   const buckets = /* @__PURE__ */ new Map();
   for (const swap of args.swaps) {
     const ts = Number(swap.timestamp);
-    const price = priceFromSwapRow(swap);
+    const price = priceFromUniswapV4SwapRow(swap);
     if (!Number.isFinite(ts) || price == null) continue;
     const bucket = bucketStartSec(Math.floor(ts), args.bucketSec);
     const vol = parseDecimal(swap.amountUSD) ?? 0;
@@ -3539,6 +4278,74 @@ async function uniswapV4FetchOhlcv(args) {
   };
 }
 
+// src/protocols/evm/uniswap-v4/livePrice.ts
+function applyPriceQuote(price, quote) {
+  if (!Number.isFinite(price) || price <= 0) return null;
+  if (quote === "token1PerToken0") {
+    const inverted = 1 / price;
+    return Number.isFinite(inverted) && inverted > 0 ? inverted : null;
+  }
+  return price;
+}
+function bitqueryFilterFromPoolReference(poolReference) {
+  const ref = poolReference.trim();
+  if (!ref) return null;
+  if (ref.startsWith("symbol:")) {
+    return { kind: "symbol", symbol: ref.slice("symbol:".length).trim() };
+  }
+  if (ref.startsWith("0x")) {
+    return { kind: "address", address: ref };
+  }
+  return null;
+}
+async function fetchUniswapV4BitqueryLatestClose(args) {
+  const filter = bitqueryFilterFromPoolReference(args.poolReference);
+  if (!filter) return null;
+  const apiKey = resolveBitqueryApiKey(args.bitqueryApiKey);
+  if (!apiKey) return null;
+  const interval = args.interval?.trim() || "15m";
+  const endTimeMs = Date.now();
+  const startTimeMs = endTimeMs - 6 * 3600 * 1e3;
+  const { candles } = await fetchRobinhoodBitqueryOhlcv({
+    filter,
+    interval,
+    startTimeMs,
+    endTimeMs,
+    apiKey,
+    limit: 5
+  });
+  if (candles.length === 0) return null;
+  const last = candles[candles.length - 1];
+  const close = Number(last.close);
+  return Number.isFinite(close) && close > 0 ? close : null;
+}
+async function fetchUniswapV4ChartLivePrice(args) {
+  const chainId = Math.floor(Number(args.chainId));
+  if (!Number.isFinite(chainId) || chainId <= 0) return null;
+  const poolReference = args.poolReference.trim();
+  if (!poolReference) return null;
+  const dataSource = String(args.dataSource ?? "").trim().toLowerCase();
+  if (dataSource === "bitquery" || isRobinhoodOhlcvChain(chainId)) {
+    return fetchUniswapV4BitqueryLatestClose({
+      poolReference,
+      interval: args.interval,
+      bitqueryApiKey: args.bitqueryApiKey
+    });
+  }
+  if (!uniswapV4SubgraphSupportedChainIds().includes(chainId)) {
+    return null;
+  }
+  const row = await fetchUniswapV4LatestSwap({
+    chainId,
+    poolReference,
+    theGraphApiKey: resolveTheGraphApiKey(args.theGraphApiKey)
+  });
+  if (!row) return null;
+  const raw = priceFromUniswapV4SwapRow(row);
+  if (raw == null) return null;
+  return applyPriceQuote(raw, args.priceQuote);
+}
+
 // src/protocols/evm/uniswap-v4/limitOrder.ts
 function trimAddr3(a) {
   return a.trim();
@@ -4032,6 +4839,6 @@ var uniswapV4 = {
   isChainSupported: isUniswapV4ChainSupported
 };
 
-export { BITQUERY_API_KEY_DOCS_URL, BITQUERY_API_KEY_ENV, BITQUERY_API_KEY_SIGNUP_URL, BITQUERY_GRAPHQL_URL, DEFAULT_LIMIT_ORDER_QUOTE_PATH, DEFAULT_ORDER_SUBMIT_PATH, DEFAULT_UNISWAPX_ORDER_BASE, MAX_UINT160, MAX_UINT48, PERMIT2_ADDRESS, ROBINHOOD_CHAIN_ID, ROBINHOOD_WETH_ADDRESS, THE_GRAPH_API_KEY_DOCS_URL, THE_GRAPH_API_KEY_ENV, THE_GRAPH_API_KEY_SIGNUP_URL, UNISWAP_LIMIT_ORDER_CHAIN_ID, UNISWAP_LP_API_BASE_DEFAULT, UNISWAP_LP_DEFAULT_DEADLINE_SEC_OFFSET, UNISWAP_LP_DEFAULT_EXPIRY_MINUTES, UNISWAP_LP_DEFAULT_SLIPPAGE_PERCENT, 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_LP_COLLECT_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_DECREASE_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK, UNISWAP_V4_LP_INCREASE_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_LOG_CHUNK_SIZE_DEFAULT, UNISWAP_V4_LP_LOG_CHUNK_SIZE_MIN, UNISWAP_V4_LP_MINT_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_POOL_LOOKUP_HINT, UNISWAP_V4_LP_POSITION_REGISTRY_HINT, UNISWAP_V4_LP_WETH_DEPOSIT_FALLBACK, UNISWAP_V4_OHLCV_INTERVALS, UNISWAP_V4_PROTOCOL_ID, UNISWAP_V4_SUBGRAPH_ID_BY_CHAIN_ID, aggregateOhlcvCandles, applySlippagePercentToApproveWei, assertUniswapLimitOrderChain, assertUniswapV4OhlcvInterval, bitqueryApiKeyVariablesHint, bitqueryAuthErrorMessage, buildEvmMultisignBodyUniswapV4CollectFeesBatch, buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4LimitOrderBatch, buildEvmMultisignBodyUniswapV4LimitOrderBatchFromMcp, buildEvmMultisignBodyUniswapV4MintLiquidityBatch, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildLimitOrderQuoteRequestBody, buildUniswapQuoteRequestBody, buildUniswapV4PurposePrefill, buildUniswapXLimitOrderSubmitBody, computeUniswapV4PoolReference, computeUniswapV4Session, createSwap, currencyFilterLabel, errorMessageFromUniswapJsonBody, extractPermitDataFromLimitQuote, extractUniswapLpTokenAmounts, extractUniswapLpTransaction, fetchEthereumAddressForKeyGen, fetchRobinhoodBitqueryOhlcv, fetchUniswapV4PoolDayDatas, fetchUniswapV4PoolHourDatas, fetchUniswapV4PoolMeta, fetchUniswapV4Swaps, fetchUniswapXLimitOrders, formatUniswapAmountFieldFromWei, formatUniswapLpAmountHuman, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, formatUniswapV4PositionNotFoundError, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, getUniswapUniversalRouterVersion, getUniswapV4PositionManagerDeployBlock, getUniswapV4PositionManagerOrThrow, isBitqueryAuthOrRateLimitError, isEthGetLogsBlockRangeTooLargeError, isNativeUniswapLpTokenAddress, isRobinhoodOhlcvChain, isTheGraphRateLimitOrAuthError, isUniswapFullQuoteResponseNativeIn, isUniswapFullQuoteResponseNativeOut, isUniswapLimitOrderChainSupported, isUniswapNativeTokenAddress, isUniswapTokenInAddressNative, isUniswapV4ChainSupported, isUniswapV4LiquidityEvmSignRequest, isUniswapV4SwapEvmSignRequest, listUniswapV4PositionsForWallet, listUniswapV4StandardLpPools, mapBitqueryOhlcvRowsToCandles, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapLpApiSnapshot, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, parseUniswapV4ScanFromDateYmd, permitDataToEip712Payload, quoteSwap, readUniswapV4PositionInfoRaw, requireBitqueryApiKey, resolveBitqueryApiKey, resolveBlockAtOrAfterUnixTime, resolveChainIdFromStoredUniswapQuote, resolveInputChainId, resolveRobinhoodChartCurrency, resolveRouterSwapGasUnitsFromSignRequest, resolveTheGraphApiKey, resolveUniswapV4LpExistingPoolFromKey, resolveUniswapV4LpPoolPreset, resolveUniswapV4OhlcvDataTier, resolveUniswapV4OhlcvPool, resolveUniswapV4PositionScanFromDate, sortUniswapV4PoolCurrencies, submitUniswapXLimitOrder, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, theGraphApiKeyVariablesHint, theGraphRateLimitErrorMessage, tryGetUniswapV4PositionManager, uniswapCreateSwap, uniswapFetchLimitOrdersMcp, uniswapLimitOrderQuote, uniswapLpClaimFees, uniswapLpCreatePosition, uniswapLpDecreasePosition, uniswapLpIncreasePosition, uniswapLpTxFieldForAction, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4FetchOhlcv, uniswapV4ListPositionsForMcp, uniswapV4ListPositionsFromRegistryForMcp, uniswapV4ListPositionsRegistryMcpPlaceholder, uniswapV4ListStandardLpPools, uniswapV4OhlcvIntervalToBucketSec, uniswapV4OhlcvSupportedChainIds, uniswapV4PositionMintedTokenIdsFromReceipt, uniswapV4ProtocolModule, uniswapV4RegisterPositionFromMintTxPlaceholder, uniswapV4RegisterPositionNftPlaceholder, uniswapV4SubgraphIdForChain, uniswapV4SubgraphSupportedChainIds, uniswapV4SubgraphUrlForChain };
+export { BITQUERY_API_KEY_DOCS_URL, BITQUERY_API_KEY_ENV, BITQUERY_API_KEY_SIGNUP_URL, BITQUERY_GRAPHQL_URL, DEFAULT_LIMIT_ORDER_QUOTE_PATH, DEFAULT_ORDER_SUBMIT_PATH, DEFAULT_UNISWAPX_ORDER_BASE, MAX_UINT160, MAX_UINT48, PERMIT2_ADDRESS, ROBINHOOD_CHAIN_ID, ROBINHOOD_WETH_ADDRESS, THE_GRAPH_API_KEY_DOCS_URL, THE_GRAPH_API_KEY_ENV, THE_GRAPH_API_KEY_SIGNUP_URL, UNISWAP_LIMIT_ORDER_CHAIN_ID, UNISWAP_LP_API_BASE_DEFAULT, UNISWAP_LP_DEFAULT_DEADLINE_SEC_OFFSET, UNISWAP_LP_DEFAULT_EXPIRY_MINUTES, UNISWAP_LP_DEFAULT_SLIPPAGE_PERCENT, 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_UNIVERSAL_ROUTER_VERSION_PERMISSIONED, UNISWAP_V4_LP_COLLECT_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_DECREASE_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_ERC20_APPROVE_FALLBACK, UNISWAP_V4_LP_INCREASE_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_LOG_CHUNK_SIZE_DEFAULT, UNISWAP_V4_LP_LOG_CHUNK_SIZE_MIN, UNISWAP_V4_LP_MINT_DEFAULT_GAS_UNITS, UNISWAP_V4_LP_PERMIT2_APPROVE_FALLBACK, UNISWAP_V4_LP_POOL_LOOKUP_HINT, UNISWAP_V4_LP_POSITION_REGISTRY_HINT, UNISWAP_V4_LP_WETH_DEPOSIT_FALLBACK, UNISWAP_V4_OHLCV_INTERVALS, UNISWAP_V4_PERMISSION_FLAG_LIQUIDITY, UNISWAP_V4_PERMISSION_FLAG_SWAP, UNISWAP_V4_PROTOCOL_ID, UNISWAP_V4_SUBGRAPH_ID_BY_CHAIN_ID, UniswapV4PermissionDeniedError, aggregateOhlcvCandles, applySlippagePercentToApproveWei, assertUniswapLimitOrderChain, assertUniswapV4OhlcvInterval, assertUniswapV4PermissionsAllowlisted, bitqueryApiKeyVariablesHint, bitqueryAuthErrorMessage, buildEvmMultisignBodyUniswapV4CollectFeesBatch, buildEvmMultisignBodyUniswapV4DecreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4IncreaseLiquidityBatch, buildEvmMultisignBodyUniswapV4LimitOrderBatch, buildEvmMultisignBodyUniswapV4LimitOrderBatchFromMcp, buildEvmMultisignBodyUniswapV4MintLiquidityBatch, buildEvmMultisignBodyUniswapV4PermissionedAllowlistFinalize, buildEvmMultisignBodyUniswapV4SkipPermit2Batch, buildLimitOrderQuoteRequestBody, buildUniswapQuoteRequestBody, buildUniswapV4KycApplyLink, buildUniswapV4PermissionedLpPoolRow, buildUniswapV4PurposePrefill, buildUniswapXLimitOrderSubmitBody, computeUniswapV4PoolReference, computeUniswapV4Session, createSwap, currencyFilterLabel, errorMessageFromUniswapJsonBody, extractPermitDataFromLimitQuote, extractUniswapLpTokenAmounts, extractUniswapLpTransaction, fetchEthereumAddressForKeyGen, fetchRobinhoodBitqueryOhlcv, fetchUniswapV4ChartLivePrice, fetchUniswapV4LatestSwap, fetchUniswapV4PoolDayDatas, fetchUniswapV4PoolHourDatas, fetchUniswapV4PoolMeta, fetchUniswapV4Swaps, fetchUniswapXLimitOrders, formatUniswapAmountFieldFromWei, formatUniswapLpAmountHuman, formatUniswapPercentForUi, formatUniswapQuoteForDisplay, formatUniswapV4PositionNotFoundError, getClassicQuoteFromStoredUniswapResponse, getUniswapUniversalRouterSpenderOrThrow, getUniswapUniversalRouterVersion, getUniswapV4PermissionedHooksOrThrow, getUniswapV4PermissionedPositionManagerOrThrow, getUniswapV4PermissionsAdapterFactoryOrThrow, getUniswapV4PositionManagerDeployBlock, getUniswapV4PositionManagerOrThrow, isBitqueryAuthOrRateLimitError, isEthGetLogsBlockRangeTooLargeError, isNativeUniswapLpTokenAddress, isRobinhoodOhlcvChain, isTheGraphRateLimitOrAuthError, isUniswapFullQuoteResponseNativeIn, isUniswapFullQuoteResponseNativeOut, isUniswapLimitOrderChainSupported, isUniswapNativeTokenAddress, isUniswapStoredQuotePermissioned, isUniswapTokenInAddressNative, isUniswapV4AnyPositionManager, isUniswapV4ChainSupported, isUniswapV4LiquidityEvmSignRequest, isUniswapV4PermissionedAllowlistEvmSignRequest, isUniswapV4PermissionedPositionManager, isUniswapV4SwapEvmSignRequest, listUniswapV4PermissionedLpPools, listUniswapV4PositionsForWallet, listUniswapV4StandardLpPools, mapBitqueryOhlcvRowsToCandles, messageFromUniswapHttpResponseBody, parseUniswapChainId, parseUniswapLpApiSnapshot, parseUniswapQuoteClassicInOut, parseUniswapQuoteSlippageInfo, parseUniswapV4ScanFromDateYmd, permitDataToEip712Payload, pickUniswapV4KycTarget, quoteSwap, readUniswapV4OnChainPermissionFlags, readUniswapV4PositionInfoRaw, requireBitqueryApiKey, resolveBitqueryApiKey, resolveBlockAtOrAfterUnixTime, resolveChainIdFromStoredUniswapQuote, resolveInputChainId, resolveRobinhoodChartCurrency, resolveRouterSwapGasUnitsFromSignRequest, resolveTheGraphApiKey, resolveUniswapV4LpExistingPoolFromKey, resolveUniswapV4LpPoolPreset, resolveUniswapV4OhlcvDataTier, resolveUniswapV4OhlcvPool, resolveUniswapV4PermissionedLpPoolPreset, resolveUniswapV4PositionManager, resolveUniswapV4PositionScanFromDate, sortUniswapV4PoolCurrencies, submitUniswapXLimitOrder, swapExactInput, swapFromQuote, swapTransactionDeadlineUnixFromExpiryMinutes, theGraphApiKeyVariablesHint, theGraphRateLimitErrorMessage, tryGetUniswapUniversalRouterV22, tryGetUniswapV4PermissionedHooks, tryGetUniswapV4PermissionedPositionManager, tryGetUniswapV4PermissionsAdapterFactory, tryGetUniswapV4PositionManager, uniswapCreateSwap, uniswapFetchLimitOrdersMcp, uniswapLimitOrderQuote, uniswapLpClaimFees, uniswapLpCreatePosition, uniswapLpDecreasePosition, uniswapLpIncreasePosition, uniswapLpTxFieldForAction, uniswapQuoteToJsonQuoteOneLine, uniswapTradeQuote, uniswapV4, uniswapV4CheckPermissions, uniswapV4CheckPermissionsMcp, uniswapV4FetchOhlcv, uniswapV4KycApplyLinkMcp, uniswapV4ListLpPools, uniswapV4ListPositionsForMcp, uniswapV4ListPositionsFromRegistryForMcp, uniswapV4ListPositionsRegistryMcpPlaceholder, uniswapV4ListStandardLpPools, uniswapV4OhlcvIntervalToBucketSec, uniswapV4OhlcvSupportedChainIds, uniswapV4PositionMintedTokenIdsFromReceipt, uniswapV4ProtocolModule, uniswapV4RegisterPositionFromMintTxPlaceholder, uniswapV4RegisterPositionNftPlaceholder, uniswapV4SubgraphIdForChain, uniswapV4SubgraphSupportedChainIds, uniswapV4SubgraphUrlForChain };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map