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

package/dist/utils/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/utils/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;gBAEU,MAAM,EAAE,YAAY;IAQhC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAI7C;;;OAGG;IACH,OAAO,CAAC,GAAG;IAgCX;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAQjC;;;;;;;;;;;;;OAaG;IACH,cAAc,IAAI,OAAO;CAG1B"}

package/dist/utils/MonitoringMetrics.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Monitoring Metrics
+ *
+ * Collects real-time performance metrics for swap monitoring system.
+ * Tracks latency, throughput, cache performance, and memory usage.
+ *
+ * @packageDocumentation
+ */
+import type { SwapMonitorHealth } from '../types/swap-monitor.dto';
+/**
+ * Percentile latency data
+ *
+ * @internal
+ */
+export interface LatencyPercentiles {
+    p50: number;
+    p95: number;
+    p99: number;
+}
+/**
+ * Collects and maintains performance metrics for swap monitoring
+ *
+ * Tracks:
+ * - Event processing latency (p50, p95, p99)
+ * - Throughput (events per second)
+ * - Cache hit rates
+ * - Memory usage
+ * - Per-pool performance
+ *
+ * @internal
+ */
+export declare class MonitoringMetrics {
+    private eventLatencies;
+    private readonly maxLatencySamples;
+    private eventsProcessed;
+    private eventsDropped;
+    private queueDepth;
+    private maxQueueDepth;
+    private startTime;
+    private perPoolMetrics;
+    private memorySnapshots;
+    private readonly maxMemorySnapshots;
+    constructor();
+    /**
+     * Record event processing latency
+     *
+     * @param latencyMs - Processing time in milliseconds
+     */
+    recordEventLatency(latencyMs: number): void;
+    /**
+     * Record an event drop
+     */
+    recordEventDropped(): void;
+    /**
+     * Update queue depth
+     *
+     * @param depth - Current queue size
+     */
+    updateQueueDepth(depth: number): void;
+    /**
+     * Record pool cache hit
+     *
+     * @param poolKey - Pool identifier
+     * @param latencyMs - Processing latency
+     */
+    recordPoolCacheHit(poolKey: string, latencyMs: number): void;
+    /**
+     * Record pool cache miss
+     *
+     * @param poolKey - Pool identifier
+     * @param latencyMs - Processing latency
+     */
+    recordPoolCacheMiss(poolKey: string, latencyMs: number): void;
+    /**
+     * Get latency percentiles
+     *
+     * @returns P50, P95, P99 latencies in milliseconds
+     */
+    getLatencyPercentiles(): LatencyPercentiles;
+    /**
+     * Get cache hit rate
+     *
+     * @returns Percentage (0-100)
+     */
+    getCacheHitRate(): number;
+    /**
+     * Get events per second
+     *
+     * @returns Throughput metric
+     */
+    getThroughputPerSecond(): number;
+    /**
+     * Record memory usage
+     */
+    recordMemory(): void;
+    /**
+     * Get current memory usage in MB
+     *
+     * @returns Memory in megabytes or 0 if unavailable
+     */
+    getMemoryUsedMB(): number;
+    /**
+     * Get average latency for a pool
+     *
+     * @param poolKey - Pool identifier
+     * @returns Average latency in milliseconds
+     */
+    getPoolAverageLatency(poolKey: string): number;
+    /**
+     * Get cache hit rate for a pool
+     *
+     * @param poolKey - Pool identifier
+     * @returns Percentage (0-100)
+     */
+    getPoolCacheHitRate(poolKey: string): number;
+    /**
+     * Get all metrics as health object
+     *
+     * @param totalPoolsMonitored - Total number of pools in cache
+     * @param hotCacheSize - Size of hot cache
+     * @param warmCacheSize - Size of warm cache
+     * @param coldCacheSize - Size of cold cache
+     * @param maxMemoryMB - Maximum allowed memory in MB
+     * @returns Health object with all metrics
+     */
+    getHealthMetrics(totalPoolsMonitored: number, hotCacheSize: number, warmCacheSize: number, coldCacheSize: number, maxMemoryMB: number): Omit<SwapMonitorHealth, 'status' | 'websocket'>;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get summary statistics
+     *
+     * @returns Summary object with key metrics
+     */
+    getSummary(): {
+        eventsProcessed: number;
+        eventsDropped: number;
+        cacheHitRate: number;
+        averageLatency: number;
+        memoryUsedMB: number;
+        throughputPerSecond: number;
+    };
+    /**
+     * Get private helper to get or create pool metrics
+     *
+     * @internal
+     */
+    private getPoolMetrics;
+}
+//# sourceMappingURL=MonitoringMetrics.d.ts.map

package/dist/utils/MonitoringMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitoringMetrics.d.ts","sourceRoot":"","sources":["../../src/utils/MonitoringMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAKnE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAeD;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,cAAc,CAAkC;IAGxD,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAO;;IAM1C;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ3C;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ5D;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ7D;;;;OAIG;IACH,qBAAqB,IAAI,kBAAkB;IAiB3C;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAczB;;;;OAIG;IACH,sBAAsB,IAAI,MAAM;IAShC;;OAEG;IACH,YAAY,IAAI,IAAI;IAUpB;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAOzB;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAS9C;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAc5C;;;;;;;;;OASG;IACH,gBAAgB,CACd,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,WAAW,CAAC;IA+BlD;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;;;OAIG;IACH,UAAU,IAAI;QACZ,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;KAC7B;IAeD;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAavB"}

package/dist/utils/PoolKeyNormalizer.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Pool Key Normalizer
+ *
+ * Handles creation and parsing of pool identifiers in the format:
+ * token0/token1/feeTier
+ *
+ * Provides consistent pool key generation and decomposition across the system.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Pool key components
+ *
+ * @internal
+ */
+export interface PoolKeyComponents {
+    token0: string;
+    token1: string;
+    feeTier: number;
+}
+/**
+ * Normalizes pool identifiers
+ *
+ * Creates and parses pool keys in the format: token0/token1/feeTier
+ *
+ * @internal
+ */
+export declare class PoolKeyNormalizer {
+    /**
+     * Create a pool key from components
+     *
+     * Format: token0/token1/feeTier
+     * Example: GALA|Unit|none|none/GUSDC|Unit|none|none/3000
+     *
+     * @param token0 - First token
+     * @param token1 - Second token
+     * @param feeTier - Fee tier in basis points
+     * @returns Pool key string
+     */
+    static createPoolKey(token0: string, token1: string, feeTier: number): string;
+    /**
+     * Parse a pool key into components
+     *
+     * Splits pool key by '/' to extract token0, token1, and feeTier.
+     *
+     * @param poolKey - Pool key string
+     * @returns Pool key components or null if invalid format
+     *
+     * @example
+     * ```typescript
+     * const result = PoolKeyNormalizer.parsePoolKey('GALA|Unit|none|none/GUSDC|Unit|none|none/3000');
+     * // Returns: { token0: 'GALA|Unit|none|none', token1: 'GUSDC|Unit|none|none', feeTier: 3000 }
+     * ```
+     */
+    static parsePoolKey(poolKey: string): PoolKeyComponents | null;
+    /**
+     * Check if a string is a valid pool key
+     *
+     * @param poolKey - String to check
+     * @returns True if valid pool key format
+     */
+    static isValidPoolKey(poolKey: unknown): poolKey is string;
+    /**
+     * Extract token0 from pool key
+     *
+     * @param poolKey - Pool key string
+     * @returns Token0 or null if invalid
+     */
+    static getToken0(poolKey: string): string | null;
+    /**
+     * Extract token1 from pool key
+     *
+     * @param poolKey - Pool key string
+     * @returns Token1 or null if invalid
+     */
+    static getToken1(poolKey: string): string | null;
+    /**
+     * Extract fee tier from pool key
+     *
+     * @param poolKey - Pool key string
+     * @returns Fee tier in basis points or null if invalid
+     */
+    static getFeeTier(poolKey: string): number | null;
+    /**
+     * Check if a pool key contains a specific token
+     *
+     * Matches token against either token0 or token1.
+     *
+     * @param poolKey - Pool key string
+     * @param token - Token to search for
+     * @returns True if token is in pool
+     */
+    static containsToken(poolKey: string, token: string): boolean;
+    /**
+     * Check if a pool key contains both tokens in a pair
+     *
+     * Matches regardless of position (token0 vs token1).
+     *
+     * @param poolKey - Pool key string
+     * @param token1 - First token to search for
+     * @param token2 - Second token to search for
+     * @returns True if both tokens are in pool (regardless of position)
+     */
+    static containsTokenPair(poolKey: string, token1: string, token2: string): boolean;
+    /**
+     * Normalize fee tier to standard basis points
+     *
+     * Accepts multiple formats and returns standard basis point value.
+     * Recognized values:
+     * - 500 (0.05%), 3000 (0.3%), 10000 (1.0%)
+     * - 0.05, 0.3, 1 (as decimal)
+     *
+     * @param fee - Fee in any format
+     * @returns Normalized fee tier or null if unrecognized
+     */
+    static normalizeFee(fee: string | number | undefined): number | null;
+    /**
+     * Format fee tier as percentage string
+     *
+     * @param feeTier - Fee tier in basis points
+     * @returns Percentage string (e.g., "0.3%")
+     */
+    static formatFeeAsPercentage(feeTier: number): string;
+    /**
+     * Check if two tokens form a valid pair
+     *
+     * Valid pairs have two different tokens.
+     *
+     * @param token1 - First token
+     * @param token2 - Second token
+     * @returns True if valid pair
+     */
+    static isValidTokenPair(token1: string, token2: string): boolean;
+}
+//# sourceMappingURL=PoolKeyNormalizer.d.ts.map

package/dist/utils/PoolKeyNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolKeyNormalizer.d.ts","sourceRoot":"","sources":["../../src/utils/PoolKeyNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAI7E;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAkC9D;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,MAAM;IAS1D;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKhD;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKhD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKjD;;;;;;;;OAQG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAS7D;;;;;;;;;OASG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAalF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IA2BpE;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAKrD;;;;;;;;OAQG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAGjE"}

package/dist/utils/ReconnectionManager.d.ts

@@ -0,0 +1,142 @@
+/**
+ * ReconnectionManager - Centralized reconnection logic for WebSocket services
+ *
+ * Provides unified reconnection tracking, delay calculation with optional
+ * exponential backoff, and retry decision logic. Used by:
+ * - WebSocketService (transaction monitoring)
+ * - StreamWebSocketService (streaming/chat)
+ * - MultiPoolStateManager (DEX swap monitoring)
+ *
+ * @category Utils
+ * @since 5.12.0
+ */
+/**
+ * Configuration options for ReconnectionManager
+ */
+export interface ReconnectionConfig {
+    /** Maximum number of reconnection attempts before giving up (default: 5) */
+    maxAttempts?: number;
+    /** Base delay between reconnection attempts in milliseconds (default: 2000) */
+    baseDelayMs?: number;
+    /** Whether to use exponential backoff for delays (default: false) */
+    useExponentialBackoff?: boolean;
+    /** Maximum delay cap when using exponential backoff in milliseconds (default: 30000) */
+    maxDelayMs?: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier?: number;
+}
+/**
+ * Current state of the reconnection manager
+ */
+export interface ReconnectionState {
+    /** Current number of reconnection attempts made */
+    attempts: number;
+    /** Maximum attempts allowed */
+    maxAttempts: number;
+    /** Whether more reconnection attempts are available */
+    canRetry: boolean;
+    /** Next delay to wait before reconnecting (in milliseconds) */
+    nextDelayMs: number;
+    /** Whether max attempts has been reached */
+    exhausted: boolean;
+}
+/**
+ * Manages reconnection state and delay calculation for WebSocket services
+ *
+ * Provides a unified interface for:
+ * - Tracking reconnection attempts
+ * - Calculating delays (with optional exponential backoff)
+ * - Determining if retry should be attempted
+ * - Resetting state on successful connection
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const manager = new ReconnectionManager();
+ *
+ * // On disconnect
+ * if (manager.shouldRetry()) {
+ *   const delay = manager.getNextDelay();
+ *   manager.recordAttempt();
+ *   setTimeout(() => reconnect(), delay);
+ * } else {
+ *   console.log('Max reconnection attempts reached');
+ * }
+ *
+ * // On successful connect
+ * manager.reset();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With exponential backoff
+ * const manager = new ReconnectionManager({
+ *   maxAttempts: 10,
+ *   baseDelayMs: 1000,
+ *   useExponentialBackoff: true,
+ *   maxDelayMs: 60000,
+ * });
+ *
+ * // Delays: 1000, 2000, 4000, 8000, 16000, 32000, 60000, 60000, ...
+ * ```
+ */
+export declare class ReconnectionManager {
+    private readonly config;
+    private attempts;
+    private currentDelayMs;
+    constructor(config?: ReconnectionConfig);
+    /**
+     * Check if another reconnection attempt should be made
+     *
+     * @returns true if attempts < maxAttempts
+     */
+    shouldRetry(): boolean;
+    /**
+     * Get the delay to wait before the next reconnection attempt
+     *
+     * When using exponential backoff, the delay doubles each attempt
+     * up to the configured maximum delay.
+     *
+     * @returns Delay in milliseconds
+     */
+    getNextDelay(): number;
+    /**
+     * Record a reconnection attempt
+     *
+     * Increments the attempt counter and updates the delay
+     * for the next attempt (if using exponential backoff).
+     */
+    recordAttempt(): void;
+    /**
+     * Reset the reconnection state
+     *
+     * Call this on successful connection to reset attempts
+     * and delay back to initial values.
+     */
+    reset(): void;
+    /**
+     * Get the current number of reconnection attempts
+     */
+    getAttempts(): number;
+    /**
+     * Get the maximum allowed reconnection attempts
+     */
+    getMaxAttempts(): number;
+    /**
+     * Check if max reconnection attempts have been exhausted
+     */
+    isExhausted(): boolean;
+    /**
+     * Get a snapshot of the current reconnection state
+     *
+     * Useful for logging and health monitoring.
+     */
+    getState(): ReconnectionState;
+    /**
+     * Get formatted status string for logging
+     *
+     * @returns String like "2/5 attempts"
+     */
+    getStatusString(): string;
+}
+//# sourceMappingURL=ReconnectionManager.d.ts.map

package/dist/utils/ReconnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconnectionManager.d.ts","sourceRoot":"","sources":["../../src/utils/ReconnectionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAaD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,kBAAuB;IAW3C;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;OAOG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAWrB;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,QAAQ,IAAI,iBAAiB;IAU7B;;;;OAIG;IACH,eAAe,IAAI,MAAM;CAG1B"}

package/dist/utils/SignatureHelper.d.ts

@@ -0,0 +1,140 @@
+import type { ethers } from 'ethers';
+export interface EIP712Domain {
+    name: string;
+    chainId?: number;
+    verifyingContract?: string;
+    version?: string;
+}
+export interface EIP712Types {
+    [key: string]: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+export interface SignedPayload {
+    signature: string;
+    domain: EIP712Domain;
+    types: EIP712Types;
+    signerPublicKey?: string;
+    prefix?: string;
+}
+/**
+ * Helper class for EIP-712 structured data signing
+ * Used for GalaChain transaction signatures
+ */
+export declare class SignatureHelper {
+    private wallet;
+    constructor(wallet: ethers.Wallet);
+    /**
+     * Generate a unique key for idempotency
+     */
+    static generateUniqueKey(): string;
+    /**
+     * Sign a TransferToken payload using EIP-712
+     */
+    signTransferToken(payload: {
+        from: string;
+        to: string;
+        quantity: string;
+        tokenInstance: {
+            collection: string;
+            category: string;
+            type: string;
+            additionalKey: string;
+            instance: string;
+        };
+        uniqueKey: string;
+    }): Promise<SignedPayload>;
+    /**
+     * Sign a LockToken payload using EIP-712
+     */
+    signLockToken(payload: {
+        lockAuthority: string;
+        tokenInstances: Array<{
+            owner: string;
+            quantity: string;
+            tokenInstanceKey: {
+                collection: string;
+                category: string;
+                type: string;
+                additionalKey: string;
+                instance: string;
+            };
+        }>;
+        expires?: number;
+        name?: string;
+        uniqueKey: string;
+    }): Promise<SignedPayload>;
+    /**
+     * Sign a BurnTokens payload using EIP-712
+     */
+    signBurnTokens(payload: {
+        tokenInstances: Array<{
+            quantity: string;
+            tokenInstanceKey: {
+                collection: string;
+                category: string;
+                type: string;
+                additionalKey: string;
+                instance: string;
+            };
+        }>;
+        uniqueKey: string;
+    }): Promise<SignedPayload>;
+    /**
+     * Sign an UnlockToken payload using EIP-712
+     */
+    signUnlockToken(payload: {
+        tokenInstances: Array<{
+            owner: string;
+            quantity: string;
+            tokenInstanceKey: {
+                collection: string;
+                category: string;
+                type: string;
+                additionalKey: string;
+                instance: string;
+            };
+        }>;
+        name?: string;
+        uniqueKey: string;
+    }): Promise<SignedPayload>;
+    /**
+     * Convert Ethereum address to GalaChain wallet format
+     *
+     * @deprecated Use AddressFormatter.toBackendFormat() instead for consistent address handling
+     * This method is kept for backward compatibility but delegates to AddressFormatter
+     * for proper validation and checksumming.
+     */
+    static toGalaChainAddress(address: string): string;
+    /**
+     * Convert GalaChain wallet format to Ethereum address
+     * Preserves EIP-55 checksum case if present in the address
+     *
+     * @deprecated Use AddressFormatter.toEthereumFormat() instead for consistent address handling
+     * This method is kept for backward compatibility but delegates to AddressFormatter
+     * for proper format conversion.
+     */
+    static fromGalaChainAddress(galaAddress: string): string;
+    /**
+     * Create token instance for GALA transfers
+     */
+    static createGALATokenInstance(): {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+        instance: string;
+    };
+    /**
+     * Create token instance from token class key
+     */
+    static createTokenInstanceFromClassKey(tokenClassKey: string): {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+        instance: string;
+    };
+}
+//# sourceMappingURL=SignatureHelper.d.ts.map

package/dist/utils/SignatureHelper.d.ts.map

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