@mento-protocol/mento-sdk 3.0.0-beta.3 → 3.0.0-beta.30

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

@@ -0,0 +1,154 @@
+import { PublicClient } from 'viem';
+import { PoolService } from '../pools';
+import { RouteService } from '../routes';
+import { LiquidityOptions, AddLiquidityQuote, RemoveLiquidityQuote, AddLiquidityDetails, RemoveLiquidityDetails, AddLiquidityTransaction, RemoveLiquidityTransaction, LPTokenBalance, ZapInQuote, ZapOutQuote, ZapInDetails, ZapOutDetails, ZapInTransaction, ZapOutTransaction } from '../../core/types';
+export declare class LiquidityService {
+    private publicClient;
+    private chainId;
+    private poolService;
+    private routeService;
+    constructor(publicClient: PublicClient, chainId: number, poolService: PoolService, 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
+     */
+    buildAddLiquidityTransaction(poolAddress: string, tokenA: string, amountA: bigint, tokenB: string, amountB: bigint, recipient: string, owner: string, options: LiquidityOptions): Promise<AddLiquidityTransaction>;
+    /**
+     * 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
+     */
+    buildAddLiquidityParams(poolAddress: string, tokenA: string, amountA: bigint, tokenB: string, amountB: bigint, recipient: string, options: LiquidityOptions): Promise<AddLiquidityDetails>;
+    /**
+     * 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
+     */
+    buildRemoveLiquidityTransaction(poolAddress: string, liquidity: bigint, recipient: string, owner: string, options: LiquidityOptions): Promise<RemoveLiquidityTransaction>;
+    /**
+     * 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
+     */
+    buildRemoveLiquidityParams(poolAddress: string, liquidity: bigint, recipient: string, options: LiquidityOptions): Promise<RemoveLiquidityDetails>;
+    /**
+     * 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
+     */
+    quoteAddLiquidity(poolAddress: string, tokenA: string, amountA: bigint, tokenB: string, amountB: bigint): Promise<AddLiquidityQuote>;
+    /**
+     * 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
+     */
+    quoteRemoveLiquidity(poolAddress: string, liquidity: bigint): Promise<RemoveLiquidityQuote>;
+    /**
+     * 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
+     */
+    getLPTokenBalance(poolAddress: string, owner: string): Promise<LPTokenBalance>;
+    /**
+     * 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
+     */
+    buildZapInTransaction(poolAddress: string, tokenIn: string, amountIn: bigint, amountInSplit: number, recipient: string, owner: string, options: LiquidityOptions): Promise<ZapInTransaction>;
+    /**
+     * 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
+     */
+    buildZapInParams(poolAddress: string, tokenIn: string, amountIn: bigint, amountInSplit: number, recipient: string, options: LiquidityOptions): Promise<ZapInDetails>;
+    /**
+     * 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
+     */
+    buildZapOutTransaction(poolAddress: string, tokenOut: string, liquidity: bigint, recipient: string, owner: string, options: LiquidityOptions): Promise<ZapOutTransaction>;
+    /**
+     * 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
+     */
+    buildZapOutParams(poolAddress: string, tokenOut: string, liquidity: bigint, recipient: string, options: LiquidityOptions): Promise<ZapOutDetails>;
+    /**
+     * 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
+     */
+    quoteZapIn(poolAddress: string, tokenIn: string, amountIn: bigint, amountInSplit: number, options: LiquidityOptions): Promise<ZapInQuote>;
+    /**
+     * 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
+     */
+    quoteZapOut(poolAddress: string, tokenOut: string, liquidity: bigint, options: LiquidityOptions): Promise<ZapOutQuote>;
+}
+//# sourceMappingURL=LiquidityService.d.ts.map

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

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

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"}