@metamask-previews/perps-controller 0.0.0-preview-e4aa1532 → 0.0.0-preview-6dfa4aeba

package/dist/platform-services/HyperLiquidClientService.cjs

@@ -1,857 +0,0 @@
-"use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _HyperLiquidClientService_instances, _HyperLiquidClientService_exchangeClient, _HyperLiquidClientService_infoClient, _HyperLiquidClientService_infoClientHttp, _HyperLiquidClientService_subscriptionClient, _HyperLiquidClientService_wsTransport, _HyperLiquidClientService_httpTransport, _HyperLiquidClientService_isTestnet, _HyperLiquidClientService_connectionState, _HyperLiquidClientService_disconnectionPromise, _HyperLiquidClientService_onTerminateCallback, _HyperLiquidClientService_onReconnectCallback, _HyperLiquidClientService_reconnectionAttempt, _HyperLiquidClientService_connectionStateListeners, _HyperLiquidClientService_reconnectionRetryTimeout, _HyperLiquidClientService_deps, _HyperLiquidClientService_isReconnecting, _HyperLiquidClientService_createTransports, _HyperLiquidClientService_getIntervalMilliseconds, _HyperLiquidClientService_performDisconnection, _HyperLiquidClientService_updateConnectionState, _HyperLiquidClientService_notifyConnectionStateListeners, _HyperLiquidClientService_handleConnectionDrop;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HyperLiquidClientService = exports.WebSocketConnectionState = void 0;
-const hyperliquid_1 = require("@nktkas/hyperliquid");
-const hyperLiquidConfig_1 = require("../constants/hyperLiquidConfig.cjs");
-const perpsConfig_1 = require("../constants/perpsConfig.cjs");
-const perpsErrorCodes_1 = require("../constants/perpsErrorCodes.cjs");
-const chartUtils_1 = require("../utils/chartUtils.cjs");
-/**
- * Ensures we have a proper Error object for logging.
- * Converts unknown/string errors to proper Error instances.
- *
- * @param error - The caught error (could be Error, string, or unknown)
- * @returns A proper Error instance
- */
-function ensureError(error) {
-    if (error instanceof Error) {
-        return error;
-    }
-    return new Error(String(error));
-}
-/**
- * Connection states for WebSocket management
- */
-var WebSocketConnectionState;
-(function (WebSocketConnectionState) {
-    WebSocketConnectionState["Disconnected"] = "disconnected";
-    WebSocketConnectionState["Connecting"] = "connecting";
-    WebSocketConnectionState["Connected"] = "connected";
-    WebSocketConnectionState["Disconnecting"] = "disconnecting";
-})(WebSocketConnectionState || (exports.WebSocketConnectionState = WebSocketConnectionState = {}));
-/**
- * Maximum number of reconnection attempts before giving up
- */
-const MAX_RECONNECTION_ATTEMPTS = 10;
-/**
- * Service for managing HyperLiquid SDK clients
- * Handles initialization, transport creation, and client lifecycle
- */
-class HyperLiquidClientService {
-    /**
-     * Creates a new HyperLiquidClientService instance.
-     *
-     * @param deps - Platform dependencies for logging
-     * @param options - Configuration options
-     * @param options.isTestnet - Whether to use testnet mode
-     */
-    constructor(deps, options = {}) {
-        _HyperLiquidClientService_instances.add(this);
-        _HyperLiquidClientService_exchangeClient.set(this, void 0);
-        _HyperLiquidClientService_infoClient.set(this, void 0); // WebSocket transport (default)
-        _HyperLiquidClientService_infoClientHttp.set(this, void 0); // HTTP transport (fallback)
-        _HyperLiquidClientService_subscriptionClient.set(this, void 0);
-        _HyperLiquidClientService_wsTransport.set(this, void 0);
-        _HyperLiquidClientService_httpTransport.set(this, void 0);
-        _HyperLiquidClientService_isTestnet.set(this, void 0);
-        _HyperLiquidClientService_connectionState.set(this, WebSocketConnectionState.Disconnected);
-        _HyperLiquidClientService_disconnectionPromise.set(this, null);
-        // Callback for SDK terminate event (fired when all reconnection attempts exhausted)
-        _HyperLiquidClientService_onTerminateCallback.set(this, null);
-        _HyperLiquidClientService_onReconnectCallback.set(this, void 0);
-        // Reconnection attempt counter
-        _HyperLiquidClientService_reconnectionAttempt.set(this, 0);
-        // Connection state change listeners for event-based notifications
-        _HyperLiquidClientService_connectionStateListeners.set(this, new Set());
-        // Timeout reference for reconnection retry, tracked to enable cancellation on disconnect
-        _HyperLiquidClientService_reconnectionRetryTimeout.set(this, null);
-        // Platform dependencies for logging
-        _HyperLiquidClientService_deps.set(this, void 0);
-        // Flag to prevent concurrent reconnection attempts
-        _HyperLiquidClientService_isReconnecting.set(this, false);
-        __classPrivateFieldSet(this, _HyperLiquidClientService_deps, deps, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_isTestnet, options.isTestnet ?? false, "f");
-    }
-    /**
-     * Initialize all HyperLiquid SDK clients
-     *
-     * IMPORTANT: This method awaits transport.ready() to ensure the WebSocket is
-     * in OPEN state before marking initialization complete. This prevents race
-     * conditions where subscriptions are attempted before the WebSocket handshake
-     * completes (which would cause "subscribe error: undefined" errors).
-     *
-     * @param wallet - Wallet adapter with signTypedData capability
-     * @param wallet.address - The wallet address
-     * @param wallet.signTypedData - Function to sign typed data
-     * @param wallet.getChainId - Optional function to get chain ID
-     */
-    async initialize(wallet) {
-        try {
-            __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Connecting);
-            __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_createTransports).call(this);
-            // Ensure transports are created
-            if (!__classPrivateFieldGet(this, _HyperLiquidClientService_httpTransport, "f") || !__classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f")) {
-                throw new Error('Failed to create transports');
-            }
-            // Wallet adapter implements AbstractViemJsonRpcAccount interface with signTypedData method
-            // ExchangeClient uses HTTP transport for write operations (orders, approvals, etc.)
-            __classPrivateFieldSet(this, _HyperLiquidClientService_exchangeClient, new hyperliquid_1.ExchangeClient({
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                wallet: wallet,
-                transport: __classPrivateFieldGet(this, _HyperLiquidClientService_httpTransport, "f"),
-            }), "f");
-            // InfoClient with WebSocket transport (default) - multiplexed requests over single connection
-            __classPrivateFieldSet(this, _HyperLiquidClientService_infoClient, new hyperliquid_1.InfoClient({ transport: __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f") }), "f");
-            // InfoClient with HTTP transport (fallback) - for specific calls if WebSocket has issues
-            __classPrivateFieldSet(this, _HyperLiquidClientService_infoClientHttp, new hyperliquid_1.InfoClient({ transport: __classPrivateFieldGet(this, _HyperLiquidClientService_httpTransport, "f") }), "f");
-            // SubscriptionClient uses WebSocket transport for real-time pub/sub (price feeds, position updates)
-            __classPrivateFieldSet(this, _HyperLiquidClientService_subscriptionClient, new hyperliquid_1.SubscriptionClient({
-                transport: __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f"),
-            }), "f");
-            // Wait for WebSocket to actually be ready before setting CONNECTED
-            // This ensures we have a real connection, not just client objects
-            await __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f").ready();
-            __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Connected);
-            __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid SDK clients initialized', {
-                testnet: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f"),
-                timestamp: new Date().toISOString(),
-                connectionState: __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f"),
-                note: 'Using WebSocket for InfoClient (default), HTTP fallback available',
-            });
-        }
-        catch (error) {
-            // Cleanup on failure to prevent leaks and ensure isInitialized() returns false
-            // Clear clients first, then transports
-            __classPrivateFieldSet(this, _HyperLiquidClientService_subscriptionClient, undefined, "f");
-            __classPrivateFieldSet(this, _HyperLiquidClientService_infoClient, undefined, "f");
-            __classPrivateFieldSet(this, _HyperLiquidClientService_infoClientHttp, undefined, "f");
-            __classPrivateFieldSet(this, _HyperLiquidClientService_exchangeClient, undefined, "f");
-            // Close WebSocket transport to release resources and event listeners
-            if (__classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f")) {
-                try {
-                    await __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f").close();
-                }
-                catch {
-                    // Ignore cleanup errors
-                }
-                __classPrivateFieldSet(this, _HyperLiquidClientService_wsTransport, undefined, "f");
-            }
-            __classPrivateFieldSet(this, _HyperLiquidClientService_httpTransport, undefined, "f");
-            const errorInstance = ensureError(error);
-            __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Disconnected);
-            // Log to Sentry: initialization failure blocks all Perps functionality
-            __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").logger.error(errorInstance, {
-                tags: {
-                    feature: perpsConfig_1.PERPS_CONSTANTS.FeatureName,
-                    service: 'HyperLiquidClientService',
-                    network: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f") ? 'testnet' : 'mainnet',
-                },
-                context: {
-                    name: 'sdk_initialization',
-                    data: {
-                        operation: 'initialize',
-                        isTestnet: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f"),
-                    },
-                },
-            });
-            throw error;
-        }
-    }
-    /**
-     * Toggle testnet mode and reinitialize clients
-     *
-     * @param wallet - Wallet adapter with signTypedData capability
-     * @param wallet.address - The wallet address
-     * @param wallet.signTypedData - Function to sign typed data
-     * @param wallet.getChainId - Optional function to get chain ID
-     * @returns The new network mode
-     */
-    async toggleTestnet(wallet) {
-        __classPrivateFieldSet(this, _HyperLiquidClientService_isTestnet, !__classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f"), "f");
-        await this.initialize(wallet);
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f") ? 'testnet' : 'mainnet';
-    }
-    /**
-     * Check if clients are properly initialized
-     *
-     * @returns True if all clients are initialized
-     */
-    isInitialized() {
-        return Boolean(__classPrivateFieldGet(this, _HyperLiquidClientService_exchangeClient, "f") &&
-            __classPrivateFieldGet(this, _HyperLiquidClientService_infoClient, "f") &&
-            __classPrivateFieldGet(this, _HyperLiquidClientService_infoClientHttp, "f") &&
-            __classPrivateFieldGet(this, _HyperLiquidClientService_subscriptionClient, "f"));
-    }
-    /**
-     * Ensure clients are initialized, throw if not
-     */
-    ensureInitialized() {
-        if (!this.isInitialized()) {
-            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.CLIENT_NOT_INITIALIZED);
-        }
-    }
-    /**
-     * Recreate subscription client if needed (for reconnection scenarios)
-     *
-     * @param wallet - Wallet adapter with signTypedData capability
-     * @param wallet.address - The wallet address
-     * @param wallet.signTypedData - Function to sign typed data
-     * @param wallet.getChainId - Optional function to get chain ID
-     */
-    async ensureSubscriptionClient(wallet) {
-        if (!__classPrivateFieldGet(this, _HyperLiquidClientService_subscriptionClient, "f")) {
-            __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: Recreating subscription client after disconnect');
-            await this.initialize(wallet);
-        }
-    }
-    /**
-     * Get the exchange client
-     *
-     * @returns The exchange client
-     */
-    getExchangeClient() {
-        this.ensureInitialized();
-        if (!__classPrivateFieldGet(this, _HyperLiquidClientService_exchangeClient, "f")) {
-            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.EXCHANGE_CLIENT_NOT_AVAILABLE);
-        }
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_exchangeClient, "f");
-    }
-    /**
-     * Get the info client
-     *
-     * @param options - Options for client selection
-     * @param options.useHttp - Force HTTP transport instead of WebSocket (default: false)
-     * @returns InfoClient instance with the selected transport
-     */
-    getInfoClient(options) {
-        this.ensureInitialized();
-        if (options?.useHttp) {
-            if (!__classPrivateFieldGet(this, _HyperLiquidClientService_infoClientHttp, "f")) {
-                throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.INFO_CLIENT_NOT_AVAILABLE);
-            }
-            return __classPrivateFieldGet(this, _HyperLiquidClientService_infoClientHttp, "f");
-        }
-        if (!__classPrivateFieldGet(this, _HyperLiquidClientService_infoClient, "f")) {
-            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.INFO_CLIENT_NOT_AVAILABLE);
-        }
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_infoClient, "f");
-    }
-    /**
-     * Get the subscription client
-     *
-     * @returns The subscription client or undefined if not initialized
-     */
-    getSubscriptionClient() {
-        if (!__classPrivateFieldGet(this, _HyperLiquidClientService_subscriptionClient, "f")) {
-            __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('SubscriptionClient not initialized');
-            return undefined;
-        }
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_subscriptionClient, "f");
-    }
-    /**
-     * Ensures the WebSocket transport is in OPEN state and ready for subscriptions.
-     * This MUST be called before any subscription operations to prevent race conditions.
-     *
-     * The SDK's `transport.ready()` method:
-     * - Returns immediately if WebSocket is already in OPEN state
-     * - Waits for the "open" event if WebSocket is in CONNECTING state
-     * - Supports AbortSignal for timeout/cancellation
-     *
-     * @param timeoutMs - Maximum time to wait for transport ready (default 5000ms)
-     * @throws Error if transport not ready within timeout or subscription client unavailable
-     */
-    async ensureTransportReady(timeoutMs = 5000) {
-        const subscriptionClient = this.getSubscriptionClient();
-        if (!subscriptionClient) {
-            throw new Error('Subscription client not initialized');
-        }
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
-        try {
-            await subscriptionClient.config_.transport.ready(controller.signal);
-        }
-        catch (error) {
-            if (controller.signal.aborted) {
-                throw new Error(`WebSocket transport ready timeout after ${timeoutMs}ms`);
-            }
-            throw error;
-        }
-        finally {
-            clearTimeout(timeoutId);
-        }
-    }
-    /**
-     * Get current network state
-     *
-     * @returns The current network ('mainnet' or 'testnet')
-     */
-    getNetwork() {
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f") ? 'testnet' : 'mainnet';
-    }
-    /**
-     * Check if running on testnet
-     *
-     * @returns True if running on testnet
-     */
-    isTestnetMode() {
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f");
-    }
-    /**
-     * Update testnet mode
-     *
-     * @param testnet - Whether to use testnet
-     */
-    setTestnetMode(testnet) {
-        __classPrivateFieldSet(this, _HyperLiquidClientService_isTestnet, testnet, "f");
-    }
-    /**
-     * Fetch historical candle data using the HyperLiquid SDK
-     *
-     * @param symbol - The asset symbol (e.g., "BTC", "ETH")
-     * @param interval - The interval (e.g., "1m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M")
-     * @param limit - Number of candles to fetch (default: 100)
-     * @param endTime - End timestamp in milliseconds (default: now). Used for fetching historical data before a specific time.
-     * @returns Promise resolving to CandleData or null
-     */
-    async fetchHistoricalCandles(symbol, interval, limit = 100, endTime) {
-        this.ensureInitialized();
-        try {
-            // Calculate start and end times based on interval and limit
-            const now = endTime ?? Date.now();
-            const intervalMs = __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_getIntervalMilliseconds).call(this, interval);
-            const startTime = now - limit * intervalMs;
-            // Use the SDK's InfoClient to fetch candle data
-            // HyperLiquid SDK uses 'coin' terminology
-            const infoClient = this.getInfoClient();
-            const data = await infoClient.candleSnapshot({
-                coin: symbol, // Map to HyperLiquid SDK's 'coin' parameter
-                interval,
-                startTime,
-                endTime: now,
-            });
-            // Transform API response to match expected format
-            if (Array.isArray(data) && data.length > 0) {
-                const candles = data.map((candle) => ({
-                    time: candle.t, // open time
-                    open: candle.o.toString(),
-                    high: candle.h.toString(),
-                    low: candle.l.toString(),
-                    close: candle.c.toString(),
-                    volume: candle.v.toString(),
-                }));
-                return {
-                    symbol,
-                    interval,
-                    candles,
-                };
-            }
-            return {
-                symbol,
-                interval,
-                candles: [],
-            };
-        }
-        catch (error) {
-            const errorInstance = ensureError(error);
-            // Log to Sentry: prevents initial chart data load
-            __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").logger.error(errorInstance, {
-                tags: {
-                    feature: perpsConfig_1.PERPS_CONSTANTS.FeatureName,
-                    service: 'HyperLiquidClientService',
-                    network: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f") ? 'testnet' : 'mainnet',
-                },
-                context: {
-                    name: 'historical_candles_api',
-                    data: {
-                        operation: 'fetchHistoricalCandles',
-                        symbol,
-                        interval,
-                        limit,
-                        hasEndTime: endTime !== undefined,
-                    },
-                },
-            });
-            throw error;
-        }
-    }
-    /**
-     * Subscribe to candle updates via WebSocket
-     *
-     * @param params - Subscription parameters
-     * @param params.symbol - The asset symbol (e.g., "BTC", "ETH")
-     * @param params.interval - The interval (e.g., "1m", "5m", "15m", etc.)
-     * @param params.duration - Optional time duration for calculating initial fetch size
-     * @param params.callback - Function called with updated candle data
-     * @param params.onError - Optional function called if subscription initialization fails
-     * @returns Cleanup function to unsubscribe
-     */
-    subscribeToCandles({ symbol, interval, duration, callback, onError, }) {
-        this.ensureInitialized();
-        const subscriptionClient = this.getSubscriptionClient();
-        if (!subscriptionClient) {
-            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.SUBSCRIPTION_CLIENT_NOT_AVAILABLE);
-        }
-        let currentCandleData = null;
-        let wsUnsubscribe = null;
-        let isUnsubscribed = false;
-        // Calculate initial fetch size dynamically based on duration and interval
-        // Match main branch behavior: up to 500 candles initially
-        const initialLimit = duration
-            ? Math.min((0, chartUtils_1.calculateCandleCount)(duration, interval), 500)
-            : 100; // Default to 100 if no duration provided
-        // Helper to handle candle event updates
-        const handleCandleEvent = (candleEvent) => {
-            // Don't process events if already unsubscribed
-            if (isUnsubscribed) {
-                return;
-            }
-            // Transform SDK CandleEvent to our Candle format
-            const newCandle = {
-                time: candleEvent.t,
-                open: candleEvent.o.toString(),
-                high: candleEvent.h.toString(),
-                low: candleEvent.l.toString(),
-                close: candleEvent.c.toString(),
-                volume: candleEvent.v.toString(),
-            };
-            if (currentCandleData) {
-                // Check if this is an update to the last candle or a new candle
-                const { candles } = currentCandleData;
-                const lastCandle = candles[candles.length - 1];
-                if (lastCandle && lastCandle.time === newCandle.time) {
-                    // Update existing candle (live candle update)
-                    currentCandleData = {
-                        ...currentCandleData,
-                        candles: [...candles.slice(0, -1), newCandle],
-                    };
-                }
-                else {
-                    // New candle (completed candle)
-                    currentCandleData = {
-                        ...currentCandleData,
-                        candles: [...candles, newCandle],
-                    };
-                }
-            }
-            else {
-                currentCandleData = {
-                    symbol,
-                    interval,
-                    candles: [newCandle],
-                };
-            }
-            callback(currentCandleData);
-        };
-        // Helper to handle subscription setup
-        const setupSubscription = async () => {
-            try {
-                // 1. Fetch initial historical data
-                const initialData = await this.fetchHistoricalCandles(symbol, interval, initialLimit);
-                // Don't proceed if already unsubscribed
-                if (isUnsubscribed) {
-                    return;
-                }
-                currentCandleData = initialData;
-                if (currentCandleData) {
-                    callback(currentCandleData);
-                }
-                // 2. Subscribe to WebSocket for new candles
-                const sub = await subscriptionClient.candle({ coin: symbol, interval }, handleCandleEvent);
-                wsUnsubscribe = () => {
-                    sub.unsubscribe().catch(() => {
-                        // Ignore unsubscribe errors
-                    });
-                };
-                // If already unsubscribed while waiting, clean up immediately
-                if (isUnsubscribed && wsUnsubscribe) {
-                    wsUnsubscribe();
-                    wsUnsubscribe = null;
-                }
-            }
-            catch (error) {
-                const errorInstance = ensureError(error);
-                // Log to Sentry
-                __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").logger.error(errorInstance, {
-                    tags: {
-                        feature: perpsConfig_1.PERPS_CONSTANTS.FeatureName,
-                        service: 'HyperLiquidClientService',
-                        network: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f") ? 'testnet' : 'mainnet',
-                    },
-                    context: {
-                        name: 'candle_subscription',
-                        data: {
-                            operation: 'subscribeToCandles',
-                            symbol,
-                            interval,
-                            initialLimit,
-                        },
-                    },
-                });
-                // Notify caller of error
-                onError?.(errorInstance);
-            }
-        };
-        // Start the subscription setup (fire and forget with proper error handling)
-        setupSubscription().catch(() => {
-            // Errors are already handled in setupSubscription
-        });
-        // Return cleanup function
-        return () => {
-            isUnsubscribed = true;
-            if (wsUnsubscribe) {
-                wsUnsubscribe();
-                wsUnsubscribe = null;
-            }
-        };
-    }
-    /**
-     * Disconnect and cleanup all clients
-     *
-     * @returns Promise that resolves when disconnection is complete
-     */
-    async disconnect() {
-        // Return existing promise if already disconnecting
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_disconnectionPromise, "f")) {
-            await __classPrivateFieldGet(this, _HyperLiquidClientService_disconnectionPromise, "f");
-            return;
-        }
-        // If already disconnected, return immediately
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f") === WebSocketConnectionState.Disconnected) {
-            return;
-        }
-        // Create and store the disconnection promise
-        __classPrivateFieldSet(this, _HyperLiquidClientService_disconnectionPromise, __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_performDisconnection).call(this), "f");
-        try {
-            await __classPrivateFieldGet(this, _HyperLiquidClientService_disconnectionPromise, "f");
-        }
-        finally {
-            __classPrivateFieldSet(this, _HyperLiquidClientService_disconnectionPromise, null, "f");
-        }
-    }
-    /**
-     * Get current WebSocket connection state
-     *
-     * @returns The current connection state
-     */
-    getConnectionState() {
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f");
-    }
-    /**
-     * Check if WebSocket is fully disconnected
-     *
-     * @returns True if disconnected
-     */
-    isDisconnected() {
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f") === WebSocketConnectionState.Disconnected;
-    }
-    /**
-     * Set callback to be invoked when reconnection is needed
-     * This allows the service to notify external components (like PerpsConnectionManager)
-     * when a connection drop is detected
-     *
-     * @param callback - Callback to invoke on reconnection
-     */
-    setOnReconnectCallback(callback) {
-        __classPrivateFieldSet(this, _HyperLiquidClientService_onReconnectCallback, callback, "f");
-    }
-    /**
-     * Set callback for WebSocket termination events
-     * Called when the SDK exhausts all reconnection attempts
-     *
-     * @param callback - Callback to invoke on termination
-     */
-    setOnTerminateCallback(callback) {
-        __classPrivateFieldSet(this, _HyperLiquidClientService_onTerminateCallback, callback, "f");
-    }
-    /**
-     * Subscribe to connection state changes.
-     * The listener will be called immediately with the current state and whenever the state changes.
-     *
-     * @param listener - Callback function that receives the new connection state and reconnection attempt
-     * @returns Unsubscribe function to remove the listener
-     */
-    subscribeToConnectionState(listener) {
-        __classPrivateFieldGet(this, _HyperLiquidClientService_connectionStateListeners, "f").add(listener);
-        // Immediately notify with current state
-        // Wrap in try-catch to match notifyConnectionStateListeners behavior
-        // This ensures the unsubscribe function is always returned even if listener throws
-        try {
-            listener(__classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f"), __classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionAttempt, "f"));
-        }
-        catch {
-            // Ignore errors in listeners to prevent breaking subscription mechanism
-            // If listener throws, it will be removed when unsubscribe is called
-        }
-        // Return unsubscribe function
-        return () => {
-            __classPrivateFieldGet(this, _HyperLiquidClientService_connectionStateListeners, "f").delete(listener);
-        };
-    }
-    /**
-     * Manually trigger a reconnection attempt.
-     * This is exposed for UI retry buttons when user wants to force reconnection.
-     * Resets the reconnection attempt counter to allow retrying after max attempts.
-     *
-     * @returns Promise that resolves when reconnection attempt is complete
-     */
-    async reconnect() {
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('[HyperLiquidClientService] reconnect() called', {
-            previousAttempt: __classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionAttempt, "f"),
-            currentState: __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f"),
-        });
-        // Reset attempt counter when user manually triggers retry
-        __classPrivateFieldSet(this, _HyperLiquidClientService_reconnectionAttempt, 0, "f");
-        await __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_handleConnectionDrop).call(this);
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('[HyperLiquidClientService] reconnect() completed', {
-            newState: __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f"),
-        });
-    }
-}
-exports.HyperLiquidClientService = HyperLiquidClientService;
-_HyperLiquidClientService_exchangeClient = new WeakMap(), _HyperLiquidClientService_infoClient = new WeakMap(), _HyperLiquidClientService_infoClientHttp = new WeakMap(), _HyperLiquidClientService_subscriptionClient = new WeakMap(), _HyperLiquidClientService_wsTransport = new WeakMap(), _HyperLiquidClientService_httpTransport = new WeakMap(), _HyperLiquidClientService_isTestnet = new WeakMap(), _HyperLiquidClientService_connectionState = new WeakMap(), _HyperLiquidClientService_disconnectionPromise = new WeakMap(), _HyperLiquidClientService_onTerminateCallback = new WeakMap(), _HyperLiquidClientService_onReconnectCallback = new WeakMap(), _HyperLiquidClientService_reconnectionAttempt = new WeakMap(), _HyperLiquidClientService_connectionStateListeners = new WeakMap(), _HyperLiquidClientService_reconnectionRetryTimeout = new WeakMap(), _HyperLiquidClientService_deps = new WeakMap(), _HyperLiquidClientService_isReconnecting = new WeakMap(), _HyperLiquidClientService_instances = new WeakSet(), _HyperLiquidClientService_createTransports = function _HyperLiquidClientService_createTransports() {
-    // Prevent duplicate transport creation and listener accumulation
-    // This guards against re-entry if initialize() is called multiple times
-    // (e.g., after a failed initialization attempt that didn't properly clean up)
-    if (__classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f") && __classPrivateFieldGet(this, _HyperLiquidClientService_httpTransport, "f")) {
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: Transports already exist, skipping creation');
-        return __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f");
-    }
-    __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: Creating transports', {
-        isTestnet: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f"),
-        timestamp: new Date().toISOString(),
-        note: 'SDK will auto-select endpoints based on isTestnet flag',
-    });
-    // HTTP transport for request/response operations (InfoClient, ExchangeClient)
-    // SDK automatically selects: mainnet (https://api.hyperliquid.xyz) or testnet (https://api.hyperliquid-testnet.xyz)
-    __classPrivateFieldSet(this, _HyperLiquidClientService_httpTransport, new hyperliquid_1.HttpTransport({
-        isTestnet: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f"),
-        timeout: hyperLiquidConfig_1.HYPERLIQUID_TRANSPORT_CONFIG.timeout,
-    }), "f");
-    // WebSocket transport for real-time subscriptions (SubscriptionClient)
-    // SDK automatically selects: mainnet (wss://api.hyperliquid.xyz/ws) or testnet (wss://api.hyperliquid-testnet.xyz/ws)
-    __classPrivateFieldSet(this, _HyperLiquidClientService_wsTransport, new hyperliquid_1.WebSocketTransport({
-        isTestnet: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f"),
-        ...hyperLiquidConfig_1.HYPERLIQUID_TRANSPORT_CONFIG,
-        reconnect: {
-            ...hyperLiquidConfig_1.HYPERLIQUID_TRANSPORT_CONFIG.reconnect,
-            // Use globalThis.WebSocket for cross-platform compatibility (Node.js and browser)
-            WebSocket: globalThis.WebSocket,
-        },
-    }), "f");
-    // Listen for WebSocket termination (fired when SDK exhausts all reconnection attempts)
-    __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f").socket.addEventListener('terminate', (event) => {
-        const customEvent = event;
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: WebSocket terminated', {
-            reason: customEvent.detail?.code,
-            timestamp: new Date().toISOString(),
-        });
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Disconnected);
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_onTerminateCallback, "f")) {
-            const terminateError = customEvent.detail instanceof Error
-                ? customEvent.detail
-                : new Error(`WebSocket terminated: ${customEvent.detail?.code ?? 'unknown'}`);
-            __classPrivateFieldGet(this, _HyperLiquidClientService_onTerminateCallback, "f").call(this, terminateError);
-        }
-    });
-    return __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f");
-}, _HyperLiquidClientService_getIntervalMilliseconds = function _HyperLiquidClientService_getIntervalMilliseconds(interval) {
-    const intervalMap = {
-        '1m': 1 * 60 * 1000,
-        '3m': 3 * 60 * 1000,
-        '5m': 5 * 60 * 1000,
-        '15m': 15 * 60 * 1000,
-        '30m': 30 * 60 * 1000,
-        '1h': 60 * 60 * 1000,
-        '2h': 2 * 60 * 60 * 1000,
-        '4h': 4 * 60 * 60 * 1000,
-        '8h': 8 * 60 * 60 * 1000,
-        '12h': 12 * 60 * 60 * 1000,
-        '1d': 24 * 60 * 60 * 1000,
-        '3d': 3 * 24 * 60 * 60 * 1000,
-        '1w': 7 * 24 * 60 * 60 * 1000,
-        '1M': 30 * 24 * 60 * 60 * 1000, // Approximate
-    };
-    return intervalMap[interval] ?? 60 * 60 * 1000; // Default to 1 hour
-}, _HyperLiquidClientService_performDisconnection = 
-/**
- * Perform the actual disconnection
- */
-async function _HyperLiquidClientService_performDisconnection() {
-    try {
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Disconnecting);
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: Disconnecting SDK clients', {
-            isTestnet: __classPrivateFieldGet(this, _HyperLiquidClientService_isTestnet, "f"),
-            timestamp: new Date().toISOString(),
-            connectionState: __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f"),
-        });
-        // Clear callbacks
-        __classPrivateFieldSet(this, _HyperLiquidClientService_onReconnectCallback, undefined, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_onTerminateCallback, null, "f");
-        // Cancel any pending reconnection retry timeout
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionRetryTimeout, "f")) {
-            clearTimeout(__classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionRetryTimeout, "f"));
-            __classPrivateFieldSet(this, _HyperLiquidClientService_reconnectionRetryTimeout, null, "f");
-        }
-        // Clear connection state listeners to prevent stale callbacks
-        __classPrivateFieldGet(this, _HyperLiquidClientService_connectionStateListeners, "f").clear();
-        // Reset reconnection flag to allow future manual retries
-        // This prevents a race condition where disconnecting during an active
-        // reconnection attempt could leave the flag stuck, blocking subsequent retries
-        __classPrivateFieldSet(this, _HyperLiquidClientService_isReconnecting, false, "f");
-        // Close WebSocket transport only (HTTP is stateless)
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f")) {
-            try {
-                await __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f").close();
-                __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: Closed WebSocket transport', {
-                    timestamp: new Date().toISOString(),
-                });
-            }
-            catch (error) {
-                __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").logger.error(ensureError(error), {
-                    context: {
-                        name: 'HyperLiquidClientService.performDisconnection',
-                        data: { action: 'close_transport' },
-                    },
-                });
-            }
-        }
-        // Clear client references
-        __classPrivateFieldSet(this, _HyperLiquidClientService_subscriptionClient, undefined, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_exchangeClient, undefined, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_infoClient, undefined, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_infoClientHttp, undefined, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_wsTransport, undefined, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_httpTransport, undefined, "f");
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Disconnected);
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: SDK clients fully disconnected', {
-            timestamp: new Date().toISOString(),
-            connectionState: __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f"),
-        });
-    }
-    catch (error) {
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Disconnected);
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").logger.error(ensureError(error), {
-            context: {
-                name: 'HyperLiquidClientService.performDisconnection',
-                data: { action: 'outer_catch' },
-            },
-        });
-        throw error;
-    }
-}, _HyperLiquidClientService_updateConnectionState = function _HyperLiquidClientService_updateConnectionState(newState) {
-    const previousState = __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f");
-    const stateChanged = previousState !== newState;
-    const isReconnectionAttempt = newState === WebSocketConnectionState.Connecting &&
-        __classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionAttempt, "f") > 0;
-    __classPrivateFieldSet(this, _HyperLiquidClientService_connectionState, newState, "f");
-    // Reset reconnection attempt counter when successfully connected
-    if (newState === WebSocketConnectionState.Connected) {
-        __classPrivateFieldSet(this, _HyperLiquidClientService_reconnectionAttempt, 0, "f");
-    }
-    // Notify if state changed OR if this is a reconnection attempt (to update attempt count)
-    if (stateChanged || isReconnectionAttempt) {
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_notifyConnectionStateListeners).call(this);
-    }
-}, _HyperLiquidClientService_notifyConnectionStateListeners = function _HyperLiquidClientService_notifyConnectionStateListeners() {
-    __classPrivateFieldGet(this, _HyperLiquidClientService_connectionStateListeners, "f").forEach((listener) => {
-        try {
-            listener(__classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f"), __classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionAttempt, "f"));
-        }
-        catch {
-            // Ignore errors in listeners to prevent breaking other listeners
-        }
-    });
-}, _HyperLiquidClientService_handleConnectionDrop = 
-/**
- * Handle detected connection drop
- * Recreates WebSocket transport and notifies callback to restore subscriptions
- * Will give up after MAX_RECONNECTION_ATTEMPTS and mark status as disconnected
- */
-async function _HyperLiquidClientService_handleConnectionDrop() {
-    // Prevent multiple simultaneous reconnection attempts
-    if (__classPrivateFieldGet(this, _HyperLiquidClientService_isReconnecting, "f")) {
-        return;
-    }
-    __classPrivateFieldSet(this, _HyperLiquidClientService_isReconnecting, true, "f");
-    // Increment reconnection attempt counter
-    __classPrivateFieldSet(this, _HyperLiquidClientService_reconnectionAttempt, __classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionAttempt, "f") + 1, "f");
-    // Check if we've exceeded max retry attempts
-    if (__classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionAttempt, "f") > MAX_RECONNECTION_ATTEMPTS) {
-        __classPrivateFieldSet(this, _HyperLiquidClientService_isReconnecting, false, "f");
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Disconnected);
-        return;
-    }
-    try {
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Connecting);
-        // Close existing WebSocket transport and clear references
-        // so createTransports() will create fresh ones
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f")) {
-            try {
-                await __classPrivateFieldGet(this, _HyperLiquidClientService_wsTransport, "f").close();
-            }
-            catch {
-                // Ignore errors during close - transport may already be dead
-            }
-        }
-        __classPrivateFieldSet(this, _HyperLiquidClientService_wsTransport, undefined, "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_httpTransport, undefined, "f");
-        // Recreate WebSocket transport - returns the new transport for type safety
-        const newWsTransport = __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_createTransports).call(this);
-        // Recreate clients that use WebSocket transport
-        __classPrivateFieldSet(this, _HyperLiquidClientService_infoClient, new hyperliquid_1.InfoClient({ transport: newWsTransport }), "f");
-        __classPrivateFieldSet(this, _HyperLiquidClientService_subscriptionClient, new hyperliquid_1.SubscriptionClient({
-            transport: newWsTransport,
-        }), "f");
-        await newWsTransport.ready();
-        __classPrivateFieldGet(this, _HyperLiquidClientService_deps, "f").debugLogger.log('HyperLiquid: Transport ready, restoring subscriptions', { timestamp: new Date().toISOString() });
-        // NOW safe to restore subscriptions
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_onReconnectCallback, "f")) {
-            await __classPrivateFieldGet(this, _HyperLiquidClientService_onReconnectCallback, "f").call(this);
-        }
-        // Cancel any pending retry timeout from previous failed attempts
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionRetryTimeout, "f")) {
-            clearTimeout(__classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionRetryTimeout, "f"));
-            __classPrivateFieldSet(this, _HyperLiquidClientService_reconnectionRetryTimeout, null, "f");
-        }
-        __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Connected);
-        __classPrivateFieldSet(this, _HyperLiquidClientService_isReconnecting, false, "f");
-    }
-    catch {
-        // Reset flag before scheduling retry so the next attempt can proceed
-        __classPrivateFieldSet(this, _HyperLiquidClientService_isReconnecting, false, "f");
-        // Check if we've exceeded max retry attempts
-        if (__classPrivateFieldGet(this, _HyperLiquidClientService_reconnectionAttempt, "f") >= MAX_RECONNECTION_ATTEMPTS) {
-            __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_updateConnectionState).call(this, WebSocketConnectionState.Disconnected);
-            return;
-        }
-        // Reconnection failed - schedule a retry after a delay
-        // Store timeout reference so it can be cancelled on intentional disconnect
-        __classPrivateFieldSet(this, _HyperLiquidClientService_reconnectionRetryTimeout, setTimeout(() => {
-            __classPrivateFieldSet(this, _HyperLiquidClientService_reconnectionRetryTimeout, null, "f"); // Clear reference after execution
-            // Only retry if we haven't been intentionally disconnected
-            // and no manual reconnect() is already in progress
-            // Note: State may be CONNECTING or DISCONNECTED (if terminate event fired during reconnect)
-            if ((__classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f") === WebSocketConnectionState.Connecting ||
-                __classPrivateFieldGet(this, _HyperLiquidClientService_connectionState, "f") === WebSocketConnectionState.Disconnected) &&
-                !__classPrivateFieldGet(this, _HyperLiquidClientService_disconnectionPromise, "f") &&
-                !__classPrivateFieldGet(this, _HyperLiquidClientService_isReconnecting, "f")) {
-                __classPrivateFieldGet(this, _HyperLiquidClientService_instances, "m", _HyperLiquidClientService_handleConnectionDrop).call(this).catch(() => {
-                    // Errors are handled internally in handleConnectionDrop
-                });
-            }
-        }, perpsConfig_1.PERPS_CONSTANTS.ReconnectionRetryDelayMs), "f");
-    }
-};
-//# sourceMappingURL=HyperLiquidClientService.cjs.map