@gala-chain/launchpad-sdk 3.31.2 → 4.0.1-beta.0

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":"AAgBA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAsB3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWpD,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,4BAA4B,EAE5B,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAGV,kCAAkC,EAClC,uBAAuB,EACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAerD,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,kBAAkB,CAAa;gBAE3B,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,eAAe;IAyC7G;;;;OAIG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAWhD;;;;;;;;;;;OAWG;IACG,sBAAsB,CAC1B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC;IAsI3B;;;;;;;;;;;OAWG;IACG,uBAAuB,CAC3B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC;IA8G3B;;;;OAIG;IACG,WAAW,CACf,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAqH7B;;;;;;;;;;OAUG;IACG,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiEtG;;;;OAIG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmCnE;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsEpE;;;;;;OAMG;IAEH;;;OAGG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;OAIG;YACW,mBAAmB;IA4EjC;;;OAGG;IAEH,OAAO,CAAC,yBAAyB;IAuDjC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqBpB,yBAAyB,CAC7B,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,MAA4C,EACnD,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,2BAA2B,CAAC;IA4FvC;;;;;;;OAOG;IACG,gCAAgC,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,aAAa,EAAE,GAAG,2BAA2B,CAAC;IAwDzD;;;;;OAKG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,aAAa,CAAC;IAkCzB;;;;;;;;;;OAUG;IACG,wBAAwB,CAC5B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;IAsJzB;;;;;;;;;;OAUG;IACG,uBAAuB,CAAC,MAAM,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,aAAa,CAAC;IAiF1B;;;;OAIG;IACG,uBAAuB,CAAC,IAAI,EAAE;QAClC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,kCAAkC,CAAC;IAuB/C;;;;OAIG;IACG,mBAAmB,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,uBAAuB,GAAG;QAAE,SAAS,CAAC,EAAE,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAiXzG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACG,uBAAuB,CAAC,IAAI,EAAE;QAClC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;QAC/B,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,uBAAuB,GAAG;QAAE,SAAS,CAAC,EAAE,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAwWzG;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;YACW,yBAAyB;IA8DvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuEG;IACG,eAAe,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;QAC/B,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA0FpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8EG;IACG,mBAAmB,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;QAC/B,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAwDpC;;;;;;OAMG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAsCF;;;;;;OAMG;IACG,yBAAyB,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAqBF;;;;;;;;;;OAUG;IACG,4BAA4B,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,EAAE;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IA4DF;;;;;;;;;;OAUG;IACG,0BAA0B,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IA+FF;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE;YACd,iBAAiB,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH,CAAC;IA+DF;;;;;;;OAOG;IACG,sBAAsB,CAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA0DzL;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAatB;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAUtC;;;;;OAKG;IACH,OAAO,CAAC,kCAAkC;IAQ1C;;;;;;;;;OASG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,GAAG,aAAa,EAC9B,MAAM,EAAE,MAAM,GAAG,aAAa,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC;IAsEzB;;;;OAIG;IACG,uBAAuB,CAAC,QAAQ,EAAE;QACtC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,aAAa,CAAC;IAsC1B;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAerC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAerC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAerC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAerC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;;;;;;;;;;OAYG;YACW,yBAAyB;IA0JvC;;;;;;;;;;;;;;;;;;;OAmBG;YACW,4BAA4B;IAwI1C;;;;;;;;;;;;;;;;;;OAkBG;YACW,gCAAgC;IAsI9C;;;;;;;;;;;;;;;;OAgBG;YACW,iBAAiB;IAgQ/B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,iCAAiC;IAsBzC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,gBAAgB;IA4CxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;;;;;;;OAQG;YACW,wBAAwB;IAMtC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,2BAA2B;CAIpC"}

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

@@ -0,0 +1,98 @@
+/**
+ * GalaChain Gateway Client
+ *
+ * Direct HTTP client for GalaChain Gateway DEX contract endpoints.
+ * Fully typed API interactions with zero `any` types.
+ */
+import { GalaChainGatewayResponse, GalaChainPoolData, GalaChainGetPoolDataRequest, GalaChainGetPositionsRequest, GalaChainGetPositionsResponse, GalaChainGetRemoveLiquidityEstimationRequest, GalaChainRemoveLiquidityEstimation } from '../types/galachain-api.types';
+/**
+ * GalaChain Gateway Client configuration
+ */
+export interface GalaChainGatewayClientConfig {
+    baseUrl: string;
+    timeout?: number;
+}
+/**
+ * Direct HTTP client for GalaChain Gateway DEX contract endpoints
+ */
+export declare class GalaChainGatewayClient {
+    private client;
+    constructor(config: GalaChainGatewayClientConfig);
+    /**
+     * Get pool data from GalaChain Gateway
+     * Endpoint: POST /api/asset/dexv3-contract/GetPoolData
+     *
+     * @param request - Pool data request with token pair and fee tier
+     * @returns Fully typed pool data
+     * @throws ApiError if request fails
+     */
+    getPoolData(request: GalaChainGetPoolDataRequest): Promise<GalaChainPoolData>;
+    /**
+     * Get position(s) from GalaChain Gateway
+     * Endpoint: POST /api/asset/dexv3-contract/GetPositions
+     *
+     * Supports multiple query filters:
+     * - Get all positions for owner
+     * - Get positions for specific token pair
+     * - Get specific position by ID
+     * - Pagination via bookmark
+     *
+     * @param request - Position query request with optional filters
+     * @returns List of positions matching criteria
+     * @throws ApiError if request fails
+     */
+    getPositions(request: GalaChainGetPositionsRequest): Promise<GalaChainGetPositionsResponse>;
+    /**
+     * Get position by ID from GalaChain Gateway
+     * Supports both compound key lookup (preferred) and simple positionId lookup
+     *
+     * 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(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
+     *
+     * Calculates amounts user will receive when removing liquidity
+     * Includes both principal amounts and accumulated fees
+     *
+     * @param request - Removal estimation request with position details
+     * @returns Estimated amounts to be received
+     * @throws ApiError if request fails
+     */
+    getRemoveLiquidityEstimation(request: GalaChainGetRemoveLiquidityEstimationRequest): Promise<GalaChainRemoveLiquidityEstimation>;
+    /**
+     * Validate GalaChain Gateway response wrapper
+     * Checks for errors and required fields
+     *
+     * @param response - Response object to validate
+     * @throws ApiError if response indicates error or is malformed
+     */
+    private validateResponse;
+    /**
+     * Handle errors from axios or gateway
+     * Converts various error types to ApiError
+     *
+     * @param error - Error from axios or validation
+     * @param context - Method name for better error messages
+     * @returns ApiError with context
+     */
+    private handleError;
+}
+/**
+ * Type re-export for convenience
+ * Used when function returns wrapped response
+ */
+export type GalaChainResponse<T> = GalaChainGatewayResponse<T>;
+//# sourceMappingURL=GalaChainGatewayClient.d.ts.map

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,8 @@ 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
  */
@@ -193,15 +195,40 @@ 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"
      * ```
      */
     fetchTokenClassFromChain(tokenId: string | TokenClassKey): Promise<TokenClass>;
+    /**
+     * Fetch supply information for one or more token classes from GalaChain
+     *
+     * Queries GalaChain for authoritative token supply data including:
+     * - Total supply and maximum supply
+     * - Total burned amount
+     * - Mint-related supply metrics
+     * - Token metadata (symbol, decimals, name)
+     *
+     * @param tokenClasses - Array of token class keys to query
+     * @returns Promise<TokenClassWithSupply[]> Array of token classes with supply information
+     * @throws {ValidationError} if tokenClasses array is empty
+     * @throws {Error} if network request fails or GalaChain returns error status
+     *
+     * @example
+     * ```typescript
+     * const supplies = await galaChainService.fetchTokenClassesWithSupply([
+     *   { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   { collection: 'GUSDC', category: 'Unit', type: 'none', additionalKey: 'eth:0x...' }
+     * ]);
+     *
+     * console.log(`${supplies[0].symbol}: ${supplies[0].totalSupply}`);
+     * ```
+     */
+    fetchTokenClassesWithSupply(tokenClasses: TokenClassKey[]): Promise<TokenClassWithSupply[]>;
     /**
      * Transfer GALA tokens between wallets
      *
@@ -272,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
      */
@@ -280,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
@@ -303,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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAGjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EAQlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,eAAe,EAGhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,oBAAoB,EAErB,MAAM,wBAAwB,CAAC;AAehC;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAc7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAhB/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAE9D;;;;;;;;OAQG;gBAED,IAAI,EAAE,UAAU,EACC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,aAAa,EAAE,oBAAoB,EACpD,KAAK,GAAE,OAAe,EACL,WAAW,CAAC,EAAE,aAAa,YAAA;IAU9C;;;;;;;;;;;;;;;;;;OAkBG;IACG,gBAAgB,CACpB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,gCAAgC,CAAC;IAuD5C;;;;;;;;;;;;;;;;OAgBG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAqB5C;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiCpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,gBAAgB,CAAC,WAAW,EAAE;QAClC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAItC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,iBAAiB,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA4DtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA0EpF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,2BAA2B,CAC/B,YAAY,EAAE,aAAa,EAAE,GAC5B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAkElC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkE3D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6F7D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAoGrD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAiGzD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA4CjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiD7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA+B/B;;;OAGG;YACW,oBAAoB;IA0ClC;;;;OAIG;IACH,OAAO,CAAC,oCAAoC;IAwB5C;;;;;;;;;OASG;IACH,OAAO,CAAC,gCAAgC;IAmCxC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAiE5B"}

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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"}