@steerprotocol/sdk 1.19.14 → 1.19.16

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

@@ -0,0 +1,350 @@
+import { abis } from '../../../const/deployments/abis';
+import { getContractAddressByChainIdAndContractName } from '../../../const/network';
+// Use the vault ABI for reading vault state
+const VAULT_ABI = 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);
+ * }
+ * ```
+ */
+export 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 = 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
+ */
+export 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]
+ */
+export 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

package/dist/esm/base/vault/single-asset/estimateLpTokens.js.map

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

package/dist/esm/base/vault/single-asset/index.js

@@ -0,0 +1,83 @@
+// Export all types
+export * from './types';
+// Export individual functions for separate testing and usage
+export { calculateSwapAmount } from './calculateSwapAmount';
+export { calculateLimitPrice, getPoolSlot0 } from './calculateLimitPrice';
+export { simulateSwap, determineSwapDirection, validateSwapParams } from './simulateSwap';
+export { estimateLpTokens, getVaultReserves } from './estimateLpTokens';
+// Export the main client
+export { SingleAssetDepositClient } from './singleAssetDeposit';
+/**
+ * @fileoverview Single-Asset Deposit Module
+ *
+ * This module provides comprehensive functionality for single-asset deposits into liquidity vaults.
+ * The process allows users to deposit only one token (token0 or token1), while the contract
+ * internally performs a swap to balance the token pair before depositing into the vault.
+ *
+ * ## Architecture
+ *
+ * The single-asset deposit process is broken down into separate, testable functions:
+ *
+ * 1. **calculateSwapAmount** - Determines how much of the input token needs to be swapped
+ * 2. **calculateLimitPrice** - Calculates slippage protection limits for the internal swap
+ * 3. **simulateSwap** - Simulates the swap to preview expected output amounts
+ * 4. **estimateLpTokens** - Estimates the final LP tokens that will be received
+ * 5. **SingleAssetDepositClient** - Main orchestrator that combines all steps
+ *
+ * ## Supported AMM Types
+ *
+ * Currently supports:
+ * - UniswapV3 (fully implemented)
+ * - Algebra variants (planned for future implementation)
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import { SingleAssetDepositClient, AMMType } from '@steerprotocol/sdk';
+ * import { parseEther } from 'viem';
+ *
+ * // Initialize the client
+ * const client = new SingleAssetDepositClient(publicClient, walletClient);
+ *
+ * // Preview the deposit
+ * const preview = await client.previewDeposit({
+ *   assets: parseEther('100'),
+ *   receiver: userAddress,
+ *   vault: vaultAddress,
+ *   isToken0: true,
+ *   depositSlippagePercent: 5n,
+ *   swapSlippageBP: 500,
+ *   ammType: AMMType.UniswapV3,
+ *   singleAssetDepositContract: contractAddress
+ * }, poolAddress);
+ *
+ * if (preview.success) {
+ *   console.log('Expected LP tokens:', preview.data.lpEstimation.lpTokens);
+ *
+ *   // Execute the deposit
+ *   const result = await client.deposit(params);
+ *   if (result.success) {
+ *     console.log('Transaction hash:', result.data);
+ *   }
+ * }
+ * ```
+ *
+ * ## Testing Individual Functions
+ *
+ * Each function can be tested separately:
+ *
+ * ```typescript
+ * import { calculateSwapAmount, AMMType } from '@steerprotocol/sdk';
+ *
+ * // Test swap amount calculation
+ * const result = await calculateSwapAmount(publicClient, {
+ *   depositAmount: parseEther('100'),
+ *   isToken0: true,
+ *   vault: vaultAddress,
+ *   pool: poolAddress,
+ *   ammType: AMMType.UniswapV3,
+ *   singleAssetDepositContract: contractAddress
+ * });
+ * ```
+ */ 
+//# sourceMappingURL=index.js.map

package/dist/esm/base/vault/single-asset/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/vault/single-asset/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,6DAA6D;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExE,yBAAyB;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG"}