@nktkas/hyperliquid 0.31.0 → 0.32.0

package/esm/src/transport/websocket/_subscriptionManager.d.ts

@@ -1,51 +0,0 @@
-import type { ReconnectingWebSocket } from "@nktkas/rews";
-import type { ISubscription } from "../_base.js";
-import type { HyperliquidEventTarget } from "./_hyperliquidEventTarget.js";
-import { WebSocketPostRequest } from "./_postRequest.js";
-/** Internal state for managing a subscription. */
-interface SubscriptionState {
-    /** Map of event listeners to their unsubscribe functions. */
-    listeners: Map<(data: CustomEvent) => void, () => Promise<void>>;
-    /** Promise tracking the subscription request. */
-    promise: Promise<unknown>;
-    /** Whether the subscription request has completed. */
-    promiseFinished: boolean;
-    /** Controller to signal subscription failure. */
-    failureController: AbortController;
-}
-/**
- * Manages WebSocket subscriptions to Hyperliquid event channels.
- * Handles subscription lifecycle, resubscription on reconnect, and cleanup.
- */
-export declare class WebSocketSubscriptionManager {
-    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
-    resubscribe: boolean;
-    protected _socket: ReconnectingWebSocket;
-    protected _postRequest: WebSocketPostRequest;
-    protected _hlEvents: HyperliquidEventTarget;
-    protected _subscriptions: Map<string, SubscriptionState>;
-    constructor(socket: ReconnectingWebSocket, postRequest: WebSocketPostRequest, hlEvents: HyperliquidEventTarget, resubscribe: boolean);
-    /**
-     * 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<T>(channel: string, payload: unknown, listener: (data: CustomEvent<T>) => void): Promise<ISubscription>;
-    /** Resubscribe to all existing subscriptions if auto-resubscribe is enabled. */
-    protected _handleOpen(): void;
-    /** Cleanup subscriptions if resubscribe is disabled or socket is terminated. */
-    protected _handleClose(): void;
-    /** Checks if a payload contains a user parameter. */
-    protected _hasUserParam(payload: unknown): boolean;
-    /** Counts the number of unique users across all active subscriptions. */
-    protected _countUniqueUserSubscriptions(): number;
-}
-export {};
-//# sourceMappingURL=_subscriptionManager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"_subscriptionManager.d.ts","sourceRoot":"","sources":["../../../../src/src/transport/websocket/_subscriptionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAyB,MAAM,mBAAmB,CAAC;AAQhF,kDAAkD;AAClD,UAAU,iBAAiB;IACzB,6DAA6D;IAC7D,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,sDAAsD;IACtD,eAAe,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,iBAAiB,EAAE,eAAe,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,4BAA4B;IACvC,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IAErB,SAAS,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACzC,SAAS,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC7C,SAAS,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC5C,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAa;gBAGnE,MAAM,EAAE,qBAAqB,EAC7B,WAAW,EAAE,oBAAoB,EACjC,QAAQ,EAAE,sBAAsB,EAChC,WAAW,EAAE,OAAO;IAiBtB;;;;;;;;;;;OAWG;IACG,SAAS,CAAC,CAAC,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,OAAO,CAAC,aAAa,CAAC;IAuEzB,gFAAgF;IAChF,SAAS,CAAC,WAAW,IAAI,IAAI;IAc7B,gFAAgF;IAChF,SAAS,CAAC,YAAY,IAAI,IAAI;IAc9B,qDAAqD;IACrD,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAIlD,yEAAyE;IACzE,SAAS,CAAC,6BAA6B,IAAI,MAAM;CAclD"}

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

@@ -1,150 +0,0 @@
-import { WebSocketPostRequest, WebSocketRequestError } from "./_postRequest.js";
-/** Maximum number of subscriptions allowed by Hyperliquid. */
-const MAX_SUBSCRIPTIONS = 1000;
-/** Maximum number of unique user subscriptions allowed by Hyperliquid. */
-const MAX_UNIQUE_USER_SUBSCRIPTIONS = 10;
-/**
- * Manages WebSocket subscriptions to Hyperliquid event channels.
- * Handles subscription lifecycle, resubscription on reconnect, and cleanup.
- */
-export class WebSocketSubscriptionManager {
-    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
-    resubscribe;
-    _socket;
-    _postRequest;
-    _hlEvents;
-    _subscriptions = new Map();
-    constructor(socket, postRequest, hlEvents, resubscribe) {
-        this._socket = socket;
-        this._postRequest = postRequest;
-        this._hlEvents = hlEvents;
-        this.resubscribe = resubscribe;
-        // Subscribe to socket events
-        socket.addEventListener("open", () => this._handleOpen());
-        socket.addEventListener("close", () => this._handleClose());
-        socket.addEventListener("error", () => this._handleClose());
-    }
-    // ============================================================
-    // Public methods
-    // ============================================================
-    /**
-     * 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.
-     */
-    async subscribe(channel, payload, listener) {
-        // Create a unique identifier for the subscription
-        const id = WebSocketPostRequest.requestToId(payload);
-        // Initialize new subscription, if it doesn't exist
-        let subscription = this._subscriptions.get(id);
-        if (!subscription) {
-            // Check unique subscription limits
-            if (this._subscriptions.size >= MAX_SUBSCRIPTIONS) {
-                throw new WebSocketRequestError("Cannot subscribe to more than 1000 channels");
-            }
-            // Check unique user subscription limits
-            if (this._hasUserParam(payload) && this._countUniqueUserSubscriptions() >= MAX_UNIQUE_USER_SUBSCRIPTIONS) {
-                throw new WebSocketRequestError("Cannot track more than 10 unique users");
-            }
-            // Send subscription request
-            const promise = this._postRequest.request("subscribe", payload)
-                .finally(() => subscription.promiseFinished = true);
-            // Cache subscription info
-            subscription = {
-                listeners: new Map(),
-                promise,
-                promiseFinished: false,
-                failureController: new AbortController(),
-            };
-            this._subscriptions.set(id, subscription);
-        }
-        // Initialize new listener, if it doesn't exist
-        let unsubscribe = subscription.listeners.get(listener);
-        if (!unsubscribe) {
-            // Create new unsubscribe function
-            unsubscribe = async () => {
-                // Remove listener and cleanup
-                this._hlEvents.removeEventListener(channel, listener);
-                const subscription = this._subscriptions.get(id);
-                subscription?.listeners.delete(listener);
-                // If no listeners remain, remove subscription entirely
-                if (subscription?.listeners.size === 0) {
-                    // Cleanup subscription
-                    this._subscriptions.delete(id);
-                    // If the socket is open, send unsubscription request
-                    if (this._socket.readyState === 1) { // OPEN
-                        await this._postRequest.request("unsubscribe", payload);
-                    }
-                }
-            };
-            // Add listener and cache unsubscribe function
-            this._hlEvents.addEventListener(channel, listener);
-            subscription.listeners.set(listener, unsubscribe);
-        }
-        // Wait for the initial subscription request to complete
-        await subscription.promise;
-        // Return subscription control object
-        return {
-            unsubscribe,
-            failureSignal: subscription.failureController.signal,
-        };
-    }
-    // ============================================================
-    // Socket event handlers
-    // ============================================================
-    /** Resubscribe to all existing subscriptions if auto-resubscribe is enabled. */
-    _handleOpen() {
-        if (this.resubscribe) {
-            for (const [id, subscription] of this._subscriptions.entries()) {
-                // reconnect only previously connected subscriptions to avoid double subscriptions due to message buffering
-                if (subscription.promiseFinished) {
-                    subscription.promise = this._postRequest.request("subscribe", JSON.parse(id))
-                        .catch((error) => subscription.failureController.abort(error))
-                        .finally(() => subscription.promiseFinished = true);
-                    subscription.promiseFinished = false;
-                }
-            }
-        }
-    }
-    /** Cleanup subscriptions if resubscribe is disabled or socket is terminated. */
-    _handleClose() {
-        if (!this.resubscribe || this._socket.terminationSignal.aborted) {
-            for (const subscriptionInfo of this._subscriptions.values()) {
-                for (const [_, unsubscribe] of subscriptionInfo.listeners) {
-                    unsubscribe(); // does not cause an error if used when the connection is closed
-                }
-            }
-        }
-    }
-    // ============================================================
-    // Subscription limit checks
-    // ============================================================
-    /** Checks if a payload contains a user parameter. */
-    _hasUserParam(payload) {
-        return typeof payload === "object" && payload !== null && "user" in payload;
-    }
-    /** Counts the number of unique users across all active subscriptions. */
-    _countUniqueUserSubscriptions() {
-        const users = new Set();
-        for (const id of this._subscriptions.keys()) {
-            try {
-                const payload = JSON.parse(id);
-                if (this._hasUserParam(payload)) {
-                    users.add(payload.user);
-                }
-            }
-            catch {
-                // Ignore parsing errors
-            }
-        }
-        return users.size;
-    }
-}
-//# sourceMappingURL=_subscriptionManager.js.map

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

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

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

@@ -1,142 +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 type { IRequestTransport, ISubscription, ISubscriptionTransport } from "../_base.js";
-import { ReconnectingWebSocket, type ReconnectingWebSocketOptions } from "@nktkas/rews";
-import { HyperliquidEventTarget } from "./_hyperliquidEventTarget.js";
-import { WebSocketPostRequest, WebSocketRequestError } from "./_postRequest.js";
-import { WebSocketSubscriptionManager } from "./_subscriptionManager.js";
-export { WebSocketRequestError };
-/** Configuration options for the WebSocket transport layer. */
-export interface WebSocketTransportOptions {
-    /**
-     * Indicates this transport uses testnet endpoint.
-     * @default false
-     */
-    isTestnet?: boolean;
-    /**
-     * Custom WebSocket endpoint for API and Subscription requests.
-     * - Mainnet:
-     *   - API: `wss://api.hyperliquid.xyz/ws`
-     *   - Explorer: `wss://rpc.hyperliquid.xyz/ws`
-     * - Testnet:
-     *   - API: `wss://api.hyperliquid-testnet.xyz/ws`
-     *   - Explorer: `wss://rpc.hyperliquid-testnet.xyz/ws`
-     * @default `wss://api.hyperliquid.xyz/ws` for mainnet, `wss://api.hyperliquid-testnet.xyz/ws` for testnet
-     */
-    url?: string | URL;
-    /**
-     * Timeout for requests in ms. Set to `null` to disable.
-     * @default 10_000
-     */
-    timeout?: number | null;
-    /** Reconnection policy configuration for closed connections. */
-    reconnect?: ReconnectingWebSocketOptions;
-    /**
-     * Enable automatic re-subscription to Hyperliquid subscription after reconnection.
-     * @default true
-     */
-    resubscribe?: boolean;
-}
-/** Mainnet API WebSocket URL. */
-export declare const MAINNET_API_WS_URL = "wss://api.hyperliquid.xyz/ws";
-/** Testnet API WebSocket URL. */
-export declare const TESTNET_API_WS_URL = "wss://api.hyperliquid-testnet.xyz/ws";
-/** Mainnet RPC WebSocket URL. */
-export declare const MAINNET_RPC_WS_URL = "wss://rpc.hyperliquid.xyz/ws";
-/** Testnet RPC WebSocket URL. */
-export declare 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 declare class WebSocketTransport implements IRequestTransport, ISubscriptionTransport {
-    /** Indicates this transport uses testnet endpoint. */
-    readonly isTestnet: boolean;
-    /** The WebSocket that is used for communication. */
-    readonly socket: ReconnectingWebSocket;
-    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
-    get resubscribe(): boolean;
-    set resubscribe(value: boolean);
-    /** Timeout for requests in ms. Set to `null` to disable. */
-    get timeout(): number | null;
-    set timeout(value: number | null);
-    protected _postRequest: WebSocketPostRequest;
-    protected _hlEvents: HyperliquidEventTarget;
-    protected _subscriptionManager: WebSocketSubscriptionManager;
-    protected _keepAliveInterval: ReturnType<typeof setInterval> | undefined;
-    /**
-     * Creates a new WebSocket transport instance.
-     *
-     * @param options - Configuration options for the WebSocket transport layer.
-     */
-    constructor(options?: WebSocketTransportOptions);
-    /**
-     * 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.
-     */
-    request<T>(endpoint: "info" | "exchange", payload: unknown, signal?: AbortSignal): Promise<T>;
-    /**
-     * 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<T>(channel: string, payload: unknown, listener: (data: CustomEvent<T>) => void): Promise<ISubscription>;
-    /**
-     * 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?: AbortSignal): Promise<void>;
-    /**
-     * 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?: AbortSignal): Promise<void>;
-    protected _initKeepAlive(): void;
-}
-//# sourceMappingURL=mod.d.ts.map

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"}