@nktkas/hyperliquid 0.31.0 → 0.32.0

package/esm/utils/_format.js

@@ -0,0 +1,178 @@
+/**
+ * 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: `"perp"`.
+ * @return Formatted price string
+ *
+ * @throws {TypeError} If price is not a valid number string
+ * @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.
+ * @return Formatted size string
+ *
+ * @throws {TypeError} If size is not a valid number string
+ * @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/utils/_format.js.map

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

package/esm/utils/_symbolConverter.d.ts

@@ -0,0 +1,135 @@
+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 _transport;
+    private _dexOption;
+    private _nameToAssetId;
+    private _nameToSzDecimals;
+    private _nameToSpotPairId;
+    /**
+     * 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.
+     * @return 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>;
+    private _processDefaultPerps;
+    private _processBuilderDexs;
+    private _processBuilderDexResult;
+    private _processSpotAssets;
+    /**
+     * 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
+     * ```ts
+     * import { HttpTransport } from "@nktkas/hyperliquid";
+     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+     *
+     * const transport = new HttpTransport(); // or `WebSocketTransport`
+     * const converter = await SymbolConverter.create({ transport });
+     *
+     * converter.getAssetId("BTC"); // → 0
+     * converter.getAssetId("HYPE/USDC"); // → 10107
+     * converter.getAssetId("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
+     * ```ts
+     * import { HttpTransport } from "@nktkas/hyperliquid";
+     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+     *
+     * const transport = new HttpTransport(); // or `WebSocketTransport`
+     * const converter = await SymbolConverter.create({ transport });
+     *
+     * converter.getSzDecimals("BTC"); // → 5
+     * converter.getSzDecimals("HYPE/USDC"); // → 2
+     * converter.getSzDecimals("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
+     * ```ts
+     * import { HttpTransport } from "@nktkas/hyperliquid";
+     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+     *
+     * const transport = new HttpTransport(); // or `WebSocketTransport`
+     * const converter = await SymbolConverter.create({ transport });
+     *
+     * converter.getSpotPairId("HFUN/USDC"); // → "@2"
+     * converter.getSpotPairId("PURR/USDC"); // → "PURR/USDC" (exceptions exist for some pairs)
+     * ```
+     */
+    getSpotPairId(name: string): string | undefined;
+}
+//# sourceMappingURL=_symbolConverter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,+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;IAC1B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,iBAAiB,CAA6B;IAEtD;;;;;OAKG;gBACS,OAAO,EAAE,sBAAsB;IAK3C;;;;;;;;;;;;;;OAcG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B7B,OAAO,CAAC,oBAAoB;YAOd,mBAAmB;IA6BjC,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,kBAAkB;IAoB1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}

package/esm/utils/_symbolConverter.js

@@ -0,0 +1,217 @@
+import { meta, perpDexs, spotMeta, } from "../api/info/mod.js";
+/**
+ * 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 class SymbolConverter {
+    _transport;
+    _dexOption;
+    _nameToAssetId = new Map();
+    _nameToSzDecimals = new Map();
+    _nameToSpotPairId = new Map();
+    /**
+     * 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) {
+        this._transport = options.transport;
+        this._dexOption = options.dexs ?? false;
+    }
+    /**
+     * Create and initialize a SymbolConverter instance.
+     *
+     * @param options Configuration options including transport and optional dex support.
+     * @return 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 async create(options) {
+        const instance = new SymbolConverter(options);
+        await instance.reload();
+        return instance;
+    }
+    /**
+     * Reload asset mappings from the API.
+     *
+     * Useful for refreshing data when new assets are added.
+     */
+    async reload() {
+        const config = { transport: this._transport };
+        const needDexs = this._dexOption === true || (Array.isArray(this._dexOption) && this._dexOption.length > 0);
+        const [perpMetaData, spotMetaData, perpDexsData] = await Promise.all([
+            meta(config),
+            spotMeta(config),
+            needDexs ? perpDexs(config) : undefined,
+        ]);
+        if (!perpMetaData?.universe?.length) {
+            throw new Error("Invalid perpetual metadata response");
+        }
+        if (!spotMetaData?.universe?.length || !spotMetaData?.tokens?.length) {
+            throw new Error("Invalid spot metadata response");
+        }
+        this._nameToAssetId.clear();
+        this._nameToSzDecimals.clear();
+        this._nameToSpotPairId.clear();
+        this._processDefaultPerps(perpMetaData);
+        this._processSpotAssets(spotMetaData);
+        // Only process builder dexs if dex support is enabled
+        if (perpDexsData) {
+            await this._processBuilderDexs(perpDexsData);
+        }
+    }
+    _processDefaultPerps(perpMetaData) {
+        perpMetaData.universe.forEach((asset, index) => {
+            this._nameToAssetId.set(asset.name, index);
+            this._nameToSzDecimals.set(asset.name, asset.szDecimals);
+        });
+    }
+    async _processBuilderDexs(perpDexsData) {
+        if (!perpDexsData || perpDexsData.length <= 1)
+            return;
+        const builderDexs = perpDexsData
+            .map((dex, index) => ({ dex, index }))
+            .filter((item) => {
+            return item.index > 0 && item.dex !== null && item.dex.name.length > 0;
+        });
+        if (builderDexs.length === 0)
+            return;
+        // Filter dexs based on the dexOption
+        const dexsToProcess = Array.isArray(this._dexOption)
+            ? builderDexs.filter((item) => this._dexOption.includes(item.dex.name))
+            : builderDexs; // true means process all
+        if (dexsToProcess.length === 0)
+            return;
+        const config = { transport: this._transport };
+        const results = await Promise.allSettled(dexsToProcess.map((item) => meta(config, { dex: item.dex.name })));
+        results.forEach((result, idx) => {
+            if (result.status !== "fulfilled")
+                return;
+            this._processBuilderDexResult(result.value, dexsToProcess[idx].index);
+        });
+    }
+    _processBuilderDexResult(dexMeta, perpDexIndex) {
+        const offset = 100000 + perpDexIndex * 10000;
+        dexMeta.universe.forEach((asset, index) => {
+            const assetId = offset + index;
+            this._nameToAssetId.set(asset.name, assetId);
+            this._nameToSzDecimals.set(asset.name, asset.szDecimals);
+        });
+    }
+    _processSpotAssets(spotMetaData) {
+        const tokenMap = new Map();
+        spotMetaData.tokens.forEach((token) => {
+            tokenMap.set(token.index, { name: token.name, szDecimals: token.szDecimals });
+        });
+        spotMetaData.universe.forEach((market) => {
+            if (market.tokens.length < 2)
+                return;
+            const baseToken = tokenMap.get(market.tokens[0]);
+            const quoteToken = tokenMap.get(market.tokens[1]);
+            if (!baseToken || !quoteToken)
+                return;
+            const assetId = 10000 + market.index;
+            const baseQuoteKey = `${baseToken.name}/${quoteToken.name}`;
+            this._nameToAssetId.set(baseQuoteKey, assetId);
+            this._nameToSzDecimals.set(baseQuoteKey, baseToken.szDecimals);
+            this._nameToSpotPairId.set(baseQuoteKey, market.name);
+        });
+    }
+    /**
+     * 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
+     * ```ts
+     * import { HttpTransport } from "@nktkas/hyperliquid";
+     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+     *
+     * const transport = new HttpTransport(); // or `WebSocketTransport`
+     * const converter = await SymbolConverter.create({ transport });
+     *
+     * converter.getAssetId("BTC"); // → 0
+     * converter.getAssetId("HYPE/USDC"); // → 10107
+     * converter.getAssetId("test:ABC"); // → 110000
+     * ```
+     */
+    getAssetId(name) {
+        return this._nameToAssetId.get(name);
+    }
+    /**
+     * 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
+     * ```ts
+     * import { HttpTransport } from "@nktkas/hyperliquid";
+     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+     *
+     * const transport = new HttpTransport(); // or `WebSocketTransport`
+     * const converter = await SymbolConverter.create({ transport });
+     *
+     * converter.getSzDecimals("BTC"); // → 5
+     * converter.getSzDecimals("HYPE/USDC"); // → 2
+     * converter.getSzDecimals("test:ABC"); // → 0
+     * ```
+     */
+    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
+     * ```ts
+     * import { HttpTransport } from "@nktkas/hyperliquid";
+     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+     *
+     * const transport = new HttpTransport(); // or `WebSocketTransport`
+     * const converter = await SymbolConverter.create({ transport });
+     *
+     * converter.getSpotPairId("HFUN/USDC"); // → "@2"
+     * converter.getSpotPairId("PURR/USDC"); // → "PURR/USDC" (exceptions exist for some pairs)
+     * ```
+     */
+    getSpotPairId(name) {
+        return this._nameToSpotPairId.get(name);
+    }
+}
+//# sourceMappingURL=_symbolConverter.js.map

package/esm/utils/_symbolConverter.js.map

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

package/esm/utils/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/utils/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/esm/utils/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/utils/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nktkas/hyperliquid",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Hyperliquid API SDK for all major JS runtimes, written in TypeScript.",
   "keywords": [
     "api",
@@ -30,46 +30,42 @@
   "bugs": {
     "url": "https://github.com/nktkas/hyperliquid/issues"
   },
-  "main": "./script/src/mod.js",
-  "module": "./esm/src/mod.js",
+  "main": "./script/mod.js",
+  "module": "./esm/mod.js",
   "exports": {
     ".": {
-      "import": "./esm/src/mod.js",
-      "require": "./script/src/mod.js"
+      "import": "./esm/mod.js",
+      "require": "./script/mod.js"
     },
     "./signing": {
-      "import": "./esm/src/signing/mod.js",
-      "require": "./script/src/signing/mod.js"
+      "import": "./esm/signing/mod.js",
+      "require": "./script/signing/mod.js"
     },
     "./utils": {
-      "import": "./esm/src/utils/mod.js",
-      "require": "./script/src/utils/mod.js"
+      "import": "./esm/utils/mod.js",
+      "require": "./script/utils/mod.js"
     },
     "./api/exchange": {
-      "import": "./esm/src/api/exchange/mod.js",
-      "require": "./script/src/api/exchange/mod.js"
+      "import": "./esm/api/exchange/mod.js",
+      "require": "./script/api/exchange/mod.js"
     },
     "./api/info": {
-      "import": "./esm/src/api/info/mod.js",
-      "require": "./script/src/api/info/mod.js"
+      "import": "./esm/api/info/mod.js",
+      "require": "./script/api/info/mod.js"
     },
     "./api/subscription": {
-      "import": "./esm/src/api/subscription/mod.js",
-      "require": "./script/src/api/subscription/mod.js"
+      "import": "./esm/api/subscription/mod.js",
+      "require": "./script/api/subscription/mod.js"
     }
   },
   "scripts": {},
-  "bin": {
-    "@nktkas/hyperliquid": "./esm/bin/cli.js"
-  },
   "sideEffects": false,
   "engines": {
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@nktkas/rews": "^1.2.3",
-    "@noble/hashes": "^2.0.1",
-    "micro-eth-signer": "^0.18.1",
+    "@nktkas/rews": "^2",
+    "@noble/hashes": "^2",
     "valibot": "1.2.0"
   },
   "_generatedBy": "dnt@dev"

package/script/_base.d.ts

@@ -0,0 +1,15 @@
+import * as v from "valibot";
+/** Base error class for all SDK errors. */
+export declare class HyperliquidError extends Error {
+    constructor(message?: string, options?: ErrorOptions);
+}
+/** Thrown when request parameters fail schema validation. */
+export declare class ValidationError extends HyperliquidError {
+    cause: v.ValiError<v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>>;
+    constructor(message: string, options: {
+        cause: v.ValiError<v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>>;
+    });
+}
+/** Wrapper around `v.parse` that throws {@linkcode ValidationError} instead of `ValiError`. */
+export declare function parse<const TSchema extends v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>>(schema: TSchema, input: unknown): v.InferOutput<TSchema>;
+//# sourceMappingURL=_base.d.ts.map

package/script/_base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_base.d.ts","sourceRoot":"","sources":["../src/_base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,2CAA2C;AAC3C,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIrD;AAED,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,gBAAgB;IAC1C,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACtE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE;CAKnH;AAED,+FAA+F;AAC/F,wBAAgB,KAAK,CACnB,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAC1E,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAOzD"}