@pafi-dev/trading 0.4.2 → 0.5.0

package/dist/index.cjs

@@ -21,19 +21,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   PAFI_SUBGRAPH_URL: () => import_core10.PAFI_SUBGRAPH_URL,
-  SWAP_EXACT_OUT: () => SWAP_EXACT_OUT,
-  SWAP_EXACT_OUT_SINGLE: () => SWAP_EXACT_OUT_SINGLE,
   TradingHandlers: () => TradingHandlers,
+  V3_SWAP_EXACT_IN: () => V3_SWAP_EXACT_IN,
+  V3_SWAP_EXACT_OUT: () => V3_SWAP_EXACT_OUT,
   buildAllPaths: () => buildAllPaths,
   buildErc20ApprovalCalldata: () => buildErc20ApprovalCalldata,
   buildPermit2ApprovalCalldata: () => buildPermit2ApprovalCalldata,
-  buildSwapFromQuote: () => buildSwapFromQuote,
   buildSwapUserOp: () => buildSwapUserOp,
   buildSwapUserOpExactOut: () => buildSwapUserOpExactOut,
   buildUniversalRouterExecuteArgs: () => buildUniversalRouterExecuteArgs,
   buildUniversalRouterExecuteArgsExactOut: () => buildUniversalRouterExecuteArgsExactOut,
-  buildV4SwapInput: () => buildV4SwapInput,
-  buildV4SwapInputExactOut: () => buildV4SwapInputExactOut,
+  buildV3SwapInputExactIn: () => buildV3SwapInputExactIn,
+  buildV3SwapInputExactOut: () => buildV3SwapInputExactOut,
   checkAllowance: () => checkAllowance,
   combineRoutes: () => combineRoutes,
   fetchPafiPools: () => import_core10.fetchPafiPools,
@@ -58,7 +57,6 @@ var import_core9 = require("@pafi-dev/core");
 
 // src/quoting/routes.ts
 var import_core = require("@pafi-dev/core");
-var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 function combineRoutes(chainId, pointTokenAddress) {
   const commonPools = import_core.COMMON_POOLS[chainId] ?? [];
   const pointPools = import_core.POINT_TOKEN_POOLS[chainId]?.[pointTokenAddress] ?? [];
@@ -66,84 +64,77 @@ 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
 var import_core2 = require("@pafi-dev/core");
-var import_core3 = require("@pafi-dev/core");
-async function quoteExactInput(client, quoterAddress, exactCurrency, path, exactAmount) {
-  const [amountOut, gasEstimate] = await client.readContract({
+async function quoteExactInput(client, quoterAddress, path, exactAmount) {
+  const pathBytes = (0, import_core2.encodeV3Path)(path);
+  const result = await client.readContract({
     address: quoterAddress,
-    abi: import_core2.v4QuoterAbi,
+    abi: import_core2.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: import_core2.v4QuoterAbi,
+    abi: import_core2.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: import_core2.v4QuoterAbi,
+      abi: import_core2.v3QuoterV2Abi,
       functionName: "quoteExactInput",
-      args: [
-        {
-          exactCurrency,
-          path,
-          exactAmount
-        }
-      ]
+      args: [(0, import_core2.encodeV3Path)(path), exactAmount]
     })),
     allowFailure: true
   });
@@ -152,7 +143,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");
@@ -161,7 +160,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(
@@ -170,56 +169,54 @@ 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 ?? import_core3.V4_QUOTER_ADDRESSES[chainId];
+  const quoter = quoterAddress ?? import_core2.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 = import_core3.COMMON_POOLS[chainId] ?? [];
+  const commonPools = import_core2.COMMON_POOLS[chainId] ?? [];
   const allPools = [...pools, ...commonPools];
   const paths = buildAllPaths(allPools, tokenIn, tokenOut, maxHops);
   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 = (0, import_core2.encodeV3PathReversed)(path);
+  const result = await client.readContract({
     address: quoterAddress,
-    abi: import_core2.v4QuoterAbi,
+    abi: import_core2.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: import_core2.v4QuoterAbi,
+    abi: import_core2.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: import_core2.v4QuoterAbi,
+      abi: import_core2.v3QuoterV2Abi,
       functionName: "quoteExactOutput",
-      args: [
-        {
-          exactCurrency,
-          path,
-          exactAmount
-        }
-      ]
+      args: [(0, import_core2.encodeV3PathReversed)(path), exactAmount]
     })),
     allowFailure: true
   });
@@ -228,7 +225,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");
@@ -237,7 +242,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(
@@ -246,43 +251,43 @@ 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 ?? import_core3.V4_QUOTER_ADDRESSES[chainId];
+  const quoter = quoterAddress ?? import_core2.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 = import_core3.COMMON_POOLS[chainId] ?? [];
+  const commonPools = import_core2.COMMON_POOLS[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
 var import_viem = require("viem");
+var import_core3 = require("@pafi-dev/core");
 var import_core4 = require("@pafi-dev/core");
-var import_core5 = require("@pafi-dev/core");
 async function checkAllowance(client, token, owner, spender) {
   return client.readContract({
     address: token,
-    abi: import_core4.erc20Abi,
+    abi: import_core3.erc20Abi,
     functionName: "allowance",
     args: [owner, spender]
   });
 }
 function buildErc20ApprovalCalldata(spender, amount) {
   return (0, import_viem.encodeFunctionData)({
-    abi: import_core4.erc20Abi,
+    abi: import_core3.erc20Abi,
     functionName: "approve",
     args: [spender, amount]
   });
 }
 function buildPermit2ApprovalCalldata(token, spender, amount, expiration) {
   return (0, import_viem.encodeFunctionData)({
-    abi: import_core5.permit2Abi,
+    abi: import_core4.permit2Abi,
     functionName: "approve",
     args: [token, spender, amount, expiration]
   });
@@ -290,173 +295,79 @@ function buildPermit2ApprovalCalldata(token, spender, amount, expiration) {
 
 // src/swap/universalRouter.ts
 var import_viem2 = require("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;
+var import_core5 = require("@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 = (0, import_viem2.encodePacked)(
-    ["uint8", "uint8", "uint8"],
-    [SWAP_EXACT_IN, SETTLE_ALL, TAKE_ALL]
-  );
-  const swapParam = (0, import_viem2.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 = (0, import_viem2.encodeAbiParameters)(
-    [
-      { name: "currency", type: "address" },
-      { name: "maxAmount", type: "uint256" }
-    ],
-    [currencyIn, amountIn]
-  );
-  const takeParam = (0, import_viem2.encodeAbiParameters)(
-    [
-      { name: "currency", type: "address" },
-      { name: "minAmount", type: "uint256" }
-    ],
-    [outputCurrency, minAmountOut]
-  );
-  return (0, import_viem2.encodeAbiParameters)(
-    [
-      { name: "actions", type: "bytes" },
-      { name: "params", type: "bytes[]" }
-    ],
-    [actions, [swapParam, settleParam, takeParam]]
-  );
-}
-function buildUniversalRouterExecuteArgs(currencyIn, path, amountIn, minAmountOut, outputCurrency) {
-  const commands = (0, import_viem2.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 = (0, import_core5.encodeV3Path)(path);
+  return (0, import_viem2.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 = (0, import_viem2.encodePacked)(
-    ["uint8", "uint8", "uint8"],
-    [SWAP_EXACT_OUT, SETTLE_ALL, TAKE_ALL]
-  );
-  const swapParam = (0, import_viem2.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 = (0, import_viem2.encodeAbiParameters)(
-    [
-      { name: "currency", type: "address" },
-      { name: "maxAmount", type: "uint256" }
-    ],
-    [inputCurrency, maxAmountIn]
-  );
-  const takeParam = (0, import_viem2.encodeAbiParameters)(
-    [
-      { name: "currency", type: "address" },
-      { name: "minAmount", type: "uint256" }
-    ],
-    [currencyOut, amountOut]
-  );
-  return (0, import_viem2.encodeAbiParameters)(
-    [
-      { name: "actions", type: "bytes" },
-      { name: "params", type: "bytes[]" }
-    ],
-    [actions, [swapParam, settleParam, takeParam]]
-  );
+  const pathBytes = (0, import_core5.encodeV3PathReversed)(path);
+  return (0, import_viem2.encodeAbiParameters)(V3_EXACT_OUT_INPUT_ABI, [
+    recipient,
+    amountOut,
+    maxAmountIn,
+    pathBytes,
+    true
+    // payerIsUser
+  ]);
 }
-function buildUniversalRouterExecuteArgsExactOut(currencyOut, path, amountOut, maxAmountIn, inputCurrency) {
-  const commands = (0, import_viem2.encodePacked)(["uint8"], [V4_SWAP]);
+function buildUniversalRouterExecuteArgs(recipient, path, amountIn, minAmountOut) {
+  const commands = (0, import_viem2.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 = (0, import_viem2.encodePacked)(["uint8"], [V3_SWAP_EXACT_OUT]);
+  const inputs = [
+    buildV3SwapInputExactOut(recipient, path, amountOut, maxAmountIn)
+  ];
+  return { commands, inputs };
 }
 
 // src/swap/simulate.ts
@@ -496,9 +407,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 PathKey"
+      "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.tokens.length must equal swapPath.fees.length + 1"
     );
   }
   const PERMIT2_EXPIRATION_MAX = 2n ** 48n - 1n;
@@ -508,11 +424,10 @@ function buildSwapUserOp(params) {
     );
   }
   const { commands, inputs } = buildUniversalRouterExecuteArgs(
-    params.inputTokenAddress,
+    params.userAddress,
     params.swapPath,
     params.amountIn,
-    params.minAmountOut,
-    params.outputTokenAddress
+    params.minAmountOut
   );
   const swapCallData = (0, import_viem3.encodeFunctionData)({
     abi: import_core8.universalRouterAbi,
@@ -562,9 +477,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;
@@ -574,11 +494,10 @@ function buildSwapUserOpExactOut(params) {
     );
   }
   const { commands, inputs } = buildUniversalRouterExecuteArgsExactOut(
-    params.outputTokenAddress,
+    params.userAddress,
     params.swapPath,
     params.amountOut,
-    params.maxAmountIn,
-    params.inputTokenAddress
+    params.maxAmountIn
   );
   const swapCallData = (0, import_viem3.encodeFunctionData)({
     abi: import_core8.universalRouterAbi,
@@ -639,7 +558,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
@@ -779,7 +698,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;
@@ -832,11 +751,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.
    *
@@ -897,10 +816,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
@@ -909,7 +828,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.
@@ -979,7 +898,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);
@@ -1302,7 +1221,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;
@@ -1417,7 +1336,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);
@@ -1604,19 +1523,18 @@ async function perpDepositDirect(params) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   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,