@binance/common 1.2.1 → 1.2.3

package/dist/index.d.mts

@@ -583,7 +583,34 @@ declare function setFlattenedQueryParams(urlSearchParams: URLSearchParams, param
  * @param objects - One or more objects to flatten into the URL's search parameters.
  */
 declare const setSearchParams: (url: URL, ...objects: Record<string, unknown>[]) => void;
+/**
+ * Converts a URL object to a full path string, including pathname, search parameters, and hash.
+ *
+ * @param url The URL object to convert to a path string.
+ * @returns A complete path string representation of the URL.
+ */
 declare const toPathString: (url: URL) => string;
+/**
+ * A type utility that transforms numbers in a type to their string representation when in scientific notation,
+ * while preserving the structure of arrays and objects.
+ *
+ * @template T The input type to be transformed
+ * @returns A type where numbers potentially become strings, maintaining the original type's structure
+ */
+type ScientificToString<T> = T extends number ? string | number : T extends Array<infer U> ? Array<ScientificToString<U>> : T extends object ? {
+    [K in keyof T]: ScientificToString<T[K]>;
+} : T;
+/**
+ * Normalizes scientific notation numbers in an object or array to a fixed number of decimal places.
+ *
+ * This function recursively processes objects, arrays, and numbers, converting scientific notation
+ * to a fixed decimal representation. Non-numeric values are left unchanged.
+ *
+ * @template T The type of the input object or value
+ * @param obj The object, array, or value to normalize
+ * @returns A new object or value with scientific notation numbers normalized
+ */
+declare function normalizeScientificNumbers<T>(obj: T): ScientificToString<T>;
 /**
  * Determines whether a request should be retried based on the provided error.
  *
@@ -667,7 +694,7 @@ declare function buildUserAgent(packageName: string, packageVersion: string): st
 declare function buildWebsocketAPIMessage(configuration: ConfigurationWebsocketAPI, method: string, payload: WebsocketSendMsgOptions, options: WebsocketSendMsgConfig, skipAuth?: boolean): {
     id: string;
     method: string;
-    params: SendMessageOptions;
+    params: Record<string, unknown>;
 };
 /**
  * Sanitizes a header value by checking for and preventing carriage return and line feed characters.
@@ -694,6 +721,10 @@ declare class WebsocketEventEmitter {
     off(event: 'open' | 'message' | 'error' | 'close' | 'ping' | 'pong', listener: (...args: any[]) => void): void;
     protected emit(event: 'open' | 'message' | 'error' | 'close' | 'ping' | 'pong', ...args: any[]): void;
 }
+interface TimerRecord {
+    timer?: NodeJS.Timeout;
+    type: 'timeout' | 'interval';
+}
 interface WebsocketConnection {
     id: string;
     reconnectionPending: boolean;
@@ -717,7 +748,7 @@ declare class WebsocketCommon extends WebsocketEventEmitter {
     private static readonly MAX_CONNECTION_DURATION;
     private readonly connectionQueue;
     private queueProcessing;
-    private connectionTimers;
+    protected connectionTimers: Map<WebSocketClient, Set<TimerRecord>>;
     private mode;
     private poolSize;
     private roundRobinIndex;
@@ -767,13 +798,13 @@ declare class WebsocketCommon extends WebsocketEventEmitter {
      * @param type Timer type ('timeout' or 'interval')
      * @returns Timer handle
      */
-    private scheduleTimer;
+    protected scheduleTimer(connection: WebSocketClient, callback: () => void, delay: number, type?: 'timeout' | 'interval'): NodeJS.Timeout;
     /**
      * Clears all timers associated with a WebSocket connection.
      * @param connection - The WebSocket client instance to clear timers for.
      * @returns void
      */
-    private clearTimers;
+    protected clearTimers(connection: WebSocketClient): void;
     /**
      * Processes the connection queue, reconnecting or renewing connections as needed.
      * This method is responsible for iterating through the connection queue and initiating
@@ -1052,4 +1083,4 @@ interface WebsocketStream<T> {
  */
 declare function createStreamHandler<T>(websocketBase: WebsocketAPIBase | WebsocketStreamsBase, streamOrId: string, id?: string): WebsocketStream<T>;
 
-export { ALGO_REST_API_PROD_URL, AUTO_INVEST_REST_API_PROD_URL, type AxiosRequestArgs, BadRequestError, C2C_REST_API_PROD_URL, CONVERT_REST_API_PROD_URL, COPY_TRADING_REST_API_PROD_URL, CRYPTO_LOAN_REST_API_PROD_URL, ConfigurationRestAPI, ConfigurationWebsocketAPI, ConfigurationWebsocketStreams, ConnectorClientError, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL, DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_TESTNET_URL, DUAL_INVESTMENT_REST_API_PROD_URL, FIAT_REST_API_PROD_URL, ForbiddenError, GIFT_CARD_REST_API_PROD_URL, LogLevel, Logger, MARGIN_TRADING_REST_API_PROD_URL, MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL, MARGIN_TRADING_WS_STREAMS_PROD_URL, MINING_REST_API_PROD_URL, NFT_REST_API_PROD_URL, NetworkError, NotFoundError, type ObjectType, PAY_REST_API_PROD_URL, REBATE_REST_API_PROD_URL, RateLimitBanError, type RequestArgs, RequiredError, type RestApiRateLimit, type RestApiResponse, SIMPLE_EARN_REST_API_PROD_URL, SPOT_REST_API_MARKET_URL, SPOT_REST_API_PROD_URL, SPOT_REST_API_TESTNET_URL, SPOT_WS_API_PROD_URL, SPOT_WS_API_TESTNET_URL, SPOT_WS_STREAMS_MARKET_URL, SPOT_WS_STREAMS_PROD_URL, SPOT_WS_STREAMS_TESTNET_URL, STAKING_REST_API_PROD_URL, SUB_ACCOUNT_REST_API_PROD_URL, type SendMessageOptions, ServerError, TimeUnit, TooManyRequestsError, UnauthorizedError, VIP_LOAN_REST_API_PROD_URL, WALLET_REST_API_PROD_URL, WebsocketAPIBase, type WebsocketApiRateLimit, type WebsocketApiResponse, WebsocketCommon, type WebsocketConnection, WebsocketEventEmitter, type WebsocketSendMsgConfig, type WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, buildUserAgent, buildWebsocketAPIMessage, clearSignerCache, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, parseCustomHeaders, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sanitizeHeaderValue, sendRequest, setFlattenedQueryParams, setSearchParams, shouldRetryRequest, sortObject, toPathString, validateTimeUnit };
+export { ALGO_REST_API_PROD_URL, AUTO_INVEST_REST_API_PROD_URL, type AxiosRequestArgs, BadRequestError, C2C_REST_API_PROD_URL, CONVERT_REST_API_PROD_URL, COPY_TRADING_REST_API_PROD_URL, CRYPTO_LOAN_REST_API_PROD_URL, ConfigurationRestAPI, ConfigurationWebsocketAPI, ConfigurationWebsocketStreams, ConnectorClientError, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL, DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_TESTNET_URL, DUAL_INVESTMENT_REST_API_PROD_URL, FIAT_REST_API_PROD_URL, ForbiddenError, GIFT_CARD_REST_API_PROD_URL, LogLevel, Logger, MARGIN_TRADING_REST_API_PROD_URL, MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL, MARGIN_TRADING_WS_STREAMS_PROD_URL, MINING_REST_API_PROD_URL, NFT_REST_API_PROD_URL, NetworkError, NotFoundError, type ObjectType, PAY_REST_API_PROD_URL, REBATE_REST_API_PROD_URL, RateLimitBanError, type RequestArgs, RequiredError, type RestApiRateLimit, type RestApiResponse, SIMPLE_EARN_REST_API_PROD_URL, SPOT_REST_API_MARKET_URL, SPOT_REST_API_PROD_URL, SPOT_REST_API_TESTNET_URL, SPOT_WS_API_PROD_URL, SPOT_WS_API_TESTNET_URL, SPOT_WS_STREAMS_MARKET_URL, SPOT_WS_STREAMS_PROD_URL, SPOT_WS_STREAMS_TESTNET_URL, STAKING_REST_API_PROD_URL, SUB_ACCOUNT_REST_API_PROD_URL, type SendMessageOptions, ServerError, TimeUnit, type TimerRecord, TooManyRequestsError, UnauthorizedError, VIP_LOAN_REST_API_PROD_URL, WALLET_REST_API_PROD_URL, WebsocketAPIBase, type WebsocketApiRateLimit, type WebsocketApiResponse, WebsocketCommon, type WebsocketConnection, WebsocketEventEmitter, type WebsocketSendMsgConfig, type WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, buildUserAgent, buildWebsocketAPIMessage, clearSignerCache, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, normalizeScientificNumbers, parseCustomHeaders, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sanitizeHeaderValue, sendRequest, setFlattenedQueryParams, setSearchParams, shouldRetryRequest, sortObject, toPathString, validateTimeUnit };

package/dist/index.d.ts

@@ -583,7 +583,34 @@ declare function setFlattenedQueryParams(urlSearchParams: URLSearchParams, param
  * @param objects - One or more objects to flatten into the URL's search parameters.
  */
 declare const setSearchParams: (url: URL, ...objects: Record<string, unknown>[]) => void;
+/**
+ * Converts a URL object to a full path string, including pathname, search parameters, and hash.
+ *
+ * @param url The URL object to convert to a path string.
+ * @returns A complete path string representation of the URL.
+ */
 declare const toPathString: (url: URL) => string;
+/**
+ * A type utility that transforms numbers in a type to their string representation when in scientific notation,
+ * while preserving the structure of arrays and objects.
+ *
+ * @template T The input type to be transformed
+ * @returns A type where numbers potentially become strings, maintaining the original type's structure
+ */
+type ScientificToString<T> = T extends number ? string | number : T extends Array<infer U> ? Array<ScientificToString<U>> : T extends object ? {
+    [K in keyof T]: ScientificToString<T[K]>;
+} : T;
+/**
+ * Normalizes scientific notation numbers in an object or array to a fixed number of decimal places.
+ *
+ * This function recursively processes objects, arrays, and numbers, converting scientific notation
+ * to a fixed decimal representation. Non-numeric values are left unchanged.
+ *
+ * @template T The type of the input object or value
+ * @param obj The object, array, or value to normalize
+ * @returns A new object or value with scientific notation numbers normalized
+ */
+declare function normalizeScientificNumbers<T>(obj: T): ScientificToString<T>;
 /**
  * Determines whether a request should be retried based on the provided error.
  *
@@ -667,7 +694,7 @@ declare function buildUserAgent(packageName: string, packageVersion: string): st
 declare function buildWebsocketAPIMessage(configuration: ConfigurationWebsocketAPI, method: string, payload: WebsocketSendMsgOptions, options: WebsocketSendMsgConfig, skipAuth?: boolean): {
     id: string;
     method: string;
-    params: SendMessageOptions;
+    params: Record<string, unknown>;
 };
 /**
  * Sanitizes a header value by checking for and preventing carriage return and line feed characters.
@@ -694,6 +721,10 @@ declare class WebsocketEventEmitter {
     off(event: 'open' | 'message' | 'error' | 'close' | 'ping' | 'pong', listener: (...args: any[]) => void): void;
     protected emit(event: 'open' | 'message' | 'error' | 'close' | 'ping' | 'pong', ...args: any[]): void;
 }
+interface TimerRecord {
+    timer?: NodeJS.Timeout;
+    type: 'timeout' | 'interval';
+}
 interface WebsocketConnection {
     id: string;
     reconnectionPending: boolean;
@@ -717,7 +748,7 @@ declare class WebsocketCommon extends WebsocketEventEmitter {
     private static readonly MAX_CONNECTION_DURATION;
     private readonly connectionQueue;
     private queueProcessing;
-    private connectionTimers;
+    protected connectionTimers: Map<WebSocketClient, Set<TimerRecord>>;
     private mode;
     private poolSize;
     private roundRobinIndex;
@@ -767,13 +798,13 @@ declare class WebsocketCommon extends WebsocketEventEmitter {
      * @param type Timer type ('timeout' or 'interval')
      * @returns Timer handle
      */
-    private scheduleTimer;
+    protected scheduleTimer(connection: WebSocketClient, callback: () => void, delay: number, type?: 'timeout' | 'interval'): NodeJS.Timeout;
     /**
      * Clears all timers associated with a WebSocket connection.
      * @param connection - The WebSocket client instance to clear timers for.
      * @returns void
      */
-    private clearTimers;
+    protected clearTimers(connection: WebSocketClient): void;
     /**
      * Processes the connection queue, reconnecting or renewing connections as needed.
      * This method is responsible for iterating through the connection queue and initiating
@@ -1052,4 +1083,4 @@ interface WebsocketStream<T> {
  */
 declare function createStreamHandler<T>(websocketBase: WebsocketAPIBase | WebsocketStreamsBase, streamOrId: string, id?: string): WebsocketStream<T>;
 
-export { ALGO_REST_API_PROD_URL, AUTO_INVEST_REST_API_PROD_URL, type AxiosRequestArgs, BadRequestError, C2C_REST_API_PROD_URL, CONVERT_REST_API_PROD_URL, COPY_TRADING_REST_API_PROD_URL, CRYPTO_LOAN_REST_API_PROD_URL, ConfigurationRestAPI, ConfigurationWebsocketAPI, ConfigurationWebsocketStreams, ConnectorClientError, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL, DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_TESTNET_URL, DUAL_INVESTMENT_REST_API_PROD_URL, FIAT_REST_API_PROD_URL, ForbiddenError, GIFT_CARD_REST_API_PROD_URL, LogLevel, Logger, MARGIN_TRADING_REST_API_PROD_URL, MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL, MARGIN_TRADING_WS_STREAMS_PROD_URL, MINING_REST_API_PROD_URL, NFT_REST_API_PROD_URL, NetworkError, NotFoundError, type ObjectType, PAY_REST_API_PROD_URL, REBATE_REST_API_PROD_URL, RateLimitBanError, type RequestArgs, RequiredError, type RestApiRateLimit, type RestApiResponse, SIMPLE_EARN_REST_API_PROD_URL, SPOT_REST_API_MARKET_URL, SPOT_REST_API_PROD_URL, SPOT_REST_API_TESTNET_URL, SPOT_WS_API_PROD_URL, SPOT_WS_API_TESTNET_URL, SPOT_WS_STREAMS_MARKET_URL, SPOT_WS_STREAMS_PROD_URL, SPOT_WS_STREAMS_TESTNET_URL, STAKING_REST_API_PROD_URL, SUB_ACCOUNT_REST_API_PROD_URL, type SendMessageOptions, ServerError, TimeUnit, TooManyRequestsError, UnauthorizedError, VIP_LOAN_REST_API_PROD_URL, WALLET_REST_API_PROD_URL, WebsocketAPIBase, type WebsocketApiRateLimit, type WebsocketApiResponse, WebsocketCommon, type WebsocketConnection, WebsocketEventEmitter, type WebsocketSendMsgConfig, type WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, buildUserAgent, buildWebsocketAPIMessage, clearSignerCache, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, parseCustomHeaders, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sanitizeHeaderValue, sendRequest, setFlattenedQueryParams, setSearchParams, shouldRetryRequest, sortObject, toPathString, validateTimeUnit };
+export { ALGO_REST_API_PROD_URL, AUTO_INVEST_REST_API_PROD_URL, type AxiosRequestArgs, BadRequestError, C2C_REST_API_PROD_URL, CONVERT_REST_API_PROD_URL, COPY_TRADING_REST_API_PROD_URL, CRYPTO_LOAN_REST_API_PROD_URL, ConfigurationRestAPI, ConfigurationWebsocketAPI, ConfigurationWebsocketStreams, ConnectorClientError, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL, DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_REST_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_API_TESTNET_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_PROD_URL, DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_TESTNET_URL, DUAL_INVESTMENT_REST_API_PROD_URL, FIAT_REST_API_PROD_URL, ForbiddenError, GIFT_CARD_REST_API_PROD_URL, LogLevel, Logger, MARGIN_TRADING_REST_API_PROD_URL, MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL, MARGIN_TRADING_WS_STREAMS_PROD_URL, MINING_REST_API_PROD_URL, NFT_REST_API_PROD_URL, NetworkError, NotFoundError, type ObjectType, PAY_REST_API_PROD_URL, REBATE_REST_API_PROD_URL, RateLimitBanError, type RequestArgs, RequiredError, type RestApiRateLimit, type RestApiResponse, SIMPLE_EARN_REST_API_PROD_URL, SPOT_REST_API_MARKET_URL, SPOT_REST_API_PROD_URL, SPOT_REST_API_TESTNET_URL, SPOT_WS_API_PROD_URL, SPOT_WS_API_TESTNET_URL, SPOT_WS_STREAMS_MARKET_URL, SPOT_WS_STREAMS_PROD_URL, SPOT_WS_STREAMS_TESTNET_URL, STAKING_REST_API_PROD_URL, SUB_ACCOUNT_REST_API_PROD_URL, type SendMessageOptions, ServerError, TimeUnit, type TimerRecord, TooManyRequestsError, UnauthorizedError, VIP_LOAN_REST_API_PROD_URL, WALLET_REST_API_PROD_URL, WebsocketAPIBase, type WebsocketApiRateLimit, type WebsocketApiResponse, WebsocketCommon, type WebsocketConnection, WebsocketEventEmitter, type WebsocketSendMsgConfig, type WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, buildUserAgent, buildWebsocketAPIMessage, clearSignerCache, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, normalizeScientificNumbers, parseCustomHeaders, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sanitizeHeaderValue, sendRequest, setFlattenedQueryParams, setSearchParams, shouldRetryRequest, sortObject, toPathString, validateTimeUnit };

package/dist/index.js

@@ -109,6 +109,7 @@ __export(index_exports, {
   getSignature: () => getSignature,
   getTimestamp: () => getTimestamp,
   httpRequestFunction: () => httpRequestFunction,
+  normalizeScientificNumbers: () => normalizeScientificNumbers,
   parseCustomHeaders: () => parseCustomHeaders,
   parseRateLimitHeaders: () => parseRateLimitHeaders,
   randomString: () => randomString,
@@ -249,6 +250,39 @@ var setSearchParams = function(url, ...objects) {
 var toPathString = function(url) {
   return url.pathname + url.search + url.hash;
 };
+function normalizeScientificNumbers(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => normalizeScientificNumbers(item));
+  } else if (typeof obj === "object" && obj !== null) {
+    const result = {};
+    for (const key of Object.keys(obj)) {
+      result[key] = normalizeScientificNumbers(obj[key]);
+    }
+    return result;
+  } else if (typeof obj === "number") {
+    if (!Number.isFinite(obj)) return obj;
+    const abs = Math.abs(obj);
+    if (abs === 0 || abs >= 1e-6 && abs < 1e21) return String(obj);
+    const isNegative = obj < 0;
+    const [rawMantissa, rawExponent] = abs.toExponential().split("e");
+    const exponent = +rawExponent;
+    const digits = rawMantissa.replace(".", "");
+    if (exponent < 0) {
+      const zeros = "0".repeat(Math.abs(exponent) - 1);
+      return (isNegative ? "-" : "") + "0." + zeros + digits;
+    } else {
+      const pad = exponent - (digits.length - 1);
+      if (pad >= 0) {
+        return (isNegative ? "-" : "") + digits + "0".repeat(pad);
+      } else {
+        const point = digits.length + pad;
+        return (isNegative ? "-" : "") + digits.slice(0, point) + "." + digits.slice(point);
+      }
+    }
+  } else {
+    return obj;
+  }
+}
 var shouldRetryRequest = function(error, method, retriesLeft) {
   const isRetriableMethod = ["GET", "DELETE"].includes(method ?? "");
   const isRetriableStatus = [500, 502, 503, 504].includes(
@@ -410,7 +444,7 @@ var sendRequest = function(configuration, endpoint, method, params = {}, timeUni
     method,
     ...configuration?.baseOptions
   };
-  const localVarQueryParameter = { ...params };
+  const localVarQueryParameter = { ...normalizeScientificNumbers(params) };
   if (options.isSigned) {
     const timestamp = getTimestamp();
     localVarQueryParameter["timestamp"] = timestamp;
@@ -481,7 +515,7 @@ function buildUserAgent(packageName, packageVersion) {
 function buildWebsocketAPIMessage(configuration, method, payload, options, skipAuth = false) {
   const id = payload.id && /^[0-9a-f]{32}$/.test(payload.id) ? payload.id : randomString();
   delete payload.id;
-  let params = removeEmptyValue(payload);
+  let params = normalizeScientificNumbers(removeEmptyValue(payload));
   if ((options.withApiKey || options.isSigned) && !skipAuth) params.apiKey = configuration.apiKey;
   if (options.isSigned) {
     params.timestamp = getTimestamp();
@@ -504,7 +538,7 @@ function parseCustomHeaders(headers) {
   for (const [rawName, rawValue] of Object.entries(headers || {})) {
     const name = rawName.trim();
     if (forbidden.has(name.toLowerCase())) {
-      console.warn(`Dropping forbidden header: ${name}`);
+      Logger.getInstance().warn(`Dropping forbidden header: ${name}`);
       continue;
     }
     try {
@@ -724,33 +758,27 @@ var Logger = class _Logger {
       "warn" /* WARN */,
       "error" /* ERROR */
     ];
+    const envLevel = process.env.LOG_LEVEL?.toLowerCase();
+    this.minLogLevel = envLevel && this.isValidLogLevel(envLevel) ? envLevel : "info" /* INFO */;
   }
   static getInstance() {
-    if (!_Logger.instance) {
-      _Logger.instance = new _Logger();
-    }
+    if (!_Logger.instance) _Logger.instance = new _Logger();
     return _Logger.instance;
   }
   setMinLogLevel(level) {
-    if (!this.isValidLogLevel(level)) {
-      throw new Error(`Invalid log level: ${level}`);
-    }
+    if (!this.isValidLogLevel(level)) throw new Error(`Invalid log level: ${level}`);
     this.minLogLevel = level;
   }
   isValidLogLevel(level) {
     return this.levelsOrder.includes(level);
   }
   log(level, ...message) {
-    if (level === "" /* NONE */ || !this.allowLevelLog(level)) {
-      return;
-    }
+    if (level === "" /* NONE */ || !this.allowLevelLog(level)) return;
     const timestamp = (/* @__PURE__ */ new Date()).toISOString();
     console[level](`[${timestamp}] [${level.toLowerCase()}]`, ...message);
   }
   allowLevelLog(level) {
-    if (!this.isValidLogLevel(level)) {
-      throw new Error(`Invalid log level: ${level}`);
-    }
+    if (!this.isValidLogLevel(level)) throw new Error(`Invalid log level: ${level}`);
     const currentLevelIndex = this.levelsOrder.indexOf(level);
     const minLevelIndex = this.levelsOrder.indexOf(this.minLogLevel);
     return currentLevelIndex >= minLevelIndex;
@@ -877,10 +905,24 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * @returns Timer handle
    */
   scheduleTimer(connection, callback, delay2, type = "timeout") {
-    const timer = type === "timeout" ? setTimeout(callback, delay2) : setInterval(callback, delay2);
-    if (!this.connectionTimers.has(connection))
-      this.connectionTimers.set(connection, /* @__PURE__ */ new Set());
-    this.connectionTimers.get(connection)?.add({ timer, type });
+    let timers = this.connectionTimers.get(connection);
+    if (!timers) {
+      timers = /* @__PURE__ */ new Set();
+      this.connectionTimers.set(connection, timers);
+    }
+    const timerRecord = { type };
+    const wrappedTimeout = () => {
+      try {
+        callback();
+      } finally {
+        timers.delete(timerRecord);
+      }
+    };
+    let timer;
+    if (type === "timeout") timer = setTimeout(wrappedTimeout, delay2);
+    else timer = setInterval(callback, delay2);
+    timerRecord.timer = timer;
+    timers.add(timerRecord);
     return timer;
   }
   /**
@@ -1142,13 +1184,13 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
       this.onMessage(data.toString(), targetConnection);
     });
     ws.on("ping", () => {
-      this.logger.info("Received PING from server");
+      this.logger.debug("Received PING from server");
       this.emit("ping");
       ws.pong();
-      this.logger.info("Responded PONG to server's PING message");
+      this.logger.debug("Responded PONG to server's PING message");
     });
     ws.on("pong", () => {
-      this.logger.info("Received PONG from server");
+      this.logger.debug("Received PONG from server");
       this.emit("pong");
     });
     ws.on("error", (err) => {
@@ -1228,7 +1270,7 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
       this.logger.warn("Ping only can be sent when connection is ready.");
       return;
     }
-    this.logger.info("Sending PING to all connected Websocket servers.");
+    this.logger.debug("Sending PING to all connected Websocket servers.");
     connectedConnections.forEach((connection) => {
       if (connection.ws) {
         connection.ws.ping();
@@ -1250,7 +1292,7 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    */
   send(payload, id, promiseBased = true, timeout = 5e3, connection) {
     if (!this.isConnected(connection)) {
-      const errorMsg = "Send can only be sent when connection is ready.";
+      const errorMsg = "Unable to send message \u2014 connection is not available.";
       this.logger.warn(errorMsg);
       if (promiseBased) return Promise.reject(new Error(errorMsg));
       else throw new Error(errorMsg);
@@ -1266,17 +1308,22 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     if (promiseBased) {
       return new Promise((resolve, reject) => {
         if (!id) return reject(new Error("id is required for promise-based sending."));
-        connectionToUse.pendingRequests.set(id, { resolve, reject });
-        this.scheduleTimer(
-          connectionToUse.ws,
-          () => {
-            if (connectionToUse.pendingRequests.has(id)) {
-              connectionToUse.pendingRequests.delete(id);
-              reject(new Error(`Request timeout for id: ${id}`));
-            }
+        const timeoutHandle = setTimeout(() => {
+          if (connectionToUse.pendingRequests.has(id)) {
+            connectionToUse.pendingRequests.delete(id);
+            reject(new Error(`Request timeout for id: ${id}`));
+          }
+        }, timeout);
+        connectionToUse.pendingRequests.set(id, {
+          resolve: (v) => {
+            clearTimeout(timeoutHandle);
+            resolve(v);
           },
-          timeout
-        );
+          reject: (e) => {
+            clearTimeout(timeoutHandle);
+            reject(e);
+          }
+        });
       });
     }
   }
@@ -1356,13 +1403,13 @@ var WebsocketAPIBase = class extends WebsocketCommon {
         reject(new Error("Websocket connection timed out"));
       }, 1e4);
       this.connectPool(this.prepareURL(this.configuration.wsURL)).then(() => {
-        clearTimeout(timeout);
         this.isConnecting = false;
         resolve();
       }).catch((error) => {
-        clearTimeout(timeout);
         this.isConnecting = false;
         reject(error);
+      }).finally(() => {
+        clearTimeout(timeout);
       });
     });
   }
@@ -1475,7 +1522,7 @@ var WebsocketStreamsBase = class extends WebsocketCommon {
       params: streams,
       id: id && /^[0-9a-f]{32}$/.test(id) ? id : randomString()
     };
-    this.logger.info("SUBSCRIBE", payload);
+    this.logger.debug("SUBSCRIBE", payload);
     this.send(JSON.stringify(payload), void 0, false, 0, connection);
   }
   /**
@@ -1533,13 +1580,7 @@ var WebsocketStreamsBase = class extends WebsocketCommon {
       const timeout = setTimeout(() => {
         reject(new Error("Websocket connection timed out"));
       }, 1e4);
-      this.connectPool(this.prepareURL(streams)).then(() => {
-        clearTimeout(timeout);
-        resolve();
-      }).catch((error) => {
-        clearTimeout(timeout);
-        reject(error);
-      });
+      this.connectPool(this.prepareURL(streams)).then(() => resolve()).catch((error) => reject(error)).finally(() => clearTimeout(timeout));
     });
   }
   /**
@@ -1595,7 +1636,7 @@ var WebsocketStreamsBase = class extends WebsocketCommon {
           params: [stream2],
           id: id && /^[0-9a-f]{32}$/.test(id) ? id : randomString()
         };
-        this.logger.info("UNSUBSCRIBE", payload);
+        this.logger.debug("UNSUBSCRIBE", payload);
         this.send(JSON.stringify(payload), void 0, false, 0, connection);
         this.streamConnectionMap.delete(stream2);
         this.streamCallbackMap.delete(stream2);
@@ -1716,6 +1757,7 @@ function createStreamHandler(websocketBase, streamOrId, id) {
   getSignature,
   getTimestamp,
   httpRequestFunction,
+  normalizeScientificNumbers,
   parseCustomHeaders,
   parseRateLimitHeaders,
   randomString,