@binance/common 1.1.0 → 1.1.2

package/dist/index.d.mts

@@ -100,7 +100,7 @@ declare class ConfigurationRestAPI {
         };
     };
     /**
-     * enables keep-alive functionality for the connection
+     * enables keep-alive functionality for the connection (if httpsAgent is set then we use httpsAgent.keepAlive instead)
      * @default true
      * @type {boolean}
      * @memberof ConfigurationRestAPI
@@ -152,12 +152,6 @@ declare class ConfigurationRestAPI {
      * @memberof ConfigurationRestAPI
      */
     timeUnit?: TimeUnit;
-    /**
-     * base options for axios calls
-     * @type {Record<string, unknown>}
-     * @memberof ConfigurationRestAPI
-     */
-    baseOptions?: Record<string, unknown>;
     constructor(param?: ConfigurationRestAPI);
 }
 declare class ConfigurationWebsocketAPI {
@@ -485,6 +479,13 @@ interface RequestArgs {
     timeUnit?: TimeUnit;
 }
 
+/**
+ * Resets the signer cache to a new empty WeakMap.
+ *
+ * This function clears the existing signer cache, creating a fresh WeakMap
+ * to store RequestSigner instances associated with configuration objects.
+ */
+declare const clearSignerCache: () => void;
 /**
  * Generates a query string from an object of parameters.
  *
@@ -520,11 +521,11 @@ declare function delay(ms: number): Promise<void>;
  */
 declare function getTimestamp(): number;
 /**
- * Generates a signature for a signed request based on the provided configuration.
+ * Generates a signature for the given configuration and query parameters using a cached request signer.
  *
- * @param configuration - The configuration object containing the API secret or private key information.
- * @param queryParams - The object containing the query parameters to be signed.
- * @returns The generated signature as a string.
+ * @param configuration - Configuration object containing API secret, private key, and optional passphrase.
+ * @param queryParams - The query parameters to be signed.
+ * @returns A string representing the generated signature.
  */
 declare const getSignature: (configuration: {
     apiSecret?: string;
@@ -540,6 +541,20 @@ declare const getSignature: (configuration: {
  * @throws {RequiredError} If the parameter is null or undefined.
  */
 declare const assertParamExists: (functionName: string, paramName: string, paramValue: unknown) => void;
+/**
+ * Recursively flattens an object or array into URL search parameters.
+ *
+ * This function handles nested objects and arrays by converting them into dot-notation query parameters.
+ * It supports different types of parameters:
+ * - Arrays can be stringified or recursively added
+ * - Objects are flattened with dot notation keys
+ * - Primitive values are converted to strings
+ *
+ * @param urlSearchParams The URLSearchParams object to modify
+ * @param parameter The parameter to flatten (can be an object, array, or primitive)
+ * @param key Optional key for nested parameters, used for creating dot-notation keys
+ */
+declare function setFlattenedQueryParams(urlSearchParams: URLSearchParams, parameter: unknown, key?: string): void;
 /**
  * Sets the search parameters of the provided URL by flattening the given objects into the URL's search parameters.
  *
@@ -613,6 +628,14 @@ declare function sortObject(obj: ObjectType): ObjectType;
  * @returns {string} - The resulting string with placeholders replaced by their corresponding values.
  */
 declare function replaceWebsocketStreamsPlaceholders(str: string, variables: Record<string, unknown>): string;
+/**
+ * Generates a standardized user agent string for the application.
+ *
+ * @param {string} packageName - The name of the package/application.
+ * @param {string} packageVersion - The version of the package/application.
+ * @returns {string} A formatted user agent string including package details, Node.js version, platform, and architecture.
+ */
+declare function buildUserAgent(packageName: string, packageVersion: string): string;
 
 declare class WebsocketEventEmitter {
     private eventEmitter;
@@ -960,4 +983,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_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_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, 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 WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sendRequest, 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_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_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, 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 WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, buildUserAgent, clearSignerCache, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sendRequest, setFlattenedQueryParams, setSearchParams, shouldRetryRequest, sortObject, toPathString, validateTimeUnit };

package/dist/index.d.ts

@@ -100,7 +100,7 @@ declare class ConfigurationRestAPI {
         };
     };
     /**
-     * enables keep-alive functionality for the connection
+     * enables keep-alive functionality for the connection (if httpsAgent is set then we use httpsAgent.keepAlive instead)
      * @default true
      * @type {boolean}
      * @memberof ConfigurationRestAPI
@@ -152,12 +152,6 @@ declare class ConfigurationRestAPI {
      * @memberof ConfigurationRestAPI
      */
     timeUnit?: TimeUnit;
-    /**
-     * base options for axios calls
-     * @type {Record<string, unknown>}
-     * @memberof ConfigurationRestAPI
-     */
-    baseOptions?: Record<string, unknown>;
     constructor(param?: ConfigurationRestAPI);
 }
 declare class ConfigurationWebsocketAPI {
@@ -485,6 +479,13 @@ interface RequestArgs {
     timeUnit?: TimeUnit;
 }
 
+/**
+ * Resets the signer cache to a new empty WeakMap.
+ *
+ * This function clears the existing signer cache, creating a fresh WeakMap
+ * to store RequestSigner instances associated with configuration objects.
+ */
+declare const clearSignerCache: () => void;
 /**
  * Generates a query string from an object of parameters.
  *
@@ -520,11 +521,11 @@ declare function delay(ms: number): Promise<void>;
  */
 declare function getTimestamp(): number;
 /**
- * Generates a signature for a signed request based on the provided configuration.
+ * Generates a signature for the given configuration and query parameters using a cached request signer.
  *
- * @param configuration - The configuration object containing the API secret or private key information.
- * @param queryParams - The object containing the query parameters to be signed.
- * @returns The generated signature as a string.
+ * @param configuration - Configuration object containing API secret, private key, and optional passphrase.
+ * @param queryParams - The query parameters to be signed.
+ * @returns A string representing the generated signature.
  */
 declare const getSignature: (configuration: {
     apiSecret?: string;
@@ -540,6 +541,20 @@ declare const getSignature: (configuration: {
  * @throws {RequiredError} If the parameter is null or undefined.
  */
 declare const assertParamExists: (functionName: string, paramName: string, paramValue: unknown) => void;
+/**
+ * Recursively flattens an object or array into URL search parameters.
+ *
+ * This function handles nested objects and arrays by converting them into dot-notation query parameters.
+ * It supports different types of parameters:
+ * - Arrays can be stringified or recursively added
+ * - Objects are flattened with dot notation keys
+ * - Primitive values are converted to strings
+ *
+ * @param urlSearchParams The URLSearchParams object to modify
+ * @param parameter The parameter to flatten (can be an object, array, or primitive)
+ * @param key Optional key for nested parameters, used for creating dot-notation keys
+ */
+declare function setFlattenedQueryParams(urlSearchParams: URLSearchParams, parameter: unknown, key?: string): void;
 /**
  * Sets the search parameters of the provided URL by flattening the given objects into the URL's search parameters.
  *
@@ -613,6 +628,14 @@ declare function sortObject(obj: ObjectType): ObjectType;
  * @returns {string} - The resulting string with placeholders replaced by their corresponding values.
  */
 declare function replaceWebsocketStreamsPlaceholders(str: string, variables: Record<string, unknown>): string;
+/**
+ * Generates a standardized user agent string for the application.
+ *
+ * @param {string} packageName - The name of the package/application.
+ * @param {string} packageVersion - The version of the package/application.
+ * @returns {string} A formatted user agent string including package details, Node.js version, platform, and architecture.
+ */
+declare function buildUserAgent(packageName: string, packageVersion: string): string;
 
 declare class WebsocketEventEmitter {
     private eventEmitter;
@@ -960,4 +983,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_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_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, 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 WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sendRequest, 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_REST_API_PROD_URL, DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_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, 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 WebsocketSendMsgOptions, type WebsocketStream, WebsocketStreamsBase, assertParamExists, buildQueryString, buildUserAgent, clearSignerCache, createStreamHandler, delay, getSignature, getTimestamp, httpRequestFunction, parseRateLimitHeaders, randomString, removeEmptyValue, replaceWebsocketStreamsPlaceholders, sendRequest, setFlattenedQueryParams, setSearchParams, shouldRetryRequest, sortObject, toPathString, validateTimeUnit };

package/dist/index.js

@@ -96,6 +96,8 @@ __export(index_exports, {
   WebsocketStreamsBase: () => WebsocketStreamsBase,
   assertParamExists: () => assertParamExists,
   buildQueryString: () => buildQueryString,
+  buildUserAgent: () => buildUserAgent,
+  clearSignerCache: () => clearSignerCache,
   createStreamHandler: () => createStreamHandler,
   delay: () => delay,
   getSignature: () => getSignature,
@@ -106,6 +108,7 @@ __export(index_exports, {
   removeEmptyValue: () => removeEmptyValue,
   replaceWebsocketStreamsPlaceholders: () => replaceWebsocketStreamsPlaceholders,
   sendRequest: () => sendRequest,
+  setFlattenedQueryParams: () => setFlattenedQueryParams,
   setSearchParams: () => setSearchParams,
   shouldRetryRequest: () => shouldRetryRequest,
   sortObject: () => sortObject,
@@ -364,7 +367,54 @@ var Logger = class _Logger {
 var import_crypto = __toESM(require("crypto"));
 var import_fs = __toESM(require("fs"));
 var import_https = __toESM(require("https"));
+var import_os = require("os");
 var import_axios = __toESM(require("axios"));
+var signerCache = /* @__PURE__ */ new WeakMap();
+var RequestSigner = class {
+  constructor(configuration) {
+    if (configuration.apiSecret && !configuration.privateKey) {
+      this.apiSecret = configuration.apiSecret;
+      return;
+    }
+    if (configuration.privateKey) {
+      let privateKey = configuration.privateKey;
+      if (typeof privateKey === "string" && import_fs.default.existsSync(privateKey)) {
+        privateKey = import_fs.default.readFileSync(privateKey, "utf-8");
+      }
+      const keyInput = { key: privateKey };
+      if (configuration.privateKeyPassphrase && typeof configuration.privateKeyPassphrase === "string") {
+        keyInput.passphrase = configuration.privateKeyPassphrase;
+      }
+      try {
+        this.keyObject = import_crypto.default.createPrivateKey(keyInput);
+        this.keyType = this.keyObject.asymmetricKeyType;
+      } catch {
+        throw new Error(
+          "Invalid private key. Please provide a valid RSA or ED25519 private key."
+        );
+      }
+      return;
+    }
+    throw new Error("Either 'apiSecret' or 'privateKey' must be provided for signed requests.");
+  }
+  sign(queryParams) {
+    const params = buildQueryString(queryParams);
+    if (this.apiSecret)
+      return import_crypto.default.createHmac("sha256", this.apiSecret).update(params).digest("hex");
+    if (this.keyObject && this.keyType) {
+      const data = Buffer.from(params);
+      if (this.keyType === "rsa")
+        return import_crypto.default.sign("RSA-SHA256", data, this.keyObject).toString("base64");
+      if (this.keyType === "ed25519")
+        return import_crypto.default.sign(null, data, this.keyObject).toString("base64");
+      throw new Error("Unsupported private key type. Must be RSA or ED25519.");
+    }
+    throw new Error("Signer is not properly initialized.");
+  }
+};
+var clearSignerCache = function() {
+  signerCache = /* @__PURE__ */ new WeakMap();
+};
 function buildQueryString(params) {
   if (!params) return "";
   return Object.entries(params).map(stringifyKeyValuePair).join("&");
@@ -391,39 +441,12 @@ function getTimestamp() {
   return Date.now();
 }
 var getSignature = function(configuration, queryParams) {
-  const params = buildQueryString(queryParams);
-  let signature = "";
-  if (configuration?.apiSecret && !configuration?.privateKey) {
-    signature = import_crypto.default.createHmac("sha256", configuration.apiSecret).update(params).digest("hex");
-  } else if (configuration?.privateKey) {
-    let privateKey = configuration.privateKey;
-    if (typeof privateKey === "string" && import_fs.default.existsSync(privateKey)) {
-      privateKey = import_fs.default.readFileSync(privateKey, "utf-8");
-    }
-    let keyObject;
-    try {
-      const privateKeyObj = { key: privateKey };
-      if (configuration.privateKeyPassphrase && typeof configuration.privateKeyPassphrase === "string") {
-        privateKeyObj.passphrase = configuration.privateKeyPassphrase;
-      }
-      keyObject = import_crypto.default.createPrivateKey(privateKeyObj);
-    } catch {
-      throw new Error(
-        "Invalid private key. Please provide a valid RSA or ED25519 private key."
-      );
-    }
-    const keyType = keyObject.asymmetricKeyType;
-    if (keyType === "rsa") {
-      signature = import_crypto.default.sign("RSA-SHA256", Buffer.from(params), keyObject).toString("base64");
-    } else if (keyType === "ed25519") {
-      signature = import_crypto.default.sign(null, Buffer.from(params), keyObject).toString("base64");
-    } else {
-      throw new Error("Unsupported private key type. Must be RSA or ED25519.");
-    }
-  } else {
-    throw new Error("Either 'apiSecret' or 'privateKey' must be provided for signed requests.");
+  let signer = signerCache.get(configuration);
+  if (!signer) {
+    signer = new RequestSigner(configuration);
+    signerCache.set(configuration, signer);
   }
-  return signature;
+  return signer.sign(queryParams);
 };
 var assertParamExists = function(functionName, paramName, paramValue) {
   if (paramValue === null || paramValue === void 0) {
@@ -435,25 +458,26 @@ var assertParamExists = function(functionName, paramName, paramValue) {
 };
 function setFlattenedQueryParams(urlSearchParams, parameter, key = "") {
   if (parameter == null) return;
+  if (Array.isArray(parameter)) {
+    if (key)
+      urlSearchParams.set(key, JSON.stringify(parameter));
+    else
+      for (const item of parameter) {
+        setFlattenedQueryParams(urlSearchParams, item, "");
+      }
+    return;
+  }
   if (typeof parameter === "object") {
-    if (Array.isArray(parameter)) {
-      parameter.forEach((item) => setFlattenedQueryParams(urlSearchParams, item, key));
-    } else {
-      Object.keys(parameter).forEach(
-        (currentKey) => setFlattenedQueryParams(
-          urlSearchParams,
-          parameter[currentKey],
-          `${key}${key !== "" ? "." : ""}${currentKey}`
-        )
-      );
-    }
-  } else {
-    if (urlSearchParams.has(key)) {
-      urlSearchParams.append(key, String(parameter));
-    } else {
-      urlSearchParams.set(key, String(parameter));
+    for (const subKey of Object.keys(parameter)) {
+      const subVal = parameter[subKey];
+      const newKey = key ? `${key}.${subKey}` : subKey;
+      setFlattenedQueryParams(urlSearchParams, subVal, newKey);
     }
+    return;
   }
+  const str = String(parameter);
+  if (urlSearchParams.has(key)) urlSearchParams.append(key, str);
+  else urlSearchParams.set(key, str);
 }
 var setSearchParams = function(url, ...objects) {
   const searchParams = new URLSearchParams(url.search);
@@ -475,18 +499,13 @@ var httpRequestFunction = async function(axiosArgs, configuration) {
     ...axiosArgs.options,
     url: (import_axios.default.defaults?.baseURL ? "" : configuration?.basePath ?? "") + axiosArgs.url
   };
-  if (configuration?.keepAlive) {
-    axiosRequestArgs.httpsAgent = new import_https.default.Agent({
-      ...configuration?.baseOptions?.httpsAgent instanceof import_https.default.Agent ? configuration.baseOptions.httpsAgent.options : {},
-      keepAlive: true
-    });
-  }
-  if (configuration?.compression) {
+  if (configuration?.keepAlive && !configuration?.baseOptions?.httpsAgent)
+    axiosRequestArgs.httpsAgent = new import_https.default.Agent({ keepAlive: true });
+  if (configuration?.compression)
     axiosRequestArgs.headers = {
       ...axiosRequestArgs.headers,
       "Accept-Encoding": "gzip, deflate, br"
     };
-  }
   const retries = configuration?.retries ?? 0;
   const backoff = configuration?.backoff ?? 0;
   let attempt = 0;
@@ -694,6 +713,9 @@ function replaceWebsocketStreamsPlaceholders(str, variables) {
     return "";
   });
 }
+function buildUserAgent(packageName, packageVersion) {
+  return `${packageName}/${packageVersion} (Node.js/${process.version}; ${(0, import_os.platform)()}; ${(0, import_os.arch)()})`;
+}
 
 // src/websocket.ts
 var import_events = require("events");
@@ -962,10 +984,13 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * @returns A new WebSocket client instance.
    */
   createWebSocket(url) {
-    return new import_ws.default(url, {
+    const wsClientOptions = {
       perMessageDeflate: this.configuration?.compression,
       agent: this.configuration?.agent
-    });
+    };
+    if (this.configuration.userAgent)
+      wsClientOptions.headers = { "User-Agent": this.configuration.userAgent };
+    return new import_ws.default(url, wsClientOptions);
   }
   /**
    * Initializes a WebSocket connection.
@@ -1565,6 +1590,8 @@ function createStreamHandler(websocketBase, streamOrId, id) {
   WebsocketStreamsBase,
   assertParamExists,
   buildQueryString,
+  buildUserAgent,
+  clearSignerCache,
   createStreamHandler,
   delay,
   getSignature,
@@ -1575,6 +1602,7 @@ function createStreamHandler(websocketBase, streamOrId, id) {
   removeEmptyValue,
   replaceWebsocketStreamsPlaceholders,
   sendRequest,
+  setFlattenedQueryParams,
   setSearchParams,
   shouldRetryRequest,
   sortObject,