@nktkas/hyperliquid 0.25.6 → 0.25.7

package/script/src/api/subscription/webData3.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebData3Event = exports.WebData3Request = void 0;
+exports.webData3 = webData3;
+const v = __importStar(require("valibot"));
+const _base_js_1 = require("../_base.js");
+const _common_schemas_js_1 = require("../_common_schemas.js");
+const metaAndAssetCtxs_js_1 = require("../info/metaAndAssetCtxs.js");
+const clearinghouseState_js_1 = require("../info/clearinghouseState.js");
+// -------------------- Schemas --------------------
+/** Subscription to comprehensive user and market data events. */
+exports.WebData3Request = (() => {
+    return v.pipe(v.object({
+        /** Type of subscription. */
+        type: v.pipe(v.literal("webData3"), v.description("Type of subscription.")),
+        /** User address. */
+        user: v.pipe(_base_js_1.Address, v.description("User address.")),
+    }), v.description("Subscription to comprehensive user and market data events."));
+})();
+/** Event of comprehensive user and market data. */
+exports.WebData3Event = (() => {
+    return v.pipe(v.object({
+        /** User state information. */
+        userState: v.pipe(v.object({
+            /** Agent address if one exists. */
+            agentAddress: v.pipe(v.nullable(_base_js_1.Address), v.description("Agent address if one exists.")),
+            /** Timestamp until which the agent is valid. */
+            agentValidUntil: v.pipe(v.nullable(_base_js_1.UnsignedInteger), v.description("Timestamp until which the agent is valid.")),
+            /** Cumulative ledger value. */
+            cumLedger: v.pipe(_base_js_1.UnsignedDecimal, v.description("Cumulative ledger value.")),
+            /** Server timestamp (in ms since epoch). */
+            serverTime: v.pipe(_base_js_1.UnsignedInteger, v.description("Server timestamp (in ms since epoch).")),
+            /** Whether this account is a vault. */
+            isVault: v.pipe(v.boolean(), v.description("Whether this account is a vault.")),
+            /** User address. */
+            user: v.pipe(_base_js_1.Address, v.description("User address.")),
+            /** Whether the user has opted out of spot dusting. */
+            optOutOfSpotDusting: v.pipe(v.optional(v.literal(true)), v.description("Whether the user has opted out of spot dusting.")),
+            /** Whether DEX abstraction is enabled. */
+            dexAbstractionEnabled: v.pipe(v.optional(v.boolean()), v.description("Whether DEX abstraction is enabled.")),
+        }), v.description("User state information.")),
+        /** Array of perpetual DEX states. */
+        perpDexStates: v.pipe(v.array(v.object({
+            /** Account summary for perpetual trading. */
+            clearinghouseState: clearinghouseState_js_1.ClearinghouseStateResponse,
+            /** Total equity in vaults. */
+            totalVaultEquity: v.pipe(_base_js_1.UnsignedDecimal, v.description("Total equity in vaults.")),
+            /** Array of user open orders with frontend information. */
+            openOrders: v.pipe(v.optional(v.array(_common_schemas_js_1.DetailedOrderSchema)), v.description("User open orders with frontend information.")),
+            /** Context for each perpetual asset. */
+            assetCtxs: metaAndAssetCtxs_js_1.MetaAndAssetCtxsResponse.items[1],
+            /** Assets currently at their open interest cap. */
+            perpsAtOpenInterestCap: v.pipe(v.optional(v.array(v.string())), v.description("Assets currently at their open interest cap.")),
+            /** Array of leading vaults. */
+            leadingVaults: v.pipe(v.optional(v.array(
+            /** Vault that a user is leading. */
+            v.pipe(v.object({
+                /** Address of the vault. */
+                address: v.pipe(_base_js_1.Address, v.description("Address of the vault.")),
+                /** Name of the vault. */
+                name: v.pipe(v.string(), v.description("Name of the vault.")),
+            }), v.description("Vault that a user is leading.")))), v.description("Array of leading vaults.")),
+        })), v.description("Array of perpetual DEX states.")),
+    }), v.description("Comprehensive user and market data."));
+})();
+/**
+ * Subscribe to comprehensive user and market data updates.
+ * @param config - General configuration for Subscription API subscriptions.
+ * @param params - Parameters specific to the API subscription.
+ * @param listener - A callback function to be called when the event is received.
+ * @returns A request-promise that resolves with a {@link Subscription} object to manage the subscription lifecycle.
+ *
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+ * @example
+ * ```ts
+ * import { WebSocketTransport } from "@nktkas/hyperliquid";
+ * import { webData3 } from "@nktkas/hyperliquid/api/subscription";
+ *
+ * const transport = new WebSocketTransport();
+ *
+ * const sub = await webData3(
+ *   { transport },
+ *   { user: "0x..." },
+ *   (data) => console.log(data),
+ * );
+ * ```
+ */
+function webData3(config, params, listener) {
+    const payload = (0, _base_js_1.parser)(exports.WebData3Request)({ type: "webData3", ...params });
+    return config.transport.subscribe(payload.type, payload, (e) => {
+        if (e.detail.userState.user === payload.user) {
+            listener(e.detail);
+        }
+    });
+}
+//# sourceMappingURL=webData3.js.map

package/script/src/api/subscription/webData3.js.map

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

package/script/src/api/subscription/~client.d.ts

@@ -24,6 +24,7 @@ import { userNonFundingLedgerUpdates } from "./userNonFundingLedgerUpdates.js";
 import { userTwapHistory } from "./userTwapHistory.js";
 import { userTwapSliceFills } from "./userTwapSliceFills.js";
 import { webData2 } from "./webData2.js";
+import { webData3 } from "./webData3.js";
 export type { ActiveAssetCtxEvent as WsActiveAssetCtxEvent, ActiveAssetCtxParameters as WsActiveAssetCtxParameters, } from "./activeAssetCtx.js";
 export type { ActiveAssetDataEvent as WsActiveAssetDataEvent, ActiveAssetDataParameters as WsActiveAssetDataParameters, } from "./activeAssetData.js";
 export type { ActiveSpotAssetCtxEvent as WsActiveSpotAssetCtxEvent, ActiveSpotAssetCtxParameters as WsActiveSpotAssetCtxParameters, } from "./activeSpotAssetCtx.js";
@@ -47,6 +48,7 @@ export type { UserNonFundingLedgerUpdatesEvent as WsUserNonFundingLedgerUpdatesE
 export type { UserTwapHistoryEvent as WsUserTwapHistoryEvent, UserTwapHistoryParameters as WsUserTwapHistoryParameters, } from "./userTwapHistory.js";
 export type { UserTwapSliceFillsEvent as WsUserTwapSliceFillsEvent, UserTwapSliceFillsParameters as WsUserTwapSliceFillsParameters, } from "./userTwapSliceFills.js";
 export type { WebData2Event as WsWebData2Event, WebData2Parameters as WsWebData2Parameters } from "./webData2.js";
+export type { WebData3Event as WsWebData3Event, WebData3Parameters as WsWebData3Parameters } from "./webData3.js";
 export type { SubscriptionRequestConfig } from "./_types.js";
 /**
  * A client for interacting with the Hyperliquid Subscription API.
@@ -529,5 +531,25 @@ export declare class SubscriptionClient<T extends ISubscriptionTransport = ISubs
      * ```
      */
     webData2(...args: OmitFirst<OverloadedParameters<typeof webData2>>): Promise<import("../../transport/base.js").Subscription>;
+    /**
+     * Subscribe to comprehensive user and market data updates.
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     * @returns A request-promise that resolves with a {@link Subscription} object to manage the subscription lifecycle.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport();
+     *
+     * const client = new hl.SubscriptionClient({ transport });
+     * const sub = await client.webData3({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     */
+    webData3(...args: OmitFirst<OverloadedParameters<typeof webData3>>): Promise<import("../../transport/base.js").Subscription>;
 }
 //# sourceMappingURL=~client.d.ts.map

package/script/src/api/subscription/~client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"~client.d.ts","sourceRoot":"","sources":["../../../../src/src/api/subscription/~client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"~client.d.ts","sourceRoot":"","sources":["../../../../src/src/api/subscription/~client.ts"],"names":[],"mappings":"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"}

package/script/src/api/subscription/~client.js

@@ -24,6 +24,7 @@ const userNonFundingLedgerUpdates_js_1 = require("./userNonFundingLedgerUpdates.
 const userTwapHistory_js_1 = require("./userTwapHistory.js");
 const userTwapSliceFills_js_1 = require("./userTwapSliceFills.js");
 const webData2_js_1 = require("./webData2.js");
+const webData3_js_1 = require("./webData3.js");
 /**
  * A client for interacting with the Hyperliquid Subscription API.
  * @typeParam T - The transport (extends {@linkcode ISubscriptionTransport}) used to connect to the Hyperliquid API.
@@ -557,6 +558,28 @@ class SubscriptionClient {
     webData2(...args) {
         return (0, webData2_js_1.webData2)(this, ...args);
     }
+    /**
+     * Subscribe to comprehensive user and market data updates.
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     * @returns A request-promise that resolves with a {@link Subscription} object to manage the subscription lifecycle.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport();
+     *
+     * const client = new hl.SubscriptionClient({ transport });
+     * const sub = await client.webData3({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     */
+    webData3(...args) {
+        return (0, webData3_js_1.webData3)(this, ...args);
+    }
 }
 exports.SubscriptionClient = SubscriptionClient;
 //# sourceMappingURL=~client.js.map

package/script/src/api/subscription/~client.js.map

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

package/script/src/api/subscription/~mod.d.ts

@@ -47,4 +47,5 @@ export * from "./userNonFundingLedgerUpdates.js";
 export * from "./userTwapHistory.js";
 export * from "./userTwapSliceFills.js";
 export * from "./webData2.js";
+export * from "./webData3.js";
 //# sourceMappingURL=~mod.d.ts.map

package/script/src/api/subscription/~mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"~mod.d.ts","sourceRoot":"","sources":["../../../../src/src/api/subscription/~mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"~mod.d.ts","sourceRoot":"","sources":["../../../../src/src/api/subscription/~mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/script/src/api/subscription/~mod.js

@@ -65,4 +65,5 @@ __exportStar(require("./userNonFundingLedgerUpdates.js"), exports);
 __exportStar(require("./userTwapHistory.js"), exports);
 __exportStar(require("./userTwapSliceFills.js"), exports);
 __exportStar(require("./webData2.js"), exports);
+__exportStar(require("./webData3.js"), exports);
 //# sourceMappingURL=~mod.js.map

package/script/src/api/subscription/~mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"~mod.js","sourceRoot":"","sources":["../../../../src/src/api/subscription/~mod.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;;AAEH,wCAAkD;AAAzC,kGAAA,MAAM,OAAA;AAAE,uGAAA,WAAW,OAAA;AAG5B,sDAAoC;AACpC,uDAAqC;AACrC,0DAAwC;AACxC,+CAA6B;AAC7B,iDAA+B;AAC/B,2CAAyB;AACzB,8CAA4B;AAC5B,0DAAwC;AACxC,qDAAmC;AACnC,mDAAiC;AACjC,8CAA4B;AAC5B,oDAAkC;AAClC,kDAAgC;AAChC,oDAAkC;AAClC,8CAA4B;AAC5B,kDAAgC;AAChC,iDAA+B;AAC/B,oDAAkC;AAClC,4DAA0C;AAC1C,mEAAiD;AACjD,uDAAqC;AACrC,0DAAwC;AACxC,gDAA8B"}
+{"version":3,"file":"~mod.js","sourceRoot":"","sources":["../../../../src/src/api/subscription/~mod.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;;AAEH,wCAAkD;AAAzC,kGAAA,MAAM,OAAA;AAAE,uGAAA,WAAW,OAAA;AAG5B,sDAAoC;AACpC,uDAAqC;AACrC,0DAAwC;AACxC,+CAA6B;AAC7B,iDAA+B;AAC/B,2CAAyB;AACzB,8CAA4B;AAC5B,0DAAwC;AACxC,qDAAmC;AACnC,mDAAiC;AACjC,8CAA4B;AAC5B,oDAAkC;AAClC,kDAAgC;AAChC,oDAAkC;AAClC,8CAA4B;AAC5B,kDAAgC;AAChC,iDAA+B;AAC/B,oDAAkC;AAClC,4DAA0C;AAC1C,mEAAiD;AACjD,uDAAqC;AACrC,0DAAwC;AACxC,gDAA8B;AAC9B,gDAA8B"}

package/script/src/utils/_format.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Format price according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
+ * - Maximum 5 significant figures
+ * - Maximum (6 for perp, 8 for spot) - `szDecimals` decimal places
+ * - Integer prices are always allowed regardless of significant figures
+ * - Remove trailing zeros
+ * @example
+ * ```ts
+ * import { formatPrice } from "@nktkas/hyperliquid/utils";
+ *
+ * //        `true` for perp (default), `false` for spot
+ * //                                              ⌄⌄⌄⌄⌄
+ * const price = formatPrice("0.0000123456789", 0, false); // → "0.00001234"
+ * ```
+ */
+export declare function formatPrice(price: string | number, szDecimals: number, isPerp?: boolean): string;
+/**
+ * Format size according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
+ * - Truncate to `szDecimals` decimal places
+ * - Remove trailing zeros
+ * @example
+ * ```ts
+ * import { formatSize } from "@nktkas/hyperliquid/utils";
+ *
+ * const size = formatSize("1.23456789", 5); // → "1.23456"
+ * ```
+ */
+export declare function formatSize(size: string | number, szDecimals: number): string;
+//# sourceMappingURL=_format.d.ts.map

package/script/src/utils/_format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_format.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_format.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,OAAc,GACrB,MAAM,CAiBR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ5E"}

package/script/src/utils/_format.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPrice = formatPrice;
+exports.formatSize = formatSize;
+const _base_js_1 = require("../_base.js");
+/**
+ * Format price according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
+ * - Maximum 5 significant figures
+ * - Maximum (6 for perp, 8 for spot) - `szDecimals` decimal places
+ * - Integer prices are always allowed regardless of significant figures
+ * - Remove trailing zeros
+ * @example
+ * ```ts
+ * import { formatPrice } from "@nktkas/hyperliquid/utils";
+ *
+ * //        `true` for perp (default), `false` for spot
+ * //                                              ⌄⌄⌄⌄⌄
+ * const price = formatPrice("0.0000123456789", 0, false); // → "0.00001234"
+ * ```
+ */
+function formatPrice(price, szDecimals, isPerp = true) {
+    // Prepare: trim, validate, normalize leading/trailing zeros
+    let priceStr = prepareNumber(typeof price === "string" ? price : price.toString());
+    // Integer prices bypass sig figs limit per spec
+    if (!priceStr.includes(".")) {
+        return priceStr;
+    }
+    // Apply decimal limit: max (6 for perp, 8 for spot) - `szDecimals` decimals
+    const maxDecimals = Math.max((isPerp ? 6 : 8) - szDecimals, 0);
+    priceStr = truncateDecimals(priceStr, maxDecimals);
+    // Apply sig figs limit: max 5 significant figures
+    priceStr = truncateSigFigs(priceStr, 5);
+    return priceStr;
+}
+/**
+ * Format size according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
+ * - Truncate to `szDecimals` decimal places
+ * - Remove trailing zeros
+ * @example
+ * ```ts
+ * import { formatSize } from "@nktkas/hyperliquid/utils";
+ *
+ * const size = formatSize("1.23456789", 5); // → "1.23456"
+ * ```
+ */
+function formatSize(size, szDecimals) {
+    // Prepare: trim, validate, normalize leading/trailing zeros
+    let sizeStr = prepareNumber(typeof size === "string" ? size : size.toString());
+    // Truncate to `szDecimals` decimal places
+    sizeStr = truncateDecimals(sizeStr, szDecimals);
+    return sizeStr;
+}
+/**
+ * Prepare number string for processing:
+ * 1. Trim whitespace
+ * 2. Validate format (decimal number, not hex/scientific)
+ * 3. Normalize: remove leading zeros from integer part, trailing zeros from decimal part
+ */
+function prepareNumber(numStr) {
+    const trimmed = numStr.trim();
+    // Validate: only decimal numbers allowed (no hex, scientific notation, etc)
+    if (!/^-?(\d+\.?\d*|\.\d+)$/.test(trimmed)) {
+        throw new _base_js_1.HyperliquidError(`Invalid number format: ${numStr}`);
+    }
+    // Normalize: remove leading zeros from integer, trailing zeros from decimal
+    const [int, dec] = trimmed.split(".");
+    const trimmedInt = int.replace(/^0+/, "") || "0";
+    const trimmedDec = dec?.replace(/0+$/, "");
+    return trimmedInt + (trimmedDec ? "." + trimmedDec : "");
+}
+/** String-based Math operations for arbitrary precision */
+const StringMath = {
+    /** Absolute value: remove negative sign if present */
+    abs(numStr) {
+        return numStr[0] === "-" ? numStr.slice(1) : numStr;
+    },
+    /** Floor log10 (magnitude): position of most significant digit */
+    log10Floor(numStr) {
+        const abs = this.abs(numStr);
+        const [int, dec] = abs.split(".");
+        // Number >= 1: magnitude = length of integer part - 1
+        if (int !== "0") {
+            const trimmed = int.replace(/^0+/, "");
+            return trimmed.length - 1;
+        }
+        // Number < 1: count leading zeros in decimal part
+        if (!dec)
+            return -Infinity;
+        const leadingZeros = dec.match(/^0*/)?.[0].length ?? 0;
+        return -(leadingZeros + 1);
+    },
+    /** Multiply by 10^exp: shift decimal point left (negative) or right (positive) */
+    multiplyByPow10(numStr, exp) {
+        if (exp === 0)
+            return numStr;
+        const neg = numStr[0] === "-";
+        const abs = neg ? numStr.slice(1) : numStr;
+        const [int, dec = ""] = abs.split(".");
+        if (exp > 0) {
+            // Shift right: move digits from decimal to integer
+            if (exp >= dec.length) {
+                return (neg ? "-" : "") + int + dec + "0".repeat(exp - dec.length);
+            }
+            return (neg ? "-" : "") + int + dec.slice(0, exp) + "." + dec.slice(exp);
+        }
+        else {
+            // Shift left: move digits from integer to decimal
+            const absExp = -exp;
+            if (absExp >= int.length) {
+                return (neg ? "-" : "") + "0." + "0".repeat(absExp - int.length) + int + dec;
+            }
+            return (neg ? "-" : "") + int.slice(0, -absExp) + "." + int.slice(-absExp) + dec;
+        }
+    },
+    /** Truncate: remove decimal part */
+    trunc(numStr) {
+        const dotIndex = numStr.indexOf(".");
+        return dotIndex === -1 ? numStr : numStr.slice(0, dotIndex);
+    },
+};
+/** Truncate to specified decimal places */
+function truncateDecimals(numStr, maxDecimals) {
+    const dotIndex = numStr.indexOf(".");
+    if (dotIndex === -1)
+        return numStr;
+    const truncated = numStr.substring(0, dotIndex + maxDecimals + 1);
+    // Remove trailing zeros from decimal
+    const [int, dec] = truncated.split(".");
+    const trimmedDec = dec?.replace(/0+$/, "");
+    return trimmedDec ? int + "." + trimmedDec : int;
+}
+/** Truncate to specified significant figures using string-based math */
+function truncateSigFigs(numStr, maxSigFigs) {
+    if (parseFloat(numStr) === 0)
+        return "0";
+    const neg = numStr[0] === "-";
+    const abs = neg ? numStr.slice(1) : numStr;
+    // Calculate how much to shift: align most significant digit to ones place + (maxSigFigs-1)
+    const magnitude = StringMath.log10Floor(abs);
+    const shiftAmount = maxSigFigs - magnitude - 1;
+    // Shift right, truncate integer part, shift back
+    const shifted = StringMath.multiplyByPow10(abs, shiftAmount);
+    const truncated = StringMath.trunc(shifted);
+    const result = StringMath.multiplyByPow10(truncated, -shiftAmount);
+    // Remove trailing zeros introduced by shifting
+    const final = neg ? "-" + result : result;
+    const [int, dec] = final.split(".");
+    const trimmedDec = dec?.replace(/0+$/, "");
+    return trimmedDec ? int + "." + trimmedDec : int;
+}
+//# sourceMappingURL=_format.js.map

package/script/src/utils/_format.js.map

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

package/script/src/utils/_symbolConverter.d.ts

@@ -19,6 +19,9 @@ export interface SymbolConverterOptions {
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  * const converter = await SymbolConverter.create({ transport });
  *
+ * // By default, dexs are not loaded; specify them when creating an instance
+ * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
+ *
  * const btcId = converter.getAssetId("BTC"); // perpetual → 0
  * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
  * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
@@ -26,6 +29,8 @@ export interface SymbolConverterOptions {
  * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
  * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
  * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
+ *
+ * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
  * ```
  */
 export declare class SymbolConverter {
@@ -33,6 +38,7 @@ export declare class SymbolConverter {
     private readonly dexOption;
     private readonly nameToAssetId;
     private readonly nameToSzDecimals;
+    private readonly nameToSpotPairId;
     private constructor();
     /**
      * Create and initialize a SymbolConverter instance.
@@ -73,5 +79,12 @@ export declare class SymbolConverter {
      * @example "BTC" → 5, "HYPE/USDC" → 2, "test:ABC" → 0
      */
     getSzDecimals(name: string): number | undefined;
+    /**
+     * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
+     *
+     * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
+     * @example "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
+     */
+    getSpotPairId(name: string): string | undefined;
 }
 //# sourceMappingURL=_symbolConverter.d.ts.map

package/script/src/utils/_symbolConverter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,MAAM,MAAM,SAAS,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AAE3C,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,OAAO;IAKP;;;;;;;;;;;;OAYG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B7B,OAAO,CAAC,mBAAmB;YAOb,kBAAkB;IA6BhC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}
+{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,MAAM,MAAM,SAAS,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AAE3C,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,OAAO;IAKP;;;;;;;;;;;;OAYG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B7B,OAAO,CAAC,mBAAmB;YAOb,kBAAkB;IA6BhC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;IAoBzB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}

package/script/src/utils/_symbolConverter.js

@@ -16,6 +16,9 @@ const perpDexs_js_1 = require("../api/info/perpDexs.js");
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  * const converter = await SymbolConverter.create({ transport });
  *
+ * // By default, dexs are not loaded; specify them when creating an instance
+ * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
+ *
  * const btcId = converter.getAssetId("BTC"); // perpetual → 0
  * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
  * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
@@ -23,6 +26,8 @@ const perpDexs_js_1 = require("../api/info/perpDexs.js");
  * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
  * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
  * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
+ *
+ * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
  * ```
  */
 class SymbolConverter {
@@ -30,6 +35,7 @@ class SymbolConverter {
     dexOption;
     nameToAssetId = new Map();
     nameToSzDecimals = new Map();
+    nameToSpotPairId = new Map();
     constructor(options) {
         this.transport = options.transport;
         this.dexOption = options.dexs ?? false;
@@ -71,6 +77,7 @@ class SymbolConverter {
         }
         this.nameToAssetId.clear();
         this.nameToSzDecimals.clear();
+        this.nameToSpotPairId.clear();
         this.processDefaultPerps(perpMetaData);
         this.processSpotAssets(spotMetaData);
         // Only process builder dexs if dex support is enabled
@@ -132,6 +139,7 @@ class SymbolConverter {
             const baseQuoteKey = `${baseToken.name}/${quoteToken.name}`;
             this.nameToAssetId.set(baseQuoteKey, assetId);
             this.nameToSzDecimals.set(baseQuoteKey, baseToken.szDecimals);
+            this.nameToSpotPairId.set(baseQuoteKey, market.name);
         });
     }
     /**
@@ -154,6 +162,15 @@ class SymbolConverter {
     getSzDecimals(name) {
         return this.nameToSzDecimals.get(name);
     }
+    /**
+     * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
+     *
+     * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
+     * @example "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
+     */
+    getSpotPairId(name) {
+        return this.nameToSpotPairId.get(name);
+    }
 }
 exports.SymbolConverter = SymbolConverter;
 //# sourceMappingURL=_symbolConverter.js.map

package/script/src/utils/_symbolConverter.js.map

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

package/script/src/utils/mod.d.ts

@@ -1,2 +1,3 @@
 export * from "./_symbolConverter.js";
+export * from "./_format.js";
 //# sourceMappingURL=mod.d.ts.map