@metamask-previews/core-backend 6.2.2-preview-094d56fb3 → 6.2.2-preview-7fbc8b83e

package/dist/ws/ohlcv/OHLCVService.mjs

@@ -1,325 +0,0 @@
-/**
- * OHLCV Service for real-time candlestick data streaming via WebSocket.
- *
- * Wraps {@link BackendWebSocketService} through the messenger pattern to
- * provide subscribe/unsubscribe semantics for OHLCV market-data channels.
- * Includes reference counting, grace-period unsubscribe, idempotency checks,
- * chain-status forwarding, and automatic resubscription on reconnect.
- */
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _OHLCVService_instances, _OHLCVService_messenger, _OHLCVService_trace, _OHLCVService_channels, _OHLCVService_chainsUp, _OHLCVService_performUnsubscribe, _OHLCVService_resubscribeActiveChannels, _OHLCVService_handleBarUpdate, _OHLCVService_handleSystemNotification, _OHLCVService_handleWebSocketStateChange, _OHLCVService_buildChannel, _OHLCVService_forceReconnection;
-import { projectLogger, createModuleLogger } from "../../logger.mjs";
-import { WebSocketState } from "../BackendWebSocketService.mjs";
-// =============================================================================
-// Constants
-// =============================================================================
-const SERVICE_NAME = 'OHLCVService';
-const log = createModuleLogger(projectLogger, SERVICE_NAME);
-const MESSENGER_EXPOSED_METHODS = ['subscribe', 'unsubscribe'];
-const SUBSCRIPTION_NAMESPACE = 'market-data.v1';
-const SYSTEM_NOTIFICATIONS_CHANNEL = `system-notifications.v1.${SUBSCRIPTION_NAMESPACE}`;
-/** Delay before actually unsubscribing from a channel after refCount reaches 0. */
-const GRACE_PERIOD_MS = 3000;
-export const OHLCV_SERVICE_ALLOWED_ACTIONS = [
-    'BackendWebSocketService:connect',
-    'BackendWebSocketService:forceReconnection',
-    'BackendWebSocketService:subscribe',
-    'BackendWebSocketService:getConnectionInfo',
-    'BackendWebSocketService:channelHasSubscription',
-    'BackendWebSocketService:getSubscriptionsByChannel',
-    'BackendWebSocketService:findSubscriptionsByChannelPrefix',
-    'BackendWebSocketService:addChannelCallback',
-    'BackendWebSocketService:removeChannelCallback',
-];
-export const OHLCV_SERVICE_ALLOWED_EVENTS = [
-    'BackendWebSocketService:connectionStateChanged',
-];
-// =============================================================================
-// Main Service Class
-// =============================================================================
-/**
- * Service for real-time OHLCV candlestick streaming via the backend WebSocket
- * gateway. Communicates with {@link BackendWebSocketService} exclusively
- * through the messenger — no direct import of the class.
- *
- * Features:
- * - Reference counting: multiple UI consumers share one WebSocket subscription
- * - Grace-period unsubscribe: avoids rapid unsub/resub during navigation
- * - Idempotency: duplicate subscribe calls for the same channel are no-ops
- * - Reconnect resilience: resubscribes all active channels on reconnect
- * - Chain-status forwarding: listens to system-notifications for chain up/down
- *
- */
-export class OHLCVService {
-    // =============================================================================
-    // Constructor
-    // =============================================================================
-    constructor(options) {
-        _OHLCVService_instances.add(this);
-        this.name = SERVICE_NAME;
-        _OHLCVService_messenger.set(this, void 0);
-        _OHLCVService_trace.set(this, void 0);
-        _OHLCVService_channels.set(this, new Map());
-        _OHLCVService_chainsUp.set(this, new Set());
-        __classPrivateFieldSet(this, _OHLCVService_messenger, options.messenger, "f");
-        __classPrivateFieldSet(this, _OHLCVService_trace, options.traceFn ??
-            ((_request, fn) => fn?.()), "f");
-        __classPrivateFieldGet(this, _OHLCVService_messenger, "f").registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
-        __classPrivateFieldGet(this, _OHLCVService_messenger, "f").subscribe('BackendWebSocketService:connectionStateChanged', 
-        // eslint-disable-next-line @typescript-eslint/no-misused-promises
-        (connectionInfo) => __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_handleWebSocketStateChange).call(this, connectionInfo));
-    }
-    /**
-     * Register the system-notifications channel callback.
-     */
-    init() {
-        log('OHLCV-WS: Initializing — registering system-notifications callback');
-        __classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:addChannelCallback', {
-            channelName: SYSTEM_NOTIFICATIONS_CHANNEL,
-            callback: (notification) => __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_handleSystemNotification).call(this, notification),
-        });
-    }
-    // =============================================================================
-    // Public — Subscribe / Unsubscribe
-    // =============================================================================
-    /**
-     * Subscribe to an OHLCV channel. If this is the first subscriber for the
-     * given asset/interval/currency combination a WebSocket subscription is
-     * created. Additional calls for the same combination only bump the reference
-     * count.
-     *
-     * @param options - The subscription parameters.
-     */
-    async subscribe(options) {
-        const channel = __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_buildChannel).call(this, options);
-        const entry = __classPrivateFieldGet(this, _OHLCVService_channels, "f").get(channel);
-        if (entry?.gracePeriodTimer) {
-            clearTimeout(entry.gracePeriodTimer);
-            entry.gracePeriodTimer = undefined;
-            entry.refCount += 1;
-            log('OHLCV-WS: Cancelled grace-period unsubscribe, bumped refCount', {
-                channel,
-                refCount: entry.refCount,
-            });
-            return;
-        }
-        if (entry && entry.refCount > 0) {
-            entry.refCount += 1;
-            return;
-        }
-        // Flush other channels sitting in grace period to free server-side slots
-        // and prevent accumulation when switching time ranges rapidly.
-        for (const [otherChannel, otherEntry] of __classPrivateFieldGet(this, _OHLCVService_channels, "f").entries()) {
-            if (otherChannel !== channel && otherEntry.gracePeriodTimer) {
-                clearTimeout(otherEntry.gracePeriodTimer);
-                otherEntry.gracePeriodTimer = undefined;
-                log('OHLCV-WS: Flushing grace-period channel before new subscribe', {
-                    flushedChannel: otherChannel,
-                    newChannel: channel,
-                });
-                await __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_performUnsubscribe).call(this, otherChannel);
-            }
-        }
-        try {
-            await __classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:connect');
-            if (__classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:channelHasSubscription', channel)) {
-                log('OHLCV-WS: Channel already has WS subscription (idempotency), skipping', {
-                    channel,
-                });
-                __classPrivateFieldGet(this, _OHLCVService_channels, "f").set(channel, { refCount: 1 });
-                return;
-            }
-            await __classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:subscribe', {
-                channels: [channel],
-                channelType: SUBSCRIPTION_NAMESPACE,
-                callback: (notification) => {
-                    __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_handleBarUpdate).call(this, channel, notification);
-                },
-            });
-            __classPrivateFieldGet(this, _OHLCVService_channels, "f").set(channel, { refCount: 1 });
-            log('OHLCV-WS: Subscribe succeeded — new WS subscription created', {
-                channel,
-            });
-        }
-        catch (error) {
-            log('OHLCV-WS: Subscription failed, forcing reconnection', {
-                channel,
-                error,
-            });
-            __classPrivateFieldGet(this, _OHLCVService_messenger, "f").publish('OHLCVService:subscriptionError', {
-                channel,
-                error: String(error),
-                operation: 'subscribe',
-            });
-            await __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_forceReconnection).call(this);
-        }
-    }
-    /**
-     * Unsubscribe from an OHLCV channel. Decrements the reference count and,
-     * when it reaches zero, starts a grace-period timer before actually
-     * unsubscribing from the WebSocket to absorb rapid navigation patterns.
-     *
-     * @param options - The subscription parameters to unsubscribe from.
-     */
-    async unsubscribe(options) {
-        const channel = __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_buildChannel).call(this, options);
-        const entry = __classPrivateFieldGet(this, _OHLCVService_channels, "f").get(channel);
-        if (!entry || entry.refCount <= 0) {
-            return;
-        }
-        entry.refCount -= 1;
-        if (entry.refCount > 0) {
-            return;
-        }
-        entry.gracePeriodTimer = setTimeout(() => {
-            // eslint-disable-next-line @typescript-eslint/no-floating-promises
-            __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_performUnsubscribe).call(this, channel);
-        }, GRACE_PERIOD_MS);
-    }
-    // =============================================================================
-    // Public — Cleanup
-    // =============================================================================
-    /**
-     * Destroy the service and clean up all resources.
-     */
-    destroy() {
-        for (const entry of __classPrivateFieldGet(this, _OHLCVService_channels, "f").values()) {
-            if (entry.gracePeriodTimer) {
-                clearTimeout(entry.gracePeriodTimer);
-            }
-        }
-        __classPrivateFieldGet(this, _OHLCVService_channels, "f").clear();
-        __classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:removeChannelCallback', SYSTEM_NOTIFICATIONS_CHANNEL);
-    }
-}
-_OHLCVService_messenger = new WeakMap(), _OHLCVService_trace = new WeakMap(), _OHLCVService_channels = new WeakMap(), _OHLCVService_chainsUp = new WeakMap(), _OHLCVService_instances = new WeakSet(), _OHLCVService_performUnsubscribe = 
-// =============================================================================
-// Private — WebSocket Subscription Helpers
-// =============================================================================
-async function _OHLCVService_performUnsubscribe(channel) {
-    log('OHLCV-WS: Grace period expired — performing actual WS unsubscribe', {
-        channel,
-    });
-    __classPrivateFieldGet(this, _OHLCVService_channels, "f").delete(channel);
-    try {
-        const subscriptions = __classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:getSubscriptionsByChannel', channel);
-        for (const sub of subscriptions) {
-            await sub.unsubscribe();
-        }
-        log('OHLCV-WS: WS unsubscribe completed', { channel });
-    }
-    catch (error) {
-        log('OHLCV-WS: Unsubscription failed, forcing reconnection', {
-            channel,
-            error,
-        });
-        __classPrivateFieldGet(this, _OHLCVService_messenger, "f").publish('OHLCVService:subscriptionError', {
-            channel,
-            error: String(error),
-            operation: 'unsubscribe',
-        });
-        await __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_forceReconnection).call(this);
-    }
-}, _OHLCVService_resubscribeActiveChannels = 
-/**
- * Resubscribe all channels that were active before a disconnect.
- * Called when WebSocket transitions to CONNECTED.
- */
-async function _OHLCVService_resubscribeActiveChannels() {
-    const channelCount = __classPrivateFieldGet(this, _OHLCVService_channels, "f").size;
-    log('OHLCV-WS: Resubscribing active channels after reconnect', {
-        count: channelCount,
-    });
-    for (const [channel] of __classPrivateFieldGet(this, _OHLCVService_channels, "f").entries()) {
-        try {
-            if (__classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:channelHasSubscription', channel)) {
-                log('OHLCV-WS: Channel already subscribed on server, skipping resubscribe', {
-                    channel,
-                });
-                continue;
-            }
-            await __classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:subscribe', {
-                channels: [channel],
-                channelType: SUBSCRIPTION_NAMESPACE,
-                callback: (notification) => {
-                    __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_handleBarUpdate).call(this, channel, notification);
-                },
-            });
-            log('OHLCV-WS: Resubscription succeeded', { channel });
-        }
-        catch (error) {
-            log('OHLCV-WS: Resubscription failed for channel', { channel, error });
-        }
-    }
-}, _OHLCVService_handleBarUpdate = function _OHLCVService_handleBarUpdate(channel, notification) {
-    const bar = notification.data;
-    // eslint-disable-next-line @typescript-eslint/no-floating-promises
-    __classPrivateFieldGet(this, _OHLCVService_trace, "f").call(this, {
-        name: `${SERVICE_NAME} Bar Update`,
-        data: { channel, timestamp: bar.timestamp },
-        tags: { service: SERVICE_NAME },
-    }, () => {
-        __classPrivateFieldGet(this, _OHLCVService_messenger, "f").publish('OHLCVService:barUpdated', { channel, bar });
-    });
-}, _OHLCVService_handleSystemNotification = function _OHLCVService_handleSystemNotification(notification) {
-    const data = notification.data;
-    const { timestamp } = notification;
-    if (!data.chainIds || !Array.isArray(data.chainIds) || !data.status) {
-        throw new Error('Invalid system notification data: missing chainIds or status');
-    }
-    if (data.status === 'up') {
-        for (const chainId of data.chainIds) {
-            __classPrivateFieldGet(this, _OHLCVService_chainsUp, "f").add(chainId);
-        }
-    }
-    else {
-        for (const chainId of data.chainIds) {
-            __classPrivateFieldGet(this, _OHLCVService_chainsUp, "f").delete(chainId);
-        }
-    }
-    __classPrivateFieldGet(this, _OHLCVService_messenger, "f").publish('OHLCVService:chainStatusChanged', {
-        chainIds: data.chainIds,
-        status: data.status,
-        timestamp,
-    });
-    log(`OHLCV-WS: Chain status change: ${data.status}`, {
-        chains: data.chainIds,
-        status: data.status,
-    });
-}, _OHLCVService_handleWebSocketStateChange = async function _OHLCVService_handleWebSocketStateChange(connectionInfo) {
-    const { state } = connectionInfo;
-    if (state === WebSocketState.CONNECTED) {
-        await __classPrivateFieldGet(this, _OHLCVService_instances, "m", _OHLCVService_resubscribeActiveChannels).call(this);
-    }
-    else if (state === WebSocketState.DISCONNECTED) {
-        const chainsToMarkDown = Array.from(__classPrivateFieldGet(this, _OHLCVService_chainsUp, "f"));
-        if (chainsToMarkDown.length > 0) {
-            __classPrivateFieldGet(this, _OHLCVService_messenger, "f").publish('OHLCVService:chainStatusChanged', {
-                chainIds: chainsToMarkDown,
-                status: 'down',
-                timestamp: Date.now(),
-            });
-            log('OHLCV-WS: WebSocket disconnection — marked tracked chains as down', {
-                count: chainsToMarkDown.length,
-                chains: chainsToMarkDown,
-            });
-            __classPrivateFieldGet(this, _OHLCVService_chainsUp, "f").clear();
-        }
-    }
-}, _OHLCVService_buildChannel = function _OHLCVService_buildChannel(options) {
-    return `${SUBSCRIPTION_NAMESPACE}.${options.assetId}.${options.interval}.${options.currency}`;
-}, _OHLCVService_forceReconnection = async function _OHLCVService_forceReconnection() {
-    log('OHLCV-WS: Forcing WebSocket reconnection');
-    await __classPrivateFieldGet(this, _OHLCVService_messenger, "f").call('BackendWebSocketService:forceReconnection');
-};
-//# sourceMappingURL=OHLCVService.mjs.map

package/dist/ws/ohlcv/OHLCVService.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"OHLCVService.mjs","sourceRoot":"","sources":["../../../src/ws/ohlcv/OHLCVService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OHLCV Service for real-time candlestick data streaming via WebSocket.\n *\n * Wraps {@link BackendWebSocketService} through the messenger pattern to\n * provide subscribe/unsubscribe semantics for OHLCV market-data channels.\n * Includes reference counting, grace-period unsubscribe, idempotency checks,\n * chain-status forwarding, and automatic resubscription on reconnect.\n */\n\nimport type {\n  TraceCallback,\n  TraceContext,\n  TraceRequest,\n} from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\n\nimport { projectLogger, createModuleLogger } from '../../logger';\nimport type {\n  WebSocketConnectionInfo,\n  BackendWebSocketServiceConnectionStateChangedEvent,\n  ServerNotificationMessage,\n} from '../BackendWebSocketService';\nimport { WebSocketState } from '../BackendWebSocketService';\nimport type { BackendWebSocketServiceMethodActions } from '../BackendWebSocketService-method-action-types';\nimport type { OHLCVServiceMethodActions } from './OHLCVService-method-action-types';\nimport type { OHLCVBar, OHLCVSubscriptionOptions } from './types';\n\n// =============================================================================\n// Constants\n// =============================================================================\n\nconst SERVICE_NAME = 'OHLCVService';\n\nconst log = createModuleLogger(projectLogger, SERVICE_NAME);\n\nconst MESSENGER_EXPOSED_METHODS = ['subscribe', 'unsubscribe'] as const;\n\nconst SUBSCRIPTION_NAMESPACE = 'market-data.v1';\n\nconst SYSTEM_NOTIFICATIONS_CHANNEL = `system-notifications.v1.${SUBSCRIPTION_NAMESPACE}`;\n\n/** Delay before actually unsubscribing from a channel after refCount reaches 0. */\nconst GRACE_PERIOD_MS = 3_000;\n\n// =============================================================================\n// Types — Channel Tracking\n// =============================================================================\n\ntype ChannelEntry = {\n  refCount: number;\n  gracePeriodTimer?: ReturnType<typeof setTimeout>;\n};\n\n// =============================================================================\n// Types — System Notifications\n// =============================================================================\n\n/**\n * System notification data for chain status updates on market-data channels.\n */\nexport type OHLCVSystemNotificationData = {\n  chainIds: string[];\n  status: 'down' | 'up';\n  timestamp?: number;\n};\n\n// =============================================================================\n// Types — Service Options\n// =============================================================================\n\n/**\n * Configuration options for the OHLCV service.\n */\nexport type OHLCVServiceOptions = {\n  /** Optional callback to trace performance of OHLCV operations (default: no-op) */\n  traceFn?: TraceCallback;\n};\n\n// =============================================================================\n// Action and Event Types\n// =============================================================================\n\nexport type OHLCVServiceActions = OHLCVServiceMethodActions;\n\nexport const OHLCV_SERVICE_ALLOWED_ACTIONS = [\n  'BackendWebSocketService:connect',\n  'BackendWebSocketService:forceReconnection',\n  'BackendWebSocketService:subscribe',\n  'BackendWebSocketService:getConnectionInfo',\n  'BackendWebSocketService:channelHasSubscription',\n  'BackendWebSocketService:getSubscriptionsByChannel',\n  'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n  'BackendWebSocketService:addChannelCallback',\n  'BackendWebSocketService:removeChannelCallback',\n] as const;\n\nexport const OHLCV_SERVICE_ALLOWED_EVENTS = [\n  'BackendWebSocketService:connectionStateChanged',\n] as const;\n\nexport type AllowedActions = BackendWebSocketServiceMethodActions;\n\n// Events published by OHLCVService\n\nexport type OHLCVServiceBarUpdatedEvent = {\n  type: `OHLCVService:barUpdated`;\n  payload: [{ channel: string; bar: OHLCVBar }];\n};\n\nexport type OHLCVServiceChainStatusChangedEvent = {\n  type: `OHLCVService:chainStatusChanged`;\n  payload: [{ chainIds: string[]; status: 'up' | 'down'; timestamp?: number }];\n};\n\nexport type OHLCVServiceSubscriptionErrorEvent = {\n  type: `OHLCVService:subscriptionError`;\n  payload: [{ channel: string; error: string; operation: string }];\n};\n\nexport type OHLCVServiceEvents =\n  | OHLCVServiceBarUpdatedEvent\n  | OHLCVServiceChainStatusChangedEvent\n  | OHLCVServiceSubscriptionErrorEvent;\n\nexport type AllowedEvents = BackendWebSocketServiceConnectionStateChangedEvent;\n\nexport type OHLCVServiceMessenger = Messenger<\n  typeof SERVICE_NAME,\n  OHLCVServiceActions | AllowedActions,\n  OHLCVServiceEvents | AllowedEvents\n>;\n\n// =============================================================================\n// Main Service Class\n// =============================================================================\n\n/**\n * Service for real-time OHLCV candlestick streaming via the backend WebSocket\n * gateway. Communicates with {@link BackendWebSocketService} exclusively\n * through the messenger — no direct import of the class.\n *\n * Features:\n * - Reference counting: multiple UI consumers share one WebSocket subscription\n * - Grace-period unsubscribe: avoids rapid unsub/resub during navigation\n * - Idempotency: duplicate subscribe calls for the same channel are no-ops\n * - Reconnect resilience: resubscribes all active channels on reconnect\n * - Chain-status forwarding: listens to system-notifications for chain up/down\n *\n */\nexport class OHLCVService {\n  readonly name = SERVICE_NAME;\n\n  readonly #messenger: OHLCVServiceMessenger;\n\n  readonly #trace: TraceCallback;\n\n  readonly #channels = new Map<string, ChannelEntry>();\n\n  readonly #chainsUp = new Set<string>();\n\n  // =============================================================================\n  // Constructor\n  // =============================================================================\n\n  constructor(\n    options: OHLCVServiceOptions & { messenger: OHLCVServiceMessenger },\n  ) {\n    this.#messenger = options.messenger;\n\n    this.#trace =\n      options.traceFn ??\n      ((<Result>(\n        _request: TraceRequest,\n        fn?: (context?: TraceContext) => Result,\n      ) => fn?.()) as TraceCallback);\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    this.#messenger.subscribe(\n      'BackendWebSocketService:connectionStateChanged',\n      // eslint-disable-next-line @typescript-eslint/no-misused-promises\n      (connectionInfo: WebSocketConnectionInfo) =>\n        this.#handleWebSocketStateChange(connectionInfo),\n    );\n  }\n\n  /**\n   * Register the system-notifications channel callback.\n   */\n  init(): void {\n    log('OHLCV-WS: Initializing — registering system-notifications callback');\n    this.#messenger.call('BackendWebSocketService:addChannelCallback', {\n      channelName: SYSTEM_NOTIFICATIONS_CHANNEL,\n      callback: (notification: ServerNotificationMessage) =>\n        this.#handleSystemNotification(notification),\n    });\n  }\n\n  // =============================================================================\n  // Public — Subscribe / Unsubscribe\n  // =============================================================================\n\n  /**\n   * Subscribe to an OHLCV channel. If this is the first subscriber for the\n   * given asset/interval/currency combination a WebSocket subscription is\n   * created. Additional calls for the same combination only bump the reference\n   * count.\n   *\n   * @param options - The subscription parameters.\n   */\n  async subscribe(options: OHLCVSubscriptionOptions): Promise<void> {\n    const channel = this.#buildChannel(options);\n    const entry = this.#channels.get(channel);\n\n    if (entry?.gracePeriodTimer) {\n      clearTimeout(entry.gracePeriodTimer);\n      entry.gracePeriodTimer = undefined;\n      entry.refCount += 1;\n      log('OHLCV-WS: Cancelled grace-period unsubscribe, bumped refCount', {\n        channel,\n        refCount: entry.refCount,\n      });\n      return;\n    }\n\n    if (entry && entry.refCount > 0) {\n      entry.refCount += 1;\n      return;\n    }\n\n    // Flush other channels sitting in grace period to free server-side slots\n    // and prevent accumulation when switching time ranges rapidly.\n    for (const [otherChannel, otherEntry] of this.#channels.entries()) {\n      if (otherChannel !== channel && otherEntry.gracePeriodTimer) {\n        clearTimeout(otherEntry.gracePeriodTimer);\n        otherEntry.gracePeriodTimer = undefined;\n        log('OHLCV-WS: Flushing grace-period channel before new subscribe', {\n          flushedChannel: otherChannel,\n          newChannel: channel,\n        });\n        await this.#performUnsubscribe(otherChannel);\n      }\n    }\n\n    try {\n      await this.#messenger.call('BackendWebSocketService:connect');\n\n      if (\n        this.#messenger.call(\n          'BackendWebSocketService:channelHasSubscription',\n          channel,\n        )\n      ) {\n        log(\n          'OHLCV-WS: Channel already has WS subscription (idempotency), skipping',\n          {\n            channel,\n          },\n        );\n        this.#channels.set(channel, { refCount: 1 });\n        return;\n      }\n\n      await this.#messenger.call('BackendWebSocketService:subscribe', {\n        channels: [channel],\n        channelType: SUBSCRIPTION_NAMESPACE,\n        callback: (notification: ServerNotificationMessage) => {\n          this.#handleBarUpdate(channel, notification);\n        },\n      });\n\n      this.#channels.set(channel, { refCount: 1 });\n      log('OHLCV-WS: Subscribe succeeded — new WS subscription created', {\n        channel,\n      });\n    } catch (error) {\n      log('OHLCV-WS: Subscription failed, forcing reconnection', {\n        channel,\n        error,\n      });\n      this.#messenger.publish('OHLCVService:subscriptionError', {\n        channel,\n        error: String(error),\n        operation: 'subscribe',\n      });\n      await this.#forceReconnection();\n    }\n  }\n\n  /**\n   * Unsubscribe from an OHLCV channel. Decrements the reference count and,\n   * when it reaches zero, starts a grace-period timer before actually\n   * unsubscribing from the WebSocket to absorb rapid navigation patterns.\n   *\n   * @param options - The subscription parameters to unsubscribe from.\n   */\n  async unsubscribe(options: OHLCVSubscriptionOptions): Promise<void> {\n    const channel = this.#buildChannel(options);\n    const entry = this.#channels.get(channel);\n\n    if (!entry || entry.refCount <= 0) {\n      return;\n    }\n\n    entry.refCount -= 1;\n\n    if (entry.refCount > 0) {\n      return;\n    }\n\n    entry.gracePeriodTimer = setTimeout(() => {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      this.#performUnsubscribe(channel);\n    }, GRACE_PERIOD_MS);\n  }\n\n  // =============================================================================\n  // Private — WebSocket Subscription Helpers\n  // =============================================================================\n\n  async #performUnsubscribe(channel: string): Promise<void> {\n    log('OHLCV-WS: Grace period expired — performing actual WS unsubscribe', {\n      channel,\n    });\n    this.#channels.delete(channel);\n\n    try {\n      const subscriptions = this.#messenger.call(\n        'BackendWebSocketService:getSubscriptionsByChannel',\n        channel,\n      );\n\n      for (const sub of subscriptions) {\n        await sub.unsubscribe();\n      }\n      log('OHLCV-WS: WS unsubscribe completed', { channel });\n    } catch (error) {\n      log('OHLCV-WS: Unsubscription failed, forcing reconnection', {\n        channel,\n        error,\n      });\n      this.#messenger.publish('OHLCVService:subscriptionError', {\n        channel,\n        error: String(error),\n        operation: 'unsubscribe',\n      });\n      await this.#forceReconnection();\n    }\n  }\n\n  /**\n   * Resubscribe all channels that were active before a disconnect.\n   * Called when WebSocket transitions to CONNECTED.\n   */\n  async #resubscribeActiveChannels(): Promise<void> {\n    const channelCount = this.#channels.size;\n    log('OHLCV-WS: Resubscribing active channels after reconnect', {\n      count: channelCount,\n    });\n\n    for (const [channel] of this.#channels.entries()) {\n      try {\n        if (\n          this.#messenger.call(\n            'BackendWebSocketService:channelHasSubscription',\n            channel,\n          )\n        ) {\n          log(\n            'OHLCV-WS: Channel already subscribed on server, skipping resubscribe',\n            {\n              channel,\n            },\n          );\n          continue;\n        }\n\n        await this.#messenger.call('BackendWebSocketService:subscribe', {\n          channels: [channel],\n          channelType: SUBSCRIPTION_NAMESPACE,\n          callback: (notification: ServerNotificationMessage) => {\n            this.#handleBarUpdate(channel, notification);\n          },\n        });\n        log('OHLCV-WS: Resubscription succeeded', { channel });\n      } catch (error) {\n        log('OHLCV-WS: Resubscription failed for channel', { channel, error });\n      }\n    }\n  }\n\n  // =============================================================================\n  // Private — Message Handlers\n  // =============================================================================\n\n  #handleBarUpdate(\n    channel: string,\n    notification: ServerNotificationMessage,\n  ): void {\n    const bar = notification.data as OHLCVBar;\n\n    // eslint-disable-next-line @typescript-eslint/no-floating-promises\n    this.#trace(\n      {\n        name: `${SERVICE_NAME} Bar Update`,\n        data: { channel, timestamp: bar.timestamp },\n        tags: { service: SERVICE_NAME },\n      },\n      () => {\n        this.#messenger.publish('OHLCVService:barUpdated', { channel, bar });\n      },\n    );\n  }\n\n  #handleSystemNotification(notification: ServerNotificationMessage): void {\n    const data = notification.data as OHLCVSystemNotificationData;\n    const { timestamp } = notification;\n\n    if (!data.chainIds || !Array.isArray(data.chainIds) || !data.status) {\n      throw new Error(\n        'Invalid system notification data: missing chainIds or status',\n      );\n    }\n\n    if (data.status === 'up') {\n      for (const chainId of data.chainIds) {\n        this.#chainsUp.add(chainId);\n      }\n    } else {\n      for (const chainId of data.chainIds) {\n        this.#chainsUp.delete(chainId);\n      }\n    }\n\n    this.#messenger.publish('OHLCVService:chainStatusChanged', {\n      chainIds: data.chainIds,\n      status: data.status,\n      timestamp,\n    });\n\n    log(`OHLCV-WS: Chain status change: ${data.status}`, {\n      chains: data.chainIds,\n      status: data.status,\n    });\n  }\n\n  async #handleWebSocketStateChange(\n    connectionInfo: WebSocketConnectionInfo,\n  ): Promise<void> {\n    const { state } = connectionInfo;\n\n    if (state === WebSocketState.CONNECTED) {\n      await this.#resubscribeActiveChannels();\n    } else if (state === WebSocketState.DISCONNECTED) {\n      const chainsToMarkDown = Array.from(this.#chainsUp);\n\n      if (chainsToMarkDown.length > 0) {\n        this.#messenger.publish('OHLCVService:chainStatusChanged', {\n          chainIds: chainsToMarkDown,\n          status: 'down',\n          timestamp: Date.now(),\n        });\n\n        log(\n          'OHLCV-WS: WebSocket disconnection — marked tracked chains as down',\n          {\n            count: chainsToMarkDown.length,\n            chains: chainsToMarkDown,\n          },\n        );\n\n        this.#chainsUp.clear();\n      }\n    }\n  }\n\n  // =============================================================================\n  // Private — Utility\n  // =============================================================================\n\n  #buildChannel(options: OHLCVSubscriptionOptions): string {\n    return `${SUBSCRIPTION_NAMESPACE}.${options.assetId}.${options.interval}.${options.currency}`;\n  }\n\n  async #forceReconnection(): Promise<void> {\n    log('OHLCV-WS: Forcing WebSocket reconnection');\n    await this.#messenger.call('BackendWebSocketService:forceReconnection');\n  }\n\n  // =============================================================================\n  // Public — Cleanup\n  // =============================================================================\n\n  /**\n   * Destroy the service and clean up all resources.\n   */\n  destroy(): void {\n    for (const entry of this.#channels.values()) {\n      if (entry.gracePeriodTimer) {\n        clearTimeout(entry.gracePeriodTimer);\n      }\n    }\n    this.#channels.clear();\n\n    this.#messenger.call(\n      'BackendWebSocketService:removeChannelCallback',\n      SYSTEM_NOTIFICATIONS_CHANNEL,\n    );\n  }\n}\n"]}

package/dist/ws/ohlcv/index.cjs

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OHLCV_SERVICE_ALLOWED_EVENTS = exports.OHLCV_SERVICE_ALLOWED_ACTIONS = exports.OHLCVService = void 0;
-var OHLCVService_1 = require("./OHLCVService.cjs");
-Object.defineProperty(exports, "OHLCVService", { enumerable: true, get: function () { return OHLCVService_1.OHLCVService; } });
-var OHLCVService_2 = require("./OHLCVService.cjs");
-Object.defineProperty(exports, "OHLCV_SERVICE_ALLOWED_ACTIONS", { enumerable: true, get: function () { return OHLCVService_2.OHLCV_SERVICE_ALLOWED_ACTIONS; } });
-Object.defineProperty(exports, "OHLCV_SERVICE_ALLOWED_EVENTS", { enumerable: true, get: function () { return OHLCVService_2.OHLCV_SERVICE_ALLOWED_EVENTS; } });
-//# sourceMappingURL=index.cjs.map

package/dist/ws/ohlcv/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/ws/ohlcv/index.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,mDAGwB;AAFtB,6HAAA,6BAA6B,OAAA;AAC7B,4HAAA,4BAA4B,OAAA","sourcesContent":["export { OHLCVService } from './OHLCVService';\nexport {\n  OHLCV_SERVICE_ALLOWED_ACTIONS,\n  OHLCV_SERVICE_ALLOWED_EVENTS,\n} from './OHLCVService';\nexport type {\n  OHLCVSystemNotificationData,\n  OHLCVServiceOptions,\n  OHLCVServiceActions,\n  AllowedActions as OHLCVServiceAllowedActions,\n  OHLCVServiceBarUpdatedEvent,\n  OHLCVServiceChainStatusChangedEvent,\n  OHLCVServiceSubscriptionErrorEvent,\n  OHLCVServiceEvents,\n  AllowedEvents as OHLCVServiceAllowedEvents,\n  OHLCVServiceMessenger,\n} from './OHLCVService';\nexport type { OHLCVBar, OHLCVSubscriptionOptions } from './types';\n"]}

package/dist/ws/ohlcv/index.d.cts

@@ -1,5 +0,0 @@
-export { OHLCVService } from "./OHLCVService.cjs";
-export { OHLCV_SERVICE_ALLOWED_ACTIONS, OHLCV_SERVICE_ALLOWED_EVENTS, } from "./OHLCVService.cjs";
-export type { OHLCVSystemNotificationData, OHLCVServiceOptions, OHLCVServiceActions, AllowedActions as OHLCVServiceAllowedActions, OHLCVServiceBarUpdatedEvent, OHLCVServiceChainStatusChangedEvent, OHLCVServiceSubscriptionErrorEvent, OHLCVServiceEvents, AllowedEvents as OHLCVServiceAllowedEvents, OHLCVServiceMessenger, } from "./OHLCVService.cjs";
-export type { OHLCVBar, OHLCVSubscriptionOptions } from "./types.cjs";
-//# sourceMappingURL=index.d.cts.map

package/dist/ws/ohlcv/index.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/ws/ohlcv/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAAuB;AAC9C,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,2BAAuB;AACxB,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,IAAI,0BAA0B,EAC5C,2BAA2B,EAC3B,mCAAmC,EACnC,kCAAkC,EAClC,kBAAkB,EAClB,aAAa,IAAI,yBAAyB,EAC1C,qBAAqB,GACtB,2BAAuB;AACxB,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,oBAAgB"}

package/dist/ws/ohlcv/index.d.mts

@@ -1,5 +0,0 @@
-export { OHLCVService } from "./OHLCVService.mjs";
-export { OHLCV_SERVICE_ALLOWED_ACTIONS, OHLCV_SERVICE_ALLOWED_EVENTS, } from "./OHLCVService.mjs";
-export type { OHLCVSystemNotificationData, OHLCVServiceOptions, OHLCVServiceActions, AllowedActions as OHLCVServiceAllowedActions, OHLCVServiceBarUpdatedEvent, OHLCVServiceChainStatusChangedEvent, OHLCVServiceSubscriptionErrorEvent, OHLCVServiceEvents, AllowedEvents as OHLCVServiceAllowedEvents, OHLCVServiceMessenger, } from "./OHLCVService.mjs";
-export type { OHLCVBar, OHLCVSubscriptionOptions } from "./types.mjs";
-//# sourceMappingURL=index.d.mts.map

package/dist/ws/ohlcv/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/ws/ohlcv/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAAuB;AAC9C,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,2BAAuB;AACxB,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,IAAI,0BAA0B,EAC5C,2BAA2B,EAC3B,mCAAmC,EACnC,kCAAkC,EAClC,kBAAkB,EAClB,aAAa,IAAI,yBAAyB,EAC1C,qBAAqB,GACtB,2BAAuB;AACxB,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,oBAAgB"}

package/dist/ws/ohlcv/index.mjs

@@ -1,3 +0,0 @@
-export { OHLCVService } from "./OHLCVService.mjs";
-export { OHLCV_SERVICE_ALLOWED_ACTIONS, OHLCV_SERVICE_ALLOWED_EVENTS } from "./OHLCVService.mjs";
-//# sourceMappingURL=index.mjs.map

package/dist/ws/ohlcv/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/ws/ohlcv/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAAuB;AAC9C,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC7B,2BAAuB","sourcesContent":["export { OHLCVService } from './OHLCVService';\nexport {\n  OHLCV_SERVICE_ALLOWED_ACTIONS,\n  OHLCV_SERVICE_ALLOWED_EVENTS,\n} from './OHLCVService';\nexport type {\n  OHLCVSystemNotificationData,\n  OHLCVServiceOptions,\n  OHLCVServiceActions,\n  AllowedActions as OHLCVServiceAllowedActions,\n  OHLCVServiceBarUpdatedEvent,\n  OHLCVServiceChainStatusChangedEvent,\n  OHLCVServiceSubscriptionErrorEvent,\n  OHLCVServiceEvents,\n  AllowedEvents as OHLCVServiceAllowedEvents,\n  OHLCVServiceMessenger,\n} from './OHLCVService';\nexport type { OHLCVBar, OHLCVSubscriptionOptions } from './types';\n"]}

package/dist/ws/ohlcv/types.cjs

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * OHLCV WebSocket streaming types for real-time candlestick data.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.cjs.map

package/dist/ws/ohlcv/types.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../../src/ws/ohlcv/types.ts"],"names":[],"mappings":";AAAA;;GAEG","sourcesContent":["/**\n * OHLCV WebSocket streaming types for real-time candlestick data.\n */\n\n/**\n * A single OHLCV candlestick bar received from the market-data WebSocket stream.\n */\nexport type OHLCVBar = {\n  /** Unix timestamp (seconds) of the candle open */\n  timestamp: number;\n  /** Opening price */\n  open: number;\n  /** Highest price during the candle period */\n  high: number;\n  /** Lowest price during the candle period */\n  low: number;\n  /** Closing price (latest) */\n  close: number;\n  /** Trading volume during the candle period */\n  volume: number;\n};\n\n/**\n * Options for subscribing to an OHLCV channel.\n */\nexport type OHLCVSubscriptionOptions = {\n  /** CAIP-19 asset identifier, e.g. \"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\" */\n  assetId: string;\n  /** Candle interval, e.g. \"1m\", \"5m\", \"15m\", \"1h\", \"4h\", \"1d\" */\n  interval: string;\n  /** Fiat currency code, e.g. \"usd\", \"eur\" */\n  currency: string;\n};\n"]}

package/dist/ws/ohlcv/types.d.cts

@@ -1,32 +0,0 @@
-/**
- * OHLCV WebSocket streaming types for real-time candlestick data.
- */
-/**
- * A single OHLCV candlestick bar received from the market-data WebSocket stream.
- */
-export type OHLCVBar = {
-    /** Unix timestamp (seconds) of the candle open */
-    timestamp: number;
-    /** Opening price */
-    open: number;
-    /** Highest price during the candle period */
-    high: number;
-    /** Lowest price during the candle period */
-    low: number;
-    /** Closing price (latest) */
-    close: number;
-    /** Trading volume during the candle period */
-    volume: number;
-};
-/**
- * Options for subscribing to an OHLCV channel.
- */
-export type OHLCVSubscriptionOptions = {
-    /** CAIP-19 asset identifier, e.g. "eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" */
-    assetId: string;
-    /** Candle interval, e.g. "1m", "5m", "15m", "1h", "4h", "1d" */
-    interval: string;
-    /** Fiat currency code, e.g. "usd", "eur" */
-    currency: string;
-};
-//# sourceMappingURL=types.d.cts.map

package/dist/ws/ohlcv/types.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../../src/ws/ohlcv/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,oGAAoG;IACpG,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/ws/ohlcv/types.d.mts

@@ -1,32 +0,0 @@
-/**
- * OHLCV WebSocket streaming types for real-time candlestick data.
- */
-/**
- * A single OHLCV candlestick bar received from the market-data WebSocket stream.
- */
-export type OHLCVBar = {
-    /** Unix timestamp (seconds) of the candle open */
-    timestamp: number;
-    /** Opening price */
-    open: number;
-    /** Highest price during the candle period */
-    high: number;
-    /** Lowest price during the candle period */
-    low: number;
-    /** Closing price (latest) */
-    close: number;
-    /** Trading volume during the candle period */
-    volume: number;
-};
-/**
- * Options for subscribing to an OHLCV channel.
- */
-export type OHLCVSubscriptionOptions = {
-    /** CAIP-19 asset identifier, e.g. "eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" */
-    assetId: string;
-    /** Candle interval, e.g. "1m", "5m", "15m", "1h", "4h", "1d" */
-    interval: string;
-    /** Fiat currency code, e.g. "usd", "eur" */
-    currency: string;
-};
-//# sourceMappingURL=types.d.mts.map

package/dist/ws/ohlcv/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../src/ws/ohlcv/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,oGAAoG;IACpG,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/ws/ohlcv/types.mjs

@@ -1,5 +0,0 @@
-/**
- * OHLCV WebSocket streaming types for real-time candlestick data.
- */
-export {};
-//# sourceMappingURL=types.mjs.map

package/dist/ws/ohlcv/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../src/ws/ohlcv/types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * OHLCV WebSocket streaming types for real-time candlestick data.\n */\n\n/**\n * A single OHLCV candlestick bar received from the market-data WebSocket stream.\n */\nexport type OHLCVBar = {\n  /** Unix timestamp (seconds) of the candle open */\n  timestamp: number;\n  /** Opening price */\n  open: number;\n  /** Highest price during the candle period */\n  high: number;\n  /** Lowest price during the candle period */\n  low: number;\n  /** Closing price (latest) */\n  close: number;\n  /** Trading volume during the candle period */\n  volume: number;\n};\n\n/**\n * Options for subscribing to an OHLCV channel.\n */\nexport type OHLCVSubscriptionOptions = {\n  /** CAIP-19 asset identifier, e.g. \"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\" */\n  assetId: string;\n  /** Candle interval, e.g. \"1m\", \"5m\", \"15m\", \"1h\", \"4h\", \"1d\" */\n  interval: string;\n  /** Fiat currency code, e.g. \"usd\", \"eur\" */\n  currency: string;\n};\n"]}