@pafi-dev/trading 0.4.2 → 0.5.0

package/dist/index.js

@@ -18,7 +18,6 @@ import {
 
 // src/quoting/routes.ts
 import { COMMON_POOLS, POINT_TOKEN_POOLS } from "@pafi-dev/core";
-var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 function combineRoutes(chainId, pointTokenAddress) {
   const commonPools = COMMON_POOLS[chainId] ?? [];
   const pointPools = POINT_TOKEN_POOLS[chainId]?.[pointTokenAddress] ?? [];
@@ -26,84 +25,83 @@ function combineRoutes(chainId, pointTokenAddress) {
 }
 function buildAllPaths(pools, tokenIn, tokenOut, maxHops = 3) {
   const results = [];
-  function dfs(currentToken, currentPath, usedPoolIndices) {
-    if (currentPath.length > maxHops) return;
-    if (currentPath.length > 0 && currentToken.toLowerCase() === tokenOut.toLowerCase()) {
-      results.push([...currentPath]);
+  function dfs(currentToken, tokens, fees, usedPoolIndices) {
+    const hopsSoFar = tokens.length - 1;
+    if (hopsSoFar > maxHops) return;
+    if (hopsSoFar > 0 && currentToken.toLowerCase() === tokenOut.toLowerCase()) {
+      results.push({ tokens: [...tokens], fees: [...fees] });
       return;
     }
     for (let i = 0; i < pools.length; i++) {
       if (usedPoolIndices.has(i)) continue;
       const pool = pools[i];
-      const c0 = pool.currency0.toLowerCase();
-      const c1 = pool.currency1.toLowerCase();
+      const t0 = pool.token0.toLowerCase();
+      const t1 = pool.token1.toLowerCase();
       const curr = currentToken.toLowerCase();
       let nextToken = null;
-      if (curr === c0) {
-        nextToken = pool.currency1;
-      } else if (curr === c1) {
-        nextToken = pool.currency0;
+      if (curr === t0) {
+        nextToken = pool.token1;
+      } else if (curr === t1) {
+        nextToken = pool.token0;
       }
       if (!nextToken) continue;
-      const hop = {
-        intermediateCurrency: nextToken,
-        fee: pool.fee,
-        tickSpacing: pool.tickSpacing,
-        hooks: pool.hooks ?? ZERO_ADDRESS,
-        hookData: "0x"
-      };
       usedPoolIndices.add(i);
-      currentPath.push(hop);
-      dfs(nextToken, currentPath, usedPoolIndices);
-      currentPath.pop();
+      tokens.push(nextToken);
+      fees.push(pool.fee);
+      dfs(nextToken, tokens, fees, usedPoolIndices);
+      tokens.pop();
+      fees.pop();
       usedPoolIndices.delete(i);
     }
   }
-  dfs(tokenIn, [], /* @__PURE__ */ new Set());
+  dfs(tokenIn, [tokenIn], [], /* @__PURE__ */ new Set());
   return results;
 }
 
 // src/quoting/quote.ts
-import { v4QuoterAbi } from "@pafi-dev/core";
-import { COMMON_POOLS as COMMON_POOLS2, V4_QUOTER_ADDRESSES } from "@pafi-dev/core";
-async function quoteExactInput(client, quoterAddress, exactCurrency, path, exactAmount) {
-  const [amountOut, gasEstimate] = await client.readContract({
+import {
+  COMMON_POOLS as COMMON_POOLS2,
+  QUOTER_V2_ADDRESSES,
+  encodeV3Path,
+  encodeV3PathReversed,
+  v3QuoterV2Abi
+} from "@pafi-dev/core";
+async function quoteExactInput(client, quoterAddress, path, exactAmount) {
+  const pathBytes = encodeV3Path(path);
+  const result = await client.readContract({
     address: quoterAddress,
-    abi: v4QuoterAbi,
+    abi: v3QuoterV2Abi,
     functionName: "quoteExactInput",
-    args: [{ exactCurrency, path, exactAmount }]
+    args: [pathBytes, exactAmount]
   });
+  const [amountOut, , , gasEstimate] = result;
   return { amountOut, gasEstimate, path };
 }
-async function quoteExactInputSingle(client, quoterAddress, poolKey, zeroForOne, exactAmount, hookData) {
-  const [amountOut, gasEstimate] = await client.readContract({
+async function quoteExactInputSingle(client, quoterAddress, tokenIn, tokenOut, fee, exactAmount, sqrtPriceLimitX96 = 0n) {
+  const result = await client.readContract({
     address: quoterAddress,
-    abi: v4QuoterAbi,
+    abi: v3QuoterV2Abi,
     functionName: "quoteExactInputSingle",
     args: [
       {
-        poolKey,
-        zeroForOne,
-        exactAmount,
-        hookData
+        tokenIn,
+        tokenOut,
+        amountIn: exactAmount,
+        fee,
+        sqrtPriceLimitX96
       }
     ]
   });
+  const [amountOut, , , gasEstimate] = result;
   return { amountOut, gasEstimate };
 }
-async function quoteBestRoute(client, quoterAddress, exactCurrency, routes, exactAmount) {
+async function quoteBestRoute(client, quoterAddress, routes, exactAmount) {
   const results = await client.multicall({
     contracts: routes.map((path) => ({
       address: quoterAddress,
-      abi: v4QuoterAbi,
+      abi: v3QuoterV2Abi,
       functionName: "quoteExactInput",
-      args: [
-        {
-          exactCurrency,
-          path,
-          exactAmount
-        }
-      ]
+      args: [encodeV3Path(path), exactAmount]
     })),
     allowFailure: true
   });
@@ -112,7 +110,15 @@ async function quoteBestRoute(client, quoterAddress, exactCurrency, routes, exac
   for (let i = 0; i < results.length; i++) {
     const r = results[i];
     if (r.status === "success") {
-      const [amountOut, gasEstimate] = r.result;
+      const tuple = r.result;
+      if (!Array.isArray(tuple) || tuple.length < 4) {
+        if (firstFailure === void 0) {
+          const len = Array.isArray(tuple) ? tuple.length : "n/a";
+          firstFailure = `unexpected QuoterV2 return shape (length=${len})`;
+        }
+        continue;
+      }
+      const [amountOut, , , gasEstimate] = tuple;
       allRoutes.push({ amountOut, gasEstimate, path: routes[i] });
     } else if (firstFailure === void 0) {
       const errMsg = r.error instanceof Error ? r.error.message : String(r.error ?? "unknown");
@@ -121,7 +127,7 @@ async function quoteBestRoute(client, quoterAddress, exactCurrency, routes, exac
   }
   if (allRoutes.length === 0) {
     throw new Error(
-      `No valid routes found from ${exactCurrency} (${routes.length} candidates probed)` + (firstFailure ? `; first failure: ${firstFailure}` : "")
+      `No valid routes found (${routes.length} candidates probed)` + (firstFailure ? `; first failure: ${firstFailure}` : "")
     );
   }
   const bestRoute = allRoutes.reduce(
@@ -130,9 +136,9 @@ async function quoteBestRoute(client, quoterAddress, exactCurrency, routes, exac
   return { bestRoute, allRoutes };
 }
 async function findBestQuote(client, chainId, tokenIn, tokenOut, exactAmount, pools = [], quoterAddress, maxHops = 3) {
-  const quoter = quoterAddress ?? V4_QUOTER_ADDRESSES[chainId];
+  const quoter = quoterAddress ?? QUOTER_V2_ADDRESSES[chainId];
   if (!quoter) {
-    throw new Error(`No V4 Quoter address configured for chain ${chainId}`);
+    throw new Error(`No V3 QuoterV2 address configured for chain ${chainId}`);
   }
   const commonPools = COMMON_POOLS2[chainId] ?? [];
   const allPools = [...pools, ...commonPools];
@@ -140,46 +146,44 @@ async function findBestQuote(client, chainId, tokenIn, tokenOut, exactAmount, po
   if (paths.length === 0) {
     throw new Error(`No paths found from ${tokenIn} to ${tokenOut}`);
   }
-  return quoteBestRoute(client, quoter, tokenIn, paths, exactAmount);
+  return quoteBestRoute(client, quoter, paths, exactAmount);
 }
-async function quoteExactOutput(client, quoterAddress, exactCurrency, path, exactAmount) {
-  const [amountIn, gasEstimate] = await client.readContract({
+async function quoteExactOutput(client, quoterAddress, path, exactAmount) {
+  const pathBytes = encodeV3PathReversed(path);
+  const result = await client.readContract({
     address: quoterAddress,
-    abi: v4QuoterAbi,
+    abi: v3QuoterV2Abi,
     functionName: "quoteExactOutput",
-    args: [{ exactCurrency, path, exactAmount }]
+    args: [pathBytes, exactAmount]
   });
+  const [amountIn, , , gasEstimate] = result;
   return { amountIn, gasEstimate, path };
 }
-async function quoteExactOutputSingle(client, quoterAddress, poolKey, zeroForOne, exactAmount, hookData) {
-  const [amountIn, gasEstimate] = await client.readContract({
+async function quoteExactOutputSingle(client, quoterAddress, tokenIn, tokenOut, fee, exactAmount, sqrtPriceLimitX96 = 0n) {
+  const result = await client.readContract({
     address: quoterAddress,
-    abi: v4QuoterAbi,
+    abi: v3QuoterV2Abi,
     functionName: "quoteExactOutputSingle",
     args: [
       {
-        poolKey,
-        zeroForOne,
-        exactAmount,
-        hookData
+        tokenIn,
+        tokenOut,
+        amount: exactAmount,
+        fee,
+        sqrtPriceLimitX96
       }
     ]
   });
+  const [amountIn, , , gasEstimate] = result;
   return { amountIn, gasEstimate };
 }
-async function quoteBestRouteExactOut(client, quoterAddress, exactCurrency, routes, exactAmount) {
+async function quoteBestRouteExactOut(client, quoterAddress, routes, exactAmount) {
   const results = await client.multicall({
     contracts: routes.map((path) => ({
       address: quoterAddress,
-      abi: v4QuoterAbi,
+      abi: v3QuoterV2Abi,
       functionName: "quoteExactOutput",
-      args: [
-        {
-          exactCurrency,
-          path,
-          exactAmount
-        }
-      ]
+      args: [encodeV3PathReversed(path), exactAmount]
     })),
     allowFailure: true
   });
@@ -188,7 +192,15 @@ async function quoteBestRouteExactOut(client, quoterAddress, exactCurrency, rout
   for (let i = 0; i < results.length; i++) {
     const r = results[i];
     if (r.status === "success") {
-      const [amountIn, gasEstimate] = r.result;
+      const tuple = r.result;
+      if (!Array.isArray(tuple) || tuple.length < 4) {
+        if (firstFailure === void 0) {
+          const len = Array.isArray(tuple) ? tuple.length : "n/a";
+          firstFailure = `unexpected QuoterV2 return shape (length=${len})`;
+        }
+        continue;
+      }
+      const [amountIn, , , gasEstimate] = tuple;
       allRoutes.push({ amountIn, gasEstimate, path: routes[i] });
     } else if (firstFailure === void 0) {
       const errMsg = r.error instanceof Error ? r.error.message : String(r.error ?? "unknown");
@@ -197,7 +209,7 @@ async function quoteBestRouteExactOut(client, quoterAddress, exactCurrency, rout
   }
   if (allRoutes.length === 0) {
     throw new Error(
-      `No valid exact-output routes found to ${exactCurrency} (${routes.length} candidates probed)` + (firstFailure ? `; first failure: ${firstFailure}` : "")
+      `No valid exact-output routes found (${routes.length} candidates probed)` + (firstFailure ? `; first failure: ${firstFailure}` : "")
     );
   }
   const bestRoute = allRoutes.reduce(
@@ -206,19 +218,19 @@ async function quoteBestRouteExactOut(client, quoterAddress, exactCurrency, rout
   return { bestRoute, allRoutes };
 }
 async function findBestQuoteExactOut(client, chainId, tokenIn, tokenOut, exactAmount, pools = [], quoterAddress, maxHops = 3) {
-  const quoter = quoterAddress ?? V4_QUOTER_ADDRESSES[chainId];
+  const quoter = quoterAddress ?? QUOTER_V2_ADDRESSES[chainId];
   if (!quoter) {
-    throw new Error(`No V4 Quoter address configured for chain ${chainId}`);
+    throw new Error(`No V3 QuoterV2 address configured for chain ${chainId}`);
   }
   const commonPools = COMMON_POOLS2[chainId] ?? [];
   const allPools = [...pools, ...commonPools];
-  const paths = buildAllPaths(allPools, tokenOut, tokenIn, maxHops);
+  const paths = buildAllPaths(allPools, tokenIn, tokenOut, maxHops);
   if (paths.length === 0) {
     throw new Error(
-      `No exact-output paths found to ${tokenOut} from ${tokenIn}`
+      `No exact-output paths found from ${tokenIn} to ${tokenOut}`
     );
   }
-  return quoteBestRouteExactOut(client, quoter, tokenOut, paths, exactAmount);
+  return quoteBestRouteExactOut(client, quoter, paths, exactAmount);
 }
 
 // src/swap/approval.ts
@@ -250,173 +262,79 @@ function buildPermit2ApprovalCalldata(token, spender, amount, expiration) {
 
 // src/swap/universalRouter.ts
 import { encodeAbiParameters, encodePacked } from "viem";
-var V4_SWAP = 16;
-var SWAP_EXACT_IN = 7;
-var SWAP_EXACT_OUT_SINGLE = 8;
-var SWAP_EXACT_OUT = 9;
-var SETTLE_ALL = 12;
-var TAKE_ALL = 15;
+import { encodeV3Path as encodeV3Path2, encodeV3PathReversed as encodeV3PathReversed2 } from "@pafi-dev/core";
+var V3_SWAP_EXACT_IN = 0;
+var V3_SWAP_EXACT_OUT = 1;
 var UINT128_MAX = 2n ** 128n - 1n;
-var PATH_KEY_ABI_COMPONENTS = [
-  { name: "intermediateCurrency", type: "address" },
-  { name: "fee", type: "uint256" },
-  { name: "tickSpacing", type: "int24" },
-  { name: "hooks", type: "address" },
-  { name: "hookData", type: "bytes" }
+var V3_EXACT_IN_INPUT_ABI = [
+  { name: "recipient", type: "address" },
+  { name: "amountIn", type: "uint256" },
+  { name: "amountOutMinimum", type: "uint256" },
+  { name: "path", type: "bytes" },
+  { name: "payerIsUser", type: "bool" }
 ];
-var EXACT_INPUT_PARAMS_ABI = [
-  { name: "currencyIn", type: "address" },
-  {
-    name: "path",
-    type: "tuple[]",
-    components: PATH_KEY_ABI_COMPONENTS
-  },
-  { name: "amountIn", type: "uint128" },
-  { name: "amountOutMinimum", type: "uint128" }
+var V3_EXACT_OUT_INPUT_ABI = [
+  { name: "recipient", type: "address" },
+  { name: "amountOut", type: "uint256" },
+  { name: "amountInMaximum", type: "uint256" },
+  { name: "path", type: "bytes" },
+  { name: "payerIsUser", type: "bool" }
 ];
-var EXACT_OUTPUT_PARAMS_ABI = [
-  { name: "currencyOut", type: "address" },
-  {
-    name: "path",
-    type: "tuple[]",
-    components: PATH_KEY_ABI_COMPONENTS
-  },
-  { name: "amountOut", type: "uint128" },
-  { name: "amountInMaximum", type: "uint128" }
-];
-function buildV4SwapInput(currencyIn, path, amountIn, minAmountOut, outputCurrency) {
-  const actions = encodePacked(
-    ["uint8", "uint8", "uint8"],
-    [SWAP_EXACT_IN, SETTLE_ALL, TAKE_ALL]
-  );
-  const swapParam = encodeAbiParameters(
-    [{ name: "swap", type: "tuple", components: EXACT_INPUT_PARAMS_ABI }],
-    [
-      {
-        currencyIn,
-        path: path.map((p) => ({
-          intermediateCurrency: p.intermediateCurrency,
-          fee: BigInt(p.fee),
-          tickSpacing: p.tickSpacing,
-          hooks: p.hooks,
-          hookData: p.hookData
-        })),
-        amountIn,
-        amountOutMinimum: minAmountOut
-      }
-    ]
-  );
-  const settleParam = encodeAbiParameters(
-    [
-      { name: "currency", type: "address" },
-      { name: "maxAmount", type: "uint256" }
-    ],
-    [currencyIn, amountIn]
-  );
-  const takeParam = encodeAbiParameters(
-    [
-      { name: "currency", type: "address" },
-      { name: "minAmount", type: "uint256" }
-    ],
-    [outputCurrency, minAmountOut]
-  );
-  return encodeAbiParameters(
-    [
-      { name: "actions", type: "bytes" },
-      { name: "params", type: "bytes[]" }
-    ],
-    [actions, [swapParam, settleParam, takeParam]]
-  );
-}
-function buildUniversalRouterExecuteArgs(currencyIn, path, amountIn, minAmountOut, outputCurrency) {
-  const commands = encodePacked(["uint8"], [V4_SWAP]);
-  const inputs = [
-    buildV4SwapInput(currencyIn, path, amountIn, minAmountOut, outputCurrency)
-  ];
-  return { commands, inputs };
+function buildV3SwapInputExactIn(recipient, path, amountIn, minAmountOut) {
+  if (amountIn <= 0n || amountIn > UINT128_MAX) {
+    throw new Error(
+      `buildV3SwapInputExactIn: amountIn (${amountIn}) must be in (0, 2^128-1]`
+    );
+  }
+  if (minAmountOut < 0n) {
+    throw new Error(
+      `buildV3SwapInputExactIn: minAmountOut (${minAmountOut}) must be non-negative`
+    );
+  }
+  const pathBytes = encodeV3Path2(path);
+  return encodeAbiParameters(V3_EXACT_IN_INPUT_ABI, [
+    recipient,
+    amountIn,
+    minAmountOut,
+    pathBytes,
+    true
+    // payerIsUser — router pulls via Permit2 (the SDK's only flow)
+  ]);
 }
-function buildV4SwapInputExactOut(currencyOut, path, amountOut, maxAmountIn, inputCurrency) {
+function buildV3SwapInputExactOut(recipient, path, amountOut, maxAmountIn) {
   if (amountOut <= 0n || amountOut > UINT128_MAX) {
     throw new Error(
-      `buildV4SwapInputExactOut: amountOut (${amountOut}) must be in (0, 2^128-1]`
+      `buildV3SwapInputExactOut: amountOut (${amountOut}) must be in (0, 2^128-1]`
     );
   }
   if (maxAmountIn <= 0n || maxAmountIn > UINT128_MAX) {
     throw new Error(
-      `buildV4SwapInputExactOut: maxAmountIn (${maxAmountIn}) must be in (0, 2^128-1]`
+      `buildV3SwapInputExactOut: maxAmountIn (${maxAmountIn}) must be in (0, 2^128-1]`
     );
   }
-  const actions = encodePacked(
-    ["uint8", "uint8", "uint8"],
-    [SWAP_EXACT_OUT, SETTLE_ALL, TAKE_ALL]
-  );
-  const swapParam = encodeAbiParameters(
-    [{ name: "swap", type: "tuple", components: EXACT_OUTPUT_PARAMS_ABI }],
-    [
-      {
-        currencyOut,
-        path: path.map((p) => ({
-          intermediateCurrency: p.intermediateCurrency,
-          fee: BigInt(p.fee),
-          tickSpacing: p.tickSpacing,
-          hooks: p.hooks,
-          hookData: p.hookData
-        })),
-        amountOut,
-        amountInMaximum: maxAmountIn
-      }
-    ]
-  );
-  const settleParam = encodeAbiParameters(
-    [
-      { name: "currency", type: "address" },
-      { name: "maxAmount", type: "uint256" }
-    ],
-    [inputCurrency, maxAmountIn]
-  );
-  const takeParam = encodeAbiParameters(
-    [
-      { name: "currency", type: "address" },
-      { name: "minAmount", type: "uint256" }
-    ],
-    [currencyOut, amountOut]
-  );
-  return encodeAbiParameters(
-    [
-      { name: "actions", type: "bytes" },
-      { name: "params", type: "bytes[]" }
-    ],
-    [actions, [swapParam, settleParam, takeParam]]
-  );
+  const pathBytes = encodeV3PathReversed2(path);
+  return encodeAbiParameters(V3_EXACT_OUT_INPUT_ABI, [
+    recipient,
+    amountOut,
+    maxAmountIn,
+    pathBytes,
+    true
+    // payerIsUser
+  ]);
 }
-function buildUniversalRouterExecuteArgsExactOut(currencyOut, path, amountOut, maxAmountIn, inputCurrency) {
-  const commands = encodePacked(["uint8"], [V4_SWAP]);
+function buildUniversalRouterExecuteArgs(recipient, path, amountIn, minAmountOut) {
+  const commands = encodePacked(["uint8"], [V3_SWAP_EXACT_IN]);
   const inputs = [
-    buildV4SwapInputExactOut(
-      currencyOut,
-      path,
-      amountOut,
-      maxAmountIn,
-      inputCurrency
-    )
+    buildV3SwapInputExactIn(recipient, path, amountIn, minAmountOut)
   ];
   return { commands, inputs };
 }
-var _buildSwapFromQuoteWarned = false;
-function buildSwapFromQuote(params) {
-  if (!_buildSwapFromQuoteWarned) {
-    _buildSwapFromQuoteWarned = true;
-    console.warn(
-      "[PAFI] DEPRECATION (v1.4+): `buildSwapFromQuote` from @pafi-dev/trading is deprecated and will be removed in v2.0. Use `buildUniversalRouterExecuteArgs` directly with `quote.bestRoute.path`."
-    );
-  }
-  return buildUniversalRouterExecuteArgs(
-    params.currencyIn,
-    params.quote.path,
-    params.amountIn,
-    params.minAmountOut,
-    params.currencyOut
-  );
+function buildUniversalRouterExecuteArgsExactOut(recipient, path, amountOut, maxAmountIn) {
+  const commands = encodePacked(["uint8"], [V3_SWAP_EXACT_OUT]);
+  const inputs = [
+    buildV3SwapInputExactOut(recipient, path, amountOut, maxAmountIn)
+  ];
+  return { commands, inputs };
 }
 
 // src/swap/simulate.ts
@@ -463,9 +381,14 @@ function buildSwapUserOp(params) {
       "buildSwapUserOp: minAmountOut must be >= gasFeeAmountOutput so the post-swap fee transfer cannot revert"
     );
   }
-  if (params.swapPath.length === 0) {
+  if (params.swapPath.tokens.length < 2 || params.swapPath.fees.length < 1) {
+    throw new Error(
+      "buildSwapUserOp: swapPath must contain at least one hop (>=2 tokens, >=1 fee)"
+    );
+  }
+  if (params.swapPath.tokens.length !== params.swapPath.fees.length + 1) {
     throw new Error(
-      "buildSwapUserOp: swapPath must contain at least one PathKey"
+      "buildSwapUserOp: swapPath.tokens.length must equal swapPath.fees.length + 1"
     );
   }
   const PERMIT2_EXPIRATION_MAX = 2n ** 48n - 1n;
@@ -475,11 +398,10 @@ function buildSwapUserOp(params) {
     );
   }
   const { commands, inputs } = buildUniversalRouterExecuteArgs(
-    params.inputTokenAddress,
+    params.userAddress,
     params.swapPath,
     params.amountIn,
-    params.minAmountOut,
-    params.outputTokenAddress
+    params.minAmountOut
   );
   const swapCallData = encodeFunctionData2({
     abi: universalRouterAbi2,
@@ -529,9 +451,14 @@ function buildSwapUserOpExactOut(params) {
       "buildSwapUserOpExactOut: gasFeeAmountInput must be non-negative"
     );
   }
-  if (params.swapPath.length === 0) {
+  if (params.swapPath.tokens.length < 2 || params.swapPath.fees.length < 1) {
     throw new Error(
-      "buildSwapUserOpExactOut: swapPath must contain at least one PathKey"
+      "buildSwapUserOpExactOut: swapPath must contain at least one hop (>=2 tokens, >=1 fee)"
+    );
+  }
+  if (params.swapPath.tokens.length !== params.swapPath.fees.length + 1) {
+    throw new Error(
+      "buildSwapUserOpExactOut: swapPath.tokens.length must equal swapPath.fees.length + 1"
     );
   }
   const PERMIT2_EXPIRATION_MAX = 2n ** 48n - 1n;
@@ -541,11 +468,10 @@ function buildSwapUserOpExactOut(params) {
     );
   }
   const { commands, inputs } = buildUniversalRouterExecuteArgsExactOut(
-    params.outputTokenAddress,
+    params.userAddress,
     params.swapPath,
     params.amountOut,
-    params.maxAmountIn,
-    params.inputTokenAddress
+    params.maxAmountIn
   );
   const swapCallData = encodeFunctionData2({
     abi: universalRouterAbi2,
@@ -606,7 +532,7 @@ var TradingHandlers = class {
   // GET /quote
   // =========================================================================
   /**
-   * Quote exact-input PT → USDT via Uniswap V4 on-chain Quoter.
+   * Quote exact-input PT → USDT via Uniswap V3 QuoterV2.
    *
    * Uses multicall to batch all candidate routes into a single RPC call.
    * Returns `quoteError: "QUOTE_UNAVAILABLE"` when no pool/path exists
@@ -746,7 +672,7 @@ var TradingHandlers = class {
       request.chainId,
       outputTokenAddress
     ).catch(() => 0n);
-    const hops = quoteResult.bestRoute.path.length;
+    const hops = quoteResult.bestRoute.path.fees.length;
     const slippageBps = request.slippageBps ?? (hops > 1 ? 100 : 50);
     const estimatedOutputAmount = quoteResult.bestRoute.amountOut;
     const minAmountOut = estimatedOutputAmount * BigInt(1e4 - slippageBps) / 10000n;
@@ -799,11 +725,11 @@ var TradingHandlers = class {
     };
   }
   // =========================================================================
-  // GET /quote/exact-out — V4 exact-output quote
+  // GET /quote/exact-out — V3 exact-output quote
   // =========================================================================
   /**
    * Quote the input required to receive `request.amount` of the output
-   * token via Uniswap V4. Input-side operator fee is auto-quoted, so
+   * token via Uniswap V3 QuoterV2. Input-side operator fee is auto-quoted, so
    * `inputGross = estimatedInputAmount + feeAmountInput` is the total
    * the user must hold.
    *
@@ -864,10 +790,10 @@ var TradingHandlers = class {
     }
   }
   // =========================================================================
-  // POST /swap/exact-out — V4 exact-output swap UserOp
+  // POST /swap/exact-out — V3 exact-output swap UserOp
   // =========================================================================
   /**
-   * Build a V4 exact-output swap UserOp.
+   * Build a V3 exact-output swap UserOp.
    *
    * Quotes the best exact-output route, applies slippage as a CEILING on
    * `maxAmountIn` (so the cap is never silently tightened by floor
@@ -876,7 +802,7 @@ var TradingHandlers = class {
    *   inputToken.transfer(feeRecipient, gasFeeAmountInput)  [if > 0]
    *     → input.approve(Permit2, maxAmountIn)
    *     → Permit2.approve(router, maxAmountIn)
-   *     → UniversalRouter.execute (V4 SWAP_EXACT_OUT)
+   *     → UniversalRouter.execute (V3_SWAP_EXACT_OUT)
    *
    * Operator fee is INPUT-token-side (charged before swap) so the user
    * receives exactly `request.amount` of output.
@@ -946,7 +872,7 @@ var TradingHandlers = class {
       request.chainId,
       inputTokenAddress
     ).catch(() => 0n);
-    const hops = quoteResult.bestRoute.path.length;
+    const hops = quoteResult.bestRoute.path.fees.length;
     const slippageBps = request.slippageBps ?? (hops > 1 ? 100 : 50);
     const estimatedInputAmount = quoteResult.bestRoute.amountIn;
     const slippageNumerator = estimatedInputAmount * BigInt(1e4 + slippageBps);
@@ -1276,7 +1202,7 @@ async function swapDirect(params) {
       `swapDirect: no swap path found from ${params.inputTokenAddress} to ${params.outputTokenAddress} (cause: ${cause})`
     );
   }
-  const hops = quoteResult.bestRoute.path.length;
+  const hops = quoteResult.bestRoute.path.fees.length;
   const slippageBps = params.slippageBps ?? (hops > 1 ? 100 : 50);
   const estimatedOutputAmount = quoteResult.bestRoute.amountOut;
   const minAmountOut = estimatedOutputAmount * BigInt(1e4 - slippageBps) / 10000n;
@@ -1398,7 +1324,7 @@ async function swapDirectExactOut(params) {
       `swapDirectExactOut: no swap path found from ${params.inputTokenAddress} to ${params.outputTokenAddress} (cause: ${cause})`
     );
   }
-  const hops = quoteResult.bestRoute.path.length;
+  const hops = quoteResult.bestRoute.path.fees.length;
   const slippageBps = params.slippageBps ?? (hops > 1 ? 100 : 50);
   const estimatedInputAmount = quoteResult.bestRoute.amountIn;
   const slippageNumerator = estimatedInputAmount * BigInt(1e4 + slippageBps);
@@ -1597,19 +1523,18 @@ async function perpDepositDirect(params) {
 }
 export {
   PAFI_SUBGRAPH_URL,
-  SWAP_EXACT_OUT,
-  SWAP_EXACT_OUT_SINGLE,
   TradingHandlers,
+  V3_SWAP_EXACT_IN,
+  V3_SWAP_EXACT_OUT,
   buildAllPaths,
   buildErc20ApprovalCalldata,
   buildPermit2ApprovalCalldata,
-  buildSwapFromQuote,
   buildSwapUserOp,
   buildSwapUserOpExactOut,
   buildUniversalRouterExecuteArgs,
   buildUniversalRouterExecuteArgsExactOut,
-  buildV4SwapInput,
-  buildV4SwapInputExactOut,
+  buildV3SwapInputExactIn,
+  buildV3SwapInputExactOut,
   checkAllowance,
   combineRoutes,
   fetchPafiPools,