@gala-chain/launchpad-sdk 4.0.0 → 4.0.1-beta.2

package/dist/src/services/DexService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DexService.d.ts","sourceRoot":"","sources":["../../../src/services/DexService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,SAAS,EAET,iBAAiB,EAGjB,0BAA0B,EAE3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAUjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IALpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,cAAc,CAAC,EAAE,UAAU,YAAA,EAC3B,KAAK,CAAC,EAAE,kBAAkB,YAAA,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,YAAA,EACpD,SAAS,GAAE,OAAe;IAQ5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,eAAe,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAkCjF;;;;;;;;;;;OAWG;YACW,uBAAuB;IAwGrC;;;;;;;OAOG;IACG,4BAA4B,CAChC,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,uBAAuB,CAAC,EAE5F,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,GACrD,OAAO,CAAC,cAAc,CAAC;IA2E1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACG,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkDzE;;;;;;;;;;;;;OAaG;IACG,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAmChD;;;;;;;;;;;;;OAaG;IACG,qBAAqB,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAkBxD;;;;;;;;;;;;;;;OAeG;IACG,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwDjF;;;;;;;;;;;;;OAaG;IACG,0BAA0B,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAWrE;;;;;;;;;OASG;IACG,+BAA+B,IAAI,OAAO,CAAC,0BAA0B,CAAC;CA+B7E"}

package/dist/src/services/FaucetService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FaucetService.d.ts","sourceRoot":"","sources":["../../../src/services/FaucetService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,mBAAmB,EAIpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAChC,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;OAeG;IACG,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB/D;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;CAiBpC"}

package/dist/{services → src/services}/GSwapService.d.ts

@@ -2,6 +2,7 @@ import { LoggerBase } from './BaseService';
 import { WebSocketService } from './WebSocketService';
 import { DexQuoteService } from './DexQuoteService';
 import type { SwapQuoteParams, SwapQuoteResult, ExecuteSwapParams, ExecuteSwapResult, UserAsset, PoolInfo, GSwapServiceConfig, GSwapPosition, PoolSlot0Data, PoolPriceData, GetLiquidityPositionsOptions, GetLiquidityPositionsResult } from '../types/gswap.dto';
+import type { GSwapEstimateRemoveLiquidityResult, GSwapAddLiquidityResult } from '../types/gswap-responses.types';
 import type { TokenClassKey } from '../types/common';
 export declare class GSwapService extends LoggerBase {
     private gatewayClient;
@@ -135,9 +136,14 @@ export declare class GSwapService extends LoggerBase {
      * Get a liquidity position by its ID
      * @param ownerAddress User's wallet address
      * @param positionId Position UUID
+     * @param token0 Optional first token for compound key lookup (token0)
+     * @param token1 Optional second token for compound key lookup (token1)
+     * @param feeTier Optional fee tier for compound key lookup (500, 3000, or 10000)
+     * @param tickLower Optional lower tick boundary for compound key lookup
+     * @param tickUpper Optional upper tick boundary for compound key lookup
      * @returns Detailed position information with full type safety
      */
-    getLiquidityPositionById(ownerAddress: string, positionId: string): Promise<GSwapPosition>;
+    getLiquidityPositionById(ownerAddress: string, positionId: string, token0?: string | Record<string, unknown>, token1?: string | Record<string, unknown>, feeTier?: number, tickLower?: number, tickUpper?: number): Promise<GSwapPosition>;
     /**
      * Fetch a single liquidity position using ONLY the compound key (direct HTTP call)
      * Most efficient when you already have all position parameters
@@ -169,7 +175,7 @@ export declare class GSwapService extends LoggerBase {
         liquidity: string;
         tickLower: number;
         tickUpper: number;
-    }): Promise<any>;
+    }): Promise<GSwapEstimateRemoveLiquidityResult>;
     /**
      * Add liquidity using price ranges (user-friendly)
      * @param args Liquidity addition parameters with price ranges
@@ -185,7 +191,10 @@ export declare class GSwapService extends LoggerBase {
         amount1Desired: string;
         amount0Min?: string;
         amount1Min?: string;
-    }): Promise<any>;
+    }): Promise<GSwapAddLiquidityResult & {
+        timestamp?: Date;
+        wait?: (timeoutMs?: number) => Promise<void>;
+    }>;
     /**
      * Add liquidity to GSwap pool using precise tick ranges (concentrated liquidity)
      *
@@ -263,7 +272,10 @@ export declare class GSwapService extends LoggerBase {
         amount1Desired: string;
         amount0Min?: string;
         amount1Min?: string;
-    }): Promise<any>;
+    }): Promise<GSwapAddLiquidityResult & {
+        timestamp?: Date;
+        wait?: (timeoutMs?: number) => Promise<void>;
+    }>;
     /**
      * Monitor a bundler transaction with graceful fallback on timeout
      *
@@ -372,7 +384,7 @@ export declare class GSwapService extends LoggerBase {
         amount0Min?: string;
         amount1Min?: string;
         positionId?: string;
-    }): Promise<any>;
+    }): Promise<GSwapAddLiquidityResult>;
     /**
      * Collect accumulated trading fees from a concentrated liquidity position
      *
@@ -461,7 +473,7 @@ export declare class GSwapService extends LoggerBase {
         amount0Requested?: string;
         amount1Requested?: string;
         positionId?: string;
-    }): Promise<any>;
+    }): Promise<GSwapAddLiquidityResult>;
     /**
      * Get real-time pool state with liquidity depth and current price
      * @param tokenA First token symbol (e.g., 'GALA')
@@ -469,7 +481,17 @@ export declare class GSwapService extends LoggerBase {
      * @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>;
+    getPoolData(tokenA: string, tokenB: string, feeTier: number): Promise<{
+        tokenA: string;
+        tokenB: string;
+        feeTier: number;
+        liquidity: string;
+        sqrtPriceX96: string;
+        tick: number;
+        feeGrowthGlobal0X128: string;
+        feeGrowthGlobal1X128: string;
+        currentPrice: string;
+    }>;
     /**
      * Calculate current market price for a token pair from DEX pool
      * @param tokenA First token symbol
@@ -477,7 +499,15 @@ export declare class GSwapService extends LoggerBase {
      * @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>;
+    calculateDexPoolSpotPrice(tokenA: string, tokenB: string, feeTier: number): Promise<{
+        tokenA: string;
+        tokenB: string;
+        feeTier: number;
+        price: string;
+        invertedPrice: string;
+        tick: number;
+        liquidity: string;
+    }>;
     /**
      * Calculate optimal token amounts for concentrated liquidity position
      * @param tokenA First token symbol
@@ -489,7 +519,16 @@ export declare class GSwapService extends LoggerBase {
      * @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>;
+    calculateOptimalPositionSize(tokenA: string, tokenB: string, feeTier: number, desiredAmount0: string, desiredAmount1: string, tickLower: number, tickUpper: number): Promise<{
+        amount0: string;
+        amount1: string;
+        liquidity: string;
+        ratio: string;
+        utilizationPercent: {
+            amount0: string;
+            amount1: string;
+        };
+    }>;
     /**
      * Validate liquidity position parameters before creation
      * @param tokenA First token symbol
@@ -501,7 +540,15 @@ export declare class GSwapService extends LoggerBase {
      * @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>;
+    validatePositionParameters(tokenA: string, tokenB: string, feeTier: number, tickLower: number, tickUpper: number, amount0: string, amount1: string): Promise<{
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+        gasEstimate: number;
+        tickSpacing?: number;
+        currentTick?: number;
+        poolLiquidity?: string;
+    }>;
     /**
      * Convert human-readable price range to tick boundaries
      * @param tokenA First token symbol
@@ -511,7 +558,22 @@ export declare class GSwapService extends LoggerBase {
      * @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>;
+    calculateTicksForPrice(tokenA: string, tokenB: string, minPrice: string, maxPrice: string, feeTier: number): Promise<{
+        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;
+        };
+    }>;
     /**
      * Convert tick boundaries back to human-readable prices
      * @param tokenA First token symbol
@@ -520,7 +582,17 @@ export declare class GSwapService extends LoggerBase {
      * @param tickUpper Upper tick boundary
      * @returns Price range and current price
      */
-    calculatePriceForTicks(tokenA: string, tokenB: string, tickLower: number, tickUpper: number): Promise<any>;
+    calculatePriceForTicks(tokenA: string, tokenB: string, tickLower: number, tickUpper: number): Promise<{
+        tokenA: string;
+        tokenB: string;
+        tickLower: number;
+        tickUpper: number;
+        minPrice: string;
+        maxPrice: string;
+        currentPrice?: string;
+        priceRange?: string;
+        tickSpread?: number;
+    }>;
     /**
      * Calculate execution price (output per unit input)
      */

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

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

package/dist/{services → src/services}/GalaChainGatewayClient.d.ts

@@ -44,13 +44,22 @@ export declare class GalaChainGatewayClient {
     getPositions(request: GalaChainGetPositionsRequest): Promise<GalaChainGetPositionsResponse>;
     /**
      * Get position by ID from GalaChain Gateway
-     * Convenience method that queries positions and returns first match
+     * Supports both compound key lookup (preferred) and simple positionId lookup
      *
-     * @param positionId - Unique position identifier
+     * Compound key requires: owner + token0 + token1 + tickLower + tickUpper + fee
+     * PositionId approach uses just the position ID (fallback for compatibility)
+     *
+     * @param ownerOrPositionId - Position owner address OR position ID
+     * @param token0Optional - Token0 symbol or TokenClassKey (required for compound key lookup)
+     * @param token1Optional - Token1 symbol or TokenClassKey (required for compound key lookup)
+     * @param feeOptional - Fee tier (required for compound key lookup)
+     * @param tickLowerOptional - Lower tick boundary (required for compound key lookup)
+     * @param tickUpperOptional - Upper tick boundary (required for compound key lookup)
+     * @param positionIdOptional - Position ID (optional, included in request)
      * @returns Position data if found
      * @throws ApiError if position not found or request fails
      */
-    getPositionById(positionId: string): Promise<GalaChainResponse<any>>;
+    getPositionById(ownerOrPositionId: string, token0Optional?: string | Record<string, any>, token1Optional?: string | Record<string, any>, feeOptional?: number, tickLowerOptional?: number, tickUpperOptional?: number, positionIdOptional?: string): Promise<GalaChainResponse<any>>;
     /**
      * Get liquidity removal estimation from GalaChain Gateway
      * Endpoint: POST /api/asset/dexv3-contract/GetRemoveLiquidityEstimation

package/dist/src/services/GalaChainGatewayClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GalaChainGatewayClient.d.ts","sourceRoot":"","sources":["../../../src/services/GalaChainGatewayClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,4CAA4C,EAC5C,kCAAkC,EAInC,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,4BAA4B;IAOhD;;;;;;;OAOG;IACG,WAAW,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwCnF;;;;;;;;;;;;;OAaG;IACG,YAAY,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAoCjG;;;;;;;;;;;;;;;;OAgBG;IACG,eAAe,CACnB,iBAAiB,EAAE,MAAM,EAEzB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAE7C,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7C,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,iBAAiB,CAAC,EAAE,MAAM,EAC1B,kBAAkB,CAAC,EAAE,MAAM,GAE1B,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAyHlC;;;;;;;;;;OAUG;IACG,4BAA4B,CAChC,OAAO,EAAE,4CAA4C,GACpD,OAAO,CAAC,kCAAkC,CAAC;IA8B9C;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAkBpB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,CAAC,CAAC"}

package/dist/{services → src/services}/GalaChainService.d.ts

@@ -52,6 +52,7 @@ import { BaseService } from './BaseService';
 import { FetchPoolDetailsData, InternalFetchPoolDetailsResponse } from '../types/trade.dto';
 import { TokenBalanceResult } from '../types/user.dto';
 import { TransferGalaData, TransferTokenData } from '../types/transfer.dto';
+import { LockTokenData, UnlockTokenData } from '../types/lock.dto';
 import { TokenClassWithSupply } from '../types/launchpad.dto';
 /**
  * GalaChain Service for blockchain operations
@@ -194,10 +195,10 @@ export declare class GalaChainService extends BaseService {
      *
      * // Fetch wrapped token metadata
      * const gusdc = await galaChainService.fetchTokenClassFromChain({
-     *   collection: 'Token',
+     *   collection: 'GUSDC',
      *   category: 'Unit',
-     *   type: 'GUSDC',
-     *   additionalKey: 'eth:0x...'
+     *   type: 'none',
+     *   additionalKey: 'none'
      * });
      * console.log(`Symbol: ${gusdc.symbol}`); // "GUSDC"
      * ```
@@ -298,6 +299,66 @@ export declare class GalaChainService extends BaseService {
      * @throws {TransferError} When token name cannot be resolved
      */
     resolveTokenClassKey(tokenName: string): Promise<TokenClassKey>;
+    /**
+     * Lock tokens on GalaChain
+     *
+     * Locks a specified amount of tokens, preventing them from being transferred
+     * until unlocked by the lock authority. Useful for staking, escrow, vesting,
+     * or other hold scenarios.
+     *
+     * @param data - Lock parameters including token identification and amount
+     * @returns Promise<string> Transaction ID or success identifier
+     *
+     * @example
+     * ```typescript
+     * // Lock tokens with default settings (caller is lock authority)
+     * const txId = await galaChainService.lockToken({
+     *   tokenName: 'unicorn',
+     *   amount: '100'
+     * });
+     *
+     * // Lock tokens with expiration and custom lock authority
+     * const txId = await galaChainService.lockToken({
+     *   tokenId: 'Token$Unit$UNI$eth:0x...',
+     *   amount: '100',
+     *   lockAuthority: 'eth|0x1234...', // Another wallet can unlock
+     *   expires: Date.now() + 86400000, // Expires in 24 hours
+     *   name: 'staking-lock-v1'
+     * });
+     * ```
+     *
+     * @throws {TransferError} When validation fails or lock operation is rejected
+     */
+    lockToken(data: LockTokenData): Promise<string>;
+    /**
+     * Unlock previously locked tokens on GalaChain
+     *
+     * Releases locked tokens, making them available for transfer again.
+     * Must be signed by the lock authority (the address that created the lock
+     * or was designated as lock authority).
+     *
+     * @param data - Unlock parameters including token identification and amount
+     * @returns Promise<string> Transaction ID or success identifier
+     *
+     * @example
+     * ```typescript
+     * // Unlock tokens
+     * const txId = await galaChainService.unlockToken({
+     *   tokenName: 'unicorn',
+     *   amount: '50'
+     * });
+     *
+     * // Unlock tokens matching a specific lock name
+     * const txId = await galaChainService.unlockToken({
+     *   tokenId: 'Token$Unit$UNI$eth:0x...',
+     *   amount: '100',
+     *   name: 'staking-lock-v1' // Must match the name used during lock
+     * });
+     * ```
+     *
+     * @throws {TransferError} When validation fails or unlock operation is rejected
+     */
+    unlockToken(data: UnlockTokenData): Promise<string>;
     /**
      * Validate GALA transfer data
      */
@@ -306,6 +367,14 @@ export declare class GalaChainService extends BaseService {
      * Validate token transfer data
      */
     private validateTransferTokenData;
+    /**
+     * Validate lock token data
+     */
+    private validateLockTokenData;
+    /**
+     * Validate unlock token data
+     */
+    private validateUnlockTokenData;
     /**
      * Resolve token name to tokenInstance object for transfers
      * Uses TokenResolverService to get vault address, then parses it to extract tokenInstance components
@@ -329,7 +398,7 @@ export declare class GalaChainService extends BaseService {
      */
     private extractTransactionIdFromResponse;
     /**
-     * Handle transfer errors with proper typing and context
+     * Handle transfer/lock/unlock errors with proper typing and context
      */
     private handleTransferError;
 }

package/dist/src/services/GalaChainService.d.ts.map

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

package/dist/src/services/ImageService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageService.d.ts","sourceRoot":"","sources":["../../../src/services/ImageService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAIrE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACG,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC;CAiDnB"}

package/dist/src/services/LaunchpadService.d.ts.map

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

package/dist/src/services/MultiPoolStateManager.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Multi-Pool State Manager
+ *
+ * Core coordinator for real-time DEX swap monitoring with offline price prediction.
+ * Manages WebSocket events, pool caching, delta application, and offline quotes.
+ *
+ * Architecture:
+ * - WebSocket listener for global swap broadcasts
+ * - Event extraction and recursive payload walking
+ * - Tiered LRU pool cache (hot/warm/cold)
+ * - Delta-based pool updates (~15-25ms vs full refetch ~200-400ms)
+ * - Offline quote calculation (~25-50ms)
+ * - Event filtering (position-independent tokens, order-independent pairs)
+ * - Metrics collection and health monitoring
+ *
+ * Performance Target: <50ms P50 latency for arbitrage bot use case
+ *
+ * @packageDocumentation
+ */
+import type { Socket } from 'socket.io-client';
+import type { SwapEventCallback, SubscribeSwapOptions, SwapMonitorConfig, SwapMonitorHealth, CleanupFunction } from '../types/swap-monitor.dto';
+import type { CompositePoolDataResult } from '../types/composite-pool.dto';
+import { Logger } from '../utils/Logger';
+import type { DexQuoteService } from './DexQuoteService';
+/**
+ * Manages real-time DEX swap monitoring across multiple pools
+ *
+ * Coordinates event extraction, filtering, caching, delta application,
+ * and offline quote calculation for arbitrage bot use cases.
+ *
+ * @internal
+ */
+export declare class MultiPoolStateManager {
+    private socket;
+    private socketReady;
+    private readonly config;
+    private readonly logger;
+    private readonly metrics;
+    private readonly eventExtractor;
+    private readonly quoteService;
+    private readonly cacheManager;
+    private readonly eventQueue;
+    private seenTransactions;
+    private maxSeenTransactions;
+    private listeners;
+    private onErrorCallbacks;
+    private isActive;
+    private listenerRegistered;
+    /** Handler function for cleanup reference */
+    private handleSwapEvent;
+    /** Background warming loop interval handle */
+    private warmingIntervalHandle;
+    /** Reconnection state tracking */
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelayMs;
+    constructor(socket: Socket | Promise<Socket>, fetchPoolFn: (poolKey: string) => Promise<CompositePoolDataResult>, quoteService: DexQuoteService, config?: SwapMonitorConfig, logger?: Logger);
+    /**
+     * Subscribe to swap events for real-time monitoring
+     *
+     * Sets up WebSocket listener for global swap broadcasts and event processing.
+     * Filters events based on options and calls callback for matching swaps.
+     * Automatically manages cache warming, offline quote calculation, and reconnection.
+     *
+     * **Performance:**
+     * - WebSocket connection: ~100-500ms initial setup
+     * - Event latency: <50ms P50 (25-50ms typical)
+     * - Delta application: 15-25ms (vs 200-400ms full refetch)
+     * - Offline quote: 25-50ms
+     *
+     * **Features:**
+     * - Position-independent token matching (GALA/USDC matches token0/token1 in any position)
+     * - Order-independent pair matching (GALA/USDC == USDC/GALA)
+     * - Tiered LRU cache with automatic background warming
+     * - Three-tier reconnection strategy for resilience
+     * - Delta-based pool updates for sub-50ms latency
+     *
+     * @param options - Subscription filter options
+     * @param options.tokenFilter - Token symbol to monitor (position-independent)
+     * @param options.pairFilter - Pair of tokens to monitor (order-independent, e.g., ['GALA', 'USDC'])
+     * @param options.feeFilter - Fee tier in basis points (e.g., 500, 3000, 10000)
+     * @param options.userFilter - User address to filter events
+     * @param options.onError - Error callback for connection/processing failures
+     *
+     * @param callback - Function called for each matching swap with signature:
+     *   `(event: SwapEventData, quote: OfflineQuote | null) => Promise<void>`
+     *
+     * @returns Cleanup function to unsubscribe and stop monitoring. Call this to:
+     *   - Remove the listener
+     *   - Unsubscribe from WebSocket if no other listeners exist
+     *   - Clean up background warming and metric collection
+     *
+     * @example
+     * ```typescript
+     * // Monitor GALA/USDC swaps for arbitrage opportunities
+     * const cleanup = monitor.subscribe(
+     *   {
+     *     pairFilter: ['GALA', 'USDC'],
+     *     feeFilter: 3000,
+     *     onError: (error) => console.error('Monitoring error:', error)
+     *   },
+     *   async (swap, quote) => {
+     *     if (quote && quote.priceImpact < 0.01) {
+     *       console.log(`Arbitrage opportunity: ${quote.priceImpact * 100}% impact`);
+     *       // Execute arbitrage logic
+     *     }
+     *   }
+     * );
+     *
+     * // Later, stop monitoring
+     * cleanup();
+     * ```
+     */
+    subscribe(options: SubscribeSwapOptions, callback: SwapEventCallback): CleanupFunction;
+    /**
+     * Get current health status with enhanced diagnostics
+     *
+     * Provides comprehensive health metrics including latency percentiles,
+     * cache performance trends, memory usage, and health recommendations.
+     *
+     * @returns Enhanced health object with detailed diagnostics
+     */
+    getHealth(): SwapMonitorHealth & {
+        recommendations?: string[];
+        detailedMetrics?: {
+            eventQueueUtilization: number;
+            cacheUtilization: number;
+            memoryUtilization: number;
+        };
+    };
+    /**
+     * Generate health recommendations based on current state
+     *
+     * @internal
+     */
+    private generateHealthRecommendations;
+    /**
+     * Get summary statistics
+     *
+     * @returns Summary with key metrics
+     */
+    getSummary(): {
+        queueStats: import("./SwapEventQueue").QueueStats;
+        cacheStats: {
+            totalCached: number;
+            hotCacheSize: number;
+            warmCacheSize: number;
+            coldCacheSize: number;
+            memoryUsedMB: number;
+        };
+        eventsProcessed: number;
+        eventsDropped: number;
+        cacheHitRate: number;
+        averageLatency: number;
+        memoryUsedMB: number;
+        throughputPerSecond: number;
+    };
+    /**
+     * Start background cache warming loop
+     *
+     * Periodically refreshes hot and warm cached pools to keep data fresh.
+     * Helps prevent accumulated drift from delta-only updates.
+     *
+     * @internal
+     */
+    private startBackgroundWarming;
+    /**
+     * Stop background cache warming loop
+     *
+     * @internal
+     */
+    private stopBackgroundWarming;
+    /**
+     * Perform background cache warming
+     *
+     * Periodically refreshes pools in hot and warm tiers to prevent accumulated drift.
+     * This helps maintain cache accuracy during low-event periods.
+     *
+     * @internal
+     */
+    private performBackgroundWarming;
+    /**
+     * Shutdown gracefully
+     *
+     * Stops listening, processes remaining events, and cleans up resources.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Set up connection monitoring and error handling
+     *
+     * Implements three-tier reconnection strategy:
+     * - Tier 1 (Quick): Immediate reconnect for transient failures
+     * - Tier 2 (Exponential): Backoff with exponential delay after failures
+     * - Tier 3 (Reset): Full system reset after max retries
+     *
+     * @internal
+     */
+    private setupConnectionMonitoring;
+    /**
+     * Attempt to reconnect with three-tier strategy
+     *
+     * @internal
+     */
+    private attemptReconnection;
+    /**
+     * Perform full system reset after max reconnection failures
+     *
+     * Clears cache, resets metrics, and logs comprehensive diagnostic info.
+     *
+     * @internal
+     */
+    private performFullReset;
+    /**
+     * Set up WebSocket listener for swap events
+     *
+     * @internal
+     */
+    private setupWebSocketListener;
+    /**
+     * Unsubscribe from events
+     *
+     * @internal
+     */
+    private unsubscribe;
+    /**
+     * Filter swap based on subscription options
+     *
+     * Applies position-independent and order-independent matching.
+     *
+     * @internal
+     */
+    private filterSwap;
+    /**
+     * Process a single swap event
+     *
+     * Updates pool cache with delta, calculates offline quote, and calls listeners.
+     *
+     * @internal
+     */
+    private processSwapEvent;
+    /**
+     * Notify error handlers
+     *
+     * @internal
+     */
+    private notifyError;
+    /**
+     * Determine health status based on metrics
+     *
+     * @internal
+     */
+    private determineHealthStatus;
+    /**
+     * Get max memory based on profile
+     *
+     * @internal
+     */
+    private getMaxMemoryMB;
+    /**
+     * Apply configuration defaults
+     *
+     * @internal
+     */
+    private applyDefaults;
+}
+/**
+ * Bounded Set with LRU eviction for transaction deduplication
+ *
+ * Provides Set-like interface with automatic eviction of oldest entries
+ * when capacity is reached. Prevents unbounded memory growth in 24/7 bots.
+ *
+ * @internal
+ */
+export declare class BoundedTransactionSet {
+    private readonly map;
+    private readonly maxSize;
+    constructor(maxSize: number);
+    has(transactionId: string): boolean;
+    add(transactionId: string): this;
+    delete(transactionId: string): boolean;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=MultiPoolStateManager.d.ts.map

package/dist/src/services/MultiPoolStateManager.d.ts.map

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