@gala-chain/launchpad-sdk 3.26.0 → 3.27.0

package/dist/services/GSwapService.d.ts

@@ -9,7 +9,7 @@
  * - Real-time transaction monitoring
  */
 import { WebSocketService } from './WebSocketService';
-import type { SwapQuoteParams, SwapQuoteResult, ExecuteSwapParams, ExecuteSwapResult, UserAsset, PoolInfo, GSwapServiceConfig } from '../types/gswap.dto';
+import type { SwapQuoteParams, SwapQuoteResult, ExecuteSwapParams, ExecuteSwapResult, UserAsset, PoolInfo, GSwapServiceConfig, GSwapPosition } from '../types/gswap.dto';
 export declare class GSwapService {
     private gswap;
     private tokenConverter;
@@ -52,14 +52,14 @@ export declare class GSwapService {
      * @param ownerAddress User's wallet address
      * @param limit Maximum number of positions to return (default 100)
      * @param bookmark Pagination bookmark
-     * @returns Array of liquidity positions
+     * @returns Array of liquidity positions with full type safety
      */
-    getUserLiquidityPositions(ownerAddress: string, limit?: number, bookmark?: string): Promise<any[]>;
+    getUserLiquidityPositions(ownerAddress: string, limit?: number, bookmark?: string): Promise<GSwapPosition[]>;
     /**
      * Get a specific liquidity position
      * @param ownerAddress User's wallet address
      * @param position Position details (token0, token1, fee, tickLower, tickUpper)
-     * @returns Detailed position information
+     * @returns Detailed position information with full type safety
      */
     getLiquidityPosition(ownerAddress: string, position: {
         token0: string;
@@ -67,14 +67,14 @@ export declare class GSwapService {
         fee: number;
         tickLower: number;
         tickUpper: number;
-    }): Promise<any>;
+    }): Promise<GSwapPosition>;
     /**
      * Get a liquidity position by its ID
      * @param ownerAddress User's wallet address
      * @param positionId Position UUID
-     * @returns Detailed position information
+     * @returns Detailed position information with full type safety
      */
-    getLiquidityPositionById(ownerAddress: string, positionId: string): Promise<any>;
+    getLiquidityPositionById(ownerAddress: string, positionId: string): Promise<GSwapPosition>;
     /**
      * Estimate tokens received from removing liquidity
      * @param args Removal estimation parameters
@@ -147,6 +147,65 @@ export declare class GSwapService {
         tickLower: number;
         tickUpper: number;
     }): Promise<any>;
+    /**
+     * Get real-time pool state with liquidity depth and current price
+     * @param tokenA First token symbol (e.g., 'GALA')
+     * @param tokenB Second token symbol (e.g., 'GUSDC')
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @returns Pool data with liquidity, current tick, and price
+     */
+    getPoolData(tokenA: string, tokenB: string, feeTier: number): Promise<any>;
+    /**
+     * Calculate current market price for a token pair from DEX pool
+     * @param tokenA First token symbol
+     * @param tokenB Second token symbol
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @returns Current spot price without executing trade
+     */
+    calculateDexPoolSpotPrice(tokenA: string, tokenB: string, feeTier: number): Promise<any>;
+    /**
+     * Calculate optimal token amounts for concentrated liquidity position
+     * @param tokenA First token symbol
+     * @param tokenB Second token symbol
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @param desiredAmount0 Desired amount of token A
+     * @param desiredAmount1 Desired amount of token B
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @returns Optimal amounts and utilization percentages
+     */
+    calculateOptimalPositionSize(tokenA: string, tokenB: string, feeTier: number, desiredAmount0: string, desiredAmount1: string, tickLower: number, tickUpper: number): Promise<any>;
+    /**
+     * Validate liquidity position parameters before creation
+     * @param tokenA First token symbol
+     * @param tokenB Second token symbol
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @param amount0 Token A amount
+     * @param amount1 Token B amount
+     * @returns Validation result with errors and warnings
+     */
+    validatePositionParameters(tokenA: string, tokenB: string, feeTier: number, tickLower: number, tickUpper: number, amount0: string, amount1: string): Promise<any>;
+    /**
+     * Convert human-readable price range to tick boundaries
+     * @param tokenA First token symbol
+     * @param tokenB Second token symbol
+     * @param minPrice Minimum price boundary
+     * @param maxPrice Maximum price boundary
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @returns Calculated tick boundaries and price deviations
+     */
+    calculateTicksForPrice(tokenA: string, tokenB: string, minPrice: string, maxPrice: string, feeTier: number): Promise<any>;
+    /**
+     * Convert tick boundaries back to human-readable prices
+     * @param tokenA First token symbol
+     * @param tokenB Second token symbol
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @returns Price range and current price
+     */
+    calculatePriceForTicks(tokenA: string, tokenB: string, tickLower: number, tickUpper: number): Promise<any>;
     /**
      * Calculate price impact percentage
      */
@@ -155,5 +214,40 @@ export declare class GSwapService {
      * Calculate execution price (output per unit input)
      */
     private calculateExecutionPrice;
+    /**
+     * Get tick spacing for a given fee tier (Uniswap v3 standard)
+     * @private
+     */
+    private getTickSpacing;
+    /**
+     * Calculate price from sqrtPriceX96 format (Uniswap v3 standard)
+     * price = (sqrtPriceX96 / 2^96)^2
+     * @private
+     */
+    private calculatePriceFromSqrtPriceX96;
+    /**
+     * Calculate liquidity from amount0 (Uniswap v3 math)
+     * liquidity = amount0 * (sqrtRatioA * sqrtRatioB) / (sqrtRatioB - sqrtRatioA)
+     * @private
+     */
+    private calculateLiquidityFromAmount0;
+    /**
+     * Calculate liquidity from amount1 (Uniswap v3 math)
+     * liquidity = amount1 / (sqrtRatioB - sqrtRatioA)
+     * @private
+     */
+    private calculateLiquidityFromAmount1;
+    /**
+     * Calculate amount0 from liquidity (Uniswap v3 math)
+     * amount0 = liquidity * (sqrtRatioCurrent - sqrtRatioA) / (sqrtRatioA * sqrtRatioCurrent)
+     * @private
+     */
+    private calculateAmount0FromLiquidity;
+    /**
+     * Calculate amount1 from liquidity (Uniswap v3 math)
+     * amount1 = liquidity * (sqrtRatioB - sqrtRatioCurrent)
+     * @private
+     */
+    private calculateAmount1FromLiquidity;
 }
 //# sourceMappingURL=GSwapService.d.ts.map

package/dist/services/GSwapService.d.ts.map

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

package/dist/types/gswap.dto.d.ts

@@ -156,6 +156,12 @@ export interface LiquidityPosition {
     createdAt: Date;
     updatedAt: Date;
 }
+/**
+ * GSwap position - Type-safe liquidity position from GalaSwap API
+ * @agent Represents liquidity provider position with full type safety
+ * @alias LiquidityPosition - Provides type-safe return type for GSwapService methods
+ */
+export type GSwapPosition = LiquidityPosition;
 /**
  * Parameters for adding liquidity by price range
  * @agent User-friendly LP creation using min/max prices. Recommended for most users. SDK calculates tick boundaries automatically
@@ -224,4 +230,94 @@ export interface EstimateRemoveLiquidityResult {
     token1Symbol: string;
     currentPrice: string;
 }
+/**
+ * Real-time pool state data
+ * @agent Provides liquidity depth and current price for pre-trade analysis
+ */
+export interface PoolData {
+    tokenA: string;
+    tokenB: string;
+    feeTier: number;
+    liquidity: string;
+    sqrtPriceX96: string;
+    tick: number;
+    feeGrowthGlobal0X128: string;
+    feeGrowthGlobal1X128: string;
+    currentPrice: string;
+}
+/**
+ * Spot price calculation result
+ * @agent Current market price without executing trade
+ */
+export interface SpotPriceResult {
+    tokenA: string;
+    tokenB: string;
+    feeTier: number;
+    price: string;
+    invertedPrice: string;
+    tick: number;
+    liquidity: string;
+}
+/**
+ * Optimal position size calculation
+ * @agent Calculates optimal token amounts for concentrated liquidity
+ */
+export interface OptimalPositionResult {
+    amount0: string;
+    amount1: string;
+    liquidity: string;
+    ratio: string;
+    utilizationPercent: {
+        amount0: string;
+        amount1: string;
+    };
+}
+/**
+ * Position parameter validation result
+ * @agent Pre-flight validation for liquidity operations
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    gasEstimate: number;
+    tickSpacing?: number;
+    currentTick?: number;
+    poolLiquidity?: string;
+}
+/**
+ * Tick calculation from price range
+ * @agent Converts human-readable prices to tick boundaries
+ */
+export interface TickCalculationResult {
+    tokenA: string;
+    tokenB: string;
+    feeTier: number;
+    tickLower: number;
+    tickUpper: number;
+    tickSpacing: number;
+    requestedMinPrice: string;
+    requestedMaxPrice: string;
+    actualMinPrice: string;
+    actualMaxPrice: string;
+    priceDeviation: {
+        minPriceDeviation: string;
+        maxPriceDeviation: string;
+    };
+}
+/**
+ * Price calculation from tick boundaries
+ * @agent Converts tick boundaries back to prices
+ */
+export interface PriceFromTicksResult {
+    tokenA: string;
+    tokenB: string;
+    tickLower: number;
+    tickUpper: number;
+    minPrice: string;
+    maxPrice: string;
+    currentPrice?: string;
+    priceRange: string;
+    tickSpread: number;
+}
 //# sourceMappingURL=gswap.dto.d.ts.map

package/dist/types/gswap.dto.d.ts.map

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

package/dist/types/options.dto.d.ts

@@ -225,14 +225,14 @@ export interface FetchLaunchpadTokenSpotPriceOptions {
  *
  * @example Token by name (launchpad token)
  * ```typescript
- * const price = await sdk.fetchTokenSpotPrice({
+ * const price = await sdk.fetchTokenPrice({
  *   tokenName: 'galadog'  // Auto-detects graduation
  * });
  * ```
  *
  * @example Token by ID (graduated or native DEX token)
  * ```typescript
- * const price = await sdk.fetchTokenSpotPrice({
+ * const price = await sdk.fetchTokenPrice({
  *   tokenId: 'Token|Unit|GDOG|eth:902Ef7566c8A8bEe5517FdEC0D7b5d1157942830'
  * });
  * ```

package/dist/utils/agent-config.d.ts

@@ -139,7 +139,7 @@ export declare class AgentConfig {
      *
      * // Fetch data - these work fine
      * const pools = await sdk.fetchPools();
-     * const price = await sdk.fetchTokenSpotPrice('anime');
+     * const price = await sdk.fetchTokenPrice('anime');
      *
      * // This will throw - wallet required for signing
      * try {
@@ -160,7 +160,7 @@ export declare class AgentConfig {
      *
      * // Continuous monitoring loop
      * while (true) {
-     *   const prices = await sdk.fetchTokenSpotPrice('mytoken');
+     *   const prices = await sdk.fetchTokenPrice('mytoken');
      *   console.log('Current price:', prices.price);
      *   await new Promise(resolve => setTimeout(resolve, 5000));
      * }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "3.26.0",
-  "description": "TypeScript SDK for Gala Launchpad Backend API - 64 methods supporting optional wallet (read-only and full-access modes). Production-ready DeFi token launchpad integration with AgentConfig setup, GalaChain trading, GSwap DEX integration, price history, token creation, and comprehensive user operations. Multi-format output (ESM, CJS, UMD).",
+  "version": "3.27.0",
+  "description": "TypeScript SDK for Gala Launchpad Backend API - 56 methods supporting optional wallet (read-only and full-access modes). Production-ready DeFi token launchpad integration with AgentConfig setup, GalaChain trading, GSwap DEX integration, advanced pool analytics, price history, token creation, and comprehensive user operations. Multi-format output (ESM, CJS, UMD). v3.24.0: Concentrated liquidity position analysis and optimization.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
@@ -42,9 +42,11 @@
     "demo:read-only": "tsx examples/read-only-operations.ts",
     "demo:authenticated": "tsx examples/authenticated-operations.ts",
     "demo:privatekey-override": "tsx examples/privatekey-override-pattern.ts",
-    "demo-trades": "tsx examples/demo-trades.ts",
-    "demo-cache": "tsx examples/demo-cache.ts",
-    "demo-fetch-all-pools": "tsx examples/demo-fetch-all-pools.ts",
+    "demo:trades": "tsx examples/demo-trades.ts",
+    "demo:liquidity": "tsx examples/demo-liquidity-positions.ts",
+    "demo:liquidity:detailed": "tsx examples/demo-liquidity-detailed.ts",
+    "demo:cache": "tsx examples/demo-cache.ts",
+    "demo:fetch-all-pools": "tsx examples/demo-fetch-all-pools.ts",
     "lint": "eslint src tests scripts --ext .ts,.tsx --fix",
     "lint:check": "eslint src tests scripts --ext .ts,.tsx",
     "typecheck": "tsc --noEmit",
@@ -106,7 +108,12 @@
     "agent-sdk",
     "model-context-protocol",
     "dex-trading",
-    "token-graduation"
+    "token-graduation",
+    "concentrated-liquidity",
+    "uniswap-v3",
+    "pool-analytics",
+    "position-optimization",
+    "tick-management"
   ],
   "author": {
     "name": "Gala Launchpad Team",