@lightconexyz/lightcone-sdk 0.8.1 → 0.8.2

package/dist/ws/index.d.ts.map

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

package/dist/ws/index.js

@@ -23,6 +23,8 @@ exports.subscribeTrades = subscribeTrades;
 exports.unsubscribeTrades = unsubscribeTrades;
 exports.subscribeUser = subscribeUser;
 exports.unsubscribeUser = unsubscribeUser;
+exports.subscribeWalletDepositBalances = subscribeWalletDepositBalances;
+exports.unsubscribeWalletDepositBalances = unsubscribeWalletDepositBalances;
 exports.subscribePriceHistory = subscribePriceHistory;
 exports.unsubscribePriceHistory = unsubscribePriceHistory;
 exports.subscribeTicker = subscribeTicker;
@@ -148,6 +150,33 @@ function unsubscribeUser(walletAddress) {
         },
     };
 }
+/**
+ * Subscribe to a wallet owned by the authenticated user.
+ * The channel begins with a complete replacement snapshot and then emits
+ * absolute SPL/native updates plus non-mutating status events.
+ */
+function subscribeWalletDepositBalances(walletAddress) {
+    return {
+        method: "subscribe",
+        params: {
+            type: "wallet_deposit_balances",
+            wallet_address: walletAddress,
+        },
+    };
+}
+/**
+ * Stop the authenticated wallet stream identified by this exact wallet address.
+ * This wire operation is separate from clearing local reconnect tracking.
+ */
+function unsubscribeWalletDepositBalances(walletAddress) {
+    return {
+        method: "unsubscribe",
+        params: {
+            type: "wallet_deposit_balances",
+            wallet_address: walletAddress,
+        },
+    };
+}
 function subscribePriceHistory(orderbookId, resolution) {
     return {
         method: "subscribe",
@@ -254,7 +283,15 @@ const VALID_MESSAGE_TYPES = new Set([
     "market",
     "deposit_price",
     "deposit_asset_price",
+    "wallet_deposit_balances",
 ]);
+/**
+ * Parse and normalize one inbound frame.
+ *
+ * Wallet-balance payloads cross a runtime validation boundary here: malformed
+ * nested discriminators, exact values, or slots throw a protocol `WsError`
+ * instead of escaping behind TypeScript-only types.
+ */
 function parseMessageIn(input) {
     const parsed = (0, json_1.parseJsonExact)(input);
     if (typeof parsed !== "object" || parsed === null || !("type" in parsed)) {
@@ -272,12 +309,28 @@ function parseMessageIn(input) {
     }
     let message = parsed;
     if (message.type === "book_update") {
-        const seq = message.data.seq;
+        const data = message.data;
+        const seq = data.seq;
         if ((typeof seq !== "number" && typeof seq !== "bigint") ||
             (typeof seq === "number" && (!Number.isSafeInteger(seq) || seq < 0)) ||
             (typeof seq === "bigint" && seq < 0n)) {
             throw new error_1.WsError("ProtocolError", "Invalid book_update seq");
         }
+        // Validate only populated level arrays so existing empty/resync frame
+        // tolerance is unchanged while exact quote liquidity cannot be omitted.
+        for (const side of ["bids", "asks"]) {
+            const levels = data[side];
+            if (!Array.isArray(levels))
+                continue;
+            for (const level of levels) {
+                if (typeof level !== "object" ||
+                    level === null ||
+                    Array.isArray(level) ||
+                    typeof level.quote_notional !== "string") {
+                    throw new error_1.WsError("ProtocolError", `Invalid book_update ${side} level: missing or invalid quote_notional`);
+                }
+            }
+        }
         message = {
             ...message,
             data: { ...message.data, seq: BigInt(seq) },
@@ -289,6 +342,114 @@ function parseMessageIn(input) {
             data: (0, wire_1.normalizeUserUpdate)(message.data),
         };
     }
+    if (message.type === "wallet_deposit_balances") {
+        return {
+            ...message,
+            data: normalizeWalletDepositBalancesEvent(message.data),
+        };
+    }
     return message;
 }
+/** Validate the nested wallet event before exposing its discriminated union. */
+function normalizeWalletDepositBalancesEvent(input) {
+    const data = requireObject(input, "wallet_deposit_balances data");
+    const eventType = requireString(data, "event_type");
+    const walletAddress = requireString(data, "wallet_address");
+    switch (eventType) {
+        case "wallet_deposit_balance_snapshot": {
+            const rawBalances = requireObject(data.balances, "balances");
+            const balances = {};
+            for (const [mint, balance] of Object.entries(rawBalances)) {
+                balances[mint] = normalizeDepositTokenBalance(balance);
+            }
+            return {
+                event_type: eventType,
+                wallet_address: walletAddress,
+                context_slot: requireContextSlot(data),
+                balances,
+                native_sol_balance: requireNativeSolBalance(data),
+            };
+        }
+        case "wallet_deposit_balance_update":
+            return {
+                event_type: eventType,
+                wallet_address: walletAddress,
+                context_slot: requireContextSlot(data),
+                balance: normalizeDepositTokenBalance(data.balance),
+            };
+        case "wallet_native_sol_balance_update":
+            return {
+                event_type: eventType,
+                wallet_address: walletAddress,
+                context_slot: requireContextSlot(data),
+                native_sol_balance: requireNativeSolBalance(data),
+            };
+        case "wallet_deposit_balance_status": {
+            const status = requireString(data, "status");
+            if (status !== "reconnecting" && status !== "metadata_unavailable") {
+                throw protocolError(`Invalid wallet balance status: "${status}"`);
+            }
+            return {
+                event_type: eventType,
+                wallet_address: walletAddress,
+                status,
+                code: requireString(data, "code"),
+            };
+        }
+        default:
+            throw protocolError(`Invalid wallet balance event type: "${eventType}"`);
+    }
+}
+/** Preserve exact strings and nullable icons while rejecting incomplete balances. */
+function normalizeDepositTokenBalance(input) {
+    const balance = requireObject(input, "deposit-token balance");
+    const normalized = {
+        mint: requireString(balance, "mint"),
+        idle: requireString(balance, "idle"),
+        symbol: requireString(balance, "symbol"),
+        name: requireString(balance, "name"),
+    };
+    for (const field of ["icon_url_low", "icon_url_medium", "icon_url_high"]) {
+        const value = balance[field];
+        if (value !== undefined) {
+            if (value !== null && typeof value !== "string") {
+                throw protocolError(`Invalid deposit-token balance ${field}`);
+            }
+            normalized[field] = value;
+        }
+    }
+    return normalized;
+}
+function requireObject(input, field) {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        throw protocolError(`Invalid ${field}: expected object`);
+    }
+    return input;
+}
+function requireString(data, field) {
+    const value = data[field];
+    if (typeof value !== "string") {
+        throw protocolError(`Invalid wallet balance ${field}: expected string`);
+    }
+    return value;
+}
+function requireNativeSolBalance(data) {
+    // Canonical nine-place syntax maps directly to lamports without rounding or exponents.
+    const value = requireString(data, "native_sol_balance");
+    if (!/^(?:0|[1-9][0-9]*)\.[0-9]{9}$/.test(value)) {
+        throw protocolError("Invalid wallet balance native_sol_balance: expected exactly nine decimal places");
+    }
+    return value;
+}
+function requireContextSlot(data) {
+    // Safe integers prevent precision loss when state compares JavaScript slots.
+    const value = data.context_slot;
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw protocolError("Invalid wallet balance context_slot");
+    }
+    return value;
+}
+function protocolError(message) {
+    return new error_1.WsError("ProtocolError", message);
+}
 //# sourceMappingURL=index.js.map

package/dist/ws/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ws/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MarketEvent } from \"../domain/market\";\nimport { normalizeUserUpdate, type AuthUpdate, type UserUpdate } from \"../domain/order/wire\";\nimport type { OrderBook, WsTickerData } from \"../domain/orderbook\";\nimport {\n  FULL_PRECISION,\n  normalizeAggregation,\n  type BookAggregation,\n} from \"../domain/orderbook/aggregation\";\nimport type {\n  DepositAssetPriceEvent,\n  DepositPrice,\n  PriceHistory,\n} from \"../domain/price_history\";\nimport type { WsTrade } from \"../domain/trade\";\nimport { WsError as WsErrorClass } from \"../error\";\nimport { LightconeEnv, wsUrl } from \"../env\";\nimport type { OrderBookId, PubkeyStr, Resolution } from \"../shared\";\nimport { parseJsonExact } from \"../shared/json\";\n\nexport * from \"./client.node\";\nexport * from \"./subscriptions\";\nexport type { IWsClient } from \"./types\";\n\nexport type MessageOut =\n  | { method: \"subscribe\"; params: import(\"./subscriptions\").SubscribeParams }\n  | { method: \"unsubscribe\"; params: import(\"./subscriptions\").UnsubscribeParams }\n  | { method: \"ping\" };\n\nexport type MessageIn =\n  | { type: \"book_update\"; version: number; data: OrderBook }\n  | { type: \"pong\"; version: number; data: Record<string, never> }\n  | { type: \"user\"; version: number; data: UserUpdate }\n  | { type: \"error\"; version: number; data: WsError }\n  | { type: \"price_history\"; version: number; data: PriceHistory }\n  | { type: \"trades\"; version: number; data: WsTrade }\n  | { type: \"auth\"; version: number; data: AuthUpdate }\n  | { type: \"ticker\"; version: number; data: WsTickerData }\n  | { type: \"market\"; version: number; data: MarketEvent }\n  | { type: \"deposit_price\"; version: number; data: DepositPrice }\n  | { type: \"deposit_asset_price\"; version: number; data: DepositAssetPriceEvent };\n\nexport type Kind = MessageIn;\n\nexport interface WsError {\n  error: string;\n  code?: string;\n  orderbook_id?: string;\n  /**\n   * Aggregation of the affected book subscription on book-scoped errors\n   * (`ENGINE_UNAVAILABLE`, `SUBSCRIPTION_LIMIT_REACHED`,\n   * `INVALID_ORDERBOOK_SUBSCRIPTION`). Absent = full precision; pass to\n   * `aggregationFromFrame` to identify the `(orderbook, aggregation)` pair.\n   */\n  n_sig_figs?: number;\n  mantissa?: number;\n  wallet_address?: string;\n  deposit_asset?: string;\n  hint?: string;\n  details?: string;\n}\n\nexport type WsEvent =\n  | { type: \"Message\"; message: MessageIn }\n  | { type: \"Connected\" }\n  | { type: \"Disconnected\"; code?: number; reason: string }\n  | { type: \"Error\"; error: string }\n  | { type: \"MaxReconnectReached\" };\n\nexport interface WsConfig {\n  url: string;\n  reconnect: boolean;\n  maxReconnectAttempts: number;\n  baseReconnectDelayMs: number;\n  pingIntervalMs: number;\n  pongTimeoutMs: number;\n}\n\nexport const WS_DEFAULT_CONFIG: WsConfig = {\n  url: wsUrl(LightconeEnv.Prod),\n  reconnect: true,\n  maxReconnectAttempts: 10,\n  baseReconnectDelayMs: 1_000,\n  pingIntervalMs: 30_000,\n  pongTimeoutMs: 10_000,\n};\n\nexport enum ReadyState {\n  Connecting = 0,\n  Open = 1,\n  Closing = 2,\n  Closed = 3,\n}\n\nexport function readyStateFrom(value: number): ReadyState {\n  switch (value) {\n    case 0:\n      return ReadyState.Connecting;\n    case 1:\n      return ReadyState.Open;\n    case 2:\n      return ReadyState.Closing;\n    case 3:\n    default:\n      return ReadyState.Closed;\n  }\n}\n\nexport function ping(): MessageOut {\n  return { method: \"ping\" };\n}\n\n/**\n * Subscribe to book snapshots, optionally aggregated (Hyperliquid-style).\n *\n * Omit `aggregation` for the raw book. The aggregation is normalized before\n * sending ((5, none) → (5, 1)); validate with `validateAggregation` first —\n * invalid combinations are rejected server-side with\n * `INVALID_ORDERBOOK_SUBSCRIPTION`. `undefined` fields are dropped by\n * `JSON.stringify`, so full precision stays byte-identical to the\n * pre-aggregation message.\n */\nexport function subscribeBooks(\n  orderbookIds: OrderBookId[],\n  aggregation: BookAggregation = FULL_PRECISION\n): MessageOut {\n  const sorted = [...orderbookIds].sort();\n  const normalized = normalizeAggregation(aggregation);\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"book_update\",\n      orderbook_ids: sorted,\n      nSigFigs: normalized.nSigFigs,\n      mantissa: normalized.mantissa,\n    },\n  };\n}\n\n/**\n * Unsubscribe a book subscription. The aggregation must match the one\n * subscribed (normalized) or the server removes nothing.\n */\nexport function unsubscribeBooks(\n  orderbookIds: OrderBookId[],\n  aggregation: BookAggregation = FULL_PRECISION\n): MessageOut {\n  const sorted = [...orderbookIds].sort();\n  const normalized = normalizeAggregation(aggregation);\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"book_update\",\n      orderbook_ids: sorted,\n      nSigFigs: normalized.nSigFigs,\n      mantissa: normalized.mantissa,\n    },\n  };\n}\n\nexport function subscribeTrades(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"trades\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function unsubscribeTrades(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"trades\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function subscribeUser(walletAddress: PubkeyStr): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"user\",\n      wallet_address: walletAddress,\n    },\n  };\n}\n\nexport function unsubscribeUser(walletAddress: PubkeyStr): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"user\",\n      wallet_address: walletAddress,\n    },\n  };\n}\n\nexport function subscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"price_history\",\n      orderbook_id: orderbookId,\n      resolution,\n      include_ohlcv: false,\n    },\n  };\n}\n\nexport function unsubscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"price_history\",\n      orderbook_id: orderbookId,\n      resolution,\n    },\n  };\n}\n\nexport function subscribeTicker(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"ticker\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function unsubscribeTicker(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"ticker\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function subscribeMarket(marketPubkey: PubkeyStr): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"market\",\n      market_pubkey: marketPubkey,\n    },\n  };\n}\n\nexport function unsubscribeMarket(marketPubkey: PubkeyStr): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"market\",\n      market_pubkey: marketPubkey,\n    },\n  };\n}\n\nexport function subscribeDepositPrice(depositAsset: string, resolution: Resolution): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"deposit_price\",\n      deposit_asset: depositAsset,\n      resolution,\n    },\n  };\n}\n\nexport function unsubscribeDepositPrice(depositAsset: string, resolution: Resolution): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"deposit_price\",\n      deposit_asset: depositAsset,\n      resolution,\n    },\n  };\n}\n\n/**\n * Subscribe to the live spot price for one deposit asset (snapshot +\n * per-asset price ticks). Distinct from `subscribeDepositPrice`, which\n * carries OHLCV candles per resolution.\n */\nexport function subscribeDepositAssetPrice(depositAsset: string): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: { type: \"deposit_asset_price\", deposit_asset: depositAsset },\n  };\n}\n\nexport function unsubscribeDepositAssetPrice(depositAsset: string): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: { type: \"deposit_asset_price\", deposit_asset: depositAsset },\n  };\n}\n\nconst VALID_MESSAGE_TYPES = new Set([\n  \"book_update\",\n  \"pong\",\n  \"user\",\n  \"error\",\n  \"price_history\",\n  \"trades\",\n  \"auth\",\n  \"ticker\",\n  \"market\",\n  \"deposit_price\",\n  \"deposit_asset_price\",\n]);\n\nexport function parseMessageIn(input: string): MessageIn {\n  const parsed: unknown = parseJsonExact(input);\n  if (typeof parsed !== \"object\" || parsed === null || !(\"type\" in parsed)) {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message: missing \"type\" field`);\n  }\n  const obj = parsed as Record<string, unknown>;\n  if (typeof obj.type !== \"string\" || !VALID_MESSAGE_TYPES.has(obj.type)) {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message type: \"${String(obj.type)}\"`);\n  }\n  if (!(\"version\" in obj) || typeof obj.version !== \"number\") {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message: missing or invalid \"version\" field`);\n  }\n  if (!(\"data\" in obj) || typeof obj.data !== \"object\" || obj.data === null) {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message: missing or invalid \"data\" field`);\n  }\n  let message = parsed as MessageIn;\n  if (message.type === \"book_update\") {\n    const seq = (message.data as unknown as { seq?: number | bigint }).seq;\n    if ((typeof seq !== \"number\" && typeof seq !== \"bigint\") ||\n        (typeof seq === \"number\" && (!Number.isSafeInteger(seq) || seq < 0)) ||\n        (typeof seq === \"bigint\" && seq < 0n)) {\n      throw new WsErrorClass(\"ProtocolError\", \"Invalid book_update seq\");\n    }\n    message = {\n      ...message,\n      data: { ...message.data, seq: BigInt(seq) },\n    };\n  }\n  if (message.type === \"user\") {\n    return {\n      ...message,\n      data: normalizeUserUpdate(message.data as Parameters<typeof normalizeUserUpdate>[0]),\n    };\n  }\n  return message;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ws/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MarketEvent } from \"../domain/market\";\nimport { normalizeUserUpdate, type AuthUpdate, type UserUpdate } from \"../domain/order/wire\";\nimport type { OrderBook, WsTickerData } from \"../domain/orderbook\";\nimport {\n  FULL_PRECISION,\n  normalizeAggregation,\n  type BookAggregation,\n} from \"../domain/orderbook/aggregation\";\nimport type {\n  DepositAssetPriceEvent,\n  DepositPrice,\n  PriceHistory,\n} from \"../domain/price_history\";\nimport type { WsTrade } from \"../domain/trade\";\nimport type {\n  DepositTokenBalance,\n  WalletDepositBalancesEvent,\n} from \"../domain/position\";\nimport { WsError as WsErrorClass } from \"../error\";\nimport { LightconeEnv, wsUrl } from \"../env\";\nimport type { OrderBookId, PubkeyStr, Resolution } from \"../shared\";\nimport { parseJsonExact } from \"../shared/json\";\n\nexport * from \"./client.node\";\nexport * from \"./subscriptions\";\nexport type { IWsClient } from \"./types\";\n\nexport type MessageOut =\n  | { method: \"subscribe\"; params: import(\"./subscriptions\").SubscribeParams }\n  | { method: \"unsubscribe\"; params: import(\"./subscriptions\").UnsubscribeParams }\n  | { method: \"ping\" };\n\n/** Parsed inbound channel union; wallet balances contain a strict nested event union. */\nexport type MessageIn =\n  | { type: \"book_update\"; version: number; data: OrderBook }\n  | { type: \"pong\"; version: number; data: Record<string, never> }\n  | { type: \"user\"; version: number; data: UserUpdate }\n  | { type: \"error\"; version: number; data: WsError }\n  | { type: \"price_history\"; version: number; data: PriceHistory }\n  | { type: \"trades\"; version: number; data: WsTrade }\n  | { type: \"auth\"; version: number; data: AuthUpdate }\n  | { type: \"ticker\"; version: number; data: WsTickerData }\n  | { type: \"market\"; version: number; data: MarketEvent }\n  | { type: \"deposit_price\"; version: number; data: DepositPrice }\n  | { type: \"deposit_asset_price\"; version: number; data: DepositAssetPriceEvent }\n  | {\n      type: \"wallet_deposit_balances\";\n      version: number;\n      data: WalletDepositBalancesEvent;\n    };\n\nexport type Kind = MessageIn;\n\nexport interface WsError {\n  error: string;\n  code?: string;\n  orderbook_id?: string;\n  /**\n   * Aggregation of the affected book subscription on book-scoped errors\n   * (`ENGINE_UNAVAILABLE`, `SUBSCRIPTION_LIMIT_REACHED`,\n   * `INVALID_ORDERBOOK_SUBSCRIPTION`). Absent = full precision; pass to\n   * `aggregationFromFrame` to identify the `(orderbook, aggregation)` pair.\n   */\n  n_sig_figs?: number;\n  mantissa?: number;\n  wallet_address?: string;\n  deposit_asset?: string;\n  hint?: string;\n  details?: string;\n}\n\nexport type WsEvent =\n  | { type: \"Message\"; message: MessageIn }\n  | { type: \"Connected\" }\n  | { type: \"Disconnected\"; code?: number; reason: string }\n  | { type: \"Error\"; error: string }\n  | { type: \"MaxReconnectReached\" };\n\nexport interface WsConfig {\n  url: string;\n  reconnect: boolean;\n  maxReconnectAttempts: number;\n  baseReconnectDelayMs: number;\n  pingIntervalMs: number;\n  pongTimeoutMs: number;\n}\n\nexport const WS_DEFAULT_CONFIG: WsConfig = {\n  url: wsUrl(LightconeEnv.Prod),\n  reconnect: true,\n  maxReconnectAttempts: 10,\n  baseReconnectDelayMs: 1_000,\n  pingIntervalMs: 30_000,\n  pongTimeoutMs: 10_000,\n};\n\nexport enum ReadyState {\n  Connecting = 0,\n  Open = 1,\n  Closing = 2,\n  Closed = 3,\n}\n\nexport function readyStateFrom(value: number): ReadyState {\n  switch (value) {\n    case 0:\n      return ReadyState.Connecting;\n    case 1:\n      return ReadyState.Open;\n    case 2:\n      return ReadyState.Closing;\n    case 3:\n    default:\n      return ReadyState.Closed;\n  }\n}\n\nexport function ping(): MessageOut {\n  return { method: \"ping\" };\n}\n\n/**\n * Subscribe to book snapshots, optionally aggregated (Hyperliquid-style).\n *\n * Omit `aggregation` for the raw book. The aggregation is normalized before\n * sending ((5, none) → (5, 1)); validate with `validateAggregation` first —\n * invalid combinations are rejected server-side with\n * `INVALID_ORDERBOOK_SUBSCRIPTION`. `undefined` fields are dropped by\n * `JSON.stringify`, so full precision stays byte-identical to the\n * pre-aggregation message.\n */\nexport function subscribeBooks(\n  orderbookIds: OrderBookId[],\n  aggregation: BookAggregation = FULL_PRECISION\n): MessageOut {\n  const sorted = [...orderbookIds].sort();\n  const normalized = normalizeAggregation(aggregation);\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"book_update\",\n      orderbook_ids: sorted,\n      nSigFigs: normalized.nSigFigs,\n      mantissa: normalized.mantissa,\n    },\n  };\n}\n\n/**\n * Unsubscribe a book subscription. The aggregation must match the one\n * subscribed (normalized) or the server removes nothing.\n */\nexport function unsubscribeBooks(\n  orderbookIds: OrderBookId[],\n  aggregation: BookAggregation = FULL_PRECISION\n): MessageOut {\n  const sorted = [...orderbookIds].sort();\n  const normalized = normalizeAggregation(aggregation);\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"book_update\",\n      orderbook_ids: sorted,\n      nSigFigs: normalized.nSigFigs,\n      mantissa: normalized.mantissa,\n    },\n  };\n}\n\nexport function subscribeTrades(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"trades\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function unsubscribeTrades(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"trades\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function subscribeUser(walletAddress: PubkeyStr): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"user\",\n      wallet_address: walletAddress,\n    },\n  };\n}\n\nexport function unsubscribeUser(walletAddress: PubkeyStr): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"user\",\n      wallet_address: walletAddress,\n    },\n  };\n}\n\n/**\n * Subscribe to a wallet owned by the authenticated user.\n * The channel begins with a complete replacement snapshot and then emits\n * absolute SPL/native updates plus non-mutating status events.\n */\nexport function subscribeWalletDepositBalances(\n  walletAddress: PubkeyStr\n): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"wallet_deposit_balances\",\n      wallet_address: walletAddress,\n    },\n  };\n}\n\n/**\n * Stop the authenticated wallet stream identified by this exact wallet address.\n * This wire operation is separate from clearing local reconnect tracking.\n */\nexport function unsubscribeWalletDepositBalances(\n  walletAddress: PubkeyStr\n): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"wallet_deposit_balances\",\n      wallet_address: walletAddress,\n    },\n  };\n}\n\nexport function subscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"price_history\",\n      orderbook_id: orderbookId,\n      resolution,\n      include_ohlcv: false,\n    },\n  };\n}\n\nexport function unsubscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"price_history\",\n      orderbook_id: orderbookId,\n      resolution,\n    },\n  };\n}\n\nexport function subscribeTicker(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"ticker\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function unsubscribeTicker(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"ticker\",\n      orderbook_ids: [...orderbookIds].sort(),\n    },\n  };\n}\n\nexport function subscribeMarket(marketPubkey: PubkeyStr): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"market\",\n      market_pubkey: marketPubkey,\n    },\n  };\n}\n\nexport function unsubscribeMarket(marketPubkey: PubkeyStr): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"market\",\n      market_pubkey: marketPubkey,\n    },\n  };\n}\n\nexport function subscribeDepositPrice(depositAsset: string, resolution: Resolution): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"deposit_price\",\n      deposit_asset: depositAsset,\n      resolution,\n    },\n  };\n}\n\nexport function unsubscribeDepositPrice(depositAsset: string, resolution: Resolution): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"deposit_price\",\n      deposit_asset: depositAsset,\n      resolution,\n    },\n  };\n}\n\n/**\n * Subscribe to the live spot price for one deposit asset (snapshot +\n * per-asset price ticks). Distinct from `subscribeDepositPrice`, which\n * carries OHLCV candles per resolution.\n */\nexport function subscribeDepositAssetPrice(depositAsset: string): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: { type: \"deposit_asset_price\", deposit_asset: depositAsset },\n  };\n}\n\nexport function unsubscribeDepositAssetPrice(depositAsset: string): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: { type: \"deposit_asset_price\", deposit_asset: depositAsset },\n  };\n}\n\nconst VALID_MESSAGE_TYPES = new Set([\n  \"book_update\",\n  \"pong\",\n  \"user\",\n  \"error\",\n  \"price_history\",\n  \"trades\",\n  \"auth\",\n  \"ticker\",\n  \"market\",\n  \"deposit_price\",\n  \"deposit_asset_price\",\n  \"wallet_deposit_balances\",\n]);\n\n/**\n * Parse and normalize one inbound frame.\n *\n * Wallet-balance payloads cross a runtime validation boundary here: malformed\n * nested discriminators, exact values, or slots throw a protocol `WsError`\n * instead of escaping behind TypeScript-only types.\n */\nexport function parseMessageIn(input: string): MessageIn {\n  const parsed: unknown = parseJsonExact(input);\n  if (typeof parsed !== \"object\" || parsed === null || !(\"type\" in parsed)) {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message: missing \"type\" field`);\n  }\n  const obj = parsed as Record<string, unknown>;\n  if (typeof obj.type !== \"string\" || !VALID_MESSAGE_TYPES.has(obj.type)) {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message type: \"${String(obj.type)}\"`);\n  }\n  if (!(\"version\" in obj) || typeof obj.version !== \"number\") {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message: missing or invalid \"version\" field`);\n  }\n  if (!(\"data\" in obj) || typeof obj.data !== \"object\" || obj.data === null) {\n    throw new WsErrorClass(\"ProtocolError\", `Invalid WS message: missing or invalid \"data\" field`);\n  }\n  let message = parsed as MessageIn;\n  if (message.type === \"book_update\") {\n    const data = message.data as unknown as Record<string, unknown>;\n    const seq = data.seq;\n    if ((typeof seq !== \"number\" && typeof seq !== \"bigint\") ||\n        (typeof seq === \"number\" && (!Number.isSafeInteger(seq) || seq < 0)) ||\n        (typeof seq === \"bigint\" && seq < 0n)) {\n      throw new WsErrorClass(\"ProtocolError\", \"Invalid book_update seq\");\n    }\n    // Validate only populated level arrays so existing empty/resync frame\n    // tolerance is unchanged while exact quote liquidity cannot be omitted.\n    for (const side of [\"bids\", \"asks\"] as const) {\n      const levels = data[side];\n      if (!Array.isArray(levels)) continue;\n      for (const level of levels) {\n        if (\n          typeof level !== \"object\" ||\n          level === null ||\n          Array.isArray(level) ||\n          typeof (level as Record<string, unknown>).quote_notional !== \"string\"\n        ) {\n          throw new WsErrorClass(\n            \"ProtocolError\",\n            `Invalid book_update ${side} level: missing or invalid quote_notional`,\n          );\n        }\n      }\n    }\n    message = {\n      ...message,\n      data: { ...message.data, seq: BigInt(seq) },\n    };\n  }\n  if (message.type === \"user\") {\n    return {\n      ...message,\n      data: normalizeUserUpdate(message.data as Parameters<typeof normalizeUserUpdate>[0]),\n    };\n  }\n  if (message.type === \"wallet_deposit_balances\") {\n    return {\n      ...message,\n      data: normalizeWalletDepositBalancesEvent(message.data),\n    };\n  }\n  return message;\n}\n\n/** Validate the nested wallet event before exposing its discriminated union. */\nfunction normalizeWalletDepositBalancesEvent(\n  input: unknown\n): WalletDepositBalancesEvent {\n  const data = requireObject(input, \"wallet_deposit_balances data\");\n  const eventType = requireString(data, \"event_type\");\n  const walletAddress = requireString(data, \"wallet_address\") as PubkeyStr;\n\n  switch (eventType) {\n    case \"wallet_deposit_balance_snapshot\": {\n      const rawBalances = requireObject(data.balances, \"balances\");\n      const balances = {} as Record<PubkeyStr, DepositTokenBalance>;\n      for (const [mint, balance] of Object.entries(rawBalances)) {\n        balances[mint as PubkeyStr] = normalizeDepositTokenBalance(balance);\n      }\n      return {\n        event_type: eventType,\n        wallet_address: walletAddress,\n        context_slot: requireContextSlot(data),\n        balances,\n        native_sol_balance: requireNativeSolBalance(data),\n      };\n    }\n    case \"wallet_deposit_balance_update\":\n      return {\n        event_type: eventType,\n        wallet_address: walletAddress,\n        context_slot: requireContextSlot(data),\n        balance: normalizeDepositTokenBalance(data.balance),\n      };\n    case \"wallet_native_sol_balance_update\":\n      return {\n        event_type: eventType,\n        wallet_address: walletAddress,\n        context_slot: requireContextSlot(data),\n        native_sol_balance: requireNativeSolBalance(data),\n      };\n    case \"wallet_deposit_balance_status\": {\n      const status = requireString(data, \"status\");\n      if (status !== \"reconnecting\" && status !== \"metadata_unavailable\") {\n        throw protocolError(`Invalid wallet balance status: \"${status}\"`);\n      }\n      return {\n        event_type: eventType,\n        wallet_address: walletAddress,\n        status,\n        code: requireString(data, \"code\"),\n      };\n    }\n    default:\n      throw protocolError(`Invalid wallet balance event type: \"${eventType}\"`);\n  }\n}\n\n/** Preserve exact strings and nullable icons while rejecting incomplete balances. */\nfunction normalizeDepositTokenBalance(input: unknown): DepositTokenBalance {\n  const balance = requireObject(input, \"deposit-token balance\");\n  const normalized: DepositTokenBalance = {\n    mint: requireString(balance, \"mint\") as PubkeyStr,\n    idle: requireString(balance, \"idle\"),\n    symbol: requireString(balance, \"symbol\"),\n    name: requireString(balance, \"name\"),\n  };\n  for (const field of [\"icon_url_low\", \"icon_url_medium\", \"icon_url_high\"] as const) {\n    const value = balance[field];\n    if (value !== undefined) {\n      if (value !== null && typeof value !== \"string\") {\n        throw protocolError(`Invalid deposit-token balance ${field}`);\n      }\n      normalized[field] = value;\n    }\n  }\n  return normalized;\n}\n\nfunction requireObject(input: unknown, field: string): Record<string, unknown> {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw protocolError(`Invalid ${field}: expected object`);\n  }\n  return input as Record<string, unknown>;\n}\n\nfunction requireString(data: Record<string, unknown>, field: string): string {\n  const value = data[field];\n  if (typeof value !== \"string\") {\n    throw protocolError(`Invalid wallet balance ${field}: expected string`);\n  }\n  return value;\n}\n\nfunction requireNativeSolBalance(data: Record<string, unknown>): string {\n  // Canonical nine-place syntax maps directly to lamports without rounding or exponents.\n  const value = requireString(data, \"native_sol_balance\");\n  if (!/^(?:0|[1-9][0-9]*)\\.[0-9]{9}$/.test(value)) {\n    throw protocolError(\n      \"Invalid wallet balance native_sol_balance: expected exactly nine decimal places\"\n    );\n  }\n  return value;\n}\n\nfunction requireContextSlot(data: Record<string, unknown>): number {\n  // Safe integers prevent precision loss when state compares JavaScript slots.\n  const value = data.context_slot;\n  if (!Number.isSafeInteger(value) || (value as number) < 0) {\n    throw protocolError(\"Invalid wallet balance context_slot\");\n  }\n  return value as number;\n}\n\nfunction protocolError(message: string): WsErrorClass {\n  return new WsErrorClass(\"ProtocolError\", message);\n}\n"]}

package/dist/ws/subscriptions.d.ts

@@ -5,7 +5,8 @@ import type { OrderBookId, PubkeyStr, Resolution } from "../shared";
  * backend rejects unknown/snake_case params). Each `(orderbook, aggregation)`
  * pair is a distinct subscription: one connection may hold multiple
  * aggregation views of the same orderbook, and unsubscribe must repeat the
- * same (normalized) aggregation to match.
+ * same (normalized) aggregation to match. The wallet-balance variant is an
+ * authenticated wallet identity whose tracked subscription replays on reconnect.
  */
 export type SubscribeParams = {
     type: "book_update";
@@ -18,6 +19,9 @@ export type SubscribeParams = {
 } | {
     type: "user";
     wallet_address: PubkeyStr;
+} | {
+    type: "wallet_deposit_balances";
+    wallet_address: PubkeyStr;
 } | {
     type: "price_history";
     orderbook_id: OrderBookId;
@@ -37,6 +41,7 @@ export type SubscribeParams = {
     type: "deposit_asset_price";
     deposit_asset: string;
 };
+/** Wire unsubscribe identities; wallet streams must repeat the exact wallet. */
 export type UnsubscribeParams = {
     type: "book_update";
     orderbook_ids: OrderBookId[];
@@ -48,6 +53,9 @@ export type UnsubscribeParams = {
 } | {
     type: "user";
     wallet_address: PubkeyStr;
+} | {
+    type: "wallet_deposit_balances";
+    wallet_address: PubkeyStr;
 } | {
     type: "price_history";
     orderbook_id: OrderBookId;
@@ -72,6 +80,9 @@ export interface Subscription {
     matchesUnsubscribe(unsubscribe: UnsubscribeParams): boolean;
     subscriptionKey(): string;
 }
+export declare function isAuthedSubscriptionParams(params: SubscribeParams | UnsubscribeParams): boolean;
+/** Stable deduplication and reconnect-replay identity for one subscription. */
 export declare function subscriptionKey(params: SubscribeParams): string;
+/** Match a wire unsubscribe against locally tracked replay state. */
 export declare function unsubscribeMatches(subscribe: SubscribeParams, unsubscribe: UnsubscribeParams): boolean;
 //# sourceMappingURL=subscriptions.d.ts.map

package/dist/ws/subscriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/ws/subscriptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,SAAS,CAAA;CAAE,GAC3C;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,SAAS,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,iBAAiB,IAAI,eAAe,CAAC;IACrC,mBAAmB,IAAI,iBAAiB,CAAC;IACzC,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC5D,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAyB/D;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAyCT"}
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/ws/subscriptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpE;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,SAAS,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,cAAc,EAAE,SAAS,CAAA;CAAE,GAC9D;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,SAAS,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,cAAc,EAAE,SAAS,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,iBAAiB,IAAI,eAAe,CAAC;IACrC,mBAAmB,IAAI,iBAAiB,CAAC;IACzC,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC5D,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,eAAe,GAAG,iBAAiB,GAC1C,OAAO,CAGT;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA2B/D;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CA2CT"}

package/dist/ws/subscriptions.js

@@ -1,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAuthedSubscriptionParams = isAuthedSubscriptionParams;
 exports.subscriptionKey = subscriptionKey;
 exports.unsubscribeMatches = unsubscribeMatches;
 const aggregation_1 = require("../domain/orderbook/aggregation");
+function isAuthedSubscriptionParams(params) {
+    // Classification drives logout cleanup; it does not itself prove authentication.
+    return params.type === "user" || params.type === "wallet_deposit_balances";
+}
+/** Stable deduplication and reconnect-replay identity for one subscription. */
 function subscriptionKey(params) {
     switch (params.type) {
         case "book_update": {
@@ -17,6 +23,8 @@ function subscriptionKey(params) {
             return `trades:${idsKey(params.orderbook_ids)}`;
         case "user":
             return `user:${params.wallet_address}`;
+        case "wallet_deposit_balances":
+            return `wallet_deposit_balances:${params.wallet_address}`;
         case "price_history":
             return `price_history:${params.orderbook_id}:${params.resolution}`;
         case "ticker":
@@ -29,6 +37,7 @@ function subscriptionKey(params) {
             return `deposit_asset_price:${params.deposit_asset}`;
     }
 }
+/** Match a wire unsubscribe against locally tracked replay state. */
 function unsubscribeMatches(subscribe, unsubscribe) {
     if (subscribe.type !== unsubscribe.type) {
         return false;
@@ -45,6 +54,8 @@ function unsubscribeMatches(subscribe, unsubscribe) {
             return idsKey(subscribe.orderbook_ids) === idsKey(unsubscribe.orderbook_ids);
         case "user":
             return subscribe.wallet_address === unsubscribe.wallet_address;
+        case "wallet_deposit_balances":
+            return subscribe.wallet_address === unsubscribe.wallet_address;
         case "price_history":
             return (subscribe.orderbook_id === unsubscribe.orderbook_id &&
                 subscribe.resolution === unsubscribe.resolution);

package/dist/ws/subscriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/ws/subscriptions.ts"],"names":[],"mappings":";;AAyDA,0CAyBC;AAED,gDA4CC;AAhID,iEAIyC;AAqDzC,SAAgB,eAAe,CAAC,MAAuB;IACrD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,WAAW,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7E,iEAAiE;YACjE,gDAAgD;YAChD,OAAO,IAAA,6BAAe,EAAC,WAAW,CAAC;gBACjC,CAAC,CAAC,QAAQ,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;gBACxC,CAAC,CAAC,QAAQ,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,IAAA,kCAAoB,EAAC,WAAW,CAAC,EAAE,CAAC;QAClF,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,UAAU,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAClD,KAAK,MAAM;YACT,OAAO,QAAQ,MAAM,CAAC,cAAc,EAAE,CAAC;QACzC,KAAK,eAAe;YAClB,OAAO,iBAAiB,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACrE,KAAK,QAAQ;YACX,OAAO,UAAU,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAClD,KAAK,QAAQ;YACX,OAAO,UAAU,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1C,KAAK,eAAe;YAClB,OAAO,iBAAiB,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtE,KAAK,qBAAqB;YACxB,OAAO,uBAAuB,MAAM,CAAC,aAAa,EAAE,CAAC;IACzD,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAChC,SAA0B,EAC1B,WAA8B;IAE9B,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,gBAAgB,GAAG,WAIxB,CAAC;YACF,OAAO,CACL,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC;gBAC1E,IAAA,+BAAiB,EACf,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,EAC9D,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAC7E,CACF,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,MAAM,CAAE,WAAgD,CAAC,aAAa,CAAC,CAAC;QACrH,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,MAAM,CAAE,WAAgD,CAAC,aAAa,CAAC,CAAC;QACrH,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,cAAc,KAAM,WAA6C,CAAC,cAAc,CAAC;QACpG,KAAK,eAAe;YAClB,OAAO,CACL,SAAS,CAAC,YAAY,KAAM,WAA6C,CAAC,YAAY;gBACtF,SAAS,CAAC,UAAU,KAAM,WAA0C,CAAC,UAAU,CAChF,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,aAAa,KAAM,WAA4C,CAAC,aAAa,CAAC;QACjG,KAAK,eAAe;YAClB,OAAO,CACL,SAAS,CAAC,aAAa,KAAM,WAAyC,CAAC,aAAa;gBACpF,SAAS,CAAC,UAAU,KAAM,WAA0C,CAAC,UAAU,CAChF,CAAC;QACJ,KAAK,qBAAqB;YACxB,OAAO,SAAS,CAAC,aAAa,KAAM,WAAyC,CAAC,aAAa,CAAC;IAChG,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,GAAsB;IACpC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import {\n  aggregationKeySuffix,\n  aggregationsEqual,\n  isFullPrecision,\n} from \"../domain/orderbook/aggregation\";\nimport type { OrderBookId, PubkeyStr, Resolution } from \"../shared\";\n\n/**\n * Book subscriptions optionally carry a Hyperliquid-style aggregation\n * (`nSigFigs`/`mantissa`, wire spelling — omit both for full precision; the\n * backend rejects unknown/snake_case params). Each `(orderbook, aggregation)`\n * pair is a distinct subscription: one connection may hold multiple\n * aggregation views of the same orderbook, and unsubscribe must repeat the\n * same (normalized) aggregation to match.\n */\nexport type SubscribeParams =\n  | {\n      type: \"book_update\";\n      orderbook_ids: OrderBookId[];\n      nSigFigs?: number;\n      mantissa?: number;\n    }\n  | { type: \"trades\"; orderbook_ids: OrderBookId[] }\n  | { type: \"user\"; wallet_address: PubkeyStr }\n  | {\n      type: \"price_history\";\n      orderbook_id: OrderBookId;\n      resolution: Resolution;\n      include_ohlcv?: boolean;\n    }\n  | { type: \"ticker\"; orderbook_ids: OrderBookId[] }\n  | { type: \"market\"; market_pubkey: PubkeyStr }\n  | { type: \"deposit_price\"; deposit_asset: string; resolution: Resolution }\n  | { type: \"deposit_asset_price\"; deposit_asset: string };\n\nexport type UnsubscribeParams =\n  | {\n      type: \"book_update\";\n      orderbook_ids: OrderBookId[];\n      nSigFigs?: number;\n      mantissa?: number;\n    }\n  | { type: \"trades\"; orderbook_ids: OrderBookId[] }\n  | { type: \"user\"; wallet_address: PubkeyStr }\n  | { type: \"price_history\"; orderbook_id: OrderBookId; resolution: Resolution }\n  | { type: \"ticker\"; orderbook_ids: OrderBookId[] }\n  | { type: \"market\"; market_pubkey: PubkeyStr }\n  | { type: \"deposit_price\"; deposit_asset: string; resolution: Resolution }\n  | { type: \"deposit_asset_price\"; deposit_asset: string };\n\nexport interface Subscription {\n  toSubscribeParams(): SubscribeParams;\n  toUnsubscribeParams(): UnsubscribeParams;\n  matchesUnsubscribe(unsubscribe: UnsubscribeParams): boolean;\n  subscriptionKey(): string;\n}\n\nexport function subscriptionKey(params: SubscribeParams): string {\n  switch (params.type) {\n    case \"book_update\": {\n      const aggregation = { nSigFigs: params.nSigFigs, mantissa: params.mantissa };\n      // Full precision keeps the pre-aggregation key shape so existing\n      // consumers' tracked subscriptions stay stable.\n      return isFullPrecision(aggregation)\n        ? `book:${idsKey(params.orderbook_ids)}`\n        : `book:${idsKey(params.orderbook_ids)}:${aggregationKeySuffix(aggregation)}`;\n    }\n    case \"trades\":\n      return `trades:${idsKey(params.orderbook_ids)}`;\n    case \"user\":\n      return `user:${params.wallet_address}`;\n    case \"price_history\":\n      return `price_history:${params.orderbook_id}:${params.resolution}`;\n    case \"ticker\":\n      return `ticker:${idsKey(params.orderbook_ids)}`;\n    case \"market\":\n      return `market:${params.market_pubkey}`;\n    case \"deposit_price\":\n      return `deposit_price:${params.deposit_asset}:${params.resolution}`;\n    case \"deposit_asset_price\":\n      return `deposit_asset_price:${params.deposit_asset}`;\n  }\n}\n\nexport function unsubscribeMatches(\n  subscribe: SubscribeParams,\n  unsubscribe: UnsubscribeParams\n): boolean {\n  if (subscribe.type !== unsubscribe.type) {\n    return false;\n  }\n\n  switch (subscribe.type) {\n    case \"book_update\": {\n      const unsubscribeBooks = unsubscribe as {\n        orderbook_ids: OrderBookId[];\n        nSigFigs?: number;\n        mantissa?: number;\n      };\n      return (\n        idsKey(subscribe.orderbook_ids) === idsKey(unsubscribeBooks.orderbook_ids) &&\n        aggregationsEqual(\n          { nSigFigs: subscribe.nSigFigs, mantissa: subscribe.mantissa },\n          { nSigFigs: unsubscribeBooks.nSigFigs, mantissa: unsubscribeBooks.mantissa }\n        )\n      );\n    }\n    case \"trades\":\n      return idsKey(subscribe.orderbook_ids) === idsKey((unsubscribe as { orderbook_ids: OrderBookId[] }).orderbook_ids);\n    case \"ticker\":\n      return idsKey(subscribe.orderbook_ids) === idsKey((unsubscribe as { orderbook_ids: OrderBookId[] }).orderbook_ids);\n    case \"user\":\n      return subscribe.wallet_address === (unsubscribe as { wallet_address: PubkeyStr }).wallet_address;\n    case \"price_history\":\n      return (\n        subscribe.orderbook_id === (unsubscribe as { orderbook_id: OrderBookId }).orderbook_id &&\n        subscribe.resolution === (unsubscribe as { resolution: Resolution }).resolution\n      );\n    case \"market\":\n      return subscribe.market_pubkey === (unsubscribe as { market_pubkey: PubkeyStr }).market_pubkey;\n    case \"deposit_price\":\n      return (\n        subscribe.deposit_asset === (unsubscribe as { deposit_asset: string }).deposit_asset &&\n        subscribe.resolution === (unsubscribe as { resolution: Resolution }).resolution\n      );\n    case \"deposit_asset_price\":\n      return subscribe.deposit_asset === (unsubscribe as { deposit_asset: string }).deposit_asset;\n  }\n}\n\nfunction idsKey(ids: readonly string[]): string {\n  return [...ids].sort().join(\",\");\n}\n"]}
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/ws/subscriptions.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  aggregationKeySuffix,\n  aggregationsEqual,\n  isFullPrecision,\n} from \"../domain/orderbook/aggregation\";\nimport type { OrderBookId, PubkeyStr, Resolution } from \"../shared\";\n\n/**\n * Book subscriptions optionally carry a Hyperliquid-style aggregation\n * (`nSigFigs`/`mantissa`, wire spelling — omit both for full precision; the\n * backend rejects unknown/snake_case params). Each `(orderbook, aggregation)`\n * pair is a distinct subscription: one connection may hold multiple\n * aggregation views of the same orderbook, and unsubscribe must repeat the\n * same (normalized) aggregation to match. The wallet-balance variant is an\n * authenticated wallet identity whose tracked subscription replays on reconnect.\n */\nexport type SubscribeParams =\n  | {\n      type: \"book_update\";\n      orderbook_ids: OrderBookId[];\n      nSigFigs?: number;\n      mantissa?: number;\n    }\n  | { type: \"trades\"; orderbook_ids: OrderBookId[] }\n  | { type: \"user\"; wallet_address: PubkeyStr }\n  | { type: \"wallet_deposit_balances\"; wallet_address: PubkeyStr }\n  | {\n      type: \"price_history\";\n      orderbook_id: OrderBookId;\n      resolution: Resolution;\n      include_ohlcv?: boolean;\n    }\n  | { type: \"ticker\"; orderbook_ids: OrderBookId[] }\n  | { type: \"market\"; market_pubkey: PubkeyStr }\n  | { type: \"deposit_price\"; deposit_asset: string; resolution: Resolution }\n  | { type: \"deposit_asset_price\"; deposit_asset: string };\n\n/** Wire unsubscribe identities; wallet streams must repeat the exact wallet. */\nexport type UnsubscribeParams =\n  | {\n      type: \"book_update\";\n      orderbook_ids: OrderBookId[];\n      nSigFigs?: number;\n      mantissa?: number;\n    }\n  | { type: \"trades\"; orderbook_ids: OrderBookId[] }\n  | { type: \"user\"; wallet_address: PubkeyStr }\n  | { type: \"wallet_deposit_balances\"; wallet_address: PubkeyStr }\n  | { type: \"price_history\"; orderbook_id: OrderBookId; resolution: Resolution }\n  | { type: \"ticker\"; orderbook_ids: OrderBookId[] }\n  | { type: \"market\"; market_pubkey: PubkeyStr }\n  | { type: \"deposit_price\"; deposit_asset: string; resolution: Resolution }\n  | { type: \"deposit_asset_price\"; deposit_asset: string };\n\nexport interface Subscription {\n  toSubscribeParams(): SubscribeParams;\n  toUnsubscribeParams(): UnsubscribeParams;\n  matchesUnsubscribe(unsubscribe: UnsubscribeParams): boolean;\n  subscriptionKey(): string;\n}\n\nexport function isAuthedSubscriptionParams(\n  params: SubscribeParams | UnsubscribeParams\n): boolean {\n  // Classification drives logout cleanup; it does not itself prove authentication.\n  return params.type === \"user\" || params.type === \"wallet_deposit_balances\";\n}\n\n/** Stable deduplication and reconnect-replay identity for one subscription. */\nexport function subscriptionKey(params: SubscribeParams): string {\n  switch (params.type) {\n    case \"book_update\": {\n      const aggregation = { nSigFigs: params.nSigFigs, mantissa: params.mantissa };\n      // Full precision keeps the pre-aggregation key shape so existing\n      // consumers' tracked subscriptions stay stable.\n      return isFullPrecision(aggregation)\n        ? `book:${idsKey(params.orderbook_ids)}`\n        : `book:${idsKey(params.orderbook_ids)}:${aggregationKeySuffix(aggregation)}`;\n    }\n    case \"trades\":\n      return `trades:${idsKey(params.orderbook_ids)}`;\n    case \"user\":\n      return `user:${params.wallet_address}`;\n    case \"wallet_deposit_balances\":\n      return `wallet_deposit_balances:${params.wallet_address}`;\n    case \"price_history\":\n      return `price_history:${params.orderbook_id}:${params.resolution}`;\n    case \"ticker\":\n      return `ticker:${idsKey(params.orderbook_ids)}`;\n    case \"market\":\n      return `market:${params.market_pubkey}`;\n    case \"deposit_price\":\n      return `deposit_price:${params.deposit_asset}:${params.resolution}`;\n    case \"deposit_asset_price\":\n      return `deposit_asset_price:${params.deposit_asset}`;\n  }\n}\n\n/** Match a wire unsubscribe against locally tracked replay state. */\nexport function unsubscribeMatches(\n  subscribe: SubscribeParams,\n  unsubscribe: UnsubscribeParams\n): boolean {\n  if (subscribe.type !== unsubscribe.type) {\n    return false;\n  }\n\n  switch (subscribe.type) {\n    case \"book_update\": {\n      const unsubscribeBooks = unsubscribe as {\n        orderbook_ids: OrderBookId[];\n        nSigFigs?: number;\n        mantissa?: number;\n      };\n      return (\n        idsKey(subscribe.orderbook_ids) === idsKey(unsubscribeBooks.orderbook_ids) &&\n        aggregationsEqual(\n          { nSigFigs: subscribe.nSigFigs, mantissa: subscribe.mantissa },\n          { nSigFigs: unsubscribeBooks.nSigFigs, mantissa: unsubscribeBooks.mantissa }\n        )\n      );\n    }\n    case \"trades\":\n      return idsKey(subscribe.orderbook_ids) === idsKey((unsubscribe as { orderbook_ids: OrderBookId[] }).orderbook_ids);\n    case \"ticker\":\n      return idsKey(subscribe.orderbook_ids) === idsKey((unsubscribe as { orderbook_ids: OrderBookId[] }).orderbook_ids);\n    case \"user\":\n      return subscribe.wallet_address === (unsubscribe as { wallet_address: PubkeyStr }).wallet_address;\n    case \"wallet_deposit_balances\":\n      return subscribe.wallet_address === (unsubscribe as { wallet_address: PubkeyStr }).wallet_address;\n    case \"price_history\":\n      return (\n        subscribe.orderbook_id === (unsubscribe as { orderbook_id: OrderBookId }).orderbook_id &&\n        subscribe.resolution === (unsubscribe as { resolution: Resolution }).resolution\n      );\n    case \"market\":\n      return subscribe.market_pubkey === (unsubscribe as { market_pubkey: PubkeyStr }).market_pubkey;\n    case \"deposit_price\":\n      return (\n        subscribe.deposit_asset === (unsubscribe as { deposit_asset: string }).deposit_asset &&\n        subscribe.resolution === (unsubscribe as { resolution: Resolution }).resolution\n      );\n    case \"deposit_asset_price\":\n      return subscribe.deposit_asset === (unsubscribe as { deposit_asset: string }).deposit_asset;\n  }\n}\n\nfunction idsKey(ids: readonly string[]): string {\n  return [...ids].sort().join(\",\");\n}\n"]}

package/dist/ws/types.d.ts

@@ -19,6 +19,11 @@ export interface IWsClient {
     isConnected(): boolean;
     readyState(): ReadyState;
     restartConnection(): Promise<void>;
+    /**
+     * Purge User/wallet replay tracking and queued authenticated messages.
+     * Public subscriptions remain. This does not unsubscribe an open server
+     * stream, so callers must also send unsubscribe or disconnect on logout.
+     */
     clearAuthedSubscriptions(): void;
     on(callback: (event: WsEvent) => void): () => void;
 }

package/dist/ws/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ws/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,WAAW,IAAI,OAAO,CAAC;IACvB,UAAU,IAAI,UAAU,CAAC;IACzB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,wBAAwB,IAAI,IAAI,CAAC;IACjC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACpD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ws/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,WAAW,IAAI,OAAO,CAAC;IACvB,UAAU,IAAI,UAAU,CAAC;IACzB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC;;;;OAIG;IACH,wBAAwB,IAAI,IAAI,CAAC;IACjC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACpD"}

package/dist/ws/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ws/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { MessageOut, ReadyState, WsEvent } from \"./index\";\nimport type { SubscribeParams, UnsubscribeParams } from \"./subscriptions\";\n\n/**\n * Shared interface for WebSocket clients.\n *\n * Two implementations exist:\n * - `client.node.ts`    — Node.js, backed by the `ws` npm module\n * - `client.browser.ts` — Browser, backed by native `globalThis.WebSocket`\n *\n * The active implementation is selected at build time via the `\"browser\"`\n * field in package.json.\n */\nexport interface IWsClient {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(message: MessageOut): void;\n  subscribe(params: SubscribeParams): void;\n  unsubscribe(params: UnsubscribeParams): void;\n  isConnected(): boolean;\n  readyState(): ReadyState;\n  restartConnection(): Promise<void>;\n  clearAuthedSubscriptions(): void;\n  on(callback: (event: WsEvent) => void): () => void;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ws/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { MessageOut, ReadyState, WsEvent } from \"./index\";\nimport type { SubscribeParams, UnsubscribeParams } from \"./subscriptions\";\n\n/**\n * Shared interface for WebSocket clients.\n *\n * Two implementations exist:\n * - `client.node.ts`    — Node.js, backed by the `ws` npm module\n * - `client.browser.ts` — Browser, backed by native `globalThis.WebSocket`\n *\n * The active implementation is selected at build time via the `\"browser\"`\n * field in package.json.\n */\nexport interface IWsClient {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(message: MessageOut): void;\n  subscribe(params: SubscribeParams): void;\n  unsubscribe(params: UnsubscribeParams): void;\n  isConnected(): boolean;\n  readyState(): ReadyState;\n  restartConnection(): Promise<void>;\n  /**\n   * Purge User/wallet replay tracking and queued authenticated messages.\n   * Public subscriptions remain. This does not unsubscribe an open server\n   * stream, so callers must also send unsubscribe or disconnect on logout.\n   */\n  clearAuthedSubscriptions(): void;\n  on(callback: (event: WsEvent) => void): () => void;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightconexyz/lightcone-sdk",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "TypeScript SDK for Lightcone",
   "author": "Lightcone",
   "license": "MIT",
@@ -40,6 +40,7 @@
   "dependencies": {
     "@solana/spl-token": "^0.4.14",
     "@solana/web3.js": "^1.90.0",
+    "@noble/hashes": "^1.8.0",
     "bs58": "^5.0.0",
     "decimal.js": "^10.6.0",
     "js-sha3": "^0.9.3",