@galaxy-kj/core-stellar-sdk 2.0.0

package/dist/liquidity-pools/helpers.js

@@ -0,0 +1,219 @@
+/**
+ * @fileoverview Helper functions for liquidity pool operations
+ * @description Utility functions for common liquidity pool patterns
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-01-22
+ */
+import BigNumber from 'bignumber.js';
+import { calculateMinimumAmounts } from './calculations';
+/**
+ * Calculates optimal deposit amounts maintaining pool ratio
+ * @param maxAmountA - Maximum amount of asset A user wants to deposit
+ * @param maxAmountB - Maximum amount of asset B user wants to deposit
+ * @param pool - Current pool state
+ * @param slippage - Slippage tolerance (default: 0.01 for 1%)
+ * @returns Optimal deposit amounts
+ */
+export function calculateOptimalDeposit(maxAmountA, maxAmountB, pool, slippage = '0.01') {
+    const maxA = new BigNumber(maxAmountA);
+    const maxB = new BigNumber(maxAmountB);
+    const reserveA = new BigNumber(pool.reserveA);
+    const reserveB = new BigNumber(pool.reserveB);
+    // Calculate pool ratio
+    const poolRatio = reserveB.dividedBy(reserveA);
+    // Calculate how much B is needed for maxA
+    const neededB = maxA.multipliedBy(poolRatio);
+    // Calculate how much A is needed for maxB
+    const neededA = maxB.dividedBy(poolRatio);
+    let optimalA;
+    let optimalB;
+    // Use the constraining amount
+    if (neededB.isLessThanOrEqualTo(maxB)) {
+        // A is the limiting factor
+        optimalA = maxA.toFixed(7);
+        optimalB = neededB.toFixed(7);
+    }
+    else {
+        // B is the limiting factor
+        optimalA = neededA.toFixed(7);
+        optimalB = maxB.toFixed(7);
+    }
+    // Calculate minimum amounts with slippage protection
+    const { minAmountA, minAmountB } = calculateMinimumAmounts(optimalA, optimalB, slippage);
+    return {
+        amountA: optimalA,
+        amountB: optimalB,
+        minAmountA,
+        minAmountB,
+    };
+}
+/**
+ * Formats pool assets as a readable string
+ * @param pool - Liquidity pool
+ * @returns Formatted string "ASSET_A/ASSET_B"
+ */
+export function formatPoolAssets(pool) {
+    const assetACode = pool.assetA.isNative() ? 'XLM' : pool.assetA.getCode();
+    const assetBCode = pool.assetB.isNative() ? 'XLM' : pool.assetB.getCode();
+    return `${assetACode}/${assetBCode}`;
+}
+/**
+ * Calculates the value of user's shares in the pool
+ * @param shares - User's share amount
+ * @param pool - Pool state
+ * @returns Value in terms of each asset
+ */
+export function calculateShareValue(shares, pool) {
+    const userShares = new BigNumber(shares);
+    const totalShares = new BigNumber(pool.totalShares);
+    if (totalShares.isZero()) {
+        return { valueA: '0', valueB: '0' };
+    }
+    const shareRatio = userShares.dividedBy(totalShares);
+    const valueA = shareRatio.multipliedBy(pool.reserveA).toFixed(7);
+    const valueB = shareRatio.multipliedBy(pool.reserveB).toFixed(7);
+    return { valueA, valueB };
+}
+/**
+ * Checks if a deposit would significantly impact pool price
+ * @param amountA - Amount of asset A to deposit
+ * @param amountB - Amount of asset B to deposit
+ * @param pool - Current pool state
+ * @param threshold - Price impact threshold (default: 0.01 for 1%)
+ * @returns True if price impact exceeds threshold
+ */
+export function wouldImpactPrice(amountA, amountB, pool, threshold = '0.01') {
+    const depositA = new BigNumber(amountA);
+    const depositB = new BigNumber(amountB);
+    const reserveA = new BigNumber(pool.reserveA);
+    const reserveB = new BigNumber(pool.reserveB);
+    // Calculate current ratio
+    const currentRatio = reserveB.dividedBy(reserveA);
+    // Calculate new ratio after deposit
+    const newReserveA = reserveA.plus(depositA);
+    const newReserveB = reserveB.plus(depositB);
+    const newRatio = newReserveB.dividedBy(newReserveA);
+    // Calculate price change
+    const priceChange = newRatio.minus(currentRatio).abs().dividedBy(currentRatio);
+    return priceChange.isGreaterThan(threshold);
+}
+/**
+ * Calculates the break-even price for a liquidity position
+ * Useful for understanding when to exit a position
+ * @param initialAmountA - Initial deposit of asset A
+ * @param initialAmountB - Initial deposit of asset B
+ * @param currentReserveA - Current pool reserve A
+ * @param currentReserveB - Current pool reserve B
+ * @returns Break-even price ratio
+ */
+export function calculateBreakEvenPrice(initialAmountA, initialAmountB, currentReserveA, currentReserveB) {
+    const initA = new BigNumber(initialAmountA);
+    const initB = new BigNumber(initialAmountB);
+    // Initial average price
+    const initialPrice = initB.dividedBy(initA);
+    return initialPrice.toFixed(7);
+}
+/**
+ * Estimates impermanent loss for a liquidity position
+ * @param initialPrice - Price when position was opened
+ * @param currentPrice - Current price
+ * @returns Impermanent loss as percentage
+ */
+export function calculateImpermanentLoss(initialPrice, currentPrice) {
+    const p0 = new BigNumber(initialPrice);
+    const p1 = new BigNumber(currentPrice);
+    // IL formula: 2 * sqrt(priceRatio) / (1 + priceRatio) - 1
+    const priceRatio = p1.dividedBy(p0);
+    const sqrtRatio = priceRatio.sqrt();
+    const il = new BigNumber(2)
+        .multipliedBy(sqrtRatio)
+        .dividedBy(new BigNumber(1).plus(priceRatio))
+        .minus(1)
+        .abs();
+    return il.multipliedBy(100).toFixed(2);
+}
+/**
+ * Checks if pool has sufficient liquidity for an operation
+ * @param requiredAmountA - Required amount of asset A
+ * @param requiredAmountB - Required amount of asset B
+ * @param pool - Pool state
+ * @param safetyMargin - Safety margin as percentage (default: 0.01 for 1%)
+ * @returns True if pool has sufficient liquidity
+ */
+export function hasSufficientLiquidity(requiredAmountA, requiredAmountB, pool, safetyMargin = '0.01') {
+    const reqA = new BigNumber(requiredAmountA);
+    const reqB = new BigNumber(requiredAmountB);
+    const resA = new BigNumber(pool.reserveA);
+    const resB = new BigNumber(pool.reserveB);
+    // Apply safety margin
+    const margin = new BigNumber(1).minus(safetyMargin);
+    const availableA = resA.multipliedBy(margin);
+    const availableB = resB.multipliedBy(margin);
+    return reqA.isLessThanOrEqualTo(availableA) && reqB.isLessThanOrEqualTo(availableB);
+}
+/**
+ * Calculates annual percentage rate (APR) from fees
+ * @param dailyFees - Daily fees earned
+ * @param totalLiquidity - Total liquidity in pool
+ * @returns APR as percentage
+ */
+export function calculateAPRFromFees(dailyFees, totalLiquidity) {
+    const fees = new BigNumber(dailyFees);
+    const liquidity = new BigNumber(totalLiquidity);
+    if (liquidity.isZero()) {
+        return '0.00';
+    }
+    // APR = (dailyFees / totalLiquidity) * 365 * 100
+    const apr = fees.dividedBy(liquidity).multipliedBy(365).multipliedBy(100);
+    return apr.toFixed(2);
+}
+/**
+ * Formats an amount to Stellar's 7 decimal precision
+ * @param amount - Amount to format
+ * @returns Formatted amount
+ */
+export function toStellarPrecision(amount) {
+    return new BigNumber(amount).toFixed(7, BigNumber.ROUND_DOWN);
+}
+/**
+ * Checks if two assets match (useful for finding pools)
+ * @param asset1 - First asset
+ * @param asset2 - Second asset
+ * @returns True if assets are the same
+ */
+export function assetsEqual(asset1, asset2) {
+    if (asset1.isNative() && asset2.isNative()) {
+        return true;
+    }
+    if (asset1.isNative() || asset2.isNative()) {
+        return false;
+    }
+    return (asset1.getCode() === asset2.getCode() &&
+        asset1.getIssuer() === asset2.getIssuer());
+}
+/**
+ * Sorts two assets lexicographically (required for pool ID generation)
+ * @param assetA - First asset
+ * @param assetB - Second asset
+ * @returns Sorted assets [first, second]
+ */
+export function sortAssets(assetA, assetB) {
+    const codeA = assetA.isNative() ? 'XLM' : assetA.getCode();
+    const codeB = assetB.isNative() ? 'XLM' : assetB.getCode();
+    // Sort by code first
+    if (codeA < codeB) {
+        return [assetA, assetB];
+    }
+    else if (codeA > codeB) {
+        return [assetB, assetA];
+    }
+    // If codes are the same, sort by issuer
+    if (!assetA.isNative() && !assetB.isNative()) {
+        const issuerA = assetA.getIssuer();
+        const issuerB = assetB.getIssuer();
+        return issuerA < issuerB ? [assetA, assetB] : [assetB, assetA];
+    }
+    return [assetA, assetB];
+}
+//# sourceMappingURL=helpers.js.map

package/dist/liquidity-pools/helpers.js.map

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

package/dist/liquidity-pools/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Liquidity Pools module exports
+ * @description Public API exports for liquidity pool operations
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-01-22
+ */
+export type { LiquidityPool, LiquidityPoolDeposit, LiquidityPoolWithdraw, QueryPoolsParams, LiquidityPoolResult, PoolAnalytics, PriceImpact, DepositEstimate, WithdrawEstimate, PoolShare, PoolTrade, } from './types';
+export { LiquidityPoolManager } from './liquidity-pool-manager';
+export { calculateConstantProduct, calculateSpotPrice, calculateDepositShares, calculateWithdrawAmounts, calculatePriceImpact, calculateSwapOutput, estimateDeposit, estimateWithdraw, calculateMinimumAmounts, calculatePriceBounds, } from './calculations';
+export { validatePoolId, validateAmount, validateSlippage, validatePrice, validatePublicKey, validateDepositParams, validateWithdrawParams, validateSufficientShares, validateMinimumLiquidity, } from './validation';
+export { calculateOptimalDeposit, formatPoolAssets, calculateShareValue, wouldImpactPrice, calculateBreakEvenPrice, calculateImpermanentLoss, hasSufficientLiquidity, calculateAPRFromFees, toStellarPrecision, assetsEqual, sortAssets, } from './helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/liquidity-pools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/liquidity-pools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,UAAU,GACX,MAAM,WAAW,CAAC"}

package/dist/liquidity-pools/index.js

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Liquidity Pools module exports
+ * @description Public API exports for liquidity pool operations
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-01-22
+ */
+// Export manager
+export { LiquidityPoolManager } from './liquidity-pool-manager';
+// Export calculation functions
+export { calculateConstantProduct, calculateSpotPrice, calculateDepositShares, calculateWithdrawAmounts, calculatePriceImpact, calculateSwapOutput, estimateDeposit, estimateWithdraw, calculateMinimumAmounts, calculatePriceBounds, } from './calculations';
+// Export validation functions
+export { validatePoolId, validateAmount, validateSlippage, validatePrice, validatePublicKey, validateDepositParams, validateWithdrawParams, validateSufficientShares, validateMinimumLiquidity, } from './validation';
+// Export helper functions
+export { calculateOptimalDeposit, formatPoolAssets, calculateShareValue, wouldImpactPrice, calculateBreakEvenPrice, calculateImpermanentLoss, hasSufficientLiquidity, calculateAPRFromFees, toStellarPrecision, assetsEqual, sortAssets, } from './helpers';
+// Note: Pool IDs are generated by the Stellar network and retrieved via Horizon API.
+// Use LiquidityPoolManager.queryPools() or getPoolsForAssets() to find pools for specific assets.
+//# sourceMappingURL=index.js.map

package/dist/liquidity-pools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/liquidity-pools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,+BAA+B;AAC/B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,8BAA8B;AAC9B,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,0BAA0B;AAC1B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,qFAAqF;AACrF,kGAAkG"}

package/dist/liquidity-pools/liquidity-pool-manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview Liquidity Pool Manager
+ * @description Manages liquidity pool operations on Stellar network
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-01-22
+ */
+import { Asset, Horizon } from '@stellar/stellar-sdk';
+import { LiquidityPool, LiquidityPoolDeposit, LiquidityPoolWithdraw, LiquidityPoolResult, QueryPoolsParams, PoolAnalytics, DepositEstimate, WithdrawEstimate, PoolShare } from './types';
+import { Wallet } from '../types/stellar-types';
+/**
+ * Liquidity Pool Manager class
+ * @class LiquidityPoolManager
+ * @description Handles all liquidity pool operations
+ */
+export declare class LiquidityPoolManager {
+    private server;
+    private networkPassphrase;
+    constructor(server: Horizon.Server, networkPassphrase: string);
+    /**
+     * Deposits liquidity to a pool
+     * @param wallet - Source wallet
+     * @param params - Deposit parameters
+     * @param password - Wallet password for decryption
+     * @returns Promise<LiquidityPoolResult>
+     * @throws {Error} If validation fails or transaction fails
+     */
+    depositLiquidity(wallet: Wallet, params: LiquidityPoolDeposit, password: string): Promise<LiquidityPoolResult>;
+    /**
+     * Withdraws liquidity from a pool
+     * @param wallet - Source wallet
+     * @param params - Withdrawal parameters
+     * @param password - Wallet password for decryption
+     * @returns Promise<LiquidityPoolResult>
+     * @throws {Error} If validation fails or transaction fails
+     */
+    withdrawLiquidity(wallet: Wallet, params: LiquidityPoolWithdraw, password: string): Promise<LiquidityPoolResult>;
+    /**
+     * Gets liquidity pool details by ID
+     * @param poolId - Pool ID
+     * @returns Promise<LiquidityPool>
+     * @throws {Error} If pool not found or fetch fails
+     */
+    getPoolDetails(poolId: string): Promise<LiquidityPool>;
+    /**
+     * Queries liquidity pools
+     * @param params - Query parameters
+     * @returns Promise<LiquidityPool[]>
+     */
+    queryPools(params?: QueryPoolsParams): Promise<LiquidityPool[]>;
+    /**
+     * Gets user's share balance for a specific pool
+     * @param publicKey - User's public key
+     * @param poolId - Pool ID
+     * @returns Promise<string> - Share balance
+     */
+    getUserShares(publicKey: string, poolId: string): Promise<string>;
+    /**
+     * Gets all pool shares for a user
+     * @param publicKey - User's public key
+     * @returns Promise<PoolShare[]>
+     */
+    getUserPoolShares(publicKey: string): Promise<PoolShare[]>;
+    /**
+     * Gets pool analytics with on-chain data (TVL and share price)
+     * Note: volume24h, fees24h, and apy require historical data from external analytics services
+     * @param poolId - Pool ID
+     * @returns Promise<PoolAnalytics>
+     */
+    getPoolAnalytics(poolId: string): Promise<PoolAnalytics>;
+    /**
+     * Estimates deposit operation
+     * @param poolId - Pool ID
+     * @param amountA - Amount of asset A
+     * @param amountB - Amount of asset B
+     * @returns Promise<DepositEstimate>
+     */
+    estimatePoolDeposit(poolId: string, amountA: string, amountB: string): Promise<DepositEstimate>;
+    /**
+     * Estimates withdrawal operation
+     * @param poolId - Pool ID
+     * @param shares - Shares to withdraw
+     * @returns Promise<WithdrawEstimate>
+     */
+    estimatePoolWithdraw(poolId: string, shares: string): Promise<WithdrawEstimate>;
+    /**
+     * Gets liquidity pools for specific assets
+     * @param assetA - First asset
+     * @param assetB - Second asset
+     * @param limit - Number of results to return
+     * @returns Promise<LiquidityPool[]>
+     */
+    getPoolsForAssets(assetA: Asset, assetB: Asset, limit?: number): Promise<LiquidityPool[]>;
+    /**
+     * Maps Horizon API pool to our LiquidityPool type
+     * @param horizonPool - Horizon API pool
+     * @returns LiquidityPool
+     */
+    private mapHorizonPoolToLiquidityPool;
+    /**
+     * Estimates transaction fee
+     * @returns Promise<string>
+     */
+    private estimateFee;
+}
+//# sourceMappingURL=liquidity-pool-manager.d.ts.map

package/dist/liquidity-pools/liquidity-pool-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidity-pool-manager.d.ts","sourceRoot":"","sources":["../../src/liquidity-pools/liquidity-pool-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,EAGL,OAAO,EAGR,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,SAAS,EACV,MAAM,SAAS,CAAC;AAajB,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM;IAK7D;;;;;;;OAOG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC;IA4E/B;;;;;;;OAOG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC;IAyE/B;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB5D;;;;OAIG;IACG,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAkCzE;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBvE;;;;OAIG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA4ChE;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA+B9D;;;;;;OAMG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC;IAa3B;;;;;OAKG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAa5B;;;;;;OAMG;IACG,iBAAiB,CACrB,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,KAAK,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC;IAO3B;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAsCrC;;;OAGG;YACW,WAAW;CAQ1B"}