@lightconexyz/lightcone-sdk 0.1.0 → 0.2.1

package/dist/ws/index.d.ts

@@ -0,0 +1,110 @@
+import type { MarketEvent } from "../domain/market";
+import type { AuthUpdate, UserUpdate } from "../domain/order";
+import type { OrderBook, WsTickerData } from "../domain/orderbook";
+import type { PriceHistory } from "../domain/price_history";
+import type { WsTrade } from "../domain/trade";
+import type { OrderBookId, PubkeyStr, Resolution } from "../shared";
+export * from "./client.node";
+export * from "./subscriptions";
+export type { IWsClient } from "./types";
+export type MessageOut = {
+    method: "subscribe";
+    params: import("./subscriptions").SubscribeParams;
+} | {
+    method: "unsubscribe";
+    params: import("./subscriptions").UnsubscribeParams;
+} | {
+    method: "ping";
+};
+export type MessageIn = {
+    type: "book_update";
+    version: number;
+    data: OrderBook;
+} | {
+    type: "pong";
+    version: number;
+    data: Record<string, never>;
+} | {
+    type: "user";
+    version: number;
+    data: UserUpdate;
+} | {
+    type: "error";
+    version: number;
+    data: WsError;
+} | {
+    type: "price_history";
+    version: number;
+    data: PriceHistory;
+} | {
+    type: "trades";
+    version: number;
+    data: WsTrade;
+} | {
+    type: "auth";
+    version: number;
+    data: AuthUpdate;
+} | {
+    type: "ticker";
+    version: number;
+    data: WsTickerData;
+} | {
+    type: "market";
+    version: number;
+    data: MarketEvent;
+};
+export type Kind = MessageIn;
+export interface WsError {
+    error: string;
+    code?: string;
+    orderbook_id?: string;
+    wallet_address?: string;
+    hint?: string;
+    details?: string;
+}
+export type WsEvent = {
+    type: "Message";
+    message: MessageIn;
+} | {
+    type: "Connected";
+} | {
+    type: "Disconnected";
+    code?: number;
+    reason: string;
+} | {
+    type: "Error";
+    error: string;
+} | {
+    type: "MaxReconnectReached";
+};
+export interface WsConfig {
+    url: string;
+    reconnect: boolean;
+    maxReconnectAttempts: number;
+    baseReconnectDelayMs: number;
+    pingIntervalMs: number;
+    pongTimeoutMs: number;
+}
+export declare const WS_DEFAULT_CONFIG: WsConfig;
+export declare enum ReadyState {
+    Connecting = 0,
+    Open = 1,
+    Closing = 2,
+    Closed = 3
+}
+export declare function readyStateFrom(value: number): ReadyState;
+export declare function ping(): MessageOut;
+export declare function subscribeBooks(orderbookIds: OrderBookId[]): MessageOut;
+export declare function unsubscribeBooks(orderbookIds: OrderBookId[]): MessageOut;
+export declare function subscribeTrades(orderbookIds: OrderBookId[]): MessageOut;
+export declare function unsubscribeTrades(orderbookIds: OrderBookId[]): MessageOut;
+export declare function subscribeUser(walletAddress: PubkeyStr): MessageOut;
+export declare function unsubscribeUser(walletAddress: PubkeyStr): MessageOut;
+export declare function subscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut;
+export declare function unsubscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut;
+export declare function subscribeTicker(orderbookIds: OrderBookId[]): MessageOut;
+export declare function unsubscribeTicker(orderbookIds: OrderBookId[]): MessageOut;
+export declare function subscribeMarket(marketPubkey: PubkeyStr): MessageOut;
+export declare function unsubscribeMarket(marketPubkey: PubkeyStr): MessageOut;
+export declare function parseMessageIn(input: string): MessageIn;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/ws/index.js

@@ -0,0 +1,181 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadyState = exports.WS_DEFAULT_CONFIG = void 0;
+exports.readyStateFrom = readyStateFrom;
+exports.ping = ping;
+exports.subscribeBooks = subscribeBooks;
+exports.unsubscribeBooks = unsubscribeBooks;
+exports.subscribeTrades = subscribeTrades;
+exports.unsubscribeTrades = unsubscribeTrades;
+exports.subscribeUser = subscribeUser;
+exports.unsubscribeUser = unsubscribeUser;
+exports.subscribePriceHistory = subscribePriceHistory;
+exports.unsubscribePriceHistory = unsubscribePriceHistory;
+exports.subscribeTicker = subscribeTicker;
+exports.unsubscribeTicker = unsubscribeTicker;
+exports.subscribeMarket = subscribeMarket;
+exports.unsubscribeMarket = unsubscribeMarket;
+exports.parseMessageIn = parseMessageIn;
+const network_1 = require("../network");
+__exportStar(require("./client.node"), exports);
+__exportStar(require("./subscriptions"), exports);
+exports.WS_DEFAULT_CONFIG = {
+    url: network_1.DEFAULT_WS_URL,
+    reconnect: true,
+    maxReconnectAttempts: 10,
+    baseReconnectDelayMs: 1_000,
+    pingIntervalMs: 30_000,
+    pongTimeoutMs: 1_000,
+};
+var ReadyState;
+(function (ReadyState) {
+    ReadyState[ReadyState["Connecting"] = 0] = "Connecting";
+    ReadyState[ReadyState["Open"] = 1] = "Open";
+    ReadyState[ReadyState["Closing"] = 2] = "Closing";
+    ReadyState[ReadyState["Closed"] = 3] = "Closed";
+})(ReadyState || (exports.ReadyState = ReadyState = {}));
+function readyStateFrom(value) {
+    switch (value) {
+        case 0:
+            return ReadyState.Connecting;
+        case 1:
+            return ReadyState.Open;
+        case 2:
+            return ReadyState.Closing;
+        case 3:
+        default:
+            return ReadyState.Closed;
+    }
+}
+function ping() {
+    return { method: "ping" };
+}
+function subscribeBooks(orderbookIds) {
+    return {
+        method: "subscribe",
+        params: {
+            type: "book_update",
+            orderbook_ids: orderbookIds,
+        },
+    };
+}
+function unsubscribeBooks(orderbookIds) {
+    return {
+        method: "unsubscribe",
+        params: {
+            type: "book_update",
+            orderbook_ids: orderbookIds,
+        },
+    };
+}
+function subscribeTrades(orderbookIds) {
+    return {
+        method: "subscribe",
+        params: {
+            type: "trades",
+            orderbook_ids: orderbookIds,
+        },
+    };
+}
+function unsubscribeTrades(orderbookIds) {
+    return {
+        method: "unsubscribe",
+        params: {
+            type: "trades",
+            orderbook_ids: orderbookIds,
+        },
+    };
+}
+function subscribeUser(walletAddress) {
+    return {
+        method: "subscribe",
+        params: {
+            type: "user",
+            wallet_address: walletAddress,
+        },
+    };
+}
+function unsubscribeUser(walletAddress) {
+    return {
+        method: "unsubscribe",
+        params: {
+            type: "user",
+            wallet_address: walletAddress,
+        },
+    };
+}
+function subscribePriceHistory(orderbookId, resolution) {
+    return {
+        method: "subscribe",
+        params: {
+            type: "price_history",
+            orderbook_id: orderbookId,
+            resolution,
+            include_ohlcv: false,
+        },
+    };
+}
+function unsubscribePriceHistory(orderbookId, resolution) {
+    return {
+        method: "unsubscribe",
+        params: {
+            type: "price_history",
+            orderbook_id: orderbookId,
+            resolution,
+        },
+    };
+}
+function subscribeTicker(orderbookIds) {
+    return {
+        method: "subscribe",
+        params: {
+            type: "ticker",
+            orderbook_ids: orderbookIds,
+        },
+    };
+}
+function unsubscribeTicker(orderbookIds) {
+    return {
+        method: "unsubscribe",
+        params: {
+            type: "ticker",
+            orderbook_ids: orderbookIds,
+        },
+    };
+}
+function subscribeMarket(marketPubkey) {
+    return {
+        method: "subscribe",
+        params: {
+            type: "market",
+            market_pubkey: marketPubkey,
+        },
+    };
+}
+function unsubscribeMarket(marketPubkey) {
+    return {
+        method: "unsubscribe",
+        params: {
+            type: "market",
+            market_pubkey: marketPubkey,
+        },
+    };
+}
+function parseMessageIn(input) {
+    return JSON.parse(input);
+}
+//# sourceMappingURL=index.js.map

package/dist/ws/index.js.map

@@ -0,0 +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 type { AuthUpdate, UserUpdate } from \"../domain/order\";\nimport type { OrderBook, WsTickerData } from \"../domain/orderbook\";\nimport type { PriceHistory } from \"../domain/price_history\";\nimport type { WsTrade } from \"../domain/trade\";\nimport { DEFAULT_WS_URL } from \"../network\";\nimport type { OrderBookId, PubkeyStr, Resolution } from \"../shared\";\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\nexport type Kind = MessageIn;\n\nexport interface WsError {\n  error: string;\n  code?: string;\n  orderbook_id?: string;\n  wallet_address?: 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: DEFAULT_WS_URL,\n  reconnect: true,\n  maxReconnectAttempts: 10,\n  baseReconnectDelayMs: 1_000,\n  pingIntervalMs: 30_000,\n  pongTimeoutMs: 1_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\nexport function subscribeBooks(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"book_update\",\n      orderbook_ids: orderbookIds,\n    },\n  };\n}\n\nexport function unsubscribeBooks(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"book_update\",\n      orderbook_ids: orderbookIds,\n    },\n  };\n}\n\nexport function subscribeTrades(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"subscribe\",\n    params: {\n      type: \"trades\",\n      orderbook_ids: orderbookIds,\n    },\n  };\n}\n\nexport function unsubscribeTrades(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"trades\",\n      orderbook_ids: orderbookIds,\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,\n    },\n  };\n}\n\nexport function unsubscribeTicker(orderbookIds: OrderBookId[]): MessageOut {\n  return {\n    method: \"unsubscribe\",\n    params: {\n      type: \"ticker\",\n      orderbook_ids: orderbookIds,\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 parseMessageIn(input: string): MessageIn {\n  return JSON.parse(input) as MessageIn;\n}\n"]}

package/dist/ws/subscriptions.d.ts

@@ -0,0 +1,51 @@
+import type { OrderBookId, PubkeyStr, Resolution } from "../shared";
+export type SubscribeParams = {
+    type: "book_update";
+    orderbook_ids: OrderBookId[];
+} | {
+    type: "trades";
+    orderbook_ids: OrderBookId[];
+} | {
+    type: "user";
+    wallet_address: PubkeyStr;
+} | {
+    type: "price_history";
+    orderbook_id: OrderBookId;
+    resolution: Resolution;
+    include_ohlcv?: boolean;
+} | {
+    type: "ticker";
+    orderbook_ids: OrderBookId[];
+} | {
+    type: "market";
+    market_pubkey: PubkeyStr;
+};
+export type UnsubscribeParams = {
+    type: "book_update";
+    orderbook_ids: OrderBookId[];
+} | {
+    type: "trades";
+    orderbook_ids: OrderBookId[];
+} | {
+    type: "user";
+    wallet_address: PubkeyStr;
+} | {
+    type: "price_history";
+    orderbook_id: OrderBookId;
+    resolution: Resolution;
+} | {
+    type: "ticker";
+    orderbook_ids: OrderBookId[];
+} | {
+    type: "market";
+    market_pubkey: PubkeyStr;
+};
+export interface Subscription {
+    toSubscribeParams(): SubscribeParams;
+    toUnsubscribeParams(): UnsubscribeParams;
+    matchesUnsubscribe(unsubscribe: UnsubscribeParams): boolean;
+    subscriptionKey(): string;
+}
+export declare function subscriptionKey(params: SubscribeParams): string;
+export declare function unsubscribeMatches(subscribe: SubscribeParams, unsubscribe: UnsubscribeParams): boolean;
+//# sourceMappingURL=subscriptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/ws/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GACrD;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,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,WAAW,EAAE,CAAA;CAAE,GACrD;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,CAAC;AAEjD,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,CAe/D;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAsBT"}

package/dist/ws/subscriptions.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscriptionKey = subscriptionKey;
+exports.unsubscribeMatches = unsubscribeMatches;
+function subscriptionKey(params) {
+    switch (params.type) {
+        case "book_update":
+            return `book:${idsKey(params.orderbook_ids)}`;
+        case "trades":
+            return `trades:${idsKey(params.orderbook_ids)}`;
+        case "user":
+            return `user:${params.wallet_address}`;
+        case "price_history":
+            return `price_history:${params.orderbook_id}:${params.resolution}`;
+        case "ticker":
+            return `ticker:${idsKey(params.orderbook_ids)}`;
+        case "market":
+            return `market:${params.market_pubkey}`;
+    }
+}
+function unsubscribeMatches(subscribe, unsubscribe) {
+    if (subscribe.type !== unsubscribe.type) {
+        return false;
+    }
+    switch (subscribe.type) {
+        case "book_update":
+            return idsKey(subscribe.orderbook_ids) === idsKey(unsubscribe.orderbook_ids);
+        case "trades":
+            return idsKey(subscribe.orderbook_ids) === idsKey(unsubscribe.orderbook_ids);
+        case "ticker":
+            return idsKey(subscribe.orderbook_ids) === idsKey(unsubscribe.orderbook_ids);
+        case "user":
+            return subscribe.wallet_address === unsubscribe.wallet_address;
+        case "price_history":
+            return (subscribe.orderbook_id === unsubscribe.orderbook_id &&
+                subscribe.resolution === unsubscribe.resolution);
+        case "market":
+            return subscribe.market_pubkey === unsubscribe.market_pubkey;
+    }
+}
+function idsKey(ids) {
+    return [...ids].sort().join(",");
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/ws/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/ws/subscriptions.ts"],"names":[],"mappings":";;AA8BA,0CAeC;AAED,gDAyBC;AA1CD,SAAgB,eAAe,CAAC,MAAuB;IACrD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,aAAa;YAChB,OAAO,QAAQ,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChD,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;IAC5C,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;YAChB,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,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;IACnG,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 type { OrderBookId, PubkeyStr, Resolution } from \"../shared\";\n\nexport type SubscribeParams =\n  | { type: \"book_update\"; orderbook_ids: OrderBookId[] }\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\nexport type UnsubscribeParams =\n  | { type: \"book_update\"; orderbook_ids: OrderBookId[] }\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\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      return `book:${idsKey(params.orderbook_ids)}`;\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  }\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      return idsKey(subscribe.orderbook_ids) === idsKey((unsubscribe as { orderbook_ids: OrderBookId[] }).orderbook_ids);\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  }\n}\n\nfunction idsKey(ids: readonly string[]): string {\n  return [...ids].sort().join(\",\");\n}\n"]}

package/dist/ws/types.d.ts

@@ -0,0 +1,23 @@
+import type { MessageOut, ReadyState, WsEvent } from "./index";
+import type { SubscribeParams, UnsubscribeParams } from "./subscriptions";
+/**
+ * Shared interface for WebSocket clients.
+ *
+ * Two implementations exist:
+ * - `client.node.ts`    — Node.js, backed by the `ws` npm module
+ * - `client.browser.ts` — Browser, backed by native `globalThis.WebSocket`
+ *
+ * The active implementation is selected at build time via the `"browser"`
+ * field in package.json.
+ */
+export interface IWsClient {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: MessageOut): void;
+    subscribe(params: SubscribeParams): void;
+    unsubscribe(params: UnsubscribeParams): void;
+    isConnected(): boolean;
+    readyState(): ReadyState;
+    on(callback: (event: WsEvent) => void): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACpD"}

package/dist/ws/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/ws/types.js.map

@@ -0,0 +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  on(callback: (event: WsEvent) => void): () => void;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lightconexyz/lightcone-sdk",
-  "version": "0.1.0",
-  "description": "TypeScript SDK for the Lightcone Protocol",
+  "version": "0.2.1",
+  "description": "TypeScript SDK for Lightcone",
   "author": "Lightcone",
   "license": "MIT",
   "repository": {
@@ -24,19 +24,16 @@
       "default": "./dist/index.js"
     }
   },
+  "browser": {
+    "./dist/ws/client.node.js": "./dist/ws/client.browser.js"
+  },
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:legacy": "ts-node test/unit.test.ts",
-    "test:devnet": "ts-node test/devnet.test.ts",
-    "test:stress": "ts-node test/stress.test.ts",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run clean && npm run lint && npm run test && npm run build"
+    "prepublishOnly": "npm run clean && npm run lint && npm run typecheck && npm run build"
   },
   "dependencies": {
     "@solana/spl-token": "^0.4.14",
@@ -44,7 +41,9 @@
     "bs58": "^5.0.0",
     "decimal.js": "^10.6.0",
     "js-sha3": "^0.9.3",
-    "tweetnacl": "^1.0.3",
+    "tweetnacl": "^1.0.3"
+  },
+  "optionalDependencies": {
     "ws": "^8.0.0"
   },
   "devDependencies": {
@@ -53,9 +52,7 @@
     "@typescript-eslint/parser": "^7.0.0",
     "dotenv": "^17.2.3",
     "eslint": "^8.57.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3",
-    "vitest": "^1.6.0"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "@solana/web3.js": "^1.90.0"