@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

package/dist/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/GSwapSwapService.d.ts

@@ -0,0 +1,68 @@
+import type { ExecuteSwapParams, ExecuteSwapResult, SwapQuoteParams, SwapQuoteResult } from '../types/gswap.dto';
+import { LoggerBase } from './BaseService';
+import type { DexQuoteService } from './DexQuoteService';
+import type { WebSocketService } from './WebSocketService';
+/**
+ * Configuration for GSwapSwapService
+ */
+export interface GSwapSwapServiceConfig {
+    privateKey?: string;
+    getWalletAddress: () => string | undefined;
+    bundlerBaseUrl: string;
+    gatewayBaseUrl: string;
+    webSocketService: WebSocketService;
+    dexQuoteService?: DexQuoteService;
+    debugMode?: boolean;
+}
+/**
+ * Swap operations for GSwap DEX
+ *
+ * @since 5.15.0
+ */
+export declare class GSwapSwapService extends LoggerBase {
+    private privateKey;
+    private getWalletAddress;
+    private bundlerBaseUrl;
+    private gatewayBaseUrl;
+    private webSocketService;
+    private dexQuoteService;
+    private tokenConverter;
+    constructor(config: GSwapSwapServiceConfig);
+    /**
+     * Convert a token pair from Launchpad format to GSwap format
+     */
+    private convertTokenPair;
+    /**
+     * Calculate personal sign prefix for GalaChain compatibility
+     */
+    private calculatePersonalSignPrefix;
+    /**
+     * Calculate execution price (output per unit input)
+     */
+    private calculateExecutionPrice;
+    /**
+     * Ensure WebSocket is connected before transaction monitoring
+     */
+    private ensureWebSocketConnected;
+    /**
+     * Build strings instructions for swap state locking
+     */
+    private buildSwapStringsInstructions;
+    /**
+     * Send Swap transaction directly to bundler
+     */
+    private sendSwapToBundler;
+    /**
+     * Get swap quote for spending a known input amount
+     */
+    getSwapQuoteExactInput(params: SwapQuoteParams): Promise<SwapQuoteResult>;
+    /**
+     * Get swap quote for receiving a known output amount
+     */
+    getSwapQuoteExactOutput(params: SwapQuoteParams): Promise<SwapQuoteResult>;
+    /**
+     * Execute a token swap
+     */
+    executeSwap(params: ExecuteSwapParams): Promise<ExecuteSwapResult>;
+}
+//# sourceMappingURL=GSwapSwapService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GSwapSwapService.d.ts","sourceRoot":"","sources":["../../src/services/GSwapSwapService.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAyB5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,cAAc,CAAuB;gBAEjC,MAAM,EAAE,sBAAsB;IAW1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAInC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;OAEG;YACW,wBAAwB;IAMtC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAqBpC;;OAEG;YACW,iBAAiB;IAmL/B;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAwH/E;;OAEG;IACG,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA+GhF;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwFzE"}

package/dist/services/GalaChainBalanceService.d.ts

@@ -0,0 +1,155 @@
+/**
+ * GalaChain Balance Service
+ *
+ * Service responsible for querying token balances from GalaChain.
+ * Extracted from GalaChainService for single responsibility.
+ *
+ * Features:
+ * - GALA balance queries
+ * - Generic token balance queries
+ * - Hold filtering (locked, in-use)
+ * - Available quantity calculation
+ *
+ * @example
+ * ```typescript
+ * const balanceService = new GalaChainBalanceService(http, debug);
+ *
+ * // Get GALA balance
+ * const galaBalance = await balanceService.fetchGalaBalance({
+ *   owner: "eth|1234567890abcdef1234567890abcdef12345678",
+ *   collection: "GALA",
+ *   category: "Unit",
+ *   additionalKey: "none",
+ *   type: "none",
+ *   instance: "0"
+ * });
+ *
+ * // Get any token balance with hold details
+ * const tokenBalance = await balanceService.fetchTokenBalance({
+ *   owner: "eth|...",
+ *   collection: "ANIME",
+ *   category: "Unit",
+ *   additionalKey: "none",
+ *   type: "none",
+ *   instance: "0"
+ * }, true); // include expired holds
+ * ```
+ *
+ * @category Services
+ * @since 5.15.0
+ */
+import type { TokenBalanceResult, TokenHold } from '../types/user.dto';
+import type { HttpClient } from '../utils/http';
+import { BaseService } from './BaseService';
+/**
+ * Sum the quantities of multiple token holds
+ *
+ * @param holds Array of token holds
+ * @returns Total quantity as decimal string
+ */
+declare function sumHoldQuantities(holds: TokenHold[]): string;
+/**
+ * Filter out expired holds based on current timestamp
+ *
+ * @param holds Array of token holds
+ * @param withExpired If true, return all holds including expired
+ * @returns Filtered array of holds
+ */
+declare function filterHolds(holds: TokenHold[], withExpired: boolean): TokenHold[];
+/**
+ * Calculate available (unlocked, not in-use) quantity
+ *
+ * @param total Total quantity held
+ * @param locked Quantity locked (from lockedHolds)
+ * @param inUse Quantity in use (from inUseHolds)
+ * @returns Available quantity as decimal string
+ */
+declare function calculateAvailableQuantity(total: string, locked?: string, inUse?: string): string;
+/**
+ * Balance query request parameters
+ */
+export interface BalanceQueryParams {
+    owner: string;
+    collection: string;
+    category: string;
+    additionalKey: string;
+    type: string;
+    instance: string;
+}
+/**
+ * GalaChain Balance Service
+ *
+ * Handles all balance-related queries to GalaChain gateway.
+ */
+export declare class GalaChainBalanceService extends BaseService {
+    /**
+     * Initialize GalaChain Balance Service
+     *
+     * @param http - HTTP client configured for GalaChain gateway
+     * @param debug - Enable debug logging (default: false)
+     */
+    constructor(http: HttpClient, debug?: boolean);
+    /**
+     * Determines the GalaChain channel for a given token collection.
+     * Most tokens are on the asset channel, but some tokens like MUSIC
+     * are on their own dedicated channels.
+     *
+     * @param collection - Token collection name (e.g., "$GMUSIC", "$MUSIC", "ANIME")
+     * @returns Channel name: 'asset', 'music', etc.
+     */
+    private getChannelForCollection;
+    /**
+     * Fetches GALA balance for a user from GalaChain
+     *
+     * Uses the GalaChain FetchBalances endpoint with GALA token parameters.
+     *
+     * @param requestBody Balance query parameters
+     * @returns Promise<TokenBalanceResult | null> Clean balance information or null if not held
+     * @throws Error if balance fetch fails
+     *
+     * @example
+     * ```typescript
+     * const balance = await balanceService.fetchGalaBalance({
+     *   owner: "eth|1234567890abcdef1234567890abcdef12345678",
+     *   collection: "GALA",
+     *   category: "Unit",
+     *   additionalKey: "none",
+     *   type: "none",
+     *   instance: "0"
+     * });
+     * ```
+     */
+    fetchGalaBalance(requestBody: BalanceQueryParams): Promise<TokenBalanceResult | null>;
+    /**
+     * Fetches token balance for any token from GalaChain
+     *
+     * Generic method for querying token balances using the GalaChain FetchBalances endpoint.
+     * Returns balance information including locked/in-use holds and computed available quantity.
+     *
+     * @param requestBody Balance query parameters
+     * @param withExpired If true, include expired holds in results (default: false)
+     * @returns Promise<TokenBalanceResult | null> Clean balance information or null if not held
+     * @throws Error if balance fetch fails
+     *
+     * @example
+     * ```typescript
+     * const balance = await balanceService.fetchTokenBalance({
+     *   owner: "eth|1234567890abcdef1234567890abcdef12345678",
+     *   collection: "ANIME",
+     *   category: "Unit",
+     *   additionalKey: "none",
+     *   type: "none",
+     *   instance: "0"
+     * });
+     *
+     * // Check lock details
+     * if (balance?.lockedHolds?.length) {
+     *   console.log('Locked:', balance.lockedQuantity);
+     *   console.log('Available:', balance.availableQuantity);
+     * }
+     * ```
+     */
+    fetchTokenBalance(requestBody: BalanceQueryParams, withExpired?: boolean): Promise<TokenBalanceResult | null>;
+}
+export { calculateAvailableQuantity, filterHolds, sumHoldQuantities };
+//# sourceMappingURL=GalaChainBalanceService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GalaChainBalanceService.d.ts","sourceRoot":"","sources":["../../src/services/GalaChainBalanceService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,OAAO,KAAK,EAEV,kBAAkB,EAClB,SAAS,EACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C;;;;;GAKG;AACH,iBAAS,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAQrD;AAED;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,OAAO,GAAG,SAAS,EAAE,CAU1E;AAED;;;;;;;GAOG;AACH,iBAAS,0BAA0B,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAY,EACpB,KAAK,GAAE,MAAY,GAClB,MAAM,CAER;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD;;;;;OAKG;gBACS,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE,OAAe;IAIpD;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAI3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,iBAAiB,CACrB,WAAW,EAAE,kBAAkB,EAC/B,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CA8FtC;AAGD,OAAO,EAAE,0BAA0B,EAAC,WAAW,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/services/GalaChainGatewayClient.d.ts

@@ -0,0 +1,227 @@
+/**
+ * GalaChain Gateway Client
+ *
+ * Direct HTTP client for GalaChain Gateway DEX contract endpoints with full type safety.
+ * Provides low-level blockchain interactions for DEX v3 liquidity pools and positions.
+ *
+ * ## Key Features:
+ * - Zero `any` types - fully typed responses
+ * - Automatic response validation
+ * - Compound key and position ID lookup support
+ * - Comprehensive error handling
+ *
+ * ## Supported Operations:
+ * - Pool state queries (GetPoolData)
+ * - Position management (GetPositions)
+ * - Liquidity removal estimation (GetRemoveLiquidityEstimation)
+ *
+ * @category GalaChain
+ * @since 3.0.0
+ */
+import type { GalaChainGatewayResponse, GalaChainGetPoolDataRequest, GalaChainGetPositionsRequest, GalaChainGetPositionsResponse, GalaChainGetRemoveLiquidityEstimationRequest, GalaChainGetSlot0Request, GalaChainPoolData, GalaChainRemoveLiquidityEstimation, GalaChainSlot0Data } 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);
+    /**
+     * Fetch pool state data from GalaChain DEX v3 contract
+     *
+     * Retrieves complete pool state including liquidity, price, tick data, and fee tier.
+     * Uses TokenClassKey objects for precise token identification - pipe-delimited strings
+     * are NOT supported (use parseToken() utility to convert if needed).
+     *
+     * **Critical**: tokens must be TokenClassKey objects, not strings. Backend requires
+     * structured token objects with collection/category/type/additionalKey fields.
+     *
+     * @param request Pool data request with token0, token1 (TokenClassKey objects), and fee tier
+     * @returns Promise<GalaChainPoolData> Complete pool state from blockchain
+     * @throws ApiError if tokens are strings instead of objects, or request fails
+     * @category GalaChain
+     * @since 3.0.0
+     *
+     * @example Fetch pool state for GALA/GUSDC
+     * ```typescript
+     * const poolData = await client.getPoolData({
+     *   token0: { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   token1: { collection: 'GUSDC', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   fee: 3000  // 0.3% fee tier
+     * });
+     * console.log('Current price:', poolData.sqrtPriceX96);
+     * console.log('Liquidity:', poolData.liquidity);
+     * ```
+     */
+    getPoolData(request: GalaChainGetPoolDataRequest): Promise<GalaChainPoolData>;
+    /**
+     * Fetch minimal pool state (Slot0) from GalaChain DEX v3 contract
+     *
+     * Retrieves the essential pool state data needed for pricing and liquidity calculations:
+     * - sqrtPrice: Current sqrt price (decimal string)
+     * - tick: Current tick number
+     * - liquidity: Current pool liquidity
+     * - grossPoolLiquidity: Optional gross pool liquidity value
+     *
+     * Lightweight alternative to getPoolData() when only slot0 data is needed.
+     *
+     * **Critical**: tokens must be TokenClassKey objects, not strings.
+     *
+     * @param request Slot0 request with token0, token1 (TokenClassKey objects), and fee tier
+     * @returns Promise<GalaChainSlot0Data> Minimal pool state data
+     * @throws ApiError if tokens are strings instead of objects, or request fails
+     * @category GalaChain
+     * @since 5.16.0
+     *
+     * @example Fetch Slot0 for GALA/GUSDC
+     * ```typescript
+     * const slot0 = await client.getSlot0({
+     *   token0: { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   token1: { collection: 'GUSDC', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   fee: 3000  // 0.3% fee tier
+     * });
+     * console.log('Current price:', slot0.sqrtPrice);
+     * console.log('Current tick:', slot0.tick);
+     * ```
+     */
+    getSlot0(request: GalaChainGetSlot0Request): Promise<GalaChainSlot0Data>;
+    /**
+     * Query liquidity positions from GalaChain DEX v3 contract
+     *
+     * Flexible position query supporting multiple filter combinations:
+     * - All positions for an owner (owner only)
+     * - Positions for specific pool (owner + token0 + token1)
+     * - Specific position by compound key (owner + tokens + ticks)
+     * - Pagination support via bookmark field
+     *
+     * **Response Format**: Returns either single position object or `{ positions: [...], count: N }`
+     * wrapper depending on query type. SDK normalizes to consistent array format.
+     *
+     * @param request Position query with owner and optional filters (token0, token1, fee, ticks, bookmark)
+     * @returns Promise<GalaChainGetPositionsResponse> Array of matching positions with count
+     * @throws ApiError if request fails or response format invalid
+     * @category GalaChain
+     * @since 3.0.0
+     *
+     * @example Get all positions for a user
+     * ```typescript
+     * const positions = await client.getPositions({
+     *   owner: 'client|user123'
+     * });
+     * console.log(`User has ${positions.count} positions`);
+     * ```
+     *
+     * @example Get positions for specific pool
+     * ```typescript
+     * const poolPositions = await client.getPositions({
+     *   owner: 'client|user123',
+     *   token0: { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   token1: { collection: 'GUSDC', category: 'Unit', type: 'none', additionalKey: 'none' }
+     * });
+     * ```
+     */
+    getPositions(request: GalaChainGetPositionsRequest): Promise<GalaChainGetPositionsResponse>;
+    /**
+     * Fetch specific liquidity position by compound key or position ID
+     *
+     * Supports two lookup strategies:
+     * 1. **Compound Key** (preferred): owner + token0 + token1 + fee + tickLower + tickUpper
+     * 2. **Position ID** (legacy fallback): just position ID string
+     *
+     * Compound key lookup is more reliable and matches the blockchain's native position
+     * identification scheme. Position ID lookup is provided for backward compatibility.
+     *
+     * **Response Format**: Returns position object directly (not wrapped in array).
+     *
+     * @param ownerOrPositionId Position owner address (compound key) or position ID (legacy)
+     * @param token0Optional Token0 symbol or TokenClassKey (required for compound key)
+     * @param token1Optional Token1 symbol or TokenClassKey (required for compound key)
+     * @param feeOptional Fee tier in basis points (required for compound key)
+     * @param tickLowerOptional Lower tick boundary (required for compound key)
+     * @param tickUpperOptional Upper tick boundary (required for compound key)
+     * @param positionIdOptional Optional position ID to include in request
+     * @returns Promise<GalaChainResponse<unknown>> Wrapped position data
+     * @throws ApiError if position not found (404) or request fails
+     * @category GalaChain
+     * @since 3.0.0
+     *
+     * @example Fetch position by compound key (preferred)
+     * ```typescript
+     * const position = await client.getPositionById(
+     *   'client|user123',
+     *   { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   { collection: 'GUSDC', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   3000,      // 0.3% fee
+     *   -887220,   // tickLower
+     *   887220,    // tickUpper
+     *   'position123'  // optional
+     * );
+     * console.log('Liquidity:', position.Data.liquidity);
+     * ```
+     *
+     * @example Fetch position by ID (legacy)
+     * ```typescript
+     * const position = await client.getPositionById('position123');
+     * ```
+     */
+    getPositionById(ownerOrPositionId: string, token0Optional?: string | Record<string, unknown>, token1Optional?: string | Record<string, unknown>, feeOptional?: number, tickLowerOptional?: number, tickUpperOptional?: number, positionIdOptional?: string): Promise<GalaChainResponse<unknown>>;
+    /**
+     * Calculate estimated token amounts from liquidity removal
+     *
+     * Simulates removing liquidity from a position to preview the exact amounts of token0
+     * and token1 that will be received. Includes both principal liquidity and accumulated
+     * trading fees. Does not execute the removal - use for UI preview before transaction.
+     *
+     * **Use Cases**: Preview removal amounts, calculate impermanent loss, position exit planning
+     *
+     * @param request Removal estimation request with owner, tokens, fee, ticks, and liquidity amount
+     * @returns Promise<GalaChainRemoveLiquidityEstimation> Estimated token0 and token1 amounts
+     * @throws ApiError if request fails or position parameters invalid
+     * @category GalaChain
+     * @since 3.0.0
+     *
+     * @example Estimate removal amounts
+     * ```typescript
+     * const estimation = await client.getRemoveLiquidityEstimation({
+     *   owner: 'client|user123',
+     *   token0: { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   token1: { collection: 'GUSDC', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   fee: 3000,
+     *   tickLower: -887220,
+     *   tickUpper: 887220,
+     *   liquidity: '1000000000000'
+     * });
+     * console.log(`Will receive: ${estimation.amount0} GALA, ${estimation.amount1} GUSDC`);
+     * ```
+     */
+    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/services/GalaChainGatewayClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GalaChainGatewayClient.d.ts","sourceRoot":"","sources":["../../src/services/GalaChainGatewayClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,4CAA4C,EAC5C,wBAAwB,EAAG,iBAAiB,EAE5C,kCAAkC,EAClC,kBAAkB,EAAC,MAAM,8BAA8B,CAAC;AAY1D;;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;IAIhD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,WAAW,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4CnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2C9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,YAAY,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IA4DjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,eAAe,CACnB,iBAAiB,EAAE,MAAM,EAEzB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEjD,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjD,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,iBAAiB,CAAC,EAAE,MAAM,EAC1B,kBAAkB,CAAC,EAAE,MAAM,GAE1B,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAyGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,4BAA4B,CAChC,OAAO,EAAE,4CAA4C,GACpD,OAAO,CAAC,kCAAkC,CAAC;IAkC9C;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAmBpB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,CAAC,CAAC"}

package/dist/services/GalaChainLockService.d.ts

@@ -0,0 +1,144 @@
+/**
+ * GalaChain Lock Service
+ *
+ * Service responsible for token locking and unlocking operations on GalaChain.
+ * Extracted from GalaChainService for single responsibility.
+ *
+ * Features:
+ * - Batch token locking (staking, escrow, vesting)
+ * - Batch token unlocking
+ * - Lock authority management
+ * - Expiration handling
+ *
+ * @example
+ * ```typescript
+ * const lockService = new GalaChainLockService(http, wallet, tokenResolver, debug);
+ *
+ * // Lock tokens for staking
+ * const result = await lockService.lockTokens({
+ *   tokens: [
+ *     { tokenName: 'anime', amount: '100', lockAuthority: 'eth|0x1234...' },
+ *     { tokenName: 'dragon', amount: '50', expires: Date.now() + 86400000 }
+ *   ]
+ * });
+ *
+ * // Unlock previously locked tokens
+ * const unlockResult = await lockService.unlockTokens({
+ *   tokens: [{ tokenName: 'anime', amount: '50' }]
+ * });
+ * ```
+ *
+ * @category Services
+ * @since 5.15.0
+ */
+import '../utils/errors';
+import type { Wallet } from 'ethers';
+import type { LockTokensData, LockTokensResult, UnlockTokensData, UnlockTokensResult } from '../types/lock.dto';
+import type { HttpClient } from '../utils/http';
+import { BaseService } from './BaseService';
+import type { TokenResolverService } from './TokenResolverService';
+/**
+ * GalaChain Lock Service
+ *
+ * Handles all token locking and unlocking operations on GalaChain.
+ */
+export declare class GalaChainLockService extends BaseService {
+    private readonly wallet;
+    private readonly tokenResolver;
+    private readonly signatureHelper;
+    /**
+     * Initialize GalaChain Lock Service
+     *
+     * @param http - HTTP client configured for GalaChain gateway
+     * @param wallet - Ethers wallet for signing transactions (optional for read-only operations)
+     * @param tokenResolver - Token resolver service for vault address resolution
+     * @param debug - Enable debug logging (default: false)
+     */
+    constructor(http: HttpClient, wallet: Wallet | undefined, tokenResolver: TokenResolverService, debug?: boolean);
+    /**
+     * Lock tokens on GalaChain (batch operation)
+     *
+     * Supports locking multiple token types in a single transaction.
+     * Places holds on tokens, making them non-transferable
+     * until unlocked by the lock authority. Useful for staking, escrow, vesting,
+     * or other hold scenarios.
+     *
+     * @param data - Lock parameters containing array of tokens to lock
+     * @returns LockTokensResult with transaction ID and locked token details
+     *
+     * @example
+     * ```typescript
+     * // Lock a single token
+     * const result = await lockService.lockTokens({
+     *   tokens: [{ tokenName: 'anime', amount: '100' }]
+     * });
+     *
+     * // Lock multiple tokens with different settings
+     * const result = await lockService.lockTokens({
+     *   tokens: [
+     *     { tokenName: 'anime', amount: '100', lockAuthority: 'eth|0x1234...' },
+     *     { tokenName: 'dragon', amount: '50', expires: Date.now() + 86400000 }
+     *   ]
+     * });
+     * ```
+     *
+     * @throws {LockError} When validation fails or lock operation is rejected
+     */
+    lockTokens(data: LockTokensData): Promise<LockTokensResult>;
+    /**
+     * Unlock previously locked tokens on GalaChain (batch operation)
+     *
+     * Supports unlocking multiple token types in a single transaction.
+     * 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 containing array of tokens to unlock
+     * @returns UnlockTokensResult with transaction ID and unlocked token details
+     *
+     * @example
+     * ```typescript
+     * // Unlock a single token
+     * const result = await lockService.unlockTokens({
+     *   tokens: [{ tokenName: 'anime', amount: '50' }]
+     * });
+     *
+     * // Unlock multiple tokens
+     * const result = await lockService.unlockTokens({
+     *   tokens: [
+     *     { tokenName: 'anime', amount: '50' },
+     *     { tokenName: 'dragon', amount: '25', name: 'staking-lock-v1' }
+     *   ]
+     * });
+     * ```
+     *
+     * @throws {LockError} When validation fails or unlock operation is rejected
+     */
+    unlockTokens(data: UnlockTokensData): Promise<UnlockTokensResult>;
+    /**
+     * Validate lock tokens data (batch operation)
+     */
+    private validateLockTokensData;
+    /**
+     * Validate unlock tokens data (batch operation)
+     */
+    private validateUnlockTokensData;
+    /**
+     * Extract lock result from GalaChain response
+     */
+    private extractLockResult;
+    /**
+     * Extract unlock result from GalaChain response
+     */
+    private extractUnlockResult;
+    /**
+     * Handle lock/unlock operation errors
+     */
+    private handleLockError;
+    /**
+     * Resolve token name to tokenInstance object for lock/unlock operations
+     * Uses TokenResolverService to get vault address, then parses it to extract tokenInstance components
+     */
+    private resolveTokenInstance;
+}
+//# sourceMappingURL=GalaChainLockService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GalaChainLockService.d.ts","sourceRoot":"","sources":["../../src/services/GalaChainLockService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIrC,OAAO,KAAK,EACc,cAAc,EACtC,gBAAgB,EAGhB,gBAAgB,EAChB,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAe/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAYnE;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IAajD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAbhC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAE9D;;;;;;;OAOG;gBAED,IAAI,EAAE,UAAU,EACC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,aAAa,EAAE,oBAAoB,EACpD,KAAK,GAAE,OAAe;IAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwIjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8HvE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0E9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqDhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAyDvB;;;OAGG;YACW,oBAAoB;CA4DnC"}