@metamask-previews/perps-controller 15.1.0-preview-6b7c25c → 15.1.0-preview-00a181c

package/dist/aggregation/SubscriptionMultiplexer.cjs

@@ -42,7 +42,7 @@ const errorUtils_js_1 = require("../utils/errorUtils.cjs");
  *   symbols: ['BTC', 'ETH'],
  *   providers: [
  *     ['hyperliquid', hlProvider],
- *     ['myx', myxProvider],
+ *     ['lighter', lighterProvider],
  *   ],
  *   callback: (prices) => {
  *     // prices have providerId injected

package/dist/aggregation/SubscriptionMultiplexer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"SubscriptionMultiplexer.cjs","sourceRoot":"","sources":["../../src/aggregation/SubscriptionMultiplexer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SubscriptionMultiplexer - Manages WebSocket subscriptions across multiple providers\n *\n * Responsibilities:\n * - Manage subscriptions to multiple providers simultaneously\n * - Tag all updates with providerId so UI can differentiate sources\n * - Support aggregation modes: 'merge' (all prices) or 'best_price' (best price per symbol)\n * - Cache latest updates per provider per symbol for aggregation\n */\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type {\n  PerpsProviderType,\n  PerpsProvider,\n  PerpsLogger,\n  PriceUpdate,\n  Position,\n  OrderFill,\n  Order,\n  AccountState,\n  SubscribePricesParams,\n  SubscribePositionsParams,\n  SubscribeOrderFillsParams,\n  SubscribeOrdersParams,\n  SubscribeAccountParams,\n} from '../types/index.js';\nimport { ensureError } from '../utils/errorUtils.js';\n\n/**\n * Options for constructing SubscriptionMultiplexer\n */\nexport type SubscriptionMultiplexerOptions = {\n  /** Optional logger for error reporting (e.g., Sentry) */\n  logger?: PerpsLogger;\n};\n\n/**\n * Aggregation mode for price subscriptions\n */\nexport type PriceAggregationMode = 'merge' | 'best_price';\n\n/**\n * Parameters for multiplexed price subscriptions\n */\nexport type MultiplexedPricesParams = {\n  /** Symbols to subscribe to */\n  symbols: string[];\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated price updates */\n  callback: (prices: PriceUpdate[]) => void;\n  /** Aggregation mode: 'merge' returns all prices, 'best_price' returns best per symbol */\n  aggregationMode?: PriceAggregationMode;\n  /** Optional throttle in milliseconds */\n  throttleMs?: number;\n  /** Include order book data */\n  includeOrderBook?: boolean;\n  /** Include market data (funding, OI, volume) */\n  includeMarketData?: boolean;\n};\n\n/**\n * Parameters for multiplexed position subscriptions\n */\nexport type MultiplexedPositionsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated position updates */\n  callback: (positions: Position[]) => void;\n};\n\n/**\n * Parameters for multiplexed order fill subscriptions\n */\nexport type MultiplexedOrderFillsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order fill updates */\n  callback: (fills: OrderFill[], isSnapshot?: boolean) => void;\n};\n\n/**\n * Parameters for multiplexed order subscriptions\n */\nexport type MultiplexedOrdersParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order updates */\n  callback: (orders: Order[]) => void;\n};\n\n/**\n * Parameters for multiplexed account subscriptions\n */\nexport type MultiplexedAccountParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive account updates (one per provider) */\n  callback: (accounts: AccountState[]) => void;\n};\n\n/**\n * SubscriptionMultiplexer manages real-time data subscriptions across\n * multiple perps providers.\n *\n * Key features:\n * - Subscribes to all providers simultaneously\n * - Tags all updates with source providerId\n * - Caches latest values for aggregation\n * - Supports different aggregation modes for prices\n *\n * @example\n * ```typescript\n * const mux = new SubscriptionMultiplexer();\n *\n * const unsubscribe = mux.subscribeToPrices({\n *   symbols: ['BTC', 'ETH'],\n *   providers: [\n *     ['hyperliquid', hlProvider],\n *     ['myx', myxProvider],\n *   ],\n *   callback: (prices) => {\n *     // prices have providerId injected\n *     prices.forEach(p => console.log(`${p.providerId}: ${p.symbol} = ${p.price}`));\n *   },\n *   aggregationMode: 'merge',\n * });\n *\n * // Later: clean up\n * unsubscribe();\n * ```\n */\nexport class SubscriptionMultiplexer {\n  /**\n   * Optional logger for error reporting\n   */\n  readonly #logger?: PerpsLogger;\n\n  /**\n   * Cache of latest prices per symbol per provider\n   * Map<symbol, Map<providerId, PriceUpdate>>\n   */\n  readonly #priceCache: Map<string, Map<PerpsProviderType, PriceUpdate>> =\n    new Map();\n\n  /**\n   * Cache of latest positions per provider\n   * Map<providerId, Position[]>\n   */\n  readonly #positionCache: Map<PerpsProviderType, Position[]> = new Map();\n\n  /**\n   * Cache of latest orders per provider\n   * Map<providerId, Order[]>\n   */\n  readonly #orderCache: Map<PerpsProviderType, Order[]> = new Map();\n\n  /**\n   * Cache of latest account state per provider\n   * Map<providerId, AccountState>\n   */\n  readonly #accountCache: Map<PerpsProviderType, AccountState> = new Map();\n\n  /**\n   * Create a new SubscriptionMultiplexer.\n   *\n   * @param options - Optional configuration including logger for error reporting\n   */\n  constructor(options?: SubscriptionMultiplexerOptions) {\n    this.#logger = options?.logger;\n  }\n\n  /**\n   * Subscribe to price updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPrices(params: MultiplexedPricesParams): () => void {\n    const {\n      symbols,\n      providers,\n      callback,\n      aggregationMode = 'merge',\n      throttleMs,\n      includeOrderBook,\n      includeMarketData,\n    } = params;\n\n    const unsubscribers: (() => void)[] = [];\n\n    // Subscribe to each provider with defensive error handling\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePricesParams = {\n          symbols,\n          callback: (updates) => {\n            // Tag and cache each update\n            updates.forEach((update) => {\n              const taggedUpdate: PriceUpdate = { ...update, providerId };\n\n              // Initialize symbol cache if needed\n              if (!this.#priceCache.has(update.symbol)) {\n                this.#priceCache.set(update.symbol, new Map());\n              }\n              const symbolCache = this.#priceCache.get(update.symbol);\n              if (symbolCache) {\n                symbolCache.set(providerId, taggedUpdate);\n              }\n            });\n\n            // Aggregate and emit based on mode\n            const aggregated = this.#aggregatePrices(symbols, aggregationMode);\n            callback(aggregated);\n          },\n          throttleMs,\n          includeOrderBook,\n          includeMarketData,\n        };\n\n        const unsub = provider.subscribeToPrices(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        // Log to Sentry before cleanup\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPrices'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPrices',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n\n        // Clean up any subscriptions created before the failure\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    // Return combined unsubscribe function\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Optionally clear cache for these symbols\n      symbols.forEach((symbol) => {\n        this.#priceCache.delete(symbol);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to position updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPositions(params: MultiplexedPositionsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePositionsParams = {\n          callback: (positions) => {\n            // Tag positions with providerId and cache\n            const taggedPositions = positions.map((pos) => ({\n              ...pos,\n              providerId,\n            }));\n            this.#positionCache.set(providerId, taggedPositions);\n\n            // Emit aggregated positions from all providers\n            const allPositions = this.#aggregatePositions();\n            callback(allPositions);\n          },\n        };\n\n        const unsub = provider.subscribeToPositions(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPositions'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPositions',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Clear position cache for these providers\n      providers.forEach(([providerId]) => {\n        this.#positionCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to order fill updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrderFills(params: MultiplexedOrderFillsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrderFillsParams = {\n          callback: (fills, isSnapshot) => {\n            // Tag fills with providerId\n            const taggedFills = fills.map((fill) => ({\n              ...fill,\n              providerId,\n            }));\n\n            // For fills, we don't aggregate - emit immediately with tags\n            callback(taggedFills, isSnapshot);\n          },\n        };\n\n        const unsub = provider.subscribeToOrderFills(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrderFills'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrderFills',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n    };\n  }\n\n  /**\n   * Subscribe to order updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrders(params: MultiplexedOrdersParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrdersParams = {\n          callback: (orders) => {\n            // Tag orders with providerId and cache\n            const taggedOrders = orders.map((order) => ({\n              ...order,\n              providerId,\n            }));\n            this.#orderCache.set(providerId, taggedOrders);\n\n            // Emit aggregated orders from all providers\n            const allOrders = this.#aggregateOrders();\n            callback(allOrders);\n          },\n        };\n\n        const unsub = provider.subscribeToOrders(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrders'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrders',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#orderCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to account updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToAccount(params: MultiplexedAccountParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeAccountParams = {\n          callback: (account) => {\n            if (account === null) {\n              this.#accountCache.delete(providerId);\n            } else {\n              // Tag account with providerId and cache\n              const taggedAccount: AccountState = {\n                ...account,\n                providerId,\n              };\n              this.#accountCache.set(providerId, taggedAccount);\n            }\n\n            // Emit all cached account states\n            const allAccounts = Array.from(this.#accountCache.values());\n            callback(allAccounts);\n          },\n        };\n\n        const unsub = provider.subscribeToAccount(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToAccount'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToAccount',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#accountCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Aggregate cached prices based on mode.\n   *\n   * @param symbols - Symbols to include in result\n   * @param mode - Aggregation mode\n   * @returns Aggregated price updates\n   */\n  #aggregatePrices(\n    symbols: string[],\n    mode: PriceAggregationMode,\n  ): PriceUpdate[] {\n    const result: PriceUpdate[] = [];\n\n    symbols.forEach((symbol) => {\n      const providerPrices = this.#priceCache.get(symbol);\n      if (!providerPrices || providerPrices.size === 0) {\n        return;\n      }\n\n      if (mode === 'merge') {\n        // Return all prices (one per provider)\n        providerPrices.forEach((price) => {\n          result.push(price);\n        });\n      } else {\n        // 'best_price': Return the best price across providers\n        const best = this.#findBestPrice(providerPrices);\n        if (best) {\n          result.push(best);\n        }\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Find the best price from multiple provider prices.\n   * \"Best\" is defined as the price with the smallest spread.\n   *\n   * @param providerPrices - Map of provider prices for a symbol\n   * @returns Best price update or undefined\n   */\n  #findBestPrice(\n    providerPrices: Map<PerpsProviderType, PriceUpdate>,\n  ): PriceUpdate | undefined {\n    let bestPrice: PriceUpdate | undefined;\n    let smallestSpread = Infinity;\n\n    providerPrices.forEach((price) => {\n      if (price.spread === undefined) {\n        // No spread info - just use the first one\n        bestPrice ??= price;\n      } else {\n        // If spread is available, use it to determine best\n        const spreadValue = parseFloat(price.spread);\n        if (!isNaN(spreadValue) && spreadValue < smallestSpread) {\n          smallestSpread = spreadValue;\n          bestPrice = price;\n        }\n      }\n    });\n\n    return bestPrice;\n  }\n\n  /**\n   * Aggregate positions from all providers.\n   *\n   * @returns All cached positions\n   */\n  #aggregatePositions(): Position[] {\n    const allPositions: Position[] = [];\n    this.#positionCache.forEach((positions) => {\n      allPositions.push(...positions);\n    });\n    return allPositions;\n  }\n\n  /**\n   * Aggregate orders from all providers.\n   *\n   * @returns All cached orders\n   */\n  #aggregateOrders(): Order[] {\n    const allOrders: Order[] = [];\n    this.#orderCache.forEach((orders) => {\n      allOrders.push(...orders);\n    });\n    return allOrders;\n  }\n\n  /**\n   * Clear all cached data.\n   */\n  clearCache(): void {\n    this.#priceCache.clear();\n    this.#positionCache.clear();\n    this.#orderCache.clear();\n    this.#accountCache.clear();\n  }\n\n  /**\n   * Get cached price for a symbol from a specific provider.\n   *\n   * @param symbol - Market symbol\n   * @param providerId - Provider ID\n   * @returns Cached price update or undefined\n   */\n  getCachedPrice(\n    symbol: string,\n    providerId: PerpsProviderType,\n  ): PriceUpdate | undefined {\n    return this.#priceCache.get(symbol)?.get(providerId);\n  }\n\n  /**\n   * Get all cached prices for a symbol.\n   *\n   * @param symbol - Market symbol\n   * @returns Map of provider ID to price update\n   */\n  getAllCachedPricesForSymbol(\n    symbol: string,\n  ): Map<PerpsProviderType, PriceUpdate> | undefined {\n    return this.#priceCache.get(symbol);\n  }\n}\n"]}
+{"version":3,"file":"SubscriptionMultiplexer.cjs","sourceRoot":"","sources":["../../src/aggregation/SubscriptionMultiplexer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SubscriptionMultiplexer - Manages WebSocket subscriptions across multiple providers\n *\n * Responsibilities:\n * - Manage subscriptions to multiple providers simultaneously\n * - Tag all updates with providerId so UI can differentiate sources\n * - Support aggregation modes: 'merge' (all prices) or 'best_price' (best price per symbol)\n * - Cache latest updates per provider per symbol for aggregation\n */\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type {\n  PerpsProviderType,\n  PerpsProvider,\n  PerpsLogger,\n  PriceUpdate,\n  Position,\n  OrderFill,\n  Order,\n  AccountState,\n  SubscribePricesParams,\n  SubscribePositionsParams,\n  SubscribeOrderFillsParams,\n  SubscribeOrdersParams,\n  SubscribeAccountParams,\n} from '../types/index.js';\nimport { ensureError } from '../utils/errorUtils.js';\n\n/**\n * Options for constructing SubscriptionMultiplexer\n */\nexport type SubscriptionMultiplexerOptions = {\n  /** Optional logger for error reporting (e.g., Sentry) */\n  logger?: PerpsLogger;\n};\n\n/**\n * Aggregation mode for price subscriptions\n */\nexport type PriceAggregationMode = 'merge' | 'best_price';\n\n/**\n * Parameters for multiplexed price subscriptions\n */\nexport type MultiplexedPricesParams = {\n  /** Symbols to subscribe to */\n  symbols: string[];\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated price updates */\n  callback: (prices: PriceUpdate[]) => void;\n  /** Aggregation mode: 'merge' returns all prices, 'best_price' returns best per symbol */\n  aggregationMode?: PriceAggregationMode;\n  /** Optional throttle in milliseconds */\n  throttleMs?: number;\n  /** Include order book data */\n  includeOrderBook?: boolean;\n  /** Include market data (funding, OI, volume) */\n  includeMarketData?: boolean;\n};\n\n/**\n * Parameters for multiplexed position subscriptions\n */\nexport type MultiplexedPositionsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated position updates */\n  callback: (positions: Position[]) => void;\n};\n\n/**\n * Parameters for multiplexed order fill subscriptions\n */\nexport type MultiplexedOrderFillsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order fill updates */\n  callback: (fills: OrderFill[], isSnapshot?: boolean) => void;\n};\n\n/**\n * Parameters for multiplexed order subscriptions\n */\nexport type MultiplexedOrdersParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order updates */\n  callback: (orders: Order[]) => void;\n};\n\n/**\n * Parameters for multiplexed account subscriptions\n */\nexport type MultiplexedAccountParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive account updates (one per provider) */\n  callback: (accounts: AccountState[]) => void;\n};\n\n/**\n * SubscriptionMultiplexer manages real-time data subscriptions across\n * multiple perps providers.\n *\n * Key features:\n * - Subscribes to all providers simultaneously\n * - Tags all updates with source providerId\n * - Caches latest values for aggregation\n * - Supports different aggregation modes for prices\n *\n * @example\n * ```typescript\n * const mux = new SubscriptionMultiplexer();\n *\n * const unsubscribe = mux.subscribeToPrices({\n *   symbols: ['BTC', 'ETH'],\n *   providers: [\n *     ['hyperliquid', hlProvider],\n *     ['lighter', lighterProvider],\n *   ],\n *   callback: (prices) => {\n *     // prices have providerId injected\n *     prices.forEach(p => console.log(`${p.providerId}: ${p.symbol} = ${p.price}`));\n *   },\n *   aggregationMode: 'merge',\n * });\n *\n * // Later: clean up\n * unsubscribe();\n * ```\n */\nexport class SubscriptionMultiplexer {\n  /**\n   * Optional logger for error reporting\n   */\n  readonly #logger?: PerpsLogger;\n\n  /**\n   * Cache of latest prices per symbol per provider\n   * Map<symbol, Map<providerId, PriceUpdate>>\n   */\n  readonly #priceCache: Map<string, Map<PerpsProviderType, PriceUpdate>> =\n    new Map();\n\n  /**\n   * Cache of latest positions per provider\n   * Map<providerId, Position[]>\n   */\n  readonly #positionCache: Map<PerpsProviderType, Position[]> = new Map();\n\n  /**\n   * Cache of latest orders per provider\n   * Map<providerId, Order[]>\n   */\n  readonly #orderCache: Map<PerpsProviderType, Order[]> = new Map();\n\n  /**\n   * Cache of latest account state per provider\n   * Map<providerId, AccountState>\n   */\n  readonly #accountCache: Map<PerpsProviderType, AccountState> = new Map();\n\n  /**\n   * Create a new SubscriptionMultiplexer.\n   *\n   * @param options - Optional configuration including logger for error reporting\n   */\n  constructor(options?: SubscriptionMultiplexerOptions) {\n    this.#logger = options?.logger;\n  }\n\n  /**\n   * Subscribe to price updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPrices(params: MultiplexedPricesParams): () => void {\n    const {\n      symbols,\n      providers,\n      callback,\n      aggregationMode = 'merge',\n      throttleMs,\n      includeOrderBook,\n      includeMarketData,\n    } = params;\n\n    const unsubscribers: (() => void)[] = [];\n\n    // Subscribe to each provider with defensive error handling\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePricesParams = {\n          symbols,\n          callback: (updates) => {\n            // Tag and cache each update\n            updates.forEach((update) => {\n              const taggedUpdate: PriceUpdate = { ...update, providerId };\n\n              // Initialize symbol cache if needed\n              if (!this.#priceCache.has(update.symbol)) {\n                this.#priceCache.set(update.symbol, new Map());\n              }\n              const symbolCache = this.#priceCache.get(update.symbol);\n              if (symbolCache) {\n                symbolCache.set(providerId, taggedUpdate);\n              }\n            });\n\n            // Aggregate and emit based on mode\n            const aggregated = this.#aggregatePrices(symbols, aggregationMode);\n            callback(aggregated);\n          },\n          throttleMs,\n          includeOrderBook,\n          includeMarketData,\n        };\n\n        const unsub = provider.subscribeToPrices(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        // Log to Sentry before cleanup\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPrices'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPrices',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n\n        // Clean up any subscriptions created before the failure\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    // Return combined unsubscribe function\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Optionally clear cache for these symbols\n      symbols.forEach((symbol) => {\n        this.#priceCache.delete(symbol);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to position updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPositions(params: MultiplexedPositionsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePositionsParams = {\n          callback: (positions) => {\n            // Tag positions with providerId and cache\n            const taggedPositions = positions.map((pos) => ({\n              ...pos,\n              providerId,\n            }));\n            this.#positionCache.set(providerId, taggedPositions);\n\n            // Emit aggregated positions from all providers\n            const allPositions = this.#aggregatePositions();\n            callback(allPositions);\n          },\n        };\n\n        const unsub = provider.subscribeToPositions(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPositions'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPositions',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Clear position cache for these providers\n      providers.forEach(([providerId]) => {\n        this.#positionCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to order fill updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrderFills(params: MultiplexedOrderFillsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrderFillsParams = {\n          callback: (fills, isSnapshot) => {\n            // Tag fills with providerId\n            const taggedFills = fills.map((fill) => ({\n              ...fill,\n              providerId,\n            }));\n\n            // For fills, we don't aggregate - emit immediately with tags\n            callback(taggedFills, isSnapshot);\n          },\n        };\n\n        const unsub = provider.subscribeToOrderFills(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrderFills'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrderFills',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n    };\n  }\n\n  /**\n   * Subscribe to order updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrders(params: MultiplexedOrdersParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrdersParams = {\n          callback: (orders) => {\n            // Tag orders with providerId and cache\n            const taggedOrders = orders.map((order) => ({\n              ...order,\n              providerId,\n            }));\n            this.#orderCache.set(providerId, taggedOrders);\n\n            // Emit aggregated orders from all providers\n            const allOrders = this.#aggregateOrders();\n            callback(allOrders);\n          },\n        };\n\n        const unsub = provider.subscribeToOrders(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrders'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrders',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#orderCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to account updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToAccount(params: MultiplexedAccountParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeAccountParams = {\n          callback: (account) => {\n            if (account === null) {\n              this.#accountCache.delete(providerId);\n            } else {\n              // Tag account with providerId and cache\n              const taggedAccount: AccountState = {\n                ...account,\n                providerId,\n              };\n              this.#accountCache.set(providerId, taggedAccount);\n            }\n\n            // Emit all cached account states\n            const allAccounts = Array.from(this.#accountCache.values());\n            callback(allAccounts);\n          },\n        };\n\n        const unsub = provider.subscribeToAccount(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToAccount'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToAccount',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#accountCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Aggregate cached prices based on mode.\n   *\n   * @param symbols - Symbols to include in result\n   * @param mode - Aggregation mode\n   * @returns Aggregated price updates\n   */\n  #aggregatePrices(\n    symbols: string[],\n    mode: PriceAggregationMode,\n  ): PriceUpdate[] {\n    const result: PriceUpdate[] = [];\n\n    symbols.forEach((symbol) => {\n      const providerPrices = this.#priceCache.get(symbol);\n      if (!providerPrices || providerPrices.size === 0) {\n        return;\n      }\n\n      if (mode === 'merge') {\n        // Return all prices (one per provider)\n        providerPrices.forEach((price) => {\n          result.push(price);\n        });\n      } else {\n        // 'best_price': Return the best price across providers\n        const best = this.#findBestPrice(providerPrices);\n        if (best) {\n          result.push(best);\n        }\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Find the best price from multiple provider prices.\n   * \"Best\" is defined as the price with the smallest spread.\n   *\n   * @param providerPrices - Map of provider prices for a symbol\n   * @returns Best price update or undefined\n   */\n  #findBestPrice(\n    providerPrices: Map<PerpsProviderType, PriceUpdate>,\n  ): PriceUpdate | undefined {\n    let bestPrice: PriceUpdate | undefined;\n    let smallestSpread = Infinity;\n\n    providerPrices.forEach((price) => {\n      if (price.spread === undefined) {\n        // No spread info - just use the first one\n        bestPrice ??= price;\n      } else {\n        // If spread is available, use it to determine best\n        const spreadValue = parseFloat(price.spread);\n        if (!isNaN(spreadValue) && spreadValue < smallestSpread) {\n          smallestSpread = spreadValue;\n          bestPrice = price;\n        }\n      }\n    });\n\n    return bestPrice;\n  }\n\n  /**\n   * Aggregate positions from all providers.\n   *\n   * @returns All cached positions\n   */\n  #aggregatePositions(): Position[] {\n    const allPositions: Position[] = [];\n    this.#positionCache.forEach((positions) => {\n      allPositions.push(...positions);\n    });\n    return allPositions;\n  }\n\n  /**\n   * Aggregate orders from all providers.\n   *\n   * @returns All cached orders\n   */\n  #aggregateOrders(): Order[] {\n    const allOrders: Order[] = [];\n    this.#orderCache.forEach((orders) => {\n      allOrders.push(...orders);\n    });\n    return allOrders;\n  }\n\n  /**\n   * Clear all cached data.\n   */\n  clearCache(): void {\n    this.#priceCache.clear();\n    this.#positionCache.clear();\n    this.#orderCache.clear();\n    this.#accountCache.clear();\n  }\n\n  /**\n   * Get cached price for a symbol from a specific provider.\n   *\n   * @param symbol - Market symbol\n   * @param providerId - Provider ID\n   * @returns Cached price update or undefined\n   */\n  getCachedPrice(\n    symbol: string,\n    providerId: PerpsProviderType,\n  ): PriceUpdate | undefined {\n    return this.#priceCache.get(symbol)?.get(providerId);\n  }\n\n  /**\n   * Get all cached prices for a symbol.\n   *\n   * @param symbol - Market symbol\n   * @returns Map of provider ID to price update\n   */\n  getAllCachedPricesForSymbol(\n    symbol: string,\n  ): Map<PerpsProviderType, PriceUpdate> | undefined {\n    return this.#priceCache.get(symbol);\n  }\n}\n"]}

package/dist/aggregation/SubscriptionMultiplexer.d.cts

@@ -92,7 +92,7 @@ export type MultiplexedAccountParams = {
  *   symbols: ['BTC', 'ETH'],
  *   providers: [
  *     ['hyperliquid', hlProvider],
- *     ['myx', myxProvider],
+ *     ['lighter', lighterProvider],
  *   ],
  *   callback: (prices) => {
  *     // prices have providerId injected

package/dist/aggregation/SubscriptionMultiplexer.d.mts

@@ -92,7 +92,7 @@ export type MultiplexedAccountParams = {
  *   symbols: ['BTC', 'ETH'],
  *   providers: [
  *     ['hyperliquid', hlProvider],
- *     ['myx', myxProvider],
+ *     ['lighter', lighterProvider],
  *   ],
  *   callback: (prices) => {
  *     // prices have providerId injected

package/dist/aggregation/SubscriptionMultiplexer.mjs

@@ -39,7 +39,7 @@ import { ensureError } from "../utils/errorUtils.mjs";
  *   symbols: ['BTC', 'ETH'],
  *   providers: [
  *     ['hyperliquid', hlProvider],
- *     ['myx', myxProvider],
+ *     ['lighter', lighterProvider],
  *   ],
  *   callback: (prices) => {
  *     // prices have providerId injected

package/dist/aggregation/SubscriptionMultiplexer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"SubscriptionMultiplexer.mjs","sourceRoot":"","sources":["../../src/aggregation/SubscriptionMultiplexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;;;;;;;;;;;;AAEH,OAAO,EAAE,eAAe,EAAE,qCAAoC;AAgB9D,OAAO,EAAE,WAAW,EAAE,gCAA+B;AA2ErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,uBAAuB;IA+BlC;;;;OAIG;IACH,YAAY,OAAwC;;QAnCpD;;WAEG;QACM,kDAAsB;QAE/B;;;WAGG;QACM,8CACP,IAAI,GAAG,EAAE,EAAC;QAEZ;;;WAGG;QACM,iDAAqD,IAAI,GAAG,EAAE,EAAC;QAExE;;;WAGG;QACM,8CAA+C,IAAI,GAAG,EAAE,EAAC;QAElE;;;WAGG;QACM,gDAAsD,IAAI,GAAG,EAAE,EAAC;QAQvE,uBAAA,IAAI,mCAAW,OAAO,EAAE,MAAM,MAAA,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,MAA+B;QAC/C,MAAM,EACJ,OAAO,EACP,SAAS,EACT,QAAQ,EACR,eAAe,GAAG,OAAO,EACzB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,GAAG,MAAM,CAAC;QAEX,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,2DAA2D;QAC3D,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,eAAe,GAA0B;oBAC7C,OAAO;oBACP,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;wBACpB,4BAA4B;wBAC5B,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;4BACzB,MAAM,YAAY,GAAgB,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC;4BAE5D,oCAAoC;4BACpC,IAAI,CAAC,uBAAA,IAAI,2CAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gCACzC,uBAAA,IAAI,2CAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;4BACjD,CAAC;4BACD,MAAM,WAAW,GAAG,uBAAA,IAAI,2CAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;4BACxD,IAAI,WAAW,EAAE,CAAC;gCAChB,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;4BAC5C,CAAC;wBACH,CAAC,CAAC,CAAC;wBAEH,mCAAmC;wBACnC,MAAM,UAAU,GAAG,uBAAA,IAAI,oFAAiB,MAArB,IAAI,EAAkB,OAAO,EAAE,eAAe,CAAC,CAAC;wBACnE,QAAQ,CAAC,UAAU,CAAC,CAAC;oBACvB,CAAC;oBACD,UAAU;oBACV,gBAAgB;oBAChB,iBAAiB;iBAClB,CAAC;gBAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;gBAC1D,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,+BAA+B;gBAC/B,uBAAA,IAAI,uCAAQ,EAAE,KAAK,CACjB,WAAW,CAAC,KAAK,EAAE,2CAA2C,CAAC,EAC/D;oBACE,IAAI,EAAE;wBACJ,OAAO,EAAE,eAAe,CAAC,WAAW;wBACpC,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,mBAAmB;qBAC5B;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,yBAAyB;wBAC/B,IAAI,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,MAAM,EAAE;qBAChD;iBACF,CACF,CAAC;gBAEF,wDAAwD;gBACxD,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1C,2CAA2C;YAC3C,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBACzB,uBAAA,IAAI,2CAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,MAAkC;QACrD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,eAAe,GAA6B;oBAChD,QAAQ,EAAE,CAAC,SAAS,EAAE,EAAE;wBACtB,0CAA0C;wBAC1C,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;4BAC9C,GAAG,GAAG;4BACN,UAAU;yBACX,CAAC,CAAC,CAAC;wBACJ,uBAAA,IAAI,8CAAe,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;wBAErD,+CAA+C;wBAC/C,MAAM,YAAY,GAAG,uBAAA,IAAI,uFAAoB,MAAxB,IAAI,CAAsB,CAAC;wBAChD,QAAQ,CAAC,YAAY,CAAC,CAAC;oBACzB,CAAC;iBACF,CAAC;gBAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;gBAC7D,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,uBAAA,IAAI,uCAAQ,EAAE,KAAK,CACjB,WAAW,CAAC,KAAK,EAAE,8CAA8C,CAAC,EAClE;oBACE,IAAI,EAAE;wBACJ,OAAO,EAAE,eAAe,CAAC,WAAW;wBACpC,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,sBAAsB;qBAC/B;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,yBAAyB;wBAC/B,IAAI,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,MAAM,EAAE;qBAChD;iBACF,CACF,CAAC;gBACF,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1C,2CAA2C;YAC3C,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE;gBACjC,uBAAA,IAAI,8CAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,MAAmC;QACvD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,eAAe,GAA8B;oBACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;wBAC9B,4BAA4B;wBAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BACvC,GAAG,IAAI;4BACP,UAAU;yBACX,CAAC,CAAC,CAAC;wBAEJ,6DAA6D;wBAC7D,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;oBACpC,CAAC;iBACF,CAAC;gBAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;gBAC9D,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,uBAAA,IAAI,uCAAQ,EAAE,KAAK,CACjB,WAAW,CAAC,KAAK,EAAE,+CAA+C,CAAC,EACnE;oBACE,IAAI,EAAE;wBACJ,OAAO,EAAE,eAAe,CAAC,WAAW;wBACpC,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,uBAAuB;qBAChC;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,yBAAyB;wBAC/B,IAAI,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,MAAM,EAAE;qBAChD;iBACF,CACF,CAAC;gBACF,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,MAA+B;QAC/C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,eAAe,GAA0B;oBAC7C,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;wBACnB,uCAAuC;wBACvC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;4BAC1C,GAAG,KAAK;4BACR,UAAU;yBACX,CAAC,CAAC,CAAC;wBACJ,uBAAA,IAAI,2CAAY,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;wBAE/C,4CAA4C;wBAC5C,MAAM,SAAS,GAAG,uBAAA,IAAI,oFAAiB,MAArB,IAAI,CAAmB,CAAC;wBAC1C,QAAQ,CAAC,SAAS,CAAC,CAAC;oBACtB,CAAC;iBACF,CAAC;gBAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;gBAC1D,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,uBAAA,IAAI,uCAAQ,EAAE,KAAK,CACjB,WAAW,CAAC,KAAK,EAAE,2CAA2C,CAAC,EAC/D;oBACE,IAAI,EAAE;wBACJ,OAAO,EAAE,eAAe,CAAC,WAAW;wBACpC,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,mBAAmB;qBAC5B;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,yBAAyB;wBAC/B,IAAI,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,MAAM,EAAE;qBAChD;iBACF,CACF,CAAC;gBACF,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1C,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE;gBACjC,uBAAA,IAAI,2CAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,MAAgC;QACjD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,eAAe,GAA2B;oBAC9C,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;wBACpB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;4BACrB,uBAAA,IAAI,6CAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;wBACxC,CAAC;6BAAM,CAAC;4BACN,wCAAwC;4BACxC,MAAM,aAAa,GAAiB;gCAClC,GAAG,OAAO;gCACV,UAAU;6BACX,CAAC;4BACF,uBAAA,IAAI,6CAAc,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;wBACpD,CAAC;wBAED,iCAAiC;wBACjC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,6CAAc,CAAC,MAAM,EAAE,CAAC,CAAC;wBAC5D,QAAQ,CAAC,WAAW,CAAC,CAAC;oBACxB,CAAC;iBACF,CAAC;gBAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;gBAC3D,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,uBAAA,IAAI,uCAAQ,EAAE,KAAK,CACjB,WAAW,CAAC,KAAK,EAAE,4CAA4C,CAAC,EAChE;oBACE,IAAI,EAAE;wBACJ,OAAO,EAAE,eAAe,CAAC,WAAW;wBACpC,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,oBAAoB;qBAC7B;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,yBAAyB;wBAC/B,IAAI,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,MAAM,EAAE;qBAChD;iBACF,CACF,CAAC;gBACF,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1C,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE;gBACjC,uBAAA,IAAI,6CAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IA8FD;;OAEG;IACH,UAAU;QACR,uBAAA,IAAI,2CAAY,CAAC,KAAK,EAAE,CAAC;QACzB,uBAAA,IAAI,8CAAe,CAAC,KAAK,EAAE,CAAC;QAC5B,uBAAA,IAAI,2CAAY,CAAC,KAAK,EAAE,CAAC;QACzB,uBAAA,IAAI,6CAAc,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CACZ,MAAc,EACd,UAA6B;QAE7B,OAAO,uBAAA,IAAI,2CAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,2BAA2B,CACzB,MAAc;QAEd,OAAO,uBAAA,IAAI,2CAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACF;2ZAvHG,OAAiB,EACjB,IAA0B;IAE1B,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,MAAM,cAAc,GAAG,uBAAA,IAAI,2CAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,uCAAuC;YACvC,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC/B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,uDAAuD;YACvD,MAAM,IAAI,GAAG,uBAAA,IAAI,kFAAe,MAAnB,IAAI,EAAgB,cAAc,CAAC,CAAC;YACjD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,2FAUC,cAAmD;IAEnD,IAAI,SAAkC,CAAC;IACvC,IAAI,cAAc,GAAG,QAAQ,CAAC;IAE9B,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,0CAA0C;YAC1C,SAAS,KAAT,SAAS,GAAK,KAAK,EAAC;QACtB,CAAC;aAAM,CAAC;YACN,mDAAmD;YACnD,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;gBACxD,cAAc,GAAG,WAAW,CAAC;gBAC7B,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;IAQC,MAAM,YAAY,GAAe,EAAE,CAAC;IACpC,uBAAA,IAAI,8CAAe,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACxC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,OAAO,YAAY,CAAC;AACtB,CAAC;IAQC,MAAM,SAAS,GAAY,EAAE,CAAC;IAC9B,uBAAA,IAAI,2CAAY,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * SubscriptionMultiplexer - Manages WebSocket subscriptions across multiple providers\n *\n * Responsibilities:\n * - Manage subscriptions to multiple providers simultaneously\n * - Tag all updates with providerId so UI can differentiate sources\n * - Support aggregation modes: 'merge' (all prices) or 'best_price' (best price per symbol)\n * - Cache latest updates per provider per symbol for aggregation\n */\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type {\n  PerpsProviderType,\n  PerpsProvider,\n  PerpsLogger,\n  PriceUpdate,\n  Position,\n  OrderFill,\n  Order,\n  AccountState,\n  SubscribePricesParams,\n  SubscribePositionsParams,\n  SubscribeOrderFillsParams,\n  SubscribeOrdersParams,\n  SubscribeAccountParams,\n} from '../types/index.js';\nimport { ensureError } from '../utils/errorUtils.js';\n\n/**\n * Options for constructing SubscriptionMultiplexer\n */\nexport type SubscriptionMultiplexerOptions = {\n  /** Optional logger for error reporting (e.g., Sentry) */\n  logger?: PerpsLogger;\n};\n\n/**\n * Aggregation mode for price subscriptions\n */\nexport type PriceAggregationMode = 'merge' | 'best_price';\n\n/**\n * Parameters for multiplexed price subscriptions\n */\nexport type MultiplexedPricesParams = {\n  /** Symbols to subscribe to */\n  symbols: string[];\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated price updates */\n  callback: (prices: PriceUpdate[]) => void;\n  /** Aggregation mode: 'merge' returns all prices, 'best_price' returns best per symbol */\n  aggregationMode?: PriceAggregationMode;\n  /** Optional throttle in milliseconds */\n  throttleMs?: number;\n  /** Include order book data */\n  includeOrderBook?: boolean;\n  /** Include market data (funding, OI, volume) */\n  includeMarketData?: boolean;\n};\n\n/**\n * Parameters for multiplexed position subscriptions\n */\nexport type MultiplexedPositionsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated position updates */\n  callback: (positions: Position[]) => void;\n};\n\n/**\n * Parameters for multiplexed order fill subscriptions\n */\nexport type MultiplexedOrderFillsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order fill updates */\n  callback: (fills: OrderFill[], isSnapshot?: boolean) => void;\n};\n\n/**\n * Parameters for multiplexed order subscriptions\n */\nexport type MultiplexedOrdersParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order updates */\n  callback: (orders: Order[]) => void;\n};\n\n/**\n * Parameters for multiplexed account subscriptions\n */\nexport type MultiplexedAccountParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive account updates (one per provider) */\n  callback: (accounts: AccountState[]) => void;\n};\n\n/**\n * SubscriptionMultiplexer manages real-time data subscriptions across\n * multiple perps providers.\n *\n * Key features:\n * - Subscribes to all providers simultaneously\n * - Tags all updates with source providerId\n * - Caches latest values for aggregation\n * - Supports different aggregation modes for prices\n *\n * @example\n * ```typescript\n * const mux = new SubscriptionMultiplexer();\n *\n * const unsubscribe = mux.subscribeToPrices({\n *   symbols: ['BTC', 'ETH'],\n *   providers: [\n *     ['hyperliquid', hlProvider],\n *     ['myx', myxProvider],\n *   ],\n *   callback: (prices) => {\n *     // prices have providerId injected\n *     prices.forEach(p => console.log(`${p.providerId}: ${p.symbol} = ${p.price}`));\n *   },\n *   aggregationMode: 'merge',\n * });\n *\n * // Later: clean up\n * unsubscribe();\n * ```\n */\nexport class SubscriptionMultiplexer {\n  /**\n   * Optional logger for error reporting\n   */\n  readonly #logger?: PerpsLogger;\n\n  /**\n   * Cache of latest prices per symbol per provider\n   * Map<symbol, Map<providerId, PriceUpdate>>\n   */\n  readonly #priceCache: Map<string, Map<PerpsProviderType, PriceUpdate>> =\n    new Map();\n\n  /**\n   * Cache of latest positions per provider\n   * Map<providerId, Position[]>\n   */\n  readonly #positionCache: Map<PerpsProviderType, Position[]> = new Map();\n\n  /**\n   * Cache of latest orders per provider\n   * Map<providerId, Order[]>\n   */\n  readonly #orderCache: Map<PerpsProviderType, Order[]> = new Map();\n\n  /**\n   * Cache of latest account state per provider\n   * Map<providerId, AccountState>\n   */\n  readonly #accountCache: Map<PerpsProviderType, AccountState> = new Map();\n\n  /**\n   * Create a new SubscriptionMultiplexer.\n   *\n   * @param options - Optional configuration including logger for error reporting\n   */\n  constructor(options?: SubscriptionMultiplexerOptions) {\n    this.#logger = options?.logger;\n  }\n\n  /**\n   * Subscribe to price updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPrices(params: MultiplexedPricesParams): () => void {\n    const {\n      symbols,\n      providers,\n      callback,\n      aggregationMode = 'merge',\n      throttleMs,\n      includeOrderBook,\n      includeMarketData,\n    } = params;\n\n    const unsubscribers: (() => void)[] = [];\n\n    // Subscribe to each provider with defensive error handling\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePricesParams = {\n          symbols,\n          callback: (updates) => {\n            // Tag and cache each update\n            updates.forEach((update) => {\n              const taggedUpdate: PriceUpdate = { ...update, providerId };\n\n              // Initialize symbol cache if needed\n              if (!this.#priceCache.has(update.symbol)) {\n                this.#priceCache.set(update.symbol, new Map());\n              }\n              const symbolCache = this.#priceCache.get(update.symbol);\n              if (symbolCache) {\n                symbolCache.set(providerId, taggedUpdate);\n              }\n            });\n\n            // Aggregate and emit based on mode\n            const aggregated = this.#aggregatePrices(symbols, aggregationMode);\n            callback(aggregated);\n          },\n          throttleMs,\n          includeOrderBook,\n          includeMarketData,\n        };\n\n        const unsub = provider.subscribeToPrices(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        // Log to Sentry before cleanup\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPrices'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPrices',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n\n        // Clean up any subscriptions created before the failure\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    // Return combined unsubscribe function\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Optionally clear cache for these symbols\n      symbols.forEach((symbol) => {\n        this.#priceCache.delete(symbol);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to position updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPositions(params: MultiplexedPositionsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePositionsParams = {\n          callback: (positions) => {\n            // Tag positions with providerId and cache\n            const taggedPositions = positions.map((pos) => ({\n              ...pos,\n              providerId,\n            }));\n            this.#positionCache.set(providerId, taggedPositions);\n\n            // Emit aggregated positions from all providers\n            const allPositions = this.#aggregatePositions();\n            callback(allPositions);\n          },\n        };\n\n        const unsub = provider.subscribeToPositions(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPositions'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPositions',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Clear position cache for these providers\n      providers.forEach(([providerId]) => {\n        this.#positionCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to order fill updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrderFills(params: MultiplexedOrderFillsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrderFillsParams = {\n          callback: (fills, isSnapshot) => {\n            // Tag fills with providerId\n            const taggedFills = fills.map((fill) => ({\n              ...fill,\n              providerId,\n            }));\n\n            // For fills, we don't aggregate - emit immediately with tags\n            callback(taggedFills, isSnapshot);\n          },\n        };\n\n        const unsub = provider.subscribeToOrderFills(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrderFills'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrderFills',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n    };\n  }\n\n  /**\n   * Subscribe to order updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrders(params: MultiplexedOrdersParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrdersParams = {\n          callback: (orders) => {\n            // Tag orders with providerId and cache\n            const taggedOrders = orders.map((order) => ({\n              ...order,\n              providerId,\n            }));\n            this.#orderCache.set(providerId, taggedOrders);\n\n            // Emit aggregated orders from all providers\n            const allOrders = this.#aggregateOrders();\n            callback(allOrders);\n          },\n        };\n\n        const unsub = provider.subscribeToOrders(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrders'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrders',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#orderCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to account updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToAccount(params: MultiplexedAccountParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeAccountParams = {\n          callback: (account) => {\n            if (account === null) {\n              this.#accountCache.delete(providerId);\n            } else {\n              // Tag account with providerId and cache\n              const taggedAccount: AccountState = {\n                ...account,\n                providerId,\n              };\n              this.#accountCache.set(providerId, taggedAccount);\n            }\n\n            // Emit all cached account states\n            const allAccounts = Array.from(this.#accountCache.values());\n            callback(allAccounts);\n          },\n        };\n\n        const unsub = provider.subscribeToAccount(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToAccount'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToAccount',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#accountCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Aggregate cached prices based on mode.\n   *\n   * @param symbols - Symbols to include in result\n   * @param mode - Aggregation mode\n   * @returns Aggregated price updates\n   */\n  #aggregatePrices(\n    symbols: string[],\n    mode: PriceAggregationMode,\n  ): PriceUpdate[] {\n    const result: PriceUpdate[] = [];\n\n    symbols.forEach((symbol) => {\n      const providerPrices = this.#priceCache.get(symbol);\n      if (!providerPrices || providerPrices.size === 0) {\n        return;\n      }\n\n      if (mode === 'merge') {\n        // Return all prices (one per provider)\n        providerPrices.forEach((price) => {\n          result.push(price);\n        });\n      } else {\n        // 'best_price': Return the best price across providers\n        const best = this.#findBestPrice(providerPrices);\n        if (best) {\n          result.push(best);\n        }\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Find the best price from multiple provider prices.\n   * \"Best\" is defined as the price with the smallest spread.\n   *\n   * @param providerPrices - Map of provider prices for a symbol\n   * @returns Best price update or undefined\n   */\n  #findBestPrice(\n    providerPrices: Map<PerpsProviderType, PriceUpdate>,\n  ): PriceUpdate | undefined {\n    let bestPrice: PriceUpdate | undefined;\n    let smallestSpread = Infinity;\n\n    providerPrices.forEach((price) => {\n      if (price.spread === undefined) {\n        // No spread info - just use the first one\n        bestPrice ??= price;\n      } else {\n        // If spread is available, use it to determine best\n        const spreadValue = parseFloat(price.spread);\n        if (!isNaN(spreadValue) && spreadValue < smallestSpread) {\n          smallestSpread = spreadValue;\n          bestPrice = price;\n        }\n      }\n    });\n\n    return bestPrice;\n  }\n\n  /**\n   * Aggregate positions from all providers.\n   *\n   * @returns All cached positions\n   */\n  #aggregatePositions(): Position[] {\n    const allPositions: Position[] = [];\n    this.#positionCache.forEach((positions) => {\n      allPositions.push(...positions);\n    });\n    return allPositions;\n  }\n\n  /**\n   * Aggregate orders from all providers.\n   *\n   * @returns All cached orders\n   */\n  #aggregateOrders(): Order[] {\n    const allOrders: Order[] = [];\n    this.#orderCache.forEach((orders) => {\n      allOrders.push(...orders);\n    });\n    return allOrders;\n  }\n\n  /**\n   * Clear all cached data.\n   */\n  clearCache(): void {\n    this.#priceCache.clear();\n    this.#positionCache.clear();\n    this.#orderCache.clear();\n    this.#accountCache.clear();\n  }\n\n  /**\n   * Get cached price for a symbol from a specific provider.\n   *\n   * @param symbol - Market symbol\n   * @param providerId - Provider ID\n   * @returns Cached price update or undefined\n   */\n  getCachedPrice(\n    symbol: string,\n    providerId: PerpsProviderType,\n  ): PriceUpdate | undefined {\n    return this.#priceCache.get(symbol)?.get(providerId);\n  }\n\n  /**\n   * Get all cached prices for a symbol.\n   *\n   * @param symbol - Market symbol\n   * @returns Map of provider ID to price update\n   */\n  getAllCachedPricesForSymbol(\n    symbol: string,\n  ): Map<PerpsProviderType, PriceUpdate> | undefined {\n    return this.#priceCache.get(symbol);\n  }\n}\n"]}
+{"version":3,"file":"SubscriptionMultiplexer.mjs","sourceRoot":"","sources":["../../src/aggregation/SubscriptionMultiplexer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SubscriptionMultiplexer - Manages WebSocket subscriptions across multiple providers\n *\n * Responsibilities:\n * - Manage subscriptions to multiple providers simultaneously\n * - Tag all updates with providerId so UI can differentiate sources\n * - Support aggregation modes: 'merge' (all prices) or 'best_price' (best price per symbol)\n * - Cache latest updates per provider per symbol for aggregation\n */\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type {\n  PerpsProviderType,\n  PerpsProvider,\n  PerpsLogger,\n  PriceUpdate,\n  Position,\n  OrderFill,\n  Order,\n  AccountState,\n  SubscribePricesParams,\n  SubscribePositionsParams,\n  SubscribeOrderFillsParams,\n  SubscribeOrdersParams,\n  SubscribeAccountParams,\n} from '../types/index.js';\nimport { ensureError } from '../utils/errorUtils.js';\n\n/**\n * Options for constructing SubscriptionMultiplexer\n */\nexport type SubscriptionMultiplexerOptions = {\n  /** Optional logger for error reporting (e.g., Sentry) */\n  logger?: PerpsLogger;\n};\n\n/**\n * Aggregation mode for price subscriptions\n */\nexport type PriceAggregationMode = 'merge' | 'best_price';\n\n/**\n * Parameters for multiplexed price subscriptions\n */\nexport type MultiplexedPricesParams = {\n  /** Symbols to subscribe to */\n  symbols: string[];\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated price updates */\n  callback: (prices: PriceUpdate[]) => void;\n  /** Aggregation mode: 'merge' returns all prices, 'best_price' returns best per symbol */\n  aggregationMode?: PriceAggregationMode;\n  /** Optional throttle in milliseconds */\n  throttleMs?: number;\n  /** Include order book data */\n  includeOrderBook?: boolean;\n  /** Include market data (funding, OI, volume) */\n  includeMarketData?: boolean;\n};\n\n/**\n * Parameters for multiplexed position subscriptions\n */\nexport type MultiplexedPositionsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated position updates */\n  callback: (positions: Position[]) => void;\n};\n\n/**\n * Parameters for multiplexed order fill subscriptions\n */\nexport type MultiplexedOrderFillsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order fill updates */\n  callback: (fills: OrderFill[], isSnapshot?: boolean) => void;\n};\n\n/**\n * Parameters for multiplexed order subscriptions\n */\nexport type MultiplexedOrdersParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order updates */\n  callback: (orders: Order[]) => void;\n};\n\n/**\n * Parameters for multiplexed account subscriptions\n */\nexport type MultiplexedAccountParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive account updates (one per provider) */\n  callback: (accounts: AccountState[]) => void;\n};\n\n/**\n * SubscriptionMultiplexer manages real-time data subscriptions across\n * multiple perps providers.\n *\n * Key features:\n * - Subscribes to all providers simultaneously\n * - Tags all updates with source providerId\n * - Caches latest values for aggregation\n * - Supports different aggregation modes for prices\n *\n * @example\n * ```typescript\n * const mux = new SubscriptionMultiplexer();\n *\n * const unsubscribe = mux.subscribeToPrices({\n *   symbols: ['BTC', 'ETH'],\n *   providers: [\n *     ['hyperliquid', hlProvider],\n *     ['lighter', lighterProvider],\n *   ],\n *   callback: (prices) => {\n *     // prices have providerId injected\n *     prices.forEach(p => console.log(`${p.providerId}: ${p.symbol} = ${p.price}`));\n *   },\n *   aggregationMode: 'merge',\n * });\n *\n * // Later: clean up\n * unsubscribe();\n * ```\n */\nexport class SubscriptionMultiplexer {\n  /**\n   * Optional logger for error reporting\n   */\n  readonly #logger?: PerpsLogger;\n\n  /**\n   * Cache of latest prices per symbol per provider\n   * Map<symbol, Map<providerId, PriceUpdate>>\n   */\n  readonly #priceCache: Map<string, Map<PerpsProviderType, PriceUpdate>> =\n    new Map();\n\n  /**\n   * Cache of latest positions per provider\n   * Map<providerId, Position[]>\n   */\n  readonly #positionCache: Map<PerpsProviderType, Position[]> = new Map();\n\n  /**\n   * Cache of latest orders per provider\n   * Map<providerId, Order[]>\n   */\n  readonly #orderCache: Map<PerpsProviderType, Order[]> = new Map();\n\n  /**\n   * Cache of latest account state per provider\n   * Map<providerId, AccountState>\n   */\n  readonly #accountCache: Map<PerpsProviderType, AccountState> = new Map();\n\n  /**\n   * Create a new SubscriptionMultiplexer.\n   *\n   * @param options - Optional configuration including logger for error reporting\n   */\n  constructor(options?: SubscriptionMultiplexerOptions) {\n    this.#logger = options?.logger;\n  }\n\n  /**\n   * Subscribe to price updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPrices(params: MultiplexedPricesParams): () => void {\n    const {\n      symbols,\n      providers,\n      callback,\n      aggregationMode = 'merge',\n      throttleMs,\n      includeOrderBook,\n      includeMarketData,\n    } = params;\n\n    const unsubscribers: (() => void)[] = [];\n\n    // Subscribe to each provider with defensive error handling\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePricesParams = {\n          symbols,\n          callback: (updates) => {\n            // Tag and cache each update\n            updates.forEach((update) => {\n              const taggedUpdate: PriceUpdate = { ...update, providerId };\n\n              // Initialize symbol cache if needed\n              if (!this.#priceCache.has(update.symbol)) {\n                this.#priceCache.set(update.symbol, new Map());\n              }\n              const symbolCache = this.#priceCache.get(update.symbol);\n              if (symbolCache) {\n                symbolCache.set(providerId, taggedUpdate);\n              }\n            });\n\n            // Aggregate and emit based on mode\n            const aggregated = this.#aggregatePrices(symbols, aggregationMode);\n            callback(aggregated);\n          },\n          throttleMs,\n          includeOrderBook,\n          includeMarketData,\n        };\n\n        const unsub = provider.subscribeToPrices(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        // Log to Sentry before cleanup\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPrices'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPrices',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n\n        // Clean up any subscriptions created before the failure\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    // Return combined unsubscribe function\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Optionally clear cache for these symbols\n      symbols.forEach((symbol) => {\n        this.#priceCache.delete(symbol);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to position updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPositions(params: MultiplexedPositionsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePositionsParams = {\n          callback: (positions) => {\n            // Tag positions with providerId and cache\n            const taggedPositions = positions.map((pos) => ({\n              ...pos,\n              providerId,\n            }));\n            this.#positionCache.set(providerId, taggedPositions);\n\n            // Emit aggregated positions from all providers\n            const allPositions = this.#aggregatePositions();\n            callback(allPositions);\n          },\n        };\n\n        const unsub = provider.subscribeToPositions(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPositions'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPositions',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Clear position cache for these providers\n      providers.forEach(([providerId]) => {\n        this.#positionCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to order fill updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrderFills(params: MultiplexedOrderFillsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrderFillsParams = {\n          callback: (fills, isSnapshot) => {\n            // Tag fills with providerId\n            const taggedFills = fills.map((fill) => ({\n              ...fill,\n              providerId,\n            }));\n\n            // For fills, we don't aggregate - emit immediately with tags\n            callback(taggedFills, isSnapshot);\n          },\n        };\n\n        const unsub = provider.subscribeToOrderFills(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrderFills'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrderFills',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n    };\n  }\n\n  /**\n   * Subscribe to order updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrders(params: MultiplexedOrdersParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrdersParams = {\n          callback: (orders) => {\n            // Tag orders with providerId and cache\n            const taggedOrders = orders.map((order) => ({\n              ...order,\n              providerId,\n            }));\n            this.#orderCache.set(providerId, taggedOrders);\n\n            // Emit aggregated orders from all providers\n            const allOrders = this.#aggregateOrders();\n            callback(allOrders);\n          },\n        };\n\n        const unsub = provider.subscribeToOrders(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrders'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrders',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#orderCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to account updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToAccount(params: MultiplexedAccountParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeAccountParams = {\n          callback: (account) => {\n            if (account === null) {\n              this.#accountCache.delete(providerId);\n            } else {\n              // Tag account with providerId and cache\n              const taggedAccount: AccountState = {\n                ...account,\n                providerId,\n              };\n              this.#accountCache.set(providerId, taggedAccount);\n            }\n\n            // Emit all cached account states\n            const allAccounts = Array.from(this.#accountCache.values());\n            callback(allAccounts);\n          },\n        };\n\n        const unsub = provider.subscribeToAccount(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToAccount'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToAccount',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#accountCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Aggregate cached prices based on mode.\n   *\n   * @param symbols - Symbols to include in result\n   * @param mode - Aggregation mode\n   * @returns Aggregated price updates\n   */\n  #aggregatePrices(\n    symbols: string[],\n    mode: PriceAggregationMode,\n  ): PriceUpdate[] {\n    const result: PriceUpdate[] = [];\n\n    symbols.forEach((symbol) => {\n      const providerPrices = this.#priceCache.get(symbol);\n      if (!providerPrices || providerPrices.size === 0) {\n        return;\n      }\n\n      if (mode === 'merge') {\n        // Return all prices (one per provider)\n        providerPrices.forEach((price) => {\n          result.push(price);\n        });\n      } else {\n        // 'best_price': Return the best price across providers\n        const best = this.#findBestPrice(providerPrices);\n        if (best) {\n          result.push(best);\n        }\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Find the best price from multiple provider prices.\n   * \"Best\" is defined as the price with the smallest spread.\n   *\n   * @param providerPrices - Map of provider prices for a symbol\n   * @returns Best price update or undefined\n   */\n  #findBestPrice(\n    providerPrices: Map<PerpsProviderType, PriceUpdate>,\n  ): PriceUpdate | undefined {\n    let bestPrice: PriceUpdate | undefined;\n    let smallestSpread = Infinity;\n\n    providerPrices.forEach((price) => {\n      if (price.spread === undefined) {\n        // No spread info - just use the first one\n        bestPrice ??= price;\n      } else {\n        // If spread is available, use it to determine best\n        const spreadValue = parseFloat(price.spread);\n        if (!isNaN(spreadValue) && spreadValue < smallestSpread) {\n          smallestSpread = spreadValue;\n          bestPrice = price;\n        }\n      }\n    });\n\n    return bestPrice;\n  }\n\n  /**\n   * Aggregate positions from all providers.\n   *\n   * @returns All cached positions\n   */\n  #aggregatePositions(): Position[] {\n    const allPositions: Position[] = [];\n    this.#positionCache.forEach((positions) => {\n      allPositions.push(...positions);\n    });\n    return allPositions;\n  }\n\n  /**\n   * Aggregate orders from all providers.\n   *\n   * @returns All cached orders\n   */\n  #aggregateOrders(): Order[] {\n    const allOrders: Order[] = [];\n    this.#orderCache.forEach((orders) => {\n      allOrders.push(...orders);\n    });\n    return allOrders;\n  }\n\n  /**\n   * Clear all cached data.\n   */\n  clearCache(): void {\n    this.#priceCache.clear();\n    this.#positionCache.clear();\n    this.#orderCache.clear();\n    this.#accountCache.clear();\n  }\n\n  /**\n   * Get cached price for a symbol from a specific provider.\n   *\n   * @param symbol - Market symbol\n   * @param providerId - Provider ID\n   * @returns Cached price update or undefined\n   */\n  getCachedPrice(\n    symbol: string,\n    providerId: PerpsProviderType,\n  ): PriceUpdate | undefined {\n    return this.#priceCache.get(symbol)?.get(providerId);\n  }\n\n  /**\n   * Get all cached prices for a symbol.\n   *\n   * @param symbol - Market symbol\n   * @returns Map of provider ID to price update\n   */\n  getAllCachedPricesForSymbol(\n    symbol: string,\n  ): Map<PerpsProviderType, PriceUpdate> | undefined {\n    return this.#priceCache.get(symbol);\n  }\n}\n"]}

package/dist/constants/index.cjs

@@ -24,6 +24,5 @@ __exportStar(require("./orderTypes.cjs"), exports);
 __exportStar(require("./perpsConfig.cjs"), exports);
 __exportStar(require("./transactionsHistoryConfig.cjs"), exports);
 __exportStar(require("./performanceMetrics.cjs"), exports);
-__exportStar(require("./myxConfig.cjs"), exports);
 __exportStar(require("./lighterConfig.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/constants/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,oDAAiC;AACjC,mDAAgC;AAChC,0DAAuC;AACvC,mDAAgC;AAChC,oDAAiC;AACjC,kEAA+C;AAC/C,2DAAwC;AACxC,kDAA+B;AAC/B,sDAAmC","sourcesContent":["/**\n * Barrel re-export for all portable constants in controllers/\n */\nexport * from './chartConfig.js';\nexport * from './eventNames.js';\nexport * from './hyperLiquidConfig.js';\nexport * from './orderTypes.js';\nexport * from './perpsConfig.js';\nexport * from './transactionsHistoryConfig.js';\nexport * from './performanceMetrics.js';\nexport * from './myxConfig.js';\nexport * from './lighterConfig.js';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,oDAAiC;AACjC,mDAAgC;AAChC,0DAAuC;AACvC,mDAAgC;AAChC,oDAAiC;AACjC,kEAA+C;AAC/C,2DAAwC;AACxC,sDAAmC","sourcesContent":["/**\n * Barrel re-export for all portable constants in controllers/\n */\nexport * from './chartConfig.js';\nexport * from './eventNames.js';\nexport * from './hyperLiquidConfig.js';\nexport * from './orderTypes.js';\nexport * from './perpsConfig.js';\nexport * from './transactionsHistoryConfig.js';\nexport * from './performanceMetrics.js';\nexport * from './lighterConfig.js';\n"]}

package/dist/constants/index.d.cts

@@ -8,6 +8,5 @@ export * from "./orderTypes.cjs";
 export * from "./perpsConfig.cjs";
 export * from "./transactionsHistoryConfig.cjs";
 export * from "./performanceMetrics.cjs";
-export * from "./myxConfig.cjs";
 export * from "./lighterConfig.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/constants/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,kCAAiC;AACjC,iCAAgC;AAChC,wCAAuC;AACvC,iCAAgC;AAChC,kCAAiC;AACjC,gDAA+C;AAC/C,yCAAwC;AACxC,gCAA+B;AAC/B,oCAAmC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,kCAAiC;AACjC,iCAAgC;AAChC,wCAAuC;AACvC,iCAAgC;AAChC,kCAAiC;AACjC,gDAA+C;AAC/C,yCAAwC;AACxC,oCAAmC"}

package/dist/constants/index.d.mts

@@ -8,6 +8,5 @@ export * from "./orderTypes.mjs";
 export * from "./perpsConfig.mjs";
 export * from "./transactionsHistoryConfig.mjs";
 export * from "./performanceMetrics.mjs";
-export * from "./myxConfig.mjs";
 export * from "./lighterConfig.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/constants/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,kCAAiC;AACjC,iCAAgC;AAChC,wCAAuC;AACvC,iCAAgC;AAChC,kCAAiC;AACjC,gDAA+C;AAC/C,yCAAwC;AACxC,gCAA+B;AAC/B,oCAAmC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,kCAAiC;AACjC,iCAAgC;AAChC,wCAAuC;AACvC,iCAAgC;AAChC,kCAAiC;AACjC,gDAA+C;AAC/C,yCAAwC;AACxC,oCAAmC"}

package/dist/constants/index.mjs

@@ -8,6 +8,5 @@ export * from "./orderTypes.mjs";
 export * from "./perpsConfig.mjs";
 export * from "./transactionsHistoryConfig.mjs";
 export * from "./performanceMetrics.mjs";
-export * from "./myxConfig.mjs";
 export * from "./lighterConfig.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/constants/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,kCAAiC;AACjC,iCAAgC;AAChC,wCAAuC;AACvC,iCAAgC;AAChC,kCAAiC;AACjC,gDAA+C;AAC/C,yCAAwC;AACxC,gCAA+B;AAC/B,oCAAmC","sourcesContent":["/**\n * Barrel re-export for all portable constants in controllers/\n */\nexport * from './chartConfig.js';\nexport * from './eventNames.js';\nexport * from './hyperLiquidConfig.js';\nexport * from './orderTypes.js';\nexport * from './perpsConfig.js';\nexport * from './transactionsHistoryConfig.js';\nexport * from './performanceMetrics.js';\nexport * from './myxConfig.js';\nexport * from './lighterConfig.js';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,kCAAiC;AACjC,iCAAgC;AAChC,wCAAuC;AACvC,iCAAgC;AAChC,kCAAiC;AACjC,gDAA+C;AAC/C,yCAAwC;AACxC,oCAAmC","sourcesContent":["/**\n * Barrel re-export for all portable constants in controllers/\n */\nexport * from './chartConfig.js';\nexport * from './eventNames.js';\nexport * from './hyperLiquidConfig.js';\nexport * from './orderTypes.js';\nexport * from './perpsConfig.js';\nexport * from './transactionsHistoryConfig.js';\nexport * from './performanceMetrics.js';\nexport * from './lighterConfig.js';\n"]}

package/dist/constants/perpsConfig.cjs

@@ -503,8 +503,6 @@ exports.FUNDING_RATE_CONFIG = {
 exports.PROVIDER_CONFIG = {
     /** Default perpetual DEX provider when no explicit selection exists */
     DefaultProvider: 'hyperliquid',
-    /** Force MYX to testnet only (mainnet credentials not yet available) */
-    MYX_TESTNET_ONLY: false,
     /**
      * Force Lighter to testnet only. Off: Lighter follows the global network
      * toggle — mainnet reads AND writes are enabled (the initial rollout
@@ -544,19 +542,16 @@ function getProviderNetworkKey(state) {
 exports.getProviderNetworkKey = getProviderNetworkKey;
 /**
  * Build a provider:network cache key for a specific provider id.
- * Accounts for MYX_TESTNET_ONLY: MYX is always on testnet regardless of the
- * global network flag.
+ * Accounts for LIGHTER_TESTNET_ONLY: when set, Lighter stays on testnet
+ * regardless of the global network flag.
  *
- * @param providerId - The provider identifier (e.g. "hyperliquid", "myx").
+ * @param providerId - The provider identifier (e.g. "hyperliquid", "lighter").
  * @param isTestnet - Global testnet flag from controller state.
  * @returns Cache key in the format "provider:mainnet" or "provider:testnet".
  */
 function buildProviderCacheKey(providerId, isTestnet) {
     let effectiveTestnet = isTestnet;
-    if (providerId === 'myx') {
-        effectiveTestnet = exports.PROVIDER_CONFIG.MYX_TESTNET_ONLY || isTestnet;
-    }
-    else if (providerId === 'lighter') {
+    if (providerId === 'lighter') {
         effectiveTestnet = exports.PROVIDER_CONFIG.LIGHTER_TESTNET_ONLY || isTestnet;
     }
     return `${providerId}:${effectiveTestnet ? 'testnet' : 'mainnet'}`;