okx-api 2.0.7 → 3.0.0-beta.0

package/dist/mjs/websocket-client-legacy.js

@@ -0,0 +1,517 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/* eslint-disable @typescript-eslint/no-unsafe-declaration-merging */
+import { EventEmitter } from 'events';
+import WebSocket from 'isomorphic-ws';
+import { DefaultLogger } from './util/logger.js';
+import { isConnCountEvent, isWsDataEvent, isWsErrorEvent, isWsLoginEvent, isWsSubscribeEvent, isWsUnsubscribeEvent, } from './util/typeGuards.js';
+import { signMessage } from './util/webCryptoAPI.js';
+import { getMaxTopicsPerSubscribeEventForMarket, getWsKeyForMarket, getWsKeyForTopicChannel, getWsUrlForWsKey, isWsPong, PRIVATE_WS_KEYS, PUBLIC_WS_KEYS, safeTerminateWs, WS_EVENT_CODE_ENUM, WS_KEY_MAP, WS_LOGGER_CATEGORY, } from './util/websocket-util.js';
+import WsStore from './util/WsStore.js';
+import { WsConnectionStateEnum } from './util/WsStore.types.js';
+/**
+ * @deprecated This is the old WebsocketClient that was part of the SDK prior to the V3 release. This legacy WebsocketClient is temporarily included but will be removed with the next major release.
+ */
+export class WebsocketClientLegacy extends EventEmitter {
+    logger;
+    options;
+    wsStore;
+    constructor(options, logger) {
+        super();
+        this.logger = logger || DefaultLogger;
+        this.wsStore = new WsStore(this.logger);
+        this.options = {
+            market: 'prod',
+            pongTimeout: 2000,
+            pingInterval: 10000,
+            reconnectTimeout: 500,
+            // Automatically send an authentication op/request after a connection opens, for private connections.
+            authPrivateConnectionsOnConnect: true,
+            // Individual requests do not require a signature, so this is disabled.
+            authPrivateRequests: false,
+            useNativeHeartbeats: false,
+            ...options,
+        };
+        if (this.options.market === 'demo') {
+            throw new Error('ERROR: to use demo trading, set the "demoTrading: true" flag in the constructor. The "demo" market is not valid any more.');
+        }
+    }
+    /**
+     * Subscribe to topics & track/persist them. They will be automatically resubscribed to if the connection drops/reconnects.
+     * @param wsEvents topic or list of topics
+     * @param isPrivateTopic optional - the library will try to detect private topics, you can use this to mark a topic as private (if the topic isn't recognised yet)
+     */
+    subscribe(wsEvents, isPrivateTopic) {
+        const wsEventArgs = Array.isArray(wsEvents) ? wsEvents : [wsEvents];
+        wsEventArgs.forEach((wsEventArg) => {
+            const wsKey = getWsKeyForTopicChannel(this.options.market, wsEventArg.channel, isPrivateTopic);
+            // Persist topic for reconnects
+            this.wsStore.addTopic(wsKey, wsEventArg);
+            // if connected, send subscription request
+            if (this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTED)) {
+                return this.requestSubscribeTopics(wsKey, [wsEventArg]);
+            }
+            // start connection process if it hasn't yet begun. Topics are automatically subscribed to on-connect
+            if (!this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTING) &&
+                !this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.RECONNECTING)) {
+                return this.connect(wsKey);
+            }
+        });
+    }
+    /**
+     * Unsubscribe from topics & remove them from memory. They won't be re-subscribed to if the connection reconnects.
+     * @param wsTopics topic or list of topics
+     * @param isPrivateTopic optional - the library will try to detect private topics, you can use this to mark a topic as private (if the topic isn't recognised yet)
+     */
+    unsubscribe(wsTopics, isPrivateTopic) {
+        const wsEventArgs = Array.isArray(wsTopics) ? wsTopics : [wsTopics];
+        wsEventArgs.forEach((wsEventArg) => {
+            const wsKey = getWsKeyForTopicChannel(this.options.market, wsEventArg.channel, isPrivateTopic);
+            // Remove topic from persistence for reconnects
+            this.wsStore.deleteTopic(wsKey, wsEventArg);
+            // unsubscribe request only necessary if active connection exists
+            if (this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTED)) {
+                this.requestUnsubscribeTopics(wsKey, [wsEventArg]);
+            }
+        });
+    }
+    /** Get the WsStore that tracks websocket & topic state */
+    getWsStore() {
+        return this.wsStore;
+    }
+    close(wsKey, force) {
+        this.logger.info('Closing connection', { ...WS_LOGGER_CATEGORY, wsKey });
+        this.wsStore.setConnectionState(wsKey, WsConnectionStateEnum.CLOSING);
+        this.clearTimers(wsKey);
+        const ws = this.wsStore.getWs(wsKey);
+        ws?.close();
+        if (force) {
+            safeTerminateWs(ws);
+        }
+    }
+    closeAll(force) {
+        const keys = this.wsStore.getKeys();
+        this.logger.info(`Closing all ws connections: ${keys}`);
+        keys.forEach((key) => {
+            this.close(key, force);
+        });
+    }
+    /**
+     * Request connection of all dependent (public & private) websockets, instead of waiting for automatic connection by library
+     */
+    connectAll() {
+        return [this.connectPublic(), this.connectPrivate()];
+    }
+    connectPublic(businessEndpoint) {
+        const isPrivate = false;
+        const wsKey = getWsKeyForMarket(this.options.market, isPrivate, !!businessEndpoint);
+        return this.connect(WS_KEY_MAP[wsKey]);
+    }
+    connectPrivate(businessEndpoint) {
+        const isPrivate = true;
+        const wsKey = getWsKeyForMarket(this.options.market, isPrivate, !!businessEndpoint);
+        return this.connect(WS_KEY_MAP[wsKey]);
+    }
+    async connect(wsKey) {
+        try {
+            if (this.wsStore.isWsOpen(wsKey)) {
+                this.logger.error('Refused to connect to ws with existing active connection', { ...WS_LOGGER_CATEGORY, wsKey });
+                return this.wsStore.getWs(wsKey);
+            }
+            if (this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTING)) {
+                this.logger.error('Refused to connect to ws, connection attempt already active', { ...WS_LOGGER_CATEGORY, wsKey });
+                return;
+            }
+            if (!this.wsStore.getConnectionState(wsKey) ||
+                this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.INITIAL)) {
+                this.wsStore.setConnectionState(wsKey, WsConnectionStateEnum.CONNECTING);
+            }
+            const url = getWsUrlForWsKey(wsKey, this.options, this.logger);
+            const ws = this.connectToWsUrl(url, wsKey);
+            return this.wsStore.setWs(wsKey, ws);
+        }
+        catch (err) {
+            this.parseWsError('Connection failed', err, wsKey);
+            this.reconnectWithDelay(wsKey, this.options.reconnectTimeout);
+        }
+    }
+    parseWsError(context, error, wsKey) {
+        if (!error.message) {
+            this.logger.error(`${context} due to unexpected error: `, error);
+            this.emit('exception', error);
+            return;
+        }
+        switch (error.message) {
+            default:
+                if (this.wsStore.getConnectionState(wsKey) !==
+                    WsConnectionStateEnum.CLOSING) {
+                    this.logger.error(`${context} due to unexpected response error: "${error?.msg || error?.message || error}"`, { ...WS_LOGGER_CATEGORY, wsKey, error });
+                    this.executeReconnectableClose(wsKey, 'unhandled onWsError');
+                }
+                else {
+                    this.logger.info(`${wsKey} socket forcefully closed. Will not reconnect.`);
+                }
+                break;
+        }
+        this.emit('exception', error);
+    }
+    /**
+     * Return params required to make authorized request
+     */
+    async getWsAuthRequest(wsKey) {
+        const isPublicWsKey = PUBLIC_WS_KEYS.includes(wsKey);
+        const accounts = this.options.accounts;
+        const hasAccountsToAuth = !!accounts?.length;
+        if (isPublicWsKey || !accounts || !hasAccountsToAuth) {
+            this.logger.trace('Starting public only websocket client.', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+                isPublicWsKey,
+                hasAccountsToAuth,
+            });
+            return;
+        }
+        try {
+            const authAccountRequests = accounts.map(async (credentials) => {
+                try {
+                    const { signature, timestamp } = await this.getWsAuthSignature(wsKey, credentials);
+                    return {
+                        apiKey: credentials.apiKey,
+                        passphrase: credentials.apiPass,
+                        timestamp: timestamp,
+                        sign: signature,
+                    };
+                }
+                catch (e) {
+                    this.logger.error(`Account with key ${credentials.apiKey} could not be authenticateD: ${e}`);
+                }
+                return;
+            });
+            const signedAuthAccountRequests = await Promise.all(authAccountRequests);
+            // Filter out failed accounts
+            const authRequests = signedAuthAccountRequests.filter((request) => !!request);
+            const authParams = {
+                op: 'login',
+                args: authRequests,
+            };
+            return authParams;
+        }
+        catch (e) {
+            this.logger.error(e, { ...WS_LOGGER_CATEGORY, wsKey });
+            return;
+        }
+    }
+    async getWsAuthSignature(wsKey, credentials) {
+        const { apiKey, apiSecret } = credentials;
+        if (!apiKey || !apiSecret) {
+            this.logger.info('Cannot authenticate websocket, either api or secret missing.', { ...WS_LOGGER_CATEGORY, wsKey });
+            throw new Error(`Cannot auth - missing api or secret in config (key: ${apiKey})`);
+        }
+        this.logger.trace("Getting auth'd request params", {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+        });
+        const timestamp = (Date.now() / 1000).toFixed(0);
+        // const signatureExpiresAt = timestamp + 5;
+        const signatureRequest = timestamp + 'GET' + '/users/self/verify';
+        const signature = await signMessage(signatureRequest, apiSecret, 'base64', 'SHA-256');
+        return {
+            signature,
+            timestamp,
+        };
+    }
+    async sendAuthRequest(wsKey) {
+        const logContext = {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+            method: 'sendAuthRequest',
+        };
+        this.logger.info('Sending auth request...', logContext);
+        try {
+            const authRequest = await this.getWsAuthRequest(wsKey);
+            if (!authRequest) {
+                throw new Error('Cannot authenticate this connection');
+            }
+            this.logger.info(`Sending authentication request on wsKey(${wsKey})`, logContext);
+            this.logger.trace(`Authenticating with event: ${JSON.stringify(authRequest, null, 2)} on wsKey(${wsKey})`, logContext);
+            return this.tryWsSend(wsKey, JSON.stringify(authRequest));
+        }
+        catch (e) {
+            this.logger.error(e, logContext);
+        }
+    }
+    reconnectWithDelay(wsKey, connectionDelayMs) {
+        this.clearTimers(wsKey);
+        if (this.wsStore.getConnectionState(wsKey) !==
+            WsConnectionStateEnum.CONNECTING) {
+            this.wsStore.setConnectionState(wsKey, WsConnectionStateEnum.RECONNECTING);
+        }
+        if (this.wsStore.get(wsKey)?.activeReconnectTimer) {
+            this.clearReconnectTimer(wsKey);
+        }
+        this.wsStore.get(wsKey, true).activeReconnectTimer = setTimeout(() => {
+            this.logger.info('Reconnecting to websocket', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+            });
+            this.clearReconnectTimer(wsKey);
+            this.connect(wsKey);
+        }, connectionDelayMs);
+    }
+    ping(wsKey) {
+        if (this.wsStore.get(wsKey, true).activePongTimer) {
+            return;
+        }
+        this.clearPongTimer(wsKey);
+        this.logger.trace('Sending ping', { ...WS_LOGGER_CATEGORY, wsKey });
+        this.tryWsSend(wsKey, 'ping');
+        this.wsStore.get(wsKey, true).activePongTimer = setTimeout(() => this.executeReconnectableClose(wsKey, 'Pong timeout'), this.options.pongTimeout);
+    }
+    /**
+     * Closes a connection, if it's even open. If open, this will trigger a reconnect asynchronously.
+     * If closed, trigger a reconnect immediately
+     */
+    executeReconnectableClose(wsKey, reason) {
+        this.logger.info(`${reason} - closing socket to reconnect`, {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+            reason,
+        });
+        const wasOpen = this.wsStore.isWsOpen(wsKey);
+        if (wasOpen) {
+            safeTerminateWs(this.wsStore.getWs(wsKey), true);
+        }
+        delete this.wsStore.get(wsKey, true).activePongTimer;
+        this.clearPingTimer(wsKey);
+        this.clearPongTimer(wsKey);
+        if (!wasOpen) {
+            this.logger.info(`${reason} - socket already closed - trigger immediate reconnect`, {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+                reason,
+            });
+            this.reconnectWithDelay(wsKey, this.options.reconnectTimeout);
+        }
+    }
+    clearTimers(wsKey) {
+        this.clearPingTimer(wsKey);
+        this.clearPongTimer(wsKey);
+        this.clearReconnectTimer(wsKey);
+    }
+    // Send a ping at intervals
+    clearPingTimer(wsKey) {
+        const wsState = this.wsStore.get(wsKey);
+        if (wsState?.activePingTimer) {
+            clearInterval(wsState.activePingTimer);
+            wsState.activePingTimer = undefined;
+        }
+    }
+    // Expect a pong within a time limit
+    clearPongTimer(wsKey) {
+        const wsState = this.wsStore.get(wsKey);
+        if (wsState?.activePongTimer) {
+            clearTimeout(wsState.activePongTimer);
+            wsState.activePongTimer = undefined;
+        }
+    }
+    clearReconnectTimer(wsKey) {
+        const wsState = this.wsStore.get(wsKey);
+        if (wsState?.activeReconnectTimer) {
+            clearTimeout(wsState.activeReconnectTimer);
+            wsState.activeReconnectTimer = undefined;
+        }
+    }
+    /**
+     * @private Use the `subscribe(topics)` method to subscribe to topics. Send WS message to subscribe to topics.
+     */
+    requestSubscribeTopics(wsKey, topics) {
+        if (!topics.length) {
+            return;
+        }
+        const maxTopicsPerEvent = getMaxTopicsPerSubscribeEventForMarket(this.options.market);
+        if (maxTopicsPerEvent && topics.length > maxTopicsPerEvent) {
+            this.logger.trace(`Subscribing to topics in batches of ${maxTopicsPerEvent}`);
+            for (let i = 0; i < topics.length; i += maxTopicsPerEvent) {
+                const batch = topics.slice(i, i + maxTopicsPerEvent);
+                this.logger.trace(`Subscribing to batch of ${batch.length}`);
+                this.requestSubscribeTopics(wsKey, batch);
+            }
+            this.logger.trace(`Finished batch subscribing to ${topics.length} topics`);
+            return;
+        }
+        const request = {
+            op: 'subscribe',
+            args: topics,
+        };
+        const wsMessage = JSON.stringify(request);
+        this.tryWsSend(wsKey, wsMessage);
+    }
+    /**
+     * @private Use the `unsubscribe(topics)` method to unsubscribe from topics. Send WS message to unsubscribe from topics.
+     */
+    requestUnsubscribeTopics(wsKey, topics) {
+        if (!topics.length) {
+            return;
+        }
+        const maxTopicsPerEvent = getMaxTopicsPerSubscribeEventForMarket(this.options.market);
+        if (maxTopicsPerEvent && topics.length > maxTopicsPerEvent) {
+            this.logger.trace(`Unsubscribing to topics in batches of ${maxTopicsPerEvent}`);
+            for (let i = 0; i < topics.length; i += maxTopicsPerEvent) {
+                const batch = topics.slice(i, i + maxTopicsPerEvent);
+                this.logger.trace(`Unsubscribing to batch of ${batch.length}`);
+                this.requestUnsubscribeTopics(wsKey, batch);
+            }
+            this.logger.trace(`Finished batch unsubscribing to ${topics.length} topics`);
+            return;
+        }
+        const request = {
+            op: 'unsubscribe',
+            args: topics,
+        };
+        const wsMessage = JSON.stringify(request);
+        this.tryWsSend(wsKey, wsMessage);
+    }
+    tryWsSend(wsKey, wsMessage) {
+        try {
+            this.logger.trace('Sending upstream ws message: ', {
+                ...WS_LOGGER_CATEGORY,
+                wsMessage,
+                wsKey,
+            });
+            if (!wsKey) {
+                throw new Error(`Cannot send message (wsKey not provided: wsKey(${wsKey}))`);
+            }
+            const ws = this.wsStore.getWs(wsKey);
+            if (!ws) {
+                throw new Error(`${wsKey} socket not connected yet, call "connect(${wsKey}) first then try again when the "open" event arrives`);
+            }
+            ws.send(wsMessage);
+        }
+        catch (e) {
+            this.logger.error('Failed to send WS message', {
+                ...WS_LOGGER_CATEGORY,
+                wsMessage,
+                wsKey,
+                exception: e,
+            });
+        }
+    }
+    connectToWsUrl(url, wsKey) {
+        this.logger.trace(`Opening WS connection to URL: ${url}`, {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+        });
+        const { protocols = [], ...wsOptions } = this.options.wsOptions || {};
+        const ws = new WebSocket(url, protocols, wsOptions);
+        ws.onopen = (event) => this.onWsOpen(event, wsKey, url, ws);
+        ws.onmessage = (event) => this.onWsMessage(event, wsKey, ws);
+        ws.onerror = (event) => this.parseWsError('Websocket onWsError', event, wsKey);
+        ws.onclose = (event) => this.onWsClose(event, wsKey);
+        return ws;
+    }
+    async onWsOpen(event, wsKey, url, ws) {
+        if (this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTING)) {
+            this.logger.info('Websocket connected', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+                market: this.options.market,
+            });
+            this.emit('open', { wsKey, event, wsUrl: url, ws });
+        }
+        else if (this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.RECONNECTING)) {
+            this.logger.info('Websocket reconnected', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+            });
+            this.emit('reconnected', { wsKey, event, wsUrl: url, ws });
+        }
+        this.wsStore.setConnectionState(wsKey, WsConnectionStateEnum.CONNECTED);
+        this.wsStore.get(wsKey, true).activePingTimer = setInterval(() => this.ping(wsKey), this.options.pingInterval);
+        // Private websockets require an auth packet to be sent after opening the connection
+        if (PRIVATE_WS_KEYS.includes(wsKey)) {
+            // Any requested private topics will be subscribed to once authentication succeeds (in onWsMessage handler)
+            await this.sendAuthRequest(wsKey);
+            // Private topics will be subscribed to once authentication is confirmed as successful
+            return;
+        }
+        // Public topics can be subscribed to immediately
+        const topics = [
+            ...this.wsStore.getTopics(wsKey),
+        ];
+        // Since public channels have their own ws key, these topics must be public ones already
+        this.requestSubscribeTopics(wsKey, topics);
+    }
+    onWsMessage(event, wsKey, _ws) {
+        const logContext = { ...WS_LOGGER_CATEGORY, wsKey, method: 'onWsMessage' };
+        try {
+            // any message can clear the pong timer - wouldn't get a message if the ws dropped
+            this.clearPongTimer(wsKey);
+            if (isWsPong(event)) {
+                this.logger.trace('Received pong', logContext);
+                return;
+            }
+            const msg = JSON.parse(event?.data || event);
+            if (isWsErrorEvent(msg)) {
+                this.logger.error('WS error event: ', { ...msg, wsKey });
+                return this.emit('exception', { ...msg, wsKey });
+            }
+            if (isWsDataEvent(msg)) {
+                return this.emit('update', { ...msg, wsKey });
+            }
+            if (isWsLoginEvent(msg)) {
+                // Successfully authenticated
+                if (msg.code === WS_EVENT_CODE_ENUM.OK) {
+                    this.logger.info(`Authenticated successfully on wsKey(${wsKey})`, logContext);
+                    this.emit('response', { ...msg, wsKey });
+                    const topics = [
+                        ...this.wsStore.getTopics(wsKey),
+                    ];
+                    // Since private topics have a dedicated WsKey, these are automatically all private topics (no filtering required before the subscribe call)
+                    this.requestSubscribeTopics(wsKey, topics);
+                    return;
+                }
+                this.logger.error('Authentication failed: ', {
+                    ...logContext,
+                    ...msg,
+                    wsKey,
+                });
+                return this.emit('exception', { ...msg, wsKey });
+            }
+            if (isWsSubscribeEvent(msg) || isWsUnsubscribeEvent(msg)) {
+                // this.logger.trace(`Ws subscribe reply:`, { ...msg, wsKey });
+                return this.emit('response', { ...msg, wsKey });
+            }
+            if (isConnCountEvent(msg)) {
+                return this.emit('response', { ...msg, wsKey });
+            }
+            this.logger.error('Unhandled/unrecognised ws event message', {
+                ...logContext,
+                eventName: msg.event,
+                msg: JSON.stringify(msg, null, 2),
+                wsKey,
+            });
+        }
+        catch (e) {
+            this.logger.error('Failed to parse ws event message', {
+                ...logContext,
+                error: e,
+                event,
+                wsKey,
+            });
+        }
+    }
+    onWsClose(event, wsKey) {
+        this.logger.info('Websocket connection closed', {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+        });
+        if (this.wsStore.getConnectionState(wsKey) !== WsConnectionStateEnum.CLOSING) {
+            this.reconnectWithDelay(wsKey, this.options.reconnectTimeout);
+            this.emit('reconnect', { wsKey, event });
+        }
+        else {
+            this.wsStore.setConnectionState(wsKey, WsConnectionStateEnum.INITIAL);
+            this.emit('close', { wsKey, event });
+        }
+    }
+}
+//# sourceMappingURL=websocket-client-legacy.js.map

package/dist/mjs/websocket-client-legacy.js.map

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

package/dist/mjs/websocket-client.d.ts

@@ -0,0 +1,81 @@
+import { WsAPIOperationResponseMap, WSAPIRequestFlags, WsAPITopicRequestParamMap, WsAPIWsKeyTopicMap, WSOperation, WsRequestOperationOKX } from './types/websockets/ws-api.js';
+import { MessageEventLike, WsDataEvent } from './types/websockets/ws-events.js';
+import { WSClientConfigurableOptions } from './types/websockets/ws-general.js';
+import { WsAuthRequestArg, WsChannelSubUnSubRequestArg } from './types/websockets/ws-request.js';
+import { BaseWebsocketClient, EmittableEvent, MidflightWsRequestEvent, WSClientEventMap } from './util/BaseWSClient.js';
+import { DefaultLogger } from './util/logger.js';
+import { WsKey, WsTopicRequest } from './util/websocket-util.js';
+import { WSConnectedResult } from './util/WsStore.types.js';
+export declare interface WebsocketClient {
+    on<U extends keyof WSClientEventMap<WsKey, WsDataEvent>>(event: U, listener: WSClientEventMap<WsKey>[U]): this;
+    emit<U extends keyof WSClientEventMap<WsKey, WsDataEvent>>(event: U, ...args: Parameters<WSClientEventMap<WsKey>[U]>): boolean;
+}
+export declare class WebsocketClient extends BaseWebsocketClient<WsKey, WsRequestOperationOKX<object>> {
+    constructor(options?: WSClientConfigurableOptions, logger?: DefaultLogger);
+    /**
+     * Request connection of all dependent (public & private) websockets, instead of waiting for automatic connection by library
+     */
+    connectAll(): Promise<WSConnectedResult | undefined>[];
+    connectPublic(businessEndpoint?: boolean): Promise<WSConnectedResult | undefined>;
+    connectPrivate(businessEndpoint?: boolean): Promise<WSConnectedResult | undefined>;
+    /**
+     * Ensures the WS API connection is active and ready.
+     *
+     * You do not need to call this, but if you call this before making any WS API requests,
+     * it can accelerate the first request (by preparing the connection in advance).
+     */
+    connectWSAPI(): Promise<unknown[]>;
+    /**
+     * Subscribe to topics & track/persist them. They will be automatically resubscribed to if the connection drops/reconnects.
+     * @param wsEvents topic or list of topics
+     * @param isPrivateTopic optional - the library will try to detect private topics, you can use this to mark a topic as private (if the topic isn't recognised yet)
+     */
+    subscribe(wsEvents: WsChannelSubUnSubRequestArg[] | WsChannelSubUnSubRequestArg, isPrivateTopic?: boolean): Promise<unknown>[];
+    /**
+     * Unsubscribe from topics & remove them from memory. They won't be re-subscribed to if the connection reconnects.
+     * @param wsTopics topic or list of topics
+     * @param isPrivateTopic optional - the library will try to detect private topics, you can use this to mark a topic as private (if the topic isn't recognised yet)
+     */
+    unsubscribe(wsEvents: WsChannelSubUnSubRequestArg[] | WsChannelSubUnSubRequestArg, isPrivateTopic?: boolean): Promise<unknown>[];
+    /**
+     *
+     *
+     * Internal methods required to integrate with the BaseWSClient
+     *
+     *
+     */
+    getMarketWsKey(type: 'private' | 'business'): WsKey;
+    protected sendPingEvent(wsKey: WsKey): void;
+    protected sendPongEvent(wsKey: WsKey): void;
+    protected isWsPing(data: any): boolean;
+    protected isWsPong(data: any): boolean;
+    protected isPrivateTopicRequest(_request: WsTopicRequest<string>, wsKey: WsKey): boolean;
+    protected getPrivateWSKeys(): WsKey[];
+    protected isAuthOnConnectWsKey(wsKey: WsKey): boolean;
+    protected getWsUrl(wsKey: WsKey): Promise<string>;
+    protected getMaxTopicsPerSubscribeEvent(): number | null;
+    /**
+     * @returns one or more correctly structured request events for performing a operations over WS. This can vary per exchange spec.
+     */
+    protected getWsRequestEvents(operation: WSOperation, requests: WsTopicRequest<string, object>[]): Promise<MidflightWsRequestEvent<WsRequestOperationOKX<object>>[]>;
+    private signMessage;
+    protected getWsAuthRequestEvent(wsKey: WsKey): Promise<WsRequestOperationOKX<WsAuthRequestArg>>;
+    private getWsAuthSignature;
+    /**
+     * Abstraction called to sort ws events into emittable event types (response to a request, data update, etc)
+     */
+    protected resolveEmittableEvents(wsKey: WsKey, event: MessageEventLike): EmittableEvent[];
+    /**
+     * OKX supports order placement via WebSockets. This is the WS API:
+     * https://www.okx.com/docs-v5/en/#order-book-trading-trade-ws-place-order
+     *
+     * For convenient promise-wrapped usage of the WS API, instance the WebsocketAPIClient class exported by this SDK.
+     *
+     * For demo trading, set demoTrading:true in the WS Client config.
+     *
+     * @returns a promise that resolves/rejects when a matching response arrives
+     */
+    sendWSAPIRequest<TWSKey extends keyof WsAPIWsKeyTopicMap, TWSOperation extends WsAPIWsKeyTopicMap[TWSKey], TWSParams extends WsAPITopicRequestParamMap[TWSOperation], TWSAPIResponse extends WsAPIOperationResponseMap[TWSOperation] = WsAPIOperationResponseMap[TWSOperation]>(rawWsKey: WsKey, operation: TWSOperation, params: TWSParams & {
+        signRequest?: boolean;
+    }, requestFlags?: WSAPIRequestFlags): Promise<TWSAPIResponse>;
+}