@nktkas/hyperliquid 0.31.0 → 0.32.0

package/script/transport/http/mod.d.ts

@@ -0,0 +1,112 @@
+/**
+ * HTTP transport for executing requests to the Hyperliquid API.
+ *
+ * Use {@link HttpTransport} for simple requests via HTTP POST.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";
+ *
+ * const transport = new HttpTransport();
+ * const client = new InfoClient({ transport });
+ *
+ * const mids = await client.allMids();
+ * ```
+ *
+ * @module
+ */
+import { type IRequestTransport, TransportError } from "../_base.js";
+/** Configuration options for the HTTP transport layer. */
+export interface HttpTransportOptions {
+    /**
+     * Indicates this transport uses testnet endpoint.
+     *
+     * Default: false
+     */
+    isTestnet?: boolean;
+    /**
+     * Request timeout in ms. Set to `null` to disable.
+     *
+     * Default: `10_000`
+     */
+    timeout?: number | null;
+    /**
+     * Custom API URL for requests.
+     *
+     * Default: `https://api.hyperliquid.xyz` for mainnet, `https://api.hyperliquid-testnet.xyz` for testnet.
+     */
+    apiUrl?: string | URL;
+    /**
+     * Custom RPC URL for explorer requests.
+     *
+     * Default: `https://rpc.hyperliquid.xyz` for mainnet, `https://rpc.hyperliquid-testnet.xyz` for testnet.
+     */
+    rpcUrl?: string | URL;
+    /** A custom {@link https://developer.mozilla.org/en-US/docs/Web/API/RequestInit | RequestInit} that is merged with a fetch request. */
+    fetchOptions?: Omit<RequestInit, "body" | "method">;
+}
+/** Mainnet API URL. */
+export declare const MAINNET_API_URL = "https://api.hyperliquid.xyz";
+/** Testnet API URL. */
+export declare const TESTNET_API_URL = "https://api.hyperliquid-testnet.xyz";
+/** Mainnet RPC URL. */
+export declare const MAINNET_RPC_URL = "https://rpc.hyperliquid.xyz";
+/** Testnet RPC URL. */
+export declare const TESTNET_RPC_URL = "https://rpc.hyperliquid-testnet.xyz";
+/** Error thrown when an HTTP request fails. */
+export declare class HttpRequestError extends TransportError {
+    /** The HTTP response that caused the error. */
+    response?: Response;
+    /**
+     * Creates a new HTTP request error.
+     *
+     * @param args The error arguments.
+     * @param args.response The HTTP response that caused the error.
+     * @param args.message Optional message to append after the status line.
+     * @param options The error options.
+     */
+    constructor(args?: {
+        response?: Response;
+        message?: string;
+    }, options?: ErrorOptions);
+}
+/**
+ * HTTP 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
+ */
+export declare class HttpTransport implements IRequestTransport {
+    /** Indicates this transport uses testnet endpoint. */
+    isTestnet: boolean;
+    /** Request timeout in ms. Set to `null` to disable. */
+    timeout: number | null;
+    /** Custom API URL for requests. */
+    apiUrl: string | URL;
+    /** Custom RPC URL for explorer requests. */
+    rpcUrl: string | URL;
+    /** A custom {@link https://developer.mozilla.org/en-US/docs/Web/API/RequestInit | RequestInit} that is merged with a fetch request. */
+    fetchOptions: Omit<RequestInit, "body" | "method">;
+    /**
+     * Creates a new HTTP transport instance.
+     *
+     * @param options Configuration options for the HTTP transport layer.
+     */
+    constructor(options?: HttpTransportOptions);
+    /**
+     * Sends a request to the Hyperliquid API via {@link https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API | fetch}.
+     *
+     * @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.
+     * @return A promise that resolves with parsed JSON response body.
+     *
+     * @throws {HttpRequestError} Thrown when the HTTP request fails.
+     */
+    request<T>(endpoint: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<T>;
+    /** Merges multiple `HeadersInit` into one {@link https://developer.mozilla.org/en-US/docs/Web/API/Headers/Headers | Headers}. */
+    protected _mergeHeadersInit(...inits: HeadersInit[]): Headers;
+    /** Merges multiple {@link https://developer.mozilla.org/en-US/docs/Web/API/RequestInit | RequestInit} into one {@link https://developer.mozilla.org/en-US/docs/Web/API/RequestInit | RequestInit}. */
+    protected _mergeRequestInit(...inits: RequestInit[]): RequestInit;
+}
+//# sourceMappingURL=mod.d.ts.map

package/script/transport/http/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/transport/http/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGrE,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACtB,uIAAuI;IACvI,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CACrD;AAED,uBAAuB;AACvB,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,uBAAuB;AACvB,eAAO,MAAM,eAAe,wCAAwC,CAAC;AACrE,uBAAuB;AACvB,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,uBAAuB;AACvB,eAAO,MAAM,eAAe,wCAAwC,CAAC;AAErE,+CAA+C;AAC/C,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;;;OAOG;gBACS,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,YAAY;CAerF;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mCAAmC;IACnC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;IACrB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;IACrB,uIAAuI;IACvI,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IAEnD;;;;OAIG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAQ1C;;;;;;;;;OASG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA8ChH,iIAAiI;IACjI,SAAS,CAAC,iBAAiB,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO;IAW7D,sMAAsM;IACtM,SAAS,CAAC,iBAAiB,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW;CAelE"}

package/script/transport/http/mod.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * HTTP transport for executing requests to the Hyperliquid API.
+ *
+ * Use {@link HttpTransport} for simple requests via HTTP POST.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";
+ *
+ * const transport = new HttpTransport();
+ * const client = new InfoClient({ transport });
+ *
+ * const mids = await client.allMids();
+ * ```
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpTransport = exports.HttpRequestError = exports.TESTNET_RPC_URL = exports.MAINNET_RPC_URL = exports.TESTNET_API_URL = exports.MAINNET_API_URL = void 0;
+const _base_js_1 = require("../_base.js");
+const _polyfills_js_1 = require("../_polyfills.js");
+/** Mainnet API URL. */
+exports.MAINNET_API_URL = "https://api.hyperliquid.xyz";
+/** Testnet API URL. */
+exports.TESTNET_API_URL = "https://api.hyperliquid-testnet.xyz";
+/** Mainnet RPC URL. */
+exports.MAINNET_RPC_URL = "https://rpc.hyperliquid.xyz";
+/** Testnet RPC URL. */
+exports.TESTNET_RPC_URL = "https://rpc.hyperliquid-testnet.xyz";
+/** Error thrown when an HTTP request fails. */
+class HttpRequestError extends _base_js_1.TransportError {
+    /** The HTTP response that caused the error. */
+    response;
+    /**
+     * Creates a new HTTP request error.
+     *
+     * @param args The error arguments.
+     * @param args.response The HTTP response that caused the error.
+     * @param args.message Optional message to append after the status line.
+     * @param options The error options.
+     */
+    constructor(args, options) {
+        const { response, message: detail } = args ?? {};
+        let message;
+        if (response) {
+            message = `${response.status} ${response.statusText}`.trim();
+            if (detail)
+                message += ` - ${detail}`;
+        }
+        else {
+            message = `Unknown HTTP request error: ${options?.cause}`;
+        }
+        super(message, options);
+        this.name = "HttpRequestError";
+        this.response = response;
+    }
+}
+exports.HttpRequestError = HttpRequestError;
+/**
+ * HTTP 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
+ */
+class HttpTransport {
+    /** Indicates this transport uses testnet endpoint. */
+    isTestnet;
+    /** Request timeout in ms. Set to `null` to disable. */
+    timeout;
+    /** Custom API URL for requests. */
+    apiUrl;
+    /** Custom RPC URL for explorer requests. */
+    rpcUrl;
+    /** A custom {@link https://developer.mozilla.org/en-US/docs/Web/API/RequestInit | RequestInit} that is merged with a fetch request. */
+    fetchOptions;
+    /**
+     * Creates a new HTTP transport instance.
+     *
+     * @param options Configuration options for the HTTP transport layer.
+     */
+    constructor(options) {
+        this.isTestnet = options?.isTestnet ?? false;
+        this.timeout = options?.timeout === undefined ? 10_000 : options.timeout;
+        this.apiUrl = options?.apiUrl ?? (this.isTestnet ? exports.TESTNET_API_URL : exports.MAINNET_API_URL);
+        this.rpcUrl = options?.rpcUrl ?? (this.isTestnet ? exports.TESTNET_RPC_URL : exports.MAINNET_RPC_URL);
+        this.fetchOptions = options?.fetchOptions ?? {};
+    }
+    /**
+     * Sends a request to the Hyperliquid API via {@link https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API | fetch}.
+     *
+     * @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.
+     * @return A promise that resolves with parsed JSON response body.
+     *
+     * @throws {HttpRequestError} Thrown when the HTTP request fails.
+     */
+    async request(endpoint, payload, signal) {
+        try {
+            // Construct a Request
+            const url = new URL(endpoint, endpoint === "explorer" ? this.rpcUrl : this.apiUrl);
+            const init = this._mergeRequestInit({
+                body: JSON.stringify(payload),
+                headers: {
+                    "Accept-Encoding": "gzip, deflate, br, zstd",
+                    "Content-Type": "application/json",
+                },
+                keepalive: true,
+                method: "POST",
+                signal: this.timeout ? _polyfills_js_1.AbortSignal_.timeout(this.timeout) : undefined,
+            }, this.fetchOptions, { signal });
+            // Send the Request and wait for a Response
+            const response = await fetch(url, init);
+            // Validate the Response
+            if (!response.ok || !response.headers.get("Content-Type")?.includes("application/json")) {
+                const clone = response.clone();
+                const body = await response.text().catch(() => undefined); // releases connection, clone stays readable
+                throw new HttpRequestError({ response: clone, message: body });
+            }
+            // Parse the response body
+            const clone = response.clone();
+            const body = await response.json();
+            // Check if the response is an error
+            if (body?.type === "error") {
+                throw new HttpRequestError({ response: clone, message: body?.message });
+            }
+            // Return the response body
+            return body;
+        }
+        catch (error) {
+            if (error instanceof _base_js_1.TransportError)
+                throw error; // Re-throw known errors
+            throw new HttpRequestError(undefined, { cause: error });
+        }
+    }
+    /** Merges multiple `HeadersInit` into one {@link https://developer.mozilla.org/en-US/docs/Web/API/Headers/Headers | Headers}. */
+    _mergeHeadersInit(...inits) {
+        const merged = new Headers();
+        for (const headers of inits) {
+            const entries = Symbol.iterator in headers ? headers : Object.entries(headers);
+            for (const [key, value] of entries) {
+                merged.set(key, value);
+            }
+        }
+        return merged;
+    }
+    /** Merges multiple {@link https://developer.mozilla.org/en-US/docs/Web/API/RequestInit | RequestInit} into one {@link https://developer.mozilla.org/en-US/docs/Web/API/RequestInit | RequestInit}. */
+    _mergeRequestInit(...inits) {
+        const merged = {};
+        const headersList = [];
+        const signals = [];
+        for (const init of inits) {
+            Object.assign(merged, init);
+            if (init.headers)
+                headersList.push(init.headers);
+            if (init.signal)
+                signals.push(init.signal);
+        }
+        if (headersList.length > 0)
+            merged.headers = this._mergeHeadersInit(...headersList);
+        if (signals.length > 0)
+            merged.signal = signals.length > 1 ? _polyfills_js_1.AbortSignal_.any(signals) : signals[0];
+        return merged;
+    }
+}
+exports.HttpTransport = HttpTransport;
+//# sourceMappingURL=mod.js.map

package/script/transport/http/mod.js.map

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

package/script/transport/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/transport/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/script/transport/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/transport/mod.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,gDAA8B;AAC9B,qDAAmC"}

package/script/transport/websocket/_hyperliquidEventTarget.d.ts

@@ -0,0 +1,67 @@
+interface SubscribeUnsubscribeResponse {
+    method: "subscribe" | "unsubscribe";
+    /** Original subscription request payload. */
+    subscription: unknown;
+}
+interface PostResponse {
+    id: number;
+    response: {
+        type: "info";
+        payload: {
+            type: string;
+            data: unknown;
+        };
+    } | {
+        type: "action";
+        payload: {
+            status: "ok" | "err";
+            response: {
+                type: string;
+                data?: unknown;
+            } | string;
+        };
+    } | {
+        type: "error";
+        /** Error message, e.g. "Cannot track more than 10 total users." */
+        payload: string;
+    };
+}
+interface BlockDetails {
+    blockTime: number;
+    hash: string;
+    height: number;
+    numTxs: number;
+    proposer: string;
+}
+interface TxDetails {
+    action: {
+        type: string;
+        [key: string]: unknown;
+    };
+    block: number;
+    error: string | null;
+    hash: string;
+    time: number;
+    user: string;
+}
+/** Base system events and dynamic channel events for Hyperliquid WebSocket API. */
+interface HyperliquidEventMap {
+    subscriptionResponse: CustomEvent<SubscribeUnsubscribeResponse>;
+    post: CustomEvent<PostResponse>;
+    error: CustomEvent<string>;
+    pong: CustomEvent<undefined>;
+    explorerBlock_: CustomEvent<BlockDetails[]>;
+    explorerTxs_: CustomEvent<TxDetails[]>;
+    [key: string]: CustomEvent<any>;
+}
+/** Listens for WebSocket messages and sends them as Hyperliquid typed events. */
+export interface HyperliquidEventTarget {
+    addEventListener<K extends keyof HyperliquidEventMap>(type: K, listener: ((event: HyperliquidEventMap[K]) => void) | EventListenerObject | null, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof HyperliquidEventMap>(type: K, listener: ((event: HyperliquidEventMap[K]) => void) | EventListenerObject | null, options?: boolean | EventListenerOptions): void;
+    dispatchEvent(event: HyperliquidEventMap[keyof HyperliquidEventMap]): boolean;
+}
+export declare class HyperliquidEventTarget extends EventTarget {
+    constructor(socket: WebSocket);
+}
+export {};
+//# sourceMappingURL=_hyperliquidEventTarget.d.ts.map

package/script/transport/websocket/_hyperliquidEventTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_hyperliquidEventTarget.d.ts","sourceRoot":"","sources":["../../../src/transport/websocket/_hyperliquidEventTarget.ts"],"names":[],"mappings":"AAEA,UAAU,4BAA4B;IACpC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EACJ;QACA,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;KAC1C,GACC;QACA,IAAI,EAAE,QAAQ,CAAC;QACf,OAAO,EAAE;YACP,MAAM,EAAE,IAAI,GAAG,KAAK,CAAC;YACrB,QAAQ,EACJ;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,OAAO,CAAA;aAAE,GAChC,MAAM,CAAC;SACZ,CAAC;KACH,GACC;QACA,IAAI,EAAE,OAAO,CAAC;QACd,mEAAmE;QACnE,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACL;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,UAAU,mBAAmB;IAC3B,oBAAoB,EAAE,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAChE,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7B,cAAc,EAAE,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC;IAC5C,YAAY,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;IAEvC,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;CACjC;AA6BD,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAClD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,mBAAmB,GAAG,IAAI,EAChF,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;IACR,mBAAmB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACrD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,mBAAmB,GAAG,IAAI,EAChF,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GACvC,IAAI,CAAC;IACR,aAAa,CAAC,KAAK,EAAE,mBAAmB,CAAC,MAAM,mBAAmB,CAAC,GAAG,OAAO,CAAC;CAC/E;AACD,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,MAAM,EAAE,SAAS;CAmB9B"}

package/script/transport/websocket/_hyperliquidEventTarget.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperliquidEventTarget = void 0;
+const _polyfills_js_1 = require("../_polyfills.js");
+function isHyperliquidEvent(msg) {
+    return typeof msg === "object" && msg !== null &&
+        "channel" in msg && typeof msg.channel === "string" &&
+        "data" in msg;
+}
+function isPongEvent(msg) {
+    return typeof msg === "object" && msg !== null &&
+        "channel" in msg && msg.channel === "pong";
+}
+function isExplorerBlockEvent(msg) {
+    return Array.isArray(msg) && msg.length > 0 &&
+        typeof msg[0] === "object" && msg[0] !== null &&
+        "blockTime" in msg[0] && "hash" in msg[0] &&
+        "height" in msg[0] && "numTxs" in msg[0] &&
+        "proposer" in msg[0];
+}
+function isExplorerTxsEvent(msg) {
+    return Array.isArray(msg) && msg.length > 0 &&
+        typeof msg[0] === "object" && msg[0] !== null &&
+        "action" in msg[0] && "block" in msg[0] &&
+        "error" in msg[0] && "hash" in msg[0] &&
+        "time" in msg[0] && "user" in msg[0];
+}
+class HyperliquidEventTarget extends EventTarget {
+    constructor(socket) {
+        super();
+        socket.addEventListener("message", (event) => {
+            try {
+                const msg = JSON.parse(event.data);
+                if (isHyperliquidEvent(msg)) {
+                    this.dispatchEvent(new _polyfills_js_1.CustomEvent_(msg.channel, { detail: msg.data }));
+                }
+                else if (isPongEvent(msg)) {
+                    this.dispatchEvent(new _polyfills_js_1.CustomEvent_("pong", { detail: undefined }));
+                }
+                else if (isExplorerBlockEvent(msg)) {
+                    this.dispatchEvent(new _polyfills_js_1.CustomEvent_("explorerBlock_", { detail: msg }));
+                }
+                else if (isExplorerTxsEvent(msg)) {
+                    this.dispatchEvent(new _polyfills_js_1.CustomEvent_("explorerTxs_", { detail: msg }));
+                }
+            }
+            catch {
+                // Ignore JSON parsing errors
+            }
+        });
+    }
+}
+exports.HyperliquidEventTarget = HyperliquidEventTarget;
+//# sourceMappingURL=_hyperliquidEventTarget.js.map

package/script/transport/websocket/_hyperliquidEventTarget.js.map

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

package/script/transport/websocket/_postRequest.d.ts

@@ -0,0 +1,42 @@
+import type { ReconnectingWebSocket } from "@nktkas/rews";
+import { TransportError } from "../_base.js";
+import type { HyperliquidEventTarget } from "./_hyperliquidEventTarget.js";
+interface PendingRequest {
+    id: number | string;
+    resolve: (value?: any) => void;
+    reject: (reason?: any) => void;
+}
+/** Error thrown when a WebSocket request fails. */
+export declare class WebSocketRequestError extends TransportError {
+    constructor(message?: string, options?: ErrorOptions);
+}
+/**
+ * Manages WebSocket post requests to the Hyperliquid API.
+ * Handles request creation, sending, and mapping responses to their corresponding requests.
+ */
+export declare class WebSocketPostRequest {
+    /** Timeout for requests in ms. Set to `null` to disable. */
+    timeout: number | null;
+    protected readonly _socket: ReconnectingWebSocket;
+    protected _lastId: number;
+    protected _queue: PendingRequest[];
+    /**
+     * Creates a new WebSocket async request handler.
+     *
+     * @param socket WebSocket connection instance for sending requests to the Hyperliquid WebSocket API
+     * @param hlEvents Used to recognize Hyperliquid responses and match them with sent requests
+     * @param timeout Timeout for requests in ms. Set to `null` to disable.
+     */
+    constructor(socket: ReconnectingWebSocket, hlEvents: HyperliquidEventTarget, timeout: number | null);
+    /**
+     * Sends a request to the Hyperliquid API.
+     *
+     * @return A promise that resolves with the parsed JSON response body.
+     */
+    request(method: "ping", signal?: AbortSignal): Promise<void>;
+    request<T>(method: "post" | "subscribe" | "unsubscribe", payload: unknown, signal?: AbortSignal): Promise<T>;
+    /** Normalizes an object and then converts it to a string. */
+    static requestToId(value: unknown): string;
+}
+export {};
+//# sourceMappingURL=_postRequest.d.ts.map

package/script/transport/websocket/_postRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_postRequest.d.ts","sourceRoot":"","sources":["../../../src/transport/websocket/_postRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAe3E,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpB,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE/B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CAChC;AAED,mDAAmD;AACnD,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIrD;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAClD,SAAS,CAAC,OAAO,SAAK;IACtB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,CAAM;IAExC;;;;;;OAMG;gBACS,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA0GnG;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5D,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA6DlH,6DAA6D;IAC7D,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;CAK3C"}