@steerprotocol/sdk 1.19.15 → 1.19.16

package/dist/cjs/base/vault/single-asset/calculateLimitPrice.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bigintToDecimal = bigintToDecimal;
+exports.decimalToBigint = decimalToBigint;
+exports.getQuoteFromSqrtRatioX96 = getQuoteFromSqrtRatioX96;
+exports.calculateLimitPrice = calculateLimitPrice;
+exports.getPoolSlot0 = getPoolSlot0;
+const decimal_js_1 = require("decimal.js");
+const erc20_1 = require("../../../const/abis/erc20");
+const utils_1 = require("../utils");
+const types_1 = require("./types");
+/**
+ * Configure Decimal.js for high precision calculations
+ */
+decimal_js_1.Decimal.config({
+    precision: 50, // High precision for financial calculations
+    rounding: decimal_js_1.Decimal.ROUND_DOWN // Conservative rounding for safety
+});
+/**
+ * Constants matching the Solidity contract using Decimal.js
+ */
+const BASIS_POINTS = new decimal_js_1.Decimal(10000);
+const Q96 = new decimal_js_1.Decimal(2).pow(96);
+const Q192 = Q96.mul(Q96);
+const Q128 = new decimal_js_1.Decimal(2).pow(128);
+const Q64 = new decimal_js_1.Decimal(2).pow(64);
+const UINT128_MAX = new decimal_js_1.Decimal(2).pow(128).sub(1);
+/**
+ * High-precision multiplication and division using Decimal.js
+ * Equivalent to Solidity's FullMath.mulDiv
+ */
+function mulDiv(a, b, denominator) {
+    return a.mul(b).div(denominator);
+}
+/**
+ * High-precision square root using Decimal.js
+ */
+function sqrt(value) {
+    if (value.isZero())
+        return new decimal_js_1.Decimal(0);
+    return value.sqrt();
+}
+/**
+ * Convert BigInt to Decimal for calculations
+ */
+function bigintToDecimal(value) {
+    return new decimal_js_1.Decimal(value.toString());
+}
+/**
+ * Convert Decimal back to BigInt for return values
+ * Uses toFixed(0) to get full decimal representation without scientific notation
+ */
+function decimalToBigint(value) {
+    // Use toFixed(0) to get full integer representation without scientific notation
+    const stringValue = value.floor().toFixed(0);
+    return BigInt(stringValue);
+}
+/**
+ * Get quote from sqrtRatioX96 using high-precision Decimal arithmetic
+ * Equivalent to Solidity's getQuoteFromSqrtRatioX96
+ * @param sqrtRatioX96 The sqrt ratio for which to compute the quote
+ * @param baseAmount Amount of base token
+ * @param baseToken Address of base token
+ * @param quoteToken Address of quote token
+ * @returns The quote amount as Decimal
+ */
+function getQuoteFromSqrtRatioX96(sqrtRatioX96, baseAmount, baseToken, quoteToken) {
+    // Calculate quoteAmount with better precision if it doesn't overflow when multiplied by itself
+    if (sqrtRatioX96.lte(UINT128_MAX)) {
+        const ratioX192 = sqrtRatioX96.mul(sqrtRatioX96);
+        return baseToken < quoteToken
+            ? mulDiv(ratioX192, baseAmount, Q192)
+            : mulDiv(Q192, baseAmount, ratioX192);
+    }
+    else {
+        const ratioX128 = mulDiv(sqrtRatioX96, sqrtRatioX96, Q64);
+        return baseToken < quoteToken
+            ? mulDiv(ratioX128, baseAmount, Q128)
+            : mulDiv(Q128, baseAmount, ratioX128);
+    }
+}
+/**
+ * Applies slippage protection to sqrtPriceX96 based on swap direction using high-precision arithmetic
+ * Equivalent to Solidity's applySlippageProtection function
+ * @param sqrtPriceX96 The current square root price
+ * @param slippageBP Slippage protection in basis points (e.g., 300 = 3%)
+ * @param zeroForOne True if swapping token0 for token1
+ * @param token0 Address of token0
+ * @param token1 Address of token1
+ * @param publicClient Viem public client for reading token decimals
+ * @returns The price limit with slippage protection as Decimal
+ */
+async function applySlippageProtection(sqrtPriceX96, slippageBP, zeroForOne, token0, token1, publicClient) {
+    // Get current price: how much token1 per 1 unit of token0
+    const decimals0 = await publicClient.readContract({
+        address: token0,
+        abi: erc20_1.erc20Abi,
+        functionName: 'decimals'
+    });
+    const baseAmount = new decimal_js_1.Decimal(10).pow(decimals0);
+    const currentQuote = getQuoteFromSqrtRatioX96(sqrtPriceX96, baseAmount, token0, token1);
+    let adjustedQuote;
+    if (zeroForOne) {
+        // Swapping token0 for token1
+        // We want to ensure we don't get less than expected token1
+        // So we set a minimum acceptable rate (decrease the quote)
+        adjustedQuote = mulDiv(currentQuote, BASIS_POINTS.sub(slippageBP), BASIS_POINTS);
+    }
+    else {
+        // Swapping token1 for token0  
+        // We want to ensure we don't pay more than expected token1
+        // So we set a maximum acceptable rate (increase the quote)
+        adjustedQuote = mulDiv(currentQuote, BASIS_POINTS.add(slippageBP), BASIS_POINTS);
+    }
+    if (adjustedQuote.isZero()) {
+        throw new Error('AdjustedQuoteCalculationFailed');
+    }
+    // Convert adjusted quote back to sqrtPriceX96
+    // This is the reverse of getQuoteFromSqrtRatioX96
+    let adjustedRatioX192;
+    if (token0 < token1) {
+        // ratioX192 = (adjustedQuote * 2^192) / baseAmount
+        adjustedRatioX192 = mulDiv(adjustedQuote, Q192, baseAmount);
+    }
+    else {
+        // ratioX192 = (baseAmount * 2^192) / adjustedQuote  
+        adjustedRatioX192 = mulDiv(baseAmount, Q192, adjustedQuote);
+    }
+    return sqrt(adjustedRatioX192);
+}
+/**
+ * Calculates the sqrt price limit for slippage protection during swaps using high-precision arithmetic
+ *
+ * @param publicClient - Viem public client for blockchain reads
+ * @param params - Parameters for limit price calculation
+ * @returns Promise resolving to the calculated sqrt price limit
+ *
+ * @example
+ * ```typescript
+ * const result = await calculateLimitPrice(publicClient, {
+ *   pool: '0x...',
+ *   slippageBP: 500, // 5% slippage
+ *   zeroForOne: true,
+ *   ammType: AMMType.UniswapV3,
+ *   token0: '0x...',
+ *   token1: '0x...'
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Sqrt price limit:', result.data);
+ * }
+ * ```
+ */
+async function calculateLimitPrice(publicClient, params) {
+    try {
+        // Get current pool state from slot0
+        const slot0Data = await (0, utils_1.getPoolState)(publicClient, {
+            poolAddress: params.pool,
+            isAlgebraPool: params.ammType === types_1.AMMType.Algebra,
+            isAlgebraIntegralPool: params.ammType === types_1.AMMType.AlgebraIntegral,
+            isAlgebraDirectionPool: params.ammType === types_1.AMMType.AlgebraDirectional,
+            isPoolSharkPool: false // PoolShark not defined in AMMType enum
+        });
+        if (!slot0Data.success || !slot0Data.data) {
+            throw new Error(slot0Data.error || 'Failed to get pool state');
+        }
+        const sqrtPriceX96BigInt = (0, utils_1.getPoolPrice)(slot0Data.data, {
+            isAlgebraPool: params.ammType === types_1.AMMType.Algebra,
+            isAlgebraIntegralPool: params.ammType === types_1.AMMType.AlgebraIntegral,
+            isPoolSharkPool: false // PoolShark not defined in AMMType enum
+        });
+        if (!sqrtPriceX96BigInt) {
+            throw new Error('Failed to extract pool price');
+        }
+        // Convert to Decimal for high-precision calculations
+        const sqrtPriceX96 = bigintToDecimal(sqrtPriceX96BigInt);
+        const slippageBP = new decimal_js_1.Decimal(params.slippageBP);
+        // Apply slippage protection using high-precision arithmetic
+        const limitSqrtPriceX96Decimal = await applySlippageProtection(sqrtPriceX96, slippageBP, params.zeroForOne, params.token0, params.token1, publicClient);
+        return {
+            data: decimalToBigint(limitSqrtPriceX96Decimal),
+            status: 200,
+            success: true
+        };
+    }
+    catch (error) {
+        return {
+            data: null,
+            status: 500,
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to calculate limit price'
+        };
+    }
+}
+/**
+ * Gets the current pool state from slot0
+ * Currently supports UniswapV3 only
+ *
+ * @param publicClient - Viem public client for blockchain reads
+ * @param poolAddress - Address of the pool
+ * @param ammType - Type of AMM
+ * @returns Promise resolving to the pool slot0 data
+ */
+async function getPoolSlot0(publicClient, poolAddress, ammType) {
+    try {
+        const poolState = await (0, utils_1.getPoolStateWithPrice)(publicClient, {
+            poolAddress,
+            isAlgebraPool: ammType === types_1.AMMType.Algebra,
+            isAlgebraIntegralPool: ammType === types_1.AMMType.AlgebraIntegral,
+            isAlgebraDirectionPool: ammType === types_1.AMMType.AlgebraDirectional,
+            isPoolSharkPool: false // PoolShark not defined in AMMType enum
+        });
+        if (!poolState.success || !poolState.data) {
+            throw new Error(poolState.error || 'Failed to get pool state');
+        }
+        return {
+            data: poolState.data.state,
+            status: 200,
+            success: true
+        };
+    }
+    catch (error) {
+        return {
+            data: null,
+            status: 500,
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to get pool slot0 data'
+        };
+    }
+}
+//# sourceMappingURL=calculateLimitPrice.js.map

package/dist/cjs/base/vault/single-asset/calculateLimitPrice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateLimitPrice.js","sourceRoot":"","sources":["../../../../../src/base/vault/single-asset/calculateLimitPrice.ts"],"names":[],"mappings":"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"}

package/dist/cjs/base/vault/single-asset/calculateSwapAmount.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateSwapAmount = calculateSwapAmount;
+const singleTokenDeposit_1 = require("../../../const/abis/singleTokenDeposit");
+const const_1 = require("../../../const");
+/**
+ * Calculates the amount that needs to be swapped for a single-asset deposit
+ * This function calls the smart contract's calculateSwapAmount function
+ *
+ * @param publicClient - Viem public client for blockchain reads
+ * @param params - Parameters for swap amount calculation
+ * @returns Promise resolving to swap amount and current sqrt price
+ *
+ * @example
+ * ```typescript
+ * const result = await calculateSwapAmount(publicClient, {
+ *   depositAmount: parseEther('100'),
+ *   isToken0: true,
+ *   vault: '0x...',
+ *   pool: '0x...',
+ *   ammType: AMMType.UniswapV3,
+ *   singleAssetDepositContract: '0x...'
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Swap amount:', result.data.swapAmount);
+ *   console.log('Current sqrt price:', result.data.sqrtPrice);
+ * }
+ * ```
+ */
+async function calculateSwapAmount(publicClient, params) {
+    try {
+        // Call the smart contract's calculateSwapAmount function
+        const chainId = await publicClient.getChainId();
+        const singleAssentDeposit = params.singleAssetDepositContract || (0, const_1.getContractAddressByChainIdAndContractName)(chainId, 'SingleAssetDeposit');
+        const result = await publicClient.readContract({
+            address: singleAssentDeposit,
+            abi: singleTokenDeposit_1.singleTokenDepositAbi,
+            functionName: 'calculateSwapAmount',
+            args: [
+                params.depositAmount,
+                params.isToken0,
+                params.vault,
+                params.pool,
+                params.ammType
+            ]
+        });
+        // The contract returns [swapAmount, sqrtPrice]
+        const [swapAmount, sqrtPrice] = result;
+        return {
+            data: {
+                swapAmount,
+                sqrtPrice
+            },
+            status: 200,
+            success: true
+        };
+    }
+    catch (error) {
+        return {
+            data: null,
+            status: 500,
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to calculate swap amount'
+        };
+    }
+}
+//# sourceMappingURL=calculateSwapAmount.js.map

package/dist/cjs/base/vault/single-asset/calculateSwapAmount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateSwapAmount.js","sourceRoot":"","sources":["../../../../../src/base/vault/single-asset/calculateSwapAmount.ts"],"names":[],"mappings":";;AA+BA,kDA0CC;AAxED,+EAA+E;AAG/E,0CAA4E;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,KAAK,UAAU,mBAAmB,CACvC,YAA0B,EAC1B,MAAiC;IAEjC,IAAI,CAAC;QACH,yDAAyD;QAEzD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QAChD,MAAM,mBAAmB,GAAG,MAAM,CAAC,0BAA0B,IAAI,IAAA,kDAA0C,EAAC,OAAO,EAAE,oBAAoB,CAAC,CAAA;QAE1I,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;YAC7C,OAAO,EAAE,mBAAmB;YAC5B,GAAG,EAAE,0CAAqB;YAC1B,YAAY,EAAE,qBAAqB;YACnC,IAAI,EAAE;gBACJ,MAAM,CAAC,aAAa;gBACpB,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,KAAK;gBACZ,MAAM,CAAC,IAAI;gBACX,MAAM,CAAC,OAAO;aACf;SACF,CAAC,CAAC;QAEH,+CAA+C;QAC/C,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,MAA0B,CAAC;QAE3D,OAAO;YACL,IAAI,EAAE;gBACJ,UAAU;gBACV,SAAS;aACV;YACD,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC;SAClF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cjs/base/vault/single-asset/estimateLpTokens.js

@@ -0,0 +1,355 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateLpTokens = estimateLpTokens;
+exports.getShares = getShares;
+exports.getVaultReserves = getVaultReserves;
+const abis_1 = require("../../../const/deployments/abis");
+const network_1 = require("../../../const/network");
+// Use the vault ABI for reading vault state
+const VAULT_ABI = abis_1.abis.QuickSwapUniv3MultiPositionLiquidityManager;
+/**
+ * Estimates the amount of LP tokens that will be received based on the final token amounts
+ * This calculation follows the Solidity getShares implementation from the vault contract
+ *
+ * @param publicClient - Viem public client for blockchain reads
+ * @param params - Parameters for LP token estimation
+ * @returns Promise resolving to the estimated LP tokens and final amounts
+ *
+ * @example
+ * ```typescript
+ * const result = await estimateLpTokens(publicClient, {
+ *   vault: '0x...',
+ *   originalAssets: parseEther('100'),
+ *   swapAmount: parseEther('50'),
+ *   swapResult: { amount0: -parseEther('50'), amount1: parseEther('150') },
+ *   isToken0: true
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Estimated LP tokens:', result.data.lpTokens);
+ *   console.log('Final amount0:', result.data.finalAmount0);
+ *   console.log('Final amount1:', result.data.finalAmount1);
+ * }
+ * ```
+ */
+async function estimateLpTokens(publicClient, params) {
+    try {
+        // Calculate final amounts based on original deposit and swap results
+        const finalAmount0 = params.isToken0
+            ? params.originalAssets - params.swapAmount + (params.swapResult.amount0 < 0n ? -params.swapResult.amount0 : params.swapResult.amount0)
+            : (params.swapResult.amount0 < 0n ? -params.swapResult.amount0 : params.swapResult.amount0);
+        const finalAmount1 = params.isToken0
+            ? (params.swapResult.amount1 < 0n ? -params.swapResult.amount1 : params.swapResult.amount1)
+            : params.originalAssets - params.swapAmount + (params.swapResult.amount1 < 0n ? -params.swapResult.amount1 : params.swapResult.amount1);
+        // Get vault reserves and total supply
+        const [totalSupply, tokenBalances] = await Promise.all([
+            publicClient.readContract({
+                address: params.vault,
+                abi: [{
+                        "inputs": [],
+                        "name": "totalSupply",
+                        "outputs": [
+                            {
+                                "internalType": "uint256",
+                                "name": "",
+                                "type": "uint256"
+                            }
+                        ],
+                        "stateMutability": "view",
+                        "type": "function"
+                    },],
+                functionName: 'totalSupply'
+            }),
+            // Get token0 address first, then balance
+            publicClient.readContract({
+                address: params.vault,
+                abi: [{
+                        "inputs": [],
+                        "name": "getTotalAmounts",
+                        "outputs": [
+                            {
+                                "internalType": "uint256",
+                                "name": "total0",
+                                "type": "uint256"
+                            },
+                            {
+                                "internalType": "uint256",
+                                "name": "total1",
+                                "type": "uint256"
+                            }
+                        ],
+                        "stateMutability": "view",
+                        "type": "function"
+                    },],
+                functionName: 'getTotalAmounts'
+            })
+        ]);
+        const chainId = await publicClient.getChainId();
+        const helper = (0, network_1.getContractAddressByChainIdAndContractName)(chainId, 'Helper');
+        const [shares, amount0Used, amount1Used] = await publicClient.readContract({
+            address: helper,
+            abi: [{
+                    "inputs": [
+                        {
+                            "internalType": "uint256",
+                            "name": "_totalSupply",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "total0",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "total1",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "amount0Desired",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "amount1Desired",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "amount0Min",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "amount1Min",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "minShares",
+                            "type": "uint256"
+                        }
+                    ],
+                    "name": "getShares",
+                    "outputs": [
+                        {
+                            "internalType": "uint256",
+                            "name": "shares",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "amount0Used",
+                            "type": "uint256"
+                        },
+                        {
+                            "internalType": "uint256",
+                            "name": "amount1Used",
+                            "type": "uint256"
+                        }
+                    ],
+                    "stateMutability": "pure",
+                    "type": "function"
+                }],
+            functionName: 'getShares',
+            args: [
+                totalSupply,
+                tokenBalances[0],
+                tokenBalances[1],
+                finalAmount0,
+                finalAmount1,
+                0n, // amount0Min = 0 as requested
+                0n, // amount1Min = 0 as requested
+                0n // minShares = 0
+            ]
+        });
+        return {
+            data: {
+                lpTokens: shares,
+                finalAmount0: amount0Used,
+                finalAmount1: amount1Used
+            },
+            status: 200,
+            success: true
+        };
+    }
+    catch (error) {
+        return {
+            data: null,
+            status: 500,
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to estimate LP tokens'
+        };
+    }
+}
+/**
+ * Calculates shares (LP tokens) based on deposit amounts and vault reserves
+ * This is a TypeScript implementation of the Solidity getShares function
+ *
+ * @param totalSupply - Current total supply of LP tokens
+ * @param total0 - Current balance of token0 in vault
+ * @param total1 - Current balance of token1 in vault
+ * @param amount0Desired - Desired amount of token0 to deposit
+ * @param amount1Desired - Desired amount of token1 to deposit
+ * @param amount0Min - Minimum amount of token0 (set to 0n)
+ * @param amount1Min - Minimum amount of token1 (set to 0n)
+ * @param minShares - Minimum shares required (set to 0n)
+ * @returns Object with shares, amount0Used, and amount1Used
+ */
+function getShares(totalSupply, total0, total1, amount0Desired, amount1Desired, amount0Min, amount1Min, minShares) {
+    // If total supply > 0, vault can't be empty.
+    if (!(totalSupply === 0n || total0 > 0n || total1 > 0n)) {
+        throw new Error('Invalid vault state');
+    }
+    let shares;
+    let amount0Used = 0n;
+    let amount1Used = 0n;
+    if (totalSupply === 0n) {
+        // For first deposit, just use the amounts desired
+        amount0Used = amount0Desired;
+        amount1Used = amount1Desired;
+        shares = amount0Used > amount1Used ? amount0Used : amount1Used;
+        if (shares < minShares) {
+            throw new Error('Insufficient shares for minimum requirement');
+        }
+    }
+    else if (total0 === 0n) {
+        // Vault only has token1
+        shares = mulDiv(amount1Desired, totalSupply, total1);
+        amount1Used = mulDivRoundingUp(shares, total1, totalSupply);
+        amount0Used = 0n;
+    }
+    else if (total1 === 0n) {
+        // Vault only has token0
+        shares = mulDiv(amount0Desired, totalSupply, total0);
+        amount0Used = mulDivRoundingUp(shares, total0, totalSupply);
+        amount1Used = 0n;
+    }
+    else {
+        // Both tokens present - calculate cross product
+        const cross = min(amount0Desired * total1, amount1Desired * total0);
+        if (cross === 0n) {
+            throw new Error('Invalid deposit ratio - cross product is zero');
+        }
+        // Round up amounts
+        amount0Used = ((cross - 1n) / total1) + 1n;
+        amount1Used = ((cross - 1n) / total0) + 1n;
+        shares = mulDiv(cross, totalSupply, total0) / total1;
+    }
+    // Validate requirements
+    if (shares === 0n) {
+        throw new Error('Zero shares calculated');
+    }
+    if (amount0Used < amount0Min) {
+        throw new Error('Amount0 used less than minimum');
+    }
+    if (amount1Used < amount1Min) {
+        throw new Error('Amount1 used less than minimum');
+    }
+    return { shares, amount0Used, amount1Used };
+}
+/**
+ * Multiplies two BigInt values and divides by a third (a * b / c)
+ * Equivalent to Solidity's FullMath.mulDiv
+ */
+function mulDiv(a, b, c) {
+    if (c === 0n) {
+        throw new Error('Division by zero');
+    }
+    return (a * b) / c;
+}
+/**
+ * Multiplies two BigInt values, divides by a third, and rounds up
+ * Equivalent to Solidity's FullMath.mulDivRoundingUp
+ */
+function mulDivRoundingUp(a, b, c) {
+    if (c === 0n) {
+        throw new Error('Division by zero');
+    }
+    const result = (a * b) / c;
+    const remainder = (a * b) % c;
+    return remainder > 0n ? result + 1n : result;
+}
+/**
+ * Returns the minimum of two BigInt values
+ */
+function min(a, b) {
+    return a < b ? a : b;
+}
+/**
+ * Gets the current vault reserves for both tokens
+ *
+ * @param publicClient - Viem public client for blockchain reads
+ * @param vaultAddress - Address of the vault
+ * @returns Promise resolving to [token0Balance, token1Balance, totalSupply]
+ */
+async function getVaultReserves(publicClient, vaultAddress) {
+    try {
+        const [totalSupply, token0Address, token1Address] = await Promise.all([
+            publicClient.readContract({
+                address: vaultAddress,
+                abi: VAULT_ABI,
+                functionName: 'totalSupply'
+            }),
+            publicClient.readContract({
+                address: vaultAddress,
+                abi: VAULT_ABI,
+                functionName: 'token0'
+            }),
+            publicClient.readContract({
+                address: vaultAddress,
+                abi: VAULT_ABI,
+                functionName: 'token1'
+            })
+        ]);
+        const [token0Balance, token1Balance] = await Promise.all([
+            publicClient.readContract({
+                address: token0Address,
+                abi: [
+                    {
+                        type: 'function',
+                        name: 'balanceOf',
+                        inputs: [{ name: 'account', type: 'address', internalType: 'address' }],
+                        outputs: [{ name: '', type: 'uint256', internalType: 'uint256' }],
+                        stateMutability: 'view'
+                    }
+                ],
+                functionName: 'balanceOf',
+                args: [vaultAddress]
+            }),
+            publicClient.readContract({
+                address: token1Address,
+                abi: [
+                    {
+                        type: 'function',
+                        name: 'balanceOf',
+                        inputs: [{ name: 'account', type: 'address', internalType: 'address' }],
+                        outputs: [{ name: '', type: 'uint256', internalType: 'uint256' }],
+                        stateMutability: 'view'
+                    }
+                ],
+                functionName: 'balanceOf',
+                args: [vaultAddress]
+            })
+        ]);
+        return {
+            data: {
+                token0Balance,
+                token1Balance,
+                totalSupply
+            },
+            status: 200,
+            success: true
+        };
+    }
+    catch (error) {
+        return {
+            data: null,
+            status: 500,
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to get vault reserves'
+        };
+    }
+}
+//# sourceMappingURL=estimateLpTokens.js.map