@pafi-dev/trading 0.4.0 → 0.4.2

package/dist/index.cjs

@@ -21,24 +21,34 @@ 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,
   buildAllPaths: () => buildAllPaths,
   buildErc20ApprovalCalldata: () => buildErc20ApprovalCalldata,
   buildPermit2ApprovalCalldata: () => buildPermit2ApprovalCalldata,
   buildSwapFromQuote: () => buildSwapFromQuote,
   buildSwapUserOp: () => buildSwapUserOp,
+  buildSwapUserOpExactOut: () => buildSwapUserOpExactOut,
   buildUniversalRouterExecuteArgs: () => buildUniversalRouterExecuteArgs,
+  buildUniversalRouterExecuteArgsExactOut: () => buildUniversalRouterExecuteArgsExactOut,
   buildV4SwapInput: () => buildV4SwapInput,
+  buildV4SwapInputExactOut: () => buildV4SwapInputExactOut,
   checkAllowance: () => checkAllowance,
   combineRoutes: () => combineRoutes,
   fetchPafiPools: () => import_core10.fetchPafiPools,
   findBestQuote: () => findBestQuote,
+  findBestQuoteExactOut: () => findBestQuoteExactOut,
   perpDepositDirect: () => perpDepositDirect,
   quoteBestRoute: () => quoteBestRoute,
+  quoteBestRouteExactOut: () => quoteBestRouteExactOut,
   quoteExactInput: () => quoteExactInput,
   quoteExactInputSingle: () => quoteExactInputSingle,
+  quoteExactOutput: () => quoteExactOutput,
+  quoteExactOutputSingle: () => quoteExactOutputSingle,
   simulateSwap: () => simulateSwap,
-  swapDirect: () => swapDirect
+  swapDirect: () => swapDirect,
+  swapDirectExactOut: () => swapDirectExactOut
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -101,7 +111,7 @@ async function quoteExactInput(client, quoterAddress, exactCurrency, path, exact
     address: quoterAddress,
     abi: import_core2.v4QuoterAbi,
     functionName: "quoteExactInput",
-    args: [{ exactCurrency, path, exactAmount: BigInt(exactAmount) }]
+    args: [{ exactCurrency, path, exactAmount }]
   });
   return { amountOut, gasEstimate, path };
 }
@@ -114,7 +124,7 @@ async function quoteExactInputSingle(client, quoterAddress, poolKey, zeroForOne,
       {
         poolKey,
         zeroForOne,
-        exactAmount: BigInt(exactAmount),
+        exactAmount,
         hookData
       }
     ]
@@ -131,13 +141,7 @@ async function quoteBestRoute(client, quoterAddress, exactCurrency, routes, exac
         {
           exactCurrency,
           path,
-          // `as unknown as number` cast — the V4 quoter's solidity
-          // signature takes `uint256` (a bigint at the wire level), but
-          // our pinned ABI types it as `number`. The runtime is fine
-          // (bigint serializes correctly) — this cast tells TS to skip
-          // the structural check until we re-generate the ABI with the
-          // correct uint256 type. Tracked: SDK_CORE_TRADING_AUDIT.md H11.
-          exactAmount: BigInt(exactAmount)
+          exactAmount
         }
       ]
     })),
@@ -178,6 +182,84 @@ async function findBestQuote(client, chainId, tokenIn, tokenOut, exactAmount, po
   }
   return quoteBestRoute(client, quoter, tokenIn, paths, exactAmount);
 }
+async function quoteExactOutput(client, quoterAddress, exactCurrency, path, exactAmount) {
+  const [amountIn, gasEstimate] = await client.readContract({
+    address: quoterAddress,
+    abi: import_core2.v4QuoterAbi,
+    functionName: "quoteExactOutput",
+    args: [{ exactCurrency, path, exactAmount }]
+  });
+  return { amountIn, gasEstimate, path };
+}
+async function quoteExactOutputSingle(client, quoterAddress, poolKey, zeroForOne, exactAmount, hookData) {
+  const [amountIn, gasEstimate] = await client.readContract({
+    address: quoterAddress,
+    abi: import_core2.v4QuoterAbi,
+    functionName: "quoteExactOutputSingle",
+    args: [
+      {
+        poolKey,
+        zeroForOne,
+        exactAmount,
+        hookData
+      }
+    ]
+  });
+  return { amountIn, gasEstimate };
+}
+async function quoteBestRouteExactOut(client, quoterAddress, exactCurrency, routes, exactAmount) {
+  const results = await client.multicall({
+    contracts: routes.map((path) => ({
+      address: quoterAddress,
+      abi: import_core2.v4QuoterAbi,
+      functionName: "quoteExactOutput",
+      args: [
+        {
+          exactCurrency,
+          path,
+          exactAmount
+        }
+      ]
+    })),
+    allowFailure: true
+  });
+  const allRoutes = [];
+  let firstFailure;
+  for (let i = 0; i < results.length; i++) {
+    const r = results[i];
+    if (r.status === "success") {
+      const [amountIn, gasEstimate] = r.result;
+      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");
+      firstFailure = errMsg;
+    }
+  }
+  if (allRoutes.length === 0) {
+    throw new Error(
+      `No valid exact-output routes found to ${exactCurrency} (${routes.length} candidates probed)` + (firstFailure ? `; first failure: ${firstFailure}` : "")
+    );
+  }
+  const bestRoute = allRoutes.reduce(
+    (best, current) => current.amountIn < best.amountIn ? current : best
+  );
+  return { bestRoute, allRoutes };
+}
+async function findBestQuoteExactOut(client, chainId, tokenIn, tokenOut, exactAmount, pools = [], quoterAddress, maxHops = 3) {
+  const quoter = quoterAddress ?? import_core3.V4_QUOTER_ADDRESSES[chainId];
+  if (!quoter) {
+    throw new Error(`No V4 Quoter address configured for chain ${chainId}`);
+  }
+  const commonPools = import_core3.COMMON_POOLS[chainId] ?? [];
+  const allPools = [...pools, ...commonPools];
+  const paths = buildAllPaths(allPools, tokenOut, tokenIn, maxHops);
+  if (paths.length === 0) {
+    throw new Error(
+      `No exact-output paths found to ${tokenOut} from ${tokenIn}`
+    );
+  }
+  return quoteBestRouteExactOut(client, quoter, tokenOut, paths, exactAmount);
+}
 
 // src/swap/approval.ts
 var import_viem = require("viem");
@@ -210,8 +292,11 @@ function buildPermit2ApprovalCalldata(token, spender, amount, expiration) {
 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 UINT128_MAX = 2n ** 128n - 1n;
 var PATH_KEY_ABI_COMPONENTS = [
   { name: "intermediateCurrency", type: "address" },
   { name: "fee", type: "uint256" },
@@ -229,6 +314,16 @@ var EXACT_INPUT_PARAMS_ABI = [
   { name: "amountIn", type: "uint128" },
   { name: "amountOutMinimum", type: "uint128" }
 ];
+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"],
@@ -280,7 +375,81 @@ function buildUniversalRouterExecuteArgs(currencyIn, path, amountIn, minAmountOu
   ];
   return { commands, inputs };
 }
+function buildV4SwapInputExactOut(currencyOut, path, amountOut, maxAmountIn, inputCurrency) {
+  if (amountOut <= 0n || amountOut > UINT128_MAX) {
+    throw new Error(
+      `buildV4SwapInputExactOut: 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]`
+    );
+  }
+  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]]
+  );
+}
+function buildUniversalRouterExecuteArgsExactOut(currencyOut, path, amountOut, maxAmountIn, inputCurrency) {
+  const commands = (0, import_viem2.encodePacked)(["uint8"], [V4_SWAP]);
+  const inputs = [
+    buildV4SwapInputExactOut(
+      currencyOut,
+      path,
+      amountOut,
+      maxAmountIn,
+      inputCurrency
+    )
+  ];
+  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,
@@ -381,6 +550,82 @@ function buildSwapUserOp(params) {
     }
   });
 }
+function buildSwapUserOpExactOut(params) {
+  if (params.amountOut <= 0n) {
+    throw new Error("buildSwapUserOpExactOut: amountOut must be positive");
+  }
+  if (params.maxAmountIn <= 0n) {
+    throw new Error("buildSwapUserOpExactOut: maxAmountIn must be positive");
+  }
+  if (params.gasFeeAmountInput < 0n) {
+    throw new Error(
+      "buildSwapUserOpExactOut: gasFeeAmountInput must be non-negative"
+    );
+  }
+  if (params.swapPath.length === 0) {
+    throw new Error(
+      "buildSwapUserOpExactOut: swapPath must contain at least one PathKey"
+    );
+  }
+  const PERMIT2_EXPIRATION_MAX = 2n ** 48n - 1n;
+  if (params.deadline <= 0n || params.deadline > PERMIT2_EXPIRATION_MAX) {
+    throw new Error(
+      `buildSwapUserOpExactOut: deadline (${params.deadline}) must be unix seconds in (0, 2^48-1]. Did you accidentally pass milliseconds?`
+    );
+  }
+  const { commands, inputs } = buildUniversalRouterExecuteArgsExactOut(
+    params.outputTokenAddress,
+    params.swapPath,
+    params.amountOut,
+    params.maxAmountIn,
+    params.inputTokenAddress
+  );
+  const swapCallData = (0, import_viem3.encodeFunctionData)({
+    abi: import_core8.universalRouterAbi,
+    functionName: "execute",
+    args: [commands, inputs, params.deadline]
+  });
+  const permit2ApproveData = buildPermit2ApprovalCalldata(
+    params.inputTokenAddress,
+    params.universalRouterAddress,
+    params.maxAmountIn,
+    Number(params.deadline)
+  );
+  const operations = [];
+  if (params.gasFeeAmountInput > 0n) {
+    operations.push(
+      (0, import_core8.erc20TransferOp)(
+        params.inputTokenAddress,
+        params.feeRecipient,
+        params.gasFeeAmountInput
+      )
+    );
+  }
+  operations.push(
+    (0, import_core8.erc20ApproveOp)(params.inputTokenAddress, import_core8.PERMIT2_ADDRESS, params.maxAmountIn),
+    (0, import_core8.rawCallOp)(import_core8.PERMIT2_ADDRESS, permit2ApproveData),
+    (0, import_core8.rawCallOp)(params.universalRouterAddress, swapCallData)
+  );
+  return (0, import_core8.buildPartialUserOperation)({
+    sender: params.userAddress,
+    nonce: params.aaNonce,
+    operations,
+    gasLimits: {
+      // +50k headroom for the additional pre-swap ERC-20 transfer when
+      // the input-side fee is non-zero. Keeps margin even when fee=0n.
+      callGasLimit: params.gasLimits?.callGasLimit ?? 750000n,
+      verificationGasLimit: params.gasLimits?.verificationGasLimit ?? 150000n,
+      preVerificationGas: params.gasLimits?.preVerificationGas ?? 50000n
+    }
+  });
+}
+
+// src/swap/slippage.ts
+var MAX_SLIPPAGE_BPS = 5e3;
+function isValidSlippageBps(value) {
+  if (value === void 0) return true;
+  return Number.isInteger(value) && value >= 0 && value <= MAX_SLIPPAGE_BPS;
+}
 
 // src/api/handlers.ts
 var TradingHandlers = class {
@@ -469,10 +714,9 @@ var TradingHandlers = class {
    * net. Quote response surfaces both `estimatedOutputAmount` (gross)
    * and `outputNet` so the FE can display reality.
    *
-   * v0.3.1 — `authenticatedAddress` first param. Caller (issuer
-   * controller / FE proxy) MUST pass the address extracted from the
-   * verified session/JWT. Handler asserts it equals
-   * `request.userAddress`. See SDK_CORE_TRADING_AUDIT.md C6.
+   * `authenticatedAddress` first param: caller (issuer controller / FE
+   * proxy) MUST pass the address extracted from the verified
+   * session/JWT. Handler asserts it equals `request.userAddress`.
    */
   async handleSwap(authenticatedAddress, request) {
     if ((0, import_viem4.getAddress)(authenticatedAddress) !== (0, import_viem4.getAddress)(request.userAddress)) {
@@ -494,6 +738,13 @@ var TradingHandlers = class {
         "handleSwap: amount must be positive"
       );
     }
+    if (!isValidSlippageBps(request.slippageBps)) {
+      throw new import_core9.ValidationError(
+        "INVALID_SLIPPAGE",
+        `handleSwap: slippageBps (${request.slippageBps}) must be an integer in [0, ${MAX_SLIPPAGE_BPS}]`,
+        { received: request.slippageBps, max: MAX_SLIPPAGE_BPS }
+      );
+    }
     const { pafiFeeRecipient } = (0, import_core9.getContractAddresses)(request.chainId);
     const universalRouter = import_core9.UNIVERSAL_ROUTER_ADDRESSES[request.chainId];
     if (!universalRouter) {
@@ -581,6 +832,198 @@ var TradingHandlers = class {
     };
   }
   // =========================================================================
+  // GET /quote/exact-out — V4 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
+   * `inputGross = estimatedInputAmount + feeAmountInput` is the total
+   * the user must hold.
+   *
+   * Returns `quoteError: "QUOTE_UNAVAILABLE"` rather than throwing when
+   * no path exists.
+   */
+  async handleQuoteExactOut(request) {
+    if (request.chainId !== this.chainId) {
+      throw new import_core9.ValidationError(
+        "UNSUPPORTED_CHAIN_ID",
+        `handleQuoteExactOut: unsupported chainId ${request.chainId}`,
+        { requested: request.chainId, supported: this.chainId }
+      );
+    }
+    if (request.amount === 0n) {
+      return {
+        outputAmount: 0n,
+        estimatedInputAmount: 0n,
+        inputGross: 0n,
+        feeAmountInput: 0n,
+        gasEstimate: 0n
+      };
+    }
+    const inputTokenAddress = (0, import_viem4.getAddress)(request.inputTokenAddress);
+    const outputTokenAddress = (0, import_viem4.getAddress)(request.outputTokenAddress);
+    const pools = request.pools ?? [];
+    try {
+      const best = await findBestQuoteExactOut(
+        this.provider,
+        request.chainId,
+        inputTokenAddress,
+        outputTokenAddress,
+        request.amount,
+        pools
+      );
+      const feeAmountInput = await quoteOperatorFeeInput(
+        this.provider,
+        request.chainId,
+        inputTokenAddress
+      ).catch(() => 0n);
+      const estimatedInputAmount = best.bestRoute.amountIn;
+      return {
+        outputAmount: request.amount,
+        estimatedInputAmount,
+        inputGross: estimatedInputAmount + feeAmountInput,
+        feeAmountInput,
+        gasEstimate: best.bestRoute.gasEstimate
+      };
+    } catch {
+      return {
+        outputAmount: request.amount,
+        estimatedInputAmount: 0n,
+        inputGross: 0n,
+        feeAmountInput: 0n,
+        gasEstimate: 0n,
+        quoteError: "QUOTE_UNAVAILABLE"
+      };
+    }
+  }
+  // =========================================================================
+  // POST /swap/exact-out — V4 exact-output swap UserOp
+  // =========================================================================
+  /**
+   * Build a V4 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
+   * division), then encodes a 4-step batch:
+   *
+   *   inputToken.transfer(feeRecipient, gasFeeAmountInput)  [if > 0]
+   *     → input.approve(Permit2, maxAmountIn)
+   *     → Permit2.approve(router, maxAmountIn)
+   *     → UniversalRouter.execute (V4 SWAP_EXACT_OUT)
+   *
+   * Operator fee is INPUT-token-side (charged before swap) so the user
+   * receives exactly `request.amount` of output.
+   *
+   * `authenticatedAddress` first param: caller MUST pass the address
+   * extracted from the verified session/JWT. Handler asserts equality
+   * with `request.userAddress`.
+   */
+  async handleSwapExactOut(authenticatedAddress, request) {
+    if ((0, import_viem4.getAddress)(authenticatedAddress) !== (0, import_viem4.getAddress)(request.userAddress)) {
+      throw new import_core9.ValidationError(
+        "USER_ADDRESS_MISMATCH",
+        `handleSwapExactOut: authenticatedAddress (${authenticatedAddress}) does not match request.userAddress (${request.userAddress})`
+      );
+    }
+    if (request.chainId !== this.chainId) {
+      throw new import_core9.ValidationError(
+        "UNSUPPORTED_CHAIN_ID",
+        `handleSwapExactOut: unsupported chainId ${request.chainId}`,
+        { requested: request.chainId, supported: this.chainId }
+      );
+    }
+    if (request.amount <= 0n) {
+      throw new import_core9.ValidationError(
+        "INVALID_AMOUNT",
+        "handleSwapExactOut: amount must be positive"
+      );
+    }
+    if (!isValidSlippageBps(request.slippageBps)) {
+      throw new import_core9.ValidationError(
+        "INVALID_SLIPPAGE",
+        `handleSwapExactOut: slippageBps (${request.slippageBps}) must be an integer in [0, ${MAX_SLIPPAGE_BPS}]`,
+        { received: request.slippageBps, max: MAX_SLIPPAGE_BPS }
+      );
+    }
+    const { pafiFeeRecipient } = (0, import_core9.getContractAddresses)(request.chainId);
+    const universalRouter = import_core9.UNIVERSAL_ROUTER_ADDRESSES[request.chainId];
+    if (!universalRouter) {
+      throw new import_core9.ValidationError(
+        "ROUTER_NOT_DEPLOYED",
+        `handleSwapExactOut: no UniversalRouter for chainId ${request.chainId}`
+      );
+    }
+    const inputTokenAddress = (0, import_viem4.getAddress)(request.inputTokenAddress);
+    const outputTokenAddress = (0, import_viem4.getAddress)(request.outputTokenAddress);
+    const userAddress = (0, import_viem4.getAddress)(request.userAddress);
+    const pools = request.pools ?? [];
+    let quoteResult;
+    try {
+      quoteResult = await findBestQuoteExactOut(
+        this.provider,
+        request.chainId,
+        inputTokenAddress,
+        outputTokenAddress,
+        request.amount,
+        pools
+      );
+    } catch (err) {
+      const cause = err instanceof Error ? err.message : String(err);
+      throw new import_core9.ValidationError(
+        "NO_SWAP_PATH",
+        `handleSwapExactOut: no swap path found from ${inputTokenAddress} to ${outputTokenAddress} (cause: ${cause})`
+      );
+    }
+    const gasFeeAmountInput = request.gasFeeAmountInput !== void 0 ? request.gasFeeAmountInput : await quoteOperatorFeeInput(
+      this.provider,
+      request.chainId,
+      inputTokenAddress
+    ).catch(() => 0n);
+    const hops = quoteResult.bestRoute.path.length;
+    const slippageBps = request.slippageBps ?? (hops > 1 ? 100 : 50);
+    const estimatedInputAmount = quoteResult.bestRoute.amountIn;
+    const slippageNumerator = estimatedInputAmount * BigInt(1e4 + slippageBps);
+    const maxAmountIn = (slippageNumerator + 9999n) / 10000n;
+    const deadline = BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
+    const userOp = buildSwapUserOpExactOut({
+      userAddress,
+      aaNonce: request.aaNonce,
+      inputTokenAddress,
+      outputTokenAddress,
+      universalRouterAddress: universalRouter,
+      amountOut: request.amount,
+      maxAmountIn,
+      swapPath: quoteResult.bestRoute.path,
+      deadline,
+      gasFeeAmountInput,
+      feeRecipient: pafiFeeRecipient
+    });
+    const userOpFallback = gasFeeAmountInput > 0n ? buildSwapUserOpExactOut({
+      userAddress,
+      aaNonce: request.aaNonce,
+      inputTokenAddress,
+      outputTokenAddress,
+      universalRouterAddress: universalRouter,
+      amountOut: request.amount,
+      maxAmountIn,
+      swapPath: quoteResult.bestRoute.path,
+      deadline,
+      gasFeeAmountInput: 0n,
+      feeRecipient: pafiFeeRecipient
+    }) : void 0;
+    return {
+      userOp,
+      userOpFallback,
+      outputAmount: request.amount,
+      estimatedInputAmount,
+      maxAmountIn,
+      hops,
+      deadline,
+      feeAmountUsed: gasFeeAmountInput,
+      feeRecipient: pafiFeeRecipient
+    };
+  }
+  // =========================================================================
   // POST /perp-deposit
   // =========================================================================
   /**
@@ -787,6 +1230,17 @@ async function quoteOperatorFeeOutput(provider, chainId, outputTokenAddress) {
     pointTokenAddress: outputTokenAddress
   });
 }
+async function quoteOperatorFeeInput(provider, chainId, inputTokenAddress) {
+  const { usdt } = (0, import_core9.getContractAddresses)(chainId);
+  if (usdt && (0, import_viem4.getAddress)(inputTokenAddress) === (0, import_viem4.getAddress)(usdt)) {
+    return (0, import_core9.quoteOperatorFeeUsdt)({ provider, chainId });
+  }
+  return (0, import_core9.quoteOperatorFeePt)({
+    provider,
+    chainId,
+    pointTokenAddress: inputTokenAddress
+  });
+}
 
 // src/pools.ts
 var import_core10 = require("@pafi-dev/core");
@@ -794,6 +1248,29 @@ var import_core10 = require("@pafi-dev/core");
 // src/direct/swapDirect.ts
 var import_core11 = require("@pafi-dev/core");
 async function swapDirect(params) {
+  const universalRouter = import_core11.UNIVERSAL_ROUTER_ADDRESSES[params.chainId];
+  if (!universalRouter) {
+    throw new Error(`swapDirect: no UniversalRouter for chainId ${params.chainId}`);
+  }
+  if (params.amount <= 0n) {
+    throw new Error("swapDirect: amount must be positive");
+  }
+  if (!isValidSlippageBps(params.slippageBps)) {
+    throw new Error(
+      `swapDirect: slippageBps (${params.slippageBps}) must be an integer in [0, ${MAX_SLIPPAGE_BPS}]`
+    );
+  }
+  const account = params.walletClient.account;
+  if (!account) {
+    throw new Error(
+      "swapDirect: walletClient has no account attached \u2014 cannot send tx"
+    );
+  }
+  if (account.address.toLowerCase() !== params.userAddress.toLowerCase()) {
+    throw new Error(
+      `swapDirect: walletClient.account.address (${account.address}) must equal userAddress (${params.userAddress}) \u2014 the native tx must be sent from the same EOA whose 7702-delegated bytecode is being executed`
+    );
+  }
   const code = await params.publicClient.getCode({
     address: params.userAddress
   });
@@ -809,13 +1286,6 @@ async function swapDirect(params) {
       `swapDirect: user delegated to ${delegate} which is not a PAFI-recognised impl (expected ${import_core11.SIMPLE_7702_IMPL_BASE_MAINNET} or ${import_core11.BATCH_EXECUTOR_7702_IMPL}). Continuing \u2014 execute will revert if the impl doesn't expose executeBatch.`
     );
   }
-  const universalRouter = import_core11.UNIVERSAL_ROUTER_ADDRESSES[params.chainId];
-  if (!universalRouter) {
-    throw new Error(`swapDirect: no UniversalRouter for chainId ${params.chainId}`);
-  }
-  if (params.amount <= 0n) {
-    throw new Error("swapDirect: amount must be positive");
-  }
   let quoteResult;
   try {
     quoteResult = await findBestQuote(
@@ -858,12 +1328,117 @@ async function swapDirect(params) {
     gasFeeAmountOutput,
     feeRecipient: pafiFeeRecipient
   });
+  const txHash = await params.walletClient.sendTransaction({
+    account,
+    chain: params.walletClient.chain,
+    to: params.userAddress,
+    value: 0n,
+    data: userOp.callData
+  });
+  let receipt;
+  if (params.waitForReceipt !== false) {
+    try {
+      receipt = await params.publicClient.waitForTransactionReceipt({
+        hash: txHash
+      });
+    } catch (err) {
+      params.onWarning?.(
+        `swapDirect: tx ${txHash} sent but receipt fetch failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  return {
+    txHash,
+    receipt,
+    estimatedOutputAmount,
+    minAmountOut,
+    hops,
+    deadline,
+    feeAmountUsed: gasFeeAmountOutput
+  };
+}
+
+// src/direct/swapDirectExactOut.ts
+var import_core12 = require("@pafi-dev/core");
+async function swapDirectExactOut(params) {
+  const universalRouter = import_core12.UNIVERSAL_ROUTER_ADDRESSES[params.chainId];
+  if (!universalRouter) {
+    throw new Error(
+      `swapDirectExactOut: no UniversalRouter for chainId ${params.chainId}`
+    );
+  }
+  if (params.amount <= 0n) {
+    throw new Error("swapDirectExactOut: amount must be positive");
+  }
+  if (!isValidSlippageBps(params.slippageBps)) {
+    throw new Error(
+      `swapDirectExactOut: slippageBps (${params.slippageBps}) must be an integer in [0, ${MAX_SLIPPAGE_BPS}]`
+    );
+  }
   const account = params.walletClient.account;
   if (!account) {
     throw new Error(
-      "swapDirect: walletClient has no account attached \u2014 cannot send tx"
+      "swapDirectExactOut: walletClient has no account attached \u2014 cannot send tx"
+    );
+  }
+  if (account.address.toLowerCase() !== params.userAddress.toLowerCase()) {
+    throw new Error(
+      `swapDirectExactOut: walletClient.account.address (${account.address}) must equal userAddress (${params.userAddress}) \u2014 the native tx must be sent from the same EOA whose 7702-delegated bytecode is being executed`
+    );
+  }
+  const code = await params.publicClient.getCode({
+    address: params.userAddress
+  });
+  const delegate = (0, import_core12.parseEip7702DelegatedAddress)(code);
+  if (!delegate) {
+    throw new Error(
+      `swapDirectExactOut: user ${params.userAddress} is not EIP-7702 delegated. Run \`delegateDirect()\` first or use the AA path via \`TradingHandlers.handleSwapExactOut()\` + sponsor-relayer.`
+    );
+  }
+  const impl = (0, import_core12.detectDelegateImpl)(delegate);
+  if (impl === "unknown") {
+    params.onWarning?.(
+      `swapDirectExactOut: user delegated to ${delegate} which is not a PAFI-recognised impl (expected ${import_core12.SIMPLE_7702_IMPL_BASE_MAINNET} or ${import_core12.BATCH_EXECUTOR_7702_IMPL}). Continuing \u2014 execute will revert if the impl doesn't expose executeBatch.`
     );
   }
+  let quoteResult;
+  try {
+    quoteResult = await findBestQuoteExactOut(
+      params.publicClient,
+      params.chainId,
+      params.inputTokenAddress,
+      params.outputTokenAddress,
+      params.amount,
+      params.pools ?? []
+    );
+  } catch (err) {
+    const cause = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `swapDirectExactOut: no swap path found from ${params.inputTokenAddress} to ${params.outputTokenAddress} (cause: ${cause})`
+    );
+  }
+  const hops = quoteResult.bestRoute.path.length;
+  const slippageBps = params.slippageBps ?? (hops > 1 ? 100 : 50);
+  const estimatedInputAmount = quoteResult.bestRoute.amountIn;
+  const slippageNumerator = estimatedInputAmount * BigInt(1e4 + slippageBps);
+  const maxAmountIn = (slippageNumerator + 9999n) / 10000n;
+  const gasFeeAmountInput = params.gasFeeAmountInput ?? 0n;
+  const deadline = params.deadline ?? BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
+  const { pafiFeeRecipient } = (0, import_core12.getContractAddresses)(params.chainId);
+  const userOp = buildSwapUserOpExactOut({
+    userAddress: params.userAddress,
+    aaNonce: 0n,
+    // ignored on the native-tx path; nonce comes from EOA tx count
+    inputTokenAddress: params.inputTokenAddress,
+    outputTokenAddress: params.outputTokenAddress,
+    universalRouterAddress: universalRouter,
+    amountOut: params.amount,
+    maxAmountIn,
+    swapPath: quoteResult.bestRoute.path,
+    deadline,
+    gasFeeAmountInput,
+    feeRecipient: pafiFeeRecipient
+  });
   const txHash = await params.walletClient.sendTransaction({
     account,
     chain: params.walletClient.chain,
@@ -879,23 +1454,24 @@ async function swapDirect(params) {
       });
     } catch (err) {
       params.onWarning?.(
-        `swapDirect: tx ${txHash} sent but receipt fetch failed: ${err instanceof Error ? err.message : String(err)}`
+        `swapDirectExactOut: tx ${txHash} sent but receipt fetch failed: ${err instanceof Error ? err.message : String(err)}`
       );
     }
   }
   return {
     txHash,
     receipt,
-    estimatedOutputAmount,
-    minAmountOut,
+    outputAmount: params.amount,
+    estimatedInputAmount,
+    maxAmountIn,
     hops,
     deadline,
-    feeAmountUsed: gasFeeAmountOutput
+    feeAmountUsed: gasFeeAmountInput
   };
 }
 
 // src/direct/perpDepositDirect.ts
-var import_core12 = require("@pafi-dev/core");
+var import_core13 = require("@pafi-dev/core");
 async function perpDepositDirect(params) {
   if (params.amount <= 0n) {
     throw new Error("perpDepositDirect: amount must be positive");
@@ -903,41 +1479,41 @@ async function perpDepositDirect(params) {
   const code = await params.publicClient.getCode({
     address: params.userAddress
   });
-  const delegate = (0, import_core12.parseEip7702DelegatedAddress)(code);
+  const delegate = (0, import_core13.parseEip7702DelegatedAddress)(code);
   if (!delegate) {
     throw new Error(
       `perpDepositDirect: user ${params.userAddress} is not EIP-7702 delegated. Run \`delegateDirect()\` first or use the AA path via \`TradingHandlers.handlePerpDeposit()\` + sponsor-relayer.`
     );
   }
-  const impl = (0, import_core12.detectDelegateImpl)(delegate);
+  const impl = (0, import_core13.detectDelegateImpl)(delegate);
   if (impl === "unknown") {
     params.onWarning?.(
-      `perpDepositDirect: user delegated to ${delegate} (not a PAFI-recognised impl ${import_core12.SIMPLE_7702_IMPL_BASE_MAINNET} / ${import_core12.BATCH_EXECUTOR_7702_IMPL}). Continuing \u2014 execute will revert if the impl doesn't expose executeBatch.`
+      `perpDepositDirect: user delegated to ${delegate} (not a PAFI-recognised impl ${import_core13.SIMPLE_7702_IMPL_BASE_MAINNET} / ${import_core13.BATCH_EXECUTOR_7702_IMPL}). Continuing \u2014 execute will revert if the impl doesn't expose executeBatch.`
     );
   }
-  const vault = import_core12.ORDERLY_VAULT_ADDRESSES[params.chainId];
+  const vault = import_core13.ORDERLY_VAULT_ADDRESSES[params.chainId];
   if (!vault) {
     throw new Error(
       `perpDepositDirect: no Orderly Vault for chainId ${params.chainId}`
     );
   }
-  const brokerHash = import_core12.BROKER_HASHES[params.brokerId];
+  const brokerHash = import_core13.BROKER_HASHES[params.brokerId];
   if (!brokerHash) {
     throw new Error(
       `perpDepositDirect: unknown brokerId "${params.brokerId}"`
     );
   }
-  const tokenHash = import_core12.TOKEN_HASHES.USDC;
+  const tokenHash = import_core13.TOKEN_HASHES.USDC;
   const [usdcAddress, brokerAllowed] = await Promise.all([
     params.publicClient.readContract({
       address: vault,
-      abi: import_core12.ORDERLY_VAULT_ABI,
+      abi: import_core13.ORDERLY_VAULT_ABI,
       functionName: "getAllowedToken",
       args: [tokenHash]
     }),
     params.publicClient.readContract({
       address: vault,
-      abi: import_core12.ORDERLY_VAULT_ABI,
+      abi: import_core13.ORDERLY_VAULT_ABI,
       functionName: "getAllowedBroker",
       args: [brokerHash]
     })
@@ -947,7 +1523,7 @@ async function perpDepositDirect(params) {
       `perpDepositDirect: broker "${params.brokerId}" is not whitelisted on Orderly Vault`
     );
   }
-  const { orderlyRelay: relayAddress, pafiFeeRecipient } = (0, import_core12.getContractAddresses)(
+  const { orderlyRelay: relayAddress, pafiFeeRecipient } = (0, import_core13.getContractAddresses)(
     params.chainId
   );
   const RELAY_FEE_FLOOR_USDC = 2000000n;
@@ -962,7 +1538,7 @@ async function perpDepositDirect(params) {
   };
   const relayTokenFee = await params.publicClient.readContract({
     address: relayAddress,
-    abi: import_core12.ORDERLY_RELAY_ABI,
+    abi: import_core13.ORDERLY_RELAY_ABI,
     functionName: "quoteTokenFee",
     args: [relayRequest]
   });
@@ -977,7 +1553,7 @@ async function perpDepositDirect(params) {
     );
   }
   const gasFeeUsdc = params.gasFeeUsdc ?? 0n;
-  const partial = (0, import_core12.buildPerpDepositViaRelay)({
+  const partial = (0, import_core13.buildPerpDepositViaRelay)({
     userAddress: params.userAddress,
     aaNonce: 0n,
     // ignored on the native-tx path
@@ -1011,7 +1587,7 @@ async function perpDepositDirect(params) {
       );
     }
   }
-  const accountId = (0, import_core12.computeAccountId)(params.userAddress, brokerHash);
+  const accountId = (0, import_core13.computeAccountId)(params.userAddress, brokerHash);
   return {
     txHash,
     receipt,
@@ -1028,23 +1604,33 @@ 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,
   buildAllPaths,
   buildErc20ApprovalCalldata,
   buildPermit2ApprovalCalldata,
   buildSwapFromQuote,
   buildSwapUserOp,
+  buildSwapUserOpExactOut,
   buildUniversalRouterExecuteArgs,
+  buildUniversalRouterExecuteArgsExactOut,
   buildV4SwapInput,
+  buildV4SwapInputExactOut,
   checkAllowance,
   combineRoutes,
   fetchPafiPools,
   findBestQuote,
+  findBestQuoteExactOut,
   perpDepositDirect,
   quoteBestRoute,
+  quoteBestRouteExactOut,
   quoteExactInput,
   quoteExactInputSingle,
+  quoteExactOutput,
+  quoteExactOutputSingle,
   simulateSwap,
-  swapDirect
+  swapDirect,
+  swapDirectExactOut
 });
 //# sourceMappingURL=index.cjs.map