@lightconexyz/lightcone-sdk 0.7.1 → 0.8.1-rc.3

package/dist/domain/orderbook/state.d.ts

@@ -1,54 +1,52 @@
 import type { OrderBookId } from "../../shared";
 import type { OrderBook } from "./wire";
+/**
+ * The `book_update` stream is snapshot-only: every data frame carries the
+ * full top-20 levels per side and replaces the previous book wholesale
+ * (last-write-wins). Consumers holding multiple aggregation views of one
+ * orderbook on the same connection key their `OrderbookState` instances by
+ * `(orderbook_id, aggregation)` using
+ * `aggregationFromFrame(book.n_sig_figs, book.mantissa)`.
+ */
 export type OrderbookApplyResult = {
     kind: "applied";
-} | {
-    kind: "ignored";
-    reason: OrderbookIgnoreReason;
 } | {
     kind: "refresh_required";
     reason: OrderbookRefreshReason;
 };
-export type OrderbookIgnoreReason = {
-    kind: "invalid_delta_sequence";
-    got: number;
-} | {
-    kind: "stale_delta";
-    current: number;
-    got: number;
-} | {
-    kind: "already_awaiting_snapshot";
-    got: number;
-};
-export type OrderbookRefreshReason = {
-    kind: "missing_snapshot";
-    got: number;
-} | {
-    kind: "sequence_gap";
-    expected: number;
-    got: number;
-} | {
+export type OrderbookRefreshReason = 
+/**
+ * The backend explicitly requested a resync: unsubscribe and re-subscribe
+ * with the same parameters (including aggregation) to receive a fresh
+ * snapshot.
+ */
+{
     kind: "server_resync";
-    got: number;
 };
 export declare class OrderbookState {
     readonly orderbookId: OrderBookId;
+    /**
+     * Projection version of the last applied frame. Strictly increasing but
+     * non-contiguous server-side (conflation skips versions), and the initial
+     * snapshot after every (re)subscribe is `seq: 0` — informational only,
+     * never used to gate frames.
+     */
     seq: number;
     private readonly bidsMap;
     private readonly asksMap;
     private cachedBestBid;
     private cachedBestAsk;
-    private hasSnapshot;
-    private awaitingSnapshot;
     constructor(orderbookId: OrderBookId);
     /**
-     * Apply a WS orderbook message (snapshot replaces, delta merges).
+     * Apply a WS orderbook frame (snapshot-only stream, last-write-wins).
      *
-     * Server resync messages take precedence and return `refresh_required`.
-     * Otherwise, snapshots are applied and deltas with a `seq` at or below the
-     * current value are ignored to prevent stale updates. Deltas that skip one
-     * or more expected sequence values are rejected so callers can refresh from
-     * a fresh snapshot instead of mutating a corrupted book.
+     * `resync` frames take precedence and leave the book untouched — the
+     * caller must re-subscribe with the same parameters. Every other data
+     * frame is a full snapshot by contract and replaces the book wholesale
+     * (the `is_snapshot` flag is not consulted), including the `seq: 0`
+     * initial snapshot delivered after every (re)subscribe: gating on `seq`
+     * would freeze the book after a resync or aggregation change, so `seq` is
+     * stored as informational only.
      */
     apply(book: OrderBook): OrderbookApplyResult;
     bids(): ReadonlyMap<string, string>;

package/dist/domain/orderbook/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,qBAAa,cAAc;IACzB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,WAAW,EAAE,WAAW;IAWpC;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,oBAAoB;IAkF5C,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,OAAO,IAAI,MAAM,GAAG,SAAS;IAe7B,OAAO,IAAI,MAAM,GAAG,SAAS;IAc7B,QAAQ,IAAI,MAAM,GAAG,SAAS;IAU9B,MAAM,IAAI,MAAM,GAAG,SAAS;IAU5B,OAAO,IAAI,OAAO;IAIlB,KAAK,IAAI,IAAI;CASd"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,sBAAsB;AAChC;;;;GAIG;AACH;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE5B,qBAAa,cAAc;IACzB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,aAAa,CAA4B;gBAErC,WAAW,EAAE,WAAW;IASpC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,oBAAoB;IA2B5C,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,OAAO,IAAI,MAAM,GAAG,SAAS;IAe7B,OAAO,IAAI,MAAM,GAAG,SAAS;IAc7B,QAAQ,IAAI,MAAM,GAAG,SAAS;IAU9B,MAAM,IAAI,MAAM,GAAG,SAAS;IAU5B,OAAO,IAAI,OAAO;IAIlB,KAAK,IAAI,IAAI;CAOd"}

package/dist/domain/orderbook/state.js

@@ -7,13 +7,17 @@ exports.OrderbookState = void 0;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 class OrderbookState {
     orderbookId;
+    /**
+     * Projection version of the last applied frame. Strictly increasing but
+     * non-contiguous server-side (conflation skips versions), and the initial
+     * snapshot after every (re)subscribe is `seq: 0` — informational only,
+     * never used to gate frames.
+     */
     seq;
     bidsMap;
     asksMap;
     cachedBestBid;
     cachedBestAsk;
-    hasSnapshot;
-    awaitingSnapshot;
     constructor(orderbookId) {
         this.orderbookId = orderbookId;
         this.seq = 0;
@@ -21,87 +25,38 @@ class OrderbookState {
         this.asksMap = new Map();
         this.cachedBestBid = null;
         this.cachedBestAsk = null;
-        this.hasSnapshot = false;
-        this.awaitingSnapshot = false;
     }
     /**
-     * Apply a WS orderbook message (snapshot replaces, delta merges).
+     * Apply a WS orderbook frame (snapshot-only stream, last-write-wins).
      *
-     * Server resync messages take precedence and return `refresh_required`.
-     * Otherwise, snapshots are applied and deltas with a `seq` at or below the
-     * current value are ignored to prevent stale updates. Deltas that skip one
-     * or more expected sequence values are rejected so callers can refresh from
-     * a fresh snapshot instead of mutating a corrupted book.
+     * `resync` frames take precedence and leave the book untouched — the
+     * caller must re-subscribe with the same parameters. Every other data
+     * frame is a full snapshot by contract and replaces the book wholesale
+     * (the `is_snapshot` flag is not consulted), including the `seq: 0`
+     * initial snapshot delivered after every (re)subscribe: gating on `seq`
+     * would freeze the book after a resync or aggregation change, so `seq` is
+     * stored as informational only.
      */
     apply(book) {
-        const seq = book.seq ?? 0;
         if (book.resync) {
-            this.awaitingSnapshot = true;
             return {
                 kind: "refresh_required",
-                reason: { kind: "server_resync", got: seq },
+                reason: { kind: "server_resync" },
             };
         }
-        if (book.is_snapshot) {
-            this.bidsMap.clear();
-            this.asksMap.clear();
-            this.hasSnapshot = true;
-            this.awaitingSnapshot = false;
-        }
-        else {
-            if (this.awaitingSnapshot) {
-                return {
-                    kind: "ignored",
-                    reason: { kind: "already_awaiting_snapshot", got: seq },
-                };
-            }
-            // The backend sends snapshots with seq=0 and starts delta seq at 1.
-            // A delta with seq=0 means it has no valid sequence, so drop it.
-            if (seq <= 0) {
-                return {
-                    kind: "ignored",
-                    reason: { kind: "invalid_delta_sequence", got: seq },
-                };
-            }
-            if (!this.hasSnapshot) {
-                this.awaitingSnapshot = true;
-                return {
-                    kind: "refresh_required",
-                    reason: { kind: "missing_snapshot", got: seq },
-                };
-            }
-            if (seq <= this.seq) {
-                return {
-                    kind: "ignored",
-                    reason: { kind: "stale_delta", current: this.seq, got: seq },
-                };
-            }
-            const expected = this.seq + 1;
-            if (seq !== expected) {
-                this.awaitingSnapshot = true;
-                return {
-                    kind: "refresh_required",
-                    reason: { kind: "sequence_gap", expected, got: seq },
-                };
-            }
-        }
-        this.seq = seq;
+        this.bidsMap.clear();
+        this.asksMap.clear();
         for (const level of book.bids) {
-            if (new decimal_js_1.default(level.size).isZero()) {
-                this.bidsMap.delete(level.price);
-            }
-            else {
+            if (!new decimal_js_1.default(level.size).isZero()) {
                 this.bidsMap.set(level.price, level.size);
             }
         }
         for (const level of book.asks) {
-            if (new decimal_js_1.default(level.size).isZero()) {
-                this.asksMap.delete(level.price);
-            }
-            else {
+            if (!new decimal_js_1.default(level.size).isZero()) {
                 this.asksMap.set(level.price, level.size);
             }
         }
+        this.seq = book.seq ?? 0;
         this.cachedBestBid = null;
         this.cachedBestAsk = null;
         return { kind: "applied" };
@@ -164,8 +119,6 @@ class OrderbookState {
         this.seq = 0;
         this.cachedBestBid = null;
         this.cachedBestAsk = null;
-        this.hasSnapshot = false;
-        this.awaitingSnapshot = false;
     }
 }
 exports.OrderbookState = OrderbookState;

package/dist/domain/orderbook/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/domain/orderbook/state.ts"],"names":[],"mappings":"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","sourcesContent":["import Decimal from \"decimal.js\";\nimport type { OrderBookId } from \"../../shared\";\nimport type { OrderBook } from \"./wire\";\n\nexport type OrderbookApplyResult =\n  | { kind: \"applied\" }\n  | { kind: \"ignored\"; reason: OrderbookIgnoreReason }\n  | { kind: \"refresh_required\"; reason: OrderbookRefreshReason };\n\nexport type OrderbookIgnoreReason =\n  | { kind: \"invalid_delta_sequence\"; got: number }\n  | { kind: \"stale_delta\"; current: number; got: number }\n  | { kind: \"already_awaiting_snapshot\"; got: number };\n\nexport type OrderbookRefreshReason =\n  | { kind: \"missing_snapshot\"; got: number }\n  | { kind: \"sequence_gap\"; expected: number; got: number }\n  | { kind: \"server_resync\"; got: number };\n\nexport class OrderbookState {\n  readonly orderbookId: OrderBookId;\n  seq: number;\n  private readonly bidsMap: Map<string, string>;\n  private readonly asksMap: Map<string, string>;\n  private cachedBestBid: string | undefined | null;\n  private cachedBestAsk: string | undefined | null;\n  private hasSnapshot: boolean;\n  private awaitingSnapshot: boolean;\n\n  constructor(orderbookId: OrderBookId) {\n    this.orderbookId = orderbookId;\n    this.seq = 0;\n    this.bidsMap = new Map();\n    this.asksMap = new Map();\n    this.cachedBestBid = null;\n    this.cachedBestAsk = null;\n    this.hasSnapshot = false;\n    this.awaitingSnapshot = false;\n  }\n\n  /**\n   * Apply a WS orderbook message (snapshot replaces, delta merges).\n   *\n   * Server resync messages take precedence and return `refresh_required`.\n   * Otherwise, snapshots are applied and deltas with a `seq` at or below the\n   * current value are ignored to prevent stale updates. Deltas that skip one\n   * or more expected sequence values are rejected so callers can refresh from\n   * a fresh snapshot instead of mutating a corrupted book.\n   */\n  apply(book: OrderBook): OrderbookApplyResult {\n    const seq = book.seq ?? 0;\n\n    if (book.resync) {\n      this.awaitingSnapshot = true;\n      return {\n        kind: \"refresh_required\",\n        reason: { kind: \"server_resync\", got: seq },\n      };\n    }\n\n    if (book.is_snapshot) {\n      this.bidsMap.clear();\n      this.asksMap.clear();\n      this.hasSnapshot = true;\n      this.awaitingSnapshot = false;\n    } else {\n      if (this.awaitingSnapshot) {\n        return {\n          kind: \"ignored\",\n          reason: { kind: \"already_awaiting_snapshot\", got: seq },\n        };\n      }\n\n      // The backend sends snapshots with seq=0 and starts delta seq at 1.\n      // A delta with seq=0 means it has no valid sequence, so drop it.\n      if (seq <= 0) {\n        return {\n          kind: \"ignored\",\n          reason: { kind: \"invalid_delta_sequence\", got: seq },\n        };\n      }\n\n      if (!this.hasSnapshot) {\n        this.awaitingSnapshot = true;\n        return {\n          kind: \"refresh_required\",\n          reason: { kind: \"missing_snapshot\", got: seq },\n        };\n      }\n\n      if (seq <= this.seq) {\n        return {\n          kind: \"ignored\",\n          reason: { kind: \"stale_delta\", current: this.seq, got: seq },\n        };\n      }\n\n      const expected = this.seq + 1;\n      if (seq !== expected) {\n        this.awaitingSnapshot = true;\n        return {\n          kind: \"refresh_required\",\n          reason: { kind: \"sequence_gap\", expected, got: seq },\n        };\n      }\n    }\n\n    this.seq = seq;\n\n    for (const level of book.bids) {\n      if (new Decimal(level.size).isZero()) {\n        this.bidsMap.delete(level.price);\n      } else {\n        this.bidsMap.set(level.price, level.size);\n      }\n    }\n\n    for (const level of book.asks) {\n      if (new Decimal(level.size).isZero()) {\n        this.asksMap.delete(level.price);\n      } else {\n        this.asksMap.set(level.price, level.size);\n      }\n    }\n\n    this.cachedBestBid = null;\n    this.cachedBestAsk = null;\n\n    return { kind: \"applied\" };\n  }\n\n  bids(): ReadonlyMap<string, string> {\n    return this.bidsMap;\n  }\n\n  asks(): ReadonlyMap<string, string> {\n    return this.asksMap;\n  }\n\n  bestBid(): string | undefined {\n    if (this.cachedBestBid !== null) {\n      return this.cachedBestBid;\n    }\n    if (this.bidsMap.size === 0) {\n      this.cachedBestBid = undefined;\n      return undefined;\n    }\n    const result = Array.from(this.bidsMap.keys())\n      .sort((a, b) => new Decimal(a).cmp(new Decimal(b)))\n      .at(-1);\n    this.cachedBestBid = result;\n    return result;\n  }\n\n  bestAsk(): string | undefined {\n    if (this.cachedBestAsk !== null) {\n      return this.cachedBestAsk;\n    }\n    if (this.asksMap.size === 0) {\n      this.cachedBestAsk = undefined;\n      return undefined;\n    }\n    const result = Array.from(this.asksMap.keys())\n      .sort((a, b) => new Decimal(a).cmp(new Decimal(b)))[0];\n    this.cachedBestAsk = result;\n    return result;\n  }\n\n  midPrice(): string | undefined {\n    const bid = this.bestBid();\n    const ask = this.bestAsk();\n    if (!bid || !ask) {\n      return undefined;\n    }\n\n    return new Decimal(bid).plus(ask).div(2).toString();\n  }\n\n  spread(): string | undefined {\n    const bid = this.bestBid();\n    const ask = this.bestAsk();\n    if (!bid || !ask) {\n      return undefined;\n    }\n\n    return new Decimal(ask).minus(bid).toString();\n  }\n\n  isEmpty(): boolean {\n    return this.bidsMap.size === 0 && this.asksMap.size === 0;\n  }\n\n  clear(): void {\n    this.bidsMap.clear();\n    this.asksMap.clear();\n    this.seq = 0;\n    this.cachedBestBid = null;\n    this.cachedBestAsk = null;\n    this.hasSnapshot = false;\n    this.awaitingSnapshot = false;\n  }\n}\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/domain/orderbook/state.ts"],"names":[],"mappings":"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","sourcesContent":["import Decimal from \"decimal.js\";\nimport type { OrderBookId } from \"../../shared\";\nimport type { OrderBook } from \"./wire\";\n\n/**\n * The `book_update` stream is snapshot-only: every data frame carries the\n * full top-20 levels per side and replaces the previous book wholesale\n * (last-write-wins). Consumers holding multiple aggregation views of one\n * orderbook on the same connection key their `OrderbookState` instances by\n * `(orderbook_id, aggregation)` using\n * `aggregationFromFrame(book.n_sig_figs, book.mantissa)`.\n */\nexport type OrderbookApplyResult =\n  | { kind: \"applied\" }\n  | { kind: \"refresh_required\"; reason: OrderbookRefreshReason };\n\nexport type OrderbookRefreshReason =\n  /**\n   * The backend explicitly requested a resync: unsubscribe and re-subscribe\n   * with the same parameters (including aggregation) to receive a fresh\n   * snapshot.\n   */\n  { kind: \"server_resync\" };\n\nexport class OrderbookState {\n  readonly orderbookId: OrderBookId;\n  /**\n   * Projection version of the last applied frame. Strictly increasing but\n   * non-contiguous server-side (conflation skips versions), and the initial\n   * snapshot after every (re)subscribe is `seq: 0` — informational only,\n   * never used to gate frames.\n   */\n  seq: number;\n  private readonly bidsMap: Map<string, string>;\n  private readonly asksMap: Map<string, string>;\n  private cachedBestBid: string | undefined | null;\n  private cachedBestAsk: string | undefined | null;\n\n  constructor(orderbookId: OrderBookId) {\n    this.orderbookId = orderbookId;\n    this.seq = 0;\n    this.bidsMap = new Map();\n    this.asksMap = new Map();\n    this.cachedBestBid = null;\n    this.cachedBestAsk = null;\n  }\n\n  /**\n   * Apply a WS orderbook frame (snapshot-only stream, last-write-wins).\n   *\n   * `resync` frames take precedence and leave the book untouched — the\n   * caller must re-subscribe with the same parameters. Every other data\n   * frame is a full snapshot by contract and replaces the book wholesale\n   * (the `is_snapshot` flag is not consulted), including the `seq: 0`\n   * initial snapshot delivered after every (re)subscribe: gating on `seq`\n   * would freeze the book after a resync or aggregation change, so `seq` is\n   * stored as informational only.\n   */\n  apply(book: OrderBook): OrderbookApplyResult {\n    if (book.resync) {\n      return {\n        kind: \"refresh_required\",\n        reason: { kind: \"server_resync\" },\n      };\n    }\n\n    this.bidsMap.clear();\n    this.asksMap.clear();\n    for (const level of book.bids) {\n      if (!new Decimal(level.size).isZero()) {\n        this.bidsMap.set(level.price, level.size);\n      }\n    }\n    for (const level of book.asks) {\n      if (!new Decimal(level.size).isZero()) {\n        this.asksMap.set(level.price, level.size);\n      }\n    }\n    this.seq = book.seq ?? 0;\n    this.cachedBestBid = null;\n    this.cachedBestAsk = null;\n\n    return { kind: \"applied\" };\n  }\n\n  bids(): ReadonlyMap<string, string> {\n    return this.bidsMap;\n  }\n\n  asks(): ReadonlyMap<string, string> {\n    return this.asksMap;\n  }\n\n  bestBid(): string | undefined {\n    if (this.cachedBestBid !== null) {\n      return this.cachedBestBid;\n    }\n    if (this.bidsMap.size === 0) {\n      this.cachedBestBid = undefined;\n      return undefined;\n    }\n    const result = Array.from(this.bidsMap.keys())\n      .sort((a, b) => new Decimal(a).cmp(new Decimal(b)))\n      .at(-1);\n    this.cachedBestBid = result;\n    return result;\n  }\n\n  bestAsk(): string | undefined {\n    if (this.cachedBestAsk !== null) {\n      return this.cachedBestAsk;\n    }\n    if (this.asksMap.size === 0) {\n      this.cachedBestAsk = undefined;\n      return undefined;\n    }\n    const result = Array.from(this.asksMap.keys())\n      .sort((a, b) => new Decimal(a).cmp(new Decimal(b)))[0];\n    this.cachedBestAsk = result;\n    return result;\n  }\n\n  midPrice(): string | undefined {\n    const bid = this.bestBid();\n    const ask = this.bestAsk();\n    if (!bid || !ask) {\n      return undefined;\n    }\n\n    return new Decimal(bid).plus(ask).div(2).toString();\n  }\n\n  spread(): string | undefined {\n    const bid = this.bestBid();\n    const ask = this.bestAsk();\n    if (!bid || !ask) {\n      return undefined;\n    }\n\n    return new Decimal(ask).minus(bid).toString();\n  }\n\n  isEmpty(): boolean {\n    return this.bidsMap.size === 0 && this.asksMap.size === 0;\n  }\n\n  clear(): void {\n    this.bidsMap.clear();\n    this.asksMap.clear();\n    this.seq = 0;\n    this.cachedBestBid = null;\n    this.cachedBestAsk = null;\n  }\n}\n"]}

package/dist/domain/orderbook/wire.d.ts

@@ -24,6 +24,9 @@ export interface RestBookLevel {
     size: string;
     orders?: number;
 }
+/**
+ * REST depth response. Depth is capped server-side at 20 levels per side.
+ */
 export interface OrderbookDepthResponse {
     orderbook_id: OrderBookId;
     market_pubkey?: string;
@@ -33,6 +36,19 @@ export interface OrderbookDepthResponse {
     tick_size?: string;
     bids: RestBookLevel[];
     asks: RestBookLevel[];
+    /**
+     * Display decimals for prices and sizes. Always sent by current backends;
+     * optional for tolerance of older payloads.
+     */
+    decimals?: OrderbookDepthDecimals;
+}
+/**
+ * Price/size display decimals from the depth endpoint. Distinct from
+ * `DecimalsResponse` (the `/decimals` endpoint).
+ */
+export interface OrderbookDepthDecimals {
+    price: number;
+    size: number;
 }
 export interface DecimalsResponse {
     orderbook_id: string;
@@ -45,6 +61,14 @@ export interface WsBookLevel {
     price: string;
     size: string;
 }
+/**
+ * WS orderbook snapshot frame.
+ *
+ * The stream is snapshot-only: every data frame carries the full top-20
+ * levels per side and replaces the previous book wholesale (last-write-wins).
+ * `seq` is strictly increasing but non-contiguous, and the initial snapshot
+ * after every (re)subscribe is `seq: 0` — informational only, never a gate.
+ */
 export interface OrderBook {
     orderbook_id: OrderBookId;
     is_snapshot?: boolean;
@@ -53,6 +77,14 @@ export interface OrderBook {
     timestamp?: string;
     bids: WsBookLevel[];
     asks: WsBookLevel[];
+    /**
+     * Aggregation tags echoed by the backend (omitted = full precision).
+     * Always normalized server-side ((5, none) arrives as (5, 1)). Use
+     * `aggregationFromFrame(book.n_sig_figs, book.mantissa)` to key
+     * per-`(orderbook, aggregation)` book state.
+     */
+    n_sig_figs?: number;
+    mantissa?: number;
 }
 export interface WsTickerData {
     orderbook_id: OrderBookId;

package/dist/domain/orderbook/wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/domain/orderbook/wire.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../src/domain/orderbook/wire.ts"],"names":[],"mappings":"","sourcesContent":["import type { OrderBookId, Side } from \"../../shared\";\n\nexport interface OrderbookResponse {\n  id: number;\n  market_pubkey: string;\n  orderbook_id: string;\n  base_token: string;\n  quote_token: string;\n  outcome_index?: number;\n  tick_size: number;\n  total_bids: number;\n  total_asks: number;\n  last_trade_price?: string;\n  last_trade_time?: string;\n  active: boolean;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface OrderbooksResponse {\n  orderbooks: OrderbookResponse[];\n  total: number;\n}\n\nexport interface RestBookLevel {\n  price: string;\n  size: string;\n  orders?: number;\n}\n\nexport interface OrderbookDepthResponse {\n  orderbook_id: OrderBookId;\n  market_pubkey?: string;\n  best_bid?: string;\n  best_ask?: string;\n  spread?: string;\n  tick_size?: string;\n  bids: RestBookLevel[];\n  asks: RestBookLevel[];\n}\n\nexport interface DecimalsResponse {\n  orderbook_id: string;\n  base_decimals: number;\n  quote_decimals: number;\n  price_decimals: number;\n}\n\nexport interface WsBookLevel {\n  side: Side;\n  price: string;\n  size: string;\n}\n\nexport interface OrderBook {\n  orderbook_id: OrderBookId;\n  is_snapshot?: boolean;\n  seq?: number;\n  resync?: boolean;\n  timestamp?: string;\n  bids: WsBookLevel[];\n  asks: WsBookLevel[];\n}\n\nexport interface WsTickerData {\n  orderbook_id: OrderBookId;\n  best_bid?: string;\n  best_ask?: string;\n  mid?: string;\n  timestamp?: string;\n}\n"]}
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../src/domain/orderbook/wire.ts"],"names":[],"mappings":"","sourcesContent":["import type { OrderBookId, Side } from \"../../shared\";\n\nexport interface OrderbookResponse {\n  id: number;\n  market_pubkey: string;\n  orderbook_id: string;\n  base_token: string;\n  quote_token: string;\n  outcome_index?: number;\n  tick_size: number;\n  total_bids: number;\n  total_asks: number;\n  last_trade_price?: string;\n  last_trade_time?: string;\n  active: boolean;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface OrderbooksResponse {\n  orderbooks: OrderbookResponse[];\n  total: number;\n}\n\nexport interface RestBookLevel {\n  price: string;\n  size: string;\n  orders?: number;\n}\n\n/**\n * REST depth response. Depth is capped server-side at 20 levels per side.\n */\nexport interface OrderbookDepthResponse {\n  orderbook_id: OrderBookId;\n  market_pubkey?: string;\n  best_bid?: string;\n  best_ask?: string;\n  spread?: string;\n  tick_size?: string;\n  bids: RestBookLevel[];\n  asks: RestBookLevel[];\n  /**\n   * Display decimals for prices and sizes. Always sent by current backends;\n   * optional for tolerance of older payloads.\n   */\n  decimals?: OrderbookDepthDecimals;\n}\n\n/**\n * Price/size display decimals from the depth endpoint. Distinct from\n * `DecimalsResponse` (the `/decimals` endpoint).\n */\nexport interface OrderbookDepthDecimals {\n  price: number;\n  size: number;\n}\n\nexport interface DecimalsResponse {\n  orderbook_id: string;\n  base_decimals: number;\n  quote_decimals: number;\n  price_decimals: number;\n}\n\nexport interface WsBookLevel {\n  side: Side;\n  price: string;\n  size: string;\n}\n\n/**\n * WS orderbook snapshot frame.\n *\n * The stream is snapshot-only: every data frame carries the full top-20\n * levels per side and replaces the previous book wholesale (last-write-wins).\n * `seq` is strictly increasing but non-contiguous, and the initial snapshot\n * after every (re)subscribe is `seq: 0` — informational only, never a gate.\n */\nexport interface OrderBook {\n  orderbook_id: OrderBookId;\n  is_snapshot?: boolean;\n  seq?: number;\n  resync?: boolean;\n  timestamp?: string;\n  bids: WsBookLevel[];\n  asks: WsBookLevel[];\n  /**\n   * Aggregation tags echoed by the backend (omitted = full precision).\n   * Always normalized server-side ((5, none) arrives as (5, 1)). Use\n   * `aggregationFromFrame(book.n_sig_figs, book.mantissa)` to key\n   * per-`(orderbook, aggregation)` book state.\n   */\n  n_sig_figs?: number;\n  mantissa?: number;\n}\n\nexport interface WsTickerData {\n  orderbook_id: OrderBookId;\n  best_bid?: string;\n  best_ask?: string;\n  mid?: string;\n  timestamp?: string;\n}\n"]}

package/dist/env.d.ts

@@ -17,11 +17,26 @@ export declare enum LightconeEnv {
     Staging = "staging",
     Prod = "prod"
 }
-/** REST API base URL for the given environment. */
+/**
+ * REST API base URL for the given environment.
+ *
+ * If the `SDK_API_URL` environment variable is set, its value is used
+ * regardless of the selected environment.
+ */
 export declare function apiUrl(environment: LightconeEnv): string;
-/** WebSocket URL for the given environment. */
+/**
+ * WebSocket URL for the given environment.
+ *
+ * If the `SDK_WS_URL` environment variable is set, its value is used
+ * regardless of the selected environment.
+ */
 export declare function wsUrl(environment: LightconeEnv): string;
-/** Solana RPC URL for the given environment. */
+/**
+ * Solana RPC URL for the given environment.
+ *
+ * If the `SDK_RPC_URL` environment variable is set, its value is used
+ * regardless of the selected environment.
+ */
 export declare function rpcUrl(environment: LightconeEnv): string;
 /**
  * On-chain Lightcone program ID for the given environment.

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,oBAAY,YAAY;IACtB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CASxD;AAED,+CAA+C;AAC/C,wBAAgB,KAAK,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CASvD;AAED,gDAAgD;AAChD,wBAAgB,MAAM,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CASxD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,CAa9D;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,WAA+B,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,oBAAY,YAAY;IACtB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CAWxD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CAWvD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CAWxD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,CAa9D;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,WAA+B,CAAC"}

package/dist/env.js

@@ -25,8 +25,16 @@ var LightconeEnv;
     LightconeEnv["Staging"] = "staging";
     LightconeEnv["Prod"] = "prod";
 })(LightconeEnv || (exports.LightconeEnv = LightconeEnv = {}));
-/** REST API base URL for the given environment. */
+/**
+ * REST API base URL for the given environment.
+ *
+ * If the `SDK_API_URL` environment variable is set, its value is used
+ * regardless of the selected environment.
+ */
 function apiUrl(environment) {
+    const overrideUrl = typeof process !== "undefined" ? process.env.SDK_API_URL : undefined;
+    if (overrideUrl)
+        return overrideUrl;
     switch (environment) {
         case LightconeEnv.Local:
             return "https://api.local.lightcone.xyz";
@@ -36,8 +44,16 @@ function apiUrl(environment) {
             return "https://api.lightcone.xyz";
     }
 }
-/** WebSocket URL for the given environment. */
+/**
+ * WebSocket URL for the given environment.
+ *
+ * If the `SDK_WS_URL` environment variable is set, its value is used
+ * regardless of the selected environment.
+ */
 function wsUrl(environment) {
+    const overrideUrl = typeof process !== "undefined" ? process.env.SDK_WS_URL : undefined;
+    if (overrideUrl)
+        return overrideUrl;
     switch (environment) {
         case LightconeEnv.Local:
             return "wss://ws.local.lightcone.xyz/ws";
@@ -47,15 +63,23 @@ function wsUrl(environment) {
             return "wss://ws.lightcone.xyz/ws";
     }
 }
-/** Solana RPC URL for the given environment. */
+/**
+ * Solana RPC URL for the given environment.
+ *
+ * If the `SDK_RPC_URL` environment variable is set, its value is used
+ * regardless of the selected environment.
+ */
 function rpcUrl(environment) {
+    const overrideUrl = typeof process !== "undefined" ? process.env.SDK_RPC_URL : undefined;
+    if (overrideUrl)
+        return overrideUrl;
     switch (environment) {
         case LightconeEnv.Local:
             return "https://api.devnet.solana.com";
         case LightconeEnv.Staging:
             return "https://api.devnet.solana.com";
         case LightconeEnv.Prod:
-            return "https://api.devnet.solana.com";
+            return "https://api.mainnet-beta.solana.com";
     }
 }
 /**

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":";;;AAsBA,wBASC;AAGD,sBASC;AAGD,wBASC;AAQD,8BAaC;AA5ED,6CAA4C;AAE5C;;;;;;;;;;;;GAYG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,6BAAa,CAAA;AACf,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAED,mDAAmD;AACnD,SAAgB,MAAM,CAAC,WAAyB;IAC9C,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,iCAAiC,CAAC;QAC3C,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,2BAA2B,CAAC;IACvC,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,SAAgB,KAAK,CAAC,WAAyB;IAC7C,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,iCAAiC,CAAC;QAC3C,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,2BAA2B,CAAC;IACvC,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,SAAgB,MAAM,CAAC,WAAyB;IAC9C,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,+BAA+B,CAAC;QACzC,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,+BAA+B,CAAC;QACzC,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,+BAA+B,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,WAAyB;IACjD,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,mBAAS,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IACD,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,IAAI,mBAAS,CAAC,8CAA8C,CAAC,CAAC;QACvE,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,IAAI,mBAAS,CAAC,8CAA8C,CAAC,CAAC;QACvE,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,IAAI,mBAAS,CAAC,8CAA8C,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACU,QAAA,UAAU,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC","sourcesContent":["import { PublicKey } from \"@solana/web3.js\";\n\n/**\n * Lightcone deployment environment.\n *\n * Pass to `LightconeClientBuilder.env()` to configure the client for a\n * specific deployment. Defaults to `Prod` when not specified.\n *\n * @example\n * ```ts\n * const client = LightconeClient.builder()\n *   .env(LightconeEnv.Staging)\n *   .build();\n * ```\n */\nexport enum LightconeEnv {\n  Local = \"local\",\n  Staging = \"staging\",\n  Prod = \"prod\",\n}\n\n/** REST API base URL for the given environment. */\nexport function apiUrl(environment: LightconeEnv): string {\n  switch (environment) {\n    case LightconeEnv.Local:\n      return \"https://api.local.lightcone.xyz\";\n    case LightconeEnv.Staging:\n      return \"https://api.staging.lightcone.xyz\";\n    case LightconeEnv.Prod:\n      return \"https://api.lightcone.xyz\";\n  }\n}\n\n/** WebSocket URL for the given environment. */\nexport function wsUrl(environment: LightconeEnv): string {\n  switch (environment) {\n    case LightconeEnv.Local:\n      return \"wss://ws.local.lightcone.xyz/ws\";\n    case LightconeEnv.Staging:\n      return \"wss://ws.staging.lightcone.xyz/ws\";\n    case LightconeEnv.Prod:\n      return \"wss://ws.lightcone.xyz/ws\";\n  }\n}\n\n/** Solana RPC URL for the given environment. */\nexport function rpcUrl(environment: LightconeEnv): string {\n  switch (environment) {\n    case LightconeEnv.Local:\n      return \"https://api.devnet.solana.com\";\n    case LightconeEnv.Staging:\n      return \"https://api.devnet.solana.com\";\n    case LightconeEnv.Prod:\n      return \"https://api.devnet.solana.com\";\n  }\n}\n\n/**\n * On-chain Lightcone program ID for the given environment.\n *\n * If the `SDK_PROGRAM_ID` environment variable is set, its value is used\n * regardless of the selected environment.\n */\nexport function programId(environment: LightconeEnv): PublicKey {\n  const override_id = typeof process !== \"undefined\" ? process.env.SDK_PROGRAM_ID : undefined;\n  if (override_id) {\n    return new PublicKey(override_id);\n  }\n  switch (environment) {\n    case LightconeEnv.Local:\n      return new PublicKey(\"HQZW84F7WbpDLDdd6eaDsBh6LjDQ2uCxpkZgkLakcago\");\n    case LightconeEnv.Staging:\n      return new PublicKey(\"FAq4NbwPVWNzoaNjcJGhWz4VFT5CbdysLPo7ZWWiWuuE\");\n    case LightconeEnv.Prod:\n      return new PublicKey(\"B9rCvafkkjh749284jfDu5UB268pHeRLkzFpFf7t4mxK\");\n  }\n}\n\n/**\n * Default program ID (production). Used as the default argument in PDA and\n * instruction helper functions. When targeting a non-production environment,\n * always pass `programId` explicitly via `LightconeClient.programId` or\n * `programId(env)`.\n */\nexport const PROGRAM_ID = programId(LightconeEnv.Prod);\n"]}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":";;;AA2BA,wBAWC;AAQD,sBAWC;AAQD,wBAWC;AAQD,8BAaC;AAjGD,6CAA4C;AAE5C;;;;;;;;;;;;GAYG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,6BAAa,CAAA;AACf,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAED;;;;;GAKG;AACH,SAAgB,MAAM,CAAC,WAAyB;IAC9C,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,iCAAiC,CAAC;QAC3C,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,2BAA2B,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,WAAyB;IAC7C,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,iCAAiC,CAAC;QAC3C,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,2BAA2B,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,MAAM,CAAC,WAAyB;IAC9C,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,+BAA+B,CAAC;QACzC,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,+BAA+B,CAAC;QACzC,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,qCAAqC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,WAAyB;IACjD,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,mBAAS,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IACD,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC,KAAK;YACrB,OAAO,IAAI,mBAAS,CAAC,8CAA8C,CAAC,CAAC;QACvE,KAAK,YAAY,CAAC,OAAO;YACvB,OAAO,IAAI,mBAAS,CAAC,8CAA8C,CAAC,CAAC;QACvE,KAAK,YAAY,CAAC,IAAI;YACpB,OAAO,IAAI,mBAAS,CAAC,8CAA8C,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACU,QAAA,UAAU,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC","sourcesContent":["import { PublicKey } from \"@solana/web3.js\";\n\n/**\n * Lightcone deployment environment.\n *\n * Pass to `LightconeClientBuilder.env()` to configure the client for a\n * specific deployment. Defaults to `Prod` when not specified.\n *\n * @example\n * ```ts\n * const client = LightconeClient.builder()\n *   .env(LightconeEnv.Staging)\n *   .build();\n * ```\n */\nexport enum LightconeEnv {\n  Local = \"local\",\n  Staging = \"staging\",\n  Prod = \"prod\",\n}\n\n/**\n * REST API base URL for the given environment.\n *\n * If the `SDK_API_URL` environment variable is set, its value is used\n * regardless of the selected environment.\n */\nexport function apiUrl(environment: LightconeEnv): string {\n  const overrideUrl = typeof process !== \"undefined\" ? process.env.SDK_API_URL : undefined;\n  if (overrideUrl) return overrideUrl;\n  switch (environment) {\n    case LightconeEnv.Local:\n      return \"https://api.local.lightcone.xyz\";\n    case LightconeEnv.Staging:\n      return \"https://api.staging.lightcone.xyz\";\n    case LightconeEnv.Prod:\n      return \"https://api.lightcone.xyz\";\n  }\n}\n\n/**\n * WebSocket URL for the given environment.\n *\n * If the `SDK_WS_URL` environment variable is set, its value is used\n * regardless of the selected environment.\n */\nexport function wsUrl(environment: LightconeEnv): string {\n  const overrideUrl = typeof process !== \"undefined\" ? process.env.SDK_WS_URL : undefined;\n  if (overrideUrl) return overrideUrl;\n  switch (environment) {\n    case LightconeEnv.Local:\n      return \"wss://ws.local.lightcone.xyz/ws\";\n    case LightconeEnv.Staging:\n      return \"wss://ws.staging.lightcone.xyz/ws\";\n    case LightconeEnv.Prod:\n      return \"wss://ws.lightcone.xyz/ws\";\n  }\n}\n\n/**\n * Solana RPC URL for the given environment.\n *\n * If the `SDK_RPC_URL` environment variable is set, its value is used\n * regardless of the selected environment.\n */\nexport function rpcUrl(environment: LightconeEnv): string {\n  const overrideUrl = typeof process !== \"undefined\" ? process.env.SDK_RPC_URL : undefined;\n  if (overrideUrl) return overrideUrl;\n  switch (environment) {\n    case LightconeEnv.Local:\n      return \"https://api.devnet.solana.com\";\n    case LightconeEnv.Staging:\n      return \"https://api.devnet.solana.com\";\n    case LightconeEnv.Prod:\n      return \"https://api.mainnet-beta.solana.com\";\n  }\n}\n\n/**\n * On-chain Lightcone program ID for the given environment.\n *\n * If the `SDK_PROGRAM_ID` environment variable is set, its value is used\n * regardless of the selected environment.\n */\nexport function programId(environment: LightconeEnv): PublicKey {\n  const override_id = typeof process !== \"undefined\" ? process.env.SDK_PROGRAM_ID : undefined;\n  if (override_id) {\n    return new PublicKey(override_id);\n  }\n  switch (environment) {\n    case LightconeEnv.Local:\n      return new PublicKey(\"HQZW84F7WbpDLDdd6eaDsBh6LjDQ2uCxpkZgkLakcago\");\n    case LightconeEnv.Staging:\n      return new PublicKey(\"FAq4NbwPVWNzoaNjcJGhWz4VFT5CbdysLPo7ZWWiWuuE\");\n    case LightconeEnv.Prod:\n      return new PublicKey(\"B9rCvafkkjh749284jfDu5UB268pHeRLkzFpFf7t4mxK\");\n  }\n}\n\n/**\n * Default program ID (production). Used as the default argument in PDA and\n * instruction helper functions. When targeting a non-production environment,\n * always pass `programId` explicitly via `LightconeClient.programId` or\n * `programId(env)`.\n */\nexport const PROGRAM_ID = programId(LightconeEnv.Prod);\n"]}

package/dist/http/client.d.ts

@@ -2,14 +2,10 @@ import { type RetryPolicy } from "./retry";
 export declare class LightconeHttp {
     private readonly normalizedBaseUrl;
     private authToken;
-    private adminToken;
     constructor(baseUrl: string);
     baseUrl(): string;
     clearAuthToken(): Promise<void>;
     authTokenRef(): () => Promise<string | undefined>;
-    clearAdminToken(): void;
-    adminGet<T>(url: string, retry: RetryPolicy): Promise<T>;
-    adminPost<T, B extends object>(url: string, body: B, retry: RetryPolicy): Promise<T>;
     get<T>(url: string, retry: RetryPolicy): Promise<T>;
     post<T, B extends object>(url: string, body: B, retry: RetryPolicy): Promise<T>;
     /**
@@ -28,5 +24,6 @@ export declare class LightconeHttp {
     private captureCookies;
     private cookieHeader;
     private mapStatusError;
+    private statusErrorToSdk;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/http/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AASlF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,UAAU,CAAqB;gBAE3B,OAAO,EAAE,MAAM;IAI3B,OAAO,IAAI,MAAM;IAIX,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,YAAY,IAAI,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIjD,eAAe,IAAI,IAAI;IAIjB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAUxD,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrF;;;;;;;OAOG;IACG,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAU5E,gBAAgB;YA8ChB,WAAW;YAoBX,YAAY;YAeZ,WAAW;IAgEzB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,cAAc;CAevB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAwBlF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,SAAS,CAAqB;gBAE1B,OAAO,EAAE,MAAM;IAI3B,OAAO,IAAI,MAAM;IAIX,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,YAAY,IAAI,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrF;;;;;;;OAOG;IACG,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAU5E,gBAAgB;YAmEhB,WAAW;YAiBX,YAAY;YAeZ,WAAW;IAgEzB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,gBAAgB;CAOzB"}