@nktkas/hyperliquid 0.23.1 → 0.24.0

package/esm/src/transports/websocket/_websocket_async_request.js

@@ -17,30 +17,31 @@ export class WebSocketAsyncRequest {
         this.socket = socket;
         // Monitor responses and match the pending request
         hlEvents.addEventListener("subscriptionResponse", (event) => {
+            const detail = event.detail;
             // Use a stringified request as an id
-            const id = WebSocketAsyncRequest.requestToId(event.detail);
-            this.queue.findLast((item) => item.id === id)?.resolve(event.detail);
+            const id = WebSocketAsyncRequest.requestToId(detail);
+            this.queue.findLast((item) => item.id === id)?.resolve(detail);
         });
         hlEvents.addEventListener("post", (event) => {
-            const data = event.detail.response.type === "info"
-                ? event.detail.response.payload.data
-                : event.detail.response.payload;
-            this.queue.findLast((item) => item.id === event.detail.id)?.resolve(data);
+            const detail = event.detail;
+            const data = detail.response.type === "info" ? detail.response.payload.data : detail.response.payload;
+            this.queue.findLast((item) => item.id === detail.id)?.resolve(data);
         });
         hlEvents.addEventListener("pong", () => {
             this.queue.findLast((item) => item.id === "ping")?.resolve();
         });
         hlEvents.addEventListener("error", (event) => {
+            const detail = event.detail;
             try {
                 // Error event doesn't have an id, use original request to match
-                const request = event.detail.match(/{.*}/)?.[0];
+                const request = detail.match(/{.*}/)?.[0];
                 if (!request)
                     return;
                 const parsedRequest = JSON.parse(request);
                 // For `post` requests
                 if ("id" in parsedRequest && typeof parsedRequest.id === "number") {
                     this.queue.findLast((item) => item.id === parsedRequest.id)
-                        ?.reject(new WebSocketRequestError(`Server error: ${event.detail}`, { cause: event.detail }));
+                        ?.reject(new WebSocketRequestError(`Server error: ${detail}`, { cause: detail }));
                     return;
                 }
                 // For `subscribe` and `unsubscribe` requests
@@ -48,33 +49,33 @@ export class WebSocketAsyncRequest {
                     typeof parsedRequest.subscription === "object" && parsedRequest.subscription !== null) {
                     const id = WebSocketAsyncRequest.requestToId(parsedRequest);
                     this.queue.findLast((item) => item.id === id)
-                        ?.reject(new WebSocketRequestError(`Server error: ${event.detail}`, { cause: event.detail }));
+                        ?.reject(new WebSocketRequestError(`Server error: ${detail}`, { cause: detail }));
                     return;
                 }
                 // For `Already subscribed` and `Invalid subscription` requests
-                if (event.detail.startsWith("Already subscribed") || event.detail.startsWith("Invalid subscription")) {
+                if (detail.startsWith("Already subscribed") || detail.startsWith("Invalid subscription")) {
                     const id = WebSocketAsyncRequest.requestToId({
                         method: "subscribe",
                         subscription: parsedRequest,
                     });
                     this.queue.findLast((item) => item.id === id)
-                        ?.reject(new WebSocketRequestError(`Server error: ${event.detail}`, { cause: event.detail }));
+                        ?.reject(new WebSocketRequestError(`Server error: ${detail}`, { cause: detail }));
                     return;
                 }
                 // For `Already unsubscribed` requests
-                if (event.detail.startsWith("Already unsubscribed")) {
+                if (detail.startsWith("Already unsubscribed")) {
                     const id = WebSocketAsyncRequest.requestToId({
                         method: "unsubscribe",
                         subscription: parsedRequest,
                     });
                     this.queue.findLast((item) => item.id === id)
-                        ?.reject(new WebSocketRequestError(`Server error: ${event.detail}`, { cause: event.detail }));
+                        ?.reject(new WebSocketRequestError(`Server error: ${detail}`, { cause: detail }));
                     return;
                 }
                 // For unknown requests
                 const id = WebSocketAsyncRequest.requestToId(parsedRequest);
                 this.queue.findLast((item) => item.id === id)
-                    ?.reject(new WebSocketRequestError(`Server error: ${event.detail}`, { cause: event.detail }));
+                    ?.reject(new WebSocketRequestError(`Server error: ${detail}`, { cause: detail }));
             }
             catch {
                 // Ignore JSON parsing errors
@@ -126,7 +127,7 @@ export class WebSocketAsyncRequest {
     }
     /** Normalizes an object and then converts it to a string. */
     static requestToId(value) {
-        const lowerHex = containsUppercaseHex(value) ? deepLowerHex(value) : value;
+        const lowerHex = deepLowerHex(value);
         const sorted = deepSortKeys(lowerHex);
         return JSON.stringify(sorted); // Also removes undefined
     }
@@ -137,7 +138,7 @@ function deepLowerHex(obj) {
         return /^(0X[0-9a-fA-F]*|0x[0-9a-fA-F]*[A-F][0-9a-fA-F]*)$/.test(obj) ? obj.toLowerCase() : obj;
     }
     if (Array.isArray(obj)) {
-        return obj.map(deepLowerHex);
+        return obj.map((value) => deepLowerHex(value));
     }
     if (typeof obj === "object" && obj !== null) {
         const result = {};
@@ -149,11 +150,6 @@ function deepLowerHex(obj) {
     }
     return obj;
 }
-/** Check if an object contains uppercase hexadecimal strings. */
-function containsUppercaseHex(obj) {
-    const str = JSON.stringify(obj);
-    return /0X[0-9a-fA-F]*|0x[0-9a-fA-F]*[A-F][0-9a-fA-F]*/.test(str);
-}
 /** Deeply sort the keys of an object. */
 function deepSortKeys(obj) {
     if (typeof obj !== "object" || obj === null) {

package/esm/src/transports/websocket/websocket_transport.d.ts

@@ -96,12 +96,12 @@ export declare class WebSocketTransport implements IRequestTransport, ISubscript
      *
      * @param endpoint - The API endpoint to send the request to (`explorer` requests are not supported).
      * @param payload - The payload to send with the request.
-     * @param signal - An optional abort signal.
+     * @param signal - An {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal}. If this option is set, the request can be canceled by calling {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort | abort()} on the corresponding {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}.
      * @returns A promise that resolves with parsed JSON response body.
      *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
      */
-    request<T>(type: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<T>;
+    request<T>(type: "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.
@@ -116,13 +116,13 @@ export declare class WebSocketTransport implements IRequestTransport, ISubscript
     subscribe<T>(channel: string, payload: unknown, listener: (data: CustomEvent<T>) => void): Promise<Subscription>;
     /**
      * Waits until the WebSocket connection is ready.
-     * @param signal - An optional abort signal.
+     * @param signal - An {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal}. If this option is set, the promise can be canceled by calling {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort | abort()} on the corresponding {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}.
      * @returns A promise that resolves when the connection is ready.
      */
     ready(signal?: AbortSignal): Promise<void>;
     /**
      * Closes the WebSocket connection and waits until it is fully closed.
-     * @param signal - An optional abort signal.
+     * @param signal - An {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal}. If this option is set, the promise can be canceled by calling {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort | abort()} on the corresponding {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}.
      * @returns A promise that resolves when the connection is fully closed.
      */
     close(signal?: AbortSignal): Promise<void>;

package/esm/src/transports/websocket/websocket_transport.d.ts.map

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

package/esm/src/transports/websocket/websocket_transport.js

@@ -60,7 +60,7 @@ export class WebSocketTransport {
      *
      * @param endpoint - The API endpoint to send the request to (`explorer` requests are not supported).
      * @param payload - The payload to send with the request.
-     * @param signal - An optional abort signal.
+     * @param signal - An {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal}. If this option is set, the request can be canceled by calling {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort | abort()} on the corresponding {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}.
      * @returns A promise that resolves with parsed JSON response body.
      *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
@@ -79,7 +79,7 @@ export class WebSocketTransport {
         catch (error) {
             if (error instanceof WebSocketRequestError)
                 throw error; // Re-throw known errors
-            throw new WebSocketRequestError("Unknown error while making a WebSocket request. See the `cause` for more details.", { cause: error });
+            throw new WebSocketRequestError(`Unknown error while making a WebSocket request: ${error}`, { cause: error });
         }
     }
     /**
@@ -133,7 +133,7 @@ export class WebSocketTransport {
                     catch (error) {
                         if (error instanceof WebSocketRequestError)
                             throw error; // Re-throw known errors
-                        throw new WebSocketRequestError("Unknown error while unsubscribing from a WebSocket channel. See the `cause` for more details.", { cause: error });
+                        throw new WebSocketRequestError(`Unknown error while unsubscribing from a WebSocket channel: ${error}`, { cause: error });
                     }
                 };
                 // Add listener and cache unsubscribe function
@@ -151,12 +151,12 @@ export class WebSocketTransport {
         catch (error) {
             if (error instanceof WebSocketRequestError)
                 throw error; // Re-throw known errors
-            throw new WebSocketRequestError("Unknown error while subscribing to a WebSocket channel. See the `cause` for more details.", { cause: error });
+            throw new WebSocketRequestError(`Unknown error while subscribing to a WebSocket channel: ${error}`, { cause: error });
         }
     }
     /**
      * Waits until the WebSocket connection is ready.
-     * @param signal - An optional abort signal.
+     * @param signal - An {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal}. If this option is set, the promise can be canceled by calling {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort | abort()} on the corresponding {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}.
      * @returns A promise that resolves when the connection is ready.
      */
     ready(signal) {
@@ -182,7 +182,7 @@ export class WebSocketTransport {
     }
     /**
      * Closes the WebSocket connection and waits until it is fully closed.
-     * @param signal - An optional abort signal.
+     * @param signal - An {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal}. If this option is set, the promise can be canceled by calling {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort | abort()} on the corresponding {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/AbortController | AbortController}.
      * @returns A promise that resolves when the connection is fully closed.
      */
     close(signal) {