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

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

@@ -1,12 +1,22 @@
 import { Transaction, type PublicKey, type TransactionInstruction } from "@solana/web3.js";
 import type { ClientContext } from "../../context";
 import type { CloseOrderbookAltParams, CloseOrderbookParams, Orderbook as ProgramOrderbook } from "../../program/types";
+import { type BookAggregation } from "./aggregation";
 import type { OrderbookDepthResponse } from "./wire";
 export declare class Orderbooks {
     private readonly client;
     constructor(client: ClientContext);
     pda(mintA: PublicKey, mintB: PublicKey): PublicKey;
-    get(orderbookId: string, depth?: number): Promise<OrderbookDepthResponse>;
+    /**
+     * Get live orderbook depth, optionally aggregated (Hyperliquid-style).
+     *
+     * `depth` is capped server-side at 20 levels per side (omitted, `0`, or
+     * `>20` all serve 20). Invalid aggregation combinations throw client-side
+     * before any request is made (the server would 400 with
+     * `INVALID_ORDERBOOK_QUERY`), and unknown query params are rejected
+     * server-side — only `depth`, `nSigFigs`, and `mantissa` are ever sent.
+     */
+    get(orderbookId: string, depth?: number, aggregation?: BookAggregation): Promise<OrderbookDepthResponse>;
     closeOrderbookAltIx(params: CloseOrderbookAltParams): TransactionInstruction;
     closeOrderbookIx(params: CloseOrderbookParams): TransactionInstruction;
     closeOrderbookAltTx(params: CloseOrderbookAltParams): Transaction;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAUnD,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,SAAS,IAAI,gBAAgB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAErD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAIlD,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS;IAM5C,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAQ/E,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,sBAAsB;IAI5E,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB;IAItE,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW;IAKjE,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,WAAW;IAOrD,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAWhF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAUnD,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,SAAS,IAAI,gBAAgB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAErD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAIlD,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS;IAMlD;;;;;;;;OAQG;IACG,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,GAAE,eAAgC,GAC5C,OAAO,CAAC,sBAAsB,CAAC;IAmBlC,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,sBAAsB;IAI5E,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB;IAItE,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW;IAKjE,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,WAAW;IAOrD,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAWhF"}

package/dist/domain/orderbook/client.js

@@ -8,6 +8,7 @@ const http_1 = require("../../http");
 const instructions_1 = require("../../program/instructions");
 const pda_1 = require("../../program/pda");
 const accounts_1 = require("../../program/accounts");
+const aggregation_1 = require("./aggregation");
 class Orderbooks {
     client;
     constructor(client) {
@@ -18,9 +19,29 @@ class Orderbooks {
         return (0, pda_1.getOrderbookPda)(mintA, mintB, this.client.programId)[0];
     }
     // ── HTTP methods ─────────────────────────────────────────────────────
-    async get(orderbookId, depth) {
-        const query = depth !== undefined ? `?depth=${depth}` : "";
-        const url = `${this.client.http.baseUrl()}/api/orderbook/${encodeURIComponent(orderbookId)}${query}`;
+    /**
+     * Get live orderbook depth, optionally aggregated (Hyperliquid-style).
+     *
+     * `depth` is capped server-side at 20 levels per side (omitted, `0`, or
+     * `>20` all serve 20). Invalid aggregation combinations throw client-side
+     * before any request is made (the server would 400 with
+     * `INVALID_ORDERBOOK_QUERY`), and unknown query params are rejected
+     * server-side — only `depth`, `nSigFigs`, and `mantissa` are ever sent.
+     */
+    async get(orderbookId, depth, aggregation = aggregation_1.FULL_PRECISION) {
+        const validated = (0, aggregation_1.validateAggregation)(aggregation);
+        const query = new URLSearchParams();
+        if (depth !== undefined) {
+            query.set("depth", String(depth));
+        }
+        if (validated.nSigFigs !== undefined) {
+            query.set("nSigFigs", String(validated.nSigFigs));
+        }
+        if (validated.mantissa !== undefined) {
+            query.set("mantissa", String(validated.mantissa));
+        }
+        const queryString = query.toString();
+        const url = `${this.client.http.baseUrl()}/api/orderbook/${encodeURIComponent(orderbookId)}${queryString ? `?${queryString}` : ""}`;
         return this.client.http.get(url, http_1.RetryPolicy.Idempotent);
     }
     // ── On-chain transaction builders ────────────────────────────────────

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

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/domain/orderbook/client.ts"],"names":[],"mappings":";;;AAAA,6CAA2F;AAE3F,2CAAkD;AAClD,+CAAsD;AACtD,qCAAyC;AACzC,6DAGoC;AACpC,2CAAoD;AACpD,qDAA6F;AAQ7F,MAAa,UAAU;IACQ;IAA7B,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAEtD,wEAAwE;IAExE,GAAG,CAAC,KAAgB,EAAE,KAAgB;QACpC,OAAO,IAAA,qBAAe,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,wEAAwE;IAExE,KAAK,CAAC,GAAG,CAAC,WAAmB,EAAE,KAAc;QAC3C,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,kBAAkB,CAAC,WAAW,CAAC,GAAG,KAAK,EAAE,CAAC;QACrG,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAyB,GAAG,EAAE,kBAAW,CAAC,UAAU,CAAC,CAAC;IACnF,CAAC;IAED,wEAAwE;IAExE,mBAAmB,CAAC,MAA+B;QACjD,OAAO,IAAA,uCAAwB,EAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,gBAAgB,CAAC,MAA4B;QAC3C,OAAO,IAAA,oCAAqB,EAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED,mBAAmB,CAAC,MAA+B;QACjD,MAAM,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,IAAI,qBAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,gBAAgB,CAAC,MAA4B;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,IAAI,qBAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,uEAAuE;IAEvE,KAAK,CAAC,UAAU,CAAC,KAAgB,EAAE,KAAgB;QACjD,MAAM,UAAU,GAAG,IAAA,2BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAClE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,uBAAe,CAAC,eAAe,CACnC,iBAAiB,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,IAAA,+BAA2B,EAAC,WAAW,CAAC,IAAc,CAAC,CAAC;IACjE,CAAC;CACF;AAlDD,gCAkDC","sourcesContent":["import { Transaction, type PublicKey, type TransactionInstruction } from \"@solana/web3.js\";\nimport type { ClientContext } from \"../../context\";\nimport { requireConnection } from \"../../context\";\nimport { ProgramSdkError } from \"../../program/error\";\nimport { RetryPolicy } from \"../../http\";\nimport {\n  buildCloseOrderbookAltIx,\n  buildCloseOrderbookIx,\n} from \"../../program/instructions\";\nimport { getOrderbookPda } from \"../../program/pda\";\nimport { deserializeOrderbook as deserializeProgramOrderbook } from \"../../program/accounts\";\nimport type {\n  CloseOrderbookAltParams,\n  CloseOrderbookParams,\n  Orderbook as ProgramOrderbook,\n} from \"../../program/types\";\nimport type { OrderbookDepthResponse } from \"./wire\";\n\nexport class Orderbooks {\n  constructor(private readonly client: ClientContext) {}\n\n  // ── PDA helpers ──────────────────────────────────────────────────────\n\n  pda(mintA: PublicKey, mintB: PublicKey): PublicKey {\n    return getOrderbookPda(mintA, mintB, this.client.programId)[0];\n  }\n\n  // ── HTTP methods ─────────────────────────────────────────────────────\n\n  async get(orderbookId: string, depth?: number): Promise<OrderbookDepthResponse> {\n    const query = depth !== undefined ? `?depth=${depth}` : \"\";\n    const url = `${this.client.http.baseUrl()}/api/orderbook/${encodeURIComponent(orderbookId)}${query}`;\n    return this.client.http.get<OrderbookDepthResponse>(url, RetryPolicy.Idempotent);\n  }\n\n  // ── On-chain transaction builders ────────────────────────────────────\n\n  closeOrderbookAltIx(params: CloseOrderbookAltParams): TransactionInstruction {\n    return buildCloseOrderbookAltIx(params, this.client.programId);\n  }\n\n  closeOrderbookIx(params: CloseOrderbookParams): TransactionInstruction {\n    return buildCloseOrderbookIx(params, this.client.programId);\n  }\n\n  closeOrderbookAltTx(params: CloseOrderbookAltParams): Transaction {\n    const ix = this.closeOrderbookAltIx(params);\n    return new Transaction({ feePayer: params.operator }).add(ix);\n  }\n\n  closeOrderbookTx(params: CloseOrderbookParams): Transaction {\n    const ix = this.closeOrderbookIx(params);\n    return new Transaction({ feePayer: params.operator }).add(ix);\n  }\n\n  // ── On-chain account fetchers (require Connection) ──────────────────\n\n  async getOnchain(mintA: PublicKey, mintB: PublicKey): Promise<ProgramOrderbook> {\n    const connection = requireConnection(this.client);\n    const orderbookPda = this.pda(mintA, mintB);\n    const accountInfo = await connection.getAccountInfo(orderbookPda);\n    if (!accountInfo) {\n      throw ProgramSdkError.accountNotFound(\n        `Orderbook for ${mintA.toBase58()} / ${mintB.toBase58()}`\n      );\n    }\n    return deserializeProgramOrderbook(accountInfo.data as Buffer);\n  }\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/domain/orderbook/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { Transaction, type PublicKey, type TransactionInstruction } from \"@solana/web3.js\";\nimport type { ClientContext } from \"../../context\";\nimport { requireConnection } from \"../../context\";\nimport { ProgramSdkError } from \"../../program/error\";\nimport { RetryPolicy } from \"../../http\";\nimport {\n  buildCloseOrderbookAltIx,\n  buildCloseOrderbookIx,\n} from \"../../program/instructions\";\nimport { getOrderbookPda } from \"../../program/pda\";\nimport { deserializeOrderbook as deserializeProgramOrderbook } from \"../../program/accounts\";\nimport type {\n  CloseOrderbookAltParams,\n  CloseOrderbookParams,\n  Orderbook as ProgramOrderbook,\n} from \"../../program/types\";\nimport {\n  FULL_PRECISION,\n  validateAggregation,\n  type BookAggregation,\n} from \"./aggregation\";\nimport type { OrderbookDepthResponse } from \"./wire\";\n\nexport class Orderbooks {\n  constructor(private readonly client: ClientContext) {}\n\n  // ── PDA helpers ──────────────────────────────────────────────────────\n\n  pda(mintA: PublicKey, mintB: PublicKey): PublicKey {\n    return getOrderbookPda(mintA, mintB, this.client.programId)[0];\n  }\n\n  // ── HTTP methods ─────────────────────────────────────────────────────\n\n  /**\n   * Get live orderbook depth, optionally aggregated (Hyperliquid-style).\n   *\n   * `depth` is capped server-side at 20 levels per side (omitted, `0`, or\n   * `>20` all serve 20). Invalid aggregation combinations throw client-side\n   * before any request is made (the server would 400 with\n   * `INVALID_ORDERBOOK_QUERY`), and unknown query params are rejected\n   * server-side — only `depth`, `nSigFigs`, and `mantissa` are ever sent.\n   */\n  async get(\n    orderbookId: string,\n    depth?: number,\n    aggregation: BookAggregation = FULL_PRECISION\n  ): Promise<OrderbookDepthResponse> {\n    const validated = validateAggregation(aggregation);\n    const query = new URLSearchParams();\n    if (depth !== undefined) {\n      query.set(\"depth\", String(depth));\n    }\n    if (validated.nSigFigs !== undefined) {\n      query.set(\"nSigFigs\", String(validated.nSigFigs));\n    }\n    if (validated.mantissa !== undefined) {\n      query.set(\"mantissa\", String(validated.mantissa));\n    }\n    const queryString = query.toString();\n    const url = `${this.client.http.baseUrl()}/api/orderbook/${encodeURIComponent(orderbookId)}${queryString ? `?${queryString}` : \"\"}`;\n    return this.client.http.get<OrderbookDepthResponse>(url, RetryPolicy.Idempotent);\n  }\n\n  // ── On-chain transaction builders ────────────────────────────────────\n\n  closeOrderbookAltIx(params: CloseOrderbookAltParams): TransactionInstruction {\n    return buildCloseOrderbookAltIx(params, this.client.programId);\n  }\n\n  closeOrderbookIx(params: CloseOrderbookParams): TransactionInstruction {\n    return buildCloseOrderbookIx(params, this.client.programId);\n  }\n\n  closeOrderbookAltTx(params: CloseOrderbookAltParams): Transaction {\n    const ix = this.closeOrderbookAltIx(params);\n    return new Transaction({ feePayer: params.operator }).add(ix);\n  }\n\n  closeOrderbookTx(params: CloseOrderbookParams): Transaction {\n    const ix = this.closeOrderbookIx(params);\n    return new Transaction({ feePayer: params.operator }).add(ix);\n  }\n\n  // ── On-chain account fetchers (require Connection) ──────────────────\n\n  async getOnchain(mintA: PublicKey, mintB: PublicKey): Promise<ProgramOrderbook> {\n    const connection = requireConnection(this.client);\n    const orderbookPda = this.pda(mintA, mintB);\n    const accountInfo = await connection.getAccountInfo(orderbookPda);\n    if (!accountInfo) {\n      throw ProgramSdkError.accountNotFound(\n        `Orderbook for ${mintA.toBase58()} / ${mintB.toBase58()}`\n      );\n    }\n    return deserializeProgramOrderbook(accountInfo.data as Buffer);\n  }\n}\n"]}

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

@@ -3,6 +3,7 @@ import { PublicKey } from "@solana/web3.js";
 import type { OrderBookId, PubkeyStr } from "../../shared";
 import type { OrderbookDecimals } from "../../shared/scaling";
 import type { ConditionalToken } from "../market";
+export * from "./aggregation";
 export * from "./client";
 export * from "./wire";
 export * from "./state";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO5F;AAED,wBAAgB,MAAM,CACpB,iBAAiB,EAAE,OAAO,EAC1B,gBAAgB,EAAE,OAAO,GACxB,aAAa,CAef;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,iBAAiB,CAUxE;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAE9D;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAEhE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAEjE;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAEf,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;CAMnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/orderbook/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO5F;AAED,wBAAgB,MAAM,CACpB,iBAAiB,EAAE,OAAO,EAC1B,gBAAgB,EAAE,OAAO,GACxB,aAAa,CAef;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,iBAAiB,CAUxE;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAE9D;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAEhE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAEjE;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAEf,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;CAMnD"}

package/dist/domain/orderbook/index.js

@@ -22,6 +22,7 @@ exports.orderBookMarket = orderBookMarket;
 exports.orderBookBaseMint = orderBookBaseMint;
 exports.orderBookQuoteMint = orderBookQuoteMint;
 const web3_js_1 = require("@solana/web3.js");
+__exportStar(require("./aggregation"), exports);
 __exportStar(require("./client"), exports);
 __exportStar(require("./wire"), exports);
 __exportStar(require("./state"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/orderbook/index.ts"],"names":[],"mappings":"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","sourcesContent":["import Decimal from \"decimal.js\";\nimport { PublicKey } from \"@solana/web3.js\";\nimport type { OrderBookId, PubkeyStr } from \"../../shared\";\nimport type { OrderbookDecimals } from \"../../shared/scaling\";\nimport type { ConditionalToken } from \"../market\";\n\nexport * from \"./client\";\nexport * from \"./wire\";\nexport * from \"./state\";\nexport * from \"./ticker\";\nexport { orderBookPairFromWire } from \"./convert\";\n\nexport interface OrderBookPair {\n  id: number;\n  marketPubkey: PubkeyStr;\n  orderbookId: OrderBookId;\n  base: ConditionalToken;\n  quote: ConditionalToken;\n  outcomeIndex: number;\n  tickSize: number;\n  totalBids: number;\n  totalAsks: number;\n  lastTradePrice?: string;\n  lastTradeTime?: Date;\n  active: boolean;\n}\n\nexport interface OutcomeImpact {\n  sign: string;\n  pct: number;\n  dollar: string;\n  isPositive: boolean;\n}\n\nexport function impactPct(depositPrice: Decimal, conditionalPrice: Decimal): [number, string] {\n  if (depositPrice.isZero() || conditionalPrice.isZero()) {\n    return [0, \"\"];\n  }\n\n  const value = conditionalPrice.minus(depositPrice).div(depositPrice).mul(100);\n  return [value.toNumber(), value.greaterThan(0) ? \"+\" : \"\"];\n}\n\nexport function impact(\n  depositAssetPrice: Decimal,\n  conditionalPrice: Decimal\n): OutcomeImpact {\n  if (depositAssetPrice.isZero()) {\n    return { sign: \"\", pct: 0, dollar: \"0\", isPositive: false };\n  }\n\n  const pctDecimal = conditionalPrice.minus(depositAssetPrice).div(depositAssetPrice).mul(100);\n  const pct = pctDecimal.toNumber();\n  const dollar = conditionalPrice.minus(depositAssetPrice).abs().toString();\n\n  return {\n    sign: pct > 0 ? \"+\" : \"-\",\n    pct: Math.abs(pct),\n    dollar,\n    isPositive: pct > 0,\n  };\n}\n\n/**\n * Derive scaling decimals from an orderbook pair's token metadata.\n *\n * No REST call needed — decimals are computed from the base/quote token objects.\n */\nexport function orderbookDecimals(pair: OrderBookPair): OrderbookDecimals {\n  const baseDecimals = pair.base.decimals;\n  const quoteDecimals = pair.quote.decimals;\n  return {\n    orderbookId: pair.orderbookId,\n    baseDecimals,\n    quoteDecimals,\n    priceDecimals: Math.max(0, 6 + quoteDecimals - baseDecimals),\n    tickSize: BigInt(Math.max(pair.tickSize, 0)),\n  };\n}\n\n/** Return the market as a `PublicKey`. */\nexport function orderBookMarket(pair: OrderBookPair): PublicKey {\n  return new PublicKey(pair.marketPubkey);\n}\n\n/** Return the base conditional-token mint as a `PublicKey`. */\nexport function orderBookBaseMint(pair: OrderBookPair): PublicKey {\n  return new PublicKey(pair.base.pubkey);\n}\n\n/** Return the quote conditional-token mint as a `PublicKey`. */\nexport function orderBookQuoteMint(pair: OrderBookPair): PublicKey {\n  return new PublicKey(pair.quote.pubkey);\n}\n\nexport class OrderBookValidationError extends Error {\n  readonly orderbookId: string;\n  readonly details: string[];\n\n  constructor(orderbookId: string, details: string[]) {\n    super(`OrderBook validation errors (${orderbookId}): ${details.join(\"; \")}`);\n    this.name = \"OrderBookValidationError\";\n    this.orderbookId = orderbookId;\n    this.details = details;\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/orderbook/index.ts"],"names":[],"mappings":"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","sourcesContent":["import Decimal from \"decimal.js\";\nimport { PublicKey } from \"@solana/web3.js\";\nimport type { OrderBookId, PubkeyStr } from \"../../shared\";\nimport type { OrderbookDecimals } from \"../../shared/scaling\";\nimport type { ConditionalToken } from \"../market\";\n\nexport * from \"./aggregation\";\nexport * from \"./client\";\nexport * from \"./wire\";\nexport * from \"./state\";\nexport * from \"./ticker\";\nexport { orderBookPairFromWire } from \"./convert\";\n\nexport interface OrderBookPair {\n  id: number;\n  marketPubkey: PubkeyStr;\n  orderbookId: OrderBookId;\n  base: ConditionalToken;\n  quote: ConditionalToken;\n  outcomeIndex: number;\n  tickSize: number;\n  totalBids: number;\n  totalAsks: number;\n  lastTradePrice?: string;\n  lastTradeTime?: Date;\n  active: boolean;\n}\n\nexport interface OutcomeImpact {\n  sign: string;\n  pct: number;\n  dollar: string;\n  isPositive: boolean;\n}\n\nexport function impactPct(depositPrice: Decimal, conditionalPrice: Decimal): [number, string] {\n  if (depositPrice.isZero() || conditionalPrice.isZero()) {\n    return [0, \"\"];\n  }\n\n  const value = conditionalPrice.minus(depositPrice).div(depositPrice).mul(100);\n  return [value.toNumber(), value.greaterThan(0) ? \"+\" : \"\"];\n}\n\nexport function impact(\n  depositAssetPrice: Decimal,\n  conditionalPrice: Decimal\n): OutcomeImpact {\n  if (depositAssetPrice.isZero()) {\n    return { sign: \"\", pct: 0, dollar: \"0\", isPositive: false };\n  }\n\n  const pctDecimal = conditionalPrice.minus(depositAssetPrice).div(depositAssetPrice).mul(100);\n  const pct = pctDecimal.toNumber();\n  const dollar = conditionalPrice.minus(depositAssetPrice).abs().toString();\n\n  return {\n    sign: pct > 0 ? \"+\" : \"-\",\n    pct: Math.abs(pct),\n    dollar,\n    isPositive: pct > 0,\n  };\n}\n\n/**\n * Derive scaling decimals from an orderbook pair's token metadata.\n *\n * No REST call needed — decimals are computed from the base/quote token objects.\n */\nexport function orderbookDecimals(pair: OrderBookPair): OrderbookDecimals {\n  const baseDecimals = pair.base.decimals;\n  const quoteDecimals = pair.quote.decimals;\n  return {\n    orderbookId: pair.orderbookId,\n    baseDecimals,\n    quoteDecimals,\n    priceDecimals: Math.max(0, 6 + quoteDecimals - baseDecimals),\n    tickSize: BigInt(Math.max(pair.tickSize, 0)),\n  };\n}\n\n/** Return the market as a `PublicKey`. */\nexport function orderBookMarket(pair: OrderBookPair): PublicKey {\n  return new PublicKey(pair.marketPubkey);\n}\n\n/** Return the base conditional-token mint as a `PublicKey`. */\nexport function orderBookBaseMint(pair: OrderBookPair): PublicKey {\n  return new PublicKey(pair.base.pubkey);\n}\n\n/** Return the quote conditional-token mint as a `PublicKey`. */\nexport function orderBookQuoteMint(pair: OrderBookPair): PublicKey {\n  return new PublicKey(pair.quote.pubkey);\n}\n\nexport class OrderBookValidationError extends Error {\n  readonly orderbookId: string;\n  readonly details: string[];\n\n  constructor(orderbookId: string, details: string[]) {\n    super(`OrderBook validation errors (${orderbookId}): ${details.join(\"; \")}`);\n    this.name = \"OrderBookValidationError\";\n    this.orderbookId = orderbookId;\n    this.details = details;\n  }\n}\n"]}

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":";;;;;;AAAA,4DAAiC;AAmBjC,MAAa,cAAc;IAChB,WAAW,CAAc;IAClC,GAAG,CAAS;IACK,OAAO,CAAsB;IAC7B,OAAO,CAAsB;IACtC,aAAa,CAA4B;IACzC,aAAa,CAA4B;IACzC,WAAW,CAAU;IACrB,gBAAgB,CAAU;IAElC,YAAY,WAAwB;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAe;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAE1B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC7B,OAAO;gBACL,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,EAAE;aAC5C,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,GAAG,EAAE,GAAG,EAAE;iBACxD,CAAC;YACJ,CAAC;YAED,oEAAoE;YACpE,iEAAiE;YACjE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBACb,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,GAAG,EAAE,GAAG,EAAE;iBACrD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAC7B,OAAO;oBACL,IAAI,EAAE,kBAAkB;oBACxB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG,EAAE;iBAC/C,CAAC;YACJ,CAAC;YAED,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACpB,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;iBAC7D,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YAC9B,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACrB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAC7B,OAAO;oBACL,IAAI,EAAE,kBAAkB;oBACxB,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE;iBACrD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QAEf,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,oBAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,oBAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,oBAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,oBAAO,CAAC,CAAC,CAAC,CAAC,CAAC;aAClD,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACV,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,oBAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,oBAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,oBAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;IAED,MAAM;QACJ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,oBAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAChC,CAAC;CACF;AAtLD,wCAsLC","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";
     }
 }
 /**