@nktkas/hyperliquid 0.30.3 → 0.32.0

package/esm/src/transport/websocket/mod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/transport/websocket/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE5F,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gEAAgE;IAChE,SAAS,CAAC,EAAE,4BAA4B,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB,EAAE,sBAAsB;IAClF,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,uFAAuF;IACvF,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,EAE7B;IACD,4DAA4D;IAC5D,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAE/B;IAED,SAAS,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC7C,SAAS,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC5C,SAAS,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;IAC7D,SAAS,CAAC,kBAAkB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,SAAS,CAAC;IAEzE;;;;OAIG;gBACS,OAAO,CAAC,EAAE,yBAAyB;IA4B/C;;;;;;;;;;OAUG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnG;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,CAAC,EACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC1C;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC1C,SAAS,CAAC,cAAc,IAAI,IAAI;CAgBjC"}

package/esm/src/transport/websocket/mod.js

@@ -1,200 +0,0 @@
-/**
- * WebSocket transport for {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions | subscriptions} and {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests | POST requests}.
- *
- * Use {@link WebSocketTransport} for real-time subscriptions and for lower-latency API requests.
- *
- * @example Subscriptions
- * ```ts
- * import { SubscriptionClient, WebSocketTransport } from "@nktkas/hyperliquid";
- *
- * const transport = new WebSocketTransport();
- * const client = new SubscriptionClient({ transport });
- *
- * const subscription = await client.allMids((data) => {
- *   console.log(data.mids);
- * });
- *
- * await subscription.unsubscribe();
- * ```
- *
- * @module
- */
-import { AbortSignal_ } from "../_polyfills.js";
-import { ReconnectingWebSocket } from "@nktkas/rews";
-import { HyperliquidEventTarget } from "./_hyperliquidEventTarget.js";
-import { WebSocketPostRequest, WebSocketRequestError } from "./_postRequest.js";
-import { WebSocketSubscriptionManager } from "./_subscriptionManager.js";
-export { WebSocketRequestError };
-/** Mainnet API WebSocket URL. */
-export const MAINNET_API_WS_URL = "wss://api.hyperliquid.xyz/ws";
-/** Testnet API WebSocket URL. */
-export const TESTNET_API_WS_URL = "wss://api.hyperliquid-testnet.xyz/ws";
-/** Mainnet RPC WebSocket URL. */
-export const MAINNET_RPC_WS_URL = "wss://rpc.hyperliquid.xyz/ws";
-/** Testnet RPC WebSocket URL. */
-export const TESTNET_RPC_WS_URL = "wss://rpc.hyperliquid-testnet.xyz/ws";
-/**
- * WebSocket transport for Hyperliquid API.
- *
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests
- */
-export class WebSocketTransport {
-    /** Indicates this transport uses testnet endpoint. */
-    isTestnet;
-    /** The WebSocket that is used for communication. */
-    socket;
-    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
-    get resubscribe() {
-        return this._subscriptionManager.resubscribe;
-    }
-    set resubscribe(value) {
-        this._subscriptionManager.resubscribe = value;
-    }
-    /** Timeout for requests in ms. Set to `null` to disable. */
-    get timeout() {
-        return this._postRequest.timeout;
-    }
-    set timeout(value) {
-        this._postRequest.timeout = value;
-    }
-    _postRequest;
-    _hlEvents;
-    _subscriptionManager;
-    _keepAliveInterval;
-    /**
-     * Creates a new WebSocket transport instance.
-     *
-     * @param options - Configuration options for the WebSocket transport layer.
-     */
-    constructor(options) {
-        this.isTestnet = options?.isTestnet ?? false;
-        this.socket = new ReconnectingWebSocket(options?.url ?? (this.isTestnet ? TESTNET_API_WS_URL : MAINNET_API_WS_URL), options?.reconnect);
-        this._hlEvents = new HyperliquidEventTarget(this.socket);
-        this._postRequest = new WebSocketPostRequest(this.socket, this._hlEvents, options?.timeout === undefined ? 10_000 : options.timeout);
-        this._subscriptionManager = new WebSocketSubscriptionManager(this.socket, this._postRequest, this._hlEvents, options?.resubscribe ?? true);
-        this._initKeepAlive();
-    }
-    // ============================================================
-    // Public methods
-    // ============================================================
-    /**
-     * Sends a request to the Hyperliquid API via WebSocket.
-     *
-     * @param endpoint - The API endpoint to send the request to.
-     * @param payload - The payload to send with the request.
-     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the request.
-     *
-     * @returns A promise that resolves with parsed JSON response body.
-     *
-     * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
-     */
-    async request(endpoint, payload, signal) {
-        const payload_ = { type: endpoint === "exchange" ? "action" : endpoint, payload };
-        return await this._postRequest.request("post", payload_, signal);
-    }
-    /**
-     * Subscribes to a Hyperliquid event channel.
-     * Sends a subscription request to the server and listens for events.
-     *
-     * @param channel - The event channel to listen to.
-     * @param payload - A payload to send with the subscription request.
-     * @param listener - A function to call when the event is dispatched.
-     *
-     * @returns A promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
-     *
-     * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
-     */
-    subscribe(channel, payload, listener) {
-        return this._subscriptionManager.subscribe(channel, payload, listener);
-    }
-    /**
-     * Waits until the WebSocket connection is ready.
-     *
-     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the promise.
-     *
-     * @returns A promise that resolves when the connection is ready.
-     *
-     * @throws {WebSocketRequestError} When the connection cannot be established.
-     */
-    ready(signal) {
-        return new Promise((resolve, reject) => {
-            // Combine the provided signal with the socket's termination signal
-            const combinedSignal = signal
-                ? AbortSignal_.any([this.socket.terminationSignal, signal])
-                : this.socket.terminationSignal;
-            // Check if already aborted
-            if (combinedSignal.aborted) {
-                return reject(new WebSocketRequestError("Failed to establish WebSocket connection", { cause: combinedSignal.reason }));
-            }
-            // Check if already open
-            if (this.socket.readyState === ReconnectingWebSocket.OPEN)
-                return resolve();
-            // Set up event listeners
-            const handleOpen = () => {
-                combinedSignal.removeEventListener("abort", handleAbort);
-                resolve();
-            };
-            const handleAbort = () => {
-                this.socket.removeEventListener("open", handleOpen);
-                return reject(new WebSocketRequestError("Failed to establish WebSocket connection", { cause: combinedSignal.reason }));
-            };
-            this.socket.addEventListener("open", handleOpen, { once: true });
-            combinedSignal.addEventListener("abort", handleAbort, { once: true });
-        });
-    }
-    /**
-     * Closes the WebSocket connection and waits until it is fully closed.
-     *
-     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the promise.
-     *
-     * @returns A promise that resolves when the connection is fully closed.
-     *
-     * @throws {WebSocketRequestError} When the connection cannot be closed.
-     */
-    close(signal) {
-        return new Promise((resolve, reject) => {
-            // Check if already aborted
-            if (signal?.aborted) {
-                return reject(new WebSocketRequestError("Failed to close WebSocket connection", { cause: signal.reason }));
-            }
-            // Check if already closed
-            if (this.socket.readyState === ReconnectingWebSocket.CLOSED)
-                return resolve();
-            // Set up event listeners
-            const handleClose = () => {
-                signal?.removeEventListener("abort", handleAbort);
-                resolve();
-            };
-            const handleAbort = () => {
-                return reject(new WebSocketRequestError("Failed to close WebSocket connection", { cause: signal?.reason }));
-            };
-            this.socket.addEventListener("close", handleClose, { once: true, signal });
-            this.socket.addEventListener("error", handleClose, { once: true, signal });
-            signal?.addEventListener("abort", handleAbort, { once: true });
-            // Initiate close
-            this.socket.close();
-        });
-    }
-    // ============================================================
-    // Keep-Alive Logic
-    // ============================================================
-    _initKeepAlive() {
-        const start = () => {
-            if (this._keepAliveInterval)
-                return;
-            this._keepAliveInterval = setInterval(() => {
-                this.socket.send('{"method":"ping"}');
-            }, 30_000);
-        };
-        const stop = () => {
-            clearInterval(this._keepAliveInterval);
-            this._keepAliveInterval = undefined;
-        };
-        this.socket.addEventListener("open", start);
-        this.socket.addEventListener("close", stop);
-        this.socket.addEventListener("error", stop);
-    }
-}
-//# sourceMappingURL=mod.js.map

package/esm/src/transport/websocket/mod.js.map

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

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

@@ -1,37 +0,0 @@
-/**
- * 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) or 8 (for spot) - `szDecimals` decimal places
- * - Integer prices are always allowed regardless of significant figures
- *
- * @param price - The price to format (as string or number).
- * @param szDecimals - The size decimals of the asset.
- * @param type - The market type: "perp" for perpetuals or "spot" for spot markets. Default is "perp".
- *
- * @throws {RangeError} If the formatted price is 0
- *
- * @example
- * ```ts
- * import { formatPrice } from "@nktkas/hyperliquid/utils";
- * const price = formatPrice("0.0000123456789", 0, "spot"); // → "0.00001234"
- * ```
- */
-export declare function formatPrice(price: string | number, szDecimals: number, type?: "perp" | "spot"): string;
-/**
- * Format size according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
- * - Truncate decimal places to `szDecimals`
- *
- * @param size - The size to format (as string or number).
- * @param szDecimals - The size decimals of the asset.
- *
- * @throws {RangeError} If the formatted size is 0
- *
- * @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/esm/src/utils/_format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_format.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM,CAmB9G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAY5E"}

package/esm/src/utils/_format.js

@@ -1,174 +0,0 @@
-/**
- * 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) or 8 (for spot) - `szDecimals` decimal places
- * - Integer prices are always allowed regardless of significant figures
- *
- * @param price - The price to format (as string or number).
- * @param szDecimals - The size decimals of the asset.
- * @param type - The market type: "perp" for perpetuals or "spot" for spot markets. Default is "perp".
- *
- * @throws {RangeError} If the formatted price is 0
- *
- * @example
- * ```ts
- * import { formatPrice } from "@nktkas/hyperliquid/utils";
- * const price = formatPrice("0.0000123456789", 0, "spot"); // → "0.00001234"
- * ```
- */
-export function formatPrice(price, szDecimals, type = "perp") {
-    price = price.toString().trim();
-    assertNumberString(price);
-    // Integer prices are always allowed
-    if (/^-?\d+$/.test(price))
-        return formatDecimalString(price);
-    // Apply decimal limit: max 6 (perp) or 8 (spot) - szDecimals
-    const maxDecimals = Math.max((type === "perp" ? 6 : 8) - szDecimals, 0);
-    price = StringMath.toFixedTruncate(price, maxDecimals);
-    // Apply sig figs limit: max 5 significant figures
-    price = StringMath.toPrecisionTruncate(price, 5);
-    if (price === "0") {
-        throw new RangeError("Price is too small and was truncated to 0");
-    }
-    return price;
-}
-/**
- * Format size according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
- * - Truncate decimal places to `szDecimals`
- *
- * @param size - The size to format (as string or number).
- * @param szDecimals - The size decimals of the asset.
- *
- * @throws {RangeError} If the formatted size is 0
- *
- * @example
- * ```ts
- * import { formatSize } from "@nktkas/hyperliquid/utils";
- *
- * const size = formatSize("1.23456789", 5); // → "1.23456"
- * ```
- */
-export function formatSize(size, szDecimals) {
-    size = size.toString().trim();
-    assertNumberString(size);
-    // Apply decimal limit: szDecimals
-    size = StringMath.toFixedTruncate(size, szDecimals);
-    if (size === "0") {
-        throw new RangeError("Size is too small and was truncated to 0");
-    }
-    return size;
-}
-/** String-based Math operations for arbitrary precision */
-const StringMath = {
-    /** Floor log10 (magnitude): position of most significant digit */
-    log10Floor(value) {
-        const abs = value[0] === "-" ? value.slice(1) : value;
-        // Check if zero or invalid
-        const num = Number(abs);
-        if (num === 0 || isNaN(num))
-            return -Infinity;
-        const [int, dec] = abs.split(".");
-        // Number >= 1: magnitude = length of integer part - 1
-        if (Number(int) !== 0) {
-            const trimmed = int.replace(/^0+/, "");
-            return trimmed.length - 1;
-        }
-        // Number < 1: count leading zeros in decimal part
-        const leadingZeros = dec.match(/^0*/)?.[0].length ?? 0;
-        return -(leadingZeros + 1);
-    },
-    /** Multiply by 10^exp: shift decimal point left (negative) or right (positive) */
-    multiplyByPow10(value, exp) {
-        if (!Number.isInteger(exp))
-            throw new RangeError("Exponent must be an integer");
-        if (exp === 0)
-            return formatDecimalString(value);
-        const neg = value[0] === "-";
-        const abs = neg ? value.slice(1) : value;
-        const [intRaw, dec = ""] = abs.split(".");
-        // Normalize empty integer part to "0" (handles ".5" → "0.5")
-        const int = intRaw || "0";
-        let result;
-        if (exp > 0) {
-            // Shift right: move digits from decimal to integer
-            if (exp >= dec.length) {
-                result = int + dec + "0".repeat(exp - dec.length);
-            }
-            else {
-                result = int + dec.slice(0, exp) + "." + dec.slice(exp);
-            }
-        }
-        else {
-            // Shift left: move digits from integer to decimal
-            const absExp = -exp;
-            if (absExp >= int.length) {
-                result = "0." + "0".repeat(absExp - int.length) + int + dec;
-            }
-            else {
-                result = int.slice(0, -absExp) + "." + int.slice(-absExp) + dec;
-            }
-        }
-        return formatDecimalString((neg ? "-" : "") + result);
-    },
-    /** Returns the integer part of a number by removing any fractional digits */
-    trunc(value) {
-        const dotIndex = value.indexOf(".");
-        return dotIndex === -1 ? value : value.slice(0, dotIndex) || "0";
-    },
-    /** Truncate to a certain number of significant figures */
-    toPrecisionTruncate(value, precision) {
-        if (!Number.isInteger(precision))
-            throw new RangeError("Precision must be an integer");
-        if (precision < 1)
-            throw new RangeError("Precision must be positive");
-        if (/^-?0+(\.0*)?$/.test(value))
-            return "0"; // zero is special case (don't work with log10)
-        const neg = value[0] === "-";
-        const abs = neg ? value.slice(1) : value;
-        // Calculate how much to shift: align most significant digit to ones place + (maxSigFigs-1)
-        const magnitude = StringMath.log10Floor(abs);
-        const shiftAmount = precision - 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);
-        // build final result and trim zeros
-        return formatDecimalString(neg ? "-" + result : result);
-    },
-    /** Truncate to a certain number of decimal places */
-    toFixedTruncate(value, decimals) {
-        if (!Number.isInteger(decimals))
-            throw new RangeError("Decimals must be an integer");
-        if (decimals < 0)
-            throw new RangeError("Decimals must be non-negative");
-        // Match number with up to `decimals` decimal places
-        const regex = new RegExp(`^-?(?:\\d+)?(?:\\.\\d{0,${decimals}})?`);
-        const result = value.match(regex)?.[0];
-        if (!result) {
-            throw new TypeError("Invalid number format");
-        }
-        // Trim zeros after truncation
-        return formatDecimalString(result);
-    },
-};
-function formatDecimalString(value) {
-    return value
-        // remove leading/trailing whitespace
-        .trim() // "  123.45  " → "123.45"
-        // remove leading zeros
-        .replace(/^(-?)0+(?=\d)/, "$1") // "00123" → "123", "-00.5" → "-0.5"
-        // remove trailing zeros
-        .replace(/\.0*$|(\.\d+?)0+$/, "$1") // "1.2000" → "1.2", "5.0" → "5"
-        // add leading zero if starts with decimal point
-        .replace(/^(-?)\./, "$10.") // ".5" → "0.5", "-.5" → "-0.5"
-        // add "0" if string is empty after trimming
-        .replace(/^-?$/, "0") // "" → "0", "-" → "0"
-        // normalize negative zero
-        .replace(/^-0$/, "0"); // "-0" → "0"
-}
-function assertNumberString(value) {
-    if (!/^-?(\d+\.?\d*|\.\d*)$/.test(value)) {
-        throw new TypeError("Invalid number format");
-    }
-}
-//# sourceMappingURL=_format.js.map

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

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

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

@@ -1,96 +0,0 @@
-import type { IRequestTransport } from "../transport/mod.js";
-/** Options for creating a {@link SymbolConverter} instance. */
-export interface SymbolConverterOptions {
-    /** Transport instance to use for API requests. */
-    transport: IRequestTransport;
-    /** Optional dex support: array of dex names, true for all dexs, or false/undefined to skip. */
-    dexs?: string[] | boolean;
-}
-/**
- * Utility class for converting asset symbols to their corresponding IDs and size decimals.
- * Supports perpetuals, spot markets, and optional builder dexs.
- *
- * @example
- * ```ts
- * import { HttpTransport } from "@nktkas/hyperliquid";
- * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
- *
- * 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
- *
- * 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"
- * ```
- *
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
- */
-export declare class SymbolConverter {
-    #private;
-    /**
-     * Creates a new SymbolConverter instance, but does not initialize it.
-     * Run {@link reload} to load asset data or use {@link create} to create and initialize in one step.
-     *
-     * @param options - Configuration options including transport and optional dex support.
-     */
-    constructor(options: SymbolConverterOptions);
-    /**
-     * Create and initialize a SymbolConverter instance.
-     *
-     * @param options - Configuration options including transport and optional dex support.
-     *
-     * @returns Initialized SymbolConverter instance.
-     *
-     * @example
-     * ```ts
-     * import { HttpTransport } from "@nktkas/hyperliquid";
-     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
-     *
-     * const transport = new HttpTransport(); // or `WebSocketTransport`
-     * const converter = await SymbolConverter.create({ transport });
-     * ```
-     */
-    static create(options: SymbolConverterOptions): Promise<SymbolConverter>;
-    /**
-     * Reload asset mappings from the API.
-     *
-     * Useful for refreshing data when new assets are added.
-     */
-    reload(): Promise<void>;
-    /**
-     * Get asset ID for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     *
-     * @example "BTC" → 0, "HYPE/USDC" → 10107, "test:ABC" → 110000
-     */
-    getAssetId(name: string): number | undefined;
-    /**
-     * Get size decimals for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     *
-     * @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/esm/src/utils/_symbolConverter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAU7D,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAe;;IAO1B;;;;;OAKG;gBACS,OAAO,EAAE,sBAAsB;IAK3C;;;;;;;;;;;;;;;OAeG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAiG7B;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}