@hfunlabs/hyperliquid 0.29.1-hfunlabs.1 → 0.30.2-hfunlabs.2

package/src/src/api/subscription/_methods/explorerBlock.ts

@@ -6,7 +6,7 @@ import * as v from "valibot";
 
 import { Address, Hex, UnsignedInteger } from "../../_schemas.js";
 
-/** Subscription to explorer block events (RPC endpoint). */
+/** Subscription to explorer block events. */
 export const ExplorerBlockRequest = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -25,37 +25,34 @@ export type ExplorerBlockRequest = v.InferOutput<typeof ExplorerBlockRequest>;
 export const ExplorerBlockEvent = /* @__PURE__ */ (() => {
   return v.pipe(
     v.array(
-      /** Block details. */
-      v.pipe(
-        v.object({
-          /** Block creation timestamp. */
-          blockTime: v.pipe(
-            UnsignedInteger,
-            v.description("Block creation timestamp."),
-          ),
-          /** Block hash. */
-          hash: v.pipe(
-            v.pipe(Hex, v.length(66)),
-            v.description("Block hash."),
-          ),
-          /** Block height in chain. */
-          height: v.pipe(
-            UnsignedInteger,
-            v.description("Block height in chain."),
-          ),
-          /** Total transactions in block. */
-          numTxs: v.pipe(
-            UnsignedInteger,
-            v.description("Total transactions in block."),
-          ),
-          /** Block proposer address. */
-          proposer: v.pipe(
-            Address,
-            v.description("Block proposer address."),
-          ),
-        }),
-        v.description("The details of a block."),
-      ),
+      v.object({
+        /** Block creation timestamp. */
+        blockTime: v.pipe(
+          UnsignedInteger,
+          v.description("Block creation timestamp."),
+        ),
+        /** Block hash. */
+        hash: v.pipe(
+          Hex,
+          v.length(66),
+          v.description("Block hash."),
+        ),
+        /** Block height in chain. */
+        height: v.pipe(
+          UnsignedInteger,
+          v.description("Block height in chain."),
+        ),
+        /** Total transactions in block. */
+        numTxs: v.pipe(
+          UnsignedInteger,
+          v.description("Total transactions in block."),
+        ),
+        /** Block proposer address. */
+        proposer: v.pipe(
+          Address,
+          v.description("Block proposer address."),
+        ),
+      }),
     ),
     v.description("Event of array of block details."),
   );
@@ -67,7 +64,7 @@ export type ExplorerBlockEvent = v.InferOutput<typeof ExplorerBlockEvent>;
 // ============================================================
 
 import type { SubscriptionConfig } from "./_types.js";
-import type { WebSocketSubscription } from "../../../transport/websocket/mod.js";
+import type { ISubscription } from "../../../transport/mod.js";
 
 /**
  * Subscribe to explorer block updates.
@@ -75,7 +72,7 @@ import type { WebSocketSubscription } from "../../../transport/websocket/mod.js"
  * @param config - General configuration for Subscription API subscriptions.
  * @param listener - A callback function to be called when the event is received.
  *
- * @returns A request-promise that resolves with a {@link WebSocketSubscription} object to manage the subscription lifecycle.
+ * @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.
@@ -92,11 +89,13 @@ import type { WebSocketSubscription } from "../../../transport/websocket/mod.js"
  *   (data) => console.log(data),
  * );
  * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
  */
 export function explorerBlock(
   config: SubscriptionConfig,
   listener: (data: ExplorerBlockEvent) => void,
-): Promise<WebSocketSubscription> {
+): Promise<ISubscription> {
   const payload = v.parse(ExplorerBlockRequest, { type: "explorerBlock" });
   return config.transport.subscribe<ExplorerBlockEvent>("_explorerBlock", payload, (e) => { // Internal channel as it does not have its own channel
     listener(e.detail);

package/src/src/api/subscription/_methods/explorerTxs.ts

@@ -4,9 +4,9 @@ import * as v from "valibot";
 // API Schemas
 // ============================================================
 
-import { Address, Hex, UnsignedInteger } from "../../_schemas.js";
+import { ExplorerTransactionSchema } from "../../info/_methods/_base/commonSchemas.js";
 
-/** Subscription to explorer transaction events (RPC endpoint). */
+/** Subscription to explorer transaction events. */
 export const ExplorerTxsRequest = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -24,50 +24,7 @@ export type ExplorerTxsRequest = v.InferOutput<typeof ExplorerTxsRequest>;
 /** Event of array of transaction details. */
 export const ExplorerTxsEvent = /* @__PURE__ */ (() => {
   return v.pipe(
-    v.array(
-      /** Transaction details. */
-      v.pipe(
-        v.object({
-          /** Action performed in transaction. */
-          action: v.pipe(
-            v.looseObject({
-              /** Action type. */
-              type: v.pipe(
-                v.string(),
-                v.description("Action type."),
-              ),
-            }),
-            v.description("Action performed in transaction."),
-          ),
-          /** Block number where transaction was included. */
-          block: v.pipe(
-            UnsignedInteger,
-            v.description("Block number where transaction was included."),
-          ),
-          /** Error message if transaction failed. */
-          error: v.pipe(
-            v.nullable(v.string()),
-            v.description("Error message if transaction failed."),
-          ),
-          /** Transaction hash. */
-          hash: v.pipe(
-            v.pipe(Hex, v.length(66)),
-            v.description("Transaction hash."),
-          ),
-          /** Transaction creation timestamp. */
-          time: v.pipe(
-            UnsignedInteger,
-            v.description("Transaction creation timestamp."),
-          ),
-          /** Creator's address. */
-          user: v.pipe(
-            Address,
-            v.description("Creator's address."),
-          ),
-        }),
-        v.description("Transaction details."),
-      ),
-    ),
+    v.array(ExplorerTransactionSchema),
     v.description("Event of array of transaction details."),
   );
 })();
@@ -78,14 +35,14 @@ export type ExplorerTxsEvent = v.InferOutput<typeof ExplorerTxsEvent>;
 // ============================================================
 
 import type { SubscriptionConfig } from "./_types.js";
-import type { WebSocketSubscription } from "../../../transport/websocket/mod.js";
+import type { ISubscription } from "../../../transport/mod.js";
 
 /**
  * Subscribe to explorer transaction updates.
  *
  * @param config - General configuration for Subscription API subscriptions.
  * @param listener - A callback function to be called when the event is received.
- * @returns A request-promise that resolves with a {@link WebSocketSubscription} object to manage the subscription lifecycle.
+ * @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.
@@ -102,11 +59,13 @@ import type { WebSocketSubscription } from "../../../transport/websocket/mod.js"
  *   (data) => console.log(data),
  * );
  * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
  */
 export function explorerTxs(
   config: SubscriptionConfig,
   listener: (data: ExplorerTxsEvent) => void,
-): Promise<WebSocketSubscription> {
+): Promise<ISubscription> {
   const payload = v.parse(ExplorerTxsRequest, { type: "explorerTxs" });
   return config.transport.subscribe<ExplorerTxsEvent>("_explorerTxs", payload, (e) => { // Internal channel as it does not have its own channel
     listener(e.detail);

package/src/src/api/subscription/_methods/l2Book.ts

@@ -45,7 +45,7 @@ export const L2BookRequest = /* @__PURE__ */ (() => {
 })();
 export type L2BookRequest = v.InferOutput<typeof L2BookRequest>;
 
-const L2BookLevel = /* @__PURE__ */ (() => {
+const L2BookLevelSchema = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
       /** Price. */
@@ -84,7 +84,7 @@ export const L2BookEvent = /* @__PURE__ */ (() => {
       ),
       /** Bid and ask levels (index 0 = bids, index 1 = asks). */
       levels: v.pipe(
-        v.tuple([v.array(L2BookLevel), v.array(L2BookLevel)]),
+        v.tuple([v.array(L2BookLevelSchema), v.array(L2BookLevelSchema)]),
         v.description("Bid and ask levels (index 0 = bids, index 1 = asks)."),
       ),
     }),
@@ -98,7 +98,7 @@ export type L2BookEvent = v.InferOutput<typeof L2BookEvent>;
 // ============================================================
 
 import type { SubscriptionConfig } from "./_types.js";
-import type { WebSocketSubscription } from "../../../transport/websocket/mod.js";
+import type { ISubscription } from "../../../transport/mod.js";
 
 /** Request parameters for the {@linkcode l2Book} function. */
 export type L2BookParameters = Omit<v.InferInput<typeof L2BookRequest>, "type">;
@@ -110,7 +110,7 @@ export type L2BookParameters = Omit<v.InferInput<typeof L2BookRequest>, "type">;
  * @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 WebSocketSubscription} object to manage the subscription lifecycle.
+ * @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.
@@ -135,7 +135,7 @@ export function l2Book(
   config: SubscriptionConfig,
   params: L2BookParameters,
   listener: (data: L2BookEvent) => void,
-): Promise<WebSocketSubscription> {
+): Promise<ISubscription> {
   const payload = v.parse(L2BookRequest, {
     type: "l2Book",
     ...params,

package/src/src/api/subscription/_methods/notification.ts

@@ -46,7 +46,7 @@ export type NotificationEvent = v.InferOutput<typeof NotificationEvent>;
 // ============================================================
 
 import type { SubscriptionConfig } from "./_types.js";
-import type { WebSocketSubscription } from "../../../transport/websocket/mod.js";
+import type { ISubscription } from "../../../transport/mod.js";
 
 /** Request parameters for the {@linkcode notification} function. */
 export type NotificationParameters = Omit<v.InferInput<typeof NotificationRequest>, "type">;
@@ -58,7 +58,7 @@ export type NotificationParameters = Omit<v.InferInput<typeof NotificationReques
  * @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 WebSocketSubscription} object to manage the subscription lifecycle.
+ * @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.
@@ -83,7 +83,7 @@ export function notification(
   config: SubscriptionConfig,
   params: NotificationParameters,
   listener: (data: NotificationEvent) => void,
-): Promise<WebSocketSubscription> {
+): Promise<ISubscription> {
   const payload = v.parse(NotificationRequest, { type: "notification", ...params });
   return config.transport.subscribe<NotificationEvent>(payload.type, payload, (e) => {
     listener(e.detail);

package/src/src/api/subscription/_methods/openOrders.ts

@@ -47,7 +47,10 @@ export const OpenOrdersEvent = /* @__PURE__ */ (() => {
         v.description("User address."),
       ),
       /** Array of open orders with additional display information. */
-      orders: FrontendOpenOrdersResponse,
+      orders: v.pipe(
+        FrontendOpenOrdersResponse,
+        v.description("Array of open orders with additional display information."),
+      ),
     }),
     v.description("Event of open orders for a specific user."),
   );
@@ -59,7 +62,7 @@ export type OpenOrdersEvent = v.InferOutput<typeof OpenOrdersEvent>;
 // ============================================================
 
 import type { SubscriptionConfig } from "./_types.js";
-import type { WebSocketSubscription } from "../../../transport/websocket/mod.js";
+import type { ISubscription } from "../../../transport/mod.js";
 
 /** Request parameters for the {@linkcode openOrders} function. */
 export type OpenOrdersParameters = Omit<v.InferInput<typeof OpenOrdersRequest>, "type">;
@@ -71,7 +74,7 @@ export type OpenOrdersParameters = Omit<v.InferInput<typeof OpenOrdersRequest>,
  * @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 WebSocketSubscription} object to manage the subscription lifecycle.
+ * @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.
@@ -96,7 +99,7 @@ export function openOrders(
   config: SubscriptionConfig,
   params: OpenOrdersParameters,
   listener: (data: OpenOrdersEvent) => void,
-): Promise<WebSocketSubscription> {
+): Promise<ISubscription> {
   const payload = v.parse(OpenOrdersRequest, {
     type: "openOrders",
     ...params,

package/src/src/api/subscription/_methods/orderUpdates.ts

@@ -4,7 +4,8 @@ import * as v from "valibot";
 // API Schemas
 // ============================================================
 
-import { Address, Hex, UnsignedDecimal, UnsignedInteger } from "../../_schemas.js";
+import { Address, UnsignedInteger } from "../../_schemas.js";
+import { OpenOrderSchema, OrderProcessingStatusSchema } from "../../info/_methods/_base/commonSchemas.js";
 
 /** Subscription to order updates for a specific user. */
 export const OrderUpdatesRequest = /* @__PURE__ */ (() => {
@@ -30,167 +31,85 @@ export type OrderUpdatesRequest = v.InferOutput<typeof OrderUpdatesRequest>;
 export const OrderUpdatesEvent = /* @__PURE__ */ (() => {
   return v.pipe(
     v.array(
-      /** Order with its current processing status. */
-      v.pipe(
-        v.object({
-          /** Order details. */
-          order: v.pipe(
-            v.object({
-              /** Asset symbol. */
-              coin: v.pipe(
-                v.string(),
-                v.description("Asset symbol."),
-              ),
-              /** Order side ("B" = Bid/Buy, "A" = Ask/Sell). */
-              side: v.pipe(
-                v.picklist(["B", "A"]),
-                v.description('Order side ("B" = Bid/Buy, "A" = Ask/Sell).'),
-              ),
-              /** Limit price. */
-              limitPx: v.pipe(
-                UnsignedDecimal,
-                v.description("Limit price."),
-              ),
-              /** Size. */
-              sz: v.pipe(
-                UnsignedDecimal,
-                v.description("Size."),
-              ),
-              /** Order ID. */
-              oid: v.pipe(
-                UnsignedInteger,
-                v.description("Order ID."),
-              ),
-              /** Timestamp when the order was placed (in ms since epoch). */
-              timestamp: v.pipe(
-                UnsignedInteger,
-                v.description(
-                  "Timestamp when the order was placed (in ms since epoch).",
-                ),
-              ),
-              /** Original size at order placement. */
-              origSz: v.pipe(
-                UnsignedDecimal,
-                v.description("Original size at order placement."),
-              ),
-              /** Client Order ID. */
-              cloid: v.pipe(
-                v.optional(v.pipe(Hex, v.length(34))),
-                v.description("Client Order ID."),
-              ),
-              /** Indicates if the order is reduce-only. */
-              reduceOnly: v.pipe(
-                v.optional(v.literal(true)),
-                v.description("Indicates if the order is reduce-only."),
-              ),
-            }),
-            v.description("Order details."),
+      v.object({
+        /** Order details. */
+        order: v.pipe(
+          OpenOrderSchema,
+          v.description("Order details."),
+        ),
+        /**
+         * Order processing status.
+         * - `"open"`: Order active and waiting to be filled.
+         * - `"filled"`: Order fully executed.
+         * - `"canceled"`: Order canceled by the user.
+         * - `"triggered"`: Order triggered and awaiting execution.
+         * - `"rejected"`: Order rejected by the system.
+         * - `"marginCanceled"`: Order canceled due to insufficient margin.
+         * - `"vaultWithdrawalCanceled"`: Canceled due to a user withdrawal from vault.
+         * - `"openInterestCapCanceled"`: Canceled due to order being too aggressive when open interest was at cap.
+         * - `"selfTradeCanceled"`: Canceled due to self-trade prevention.
+         * - `"reduceOnlyCanceled"`: Canceled reduced-only order that does not reduce position.
+         * - `"siblingFilledCanceled"`: Canceled due to sibling ordering being filled.
+         * - `"delistedCanceled"`: Canceled due to asset delisting.
+         * - `"liquidatedCanceled"`: Canceled due to liquidation.
+         * - `"scheduledCancel"`: Canceled due to exceeding scheduled cancel deadline (dead man's switch).
+         * - `"tickRejected"`: Rejected due to invalid tick price.
+         * - `"minTradeNtlRejected"`: Rejected due to order notional below minimum.
+         * - `"perpMarginRejected"`: Rejected due to insufficient margin.
+         * - `"reduceOnlyRejected"`: Rejected due to reduce only.
+         * - `"badAloPxRejected"`: Rejected due to post-only immediate match.
+         * - `"iocCancelRejected"`: Rejected due to IOC not able to match.
+         * - `"badTriggerPxRejected"`: Rejected due to invalid TP/SL price.
+         * - `"marketOrderNoLiquidityRejected"`: Rejected due to lack of liquidity for market order.
+         * - `"positionIncreaseAtOpenInterestCapRejected"`: Rejected due to open interest cap.
+         * - `"positionFlipAtOpenInterestCapRejected"`: Rejected due to open interest cap.
+         * - `"tooAggressiveAtOpenInterestCapRejected"`: Rejected due to price too aggressive at open interest cap.
+         * - `"openInterestIncreaseRejected"`: Rejected due to open interest cap.
+         * - `"insufficientSpotBalanceRejected"`: Rejected due to insufficient spot balance.
+         * - `"oracleRejected"`: Rejected due to price too far from oracle.
+         * - `"perpMaxPositionRejected"`: Rejected due to exceeding margin tier limit at current leverage.
+         */
+        status: v.pipe(
+          OrderProcessingStatusSchema,
+          v.description(
+            "Order processing status." +
+              '\n- `"open"`: Order active and waiting to be filled.' +
+              '\n- `"filled"`: Order fully executed.' +
+              '\n- `"canceled"`: Order canceled by the user.' +
+              '\n- `"triggered"`: Order triggered and awaiting execution.' +
+              '\n- `"rejected"`: Order rejected by the system.' +
+              '\n- `"marginCanceled"`: Order canceled due to insufficient margin.' +
+              '\n- `"vaultWithdrawalCanceled"`: Canceled due to a user withdrawal from vault.' +
+              '\n- `"openInterestCapCanceled"`: Canceled due to order being too aggressive when open interest was at cap.' +
+              '\n- `"selfTradeCanceled"`: Canceled due to self-trade prevention.' +
+              '\n- `"reduceOnlyCanceled"`: Canceled reduced-only order that does not reduce position.' +
+              '\n- `"siblingFilledCanceled"`: Canceled due to sibling ordering being filled.' +
+              '\n- `"delistedCanceled"`: Canceled due to asset delisting.' +
+              '\n- `"liquidatedCanceled"`: Canceled due to liquidation.' +
+              '\n- `"scheduledCancel"`: Canceled due to exceeding scheduled cancel deadline (dead man\'s switch).' +
+              '\n- `"tickRejected"`: Rejected due to invalid tick price.' +
+              '\n- `"minTradeNtlRejected"`: Rejected due to order notional below minimum.' +
+              '\n- `"perpMarginRejected"`: Rejected due to insufficient margin.' +
+              '\n- `"reduceOnlyRejected"`: Rejected due to reduce only.' +
+              '\n- `"badAloPxRejected"`: Rejected due to post-only immediate match.' +
+              '\n- `"iocCancelRejected"`: Rejected due to IOC not able to match.' +
+              '\n- `"badTriggerPxRejected"`: Rejected due to invalid TP/SL price.' +
+              '\n- `"marketOrderNoLiquidityRejected"`: Rejected due to lack of liquidity for market order.' +
+              '\n- `"positionIncreaseAtOpenInterestCapRejected"`: Rejected due to open interest cap.' +
+              '\n- `"positionFlipAtOpenInterestCapRejected"`: Rejected due to open interest cap.' +
+              '\n- `"tooAggressiveAtOpenInterestCapRejected"`: Rejected due to price too aggressive at open interest cap.' +
+              '\n- `"openInterestIncreaseRejected"`: Rejected due to open interest cap.' +
+              '\n- `"insufficientSpotBalanceRejected"`: Rejected due to insufficient spot balance.' +
+              '\n- `"oracleRejected"`: Rejected due to price too far from oracle.' +
+              '\n- `"perpMaxPositionRejected"`: Rejected due to exceeding margin tier limit at current leverage.',
           ),
-          /**
-           * Order processing status.
-           * - `"open"`: Order active and waiting to be filled.
-           * - `"filled"`: Order fully executed.
-           * - `"canceled"`: Order canceled by the user.
-           * - `"triggered"`: Order triggered and awaiting execution.
-           * - `"rejected"`: Order rejected by the system.
-           * - `"marginCanceled"`: Order canceled due to insufficient margin.
-           * - `"vaultWithdrawalCanceled"`: Canceled due to a user withdrawal from vault.
-           * - `"openInterestCapCanceled"`: Canceled due to order being too aggressive when open interest was at cap.
-           * - `"selfTradeCanceled"`: Canceled due to self-trade prevention.
-           * - `"reduceOnlyCanceled"`: Canceled reduced-only order that does not reduce position.
-           * - `"siblingFilledCanceled"`: Canceled due to sibling ordering being filled.
-           * - `"delistedCanceled"`: Canceled due to asset delisting.
-           * - `"liquidatedCanceled"`: Canceled due to liquidation.
-           * - `"scheduledCancel"`: Canceled due to exceeding scheduled cancel deadline (dead man's switch).
-           * - `"tickRejected"`: Rejected due to invalid tick price.
-           * - `"minTradeNtlRejected"`: Rejected due to order notional below minimum.
-           * - `"perpMarginRejected"`: Rejected due to insufficient margin.
-           * - `"reduceOnlyRejected"`: Rejected due to reduce only.
-           * - `"badAloPxRejected"`: Rejected due to post-only immediate match.
-           * - `"iocCancelRejected"`: Rejected due to IOC not able to match.
-           * - `"badTriggerPxRejected"`: Rejected due to invalid TP/SL price.
-           * - `"marketOrderNoLiquidityRejected"`: Rejected due to lack of liquidity for market order.
-           * - `"positionIncreaseAtOpenInterestCapRejected"`: Rejected due to open interest cap.
-           * - `"positionFlipAtOpenInterestCapRejected"`: Rejected due to open interest cap.
-           * - `"tooAggressiveAtOpenInterestCapRejected"`: Rejected due to price too aggressive at open interest cap.
-           * - `"openInterestIncreaseRejected"`: Rejected due to open interest cap.
-           * - `"insufficientSpotBalanceRejected"`: Rejected due to insufficient spot balance.
-           * - `"oracleRejected"`: Rejected due to price too far from oracle.
-           * - `"perpMaxPositionRejected"`: Rejected due to exceeding margin tier limit at current leverage.
-           */
-          status: v.pipe(
-            v.picklist([
-              "open",
-              "filled",
-              "canceled",
-              "triggered",
-              "rejected",
-              "marginCanceled",
-              "vaultWithdrawalCanceled",
-              "openInterestCapCanceled",
-              "selfTradeCanceled",
-              "reduceOnlyCanceled",
-              "siblingFilledCanceled",
-              "delistedCanceled",
-              "liquidatedCanceled",
-              "scheduledCancel",
-              "tickRejected",
-              "minTradeNtlRejected",
-              "perpMarginRejected",
-              "reduceOnlyRejected",
-              "badAloPxRejected",
-              "iocCancelRejected",
-              "badTriggerPxRejected",
-              "marketOrderNoLiquidityRejected",
-              "positionIncreaseAtOpenInterestCapRejected",
-              "positionFlipAtOpenInterestCapRejected",
-              "tooAggressiveAtOpenInterestCapRejected",
-              "openInterestIncreaseRejected",
-              "insufficientSpotBalanceRejected",
-              "oracleRejected",
-              "perpMaxPositionRejected",
-            ]),
-            v.description(
-              "Order processing status." +
-                '\n- `"open"`: Order active and waiting to be filled.' +
-                '\n- `"filled"`: Order fully executed.' +
-                '\n- `"canceled"`: Order canceled by the user.' +
-                '\n- `"triggered"`: Order triggered and awaiting execution.' +
-                '\n- `"rejected"`: Order rejected by the system.' +
-                '\n- `"marginCanceled"`: Order canceled due to insufficient margin.' +
-                '\n- `"vaultWithdrawalCanceled"`: Canceled due to a user withdrawal from vault.' +
-                '\n- `"openInterestCapCanceled"`: Canceled due to order being too aggressive when open interest was at cap.' +
-                '\n- `"selfTradeCanceled"`: Canceled due to self-trade prevention.' +
-                '\n- `"reduceOnlyCanceled"`: Canceled reduced-only order that does not reduce position.' +
-                '\n- `"siblingFilledCanceled"`: Canceled due to sibling ordering being filled.' +
-                '\n- `"delistedCanceled"`: Canceled due to asset delisting.' +
-                '\n- `"liquidatedCanceled"`: Canceled due to liquidation.' +
-                '\n- `"scheduledCancel"`: Canceled due to exceeding scheduled cancel deadline (dead man\'s switch).' +
-                '\n- `"tickRejected"`: Rejected due to invalid tick price.' +
-                '\n- `"minTradeNtlRejected"`: Rejected due to order notional below minimum.' +
-                '\n- `"perpMarginRejected"`: Rejected due to insufficient margin.' +
-                '\n- `"reduceOnlyRejected"`: Rejected due to reduce only.' +
-                '\n- `"badAloPxRejected"`: Rejected due to post-only immediate match.' +
-                '\n- `"iocCancelRejected"`: Rejected due to IOC not able to match.' +
-                '\n- `"badTriggerPxRejected"`: Rejected due to invalid TP/SL price.' +
-                '\n- `"marketOrderNoLiquidityRejected"`: Rejected due to lack of liquidity for market order.' +
-                '\n- `"positionIncreaseAtOpenInterestCapRejected"`: Rejected due to open interest cap.' +
-                '\n- `"positionFlipAtOpenInterestCapRejected"`: Rejected due to open interest cap.' +
-                '\n- `"tooAggressiveAtOpenInterestCapRejected"`: Rejected due to price too aggressive at open interest cap.' +
-                '\n- `"openInterestIncreaseRejected"`: Rejected due to open interest cap.' +
-                '\n- `"insufficientSpotBalanceRejected"`: Rejected due to insufficient spot balance.' +
-                '\n- `"oracleRejected"`: Rejected due to price too far from oracle.' +
-                '\n- `"perpMaxPositionRejected"`: Rejected due to exceeding margin tier limit at current leverage.',
-            ),
-          ),
-          /** Timestamp when the status was last updated (in ms since epoch). */
-          statusTimestamp: v.pipe(
-            UnsignedInteger,
-            v.description("Timestamp when the status was last updated (in ms since epoch)."),
-          ),
-        }),
-        v.description("Order with its current processing status."),
-      ),
+        ),
+        /** Timestamp when the status was last updated (in ms since epoch). */
+        statusTimestamp: v.pipe(
+          UnsignedInteger,
+          v.description("Timestamp when the status was last updated (in ms since epoch)."),
+        ),
+      }),
     ),
     v.description("Event of array of orders with their current processing status."),
   );
@@ -202,7 +121,7 @@ export type OrderUpdatesEvent = v.InferOutput<typeof OrderUpdatesEvent>;
 // ============================================================
 
 import type { SubscriptionConfig } from "./_types.js";
-import type { WebSocketSubscription } from "../../../transport/websocket/mod.js";
+import type { ISubscription } from "../../../transport/mod.js";
 
 /** Request parameters for the {@linkcode orderUpdates} function. */
 export type OrderUpdatesParameters = Omit<v.InferInput<typeof OrderUpdatesRequest>, "type">;
@@ -214,7 +133,7 @@ export type OrderUpdatesParameters = Omit<v.InferInput<typeof OrderUpdatesReques
  * @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 WebSocketSubscription} object to manage the subscription lifecycle.
+ * @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.
@@ -239,7 +158,7 @@ export function orderUpdates(
   config: SubscriptionConfig,
   params: OrderUpdatesParameters,
   listener: (data: OrderUpdatesEvent) => void,
-): Promise<WebSocketSubscription> {
+): Promise<ISubscription> {
   const payload = v.parse(OrderUpdatesRequest, { type: "orderUpdates", ...params });
   return config.transport.subscribe<OrderUpdatesEvent>(payload.type, payload, (e) => {
     listener(e.detail);