@mento-protocol/mento-sdk 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/services/liquidity/zapHelpers.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeZapInCall = encodeZapInCall;
+exports.encodeZapOutCall = encodeZapOutCall;
+exports.findZapInRoutes = findZapInRoutes;
+exports.findZapOutRoutes = findZapOutRoutes;
+exports.splitAmount = splitAmount;
+exports.estimateLiquidityFromZapIn = estimateLiquidityFromZapIn;
+const viem_1 = require("viem");
+const abis_1 = require("../../core/abis");
+const pathEncoder_1 = require("../../utils/pathEncoder");
+// ========== ENCODING FUNCTIONS ==========
+/**
+ * Encodes the zapIn function call for the Router contract
+ */
+function encodeZapInCall(tokenIn, amountInA, amountInB, zapParams, routesA, routesB, recipient) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'zapIn',
+        args: [tokenIn, amountInA, amountInB, zapParams, routesA, routesB, recipient],
+    });
+}
+/**
+ * Encodes the zapOut function call for the Router contract
+ */
+function encodeZapOutCall(tokenOut, liquidity, zapParams, routesA, routesB) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'zapOut',
+        args: [tokenOut, liquidity, zapParams, routesA, routesB],
+    });
+}
+// ========== ROUTING FUNCTIONS ==========
+/**
+ * Finds routes for zap in operations (from tokenIn to both pool tokens)
+ *
+ * @param routeService - Route service for finding swap paths
+ * @param tokenIn - Input token address
+ * @param token0 - Pool's token0 address
+ * @param token1 - Pool's token1 address
+ * @returns Routes from tokenIn to token0 and token1
+ */
+async function findZapInRoutes(routeService, tokenIn, token0, token1) {
+    let routesA = [];
+    let routesB = [];
+    // Find route from tokenIn to token0 (if different)
+    if (tokenIn.toLowerCase() !== token0.toLowerCase()) {
+        const routeA = await routeService.findRoute(tokenIn, token0);
+        routesA = (0, pathEncoder_1.encodeRoutePath)(routeA.path, tokenIn, token0);
+    }
+    // Find route from tokenIn to token1 (if different)
+    if (tokenIn.toLowerCase() !== token1.toLowerCase()) {
+        const routeB = await routeService.findRoute(tokenIn, token1);
+        routesB = (0, pathEncoder_1.encodeRoutePath)(routeB.path, tokenIn, token1);
+    }
+    return { routesA, routesB };
+}
+/**
+ * Finds routes for zap out operations (from both pool tokens to tokenOut)
+ *
+ * @param routeService - Route service for finding swap paths
+ * @param token0 - Pool's token0 address
+ * @param token1 - Pool's token1 address
+ * @param tokenOut - Output token address
+ * @returns Routes from token0 and token1 to tokenOut
+ */
+async function findZapOutRoutes(routeService, token0, token1, tokenOut) {
+    let routesA = [];
+    let routesB = [];
+    // Find route from token0 to tokenOut (if different)
+    if (token0.toLowerCase() !== tokenOut.toLowerCase()) {
+        const routeA = await routeService.findRoute(token0, tokenOut);
+        routesA = (0, pathEncoder_1.encodeRoutePath)(routeA.path, token0, tokenOut);
+    }
+    // Find route from token1 to tokenOut (if different)
+    if (token1.toLowerCase() !== tokenOut.toLowerCase()) {
+        const routeB = await routeService.findRoute(token1, tokenOut);
+        routesB = (0, pathEncoder_1.encodeRoutePath)(routeB.path, token1, tokenOut);
+    }
+    return { routesA, routesB };
+}
+// ========== CALCULATION FUNCTIONS ==========
+/**
+ * Splits an amount into two parts based on a ratio
+ *
+ * @param amountIn - Total input amount
+ * @param splitRatio - Ratio for splitting (0-1, e.g., 0.5 for 50/50)
+ * @returns Split amounts for each part
+ */
+function splitAmount(amountIn, splitRatio) {
+    if (splitRatio < 0 || splitRatio > 1) {
+        throw new Error('Split ratio must be between 0 and 1');
+    }
+    const amountA = (amountIn * BigInt(Math.floor(splitRatio * 10000))) / 10000n;
+    const amountB = amountIn - amountA;
+    return { amountA, amountB };
+}
+/**
+ * Estimates minimum LP tokens from zap in amounts.
+ *
+ * This is a conservative lower-bound estimate. The inputs are slippage-adjusted
+ * minimums, not expected amounts. Actual LP tokens minted on-chain may be higher
+ * because the router uses balanceOf(address(this)) after swaps, which can exceed
+ * the pre-calculated minimums.
+ *
+ * @param amountOutA - Minimum amount of token0 after swap (slippage-adjusted)
+ * @param amountOutB - Minimum amount of token1 after swap (slippage-adjusted)
+ * @param reserve0 - Current reserve of token0 in pool
+ * @param reserve1 - Current reserve of token1 in pool
+ * @param totalSupply - Total LP token supply
+ * @returns Conservative estimate of minimum LP tokens to be minted
+ */
+function estimateLiquidityFromZapIn(amountOutA, amountOutB, reserve0, reserve1, totalSupply) {
+    if (totalSupply === 0n) {
+        // First liquidity provision - use geometric mean with BigInt sqrt
+        // to avoid precision loss from Number() conversion on 18-decimal values
+        const product = amountOutA * amountOutB;
+        if (product === 0n)
+            return 0n;
+        let x = product;
+        let y = (x + 1n) / 2n;
+        while (y < x) {
+            x = y;
+            y = (x + product / x) / 2n;
+        }
+        return x;
+    }
+    // Existing pool - calculate based on smaller ratio
+    const liquidityA = (amountOutA * totalSupply) / reserve0;
+    const liquidityB = (amountOutB * totalSupply) / reserve1;
+    return liquidityA < liquidityB ? liquidityA : liquidityB;
+}
+//# sourceMappingURL=zapHelpers.js.map

package/dist/services/liquidity/zapHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zapHelpers.js","sourceRoot":"","sources":["../../../src/services/liquidity/zapHelpers.ts"],"names":[],"mappings":"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"}

package/dist/services/liquidity/zapIn.d.ts

@@ -0,0 +1,17 @@
+import { PublicClient } from 'viem';
+import { PoolService } from '../pools';
+import { RouteService } from '../routes';
+import { LiquidityOptions, ZapInQuote, ZapInDetails, ZapInTransaction } from '../../core/types';
+/**
+ * Builds a complete zap in transaction including approval if needed
+ */
+export declare function buildZapInTransactionInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, routeService: RouteService, poolAddress: string, tokenIn: string, amountIn: bigint, amountInSplit: number, recipient: string, owner: string, options: LiquidityOptions): Promise<ZapInTransaction>;
+/**
+ * Builds zap in transaction parameters without checking approval
+ */
+export declare function buildZapInParamsInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, routeService: RouteService, poolAddress: string, tokenIn: string, amountIn: bigint, amountInSplit: number, recipient: string, options: LiquidityOptions): Promise<ZapInDetails>;
+/**
+ * Quotes a zap in operation (read-only)
+ */
+export declare function quoteZapInInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, routeService: RouteService, poolAddress: string, tokenIn: string, amountIn: bigint, amountInSplit: number, options: LiquidityOptions): Promise<ZapInQuote>;
+//# sourceMappingURL=zapIn.d.ts.map

package/dist/services/liquidity/zapIn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zapIn.d.ts","sourceRoot":"","sources":["../../../src/services/liquidity/zapIn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,YAAY,EAAE,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAEjB,MAAM,kBAAkB,CAAA;AAezB;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CAyEvB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA0CrB"}

package/dist/services/liquidity/zapIn.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildZapInTransactionInternal = buildZapInTransactionInternal;
+exports.buildZapInParamsInternal = buildZapInParamsInternal;
+exports.quoteZapInInternal = quoteZapInInternal;
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+const validation_1 = require("../../utils/validation");
+const liquidityHelpers_1 = require("./liquidityHelpers");
+const zapHelpers_1 = require("./zapHelpers");
+// ========== ZAP IN OPERATIONS ==========
+/**
+ * Builds a complete zap in transaction including approval if needed
+ */
+async function buildZapInTransactionInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenIn, amountIn, amountInSplit, recipient, owner, options) {
+    (0, validation_1.validateAddress)(owner, 'owner');
+    // Build zap in params
+    const zapIn = await buildZapInParamsInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenIn, amountIn, amountInSplit, recipient, options);
+    // Check allowance for input token
+    const tokenInAddr = tokenIn;
+    const ownerAddr = owner;
+    const currentAllowance = await (0, liquidityHelpers_1.getAllowance)(publicClient, tokenInAddr, ownerAddr, chainId);
+    // Build approval if needed
+    const approval = currentAllowance < amountIn
+        ? { token: tokenIn, amount: amountIn, params: (0, liquidityHelpers_1.buildApprovalParams)(chainId, tokenInAddr, amountIn) }
+        : null;
+    return { approval, zapIn };
+}
+/**
+ * Builds zap in transaction parameters without checking approval
+ */
+async function buildZapInParamsInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenIn, amountIn, amountInSplit, recipient, options) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(tokenIn, 'tokenIn');
+    (0, validation_1.validateAddress)(recipient, 'recipient');
+    // Get pool info
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    // Split input amount
+    const { amountA: amountInA, amountB: amountInB } = (0, zapHelpers_1.splitAmount)(amountIn, amountInSplit);
+    // Find routes for swapping
+    const { routesA, routesB } = await (0, zapHelpers_1.findZapInRoutes)(routeService, tokenIn, token0, token1);
+    // Generate zap parameters using Router helper
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const [amountOutMinA, amountOutMinB, amountAMin, amountBMin] = (await publicClient.readContract({
+        address: routerAddress,
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'generateZapInParams',
+        args: [token0, token1, factoryAddr, amountInA, amountInB, routesA, routesB],
+    }));
+    // Apply slippage to all minimum amounts
+    const finalAmountAMin = (0, liquidityHelpers_1.calculateMinAmount)(amountAMin, options.slippageTolerance);
+    const finalAmountBMin = (0, liquidityHelpers_1.calculateMinAmount)(amountBMin, options.slippageTolerance);
+    const finalAmountOutMinA = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinA, options.slippageTolerance);
+    const finalAmountOutMinB = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinB, options.slippageTolerance);
+    // Estimate expected liquidity
+    const poolDetails = await poolService.getPoolDetails(poolAddress);
+    const totalSupply = (await publicClient.readContract({
+        address: poolAddress,
+        abi: abis_1.ERC20_ABI,
+        functionName: 'totalSupply',
+        args: [],
+    }));
+    const expectedLiquidity = (0, zapHelpers_1.estimateLiquidityFromZapIn)(finalAmountOutMinA, finalAmountOutMinB, poolDetails.reserve0, poolDetails.reserve1, totalSupply);
+    const zapParams = {
+        tokenA: token0,
+        tokenB: token1,
+        factory: factoryAddr,
+        amountAMin: finalAmountAMin,
+        amountBMin: finalAmountBMin,
+        amountOutMinA: finalAmountOutMinA,
+        amountOutMinB: finalAmountOutMinB,
+    };
+    const data = (0, zapHelpers_1.encodeZapInCall)(tokenIn, amountInA, amountInB, zapParams, routesA, routesB, recipient);
+    return {
+        params: {
+            to: routerAddress,
+            data,
+            value: '0',
+        },
+        poolAddress,
+        tokenIn,
+        amountIn,
+        amountInA,
+        amountInB,
+        routesA,
+        routesB,
+        zapParams,
+        estimatedMinLiquidity: expectedLiquidity,
+    };
+}
+/**
+ * Quotes a zap in operation (read-only)
+ */
+async function quoteZapInInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenIn, amountIn, amountInSplit, options) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(tokenIn, 'tokenIn');
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    const { amountA: amountInA, amountB: amountInB } = (0, zapHelpers_1.splitAmount)(amountIn, amountInSplit);
+    const { routesA, routesB } = await (0, zapHelpers_1.findZapInRoutes)(routeService, tokenIn, token0, token1);
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const [amountOutMinA, amountOutMinB, amountAMin, amountBMin] = (await publicClient.readContract({
+        address: routerAddress,
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'generateZapInParams',
+        args: [token0, token1, factoryAddr, amountInA, amountInB, routesA, routesB],
+    }));
+    const poolDetails = await poolService.getPoolDetails(poolAddress);
+    const totalSupply = (await publicClient.readContract({
+        address: poolAddress,
+        abi: abis_1.ERC20_ABI,
+        functionName: 'totalSupply',
+        args: [],
+    }));
+    const finalAmountOutMinA = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinA, options.slippageTolerance);
+    const finalAmountOutMinB = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinB, options.slippageTolerance);
+    const expectedLiquidity = (0, zapHelpers_1.estimateLiquidityFromZapIn)(finalAmountOutMinA, finalAmountOutMinB, poolDetails.reserve0, poolDetails.reserve1, totalSupply);
+    return {
+        amountOutMinA: finalAmountOutMinA,
+        amountOutMinB: finalAmountOutMinB,
+        amountAMin: (0, liquidityHelpers_1.calculateMinAmount)(amountAMin, options.slippageTolerance),
+        amountBMin: (0, liquidityHelpers_1.calculateMinAmount)(amountBMin, options.slippageTolerance),
+        estimatedMinLiquidity: expectedLiquidity,
+    };
+}
+//# sourceMappingURL=zapIn.js.map

package/dist/services/liquidity/zapIn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zapIn.js","sourceRoot":"","sources":["../../../src/services/liquidity/zapIn.ts"],"names":[],"mappings":"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"}

package/dist/services/liquidity/zapOut.d.ts

@@ -0,0 +1,17 @@
+import { PublicClient } from 'viem';
+import { PoolService } from '../pools';
+import { RouteService } from '../routes';
+import { LiquidityOptions, ZapOutQuote, ZapOutDetails, ZapOutTransaction } from '../../core/types';
+/**
+ * Builds a complete zap out transaction including approval if needed
+ */
+export declare function buildZapOutTransactionInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, routeService: RouteService, poolAddress: string, tokenOut: string, liquidity: bigint, recipient: string, owner: string, options: LiquidityOptions): Promise<ZapOutTransaction>;
+/**
+ * Builds zap out transaction parameters without checking approval
+ */
+export declare function buildZapOutParamsInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, routeService: RouteService, poolAddress: string, tokenOut: string, liquidity: bigint, recipient: string, options: LiquidityOptions): Promise<ZapOutDetails>;
+/**
+ * Quotes a zap out operation (read-only)
+ */
+export declare function quoteZapOutInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, routeService: RouteService, poolAddress: string, tokenOut: string, liquidity: bigint, options: LiquidityOptions): Promise<ZapOutQuote>;
+//# sourceMappingURL=zapOut.d.ts.map

package/dist/services/liquidity/zapOut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zapOut.d.ts","sourceRoot":"","sources":["../../../src/services/liquidity/zapOut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAE,MAAM,MAAM,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EACL,gBAAgB,EAGhB,WAAW,EACX,aAAa,EACb,iBAAiB,EAElB,MAAM,kBAAkB,CAAA;AAezB;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAqD5B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,CA2BtB"}

package/dist/services/liquidity/zapOut.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildZapOutTransactionInternal = buildZapOutTransactionInternal;
+exports.buildZapOutParamsInternal = buildZapOutParamsInternal;
+exports.quoteZapOutInternal = quoteZapOutInternal;
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+const errors_1 = require("../../core/errors");
+const validation_1 = require("../../utils/validation");
+const pathEncoder_1 = require("../../utils/pathEncoder");
+const liquidityHelpers_1 = require("./liquidityHelpers");
+const zapHelpers_1 = require("./zapHelpers");
+// ========== ZAP OUT OPERATIONS ==========
+const INSUFFICIENT_LIQUIDITY_SELECTOR = '0xbb55fd27';
+const MAX_ROUTE_CANDIDATES_PER_LEG = 8;
+const MAX_ROUTE_COMBINATIONS = 48;
+/**
+ * Builds a complete zap out transaction including approval if needed
+ */
+async function buildZapOutTransactionInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenOut, liquidity, recipient, owner, options) {
+    (0, validation_1.validateAddress)(owner, 'owner');
+    // Build zap out params
+    let zapOut = await buildZapOutParamsInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenOut, liquidity, recipient, options);
+    // Check LP token allowance
+    const poolAddr = poolAddress;
+    const ownerAddr = owner;
+    const currentAllowance = await (0, liquidityHelpers_1.getAllowance)(publicClient, poolAddr, ownerAddr, chainId);
+    // Build approval if needed
+    const approval = currentAllowance < liquidity
+        ? { token: poolAddress, amount: liquidity, params: (0, liquidityHelpers_1.buildApprovalParams)(chainId, poolAddr, liquidity) }
+        : null;
+    // We can only preflight/simulate a real zap call when approval is already sufficient.
+    // Before approval, transferFrom in zapOut() would fail and make simulation meaningless.
+    if (currentAllowance >= liquidity) {
+        const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+        try {
+            await simulateZapOut(publicClient, ownerAddr, routerAddress, zapOut.params.data);
+        }
+        catch (error) {
+            // Only attempt route fallback for the known liquidity failure.
+            if (!isInsufficientLiquidityError(error)) {
+                throw error;
+            }
+            zapOut = await findViableZapOutDetails(publicClient, chainId, poolService, routeService, poolAddress, tokenOut, liquidity, ownerAddr, options);
+        }
+    }
+    return { approval, zapOut };
+}
+/**
+ * Builds zap out transaction parameters without checking approval
+ */
+async function buildZapOutParamsInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenOut, liquidity, recipient, options) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(tokenOut, 'tokenOut');
+    (0, validation_1.validateAddress)(recipient, 'recipient');
+    // Get pool info
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    // Find routes for swapping (from pool tokens to tokenOut)
+    const { routesA, routesB } = await (0, zapHelpers_1.findZapOutRoutes)(routeService, token0, token1, tokenOut);
+    return buildZapOutDetailsForRoutes(publicClient, chainId, poolAddress, tokenOut, liquidity, token0, token1, factoryAddr, routesA, routesB, options);
+}
+/**
+ * Quotes a zap out operation (read-only)
+ */
+async function quoteZapOutInternal(publicClient, chainId, poolService, routeService, poolAddress, tokenOut, liquidity, options) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(tokenOut, 'tokenOut');
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    // Find routes for swapping (from pool tokens to tokenOut)
+    const { routesA, routesB } = await (0, zapHelpers_1.findZapOutRoutes)(routeService, token0, token1, tokenOut);
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const [amountOutMinA, amountOutMinB, amountAMin, amountBMin] = (await publicClient.readContract({
+        address: routerAddress,
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'generateZapOutParams',
+        args: [token0, token1, factoryAddr, liquidity, routesA, routesB],
+    }));
+    const finalAmountOutFromA = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinA, options.slippageTolerance);
+    const finalAmountOutFromB = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinB, options.slippageTolerance);
+    return {
+        amountOutFromA: finalAmountOutFromA,
+        amountOutFromB: finalAmountOutFromB,
+        amountAMin: (0, liquidityHelpers_1.calculateMinAmount)(amountAMin, options.slippageTolerance),
+        amountBMin: (0, liquidityHelpers_1.calculateMinAmount)(amountBMin, options.slippageTolerance),
+        estimatedMinTokenOut: finalAmountOutFromA + finalAmountOutFromB,
+    };
+}
+async function buildZapOutDetailsForRoutes(publicClient, chainId, poolAddress, tokenOut, liquidity, token0, token1, factoryAddr, routesA, routesB, options) {
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const [amountOutMinA, amountOutMinB, amountAMin, amountBMin] = (await publicClient.readContract({
+        address: routerAddress,
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'generateZapOutParams',
+        args: [token0, token1, factoryAddr, liquidity, routesA, routesB],
+    }));
+    const finalAmountAMin = (0, liquidityHelpers_1.calculateMinAmount)(amountAMin, options.slippageTolerance);
+    const finalAmountBMin = (0, liquidityHelpers_1.calculateMinAmount)(amountBMin, options.slippageTolerance);
+    const finalAmountOutMinA = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinA, options.slippageTolerance);
+    const finalAmountOutMinB = (0, liquidityHelpers_1.calculateMinAmount)(amountOutMinB, options.slippageTolerance);
+    const zapParams = {
+        tokenA: token0,
+        tokenB: token1,
+        factory: factoryAddr,
+        amountAMin: finalAmountAMin,
+        amountBMin: finalAmountBMin,
+        amountOutMinA: finalAmountOutMinA,
+        amountOutMinB: finalAmountOutMinB,
+    };
+    const data = (0, zapHelpers_1.encodeZapOutCall)(tokenOut, liquidity, zapParams, routesA, routesB);
+    return {
+        params: {
+            to: routerAddress,
+            data,
+            value: '0',
+        },
+        poolAddress,
+        tokenOut,
+        liquidity,
+        routesA,
+        routesB,
+        zapParams,
+        estimatedMinTokenOut: finalAmountOutMinA + finalAmountOutMinB,
+    };
+}
+async function findViableZapOutDetails(publicClient, chainId, poolService, routeService, poolAddress, tokenOut, liquidity, owner, options) {
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const routesAOptions = await getEncodedRouteCandidates(routeService, token0, tokenOut, poolAddress);
+    const routesBOptions = await getEncodedRouteCandidates(routeService, token1, tokenOut, poolAddress);
+    let best = null;
+    let combinationsTried = 0;
+    outer: for (const routesA of routesAOptions) {
+        for (const routesB of routesBOptions) {
+            if (combinationsTried >= MAX_ROUTE_COMBINATIONS) {
+                break outer;
+            }
+            combinationsTried += 1;
+            try {
+                const candidate = await buildZapOutDetailsForRoutes(publicClient, chainId, poolAddress, tokenOut, liquidity, token0, token1, factoryAddr, routesA, routesB, options);
+                await simulateZapOut(publicClient, owner, routerAddress, candidate.params.data);
+                if (!best || candidate.estimatedMinTokenOut > best.estimatedMinTokenOut) {
+                    best = candidate;
+                }
+            }
+            catch {
+                // Ignore non-viable route combination and continue searching.
+            }
+        }
+    }
+    if (!best) {
+        throw new errors_1.ZapOutRouteNotViableError(poolAddress, tokenOut);
+    }
+    return best;
+}
+async function getEncodedRouteCandidates(routeService, tokenIn, tokenOut, sourcePoolAddress) {
+    if (tokenIn.toLowerCase() === tokenOut.toLowerCase()) {
+        return [[]];
+    }
+    const rawCandidates = [];
+    // Include the SDK default first for consistency.
+    try {
+        rawCandidates.push(await routeService.findRoute(tokenIn, tokenOut));
+    }
+    catch {
+        // Continue; we'll try full route enumeration next.
+    }
+    // Build a broader candidate set for fallback route selection.
+    const allRoutes = await routeService.getRoutes({ cached: false, returnAllRoutes: true });
+    const pairCandidates = allRoutes.filter((route) => {
+        const a0 = route.tokens[0].address.toLowerCase();
+        const a1 = route.tokens[1].address.toLowerCase();
+        const t0 = tokenIn.toLowerCase();
+        const t1 = tokenOut.toLowerCase();
+        return (a0 === t0 && a1 === t1) || (a0 === t1 && a1 === t0);
+    });
+    rawCandidates.push(...pairCandidates);
+    if (rawCandidates.length === 0) {
+        throw new errors_1.RouteNotFoundError(tokenIn, tokenOut);
+    }
+    // Prioritize routes that avoid swapping through the same pool being zapped out.
+    rawCandidates.sort((a, b) => {
+        const aUsesSourcePool = routeUsesPool(a, sourcePoolAddress) ? 1 : 0;
+        const bUsesSourcePool = routeUsesPool(b, sourcePoolAddress) ? 1 : 0;
+        if (aUsesSourcePool !== bUsesSourcePool)
+            return aUsesSourcePool - bUsesSourcePool;
+        if (a.path.length !== b.path.length)
+            return a.path.length - b.path.length;
+        return 0;
+    });
+    const encodedRoutes = [];
+    const seen = new Set();
+    for (const route of rawCandidates) {
+        try {
+            const encoded = (0, pathEncoder_1.encodeRoutePath)(route.path, tokenIn, tokenOut);
+            const key = JSON.stringify(encoded);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            encodedRoutes.push(encoded);
+            if (encodedRoutes.length >= MAX_ROUTE_CANDIDATES_PER_LEG) {
+                break;
+            }
+        }
+        catch {
+            // Invalid path encoding for this direction; skip.
+        }
+    }
+    if (encodedRoutes.length === 0) {
+        throw new errors_1.RouteNotFoundError(tokenIn, tokenOut);
+    }
+    return encodedRoutes;
+}
+function routeUsesPool(route, poolAddress) {
+    const normalizedPool = poolAddress.toLowerCase();
+    return route.path.some((hop) => hop.poolAddr.toLowerCase() === normalizedPool);
+}
+async function simulateZapOut(publicClient, owner, routerAddress, data) {
+    await publicClient.call({
+        account: owner,
+        to: routerAddress,
+        data,
+    });
+}
+function isInsufficientLiquidityError(error) {
+    const message = extractErrorMessage(error).toLowerCase();
+    return (message.includes(INSUFFICIENT_LIQUIDITY_SELECTOR) ||
+        message.includes('insufficientliquidity'));
+}
+function extractErrorMessage(error) {
+    if (!(error instanceof Error)) {
+        return String(error);
+    }
+    const typed = error;
+    const parts = [
+        typed.message,
+        typed.shortMessage,
+        typed.details,
+        typed.cause instanceof Error ? typed.cause.message : undefined,
+    ].filter((part) => Boolean(part));
+    return parts.join(' | ');
+}
+//# sourceMappingURL=zapOut.js.map

package/dist/services/liquidity/zapOut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zapOut.js","sourceRoot":"","sources":["../../../src/services/liquidity/zapOut.ts"],"names":[],"mappings":"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"}