@hfunlabs/hyperliquid 0.27.1-hfunlabs.2 → 0.27.1-hfunlabs.3

package/src/src/api/subscription/allDexsClearinghouseState.ts

@@ -0,0 +1,109 @@
+import * as v from "valibot";
+
+// ============================================================
+// API Schemas
+// ============================================================
+
+import { Address } from "../_base.js";
+import { ClearinghouseStateResponse } from "../info/clearinghouseState.js";
+
+/** Subscription to clearinghouse state events across all DEXes for a specific user. */
+export const AllDexsClearinghouseStateRequest = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** Type of subscription. */
+      type: v.pipe(
+        v.literal("allDexsClearinghouseState"),
+        v.description("Type of subscription."),
+      ),
+      /** User address. */
+      user: v.pipe(
+        Address,
+        v.description("User address."),
+      ),
+    }),
+    v.description("Subscription to clearinghouse state events across all DEXes for a specific user."),
+  );
+})();
+export type AllDexsClearinghouseStateRequest = v.InferOutput<typeof AllDexsClearinghouseStateRequest>;
+
+/** Event of clearinghouse state across all DEXes for a specific user. */
+export const AllDexsClearinghouseStateEvent = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** User address. */
+      user: v.pipe(
+        Address,
+        v.description("User address."),
+      ),
+      /** Array of tuples containing DEX name and clearinghouse state. Empty string represents main DEX. */
+      clearinghouseStates: v.pipe(
+        v.array(
+          v.tuple([
+            /** DEX name (empty string for main dex). */
+            v.pipe(
+              v.string(),
+              v.description("DEX name (empty string for main dex)."),
+            ),
+            /** Account summary for perpetual trading. */
+            ClearinghouseStateResponse,
+          ]),
+        ),
+        v.description("Array of tuples containing DEX name and clearinghouse state. Empty string represents main DEX."),
+      ),
+    }),
+    v.description("Event of clearinghouse state across all DEXes for a specific user."),
+  );
+})();
+export type AllDexsClearinghouseStateEvent = v.InferOutput<typeof AllDexsClearinghouseStateEvent>;
+
+// ============================================================
+// Execution Logic
+// ============================================================
+
+import { type DeepImmutable, parser } from "../_base.js";
+import type { SubscriptionRequestConfig } from "./_types.js";
+import type { Subscription } from "../../transport/base.js";
+
+/** Request parameters for the {@linkcode allDexsClearinghouseState} function. */
+export type AllDexsClearinghouseStateParameters = Omit<v.InferInput<typeof AllDexsClearinghouseStateRequest>, "type">;
+
+/**
+ * Subscribe to clearinghouse state updates across all DEXes 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 null
+ * @example
+ * ```ts
+ * import { WebSocketTransport } from "@nktkas/hyperliquid";
+ * import { allDexsClearinghouseState } from "@nktkas/hyperliquid/api/subscription";
+ *
+ * const transport = new WebSocketTransport();
+ *
+ * const sub = await allDexsClearinghouseState(
+ *   { transport },
+ *   { user: "0x..." },
+ *   (data) => console.log(data),
+ * );
+ * ```
+ */
+export function allDexsClearinghouseState(
+  config: SubscriptionRequestConfig,
+  params: DeepImmutable<AllDexsClearinghouseStateParameters>,
+  listener: (data: AllDexsClearinghouseStateEvent) => void,
+): Promise<Subscription> {
+  const payload = parser(AllDexsClearinghouseStateRequest)({
+    type: "allDexsClearinghouseState",
+    ...params,
+  });
+  return config.transport.subscribe<AllDexsClearinghouseStateEvent>(payload.type, payload, (e) => {
+    if (e.detail.user === payload.user) {
+      listener(e.detail);
+    }
+  });
+}

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

@@ -5,6 +5,7 @@ import type { SubscriptionRequestConfig } from "./_types.js";
 import { activeAssetCtx } from "./activeAssetCtx.js";
 import { activeAssetData } from "./activeAssetData.js";
 import { activeSpotAssetCtx } from "./activeSpotAssetCtx.js";
+import { allDexsClearinghouseState } from "./allDexsClearinghouseState.js";
 import { allMids } from "./allMids.js";
 import { assetCtxs } from "./assetCtxs.js";
 import { bbo } from "./bbo.js";
@@ -41,6 +42,10 @@ export type {
   ActiveSpotAssetCtxEvent as WsActiveSpotAssetCtxEvent,
   ActiveSpotAssetCtxParameters as WsActiveSpotAssetCtxParameters,
 } from "./activeSpotAssetCtx.js";
+export type {
+  AllDexsClearinghouseStateEvent as WsAllDexsClearinghouseStateEvent,
+  AllDexsClearinghouseStateParameters as WsAllDexsClearinghouseStateParameters,
+} from "./allDexsClearinghouseState.js";
 export type { AllMidsEvent as WsAllMidsEvent, AllMidsParameters as WsAllMidsParameters } from "./allMids.js";
 export type { AssetCtxsEvent as WsAssetCtxsEvent, AssetCtxsParameters as WsAssetCtxsParameters } from "./assetCtxs.js";
 export type { BboEvent as WsBboEvent, BboParameters as WsBboParameters } from "./bbo.js";
@@ -206,6 +211,31 @@ export class SubscriptionClient<
     return activeSpotAssetCtx(this, ...args);
   }
 
+  /**
+   * Subscribe to clearinghouse state updates across all DEXes 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 Subscription} object to manage the subscription lifecycle.
+   *
+   * @throws {TransportError} When the transport layer throws an error.
+   *
+   * @see null
+   * @example
+   * ```ts
+   * import * as hl from "@nktkas/hyperliquid";
+   *
+   * const transport = new hl.WebSocketTransport();
+   *
+   * const client = new hl.SubscriptionClient({ transport });
+   * const sub = await client.allDexsClearinghouseState({ user: "0x..." }, (data) => console.log(data));
+   * ```
+   */
+  allDexsClearinghouseState(
+    ...args: OmitFirst<OverloadedParameters<typeof allDexsClearinghouseState>>
+  ): ReturnType<typeof allDexsClearinghouseState> {
+    return allDexsClearinghouseState(this, ...args);
+  }
+
   /**
    * Subscribe to mid prices for all actively traded assets.
    * @param params - Parameters specific to the API subscription.

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

@@ -29,6 +29,7 @@ export type { SubscriptionRequestConfig } from "./_types.js";
 export * from "./activeAssetCtx.js";
 export * from "./activeAssetData.js";
 export * from "./activeSpotAssetCtx.js";
+export * from "./allDexsClearinghouseState.js";
 export * from "./allMids.js";
 export * from "./assetCtxs.js";
 export * from "./bbo.js";