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

package/dist/services/liquidity/LiquidityService.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiquidityService = void 0;
+const basicLiquidity_1 = require("./basicLiquidity");
+const zapIn_1 = require("./zapIn");
+const zapOut_1 = require("./zapOut");
+class LiquidityService {
+    constructor(publicClient, chainId, poolService, routeService) {
+        this.publicClient = publicClient;
+        this.chainId = chainId;
+        this.poolService = poolService;
+        this.routeService = routeService;
+    }
+    /**
+     * Builds add liquidity transaction with token approvals if needed.
+     * Provide two tokens in any order - the Router handles token ordering automatically.
+     * @param poolAddress - FPMM pool address
+     * @param tokenA - First token address
+     * @param amountA - Amount of first token
+     * @param tokenB - Second token address
+     * @param amountB - Amount of second token
+     * @param recipient - Address to receive LP tokens
+     * @param owner - Address that owns the input tokens (for checking allowances)
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction with approvals (if needed) and add liquidity call
+     */
+    async buildAddLiquidityTransaction(poolAddress, tokenA, amountA, tokenB, amountB, recipient, owner, options) {
+        return (0, basicLiquidity_1.buildAddLiquidityTransactionInternal)(this.publicClient, this.chainId, this.poolService, poolAddress, tokenA, amountA, tokenB, amountB, recipient, owner, options);
+    }
+    /**
+     * Builds add liquidity transaction parameters without checking token approvals.
+     * Use buildAddLiquidityTransaction if you need approval handling.
+     * @param poolAddress - FPMM pool address
+     * @param tokenA - First token address
+     * @param amountA - Amount of first token
+     * @param tokenB - Second token address
+     * @param amountB - Amount of second token
+     * @param recipient - Address to receive LP tokens
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction details with encoded call data
+     */
+    async buildAddLiquidityParams(poolAddress, tokenA, amountA, tokenB, amountB, recipient, options) {
+        return (0, basicLiquidity_1.buildAddLiquidityParamsInternal)(this.publicClient, this.chainId, this.poolService, poolAddress, tokenA, amountA, tokenB, amountB, recipient, options);
+    }
+    /**
+     * Builds remove liquidity transaction with LP token approval if needed.
+     * @param poolAddress - FPMM pool address (also the LP token address)
+     * @param liquidity - Amount of LP tokens to burn
+     * @param recipient - Address to receive the underlying tokens
+     * @param owner - Address that owns the LP tokens (for checking allowance)
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction with approval (if needed) and remove liquidity call
+     */
+    async buildRemoveLiquidityTransaction(poolAddress, liquidity, recipient, owner, options) {
+        return (0, basicLiquidity_1.buildRemoveLiquidityTransactionInternal)(this.publicClient, this.chainId, this.poolService, poolAddress, liquidity, recipient, owner, options);
+    }
+    /**
+     * Builds remove liquidity transaction parameters without checking LP token approval.
+     * Use buildRemoveLiquidityTransaction if you need approval handling.
+     * @param poolAddress - FPMM pool address
+     * @param liquidity - Amount of LP tokens to burn
+     * @param recipient - Address to receive the underlying tokens
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction details with encoded call data
+     */
+    async buildRemoveLiquidityParams(poolAddress, liquidity, recipient, options) {
+        return (0, basicLiquidity_1.buildRemoveLiquidityParamsInternal)(this.publicClient, this.chainId, this.poolService, poolAddress, liquidity, recipient, options);
+    }
+    /**
+     * Quotes an add liquidity operation (read-only call).
+     * Returns expected amounts and LP tokens based on current pool reserves.
+     * @param poolAddress - FPMM pool address
+     * @param tokenA - First token address
+     * @param amountA - Amount of first token
+     * @param tokenB - Second token address
+     * @param amountB - Amount of second token
+     * @returns Expected amounts and LP tokens to be minted
+     */
+    async quoteAddLiquidity(poolAddress, tokenA, amountA, tokenB, amountB) {
+        return (0, basicLiquidity_1.quoteAddLiquidityInternal)(this.publicClient, this.chainId, this.poolService, poolAddress, tokenA, amountA, tokenB, amountB);
+    }
+    /**
+     * Quotes a remove liquidity operation (read-only call).
+     * Returns expected token amounts based on current pool reserves.
+     * @param poolAddress - FPMM pool address
+     * @param liquidity - Amount of LP tokens to burn
+     * @returns Expected amounts of token0 and token1
+     */
+    async quoteRemoveLiquidity(poolAddress, liquidity) {
+        return (0, basicLiquidity_1.quoteRemoveLiquidityInternal)(this.publicClient, this.chainId, this.poolService, poolAddress, liquidity);
+    }
+    /**
+     * Gets LP token balance and pool share percentage for an address.
+     * @param poolAddress - FPMM pool address (also the LP token address)
+     * @param owner - Address to check balance for
+     * @returns Balance, total supply, and share percentage
+     */
+    async getLPTokenBalance(poolAddress, owner) {
+        return (0, basicLiquidity_1.getLPTokenBalanceInternal)(this.publicClient, this.poolService, poolAddress, owner);
+    }
+    /**
+     * Builds zap in transaction with approval if needed.
+     * Adds liquidity using a single input token - the Router swaps it to both pool tokens automatically.
+     * @param poolAddress - FPMM pool address
+     * @param tokenIn - Input token address
+     * @param amountIn - Total input amount
+     * @param amountInSplit - How to split input between pool tokens (0-1, e.g., 0.5 for 50/50)
+     * @param recipient - Address to receive LP tokens
+     * @param owner - Address that owns the input token
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction with approval (if needed) and zap in call
+     */
+    async buildZapInTransaction(poolAddress, tokenIn, amountIn, amountInSplit, recipient, owner, options) {
+        return (0, zapIn_1.buildZapInTransactionInternal)(this.publicClient, this.chainId, this.poolService, this.routeService, poolAddress, tokenIn, amountIn, amountInSplit, recipient, owner, options);
+    }
+    /**
+     * Builds zap in transaction parameters without checking approval.
+     * Use buildZapInTransaction if you need approval handling.
+     * @param poolAddress - FPMM pool address
+     * @param tokenIn - Input token address
+     * @param amountIn - Total input amount
+     * @param amountInSplit - Split ratio (0-1)
+     * @param recipient - Address to receive LP tokens
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction details with encoded call data and routing information
+     */
+    async buildZapInParams(poolAddress, tokenIn, amountIn, amountInSplit, recipient, options) {
+        return (0, zapIn_1.buildZapInParamsInternal)(this.publicClient, this.chainId, this.poolService, this.routeService, poolAddress, tokenIn, amountIn, amountInSplit, recipient, options);
+    }
+    /**
+     * Builds zap out transaction with approval if needed.
+     * Removes liquidity and swaps both tokens to a single output token.
+     * @param poolAddress - FPMM pool address
+     * @param tokenOut - Output token address
+     * @param liquidity - Amount of LP tokens to burn
+     * @param recipient - Address to receive output tokens
+     * @param owner - Address that owns the LP tokens
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction with approval (if needed) and zap out call
+     */
+    async buildZapOutTransaction(poolAddress, tokenOut, liquidity, recipient, owner, options) {
+        return (0, zapOut_1.buildZapOutTransactionInternal)(this.publicClient, this.chainId, this.poolService, this.routeService, poolAddress, tokenOut, liquidity, recipient, owner, options);
+    }
+    /**
+     * Builds zap out transaction parameters without checking approval.
+     * Use buildZapOutTransaction if you need approval handling.
+     * @param poolAddress - FPMM pool address
+     * @param tokenOut - Output token address
+     * @param liquidity - Amount of LP tokens to burn
+     * @param recipient - Address to receive output tokens
+     * @param options - Slippage tolerance and deadline
+     * @returns Transaction details with encoded call data and routing information
+     */
+    async buildZapOutParams(poolAddress, tokenOut, liquidity, recipient, options) {
+        return (0, zapOut_1.buildZapOutParamsInternal)(this.publicClient, this.chainId, this.poolService, this.routeService, poolAddress, tokenOut, liquidity, recipient, options);
+    }
+    /**
+     * Quotes a zap in operation (read-only call).
+     * Estimates expected LP tokens and minimum amounts after swaps and slippage.
+     * @param poolAddress - FPMM pool address
+     * @param tokenIn - Input token address
+     * @param amountIn - Total input amount
+     * @param amountInSplit - Split ratio (0-1)
+     * @param options - Slippage tolerance and deadline
+     * @returns Expected LP tokens and minimum amounts for both pool tokens
+     */
+    async quoteZapIn(poolAddress, tokenIn, amountIn, amountInSplit, options) {
+        return (0, zapIn_1.quoteZapInInternal)(this.publicClient, this.chainId, this.poolService, this.routeService, poolAddress, tokenIn, amountIn, amountInSplit, options);
+    }
+    /**
+     * Quotes a zap out operation (read-only call).
+     * Estimates expected output tokens after removing liquidity and swapping.
+     * @param poolAddress - FPMM pool address
+     * @param tokenOut - Output token address
+     * @param liquidity - Amount of LP tokens to burn
+     * @param options - Slippage tolerance and deadline
+     * @returns Expected output amount and minimum amounts after slippage
+     */
+    async quoteZapOut(poolAddress, tokenOut, liquidity, options) {
+        return (0, zapOut_1.quoteZapOutInternal)(this.publicClient, this.chainId, this.poolService, this.routeService, poolAddress, tokenOut, liquidity, options);
+    }
+}
+exports.LiquidityService = LiquidityService;
+//# sourceMappingURL=LiquidityService.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { PublicClient } from 'viem';
+import { PoolService } from '../pools';
+import { LiquidityOptions, AddLiquidityQuote, RemoveLiquidityQuote, AddLiquidityDetails, RemoveLiquidityDetails, AddLiquidityTransaction, RemoveLiquidityTransaction, LPTokenBalance } from '../../core/types';
+export declare function buildAddLiquidityTransactionInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, poolAddress: string, tokenA: string, amountA: bigint, tokenB: string, amountB: bigint, recipient: string, owner: string, options: LiquidityOptions): Promise<AddLiquidityTransaction>;
+export declare function buildAddLiquidityParamsInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, poolAddress: string, tokenA: string, amountA: bigint, tokenB: string, amountB: bigint, recipient: string, options: LiquidityOptions): Promise<AddLiquidityDetails>;
+export declare function quoteAddLiquidityInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, poolAddress: string, tokenA: string, amountA: bigint, tokenB: string, amountB: bigint): Promise<AddLiquidityQuote>;
+export declare function buildRemoveLiquidityTransactionInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, poolAddress: string, liquidity: bigint, recipient: string, owner: string, options: LiquidityOptions): Promise<RemoveLiquidityTransaction>;
+export declare function buildRemoveLiquidityParamsInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, poolAddress: string, liquidity: bigint, recipient: string, options: LiquidityOptions): Promise<RemoveLiquidityDetails>;
+export declare function quoteRemoveLiquidityInternal(publicClient: PublicClient, chainId: number, poolService: PoolService, poolAddress: string, liquidity: bigint): Promise<RemoveLiquidityQuote>;
+export declare function getLPTokenBalanceInternal(publicClient: PublicClient, poolService: PoolService, poolAddress: string, owner: string): Promise<LPTokenBalance>;
+//# sourceMappingURL=basicLiquidity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basicLiquidity.d.ts","sourceRoot":"","sources":["../../../src/services/liquidity/basicLiquidity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,YAAY,EAAsB,MAAM,MAAM,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,cAAc,EACf,MAAM,kBAAkB,CAAA;AAuCzB,wBAAsB,oCAAoC,CACxD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAiClC;AAED,wBAAsB,+BAA+B,CACnD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAmC9B;AAED,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAkB5B;AAED,wBAAsB,uCAAuC,CAC3D,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,0BAA0B,CAAC,CAuBrC;AAED,wBAAsB,kCAAkC,CACtD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CA6BjC;AAED,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAgCzB"}

package/dist/services/liquidity/basicLiquidity.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAddLiquidityTransactionInternal = buildAddLiquidityTransactionInternal;
+exports.buildAddLiquidityParamsInternal = buildAddLiquidityParamsInternal;
+exports.quoteAddLiquidityInternal = quoteAddLiquidityInternal;
+exports.buildRemoveLiquidityTransactionInternal = buildRemoveLiquidityTransactionInternal;
+exports.buildRemoveLiquidityParamsInternal = buildRemoveLiquidityParamsInternal;
+exports.quoteRemoveLiquidityInternal = quoteRemoveLiquidityInternal;
+exports.getLPTokenBalanceInternal = getLPTokenBalanceInternal;
+const viem_1 = require("viem");
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+const validation_1 = require("../../utils/validation");
+const liquidityHelpers_1 = require("./liquidityHelpers");
+function encodeAddLiquidityCall(tokenA, tokenB, amountADesired, amountBDesired, amountAMin, amountBMin, recipient, deadline) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'addLiquidity',
+        args: [tokenA, tokenB, amountADesired, amountBDesired, amountAMin, amountBMin, recipient, deadline],
+    });
+}
+function encodeRemoveLiquidityCall(token0, token1, liquidity, amount0Min, amount1Min, recipient, deadline) {
+    return (0, viem_1.encodeFunctionData)({
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'removeLiquidity',
+        args: [token0, token1, liquidity, amount0Min, amount1Min, recipient, deadline],
+    });
+}
+async function buildAddLiquidityTransactionInternal(publicClient, chainId, poolService, poolAddress, tokenA, amountA, tokenB, amountB, recipient, owner, options) {
+    const addLiquidity = await buildAddLiquidityParamsInternal(publicClient, chainId, poolService, poolAddress, tokenA, amountA, tokenB, amountB, recipient, options);
+    (0, validation_1.validateAddress)(owner, 'owner');
+    const ownerAddr = owner;
+    const tokenAAddr = addLiquidity.tokenA;
+    const tokenBAddr = addLiquidity.tokenB;
+    const [allowanceA, allowanceB] = await Promise.all([
+        (0, liquidityHelpers_1.getAllowance)(publicClient, tokenAAddr, ownerAddr, chainId),
+        (0, liquidityHelpers_1.getAllowance)(publicClient, tokenBAddr, ownerAddr, chainId),
+    ]);
+    const approvalA = allowanceA < amountA
+        ? { token: addLiquidity.tokenA, amount: amountA, params: (0, liquidityHelpers_1.buildApprovalParams)(chainId, tokenAAddr, amountA) }
+        : null;
+    const approvalB = allowanceB < amountB
+        ? { token: addLiquidity.tokenB, amount: amountB, params: (0, liquidityHelpers_1.buildApprovalParams)(chainId, tokenBAddr, amountB) }
+        : null;
+    return { approvalA, approvalB, addLiquidity };
+}
+async function buildAddLiquidityParamsInternal(publicClient, chainId, poolService, poolAddress, tokenA, amountA, tokenB, amountB, recipient, options) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(tokenA, 'tokenA');
+    (0, validation_1.validateAddress)(tokenB, 'tokenB');
+    (0, validation_1.validateAddress)(recipient, 'recipient');
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    (0, liquidityHelpers_1.validatePoolTokens)(token0, token1, tokenA, tokenB);
+    const quote = await quoteAddLiquidityInternal(publicClient, chainId, poolService, poolAddress, tokenA, amountA, tokenB, amountB);
+    const amountAMin = (0, liquidityHelpers_1.calculateMinAmount)(quote.amountA, options.slippageTolerance);
+    const amountBMin = (0, liquidityHelpers_1.calculateMinAmount)(quote.amountB, options.slippageTolerance);
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const data = encodeAddLiquidityCall(tokenA, tokenB, amountA, amountB, amountAMin, amountBMin, recipient, options.deadline);
+    return {
+        params: {
+            to: routerAddress,
+            data,
+            value: '0',
+        },
+        poolAddress,
+        token0,
+        token1,
+        tokenA,
+        tokenB,
+        amountADesired: amountA,
+        amountBDesired: amountB,
+        amountAMin,
+        amountBMin,
+        estimatedMinLiquidity: quote.liquidity,
+        deadline: options.deadline,
+    };
+}
+async function quoteAddLiquidityInternal(publicClient, chainId, poolService, poolAddress, tokenA, amountA, tokenB, amountB) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(tokenA, 'tokenA');
+    (0, validation_1.validateAddress)(tokenB, 'tokenB');
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    (0, liquidityHelpers_1.validatePoolTokens)(token0, token1, tokenA, tokenB);
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const [resultAmountA, resultAmountB, liquidity] = (await publicClient.readContract({
+        address: routerAddress,
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'quoteAddLiquidity',
+        args: [tokenA, tokenB, factoryAddr, amountA, amountB],
+    }));
+    return { amountA: resultAmountA, amountB: resultAmountB, liquidity };
+}
+async function buildRemoveLiquidityTransactionInternal(publicClient, chainId, poolService, poolAddress, liquidity, recipient, owner, options) {
+    (0, validation_1.validateAddress)(owner, 'owner');
+    // Build remove liquidity params
+    const removeLiquidity = await buildRemoveLiquidityParamsInternal(publicClient, chainId, poolService, poolAddress, liquidity, recipient, options);
+    const poolAddr = poolAddress; // Pool address IS the LP token
+    const ownerAddr = owner;
+    const currentAllowance = await (0, liquidityHelpers_1.getAllowance)(publicClient, poolAddr, ownerAddr, chainId);
+    const approval = currentAllowance < liquidity
+        ? { token: poolAddress, amount: liquidity, params: (0, liquidityHelpers_1.buildApprovalParams)(chainId, poolAddr, liquidity) }
+        : null;
+    return { approval, removeLiquidity };
+}
+async function buildRemoveLiquidityParamsInternal(publicClient, chainId, poolService, poolAddress, liquidity, recipient, options) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(recipient, 'recipient');
+    const { token0, token1 } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    const quote = await quoteRemoveLiquidityInternal(publicClient, chainId, poolService, poolAddress, liquidity);
+    const amount0Min = (0, liquidityHelpers_1.calculateMinAmount)(quote.amount0, options.slippageTolerance);
+    const amount1Min = (0, liquidityHelpers_1.calculateMinAmount)(quote.amount1, options.slippageTolerance);
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const data = encodeRemoveLiquidityCall(token0, token1, liquidity, amount0Min, amount1Min, recipient, options.deadline);
+    return {
+        params: {
+            to: routerAddress,
+            data,
+            value: '0',
+        },
+        poolAddress,
+        token0,
+        token1,
+        liquidity,
+        amount0Min,
+        amount1Min,
+        expectedAmount0: quote.amount0,
+        expectedAmount1: quote.amount1,
+        deadline: options.deadline,
+    };
+}
+async function quoteRemoveLiquidityInternal(publicClient, chainId, poolService, poolAddress, liquidity) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    const { token0, token1, factoryAddr } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const [amount0, amount1] = (await publicClient.readContract({
+        address: routerAddress,
+        abi: abis_1.ROUTER_ABI,
+        functionName: 'quoteRemoveLiquidity',
+        args: [token0, token1, factoryAddr, liquidity],
+    }));
+    return { amount0, amount1 };
+}
+async function getLPTokenBalanceInternal(publicClient, poolService, poolAddress, owner) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    (0, validation_1.validateAddress)(owner, 'owner');
+    const { token0, token1 } = await (0, liquidityHelpers_1.getPoolInfo)(poolService, poolAddress);
+    // Pool address IS the LP token address (FPMM pools are ERC20)
+    const [balance, totalSupply] = await Promise.all([
+        publicClient.readContract({
+            address: poolAddress,
+            abi: abis_1.ERC20_ABI,
+            functionName: 'balanceOf',
+            args: [owner],
+        }),
+        publicClient.readContract({
+            address: poolAddress,
+            abi: abis_1.ERC20_ABI,
+            functionName: 'totalSupply',
+            args: [],
+        }),
+    ]);
+    const sharePercent = totalSupply > 0n ? Number((balance * 10000n) / totalSupply) / 100 : 0;
+    return {
+        poolAddress,
+        balance,
+        token0,
+        token1,
+        totalSupply,
+        sharePercent,
+    };
+}
+//# sourceMappingURL=basicLiquidity.js.map

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

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

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

@@ -0,0 +1,2 @@
+export * from './LiquidityService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/liquidity/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA"}

package/dist/services/liquidity/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./LiquidityService"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/liquidity/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAkC"}

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

@@ -0,0 +1,13 @@
+import { Address, PublicClient } from 'viem';
+import { PoolService } from '../pools';
+import { CallParams } from '../../core/types';
+export declare function buildApprovalParams(chainId: number, token: Address, amount: bigint): CallParams;
+export declare function getAllowance(publicClient: PublicClient, token: Address, owner: Address, chainId: number): Promise<bigint>;
+export declare function calculateMinAmount(amount: bigint, slippageTolerance: number): bigint;
+export declare function getPoolInfo(poolService: PoolService, poolAddress: string): Promise<{
+    token0: Address;
+    token1: Address;
+    factoryAddr: Address;
+}>;
+export declare function validatePoolTokens(poolToken0: Address, poolToken1: Address, tokenA: string, tokenB: string): void;
+//# sourceMappingURL=liquidityHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquidityHelpers.d.ts","sourceRoot":"","sources":["../../../src/services/liquidity/liquidityHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAsB,MAAM,MAAM,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,UAAU,EAAY,MAAM,kBAAkB,CAAA;AAKvD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAQ/F;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAWpF;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;CACrB,CAAC,CAmBD;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,IAAI,CAoBN"}

package/dist/services/liquidity/liquidityHelpers.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildApprovalParams = buildApprovalParams;
+exports.getAllowance = getAllowance;
+exports.calculateMinAmount = calculateMinAmount;
+exports.getPoolInfo = getPoolInfo;
+exports.validatePoolTokens = validatePoolTokens;
+const viem_1 = require("viem");
+const types_1 = require("../../core/types");
+const abis_1 = require("../../core/abis");
+const constants_1 = require("../../core/constants");
+const validation_1 = require("../../utils/validation");
+function buildApprovalParams(chainId, token, amount) {
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    const data = (0, viem_1.encodeFunctionData)({
+        abi: abis_1.ERC20_ABI,
+        functionName: 'approve',
+        args: [routerAddress, amount],
+    });
+    return { to: token, data, value: '0' };
+}
+async function getAllowance(publicClient, token, owner, chainId) {
+    const routerAddress = (0, constants_1.getContractAddress)(chainId, 'Router');
+    return (await publicClient.readContract({
+        address: token,
+        abi: abis_1.ERC20_ABI,
+        functionName: 'allowance',
+        args: [owner, routerAddress],
+    }));
+}
+function calculateMinAmount(amount, slippageTolerance) {
+    if (slippageTolerance < 0) {
+        throw new Error('Slippage tolerance cannot be negative');
+    }
+    if (slippageTolerance > 100) {
+        throw new Error('Slippage tolerance cannot exceed 100%');
+    }
+    const basisPoints = BigInt(Math.floor(slippageTolerance * 100));
+    const slippageMultiplier = 10000n - basisPoints;
+    return (amount * slippageMultiplier) / 10000n;
+}
+async function getPoolInfo(poolService, poolAddress) {
+    (0, validation_1.validateAddress)(poolAddress, 'poolAddress');
+    const pools = await poolService.getPools();
+    const pool = pools.find((p) => p.poolAddr.toLowerCase() === poolAddress.toLowerCase());
+    if (!pool) {
+        throw new Error(`Pool not found: ${poolAddress}. Ensure the address is a valid FPMM pool.`);
+    }
+    if (pool.poolType !== types_1.PoolType.FPMM) {
+        throw new Error(`Pool ${poolAddress} is type ${pool.poolType}. Only FPMM pools support liquidity provision.`);
+    }
+    return {
+        token0: pool.token0,
+        token1: pool.token1,
+        factoryAddr: pool.factoryAddr,
+    };
+}
+function validatePoolTokens(poolToken0, poolToken1, tokenA, tokenB) {
+    const tokenALower = tokenA.toLowerCase();
+    const tokenBLower = tokenB.toLowerCase();
+    const token0Lower = poolToken0.toLowerCase();
+    const token1Lower = poolToken1.toLowerCase();
+    // Ensure both tokens belong to pool
+    const aInPool = tokenALower === token0Lower || tokenALower === token1Lower;
+    const bInPool = tokenBLower === token0Lower || tokenBLower === token1Lower;
+    if (!aInPool || !bInPool) {
+        throw new Error(`Tokens don't match pool. Pool has ${poolToken0} and ${poolToken1}, but received ${tokenA} and ${tokenB}`);
+    }
+    // Ensure tokens are different
+    if (tokenALower === tokenBLower) {
+        throw new Error('tokenA and tokenB must be different');
+    }
+}
+//# sourceMappingURL=liquidityHelpers.js.map

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

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

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

@@ -0,0 +1,66 @@
+import { Address } from 'viem';
+import { RouteService } from '../routes';
+import { ZapParams } from '../../core/types';
+import { RouterRoute } from '../../utils/pathEncoder';
+/**
+ * Encodes the zapIn function call for the Router contract
+ */
+export declare function encodeZapInCall(tokenIn: Address, amountInA: bigint, amountInB: bigint, zapParams: ZapParams, routesA: RouterRoute[], routesB: RouterRoute[], recipient: Address): string;
+/**
+ * Encodes the zapOut function call for the Router contract
+ */
+export declare function encodeZapOutCall(tokenOut: Address, liquidity: bigint, zapParams: ZapParams, routesA: RouterRoute[], routesB: RouterRoute[]): string;
+/**
+ * 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
+ */
+export declare function findZapInRoutes(routeService: RouteService, tokenIn: string, token0: string, token1: string): Promise<{
+    routesA: RouterRoute[];
+    routesB: RouterRoute[];
+}>;
+/**
+ * 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
+ */
+export declare function findZapOutRoutes(routeService: RouteService, token0: string, token1: string, tokenOut: string): Promise<{
+    routesA: RouterRoute[];
+    routesB: RouterRoute[];
+}>;
+/**
+ * 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
+ */
+export declare function splitAmount(amountIn: bigint, splitRatio: number): {
+    amountA: bigint;
+    amountB: bigint;
+};
+/**
+ * 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
+ */
+export declare function estimateLiquidityFromZapIn(amountOutA: bigint, amountOutB: bigint, reserve0: bigint, reserve1: bigint, totalSupply: bigint): bigint;
+//# sourceMappingURL=zapHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zapHelpers.d.ts","sourceRoot":"","sources":["../../../src/services/liquidity/zapHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,MAAM,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C,OAAO,EAAmB,WAAW,EAAwB,MAAM,yBAAyB,CAAA;AAI5F;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,EAAE,OAAO,GACjB,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,EAAE,WAAW,EAAE,GACrB,MAAM,CAMR;AAID;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAiB7D;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAiB7D;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAStG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAiBR"}