@nktkas/hyperliquid 0.25.6 → 0.25.8

package/src/src/api/exchange/withdraw3.ts

@@ -6,7 +6,6 @@ import {
   type ExtractRequestAction,
   type ExtractRequestOptions,
   getSignatureChainId,
-  globalNonceManager,
   type MultiSignRequestConfig,
   Signature,
 } from "./_base/mod.js";
@@ -123,16 +122,20 @@ export async function withdraw3(
   params: DeepImmutable<Withdraw3Parameters>,
   opts?: Withdraw3Options,
 ): Promise<SuccessResponse> {
-  const action = parser(Withdraw3Request.entries.action)({
-    type: "withdraw3",
-    hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
-    signatureChainId: await getSignatureChainId(config),
-    time: globalNonceManager.getNonce(),
-    ...params,
+  const request = parser(Withdraw3Request)({
+    action: {
+      type: "withdraw3",
+      hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
+      signatureChainId: await getSignatureChainId(config),
+      time: 0, // Placeholder; actual nonce generated in `executeUserSignedAction` to prevent race conditions
+      ...params,
+    },
+    nonce: 0, // Placeholder; actual nonce generated in `executeUserSignedAction` to prevent race conditions
+    signature: { // Placeholder; actual signature generated in `executeUserSignedAction`
+      r: "0x0000000000000000000000000000000000000000000000000000000000000000",
+      s: "0x0000000000000000000000000000000000000000000000000000000000000000",
+      v: 27,
+    },
   });
-  return await executeUserSignedAction(
-    config,
-    { action, types: Withdraw3Types },
-    opts?.signal,
-  );
+  return await executeUserSignedAction(config, request, Withdraw3Types, opts?.signal);
 }

package/src/src/api/exchange/~client.ts

@@ -2,7 +2,7 @@ import type { MaybePromise, OmitFirst, OverloadedParameters } from "../_base.js"
 import type { ExchangeRequestConfig, MultiSignRequestConfig } from "./_base/mod.js";
 import type { IRequestTransport } from "../../transport/base.js";
 import type { AbstractWallet } from "../../signing/mod.js";
-import { PrivateKeyEIP712Signer } from "../../utils/_minimalEIP712Signer.js";
+import { PrivateKeyEIP712Signer } from "../../utils/_eip712.js";
 
 import { agentEnableDexAbstraction } from "./agentEnableDexAbstraction.js";
 import { approveAgent } from "./approveAgent.js";
@@ -19,6 +19,7 @@ import { cSignerAction } from "./cSignerAction.js";
 import { cValidatorAction } from "./cValidatorAction.js";
 import { cWithdraw } from "./cWithdraw.js";
 import { evmUserModify } from "./evmUserModify.js";
+import { linkStakingUser } from "./linkStakingUser.js";
 import { modify } from "./modify.js";
 import { multiSig } from "./multiSig.js";
 import { order } from "./order.js";
@@ -64,6 +65,7 @@ export type { CSignerActionOptions, CSignerActionParameters } from "./cSignerAct
 export type { CValidatorActionOptions, CValidatorActionParameters } from "./cValidatorAction.js";
 export type { CWithdrawOptions, CWithdrawParameters } from "./cWithdraw.js";
 export type { EvmUserModifyOptions, EvmUserModifyParameters } from "./evmUserModify.js";
+export type { LinkStakingUserOptions, LinkStakingUserParameters } from "./linkStakingUser.js";
 export type { ModifyOptions, ModifyParameters } from "./modify.js";
 export type { MultiSigOptions, MultiSigParameters } from "./multiSig.js";
 export type { OrderOptions, OrderParameters } from "./order.js";
@@ -118,7 +120,6 @@ export class ExchangeClient<
   signatureChainId?: string | (() => MaybePromise<string>);
   defaultVaultAddress?: string;
   defaultExpiresAfter?: number | (() => MaybePromise<number>);
-  sequentialRequests?: boolean;
 
   /**
    * Initialises a new instance.
@@ -181,7 +182,6 @@ export class ExchangeClient<
     this.defaultVaultAddress = args.defaultVaultAddress;
     this.defaultExpiresAfter = args.defaultExpiresAfter;
     this.signatureChainId = args.signatureChainId;
-    this.sequentialRequests = args.sequentialRequests;
   }
 
   /**
@@ -609,7 +609,7 @@ export class ExchangeClient<
    * Configure block type for EVM transactions.
    * @param params - Parameters specific to the API request.
    * @param opts - Request execution options.
-   * @returns Response for creating a sub-account.
+   * @returns Successful response without specific data.
    *
    * @throws {ApiRequestError} When the API returns an unsuccessful response.
    * @throws {TransportError} When the transport layer throws an error.
@@ -630,6 +630,31 @@ export class ExchangeClient<
     return evmUserModify(this, ...args);
   }
 
+  /**
+   * Link staking and trading accounts for fee discount attribution.
+   * @param params - Parameters specific to the API request.
+   * @param opts - Request execution options.
+   * @returns Successful response without specific data.
+   *
+   * @throws {ApiRequestError} When the API returns an unsuccessful response.
+   * @throws {TransportError} When the transport layer throws an error.
+   *
+   * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#staking-linking
+   * @example
+   * ```ts
+   * import * as hl from "@nktkas/hyperliquid";
+   *
+   * const pk = "0x..."; // viem, ethers or private key
+   * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+   *
+   * const client = new hl.ExchangeClient({ transport, wallet: pk });
+   * await client.linkStakingUser({ user: "0x...", isFinalize: false });
+   * ```
+   */
+  linkStakingUser(...args: OmitFirst<OverloadedParameters<typeof linkStakingUser>>) {
+    return linkStakingUser(this, ...args);
+  }
+
   /**
    * Modify an order.
    * @param params - Parameters specific to the API request.
@@ -1492,7 +1517,7 @@ export class MultiSignClient<
   /**
    * @note Is the first wallet from {@linkcode signers}. Changing the property also changes the first element in the {@linkcode signers} array.
    */
-  declare readonly wallet: S[0];
+  declare wallet: S[0];
 
   /**
    * Initialises a new multi-signature client instance.

package/src/src/api/exchange/~mod.ts

@@ -55,6 +55,7 @@ export * from "./cSignerAction.js";
 export * from "./cValidatorAction.js";
 export * from "./cWithdraw.js";
 export * from "./evmUserModify.js";
+export * from "./linkStakingUser.js";
 export * from "./modify.js";
 export * from "./multiSig.js";
 export * from "./order.js";

package/src/src/api/info/meta.ts

@@ -73,6 +73,13 @@ export const MetaResponse = /* @__PURE__ */ (() => {
                 v.optional(v.literal(true)),
                 v.description("Indicates if the universe is delisted."),
               ),
+              /** Trading margin mode constraint. */
+              marginMode: v.pipe(
+                v.optional(
+                  v.union([v.literal("strictIsolated"), v.literal("noCross")]),
+                ),
+                v.description("Trading margin mode constraint."),
+              ),
             }),
             v.description("Trading universe parameters for perpetual asset."),
           ),

package/src/src/api/info/perpDexs.ts

@@ -63,6 +63,16 @@ export const PerpDexsResponse = /* @__PURE__ */ (() => {
               v.array(v.tuple([v.string(), v.string()])),
               v.description("Mapping of asset names to their streaming open interest caps."),
             ),
+            /** List of delegated function names and their authorized executor addresses. */
+            subDeployers: v.pipe(
+              v.array(
+                v.tuple([
+                  v.string(),
+                  v.array(Address),
+                ]),
+              ),
+              v.description("List of delegated function names and their authorized executor addresses."),
+            ),
           }),
           v.description(" Perpetual dex metadata."),
         ),

package/src/src/api/info/spotClearinghouseState.ts

@@ -2,6 +2,8 @@ import * as v from "valibot";
 import { Address, type DeepImmutable, parser, UnsignedDecimal, UnsignedInteger } from "../_base.js";
 import type { InfoRequestConfig } from "./_types.js";
 
+import { BalanceSchema } from "../_common_schemas.js";
+
 // -------------------- Schemas --------------------
 
 /**
@@ -41,39 +43,7 @@ export const SpotClearinghouseStateResponse = /* @__PURE__ */ (() => {
     v.object({
       /** Balance for each token. */
       balances: v.pipe(
-        v.array(
-          /** Balance for a specific spot token. */
-          v.pipe(
-            v.object({
-              /** Asset symbol. */
-              coin: v.pipe(
-                v.string(),
-                v.description("Asset symbol."),
-              ),
-              /** Unique identifier for the token. */
-              token: v.pipe(
-                UnsignedInteger,
-                v.description("Unique identifier for the token."),
-              ),
-              /** Total balance. */
-              total: v.pipe(
-                UnsignedDecimal,
-                v.description("Total balance."),
-              ),
-              /** Amount on hold. */
-              hold: v.pipe(
-                UnsignedDecimal,
-                v.description("Amount on hold."),
-              ),
-              /** Entry notional value. */
-              entryNtl: v.pipe(
-                UnsignedDecimal,
-                v.description("Entry notional value."),
-              ),
-            }),
-            v.description("Balance for a specific spot token."),
-          ),
-        ),
+        v.array(BalanceSchema),
         v.description("Balance for each token."),
       ),
       /** Escrowed balances. */

package/src/src/api/info/userFees.ts

@@ -225,7 +225,52 @@ export const UserFeesResponse = /* @__PURE__ */ (() => {
         v.nullable(v.unknown()),
         v.description("Timestamp when next trial becomes available."),
       ),
-      stakingLink: v.nullable(v.unknown()),
+      /**
+       * Permanent link between staking and trading accounts.
+       * Staking user gains full control of trading account funds.
+       * Staking user forfeits own fee discounts.
+       */
+      stakingLink: v.pipe(
+        v.nullable(
+          v.object({
+            /**
+             * Linked account address:
+             * - When queried by staking account: contains trading account address.
+             * - When queried by trading account: contains staking account address.
+             */
+            stakingUser: v.pipe(
+              Address,
+              v.description(
+                "Linked account address:" +
+                  "\n- When queried by staking account: contains trading account address." +
+                  "\n- When queried by trading account: contains staking account address.",
+              ),
+            ),
+            /**
+             * Link status:
+             * - `requested` = link initiated by trading user, awaiting staking user confirmation.
+             * - `stakingUser` = response queried by staking account.
+             * - `tradingUser` = response queried by trading account.
+             */
+            type: v.pipe(
+              v.union([
+                v.literal("requested"),
+                v.literal("stakingUser"),
+                v.literal("tradingUser"),
+              ]),
+              v.description(
+                "Link status:" +
+                  "\n- `requested` = link initiated by trading user, awaiting staking user confirmation" +
+                  "\n- `stakingUser` = response queried by staking account" +
+                  "\n- `tradingUser` = response queried by trading account",
+              ),
+            ),
+          }),
+        ),
+        v.description(
+          "Permanent link between staking and trading accounts. Staking user gains full control of trading account funds. Staking user forfeits own fee discounts.",
+        ),
+      ),
       /** Active staking discount details. */
       activeStakingDiscount: v.pipe(
         v.object({

package/src/src/api/info/webData2.ts

@@ -1,12 +1,8 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, parser, UnsignedDecimal, UnsignedInteger } from "../_base.js";
+import { Address, type DeepImmutable, parser } from "../_base.js";
 import type { InfoRequestConfig } from "./_types.js";
 
-import { DetailedOrderSchema, TwapStateSchema } from "../_common_schemas.js";
-import { MetaAndAssetCtxsResponse } from "./metaAndAssetCtxs.js";
-import { ClearinghouseStateResponse } from "./clearinghouseState.js";
-import { SpotClearinghouseStateResponse } from "./spotClearinghouseState.js";
-import { SpotMetaAndAssetCtxsResponse } from "./spotMetaAndAssetCtxs.js";
+import { WebData2Event } from "../subscription/webData2.js";
 
 // -------------------- Schemas --------------------
 
@@ -39,104 +35,7 @@ export type WebData2Request = v.InferOutput<typeof WebData2Request>;
  */
 export const WebData2Response = /* @__PURE__ */ (() => {
   return v.pipe(
-    v.object({
-      /** Account summary for perpetual trading. */
-      clearinghouseState: ClearinghouseStateResponse,
-      /** Array of leading vaults. */
-      leadingVaults: v.pipe(
-        v.array(
-          /** Vault that a user is leading. */
-          v.pipe(
-            v.object({
-              /** Address of the vault. */
-              address: v.pipe(
-                Address,
-                v.description("Address of the vault."),
-              ),
-              /** Name of the vault. */
-              name: v.pipe(
-                v.string(),
-                v.description("Name of the vault."),
-              ),
-            }),
-            v.description("Vault that a user is leading."),
-          ),
-        ),
-        v.description("Array of leading vaults."),
-      ),
-      /** Total equity in vaults. */
-      totalVaultEquity: v.pipe(
-        UnsignedDecimal,
-        v.description("Total equity in vaults."),
-      ),
-      /** Array of user open orders with frontend information. */
-      openOrders: v.pipe(
-        v.array(DetailedOrderSchema),
-        v.description("User open orders with frontend information."),
-      ),
-      /** Agent address if one exists. */
-      agentAddress: v.pipe(
-        v.nullable(Address),
-        v.description("Agent address if one exists."),
-      ),
-      /** Timestamp until which the agent is valid. */
-      agentValidUntil: v.pipe(
-        v.nullable(UnsignedInteger),
-        v.description("Timestamp until which the agent is valid."),
-      ),
-      /** Cumulative ledger value. */
-      cumLedger: v.pipe(
-        UnsignedDecimal,
-        v.description("Cumulative ledger value."),
-      ),
-      /** Metadata for perpetual assets. */
-      meta: MetaAndAssetCtxsResponse.items[0],
-      /** Context for each perpetual asset. */
-      assetCtxs: MetaAndAssetCtxsResponse.items[1],
-      /** Server timestamp (in ms since epoch). */
-      serverTime: v.pipe(
-        UnsignedInteger,
-        v.description("Server timestamp (in ms since epoch)."),
-      ),
-      /** Whether this account is a vault. */
-      isVault: v.pipe(
-        v.boolean(),
-        v.description("Whether this account is a vault."),
-      ),
-      /** User address. */
-      user: v.pipe(
-        Address,
-        v.description("User address."),
-      ),
-      /** Array of TWAP states. */
-      twapStates: v.pipe(
-        v.array(
-          /** TWAP ID and state. */
-          v.pipe(
-            v.tuple([
-              UnsignedInteger,
-              TwapStateSchema,
-            ]),
-            v.description("TWAP ID and state."),
-          ),
-        ),
-        v.description("Array of TWAP states."),
-      ),
-      /** Account summary for spot trading. */
-      spotState: SpotClearinghouseStateResponse,
-      /** Context for each spot asset. */
-      spotAssetCtxs: SpotMetaAndAssetCtxsResponse.items[1],
-      /** Whether the user has opted out of spot dusting. */
-      optOutOfSpotDusting: v.pipe(
-        v.optional(v.literal(true)),
-        v.description("Whether the user has opted out of spot dusting."),
-      ),
-      /** Assets currently at their open interest cap. */
-      perpsAtOpenInterestCap: v.pipe(
-        v.optional(v.array(v.string())),
-        v.description("Assets currently at their open interest cap."),
-      ),
-    }),
+    WebData2Event,
     v.description("Comprehensive user and market data."),
   );
 })();

package/src/src/api/subscription/spotState.ts

@@ -0,0 +1,96 @@
+import * as v from "valibot";
+import { Address, type DeepImmutable, parser } from "../_base.js";
+import type { SubscriptionRequestConfig } from "./_types.js";
+import type { Subscription } from "../../transport/base.js";
+
+import { BalanceSchema } from "../_common_schemas.js";
+
+// -------------------- Schemas --------------------
+
+/** Subscription to spot state events for a specific user. */
+export const SpotStateRequest = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** Type of subscription. */
+      type: v.pipe(
+        v.literal("spotState"),
+        v.description("Type of subscription."),
+      ),
+      /** User address. */
+      user: v.pipe(
+        Address,
+        v.description("User address."),
+      ),
+    }),
+    v.description("Subscription to spot state events for a specific user."),
+  );
+})();
+export type SpotStateRequest = v.InferOutput<typeof SpotStateRequest>;
+
+/** Event of user spot state. */
+export const SpotStateEvent = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** User address. */
+      user: v.pipe(
+        Address,
+        v.description("User address."),
+      ),
+      /** Spot state of the user. */
+      spotState: v.pipe(
+        v.object({
+          /** Balance for each token. */
+          balances: v.pipe(
+            v.array(BalanceSchema),
+            v.description("Balance for each token."),
+          ),
+        }),
+        v.description("Spot state of the user."),
+      ),
+    }),
+    v.description("Event of user spot state."),
+  );
+})();
+export type SpotStateEvent = v.InferOutput<typeof SpotStateEvent>;
+
+// -------------------- Function --------------------
+
+/** Request parameters for the {@linkcode spotState} function. */
+export type SpotStateParameters = Omit<v.InferInput<typeof SpotStateRequest>, "type">;
+
+/**
+ * Subscribe to spot state updates for a specific user.
+ * @param config - General configuration for Subscription API subscriptions.
+ * @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 Subscription} object to manage the subscription lifecycle.
+ *
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+ * @example
+ * ```ts
+ * import { WebSocketTransport } from "@nktkas/hyperliquid";
+ * import { spotState } from "@nktkas/hyperliquid/api/subscription";
+ *
+ * const transport = new WebSocketTransport();
+ *
+ * const sub = await spotState(
+ *   { transport },
+ *   { user: "0x..." },
+ *   (data) => console.log(data),
+ * );
+ * ```
+ */
+export function spotState(
+  config: SubscriptionRequestConfig,
+  params: DeepImmutable<SpotStateParameters>,
+  listener: (data: SpotStateEvent) => void,
+): Promise<Subscription> {
+  const payload = parser(SpotStateRequest)({ type: "spotState", user: params.user });
+  return config.transport.subscribe<SpotStateEvent>(payload.type, payload, (e) => {
+    if (e.detail.user === payload.user) {
+      listener(e.detail);
+    }
+  });
+}

package/src/src/api/subscription/webData2.ts

@@ -118,7 +118,7 @@ export const WebData2Event = /* @__PURE__ */ (() => {
         v.description("Array of TWAP states."),
       ),
       /** Account summary for spot trading. */
-      spotState: SpotClearinghouseStateResponse,
+      spotState: v.optional(SpotClearinghouseStateResponse),
       /** Context for each spot asset. */
       spotAssetCtxs: SpotMetaAndAssetCtxsResponse.items[1],
       /** Whether the user has opted out of spot dusting. */

package/src/src/api/subscription/webData3.ts

@@ -0,0 +1,179 @@
+import * as v from "valibot";
+import { Address, type DeepImmutable, parser, UnsignedDecimal, UnsignedInteger } from "../_base.js";
+import type { SubscriptionRequestConfig } from "./_types.js";
+import type { Subscription } from "../../transport/base.js";
+
+import { DetailedOrderSchema } from "../_common_schemas.js";
+import { MetaAndAssetCtxsResponse } from "../info/metaAndAssetCtxs.js";
+import { ClearinghouseStateResponse } from "../info/clearinghouseState.js";
+
+// -------------------- Schemas --------------------
+
+/** Subscription to comprehensive user and market data events. */
+export const WebData3Request = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** Type of subscription. */
+      type: v.pipe(
+        v.literal("webData3"),
+        v.description("Type of subscription."),
+      ),
+      /** User address. */
+      user: v.pipe(
+        Address,
+        v.description("User address."),
+      ),
+    }),
+    v.description("Subscription to comprehensive user and market data events."),
+  );
+})();
+export type WebData3Request = v.InferOutput<typeof WebData3Request>;
+
+/** Event of comprehensive user and market data. */
+export const WebData3Event = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** User state information. */
+      userState: v.pipe(
+        v.object({
+          /** Agent address if one exists. */
+          agentAddress: v.pipe(
+            v.nullable(Address),
+            v.description("Agent address if one exists."),
+          ),
+          /** Timestamp until which the agent is valid. */
+          agentValidUntil: v.pipe(
+            v.nullable(UnsignedInteger),
+            v.description("Timestamp until which the agent is valid."),
+          ),
+          /** Cumulative ledger value. */
+          cumLedger: v.pipe(
+            UnsignedDecimal,
+            v.description("Cumulative ledger value."),
+          ),
+          /** Server timestamp (in ms since epoch). */
+          serverTime: v.pipe(
+            UnsignedInteger,
+            v.description("Server timestamp (in ms since epoch)."),
+          ),
+          /** Whether this account is a vault. */
+          isVault: v.pipe(
+            v.boolean(),
+            v.description("Whether this account is a vault."),
+          ),
+          /** User address. */
+          user: v.pipe(
+            Address,
+            v.description("User address."),
+          ),
+          /** Whether the user has opted out of spot dusting. */
+          optOutOfSpotDusting: v.pipe(
+            v.optional(v.literal(true)),
+            v.description("Whether the user has opted out of spot dusting."),
+          ),
+          /** Whether DEX abstraction is enabled. */
+          dexAbstractionEnabled: v.pipe(
+            v.optional(v.boolean()),
+            v.description("Whether DEX abstraction is enabled."),
+          ),
+        }),
+        v.description("User state information."),
+      ),
+      /** Array of perpetual DEX states. */
+      perpDexStates: v.pipe(
+        v.array(
+          v.object({
+            /** Account summary for perpetual trading. */
+            clearinghouseState: ClearinghouseStateResponse,
+            /** Total equity in vaults. */
+            totalVaultEquity: v.pipe(
+              UnsignedDecimal,
+              v.description("Total equity in vaults."),
+            ),
+            /** Array of user open orders with frontend information. */
+            openOrders: v.pipe(
+              v.optional(v.array(DetailedOrderSchema)),
+              v.description("User open orders with frontend information."),
+            ),
+            /** Context for each perpetual asset. */
+            assetCtxs: MetaAndAssetCtxsResponse.items[1],
+            /** Assets currently at their open interest cap. */
+            perpsAtOpenInterestCap: v.pipe(
+              v.optional(v.array(v.string())),
+              v.description("Assets currently at their open interest cap."),
+            ),
+            /** Array of leading vaults. */
+            leadingVaults: v.pipe(
+              v.optional(
+                v.array(
+                  /** Vault that a user is leading. */
+                  v.pipe(
+                    v.object({
+                      /** Address of the vault. */
+                      address: v.pipe(
+                        Address,
+                        v.description("Address of the vault."),
+                      ),
+                      /** Name of the vault. */
+                      name: v.pipe(
+                        v.string(),
+                        v.description("Name of the vault."),
+                      ),
+                    }),
+                    v.description("Vault that a user is leading."),
+                  ),
+                ),
+              ),
+              v.description("Array of leading vaults."),
+            ),
+          }),
+        ),
+        v.description("Array of perpetual DEX states."),
+      ),
+    }),
+    v.description("Comprehensive user and market data."),
+  );
+})();
+export type WebData3Event = v.InferOutput<typeof WebData3Event>;
+
+// -------------------- Function --------------------
+
+/** Request parameters for the {@linkcode webData3} function. */
+export type WebData3Parameters = Omit<v.InferInput<typeof WebData3Request>, "type">;
+
+/**
+ * Subscribe to comprehensive user and market data updates.
+ * @param config - General configuration for Subscription API subscriptions.
+ * @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 Subscription} object to manage the subscription lifecycle.
+ *
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+ * @example
+ * ```ts
+ * import { WebSocketTransport } from "@nktkas/hyperliquid";
+ * import { webData3 } from "@nktkas/hyperliquid/api/subscription";
+ *
+ * const transport = new WebSocketTransport();
+ *
+ * const sub = await webData3(
+ *   { transport },
+ *   { user: "0x..." },
+ *   (data) => console.log(data),
+ * );
+ * ```
+ */
+export function webData3(
+  config: SubscriptionRequestConfig,
+  params: DeepImmutable<WebData3Parameters>,
+  listener: (data: WebData3Event) => void,
+): Promise<Subscription> {
+  const payload = parser(WebData3Request)({ type: "webData3", ...params });
+  return config.transport.subscribe<WebData3Event>(payload.type, payload, (e) => {
+    if (e.detail.userState.user === payload.user) {
+      listener(e.detail);
+    }
+  });
+}