@nktkas/hyperliquid 0.30.3 → 0.31.0

package/script/src/api/subscription/client.js

@@ -60,23 +60,132 @@ class SubscriptionClient {
     constructor(config) {
         this.config_ = config;
     }
-    /** @see {@link activeAssetCtx} */
+    /**
+     * Subscribe to context updates for a specific perpetual asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.activeAssetCtx({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     activeAssetCtx(params, listener) {
         return (0, activeAssetCtx_js_1.activeAssetCtx)(this.config_, params, listener);
     }
-    /** @see {@link activeAssetData} */
+    /**
+     * Subscribe to trading data updates for a specific asset and user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.activeAssetData({ coin: "ETH", user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     activeAssetData(params, listener) {
         return (0, activeAssetData_js_1.activeAssetData)(this.config_, params, listener);
     }
-    /** @see {@link activeSpotAssetCtx} */
+    /**
+     * Subscribe to context updates for a specific spot asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.activeSpotAssetCtx({ coin: "@1" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     activeSpotAssetCtx(params, listener) {
         return (0, activeSpotAssetCtx_js_1.activeSpotAssetCtx)(this.config_, params, listener);
     }
-    /** @see {@link allDexsAssetCtxs} */
+    /**
+     * Subscribe to asset contexts for all DEXs.
+     *
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.allDexsAssetCtxs((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     allDexsAssetCtxs(listener) {
         return (0, allDexsAssetCtxs_js_1.allDexsAssetCtxs)(this.config_, listener);
     }
-    /** @see {@link allDexsClearinghouseState} */
+    /**
+     * Subscribe to clearinghouse states for all DEXs for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.allDexsClearinghouseState({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     allDexsClearinghouseState(params, listener) {
         return (0, allDexsClearinghouseState_js_1.allDexsClearinghouseState)(this.config_, params, listener);
     }
@@ -90,91 +199,573 @@ class SubscriptionClient {
         const listener = typeof paramsOrListener === "function" ? paramsOrListener : maybeListener;
         return (0, assetCtxs_js_1.assetCtxs)(this.config_, params, listener);
     }
-    /** @see {@link bbo} */
+    /**
+     * Subscribe to best bid and offer updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.bbo({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     bbo(params, listener) {
         return (0, bbo_js_1.bbo)(this.config_, params, listener);
     }
-    /** @see {@link candle} */
+    /**
+     * Subscribe to candlestick data updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.candle({ coin: "ETH", interval: "1h" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     candle(params, listener) {
         return (0, candle_js_1.candle)(this.config_, params, listener);
     }
-    /** @see {@link clearinghouseState} */
+    /**
+     * Subscribe to clearinghouse state updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.clearinghouseState({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     clearinghouseState(params, listener) {
         return (0, clearinghouseState_js_1.clearinghouseState)(this.config_, params, listener);
     }
-    /** @see {@link explorerBlock} */
+    /**
+     * Subscribe to explorer block updates.
+     *
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport({ url: "wss://rpc.hyperliquid.xyz/ws" }); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.explorerBlock((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     explorerBlock(listener) {
         return (0, explorerBlock_js_1.explorerBlock)(this.config_, listener);
     }
-    /** @see {@link explorerTxs} */
+    /**
+     * Subscribe to explorer transaction updates.
+     *
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport({ url: "wss://rpc.hyperliquid.xyz/ws" }); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.explorerTxs((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     explorerTxs(listener) {
         return (0, explorerTxs_js_1.explorerTxs)(this.config_, listener);
     }
-    /** @see {@link l2Book} */
+    /**
+     * Subscribe to L2 order book updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.l2Book({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     l2Book(params, listener) {
         return (0, l2Book_js_1.l2Book)(this.config_, params, listener);
     }
-    /** @see {@link notification} */
+    /**
+     * Subscribe to notification updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.notification({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     notification(params, listener) {
         return (0, notification_js_1.notification)(this.config_, params, listener);
     }
-    /** @see {@link openOrders} */
+    /**
+     * Subscribe to open orders updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.openOrders({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     openOrders(params, listener) {
         return (0, openOrders_js_1.openOrders)(this.config_, params, listener);
     }
-    /** @see {@link orderUpdates} */
+    /**
+     * Subscribe to order status updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.orderUpdates({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     orderUpdates(params, listener) {
         return (0, orderUpdates_js_1.orderUpdates)(this.config_, params, listener);
     }
-    /** @see {@link spotAssetCtxs} */
+    /**
+     * Subscribe to context updates for all spot assets.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.spotAssetCtxs((data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     spotAssetCtxs(listener) {
         return (0, spotAssetCtxs_js_1.spotAssetCtxs)(this.config_, listener);
     }
-    /** @see {@link spotState} */
+    /**
+     * Subscribe to spot state updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.spotState({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     spotState(params, listener) {
         return (0, spotState_js_1.spotState)(this.config_, params, listener);
     }
-    /** @see {@link trades} */
+    /**
+     * Subscribe to real-time trade updates for a specific asset.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.trades({ coin: "ETH" }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     trades(params, listener) {
         return (0, trades_js_1.trades)(this.config_, params, listener);
     }
-    /** @see {@link twapStates} */
+    /**
+     * Subscribe to TWAP states updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.twapStates({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     twapStates(params, listener) {
         return (0, twapStates_js_1.twapStates)(this.config_, params, listener);
     }
-    /** @see {@link userEvents} */
+    /**
+     * Subscribe to non-order events for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userEvents({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userEvents(params, listener) {
         return (0, userEvents_js_1.userEvents)(this.config_, params, listener);
     }
-    /** @see {@link userFills} */
+    /**
+     * Subscribe to trade fill updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userFills({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userFills(params, listener) {
         return (0, userFills_js_1.userFills)(this.config_, params, listener);
     }
-    /** @see {@link userFundings} */
+    /**
+     * Subscribe to funding payment updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userFundings({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userFundings(params, listener) {
         return (0, userFundings_js_1.userFundings)(this.config_, params, listener);
     }
-    /** @see {@link userHistoricalOrders} */
+    /**
+     * Subscribe to historical order updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userHistoricalOrders({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userHistoricalOrders(params, listener) {
         return (0, userHistoricalOrders_js_1.userHistoricalOrders)(this.config_, params, listener);
     }
-    /** @see {@link userNonFundingLedgerUpdates} */
+    /**
+     * Subscribe to non-funding ledger updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userNonFundingLedgerUpdates({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userNonFundingLedgerUpdates(params, listener) {
         return (0, userNonFundingLedgerUpdates_js_1.userNonFundingLedgerUpdates)(this.config_, params, listener);
     }
-    /** @see {@link userTwapHistory} */
+    /**
+     * Subscribe to TWAP order history updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userTwapHistory({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userTwapHistory(params, listener) {
         return (0, userTwapHistory_js_1.userTwapHistory)(this.config_, params, listener);
     }
-    /** @see {@link userTwapSliceFills} */
+    /**
+     * Subscribe to TWAP execution updates for a specific user.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.userTwapSliceFills({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     userTwapSliceFills(params, listener) {
         return (0, userTwapSliceFills_js_1.userTwapSliceFills)(this.config_, params, listener);
     }
-    /** @see {@link webData2} */
+    /**
+     * Subscribe to comprehensive user and market data updates.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.webData2({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     webData2(params, listener) {
         return (0, webData2_js_1.webData2)(this.config_, params, listener);
     }
-    /** @see {@link webData3} */
+    /**
+     * Subscribe to comprehensive user and market data updates.
+     *
+     * @param params - Parameters specific to the API subscription.
+     * @param listener - A callback function to be called when the event is received.
+     *
+     * @returns A request-promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
+     * const client = new hl.SubscriptionClient({ transport });
+     *
+     * const sub = await client.webData3({ user: "0x..." }, (data) => console.log(data));
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     */
     webData3(params, listener) {
         return (0, webData3_js_1.webData3)(this.config_, params, listener);
     }