@binance/common 1.1.3 → 1.2.0

package/dist/index.js

@@ -38,7 +38,7 @@ __export(index_exports, {
   COPY_TRADING_REST_API_PROD_URL: () => COPY_TRADING_REST_API_PROD_URL,
   CRYPTO_LOAN_REST_API_PROD_URL: () => CRYPTO_LOAN_REST_API_PROD_URL,
   ConfigurationRestAPI: () => ConfigurationRestAPI,
-  ConfigurationWebsocketAPI: () => ConfigurationWebsocketAPI,
+  ConfigurationWebsocketAPI: () => ConfigurationWebsocketAPI2,
   ConfigurationWebsocketStreams: () => ConfigurationWebsocketStreams,
   ConnectorClientError: () => ConnectorClientError,
   DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL: () => DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL,
@@ -102,16 +102,19 @@ __export(index_exports, {
   assertParamExists: () => assertParamExists,
   buildQueryString: () => buildQueryString,
   buildUserAgent: () => buildUserAgent,
+  buildWebsocketAPIMessage: () => buildWebsocketAPIMessage,
   clearSignerCache: () => clearSignerCache,
   createStreamHandler: () => createStreamHandler,
   delay: () => delay,
   getSignature: () => getSignature,
   getTimestamp: () => getTimestamp,
   httpRequestFunction: () => httpRequestFunction,
+  parseCustomHeaders: () => parseCustomHeaders,
   parseRateLimitHeaders: () => parseRateLimitHeaders,
   randomString: () => randomString,
   removeEmptyValue: () => removeEmptyValue,
   replaceWebsocketStreamsPlaceholders: () => replaceWebsocketStreamsPlaceholders,
+  sanitizeHeaderValue: () => sanitizeHeaderValue,
   sendRequest: () => sendRequest,
   setFlattenedQueryParams: () => setFlattenedQueryParams,
   setSearchParams: () => setSearchParams,
@@ -122,257 +125,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/configuration.ts
-var ConfigurationRestAPI = class {
-  constructor(param = { apiKey: "" }) {
-    this.apiKey = param.apiKey;
-    this.apiSecret = param.apiSecret;
-    this.basePath = param.basePath;
-    this.keepAlive = param.keepAlive ?? true;
-    this.compression = param.compression ?? true;
-    this.retries = param.retries ?? 3;
-    this.backoff = param.backoff ?? 1e3;
-    this.privateKey = param.privateKey;
-    this.privateKeyPassphrase = param.privateKeyPassphrase;
-    this.timeUnit = param.timeUnit;
-    this.baseOptions = {
-      timeout: param.timeout ?? 1e3,
-      proxy: param.proxy && {
-        host: param.proxy.host,
-        port: param.proxy.port,
-        auth: param.proxy.auth
-      },
-      httpsAgent: param.httpsAgent ?? false,
-      headers: {
-        "Content-Type": "application/json",
-        "X-MBX-APIKEY": param.apiKey
-      }
-    };
-  }
-};
-var ConfigurationWebsocketAPI = class {
-  constructor(param = { apiKey: "" }) {
-    this.apiKey = param.apiKey;
-    this.apiSecret = param.apiSecret;
-    this.wsURL = param.wsURL;
-    this.timeout = param.timeout ?? 5e3;
-    this.reconnectDelay = param.reconnectDelay ?? 5e3;
-    this.compression = param.compression ?? true;
-    this.agent = param.agent ?? false;
-    this.mode = param.mode ?? "single";
-    this.poolSize = param.poolSize ?? 1;
-    this.privateKey = param.privateKey;
-    this.privateKeyPassphrase = param.privateKeyPassphrase;
-    this.timeUnit = param.timeUnit;
-  }
-};
-var ConfigurationWebsocketStreams = class {
-  constructor(param = {}) {
-    this.wsURL = param.wsURL;
-    this.reconnectDelay = param.reconnectDelay ?? 5e3;
-    this.compression = param.compression ?? true;
-    this.agent = param.agent ?? false;
-    this.mode = param.mode ?? "single";
-    this.poolSize = param.poolSize ?? 1;
-    this.timeUnit = param.timeUnit;
-  }
-};
-
-// src/constants.ts
-var TimeUnit = {
-  MILLISECOND: "MILLISECOND",
-  millisecond: "millisecond",
-  MICROSECOND: "MICROSECOND",
-  microsecond: "microsecond"
-};
-var ALGO_REST_API_PROD_URL = "https://api.binance.com";
-var AUTO_INVEST_REST_API_PROD_URL = "https://api.binance.com";
-var C2C_REST_API_PROD_URL = "https://api.binance.com";
-var CONVERT_REST_API_PROD_URL = "https://api.binance.com";
-var COPY_TRADING_REST_API_PROD_URL = "https://api.binance.com";
-var CRYPTO_LOAN_REST_API_PROD_URL = "https://api.binance.com";
-var DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL = "https://dapi.binance.com";
-var DERIVATIVES_TRADING_COIN_FUTURES_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
-var DERIVATIVES_TRADING_COIN_FUTURES_WS_API_PROD_URL = "wss://ws-dapi.binance.com/ws-dapi/v1";
-var DERIVATIVES_TRADING_COIN_FUTURES_WS_API_TESTNET_URL = "wss://testnet.binancefuture.com/ws-dapi/v1";
-var DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_PROD_URL = "wss://dstream.binance.com";
-var DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_TESTNET_URL = "wss://dstream.binancefuture.com";
-var DERIVATIVES_TRADING_USDS_FUTURES_REST_API_PROD_URL = "https://fapi.binance.com";
-var DERIVATIVES_TRADING_USDS_FUTURES_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
-var DERIVATIVES_TRADING_USDS_FUTURES_WS_API_PROD_URL = "wss://ws-fapi.binance.com/ws-fapi/v1";
-var DERIVATIVES_TRADING_USDS_FUTURES_WS_API_TESTNET_URL = "wss://testnet.binancefuture.com/ws-fapi/v1";
-var DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_PROD_URL = "wss://fstream.binance.com";
-var DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_TESTNET_URL = "wss://stream.binancefuture.com";
-var DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL = "https://eapi.binance.com";
-var DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL = "wss://nbstream.binance.com/eoptions";
-var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL = "https://papi.binance.com";
-var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
-var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL = "wss://fstream.binance.com/pm";
-var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL = "wss://fstream.binancefuture.com/pm";
-var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_PROD_URL = "https://api.binance.com";
-var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_WS_STREAMS_PROD_URL = "wss://fstream.binance.com/pm-classic";
-var DUAL_INVESTMENT_REST_API_PROD_URL = "https://api.binance.com";
-var FIAT_REST_API_PROD_URL = "https://api.binance.com";
-var GIFT_CARD_REST_API_PROD_URL = "https://api.binance.com";
-var MARGIN_TRADING_REST_API_PROD_URL = "https://api.binance.com";
-var MARGIN_TRADING_WS_STREAMS_PROD_URL = "wss://stream.binance.com:9443";
-var MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL = "wss://margin-stream.binance.com";
-var MINING_REST_API_PROD_URL = "https://api.binance.com";
-var NFT_REST_API_PROD_URL = "https://api.binance.com";
-var PAY_REST_API_PROD_URL = "https://api.binance.com";
-var REBATE_REST_API_PROD_URL = "https://api.binance.com";
-var SIMPLE_EARN_REST_API_PROD_URL = "https://api.binance.com";
-var SPOT_REST_API_PROD_URL = "https://api.binance.com";
-var SPOT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
-var SPOT_WS_API_PROD_URL = "wss://ws-api.binance.com:443/ws-api/v3";
-var SPOT_WS_API_TESTNET_URL = "wss://ws-api.testnet.binance.vision/ws-api/v3";
-var SPOT_WS_STREAMS_PROD_URL = "wss://stream.binance.com:9443";
-var SPOT_WS_STREAMS_TESTNET_URL = "wss://stream.testnet.binance.vision";
-var SPOT_REST_API_MARKET_URL = "https://data-api.binance.vision";
-var SPOT_WS_STREAMS_MARKET_URL = "wss://data-stream.binance.vision";
-var STAKING_REST_API_PROD_URL = "https://api.binance.com";
-var SUB_ACCOUNT_REST_API_PROD_URL = "https://api.binance.com";
-var VIP_LOAN_REST_API_PROD_URL = "https://api.binance.com";
-var WALLET_REST_API_PROD_URL = "https://api.binance.com";
-
-// src/errors.ts
-var ConnectorClientError = class _ConnectorClientError extends Error {
-  constructor(msg) {
-    super(msg || "An unexpected error occurred.");
-    Object.setPrototypeOf(this, _ConnectorClientError.prototype);
-    this.name = "ConnectorClientError";
-  }
-};
-var RequiredError = class _RequiredError extends Error {
-  constructor(field, msg) {
-    super(msg || `Required parameter ${field} was null or undefined.`);
-    this.field = field;
-    Object.setPrototypeOf(this, _RequiredError.prototype);
-    this.name = "RequiredError";
-  }
-};
-var UnauthorizedError = class _UnauthorizedError extends Error {
-  constructor(msg) {
-    super(msg || "Unauthorized access. Authentication required.");
-    Object.setPrototypeOf(this, _UnauthorizedError.prototype);
-    this.name = "UnauthorizedError";
-  }
-};
-var ForbiddenError = class _ForbiddenError extends Error {
-  constructor(msg) {
-    super(msg || "Access to the requested resource is forbidden.");
-    Object.setPrototypeOf(this, _ForbiddenError.prototype);
-    this.name = "ForbiddenError";
-  }
-};
-var TooManyRequestsError = class _TooManyRequestsError extends Error {
-  constructor(msg) {
-    super(msg || "Too many requests. You are being rate-limited.");
-    Object.setPrototypeOf(this, _TooManyRequestsError.prototype);
-    this.name = "TooManyRequestsError";
-  }
-};
-var RateLimitBanError = class _RateLimitBanError extends Error {
-  constructor(msg) {
-    super(msg || "The IP address has been banned for exceeding rate limits.");
-    Object.setPrototypeOf(this, _RateLimitBanError.prototype);
-    this.name = "RateLimitBanError";
-  }
-};
-var ServerError = class _ServerError extends Error {
-  constructor(msg, statusCode) {
-    super(msg || "An internal server error occurred.");
-    this.statusCode = statusCode;
-    Object.setPrototypeOf(this, _ServerError.prototype);
-    this.name = "ServerError";
-  }
-};
-var NetworkError = class _NetworkError extends Error {
-  constructor(msg) {
-    super(msg || "A network error occurred.");
-    Object.setPrototypeOf(this, _NetworkError.prototype);
-    this.name = "NetworkError";
-  }
-};
-var NotFoundError = class _NotFoundError extends Error {
-  constructor(msg) {
-    super(msg || "The requested resource was not found.");
-    Object.setPrototypeOf(this, _NotFoundError.prototype);
-    this.name = "NotFoundError";
-  }
-};
-var BadRequestError = class _BadRequestError extends Error {
-  constructor(msg) {
-    super(msg || "The request was invalid or cannot be otherwise served.");
-    Object.setPrototypeOf(this, _BadRequestError.prototype);
-    this.name = "BadRequestError";
-  }
-};
-
-// src/logger.ts
-var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2["NONE"] = "";
-  LogLevel2["DEBUG"] = "debug";
-  LogLevel2["INFO"] = "info";
-  LogLevel2["WARN"] = "warn";
-  LogLevel2["ERROR"] = "error";
-  return LogLevel2;
-})(LogLevel || {});
-var Logger = class _Logger {
-  constructor() {
-    this.minLogLevel = "info" /* INFO */;
-    this.levelsOrder = [
-      "" /* NONE */,
-      "debug" /* DEBUG */,
-      "info" /* INFO */,
-      "warn" /* WARN */,
-      "error" /* ERROR */
-    ];
-  }
-  static getInstance() {
-    if (!_Logger.instance) {
-      _Logger.instance = new _Logger();
-    }
-    return _Logger.instance;
-  }
-  setMinLogLevel(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;
-    }
-    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}`);
-    }
-    const currentLevelIndex = this.levelsOrder.indexOf(level);
-    const minLevelIndex = this.levelsOrder.indexOf(this.minLogLevel);
-    return currentLevelIndex >= minLevelIndex;
-  }
-  debug(...message) {
-    this.log("debug" /* DEBUG */, ...message);
-  }
-  info(...message) {
-    this.log("info" /* INFO */, ...message);
-  }
-  warn(...message) {
-    this.log("warn" /* WARN */, ...message);
-  }
-  error(...message) {
-    this.log("error" /* ERROR */, ...message);
-  }
-};
-
 // src/utils.ts
 var import_crypto = __toESM(require("crypto"));
 var import_fs = __toESM(require("fs"));
@@ -591,141 +343,431 @@ var httpRequestFunction = async function(axiosArgs, configuration) {
       }
     }
   }
-  throw lastError;
+  throw lastError;
+};
+var parseRateLimitHeaders = function(headers) {
+  const rateLimits = [];
+  const parseIntervalDetails = (key) => {
+    const match = key.match(/x-mbx-used-weight-(\d+)([smhd])|x-mbx-order-count-(\d+)([smhd])/i);
+    if (!match) return null;
+    const intervalNum = parseInt(match[1] || match[3], 10);
+    const intervalLetter = (match[2] || match[4])?.toUpperCase();
+    let interval;
+    switch (intervalLetter) {
+      case "S":
+        interval = "SECOND";
+        break;
+      case "M":
+        interval = "MINUTE";
+        break;
+      case "H":
+        interval = "HOUR";
+        break;
+      case "D":
+        interval = "DAY";
+        break;
+      default:
+        return null;
+    }
+    return { interval, intervalNum };
+  };
+  for (const [key, value] of Object.entries(headers)) {
+    const normalizedKey = key.toLowerCase();
+    if (value === void 0) continue;
+    if (normalizedKey.startsWith("x-mbx-used-weight-")) {
+      const details = parseIntervalDetails(normalizedKey);
+      if (details) {
+        rateLimits.push({
+          rateLimitType: "REQUEST_WEIGHT",
+          interval: details.interval,
+          intervalNum: details.intervalNum,
+          count: parseInt(value, 10)
+        });
+      }
+    } else if (normalizedKey.startsWith("x-mbx-order-count-")) {
+      const details = parseIntervalDetails(normalizedKey);
+      if (details) {
+        rateLimits.push({
+          rateLimitType: "ORDERS",
+          interval: details.interval,
+          intervalNum: details.intervalNum,
+          count: parseInt(value, 10)
+        });
+      }
+    }
+  }
+  if (headers["retry-after"]) {
+    const retryAfter = parseInt(headers["retry-after"], 10);
+    for (const limit of rateLimits) {
+      limit.retryAfter = retryAfter;
+    }
+  }
+  return rateLimits;
+};
+var sendRequest = function(configuration, endpoint, method, params = {}, timeUnit, options = {}) {
+  const localVarUrlObj = new URL(endpoint, configuration?.basePath);
+  const localVarRequestOptions = {
+    method,
+    ...configuration?.baseOptions
+  };
+  const localVarQueryParameter = { ...params };
+  if (options.isSigned) {
+    const timestamp = getTimestamp();
+    localVarQueryParameter["timestamp"] = timestamp;
+    const signature = getSignature(configuration, localVarQueryParameter);
+    if (signature) {
+      localVarQueryParameter["signature"] = signature;
+    }
+  }
+  setSearchParams(localVarUrlObj, localVarQueryParameter);
+  if (timeUnit && localVarRequestOptions.headers) {
+    const _timeUnit = validateTimeUnit(timeUnit);
+    localVarRequestOptions.headers = {
+      ...localVarRequestOptions.headers,
+      "X-MBX-TIME-UNIT": _timeUnit
+    };
+  }
+  return httpRequestFunction(
+    {
+      url: toPathString(localVarUrlObj),
+      options: localVarRequestOptions
+    },
+    configuration
+  );
+};
+function removeEmptyValue(obj) {
+  if (!(obj instanceof Object)) return {};
+  return Object.fromEntries(
+    Object.entries(obj).filter(
+      ([, value]) => value !== null && value !== void 0 && value !== ""
+    )
+  );
+}
+function sortObject(obj) {
+  return Object.keys(obj).sort().reduce((res, key) => {
+    res[key] = obj[key];
+    return res;
+  }, {});
+}
+function replaceWebsocketStreamsPlaceholders(str, variables) {
+  const normalizedVariables = Object.keys(variables).reduce(
+    (acc, key) => {
+      const normalizedKey = key.toLowerCase().replace(/[-_]/g, "");
+      acc[normalizedKey] = variables[key];
+      return acc;
+    },
+    {}
+  );
+  return str.replace(/(@)?<([^>]+)>/g, (match, precedingAt, fieldName) => {
+    const normalizedFieldName = fieldName.toLowerCase().replace(/[-_]/g, "");
+    if (Object.prototype.hasOwnProperty.call(normalizedVariables, normalizedFieldName) && normalizedVariables[normalizedFieldName] != null) {
+      const value = normalizedVariables[normalizedFieldName];
+      switch (normalizedFieldName) {
+        case "symbol":
+        case "windowsize":
+          return value.toLowerCase();
+        case "updatespeed":
+          return `@${value}`;
+        default:
+          return (precedingAt || "") + value;
+      }
+    }
+    return "";
+  });
+}
+function buildUserAgent(packageName, packageVersion) {
+  return `${packageName}/${packageVersion} (Node.js/${process.version}; ${(0, import_os.platform)()}; ${(0, import_os.arch)()})`;
+}
+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);
+  if ((options.withApiKey || options.isSigned) && !skipAuth) params.apiKey = configuration.apiKey;
+  if (options.isSigned) {
+    params.timestamp = getTimestamp();
+    params = sortObject(params);
+    if (!skipAuth) params.signature = getSignature(configuration, params);
+  }
+  return { id, method, params };
+}
+function sanitizeHeaderValue(value) {
+  const sanitizeOne = (v) => {
+    if (/\r|\n/.test(v)) throw new Error(`Invalid header value (contains CR/LF): "${v}"`);
+    return v;
+  };
+  return Array.isArray(value) ? value.map(sanitizeOne) : sanitizeOne(value);
+}
+function parseCustomHeaders(headers) {
+  if (!headers || Object.keys(headers).length === 0) return {};
+  const forbidden = /* @__PURE__ */ new Set(["host", "authorization", "cookie", ":method", ":path"]);
+  const parsedHeaders = {};
+  for (const [rawName, rawValue] of Object.entries(headers || {})) {
+    const name = rawName.trim();
+    if (forbidden.has(name.toLowerCase())) {
+      console.warn(`Dropping forbidden header: ${name}`);
+      continue;
+    }
+    try {
+      parsedHeaders[name] = sanitizeHeaderValue(rawValue);
+    } catch {
+      continue;
+    }
+  }
+  return parsedHeaders;
+}
+
+// src/configuration.ts
+var ConfigurationRestAPI = class {
+  constructor(param = { apiKey: "" }) {
+    this.apiKey = param.apiKey;
+    this.apiSecret = param.apiSecret;
+    this.basePath = param.basePath;
+    this.keepAlive = param.keepAlive ?? true;
+    this.compression = param.compression ?? true;
+    this.retries = param.retries ?? 3;
+    this.backoff = param.backoff ?? 1e3;
+    this.privateKey = param.privateKey;
+    this.privateKeyPassphrase = param.privateKeyPassphrase;
+    this.timeUnit = param.timeUnit;
+    this.baseOptions = {
+      timeout: param.timeout ?? 1e3,
+      proxy: param.proxy && {
+        host: param.proxy.host,
+        port: param.proxy.port,
+        auth: param.proxy.auth
+      },
+      httpsAgent: param.httpsAgent ?? false,
+      headers: {
+        ...parseCustomHeaders(param.customHeaders || {}),
+        "Content-Type": "application/json",
+        "X-MBX-APIKEY": param.apiKey
+      }
+    };
+  }
+};
+var ConfigurationWebsocketAPI2 = class {
+  constructor(param = { apiKey: "" }) {
+    this.apiKey = param.apiKey;
+    this.apiSecret = param.apiSecret;
+    this.wsURL = param.wsURL;
+    this.timeout = param.timeout ?? 5e3;
+    this.reconnectDelay = param.reconnectDelay ?? 5e3;
+    this.compression = param.compression ?? true;
+    this.agent = param.agent ?? false;
+    this.mode = param.mode ?? "single";
+    this.poolSize = param.poolSize ?? 1;
+    this.privateKey = param.privateKey;
+    this.privateKeyPassphrase = param.privateKeyPassphrase;
+    this.timeUnit = param.timeUnit;
+    this.autoSessionReLogon = param.autoSessionReLogon ?? true;
+  }
+};
+var ConfigurationWebsocketStreams = class {
+  constructor(param = {}) {
+    this.wsURL = param.wsURL;
+    this.reconnectDelay = param.reconnectDelay ?? 5e3;
+    this.compression = param.compression ?? true;
+    this.agent = param.agent ?? false;
+    this.mode = param.mode ?? "single";
+    this.poolSize = param.poolSize ?? 1;
+    this.timeUnit = param.timeUnit;
+  }
+};
+
+// src/constants.ts
+var TimeUnit = {
+  MILLISECOND: "MILLISECOND",
+  millisecond: "millisecond",
+  MICROSECOND: "MICROSECOND",
+  microsecond: "microsecond"
+};
+var ALGO_REST_API_PROD_URL = "https://api.binance.com";
+var AUTO_INVEST_REST_API_PROD_URL = "https://api.binance.com";
+var C2C_REST_API_PROD_URL = "https://api.binance.com";
+var CONVERT_REST_API_PROD_URL = "https://api.binance.com";
+var COPY_TRADING_REST_API_PROD_URL = "https://api.binance.com";
+var CRYPTO_LOAN_REST_API_PROD_URL = "https://api.binance.com";
+var DERIVATIVES_TRADING_COIN_FUTURES_REST_API_PROD_URL = "https://dapi.binance.com";
+var DERIVATIVES_TRADING_COIN_FUTURES_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
+var DERIVATIVES_TRADING_COIN_FUTURES_WS_API_PROD_URL = "wss://ws-dapi.binance.com/ws-dapi/v1";
+var DERIVATIVES_TRADING_COIN_FUTURES_WS_API_TESTNET_URL = "wss://testnet.binancefuture.com/ws-dapi/v1";
+var DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_PROD_URL = "wss://dstream.binance.com";
+var DERIVATIVES_TRADING_COIN_FUTURES_WS_STREAMS_TESTNET_URL = "wss://dstream.binancefuture.com";
+var DERIVATIVES_TRADING_USDS_FUTURES_REST_API_PROD_URL = "https://fapi.binance.com";
+var DERIVATIVES_TRADING_USDS_FUTURES_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
+var DERIVATIVES_TRADING_USDS_FUTURES_WS_API_PROD_URL = "wss://ws-fapi.binance.com/ws-fapi/v1";
+var DERIVATIVES_TRADING_USDS_FUTURES_WS_API_TESTNET_URL = "wss://testnet.binancefuture.com/ws-fapi/v1";
+var DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_PROD_URL = "wss://fstream.binance.com";
+var DERIVATIVES_TRADING_USDS_FUTURES_WS_STREAMS_TESTNET_URL = "wss://stream.binancefuture.com";
+var DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL = "https://eapi.binance.com";
+var DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL = "wss://nbstream.binance.com/eoptions";
+var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_PROD_URL = "https://papi.binance.com";
+var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_REST_API_TESTNET_URL = "https://testnet.binancefuture.com";
+var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_PROD_URL = "wss://fstream.binance.com/pm";
+var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_WS_STREAMS_TESTNET_URL = "wss://fstream.binancefuture.com/pm";
+var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_REST_API_PROD_URL = "https://api.binance.com";
+var DERIVATIVES_TRADING_PORTFOLIO_MARGIN_PRO_WS_STREAMS_PROD_URL = "wss://fstream.binance.com/pm-classic";
+var DUAL_INVESTMENT_REST_API_PROD_URL = "https://api.binance.com";
+var FIAT_REST_API_PROD_URL = "https://api.binance.com";
+var GIFT_CARD_REST_API_PROD_URL = "https://api.binance.com";
+var MARGIN_TRADING_REST_API_PROD_URL = "https://api.binance.com";
+var MARGIN_TRADING_WS_STREAMS_PROD_URL = "wss://stream.binance.com:9443";
+var MARGIN_TRADING_RISK_WS_STREAMS_PROD_URL = "wss://margin-stream.binance.com";
+var MINING_REST_API_PROD_URL = "https://api.binance.com";
+var NFT_REST_API_PROD_URL = "https://api.binance.com";
+var PAY_REST_API_PROD_URL = "https://api.binance.com";
+var REBATE_REST_API_PROD_URL = "https://api.binance.com";
+var SIMPLE_EARN_REST_API_PROD_URL = "https://api.binance.com";
+var SPOT_REST_API_PROD_URL = "https://api.binance.com";
+var SPOT_REST_API_TESTNET_URL = "https://testnet.binance.vision";
+var SPOT_WS_API_PROD_URL = "wss://ws-api.binance.com:443/ws-api/v3";
+var SPOT_WS_API_TESTNET_URL = "wss://ws-api.testnet.binance.vision/ws-api/v3";
+var SPOT_WS_STREAMS_PROD_URL = "wss://stream.binance.com:9443";
+var SPOT_WS_STREAMS_TESTNET_URL = "wss://stream.testnet.binance.vision";
+var SPOT_REST_API_MARKET_URL = "https://data-api.binance.vision";
+var SPOT_WS_STREAMS_MARKET_URL = "wss://data-stream.binance.vision";
+var STAKING_REST_API_PROD_URL = "https://api.binance.com";
+var SUB_ACCOUNT_REST_API_PROD_URL = "https://api.binance.com";
+var VIP_LOAN_REST_API_PROD_URL = "https://api.binance.com";
+var WALLET_REST_API_PROD_URL = "https://api.binance.com";
+
+// src/errors.ts
+var ConnectorClientError = class _ConnectorClientError extends Error {
+  constructor(msg) {
+    super(msg || "An unexpected error occurred.");
+    Object.setPrototypeOf(this, _ConnectorClientError.prototype);
+    this.name = "ConnectorClientError";
+  }
+};
+var RequiredError = class _RequiredError extends Error {
+  constructor(field, msg) {
+    super(msg || `Required parameter ${field} was null or undefined.`);
+    this.field = field;
+    Object.setPrototypeOf(this, _RequiredError.prototype);
+    this.name = "RequiredError";
+  }
+};
+var UnauthorizedError = class _UnauthorizedError extends Error {
+  constructor(msg) {
+    super(msg || "Unauthorized access. Authentication required.");
+    Object.setPrototypeOf(this, _UnauthorizedError.prototype);
+    this.name = "UnauthorizedError";
+  }
+};
+var ForbiddenError = class _ForbiddenError extends Error {
+  constructor(msg) {
+    super(msg || "Access to the requested resource is forbidden.");
+    Object.setPrototypeOf(this, _ForbiddenError.prototype);
+    this.name = "ForbiddenError";
+  }
 };
-var parseRateLimitHeaders = function(headers) {
-  const rateLimits = [];
-  const parseIntervalDetails = (key) => {
-    const match = key.match(/x-mbx-used-weight-(\d+)([smhd])|x-mbx-order-count-(\d+)([smhd])/i);
-    if (!match) return null;
-    const intervalNum = parseInt(match[1] || match[3], 10);
-    const intervalLetter = (match[2] || match[4])?.toUpperCase();
-    let interval;
-    switch (intervalLetter) {
-      case "S":
-        interval = "SECOND";
-        break;
-      case "M":
-        interval = "MINUTE";
-        break;
-      case "H":
-        interval = "HOUR";
-        break;
-      case "D":
-        interval = "DAY";
-        break;
-      default:
-        return null;
+var TooManyRequestsError = class _TooManyRequestsError extends Error {
+  constructor(msg) {
+    super(msg || "Too many requests. You are being rate-limited.");
+    Object.setPrototypeOf(this, _TooManyRequestsError.prototype);
+    this.name = "TooManyRequestsError";
+  }
+};
+var RateLimitBanError = class _RateLimitBanError extends Error {
+  constructor(msg) {
+    super(msg || "The IP address has been banned for exceeding rate limits.");
+    Object.setPrototypeOf(this, _RateLimitBanError.prototype);
+    this.name = "RateLimitBanError";
+  }
+};
+var ServerError = class _ServerError extends Error {
+  constructor(msg, statusCode) {
+    super(msg || "An internal server error occurred.");
+    this.statusCode = statusCode;
+    Object.setPrototypeOf(this, _ServerError.prototype);
+    this.name = "ServerError";
+  }
+};
+var NetworkError = class _NetworkError extends Error {
+  constructor(msg) {
+    super(msg || "A network error occurred.");
+    Object.setPrototypeOf(this, _NetworkError.prototype);
+    this.name = "NetworkError";
+  }
+};
+var NotFoundError = class _NotFoundError extends Error {
+  constructor(msg) {
+    super(msg || "The requested resource was not found.");
+    Object.setPrototypeOf(this, _NotFoundError.prototype);
+    this.name = "NotFoundError";
+  }
+};
+var BadRequestError = class _BadRequestError extends Error {
+  constructor(msg) {
+    super(msg || "The request was invalid or cannot be otherwise served.");
+    Object.setPrototypeOf(this, _BadRequestError.prototype);
+    this.name = "BadRequestError";
+  }
+};
+
+// src/logger.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2["NONE"] = "";
+  LogLevel2["DEBUG"] = "debug";
+  LogLevel2["INFO"] = "info";
+  LogLevel2["WARN"] = "warn";
+  LogLevel2["ERROR"] = "error";
+  return LogLevel2;
+})(LogLevel || {});
+var Logger = class _Logger {
+  constructor() {
+    this.minLogLevel = "info" /* INFO */;
+    this.levelsOrder = [
+      "" /* NONE */,
+      "debug" /* DEBUG */,
+      "info" /* INFO */,
+      "warn" /* WARN */,
+      "error" /* ERROR */
+    ];
+  }
+  static getInstance() {
+    if (!_Logger.instance) {
+      _Logger.instance = new _Logger();
     }
-    return { interval, intervalNum };
-  };
-  for (const [key, value] of Object.entries(headers)) {
-    const normalizedKey = key.toLowerCase();
-    if (value === void 0) continue;
-    if (normalizedKey.startsWith("x-mbx-used-weight-")) {
-      const details = parseIntervalDetails(normalizedKey);
-      if (details) {
-        rateLimits.push({
-          rateLimitType: "REQUEST_WEIGHT",
-          interval: details.interval,
-          intervalNum: details.intervalNum,
-          count: parseInt(value, 10)
-        });
-      }
-    } else if (normalizedKey.startsWith("x-mbx-order-count-")) {
-      const details = parseIntervalDetails(normalizedKey);
-      if (details) {
-        rateLimits.push({
-          rateLimitType: "ORDERS",
-          interval: details.interval,
-          intervalNum: details.intervalNum,
-          count: parseInt(value, 10)
-        });
-      }
+    return _Logger.instance;
+  }
+  setMinLogLevel(level) {
+    if (!this.isValidLogLevel(level)) {
+      throw new Error(`Invalid log level: ${level}`);
     }
+    this.minLogLevel = level;
   }
-  if (headers["retry-after"]) {
-    const retryAfter = parseInt(headers["retry-after"], 10);
-    for (const limit of rateLimits) {
-      limit.retryAfter = retryAfter;
+  isValidLogLevel(level) {
+    return this.levelsOrder.includes(level);
+  }
+  log(level, ...message) {
+    if (level === "" /* NONE */ || !this.allowLevelLog(level)) {
+      return;
     }
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    console[level](`[${timestamp}] [${level.toLowerCase()}]`, ...message);
   }
-  return rateLimits;
-};
-var sendRequest = function(configuration, endpoint, method, params = {}, timeUnit, options = {}) {
-  const localVarUrlObj = new URL(endpoint, configuration?.basePath);
-  const localVarRequestOptions = {
-    method,
-    ...configuration?.baseOptions
-  };
-  const localVarQueryParameter = { ...params };
-  if (options.isSigned) {
-    const timestamp = getTimestamp();
-    localVarQueryParameter["timestamp"] = timestamp;
-    const signature = getSignature(configuration, localVarQueryParameter);
-    if (signature) {
-      localVarQueryParameter["signature"] = signature;
+  allowLevelLog(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;
   }
-  setSearchParams(localVarUrlObj, localVarQueryParameter);
-  if (timeUnit && localVarRequestOptions.headers) {
-    const _timeUnit = validateTimeUnit(timeUnit);
-    localVarRequestOptions.headers = {
-      ...localVarRequestOptions.headers,
-      "X-MBX-TIME-UNIT": _timeUnit
-    };
+  debug(...message) {
+    this.log("debug" /* DEBUG */, ...message);
+  }
+  info(...message) {
+    this.log("info" /* INFO */, ...message);
+  }
+  warn(...message) {
+    this.log("warn" /* WARN */, ...message);
+  }
+  error(...message) {
+    this.log("error" /* ERROR */, ...message);
   }
-  return httpRequestFunction(
-    {
-      url: toPathString(localVarUrlObj),
-      options: localVarRequestOptions
-    },
-    configuration
-  );
 };
-function removeEmptyValue(obj) {
-  if (!(obj instanceof Object)) return {};
-  return Object.fromEntries(
-    Object.entries(obj).filter(
-      ([, value]) => value !== null && value !== void 0 && value !== ""
-    )
-  );
-}
-function sortObject(obj) {
-  return Object.keys(obj).sort().reduce((res, key) => {
-    res[key] = obj[key];
-    return res;
-  }, {});
-}
-function replaceWebsocketStreamsPlaceholders(str, variables) {
-  const normalizedVariables = Object.keys(variables).reduce(
-    (acc, key) => {
-      const normalizedKey = key.toLowerCase().replace(/[-_]/g, "");
-      acc[normalizedKey] = variables[key];
-      return acc;
-    },
-    {}
-  );
-  return str.replace(/(@)?<([^>]+)>/g, (match, precedingAt, fieldName) => {
-    const normalizedFieldName = fieldName.toLowerCase().replace(/[-_]/g, "");
-    if (Object.prototype.hasOwnProperty.call(normalizedVariables, normalizedFieldName) && normalizedVariables[normalizedFieldName] != null) {
-      const value = normalizedVariables[normalizedFieldName];
-      switch (normalizedFieldName) {
-        case "symbol":
-        case "windowsize":
-          return value.toLowerCase();
-        case "updatespeed":
-          return `@${value}`;
-        default:
-          return (precedingAt || "") + value;
-      }
-    }
-    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");
@@ -785,6 +827,20 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
       });
     }
   }
+  /**
+   * Retrieves available WebSocket connections based on the connection mode and readiness.
+   * In 'single' mode, returns the first connection in the pool.
+   * In 'pool' mode, filters and returns connections that are ready for use.
+   * @param allowNonEstablishedWebsockets - Optional flag to include non-established WebSocket connections.
+   * @returns An array of available WebSocket connections.
+   */
+  getAvailableConnections(allowNonEstablishedWebsockets = false) {
+    if (this.mode === "single") return [this.connectionPool[0]];
+    const availableConnections = this.connectionPool.filter(
+      (connection) => this.isConnectionReady(connection, allowNonEstablishedWebsockets)
+    );
+    return availableConnections;
+  }
   /**
    * Gets a WebSocket connection from the pool or single connection.
    * If the connection mode is 'single', it returns the first connection in the pool.
@@ -794,10 +850,7 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * @returns {WebsocketConnection} The selected WebSocket connection.
    */
   getConnection(allowNonEstablishedWebsockets = false) {
-    if (this.mode === "single") return this.connectionPool[0];
-    const availableConnections = this.connectionPool.filter(
-      (connection) => this.isConnectionReady(connection, allowNonEstablishedWebsockets)
-    );
+    const availableConnections = this.getAvailableConnections(allowNonEstablishedWebsockets);
     if (availableConnections.length === 0) {
       throw new Error("No available Websocket connections are ready.");
     }
@@ -917,6 +970,40 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     WebsocketConnectionToClose.close();
     this.cleanup(WebsocketConnectionToClose);
   }
+  /**
+   * Attempts to re-establish a session for a WebSocket connection.
+   * If a session logon request exists and the connection is not already logged on,
+   * it sends an authentication request and updates the connection's logged-on status.
+   * @param connection - The WebSocket connection to re-authenticate.
+   * @private
+   */
+  async sessionReLogon(connection) {
+    const req = connection.sessionLogonReq;
+    if (req && !connection.isSessionLoggedOn) {
+      const data = buildWebsocketAPIMessage(
+        this.configuration,
+        req.method,
+        req.payload,
+        req.options
+      );
+      this.logger.debug(`Session re-logon with connection id: ${connection.id}`, data);
+      try {
+        await this.send(
+          JSON.stringify(data),
+          data.id,
+          true,
+          this.configuration.timeout,
+          connection
+        );
+        connection.isSessionLoggedOn = true;
+      } catch (err) {
+        this.logger.error(
+          `Session re-logon with connection id ${connection.id} failed:`,
+          err
+        );
+      }
+    }
+  }
   /**
    * Cleans up WebSocket connection resources.
    * Removes all listeners and clears any associated timers for the provided WebSocket client.
@@ -941,8 +1028,6 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
    * Handles the opening of a WebSocket connection.
    * @param url - The URL of the WebSocket server.
    * @param targetConnection - The WebSocket connection being opened.
-   * @param oldConnection - The previous WebSocket connection, if this is a renewal.
-   * @param isRenewal - Indicates whether this is a connection renewal.
    * @param oldWSConnection - The WebSocket client instance associated with the old connection.
    */
   onOpen(url, targetConnection, oldWSConnection) {
@@ -957,6 +1042,7 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     } else {
       this.emit("open", this);
     }
+    this.sessionReLogon(targetConnection);
   }
   /**
    * Returns the URL to use when reconnecting.
@@ -1027,10 +1113,12 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     );
     if (isRenewal) targetConnection.renewalPending = true;
     else targetConnection.ws = ws;
+    targetConnection.isSessionLoggedOn = false;
     this.scheduleTimer(
       ws,
       () => {
         this.logger.info(`Renewing Websocket connection with id ${targetConnection.id}`);
+        targetConnection.isSessionLoggedOn = false;
         this.enqueueReconnection(
           targetConnection,
           this.getReconnectURL(url, targetConnection),
@@ -1074,6 +1162,7 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
             this.logger.info(
               `Reconnecting conection with id ${targetConnection.id} to the server.`
             );
+            targetConnection.isSessionLoggedOn = false;
             targetConnection.reconnectionPending = true;
             this.enqueueReconnection(
               targetConnection,
@@ -1109,6 +1198,8 @@ var WebsocketCommon = class _WebsocketCommon extends WebsocketEventEmitter {
     else {
       this.connectionPool.forEach((connection) => {
         connection.closeInitiated = true;
+        connection.isSessionLoggedOn = false;
+        connection.sessionLogonReq = void 0;
       });
       const disconnectPromises = this.connectionPool.map(
         (connection) => this.closeConnectionGracefully(connection.ws, connection)
@@ -1269,37 +1360,43 @@ var WebsocketAPIBase = class extends WebsocketCommon {
       });
     });
   }
-  /**
-   * Sends a message to the WebSocket API Server.
-   * Supports both signed and unsigned messages.
-   * @param method The API method to call
-   * @param payload Message parameters and options
-   * @param options Additional requests options (withApiKey, isSigned)
-   * @returns Promise that resolves with the server response
-   * @throws Error if not connected
-   */
-  sendMessage(method, payload = {}, options = {}) {
+  async sendMessage(method, payload = {}, options = {}) {
     if (!this.isConnected()) {
-      return Promise.reject(new Error("Not connected"));
-    }
-    const id = payload.id && /^[0-9a-f]{32}$/.test(payload.id) ? payload.id : randomString();
-    delete payload.id;
-    let params = removeEmptyValue(payload);
-    if (options.withApiKey || options.isSigned) {
-      params.apiKey = this.configuration.apiKey;
+      throw new Error("Not connected");
     }
-    if (options.isSigned) {
-      params.timestamp = getTimestamp();
-      params = sortObject(params);
-      params.signature = getSignature(this.configuration, params);
-    }
-    const data = {
-      id,
+    const connections = options.isSessionLogon || options.isSessionLogout ? this.getAvailableConnections() : [this.getConnection()];
+    const skipAuth = options.isSessionLogon || options.isSessionLogout ? false : this.configuration.autoSessionReLogon && connections[0].isSessionLoggedOn;
+    const data = buildWebsocketAPIMessage(
+      this.configuration,
       method,
-      params
-    };
+      payload,
+      options,
+      skipAuth
+    );
     this.logger.debug("Send message to Binance WebSocket API Server:", data);
-    return this.send(JSON.stringify(data), id, true, this.configuration?.timeout);
+    const responses = await Promise.all(
+      connections.map(
+        (connection) => this.send(
+          JSON.stringify(data),
+          data.id,
+          true,
+          this.configuration.timeout,
+          connection
+        )
+      )
+    );
+    if ((options.isSessionLogon || options.isSessionLogout) && this.configuration.autoSessionReLogon) {
+      connections.forEach((connection) => {
+        if (options.isSessionLogon) {
+          connection.isSessionLoggedOn = true;
+          connection.sessionLogonReq = { method, payload, options };
+        } else {
+          connection.isSessionLoggedOn = false;
+          connection.sessionLogonReq = void 0;
+        }
+      });
+    }
+    return connections.length === 1 ? responses[0] : responses;
   }
 };
 var WebsocketStreamsBase = class extends WebsocketCommon {
@@ -1411,7 +1508,6 @@ var WebsocketStreamsBase = class extends WebsocketCommon {
    * @param url The URL of the WebSocket connection.
    * @param targetConnection The WebSocket connection that was opened.
    * @param oldConnection The previous WebSocket connection, if any.
-   * @param isRenewal Whether the connection is a renewal of an existing connection.
    */
   onOpen(url, targetConnection, oldWSConnection) {
     this.processPendingSubscriptions(targetConnection);
@@ -1606,16 +1702,19 @@ function createStreamHandler(websocketBase, streamOrId, id) {
   assertParamExists,
   buildQueryString,
   buildUserAgent,
+  buildWebsocketAPIMessage,
   clearSignerCache,
   createStreamHandler,
   delay,
   getSignature,
   getTimestamp,
   httpRequestFunction,
+  parseCustomHeaders,
   parseRateLimitHeaders,
   randomString,
   removeEmptyValue,
   replaceWebsocketStreamsPlaceholders,
+  sanitizeHeaderValue,
   sendRequest,
   setFlattenedQueryParams,
   setSearchParams,