kucoin-api 0.0.2 → 1.0.0

package/dist/cjs/lib/BaseRestClient.js

@@ -0,0 +1,268 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRestClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const misc_util_js_1 = require("./misc-util.js");
+const requestUtils_js_1 = require("./requestUtils.js");
+const webCryptoAPI_js_1 = require("./webCryptoAPI.js");
+const MISSING_API_KEYS_ERROR = 'API Key, Secret & API Passphrase are ALL required to use the authenticated REST client';
+const ENABLE_HTTP_TRACE = typeof process === 'object' &&
+    typeof process.env === 'object' &&
+    process.env.KUCOINTRACE;
+if (ENABLE_HTTP_TRACE) {
+    axios_1.default.interceptors.request.use((request) => {
+        console.log(new Date(), 'Starting Request', JSON.stringify({
+            url: request.url,
+            method: request.method,
+            params: request.params,
+            data: request.data,
+        }, null, 2));
+        return request;
+    });
+    axios_1.default.interceptors.response.use((response) => {
+        console.log(new Date(), 'Response:', {
+            // request: {
+            //   url: response.config.url,
+            //   method: response.config.method,
+            //   data: response.config.data,
+            //   headers: response.config.headers,
+            // },
+            response: {
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                data: JSON.stringify(response.data, null, 2),
+            },
+        });
+        return response;
+    });
+}
+class BaseRestClient {
+    options;
+    baseUrl;
+    globalRequestOptions;
+    apiKey;
+    apiSecret;
+    apiPassphrase;
+    /**
+     * Create an instance of the REST client. Pass API credentials in the object in the first parameter.
+     * @param {RestClientOptions} [restClientOptions={}] options to configure REST API connectivity
+     * @param {AxiosRequestConfig} [networkOptions={}] HTTP networking options for axios
+     */
+    constructor(restClientOptions = {}, networkOptions = {}) {
+        this.options = {
+            /** Throw errors if any request params are empty */
+            strictParamValidation: false,
+            apiKeyVersion: 2,
+            ...restClientOptions,
+        };
+        this.globalRequestOptions = {
+            /** in ms == 5 minutes by default */
+            timeout: 1000 * 60 * 5,
+            /** inject custom rquest options based on axios specs - see axios docs for more guidance on AxiosRequestConfig: https://github.com/axios/axios#request-config */
+            ...networkOptions,
+            headers: {
+                'Content-Type': 'application/json',
+                locale: 'en-US',
+            },
+        };
+        this.baseUrl = (0, requestUtils_js_1.getRestBaseUrl)(false, restClientOptions, this.getClientType());
+        this.apiKey = this.options.apiKey;
+        this.apiSecret = this.options.apiSecret;
+        this.apiPassphrase = this.options.apiPassphrase;
+        // Throw if one of the 3 values is missing, but at least one of them is set
+        const credentials = [this.apiKey, this.apiSecret, this.apiPassphrase];
+        if (credentials.includes(undefined) &&
+            credentials.some((v) => typeof v === 'string')) {
+            throw new Error(MISSING_API_KEYS_ERROR);
+        }
+    }
+    /**
+     * Timestamp used to sign the request. Override this method to implement your own timestamp/sync mechanism
+     */
+    getSignTimestampMs() {
+        return Date.now();
+    }
+    get(endpoint, params) {
+        return this._call('GET', endpoint, params, true);
+    }
+    post(endpoint, params) {
+        return this._call('POST', endpoint, params, true);
+    }
+    getPrivate(endpoint, params) {
+        return this._call('GET', endpoint, params, false);
+    }
+    postPrivate(endpoint, params) {
+        return this._call('POST', endpoint, params, false);
+    }
+    deletePrivate(endpoint, params) {
+        return this._call('DELETE', endpoint, params, false);
+    }
+    /**
+     * @private Make a HTTP request to a specific endpoint. Private endpoint API calls are automatically signed.
+     */
+    async _call(method, endpoint, params, isPublicApi) {
+        // Sanity check to make sure it's only ever prefixed by one forward slash
+        const requestUrl = [this.baseUrl, endpoint].join(endpoint.startsWith('/') ? '' : '/');
+        // Build a request and handle signature process
+        const options = await this.buildRequest(method, endpoint, requestUrl, params, isPublicApi);
+        if (ENABLE_HTTP_TRACE) {
+            console.log('full request: ', options);
+        }
+        // Dispatch request
+        return (0, axios_1.default)(options)
+            .then((response) => {
+            if (response.status == 200) {
+                // Throw if API returns an error (e.g. insufficient balance)
+                if (typeof response.data?.code === 'string' &&
+                    response.data?.code !== '200000') {
+                    throw { response };
+                }
+                return response.data;
+            }
+            throw { response };
+        })
+            .catch((e) => this.parseException(e, { method, endpoint, requestUrl, params }));
+    }
+    /**
+     * @private generic handler to parse request exceptions
+     */
+    parseException(e, requestParams) {
+        if (this.options.parseExceptions === false) {
+            throw e;
+        }
+        // Something happened in setting up the request that triggered an error
+        if (!e.response) {
+            if (!e.request) {
+                throw e.message;
+            }
+            // request made but no response received
+            throw e;
+        }
+        // The request was made and the server responded with a status code
+        // that falls out of the range of 2xx
+        const response = e.response;
+        // console.error('err: ', response?.data);
+        throw {
+            code: response.status,
+            message: response.statusText,
+            body: response.data,
+            headers: response.headers,
+            requestOptions: {
+                ...this.options,
+                // Prevent credentials from leaking into error messages
+                apiKey: 'omittedFromError',
+                apiSecret: 'omittedFromError',
+                apiPassphrase: 'omittedFromError',
+            },
+            requestParams,
+        };
+    }
+    /**
+     * @private sign request and set recv window
+     */
+    async signRequest(data, endpoint, method, signMethod) {
+        const timestamp = this.getSignTimestampMs();
+        const res = {
+            originalParams: {
+                ...data,
+            },
+            sign: '',
+            timestamp,
+            recvWindow: 0,
+            serializedParams: '',
+            queryParamsWithSign: '',
+        };
+        if (!this.apiKey || !this.apiSecret) {
+            return res;
+        }
+        const strictParamValidation = this.options.strictParamValidation;
+        const encodeQueryStringValues = true;
+        if (signMethod === 'kucoin') {
+            const signRequestParams = method === 'GET' || method === 'DELETE'
+                ? (0, requestUtils_js_1.serializeParams)(data, strictParamValidation, encodeQueryStringValues, '?')
+                : JSON.stringify(data) || '';
+            const paramsStr = `${timestamp}${method}/${endpoint}${signRequestParams}`;
+            res.sign = await (0, webCryptoAPI_js_1.signMessage)(paramsStr, this.apiSecret, 'base64', 'SHA-256');
+            res.queryParamsWithSign = signRequestParams;
+            return res;
+        }
+        console.error(new Date(), (0, misc_util_js_1.neverGuard)(signMethod, `Unhandled sign method: "${webCryptoAPI_js_1.signMessage}"`));
+        return res;
+    }
+    async prepareSignParams(method, endpoint, signMethod, params, isPublicApi) {
+        if (isPublicApi) {
+            return {
+                originalParams: params,
+                paramsWithSign: params,
+            };
+        }
+        if (!this.apiKey || !this.apiSecret || !this.apiPassphrase) {
+            throw new Error(MISSING_API_KEYS_ERROR);
+        }
+        return this.signRequest(params, endpoint, method, signMethod);
+    }
+    /** Returns an axios request object. Handles signing process automatically if this is a private API call */
+    async buildRequest(method, endpoint, url, params, isPublicApi) {
+        const options = {
+            ...this.globalRequestOptions,
+            url: url,
+            method: method,
+        };
+        for (const key in params) {
+            if (typeof params[key] === 'undefined') {
+                delete params[key];
+            }
+        }
+        if (isPublicApi || !this.apiKey || !this.apiSecret) {
+            return {
+                ...options,
+                params: params,
+            };
+        }
+        const signResult = await this.prepareSignParams(method, endpoint, 'kucoin', params, isPublicApi);
+        const authHeaders = {
+            'KC-API-KEY': this.apiKey,
+            'KC-API-PARTNER': this.getClientType() === requestUtils_js_1.REST_CLIENT_TYPE_ENUM.main
+                ? requestUtils_js_1.APIIDMain
+                : requestUtils_js_1.APIIDFutures,
+            'KC-API-TIMESTAMP': signResult.timestamp,
+            'KC-API-KEY-VERSION': this.options.apiKeyVersion,
+        };
+        const partnerSignParam = `${authHeaders['KC-API-TIMESTAMP']}${authHeaders['KC-API-PARTNER']}${authHeaders['KC-API-KEY']}`;
+        const partnerSign = this.getClientType() === requestUtils_js_1.REST_CLIENT_TYPE_ENUM.main
+            ? requestUtils_js_1.APIIDMainSign
+            : requestUtils_js_1.APIIDFuturesSign;
+        const partnerSignResult = await (0, webCryptoAPI_js_1.signMessage)(partnerSignParam, partnerSign, 'base64', 'SHA-256');
+        const signedPassphrase = await (0, webCryptoAPI_js_1.signMessage)(this.apiPassphrase, this.apiSecret, 'base64', 'SHA-256');
+        if (method === 'GET') {
+            return {
+                ...options,
+                headers: {
+                    ...authHeaders,
+                    ...options.headers,
+                    'KC-API-SIGN': signResult.sign,
+                    'KC-API-PARTNER-SIGN': partnerSignResult,
+                    'KC-API-PASSPHRASE': signedPassphrase,
+                },
+                url: options.url + signResult.queryParamsWithSign,
+            };
+        }
+        return {
+            ...options,
+            headers: {
+                ...authHeaders,
+                ...options.headers,
+                'KC-API-SIGN': signResult.sign,
+                'KC-API-PARTNER-SIGN': partnerSignResult,
+                'KC-API-PASSPHRASE': signedPassphrase,
+            },
+            data: params,
+        };
+    }
+}
+exports.BaseRestClient = BaseRestClient;
+//# sourceMappingURL=BaseRestClient.js.map

package/dist/cjs/lib/BaseRestClient.js.map

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

package/dist/cjs/lib/BaseWSClient.d.ts

@@ -0,0 +1,168 @@
+/// <reference types="node" />
+import EventEmitter from 'events';
+import WebSocket from 'isomorphic-ws';
+import { WebsocketClientOptions, WSClientConfigurableOptions } from '../types/websockets/client.js';
+import { WsOperation } from '../types/websockets/requests.js';
+import { DefaultLogger } from './websocket/logger.js';
+import { MessageEventLike, WsTopicRequest, WsTopicRequestOrStringTopic } from './websocket/websocket-util.js';
+import { WsStore } from './websocket/WsStore.js';
+import { WSConnectedResult } from './websocket/WsStore.types.js';
+interface WSClientEventMap<WsKey extends string> {
+    /** Connection opened. If this connection was previously opened and reconnected, expect the reconnected event instead */
+    open: (evt: {
+        wsKey: WsKey;
+        event: any;
+    }) => void;
+    /** Reconnecting a dropped connection */
+    reconnect: (evt: {
+        wsKey: WsKey;
+        event: any;
+    }) => void;
+    /** Successfully reconnected a connection that dropped */
+    reconnected: (evt: {
+        wsKey: WsKey;
+        event: any;
+    }) => void;
+    /** Connection closed */
+    close: (evt: {
+        wsKey: WsKey;
+        event: any;
+    }) => void;
+    /** Received reply to websocket command (e.g. after subscribing to topics) */
+    response: (response: any & {
+        wsKey: WsKey;
+    }) => void;
+    /** Received data for topic */
+    update: (response: any & {
+        wsKey: WsKey;
+    }) => void;
+    /** Exception from ws client OR custom listeners (e.g. if you throw inside your event handler) */
+    exception: (response: any & {
+        wsKey: WsKey;
+    }) => void;
+    error: (response: any & {
+        wsKey: WsKey;
+    }) => void;
+    /** Confirmation that a connection successfully authenticated */
+    authenticated: (event: {
+        wsKey: WsKey;
+        event: any;
+    }) => void;
+}
+export interface EmittableEvent<TEvent = any> {
+    eventType: 'response' | 'update' | 'exception' | 'authenticated' | 'connectionReady';
+    event: TEvent;
+}
+export interface BaseWebsocketClient<TWSKey extends string> {
+    on<U extends keyof WSClientEventMap<TWSKey>>(event: U, listener: WSClientEventMap<TWSKey>[U]): this;
+    emit<U extends keyof WSClientEventMap<TWSKey>>(event: U, ...args: Parameters<WSClientEventMap<TWSKey>[U]>): boolean;
+}
+type WSTopic = string;
+export declare abstract class BaseWebsocketClient<TWSKey extends string> extends EventEmitter {
+    private wsStore;
+    protected logger: typeof DefaultLogger;
+    protected options: WebsocketClientOptions;
+    private wsApiRequestId;
+    constructor(options?: WSClientConfigurableOptions, logger?: typeof DefaultLogger);
+    protected abstract sendPingEvent(wsKey: TWSKey, ws: WebSocket): void;
+    protected abstract sendPongEvent(wsKey: TWSKey, ws: WebSocket): void;
+    protected abstract isWsPong(data: any): boolean;
+    protected abstract isWsPing(data: any): boolean;
+    protected abstract getWsAuthRequestEvent(wsKey: TWSKey): Promise<object>;
+    protected abstract isPrivateTopicRequest(request: WsTopicRequest<WSTopic>, wsKey: TWSKey): boolean;
+    /**
+     * Returns a list of string events that can be individually sent upstream to complete subscribing/unsubscribing/etc to these topics
+     */
+    protected abstract getWsOperationEventsForTopics(topics: WsTopicRequest<WSTopic>[], wsKey: TWSKey, operation: WsOperation): Promise<string[]>;
+    protected abstract getPrivateWSKeys(): TWSKey[];
+    protected abstract getWsUrl(wsKey: TWSKey): Promise<string>;
+    protected abstract getMaxTopicsPerSubscribeEvent(wsKey: TWSKey): number | null;
+    /**
+     * Abstraction called to sort ws events into emittable event types (response to a request, data update, etc)
+     */
+    protected abstract resolveEmittableEvents(wsKey: TWSKey, event: MessageEventLike): EmittableEvent[];
+    /**
+     * Request connection of all dependent (public & private) websockets, instead of waiting for automatic connection by library
+     */
+    protected abstract connectAll(): Promise<(WSConnectedResult | undefined)[]>;
+    protected isPrivateWsKey(wsKey: TWSKey): boolean;
+    /** Returns auto-incrementing request ID, used to track promise references for async requests */
+    protected getNewRequestId(): string;
+    protected abstract sendWSAPIRequest(wsKey: TWSKey, channel: WSTopic, params?: any): Promise<unknown>;
+    protected abstract sendWSAPIRequest(wsKey: TWSKey, channel: WSTopic, params: any): Promise<unknown>;
+    /**
+     * Subscribe to one or more topics on a WS connection (identified by WS Key).
+     *
+     * - Topics are automatically cached
+     * - Connections are automatically opened, if not yet connected
+     * - Authentication is automatically handled
+     * - Topics are automatically resubscribed to, if something happens to the connection, unless you call unsubsribeTopicsForWsKey(topics, key).
+     *
+     * @param wsTopicRequests array of topics to subscribe to
+     * @param wsKey ws key referring to the ws connection these topics should be subscribed on
+     */
+    subscribeTopicsForWsKey(wsTopicRequests: WsTopicRequestOrStringTopic<WSTopic>[], wsKey: TWSKey): false | Promise<WSConnectedResult | undefined> | undefined;
+    protected unsubscribeTopicsForWsKey(wsTopicRequests: WsTopicRequestOrStringTopic<string>[], wsKey: TWSKey): void;
+    /**
+     * Splits topic requests into two groups, public & private topic requests
+     */
+    private sortTopicRequestsIntoPublicPrivate;
+    /** Get the WsStore that tracks websockets & topics */
+    getWsStore(): WsStore<TWSKey, WsTopicRequest<string>>;
+    close(wsKey: TWSKey, force?: boolean): void;
+    closeAll(force?: boolean): void;
+    isConnected(wsKey: TWSKey): boolean;
+    /**
+     * Request connection to a specific websocket, instead of waiting for automatic connection.
+     */
+    connect(wsKey: TWSKey): Promise<WSConnectedResult | undefined>;
+    private connectToWsUrl;
+    private parseWsError;
+    /** Get a signature, build the auth request and send it */
+    private sendAuthRequest;
+    private reconnectWithDelay;
+    private ping;
+    private clearTimers;
+    private clearPingTimer;
+    private clearPongTimer;
+    /**
+     * Simply builds and sends subscribe events for a list of topics for a ws key
+     *
+     * @private Use the `subscribe(topics)` or `subscribeTopicsForWsKey(topics, wsKey)` method to subscribe to topics. Send WS message to subscribe to topics.
+     */
+    private requestSubscribeTopics;
+    /**
+     * Simply builds and sends unsubscribe events for a list of topics for a ws key
+     *
+     * @private Use the `unsubscribe(topics)` method to unsubscribe from topics. Send WS message to unsubscribe from topics.
+     */
+    private requestUnsubscribeTopics;
+    /**
+     * Try sending a string event on a WS connection (identified by the WS Key)
+     */
+    tryWsSend(wsKey: TWSKey, wsMessage: string): void;
+    private onWsOpen;
+    /**
+     * Called automatically once a connection is ready.
+     * - Some exchanges are ready immediately after the connections open.
+     * - Some exchanges send an event to confirm the connection is ready for us.
+     *
+     * This method is called to act when the connection is ready. Use `requireConnectionReadyConfirmation` to control how this is called.
+     */
+    private onWsReadyForEvents;
+    /**
+     * Handle subscription to private topics _after_ authentication successfully completes asynchronously.
+     *
+     * Only used for exchanges that require auth before sending private topic subscription requests
+     */
+    private onWsAuthenticated;
+    private onWsMessage;
+    private onWsClose;
+    private getWs;
+    private setWsState;
+    /**
+     * Promise-driven method to assert that a ws has successfully connected (will await until connection is open)
+     */
+    protected assertIsConnected(wsKey: TWSKey): Promise<unknown>;
+}
+export {};