@symmio/trading-core 1.0.1 → 2.0.0

package/dist/websocket/prices/parse-binance-price-frame.d.ts

@@ -0,0 +1,25 @@
+import { BinanceMarkPriceTick } from '../../price-service/types.js';
+/**
+ * Parse one inbound `!markPrice@arr@1s` frame into normalized ticks, or `null`
+ * when the payload is not a price push (control frame, malformed JSON,
+ * unexpected shape).
+ *
+ * Returning `null` rather than `[]` for a non-price frame matches
+ * `parsePriceFrame`'s contract, so both watchers share the identical
+ * "nothing to deliver" guard.
+ *
+ * Deliberately **not** a generalization of `parsePriceFrame`: that parser
+ * requires `name` + `markPrice`, while Binance sends `s` + `p`, so feeding
+ * Binance frames to it yields an empty array for every message — a feed that
+ * reports `open` and never ticks. Two small parsers beat one that can silently
+ * mis-handle either vendor.
+ *
+ * Accepts three envelopes so one watcher works against a raw stream, a combined
+ * stream, and a single-symbol stream. Reads only the keys it needs, because the
+ * live wire carries fields Binance's own docs omit (`ap`, `st`).
+ *
+ * @param data - Raw WebSocket payload (string or already-parsed value).
+ * @returns Normalized ticks, or `null` when the frame is not a price push.
+ */
+export declare function parseBinancePriceFrame(data: unknown): BinanceMarkPriceTick[] | null;
+//# sourceMappingURL=parse-binance-price-frame.d.ts.map

package/dist/websocket/prices/parse-binance-price-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-binance-price-frame.d.ts","sourceRoot":"","sources":["../../../src/websocket/prices/parse-binance-price-frame.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,EAAE,GAAG,IAAI,CAYnF"}

package/dist/websocket/prices/parse-binance-price-frame.js

@@ -0,0 +1,55 @@
+//#region src/websocket/prices/parse-binance-price-frame.ts
+function e(e) {
+	if (e === t) return n;
+	let i = r(e);
+	return t = e, n = i, i;
+}
+var t = Symbol("no-frame"), n = null;
+function r(e) {
+	let t = i(e);
+	if (t === null) return null;
+	let n = a(t);
+	if (!n) return null;
+	let r = [];
+	for (let e of n) {
+		let t = o(e);
+		t && r.push(t);
+	}
+	return r;
+}
+function i(e) {
+	if (typeof e != "string") return e ?? null;
+	try {
+		return JSON.parse(e);
+	} catch {
+		return null;
+	}
+}
+function a(e) {
+	if (Array.isArray(e)) return e;
+	if (typeof e != "object" || !e) return null;
+	let t = e.data;
+	if (Array.isArray(t)) return t;
+	if (t && typeof t == "object") return [t];
+	let n = e;
+	return typeof n.s == "string" && n.p !== void 0 ? [e] : null;
+}
+function o(e) {
+	if (typeof e != "object" || !e) return null;
+	let t = e;
+	if (typeof t.s != "string" || t.s.length === 0 || typeof t.p != "string" && typeof t.p != "number") return null;
+	let n = String(t.p);
+	return n.length === 0 || !Number.isFinite(Number(n)) ? null : {
+		provider: "binance",
+		name: t.s,
+		markPrice: n,
+		indexPrice: t.i === void 0 ? "" : String(t.i),
+		binanceLastFundingRate: t.r === void 0 ? "" : String(t.r),
+		binanceNextFundingTime: typeof t.T == "number" ? t.T : 0,
+		...typeof t.E == "number" ? { time: t.E } : {}
+	};
+}
+//#endregion
+export { e as parseBinancePriceFrame };
+
+//# sourceMappingURL=parse-binance-price-frame.js.map

package/dist/websocket/prices/parse-binance-price-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-binance-price-frame.js","names":[],"sources":["../../../src/websocket/prices/parse-binance-price-frame.ts"],"sourcesContent":["import type { RawBinanceMarkPriceFrame } from \"../../price-service/binance/types\";\nimport type { BinanceMarkPriceTick } from \"../../price-service/types\";\n\n/**\n * Parse one inbound `!markPrice@arr@1s` frame into normalized ticks, or `null`\n * when the payload is not a price push (control frame, malformed JSON,\n * unexpected shape).\n *\n * Returning `null` rather than `[]` for a non-price frame matches\n * `parsePriceFrame`'s contract, so both watchers share the identical\n * \"nothing to deliver\" guard.\n *\n * Deliberately **not** a generalization of `parsePriceFrame`: that parser\n * requires `name` + `markPrice`, while Binance sends `s` + `p`, so feeding\n * Binance frames to it yields an empty array for every message — a feed that\n * reports `open` and never ticks. Two small parsers beat one that can silently\n * mis-handle either vendor.\n *\n * Accepts three envelopes so one watcher works against a raw stream, a combined\n * stream, and a single-symbol stream. Reads only the keys it needs, because the\n * live wire carries fields Binance's own docs omit (`ap`, `st`).\n *\n * @param data - Raw WebSocket payload (string or already-parsed value).\n * @returns Normalized ticks, or `null` when the frame is not a price push.\n */\nexport function parseBinancePriceFrame(data: unknown): BinanceMarkPriceTick[] | null {\n  if (data === memoRaw) return memoParsed;\n\n  const parsed = parseFrame(data);\n\n  // Cache by reference identity only. The socket pool fans the *same* `data`\n  // value synchronously to every listener, so N watchers on one stream would\n  // otherwise each re-parse the full ~740-entry array once per second. Holding\n  // one frame costs nothing and collapses that to a single parse.\n  memoRaw = data;\n  memoParsed = parsed;\n  return parsed;\n}\n\n/** Last raw payload seen, held only to dedupe the per-listener fan-out. @internal */\nlet memoRaw: unknown = Symbol(\"no-frame\");\n/** Parse result for {@link memoRaw}. @internal */\nlet memoParsed: BinanceMarkPriceTick[] | null = null;\n\n/** @internal */\nfunction parseFrame(data: unknown): BinanceMarkPriceTick[] | null {\n  const payload = decode(data);\n  if (payload === null) return null;\n\n  const entries = toEntries(payload);\n  if (!entries) return null;\n\n  const ticks: BinanceMarkPriceTick[] = [];\n  for (const entry of entries) {\n    const tick = toTick(entry);\n    if (tick) ticks.push(tick);\n  }\n  return ticks;\n}\n\n/** @internal */\nfunction decode(data: unknown): unknown {\n  if (typeof data !== \"string\") return data ?? null;\n  try {\n    return JSON.parse(data);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Unwrap the three envelopes: a top-level array (the raw-stream case), a\n * `{ stream, data }` combined-stream wrapper, and a bare single object.\n *\n * @internal\n */\nfunction toEntries(payload: unknown): unknown[] | null {\n  if (Array.isArray(payload)) return payload;\n  if (typeof payload !== \"object\" || payload === null) return null;\n\n  const wrapped = (payload as { data?: unknown }).data;\n  if (Array.isArray(wrapped)) return wrapped;\n  if (wrapped && typeof wrapped === \"object\") return [wrapped];\n\n  // A bare object is only a price push if it carries the two required fields;\n  // otherwise it is a control frame (subscribe ack, error, pong).\n  const candidate = payload as Partial<RawBinanceMarkPriceFrame>;\n  return typeof candidate.s === \"string\" && candidate.p !== undefined ? [payload] : null;\n}\n\n/**\n * Map one entry, or `null` when it lacks the two fields a mark price cannot be\n * built without.\n *\n * A numeric `p` is coerced with `String()` rather than arithmetic, so no price\n * is ever routed through a float. Missing optional fields default rather than\n * dropping the entry: a mark price with no funding attached is still a usable\n * mark price.\n *\n * @internal\n */\nfunction toTick(entry: unknown): BinanceMarkPriceTick | null {\n  if (typeof entry !== \"object\" || entry === null) return null;\n  const raw = entry as Partial<RawBinanceMarkPriceFrame>;\n\n  if (typeof raw.s !== \"string\" || raw.s.length === 0) return null;\n  if (typeof raw.p !== \"string\" && typeof raw.p !== \"number\") return null;\n  const markPrice = String(raw.p);\n  if (markPrice.length === 0 || !Number.isFinite(Number(markPrice))) return null;\n\n  return {\n    provider: \"binance\",\n    name: raw.s,\n    markPrice,\n    indexPrice: raw.i !== undefined ? String(raw.i) : \"\",\n    binanceLastFundingRate: raw.r !== undefined ? String(raw.r) : \"\",\n    binanceNextFundingTime: typeof raw.T === \"number\" ? raw.T : 0,\n    ...(typeof raw.E === \"number\" ? { time: raw.E } : {}),\n  };\n}\n"],"mappings":";AAyBA,SAAgB,EAAuB,GAA8C;CACnF,IAAI,MAAS,GAAS,OAAO;CAE7B,IAAM,IAAS,EAAW,CAAI;CAQ9B,OAFA,IAAU,GACV,IAAa,GACN;AACT;AAGA,IAAI,IAAmB,OAAO,UAAU,GAEpC,IAA4C;AAGhD,SAAS,EAAW,GAA8C;CAChE,IAAM,IAAU,EAAO,CAAI;CAC3B,IAAI,MAAY,MAAM,OAAO;CAE7B,IAAM,IAAU,EAAU,CAAO;CACjC,IAAI,CAAC,GAAS,OAAO;CAErB,IAAM,IAAgC,CAAC;CACvC,KAAK,IAAM,KAAS,GAAS;EAC3B,IAAM,IAAO,EAAO,CAAK;EACzB,AAAI,KAAM,EAAM,KAAK,CAAI;CAC3B;CACA,OAAO;AACT;AAGA,SAAS,EAAO,GAAwB;CACtC,IAAI,OAAO,KAAS,UAAU,OAAO,KAAQ;CAC7C,IAAI;EACF,OAAO,KAAK,MAAM,CAAI;CACxB,QAAQ;EACN,OAAO;CACT;AACF;AAQA,SAAS,EAAU,GAAoC;CACrD,IAAI,MAAM,QAAQ,CAAO,GAAG,OAAO;CACnC,IAAI,OAAO,KAAY,aAAY,GAAkB,OAAO;CAE5D,IAAM,IAAW,EAA+B;CAChD,IAAI,MAAM,QAAQ,CAAO,GAAG,OAAO;CACnC,IAAI,KAAW,OAAO,KAAY,UAAU,OAAO,CAAC,CAAO;CAI3D,IAAM,IAAY;CAClB,OAAO,OAAO,EAAU,KAAM,YAAY,EAAU,MAAM,KAAA,IAAY,CAAC,CAAO,IAAI;AACpF;AAaA,SAAS,EAAO,GAA6C;CAC3D,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CACxD,IAAM,IAAM;CAGZ,IADI,OAAO,EAAI,KAAM,YAAY,EAAI,EAAE,WAAW,KAC9C,OAAO,EAAI,KAAM,YAAY,OAAO,EAAI,KAAM,UAAU,OAAO;CACnE,IAAM,IAAY,OAAO,EAAI,CAAC;CAG9B,OAFI,EAAU,WAAW,KAAK,CAAC,OAAO,SAAS,OAAO,CAAS,CAAC,IAAU,OAEnE;EACL,UAAU;EACV,MAAM,EAAI;EACV;EACA,YAAY,EAAI,MAAM,KAAA,IAA4B,KAAhB,OAAO,EAAI,CAAC;EAC9C,wBAAwB,EAAI,MAAM,KAAA,IAA4B,KAAhB,OAAO,EAAI,CAAC;EAC1D,wBAAwB,OAAO,EAAI,KAAM,WAAW,EAAI,IAAI;EAC5D,GAAI,OAAO,EAAI,KAAM,WAAW,EAAE,MAAM,EAAI,EAAE,IAAI,CAAC;CACrD;AACF"}

package/dist/websocket/prices/watch-binance-prices.d.ts

@@ -0,0 +1,89 @@
+import { SolverId } from '../../core/chains/types.js';
+import { Config } from '../../core/config/index.js';
+import { BinanceMarkPriceTick } from '../../price-service/types.js';
+import { SymmError } from '../../shared/errors/symm-error.js';
+import { Unwatch } from '../notifications/types.js';
+import { SocketStatus } from '../socket/socket-status.js';
+/**
+ * Parameters for {@link watchBinancePrices}.
+ */
+export interface WatchBinancePricesParameters {
+    /** Target chain id. Defaults to the config's `defaultChainId`. */
+    chainId?: number;
+    /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */
+    solverId?: SolverId;
+    /**
+     * Deliver ticks only for these market names (case-insensitive).
+     *
+     * **This filters delivery, it does not narrow the subscription.**
+     * `!markPrice@arr@1s` is an all-market broadcast — there is no subscribe frame
+     * and no way to ask for a subset — so the socket still receives every listed
+     * symbol (~740) once per second regardless of what you pass here. The filter
+     * runs per watcher after parsing.
+     *
+     * What it saves is everything downstream of `onPrices`: the callback fires
+     * with 3 ticks instead of ~740, which is the difference between a handful of
+     * state updates per second and a full-map churn. What it does **not** save is
+     * bandwidth or the parse itself (one parse per frame is shared across all
+     * watchers on the stream).
+     *
+     * Watchers with different filters still share one socket — the filter is
+     * deliberately not part of the pool key, since filtering at the socket would
+     * starve siblings.
+     *
+     * If you need to actually reduce what crosses the wire, Binance also serves
+     * per-symbol streams (`<symbol>@markPrice@1s`); point `priceService.wsUrl` at
+     * one and omit `names`. That trades the shared all-market socket for one
+     * connection per symbol.
+     */
+    names?: readonly string[];
+    /**
+     * Called for every parsed (and filtered) batch of ticks.
+     *
+     * **Treat the batch and its ticks as read-only.** One frame is parsed once and
+     * shared across every watcher on the stream, so mutating a tick in place would
+     * be visible to the others. Copy before transforming.
+     */
+    onPrices: (prices: BinanceMarkPriceTick[]) => void;
+    /** Called whenever the underlying connection status changes. */
+    onStatusChange?: (status: SocketStatus) => void;
+    /** Called on a transport or parse error; does not stop the subscription. */
+    onError?: (error: SymmError) => void;
+}
+/**
+ * Subscribe to Binance USD-M Futures' all-market mark-price stream.
+ *
+ * The endpoint is broadcast-only — there is no subscribe frame; every connected
+ * client receives the same 1/sec array of ticks. Watchers sharing the same
+ * `wsUrl` share one underlying socket; it closes when the last watcher
+ * unwatches.
+ *
+ * The URL is taken verbatim from `priceService.wsUrl` and dialled as-is. The
+ * registry default is `wss://fstream.binance.com/market/ws/!markPrice@arr@1s`:
+ * Binance's *documented* `/ws/<stream>` form was measured to connect and then
+ * never push a frame, so using it would ship a feed that reports `open` and
+ * silently never ticks. Keeping the whole URL in config means a routing change
+ * or a proxy is a one-value override.
+ *
+ * Binance force-closes a connection every 24h with a clean code; the shared
+ * reconnecting socket never inspects the close code, so that reconnects like any
+ * other drop with no extra handling.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Handlers, optional chain/solver override, optional name filter.
+ * @returns An unwatch function that releases this subscription.
+ * @throws {SymmError} synchronously when the chain is unsupported, the resolved
+ *   price service is not Binance (`UNSUPPORTED_BY_PRICE_SERVICE`), there is no
+ *   `wsUrl` configured, or no `WebSocket` implementation exists.
+ *
+ * @example
+ * ```ts
+ * const unwatch = watchBinancePrices(config, {
+ *   solverId: "rasa",
+ *   names: ["BTCUSDT"],
+ *   onPrices: (ticks) => console.log(ticks[0]?.markPrice),
+ * });
+ * ```
+ */
+export declare function watchBinancePrices(config: Config, parameters: WatchBinancePricesParameters): Unwatch;
+//# sourceMappingURL=watch-binance-prices.d.ts.map

package/dist/websocket/prices/watch-binance-prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-binance-prices.d.ts","sourceRoot":"","sources":["../../../src/websocket/prices/watch-binance-prices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,IAAI,CAAC;IACnD,gEAAgE;IAChE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,4BAA4B,GAAG,OAAO,CAwDpG"}

package/dist/websocket/prices/watch-binance-prices.js

@@ -0,0 +1,53 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { createReconnectingSocket as t } from "../socket/create-reconnecting-socket.js";
+import { getSocketPool as n } from "../socket/get-socket-pool.js";
+import { parseBinancePriceFrame as r } from "./parse-binance-price-frame.js";
+import { assertPriceServiceProvider as i } from "../../price-service/assert-price-service-provider.js";
+import { resolvePriceService as a } from "../../price-service/resolve-price-service.js";
+//#region src/websocket/prices/watch-binance-prices.ts
+function o(t) {
+	if (t instanceof e) return t;
+	let n = t instanceof Error ? t : void 0;
+	return new e("api", "PRICES_SOCKET_ERROR", `Prices socket error${n ? `: ${n.message}` : "."}`, { cause: n });
+}
+function s(s, c) {
+	let { chainId: l, solverId: u, names: d, onPrices: f, onStatusChange: p, onError: m } = c, h = a(s, {
+		chainId: l,
+		solverId: u
+	});
+	i(h, "binance", "watchBinancePrices");
+	let g = h.wsUrl;
+	if (!g) throw new e("config", "PRICES_WS_NOT_CONFIGURED", "Chain has no `priceService.wsUrl` configured.");
+	let _ = s.getWebSocketConstructor(), v = d?.length ? new Set(d.map((e) => e.trim().toUpperCase())) : void 0, y = `${g}|binance-mark-prices`;
+	return n(s).acquire(y, (e) => t({
+		url: g,
+		webSocketConstructor: _,
+		getOpenMessages: () => [],
+		onMessage: e.onMessage,
+		onStatusChange: e.onStatusChange,
+		onError: e.onError
+	}), {
+		onMessage: (e) => {
+			let t;
+			try {
+				t = r(e);
+			} catch (e) {
+				m?.(o(e));
+				return;
+			}
+			if (!t || t.length === 0) return;
+			let n = v ? t.filter((e) => v.has(e.name.toUpperCase())) : t;
+			if (n.length !== 0) try {
+				f(n);
+			} catch (e) {
+				m?.(o(e));
+			}
+		},
+		onStatusChange: p,
+		onError: (e) => m?.(o(e))
+	});
+}
+//#endregion
+export { s as watchBinancePrices };
+
+//# sourceMappingURL=watch-binance-prices.js.map

package/dist/websocket/prices/watch-binance-prices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-binance-prices.js","names":[],"sources":["../../../src/websocket/prices/watch-binance-prices.ts"],"sourcesContent":["import type { SolverId } from \"../../core/chains/types\";\nimport type { Config } from \"../../core/config\";\nimport { assertPriceServiceProvider } from \"../../price-service/assert-price-service-provider\";\nimport { resolvePriceService } from \"../../price-service/resolve-price-service\";\nimport type { BinanceMarkPriceTick } from \"../../price-service/types\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { Unwatch } from \"../notifications/types\";\nimport { createReconnectingSocket } from \"../socket/create-reconnecting-socket\";\nimport { getSocketPool } from \"../socket/get-socket-pool\";\nimport type { SocketStatus } from \"../socket/socket-status\";\nimport { parseBinancePriceFrame } from \"./parse-binance-price-frame\";\n\n/**\n * Parameters for {@link watchBinancePrices}.\n */\nexport interface WatchBinancePricesParameters {\n  /** Target chain id. Defaults to the config's `defaultChainId`. */\n  chainId?: number;\n  /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */\n  solverId?: SolverId;\n  /**\n   * Deliver ticks only for these market names (case-insensitive).\n   *\n   * **This filters delivery, it does not narrow the subscription.**\n   * `!markPrice@arr@1s` is an all-market broadcast — there is no subscribe frame\n   * and no way to ask for a subset — so the socket still receives every listed\n   * symbol (~740) once per second regardless of what you pass here. The filter\n   * runs per watcher after parsing.\n   *\n   * What it saves is everything downstream of `onPrices`: the callback fires\n   * with 3 ticks instead of ~740, which is the difference between a handful of\n   * state updates per second and a full-map churn. What it does **not** save is\n   * bandwidth or the parse itself (one parse per frame is shared across all\n   * watchers on the stream).\n   *\n   * Watchers with different filters still share one socket — the filter is\n   * deliberately not part of the pool key, since filtering at the socket would\n   * starve siblings.\n   *\n   * If you need to actually reduce what crosses the wire, Binance also serves\n   * per-symbol streams (`<symbol>@markPrice@1s`); point `priceService.wsUrl` at\n   * one and omit `names`. That trades the shared all-market socket for one\n   * connection per symbol.\n   */\n  names?: readonly string[];\n  /**\n   * Called for every parsed (and filtered) batch of ticks.\n   *\n   * **Treat the batch and its ticks as read-only.** One frame is parsed once and\n   * shared across every watcher on the stream, so mutating a tick in place would\n   * be visible to the others. Copy before transforming.\n   */\n  onPrices: (prices: BinanceMarkPriceTick[]) => void;\n  /** Called whenever the underlying connection status changes. */\n  onStatusChange?: (status: SocketStatus) => void;\n  /** Called on a transport or parse error; does not stop the subscription. */\n  onError?: (error: SymmError) => void;\n}\n\n/** @internal */\nfunction toPricesError(event: unknown): SymmError {\n  if (event instanceof SymmError) return event;\n  const cause = event instanceof Error ? event : undefined;\n  return new SymmError(\"api\", \"PRICES_SOCKET_ERROR\", `Prices socket error${cause ? `: ${cause.message}` : \".\"}`, {\n    cause,\n  });\n}\n\n/**\n * Subscribe to Binance USD-M Futures' all-market mark-price stream.\n *\n * The endpoint is broadcast-only — there is no subscribe frame; every connected\n * client receives the same 1/sec array of ticks. Watchers sharing the same\n * `wsUrl` share one underlying socket; it closes when the last watcher\n * unwatches.\n *\n * The URL is taken verbatim from `priceService.wsUrl` and dialled as-is. The\n * registry default is `wss://fstream.binance.com/market/ws/!markPrice@arr@1s`:\n * Binance's *documented* `/ws/<stream>` form was measured to connect and then\n * never push a frame, so using it would ship a feed that reports `open` and\n * silently never ticks. Keeping the whole URL in config means a routing change\n * or a proxy is a one-value override.\n *\n * Binance force-closes a connection every 24h with a clean code; the shared\n * reconnecting socket never inspects the close code, so that reconnects like any\n * other drop with no extra handling.\n *\n * @param config - The SDK config.\n * @param parameters - Handlers, optional chain/solver override, optional name filter.\n * @returns An unwatch function that releases this subscription.\n * @throws {SymmError} synchronously when the chain is unsupported, the resolved\n *   price service is not Binance (`UNSUPPORTED_BY_PRICE_SERVICE`), there is no\n *   `wsUrl` configured, or no `WebSocket` implementation exists.\n *\n * @example\n * ```ts\n * const unwatch = watchBinancePrices(config, {\n *   solverId: \"rasa\",\n *   names: [\"BTCUSDT\"],\n *   onPrices: (ticks) => console.log(ticks[0]?.markPrice),\n * });\n * ```\n */\nexport function watchBinancePrices(config: Config, parameters: WatchBinancePricesParameters): Unwatch {\n  const { chainId, solverId, names, onPrices, onStatusChange, onError } = parameters;\n\n  const priceService = resolvePriceService(config, { chainId, solverId });\n  assertPriceServiceProvider(priceService, \"binance\", \"watchBinancePrices\");\n\n  const wsUrl = priceService.wsUrl;\n  if (!wsUrl) {\n    throw new SymmError(\"config\", \"PRICES_WS_NOT_CONFIGURED\", \"Chain has no `priceService.wsUrl` configured.\");\n  }\n  const webSocketConstructor = config.getWebSocketConstructor();\n\n  /**\n   * The filter is per-listener and deliberately absent from the pool key: the\n   * pool fans one frame to every listener, so filtering at the socket would\n   * starve siblings that asked for different names.\n   */\n  const wanted = names?.length ? new Set(names.map((name) => name.trim().toUpperCase())) : undefined;\n\n  const key = `${wsUrl}|binance-mark-prices`;\n\n  return getSocketPool(config).acquire(\n    key,\n    (handlers) =>\n      createReconnectingSocket({\n        url: wsUrl,\n        webSocketConstructor,\n        getOpenMessages: () => [],\n        onMessage: handlers.onMessage,\n        onStatusChange: handlers.onStatusChange,\n        onError: handlers.onError,\n      }),\n    {\n      onMessage: (data) => {\n        let ticks;\n        try {\n          ticks = parseBinancePriceFrame(data);\n        } catch (err) {\n          onError?.(toPricesError(err));\n          return;\n        }\n        if (!ticks || ticks.length === 0) return;\n\n        const delivered = wanted ? ticks.filter((tick) => wanted.has(tick.name.toUpperCase())) : ticks;\n        if (delivered.length === 0) return;\n\n        try {\n          onPrices(delivered);\n        } catch (err) {\n          onError?.(toPricesError(err));\n        }\n      },\n      onStatusChange,\n      onError: (event) => onError?.(toPricesError(event)),\n    },\n  );\n}\n"],"mappings":";;;;;;;AA4DA,SAAS,EAAc,GAA2B;CAChD,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EAAU,OAAO,uBAAuB,sBAAsB,IAAQ,KAAK,EAAM,YAAY,OAAO,EAC7G,SACF,CAAC;AACH;AAqCA,SAAgB,EAAmB,GAAgB,GAAmD;CACpG,IAAM,EAAE,YAAS,aAAU,UAAO,aAAU,mBAAgB,eAAY,GAElE,IAAe,EAAoB,GAAQ;EAAE;EAAS;CAAS,CAAC;CACtE,EAA2B,GAAc,WAAW,oBAAoB;CAExE,IAAM,IAAQ,EAAa;CAC3B,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,UAAU,4BAA4B,+CAA+C;CAE3G,IAAM,IAAuB,EAAO,wBAAwB,GAOtD,IAAS,GAAO,SAAS,IAAI,IAAI,EAAM,KAAK,MAAS,EAAK,KAAK,EAAE,YAAY,CAAC,CAAC,IAAI,KAAA,GAEnF,IAAM,GAAG,EAAM;CAErB,OAAO,EAAc,CAAM,EAAE,QAC3B,IACC,MACC,EAAyB;EACvB,KAAK;EACL;EACA,uBAAuB,CAAC;EACxB,WAAW,EAAS;EACpB,gBAAgB,EAAS;EACzB,SAAS,EAAS;CACpB,CAAC,GACH;EACE,YAAY,MAAS;GACnB,IAAI;GACJ,IAAI;IACF,IAAQ,EAAuB,CAAI;GACrC,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;IAC5B;GACF;GACA,IAAI,CAAC,KAAS,EAAM,WAAW,GAAG;GAElC,IAAM,IAAY,IAAS,EAAM,QAAQ,MAAS,EAAO,IAAI,EAAK,KAAK,YAAY,CAAC,CAAC,IAAI;GACrF,MAAU,WAAW,GAEzB,IAAI;IACF,EAAS,CAAS;GACpB,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;GAC9B;EACF;EACA;EACA,UAAU,MAAU,IAAU,EAAc,CAAK,CAAC;CACpD,CACF;AACF"}

package/dist/websocket/prices/watch-enigma-prices.d.ts

@@ -1,6 +1,7 @@
+import { SolverId } from '../../core/chains/types.js';
 import { Config } from '../../core/config/index.js';
 import { SymmError } from '../../shared/errors/symm-error.js';
-import { Unwatch } from '../notifications/watch-notifications.js';
+import { Unwatch } from '../notifications/types.js';
 import { SocketStatus } from '../socket/socket-status.js';
 import { EnigmaPriceTick } from './types.js';
 /**
@@ -9,6 +10,10 @@ import { EnigmaPriceTick } from './types.js';
 export interface WatchEnigmaPricesParameters {
     /** Target chain id. Defaults to the config's `defaultChainId`. */
     chainId?: number;
+    /** Solver whose price provider to resolve. Defaults to the chain's default solver. */
+    solverId?: SolverId;
+    /** Deliver ticks only for these market names (case-insensitive). */
+    names?: readonly string[];
     /** Called for every parsed batch of price ticks. */
     onPrices: (prices: EnigmaPriceTick[]) => void;
     /** Called whenever the underlying connection status changes. */

package/dist/websocket/prices/watch-enigma-prices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-enigma-prices.d.ts","sourceRoot":"","sources":["../../../src/websocket/prices/watch-enigma-prices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAGpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IAC9C,gEAAgE;IAChE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAUD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,2BAA2B,GAAG,OAAO,CA2ClG"}
+{"version":3,"file":"watch-enigma-prices.d.ts","sourceRoot":"","sources":["../../../src/websocket/prices/watch-enigma-prices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IAC9C,gEAAgE;IAChE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAUD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,2BAA2B,GAAG,OAAO,CA0DlG"}

package/dist/websocket/prices/watch-enigma-prices.js

@@ -2,19 +2,26 @@ import { SymmError as e } from "../../shared/errors/symm-error.js";
 import { createReconnectingSocket as t } from "../socket/create-reconnecting-socket.js";
 import { getSocketPool as n } from "../socket/get-socket-pool.js";
 import { parsePriceFrame as r } from "./parse-price-frame.js";
+import { assertPriceServiceProvider as i } from "../../price-service/assert-price-service-provider.js";
+import { resolvePriceService as a } from "../../price-service/resolve-price-service.js";
 //#region src/websocket/prices/watch-enigma-prices.ts
-function i(t) {
+function o(t) {
 	if (t instanceof e) return t;
 	let n = t instanceof Error ? t : void 0;
 	return new e("api", "PRICES_SOCKET_ERROR", `Prices socket error${n ? `: ${n.message}` : "."}`, { cause: n });
 }
-function a(a, o) {
-	let { chainId: s, onPrices: c, onStatusChange: l, onError: u } = o, { priceService: d } = a.getChainConfig(s), f = d.wsUrl;
-	if (!f) throw new e("config", "PRICES_WS_NOT_CONFIGURED", "Chain has no `priceService.wsUrl` configured.");
-	let p = a.getWebSocketConstructor(), m = `${f}|prices`;
-	return n(a).acquire(m, (e) => t({
-		url: f,
-		webSocketConstructor: p,
+function s(s, c) {
+	let { chainId: l, solverId: u, names: d, onPrices: f, onStatusChange: p, onError: m } = c, h = a(s, {
+		chainId: l,
+		solverId: u
+	});
+	i(h, "enigma", "watchEnigmaPrices");
+	let g = h.wsUrl;
+	if (!g) throw new e("config", "PRICES_WS_NOT_CONFIGURED", "Chain has no `priceService.wsUrl` configured.");
+	let _ = s.getWebSocketConstructor(), v = d?.length ? new Set(d.map((e) => e.trim().toUpperCase())) : void 0, y = `${g}|prices`;
+	return n(s).acquire(y, (e) => t({
+		url: g,
+		webSocketConstructor: _,
 		getOpenMessages: () => [],
 		onMessage: e.onMessage,
 		onStatusChange: e.onStatusChange,
@@ -25,20 +32,22 @@ function a(a, o) {
 			try {
 				t = r(e);
 			} catch (e) {
-				u?.(i(e));
+				m?.(o(e));
 				return;
 			}
-			if (!(!t || t.length === 0)) try {
-				c(t);
+			if (!t || t.length === 0) return;
+			let n = v ? t.filter((e) => v.has(e.name.toUpperCase())) : t;
+			if (n.length !== 0) try {
+				f(n);
 			} catch (e) {
-				u?.(i(e));
+				m?.(o(e));
 			}
 		},
-		onStatusChange: l,
-		onError: (e) => u?.(i(e))
+		onStatusChange: p,
+		onError: (e) => m?.(o(e))
 	});
 }
 //#endregion
-export { a as watchEnigmaPrices };
+export { s as watchEnigmaPrices };
 
 //# sourceMappingURL=watch-enigma-prices.js.map

package/dist/websocket/prices/watch-enigma-prices.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch-enigma-prices.js","names":[],"sources":["../../../src/websocket/prices/watch-enigma-prices.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { Unwatch } from \"../notifications/watch-notifications\";\nimport { createReconnectingSocket } from \"../socket/create-reconnecting-socket\";\nimport { getSocketPool } from \"../socket/get-socket-pool\";\nimport type { SocketStatus } from \"../socket/socket-status\";\nimport { parsePriceFrame } from \"./parse-price-frame\";\nimport type { EnigmaPriceTick } from \"./types\";\n\n/**\n * Parameters for {@link watchEnigmaPrices}.\n */\nexport interface WatchEnigmaPricesParameters {\n  /** Target chain id. Defaults to the config's `defaultChainId`. */\n  chainId?: number;\n  /** Called for every parsed batch of price ticks. */\n  onPrices: (prices: EnigmaPriceTick[]) => void;\n  /** Called whenever the underlying connection status changes. */\n  onStatusChange?: (status: SocketStatus) => void;\n  /** Called on a transport or parse error; does not stop the subscription. */\n  onError?: (error: SymmError) => void;\n}\n\nfunction toPricesError(event: unknown): SymmError {\n  if (event instanceof SymmError) return event;\n  const cause = event instanceof Error ? event : undefined;\n  return new SymmError(\"api\", \"PRICES_SOCKET_ERROR\", `Prices socket error${cause ? `: ${cause.message}` : \".\"}`, {\n    cause,\n  });\n}\n\n/**\n * Subscribe to the chain's Enigma lowcap price-service WebSocket.\n *\n * The endpoint is broadcast-only — there is no subscribe message; every\n * connected client receives the same price ticks. Watchers sharing the\n * same `wsUrl` share one underlying socket; it closes when the last\n * watcher unwatches.\n *\n * @param config - The SDK config.\n * @param parameters - Handlers + optional chain override.\n * @returns An unwatch function that releases this subscription.\n * @throws {SymmError} synchronously when the chain is unsupported, has no\n *   `priceService.wsUrl` configured, or no `WebSocket` implementation exists.\n *\n * @example\n * ```ts\n * const unwatch = watchEnigmaPrices(config, {\n *   onPrices: (ticks) => console.log(ticks.length, \"ticks\"),\n *   onStatusChange: (status) => console.log(status),\n * });\n * ```\n */\nexport function watchEnigmaPrices(config: Config, parameters: WatchEnigmaPricesParameters): Unwatch {\n  const { chainId, onPrices, onStatusChange, onError } = parameters;\n\n  const { priceService } = config.getChainConfig(chainId);\n  const wsUrl = priceService.wsUrl;\n  if (!wsUrl) {\n    throw new SymmError(\"config\", \"PRICES_WS_NOT_CONFIGURED\", \"Chain has no `priceService.wsUrl` configured.\");\n  }\n  const webSocketConstructor = config.getWebSocketConstructor();\n\n  const key = `${wsUrl}|prices`;\n\n  return getSocketPool(config).acquire(\n    key,\n    (handlers) =>\n      createReconnectingSocket({\n        url: wsUrl,\n        webSocketConstructor,\n        getOpenMessages: () => [],\n        onMessage: handlers.onMessage,\n        onStatusChange: handlers.onStatusChange,\n        onError: handlers.onError,\n      }),\n    {\n      onMessage: (data) => {\n        let ticks;\n        try {\n          ticks = parsePriceFrame(data);\n        } catch (err) {\n          onError?.(toPricesError(err));\n          return;\n        }\n        if (!ticks || ticks.length === 0) return;\n        try {\n          onPrices(ticks);\n        } catch (err) {\n          onError?.(toPricesError(err));\n        }\n      },\n      onStatusChange,\n      onError: (event) => onError?.(toPricesError(event)),\n    },\n  );\n}\n"],"mappings":";;;;;AAuBA,SAAS,EAAc,GAA2B;CAChD,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EAAU,OAAO,uBAAuB,sBAAsB,IAAQ,KAAK,EAAM,YAAY,OAAO,EAC7G,SACF,CAAC;AACH;AAwBA,SAAgB,EAAkB,GAAgB,GAAkD;CAClG,IAAM,EAAE,YAAS,aAAU,mBAAgB,eAAY,GAEjD,EAAE,oBAAiB,EAAO,eAAe,CAAO,GAChD,IAAQ,EAAa;CAC3B,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,UAAU,4BAA4B,+CAA+C;CAE3G,IAAM,IAAuB,EAAO,wBAAwB,GAEtD,IAAM,GAAG,EAAM;CAErB,OAAO,EAAc,CAAM,EAAE,QAC3B,IACC,MACC,EAAyB;EACvB,KAAK;EACL;EACA,uBAAuB,CAAC;EACxB,WAAW,EAAS;EACpB,gBAAgB,EAAS;EACzB,SAAS,EAAS;CACpB,CAAC,GACH;EACE,YAAY,MAAS;GACnB,IAAI;GACJ,IAAI;IACF,IAAQ,EAAgB,CAAI;GAC9B,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;IAC5B;GACF;GACI,OAAC,KAAS,EAAM,WAAW,IAC/B,IAAI;IACF,EAAS,CAAK;GAChB,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;GAC9B;EACF;EACA;EACA,UAAU,MAAU,IAAU,EAAc,CAAK,CAAC;CACpD,CACF;AACF"}
+{"version":3,"file":"watch-enigma-prices.js","names":[],"sources":["../../../src/websocket/prices/watch-enigma-prices.ts"],"sourcesContent":["import type { SolverId } from \"../../core/chains/types\";\nimport type { Config } from \"../../core/config\";\nimport { assertPriceServiceProvider } from \"../../price-service/assert-price-service-provider\";\nimport { resolvePriceService } from \"../../price-service/resolve-price-service\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { Unwatch } from \"../notifications/types\";\nimport { createReconnectingSocket } from \"../socket/create-reconnecting-socket\";\nimport { getSocketPool } from \"../socket/get-socket-pool\";\nimport type { SocketStatus } from \"../socket/socket-status\";\nimport { parsePriceFrame } from \"./parse-price-frame\";\nimport type { EnigmaPriceTick } from \"./types\";\n\n/**\n * Parameters for {@link watchEnigmaPrices}.\n */\nexport interface WatchEnigmaPricesParameters {\n  /** Target chain id. Defaults to the config's `defaultChainId`. */\n  chainId?: number;\n  /** Solver whose price provider to resolve. Defaults to the chain's default solver. */\n  solverId?: SolverId;\n  /** Deliver ticks only for these market names (case-insensitive). */\n  names?: readonly string[];\n  /** Called for every parsed batch of price ticks. */\n  onPrices: (prices: EnigmaPriceTick[]) => void;\n  /** Called whenever the underlying connection status changes. */\n  onStatusChange?: (status: SocketStatus) => void;\n  /** Called on a transport or parse error; does not stop the subscription. */\n  onError?: (error: SymmError) => void;\n}\n\nfunction toPricesError(event: unknown): SymmError {\n  if (event instanceof SymmError) return event;\n  const cause = event instanceof Error ? event : undefined;\n  return new SymmError(\"api\", \"PRICES_SOCKET_ERROR\", `Prices socket error${cause ? `: ${cause.message}` : \".\"}`, {\n    cause,\n  });\n}\n\n/**\n * Subscribe to the chain's Enigma lowcap price-service WebSocket.\n *\n * The endpoint is broadcast-only — there is no subscribe message; every\n * connected client receives the same price ticks. Watchers sharing the\n * same `wsUrl` share one underlying socket; it closes when the last\n * watcher unwatches.\n *\n * @param config - The SDK config.\n * @param parameters - Handlers + optional chain override.\n * @returns An unwatch function that releases this subscription.\n * @throws {SymmError} synchronously when the chain is unsupported, has no\n *   `priceService.wsUrl` configured, or no `WebSocket` implementation exists.\n *\n * @example\n * ```ts\n * const unwatch = watchEnigmaPrices(config, {\n *   onPrices: (ticks) => console.log(ticks.length, \"ticks\"),\n *   onStatusChange: (status) => console.log(status),\n * });\n * ```\n */\nexport function watchEnigmaPrices(config: Config, parameters: WatchEnigmaPricesParameters): Unwatch {\n  const { chainId, solverId, names, onPrices, onStatusChange, onError } = parameters;\n\n  const priceService = resolvePriceService(config, { chainId, solverId });\n  /**\n   * Without this guard, pointing an Enigma watcher at a non-Enigma feed is the\n   * only *silent* failure in the price layer: the socket connects, the other\n   * vendor's frames parse to nothing, `parsePriceFrame` returns an empty array,\n   * and the watcher reports `status: \"open\"` while delivering zero ticks\n   * forever. Fail as a typed config error instead.\n   */\n  assertPriceServiceProvider(priceService, \"enigma\", \"watchEnigmaPrices\");\n\n  const wsUrl = priceService.wsUrl;\n  if (!wsUrl) {\n    throw new SymmError(\"config\", \"PRICES_WS_NOT_CONFIGURED\", \"Chain has no `priceService.wsUrl` configured.\");\n  }\n  const webSocketConstructor = config.getWebSocketConstructor();\n\n  const wanted = names?.length ? new Set(names.map((name) => name.trim().toUpperCase())) : undefined;\n\n  const key = `${wsUrl}|prices`;\n\n  return getSocketPool(config).acquire(\n    key,\n    (handlers) =>\n      createReconnectingSocket({\n        url: wsUrl,\n        webSocketConstructor,\n        getOpenMessages: () => [],\n        onMessage: handlers.onMessage,\n        onStatusChange: handlers.onStatusChange,\n        onError: handlers.onError,\n      }),\n    {\n      onMessage: (data) => {\n        let ticks;\n        try {\n          ticks = parsePriceFrame(data);\n        } catch (err) {\n          onError?.(toPricesError(err));\n          return;\n        }\n        if (!ticks || ticks.length === 0) return;\n\n        const delivered = wanted ? ticks.filter((tick) => wanted.has(tick.name.toUpperCase())) : ticks;\n        if (delivered.length === 0) return;\n\n        try {\n          onPrices(delivered);\n        } catch (err) {\n          onError?.(toPricesError(err));\n        }\n      },\n      onStatusChange,\n      onError: (event) => onError?.(toPricesError(event)),\n    },\n  );\n}\n"],"mappings":";;;;;;;AA8BA,SAAS,EAAc,GAA2B;CAChD,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EAAU,OAAO,uBAAuB,sBAAsB,IAAQ,KAAK,EAAM,YAAY,OAAO,EAC7G,SACF,CAAC;AACH;AAwBA,SAAgB,EAAkB,GAAgB,GAAkD;CAClG,IAAM,EAAE,YAAS,aAAU,UAAO,aAAU,mBAAgB,eAAY,GAElE,IAAe,EAAoB,GAAQ;EAAE;EAAS;CAAS,CAAC;CAQtE,EAA2B,GAAc,UAAU,mBAAmB;CAEtE,IAAM,IAAQ,EAAa;CAC3B,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,UAAU,4BAA4B,+CAA+C;CAE3G,IAAM,IAAuB,EAAO,wBAAwB,GAEtD,IAAS,GAAO,SAAS,IAAI,IAAI,EAAM,KAAK,MAAS,EAAK,KAAK,EAAE,YAAY,CAAC,CAAC,IAAI,KAAA,GAEnF,IAAM,GAAG,EAAM;CAErB,OAAO,EAAc,CAAM,EAAE,QAC3B,IACC,MACC,EAAyB;EACvB,KAAK;EACL;EACA,uBAAuB,CAAC;EACxB,WAAW,EAAS;EACpB,gBAAgB,EAAS;EACzB,SAAS,EAAS;CACpB,CAAC,GACH;EACE,YAAY,MAAS;GACnB,IAAI;GACJ,IAAI;IACF,IAAQ,EAAgB,CAAI;GAC9B,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;IAC5B;GACF;GACA,IAAI,CAAC,KAAS,EAAM,WAAW,GAAG;GAElC,IAAM,IAAY,IAAS,EAAM,QAAQ,MAAS,EAAO,IAAI,EAAK,KAAK,YAAY,CAAC,CAAC,IAAI;GACrF,MAAU,WAAW,GAEzB,IAAI;IACF,EAAS,CAAS;GACpB,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;GAC9B;EACF;EACA;EACA,UAAU,MAAU,IAAU,EAAc,CAAK,CAAC;CACpD,CACF;AACF"}

package/dist/websocket/prices/watch-prices.d.ts

@@ -0,0 +1,66 @@
+import { SolverId } from '../../core/chains/types.js';
+import { Config } from '../../core/config/index.js';
+import { MarkPriceTick } from '../../price-service/types.js';
+import { SymmError } from '../../shared/errors/symm-error.js';
+import { Unwatch } from '../notifications/types.js';
+import { SocketStatus } from '../socket/socket-status.js';
+/**
+ * Parameters for {@link watchPrices}.
+ */
+export interface WatchPricesParameters {
+    /** Target chain id. Defaults to the config's `defaultChainId`. */
+    chainId?: number;
+    /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */
+    solverId?: SolverId;
+    /**
+     * Deliver ticks only for these market names (case-insensitive).
+     *
+     * Strongly recommended on Binance, whose stream pushes every listed symbol
+     * once per second. Filtering is per-watcher, so watchers with different
+     * filters still share one socket.
+     */
+    names?: readonly string[];
+    /** Called for every parsed (and filtered) batch of ticks. */
+    onPrices: (prices: MarkPriceTick[]) => void;
+    /** Called whenever the underlying connection status changes. */
+    onStatusChange?: (status: SocketStatus) => void;
+    /** Called on a transport or parse error; does not stop the subscription. */
+    onError?: (error: SymmError) => void;
+}
+/**
+ * Subscribe to the live mark-price feed of whichever provider serves the
+ * resolved solver (`solver.priceService ?? chain.priceService`).
+ *
+ * This is the provider-agnostic entry point: a positions table or trade ticket
+ * subscribes once and narrows on `tick.provider` only when it wants
+ * provider-specific fields.
+ *
+ * Opens a socket and nothing else — it never issues HTTP. For a REST fallback
+ * while the socket is degraded, compose `getMarkPricesQueryOptions` gated on
+ * `SocketStatus`, or use `usePrices({ restFallback })` in
+ * `@symmio/trading-react`. A `watch*` that silently became an HTTP poller would
+ * break its own contract: `Unwatch` would tear down two unlike resources and
+ * `onStatusChange` would describe a transport the data no longer came from.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Handlers, optional chain/solver override, optional name filter.
+ * @returns An unwatch function that releases this subscription.
+ * @throws {SymmError} synchronously on unsupported chain, missing `wsUrl`, an
+ *   unsupported provider, or no `WebSocket` implementation.
+ *
+ * @example
+ * ```ts
+ * const unwatch = watchPrices(config, {
+ *   solverId: "rasa",
+ *   names: ["BTCUSDT"],
+ *   onPrices: (ticks) => {
+ *     for (const tick of ticks) {
+ *       console.log(tick.name, tick.markPrice);
+ *       if (tick.provider === "binance") console.log(tick.indexPrice);
+ *     }
+ *   },
+ * });
+ * ```
+ */
+export declare function watchPrices(config: Config, parameters: WatchPricesParameters): Unwatch;
+//# sourceMappingURL=watch-prices.d.ts.map

package/dist/websocket/prices/watch-prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-prices.d.ts","sourceRoot":"","sources":["../../../src/websocket/prices/watch-prices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IAC5C,gEAAgE;IAChE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAyBtF"}

package/dist/websocket/prices/watch-prices.js

@@ -0,0 +1,40 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { resolvePriceService as t } from "../../price-service/resolve-price-service.js";
+import { watchBinancePrices as n } from "./watch-binance-prices.js";
+import { watchEnigmaPrices as r } from "./watch-enigma-prices.js";
+//#region src/websocket/prices/watch-prices.ts
+function i(i, a) {
+	let { chainId: o, solverId: s, names: c, onPrices: l, onStatusChange: u, onError: d } = a, f = t(i, {
+		chainId: o,
+		solverId: s
+	});
+	switch (f.type) {
+		case "enigma": return r(i, {
+			chainId: o,
+			solverId: s,
+			names: c,
+			onPrices: (e) => l(e.map((e) => ({
+				...e,
+				provider: "enigma"
+			}))),
+			onStatusChange: u,
+			onError: d
+		});
+		case "binance": return n(i, {
+			chainId: o,
+			solverId: s,
+			names: c,
+			onPrices: l,
+			onStatusChange: u,
+			onError: d
+		});
+		default: {
+			let t = f.type;
+			throw new e("config", "UNSUPPORTED_PRICE_SERVICE_TYPE", `No live price feed for price-service type "${t}".`);
+		}
+	}
+}
+//#endregion
+export { i as watchPrices };
+
+//# sourceMappingURL=watch-prices.js.map

package/dist/websocket/prices/watch-prices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-prices.js","names":[],"sources":["../../../src/websocket/prices/watch-prices.ts"],"sourcesContent":["import type { SolverId } from \"../../core/chains/types\";\nimport type { Config } from \"../../core/config\";\nimport { resolvePriceService } from \"../../price-service/resolve-price-service\";\nimport type { MarkPriceTick } from \"../../price-service/types\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { Unwatch } from \"../notifications/types\";\nimport type { SocketStatus } from \"../socket/socket-status\";\nimport { watchBinancePrices } from \"./watch-binance-prices\";\nimport { watchEnigmaPrices } from \"./watch-enigma-prices\";\n\n/**\n * Parameters for {@link watchPrices}.\n */\nexport interface WatchPricesParameters {\n  /** Target chain id. Defaults to the config's `defaultChainId`. */\n  chainId?: number;\n  /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */\n  solverId?: SolverId;\n  /**\n   * Deliver ticks only for these market names (case-insensitive).\n   *\n   * Strongly recommended on Binance, whose stream pushes every listed symbol\n   * once per second. Filtering is per-watcher, so watchers with different\n   * filters still share one socket.\n   */\n  names?: readonly string[];\n  /** Called for every parsed (and filtered) batch of ticks. */\n  onPrices: (prices: MarkPriceTick[]) => void;\n  /** Called whenever the underlying connection status changes. */\n  onStatusChange?: (status: SocketStatus) => void;\n  /** Called on a transport or parse error; does not stop the subscription. */\n  onError?: (error: SymmError) => void;\n}\n\n/**\n * Subscribe to the live mark-price feed of whichever provider serves the\n * resolved solver (`solver.priceService ?? chain.priceService`).\n *\n * This is the provider-agnostic entry point: a positions table or trade ticket\n * subscribes once and narrows on `tick.provider` only when it wants\n * provider-specific fields.\n *\n * Opens a socket and nothing else — it never issues HTTP. For a REST fallback\n * while the socket is degraded, compose `getMarkPricesQueryOptions` gated on\n * `SocketStatus`, or use `usePrices({ restFallback })` in\n * `@symmio/trading-react`. A `watch*` that silently became an HTTP poller would\n * break its own contract: `Unwatch` would tear down two unlike resources and\n * `onStatusChange` would describe a transport the data no longer came from.\n *\n * @param config - The SDK config.\n * @param parameters - Handlers, optional chain/solver override, optional name filter.\n * @returns An unwatch function that releases this subscription.\n * @throws {SymmError} synchronously on unsupported chain, missing `wsUrl`, an\n *   unsupported provider, or no `WebSocket` implementation.\n *\n * @example\n * ```ts\n * const unwatch = watchPrices(config, {\n *   solverId: \"rasa\",\n *   names: [\"BTCUSDT\"],\n *   onPrices: (ticks) => {\n *     for (const tick of ticks) {\n *       console.log(tick.name, tick.markPrice);\n *       if (tick.provider === \"binance\") console.log(tick.indexPrice);\n *     }\n *   },\n * });\n * ```\n */\nexport function watchPrices(config: Config, parameters: WatchPricesParameters): Unwatch {\n  const { chainId, solverId, names, onPrices, onStatusChange, onError } = parameters;\n  const priceService = resolvePriceService(config, { chainId, solverId });\n\n  switch (priceService.type) {\n    case \"enigma\":\n      return watchEnigmaPrices(config, {\n        chainId,\n        solverId,\n        names,\n        onPrices: (ticks) => onPrices(ticks.map((tick) => ({ ...tick, provider: \"enigma\" }))),\n        onStatusChange,\n        onError,\n      });\n    case \"binance\":\n      return watchBinancePrices(config, { chainId, solverId, names, onPrices, onStatusChange, onError });\n    default: {\n      const unreachable: never = priceService.type;\n      throw new SymmError(\n        \"config\",\n        \"UNSUPPORTED_PRICE_SERVICE_TYPE\",\n        `No live price feed for price-service type \"${unreachable}\".`,\n      );\n    }\n  }\n}\n"],"mappings":";;;;;AAqEA,SAAgB,EAAY,GAAgB,GAA4C;CACtF,IAAM,EAAE,YAAS,aAAU,UAAO,aAAU,mBAAgB,eAAY,GAClE,IAAe,EAAoB,GAAQ;EAAE;EAAS;CAAS,CAAC;CAEtE,QAAQ,EAAa,MAArB;EACE,KAAK,UACH,OAAO,EAAkB,GAAQ;GAC/B;GACA;GACA;GACA,WAAW,MAAU,EAAS,EAAM,KAAK,OAAU;IAAE,GAAG;IAAM,UAAU;GAAS,EAAE,CAAC;GACpF;GACA;EACF,CAAC;EACH,KAAK,WACH,OAAO,EAAmB,GAAQ;GAAE;GAAS;GAAU;GAAO;GAAU;GAAgB;EAAQ,CAAC;EACnG,SAAS;GACP,IAAM,IAAqB,EAAa;GACxC,MAAM,IAAI,EACR,UACA,kCACA,8CAA8C,EAAY,GAC5D;EACF;CACF;AACF"}

package/dist/websocket/tpsl/parse-tpsl-frame.d.ts

@@ -1,6 +1,6 @@
 import { TpSlNotification } from './types.js';
 /**
- * Parse a raw defilytics frame into a {@link TpSlNotification}, or `null` when
+ * Parse a raw enigma frame into a {@link TpSlNotification}, or `null` when
  * the frame isn't a `report` (control frames, malformed JSON, missing payload,
  * wrong shape).
  *

package/dist/websocket/tpsl/parse-tpsl-frame.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-tpsl-frame.js","names":[],"sources":["../../../src/websocket/tpsl/parse-tpsl-frame.ts"],"sourcesContent":["import type { RawTpSlNotification, TpSlNotification } from \"./types\";\n\n/**\n * Parse a raw defilytics frame into a {@link TpSlNotification}, or `null` when\n * the frame isn't a `report` (control frames, malformed JSON, missing payload,\n * wrong shape).\n *\n * Wire shape (single-wrapped — the `data` field IS the payload, not a nested\n * envelope):\n *\n * ```jsonc\n * {\n *   \"app_name\": \"Hyper-EVM_COH-Low-Cap_Production\",\n *   \"primary_identifier\": 9565,\n *   \"secondary_identifier\": 0,\n *   \"address\": \"0xaE96…\",\n *   \"type\": \"report\",\n *   \"timestamp\": 1782821982,\n *   \"data\": { coh_quote_id, conditional_order_type, state, details, successful }\n * }\n * ```\n */\nexport function parseTpSlFrame(data: unknown): TpSlNotification | null {\n  const envelope = normalizeEnvelope(data);\n  if (!envelope) return null;\n  if (envelope.type && envelope.type !== \"report\") return null;\n\n  const payload = envelope.data;\n  if (!payload) return null;\n\n  const primary = Number(envelope.primary_identifier ?? 0);\n  const secondary = Number(envelope.secondary_identifier ?? 0);\n  const quoteId = primary !== 0 ? primary : secondary;\n\n  const base = {\n    quoteId,\n    primaryIdentifier: primary,\n    secondaryIdentifier: secondary,\n    account: envelope.address ?? null,\n    conditionalOrderType: payload.conditional_order_type ?? null,\n    state: payload.state,\n    cohQuoteId: payload.coh_quote_id,\n    timestamp: typeof envelope.timestamp === \"number\" ? envelope.timestamp : undefined,\n    raw: envelope,\n  } as const;\n\n  if (payload.successful) {\n    return { ...base, successful: true, details: payload.details };\n  }\n  return {\n    ...base,\n    successful: false,\n    errorCode: payload.error_code,\n    errorMessage: payload.error_message,\n  };\n}\n\n/**\n * Narrow arbitrary input (raw ws `event.data`, JSON string, or already-parsed\n * object) into a typed {@link RawTpSlNotification}, or `null` if it can't be\n * safely treated as one.\n *\n * The runtime is best-effort — the WS server owns the shape and we only trust\n * the outer envelope; the payload is walked through the union type\n * ({@link RawTpSlNotification.data}) after.\n */\nfunction normalizeEnvelope(data: unknown): RawTpSlNotification | null {\n  if (typeof data === \"string\") {\n    try {\n      const parsed: unknown = JSON.parse(data);\n      return isEnvelope(parsed) ? parsed : null;\n    } catch {\n      return null;\n    }\n  }\n  return isEnvelope(data) ? data : null;\n}\n\nfunction isEnvelope(value: unknown): value is RawTpSlNotification {\n  return typeof value === \"object\" && value !== null;\n}\n"],"mappings":";AAsBA,SAAgB,EAAe,GAAwC;CACrE,IAAM,IAAW,EAAkB,CAAI;CAEvC,IADI,CAAC,KACD,EAAS,QAAQ,EAAS,SAAS,UAAU,OAAO;CAExD,IAAM,IAAU,EAAS;CACzB,IAAI,CAAC,GAAS,OAAO;CAErB,IAAM,IAAU,OAAO,EAAS,sBAAsB,CAAC,GACjD,IAAY,OAAO,EAAS,wBAAwB,CAAC,GAGrD,IAAO;EACX,SAHc,MAAY,IAAc,IAAV;EAI9B,mBAAmB;EACnB,qBAAqB;EACrB,SAAS,EAAS,WAAW;EAC7B,sBAAsB,EAAQ,0BAA0B;EACxD,OAAO,EAAQ;EACf,YAAY,EAAQ;EACpB,WAAW,OAAO,EAAS,aAAc,WAAW,EAAS,YAAY,KAAA;EACzE,KAAK;CACP;CAKA,OAHI,EAAQ,aACH;EAAE,GAAG;EAAM,YAAY;EAAM,SAAS,EAAQ;CAAQ,IAExD;EACL,GAAG;EACH,YAAY;EACZ,WAAW,EAAQ;EACnB,cAAc,EAAQ;CACxB;AACF;AAWA,SAAS,EAAkB,GAA2C;CACpE,IAAI,OAAO,KAAS,UAClB,IAAI;EACF,IAAM,IAAkB,KAAK,MAAM,CAAI;EACvC,OAAO,EAAW,CAAM,IAAI,IAAS;CACvC,QAAQ;EACN,OAAO;CACT;CAEF,OAAO,EAAW,CAAI,IAAI,IAAO;AACnC;AAEA,SAAS,EAAW,GAA8C;CAChE,OAAO,OAAO,KAAU,cAAY;AACtC"}
+{"version":3,"file":"parse-tpsl-frame.js","names":[],"sources":["../../../src/websocket/tpsl/parse-tpsl-frame.ts"],"sourcesContent":["import type { RawTpSlNotification, TpSlNotification } from \"./types\";\n\n/**\n * Parse a raw enigma frame into a {@link TpSlNotification}, or `null` when\n * the frame isn't a `report` (control frames, malformed JSON, missing payload,\n * wrong shape).\n *\n * Wire shape (single-wrapped — the `data` field IS the payload, not a nested\n * envelope):\n *\n * ```jsonc\n * {\n *   \"app_name\": \"Hyper-EVM_COH-Low-Cap_Production\",\n *   \"primary_identifier\": 9565,\n *   \"secondary_identifier\": 0,\n *   \"address\": \"0xaE96…\",\n *   \"type\": \"report\",\n *   \"timestamp\": 1782821982,\n *   \"data\": { coh_quote_id, conditional_order_type, state, details, successful }\n * }\n * ```\n */\nexport function parseTpSlFrame(data: unknown): TpSlNotification | null {\n  const envelope = normalizeEnvelope(data);\n  if (!envelope) return null;\n  if (envelope.type && envelope.type !== \"report\") return null;\n\n  const payload = envelope.data;\n  if (!payload) return null;\n\n  const primary = Number(envelope.primary_identifier ?? 0);\n  const secondary = Number(envelope.secondary_identifier ?? 0);\n  const quoteId = primary !== 0 ? primary : secondary;\n\n  const base = {\n    quoteId,\n    primaryIdentifier: primary,\n    secondaryIdentifier: secondary,\n    account: envelope.address ?? null,\n    conditionalOrderType: payload.conditional_order_type ?? null,\n    state: payload.state,\n    cohQuoteId: payload.coh_quote_id,\n    timestamp: typeof envelope.timestamp === \"number\" ? envelope.timestamp : undefined,\n    raw: envelope,\n  } as const;\n\n  if (payload.successful) {\n    return { ...base, successful: true, details: payload.details };\n  }\n  return {\n    ...base,\n    successful: false,\n    errorCode: payload.error_code,\n    errorMessage: payload.error_message,\n  };\n}\n\n/**\n * Narrow arbitrary input (raw ws `event.data`, JSON string, or already-parsed\n * object) into a typed {@link RawTpSlNotification}, or `null` if it can't be\n * safely treated as one.\n *\n * The runtime is best-effort — the WS server owns the shape and we only trust\n * the outer envelope; the payload is walked through the union type\n * ({@link RawTpSlNotification.data}) after.\n */\nfunction normalizeEnvelope(data: unknown): RawTpSlNotification | null {\n  if (typeof data === \"string\") {\n    try {\n      const parsed: unknown = JSON.parse(data);\n      return isEnvelope(parsed) ? parsed : null;\n    } catch {\n      return null;\n    }\n  }\n  return isEnvelope(data) ? data : null;\n}\n\nfunction isEnvelope(value: unknown): value is RawTpSlNotification {\n  return typeof value === \"object\" && value !== null;\n}\n"],"mappings":";AAsBA,SAAgB,EAAe,GAAwC;CACrE,IAAM,IAAW,EAAkB,CAAI;CAEvC,IADI,CAAC,KACD,EAAS,QAAQ,EAAS,SAAS,UAAU,OAAO;CAExD,IAAM,IAAU,EAAS;CACzB,IAAI,CAAC,GAAS,OAAO;CAErB,IAAM,IAAU,OAAO,EAAS,sBAAsB,CAAC,GACjD,IAAY,OAAO,EAAS,wBAAwB,CAAC,GAGrD,IAAO;EACX,SAHc,MAAY,IAAc,IAAV;EAI9B,mBAAmB;EACnB,qBAAqB;EACrB,SAAS,EAAS,WAAW;EAC7B,sBAAsB,EAAQ,0BAA0B;EACxD,OAAO,EAAQ;EACf,YAAY,EAAQ;EACpB,WAAW,OAAO,EAAS,aAAc,WAAW,EAAS,YAAY,KAAA;EACzE,KAAK;CACP;CAKA,OAHI,EAAQ,aACH;EAAE,GAAG;EAAM,YAAY;EAAM,SAAS,EAAQ;CAAQ,IAExD;EACL,GAAG;EACH,YAAY;EACZ,WAAW,EAAQ;EACnB,cAAc,EAAQ;CACxB;AACF;AAWA,SAAS,EAAkB,GAA2C;CACpE,IAAI,OAAO,KAAS,UAClB,IAAI;EACF,IAAM,IAAkB,KAAK,MAAM,CAAI;EACvC,OAAO,EAAW,CAAM,IAAI,IAAS;CACvC,QAAQ;EACN,OAAO;CACT;CAEF,OAAO,EAAW,CAAI,IAAI,IAAO;AACnC;AAEA,SAAS,EAAW,GAA8C;CAChE,OAAO,OAAO,KAAU,cAAY;AACtC"}

package/dist/websocket/tpsl/types.d.ts

@@ -1,7 +1,7 @@
 import { TpSlConditionalOrderType } from '../../tpsl/types.js';
 /**
  * Wire shape of one report frame from the TP/SL notifications WS, after the
- * defilytics envelope is unwrapped.
+ * enigma envelope is unwrapped.
  */
 export interface RawTpSlNotification {
     app_name?: string;

package/dist/websocket/tpsl/watch-tpsl-notifications.d.ts

@@ -22,7 +22,7 @@ export interface WatchTpSlNotificationsParameters {
 }
 /**
  * Subscribe to live TP/SL notifications for an account. Reuses the
- * defilytics-protocol subscribe-frame builder and the SDK's socket pool, so
+ * enigma-protocol subscribe-frame builder and the SDK's socket pool, so
  * many watchers across the app share one underlying connection per
  * `(wsUrl, appName, account)` triple. Scoped by `tpsl.appName` (e.g.
  * `Hyper-EVM_COH-Low-Cap_Production`), distinct from the quote-state

package/dist/websocket/tpsl/watch-tpsl-notifications.js

@@ -1,7 +1,7 @@
 import { SymmError as e } from "../../shared/errors/symm-error.js";
-import { buildSubscribeMessage as t } from "../notifications/build-subscribe-message.js";
-import { createReconnectingSocket as n } from "../socket/create-reconnecting-socket.js";
-import { getSocketPool as r } from "../socket/get-socket-pool.js";
+import { createReconnectingSocket as t } from "../socket/create-reconnecting-socket.js";
+import { getSocketPool as n } from "../socket/get-socket-pool.js";
+import { buildSubscribeMessage as r } from "../notifications/adapters/enigma-notifications.js";
 import { resolveTpSlConfig as i } from "../../tpsl/internal/resolve-tpsl-config.js";
 import { parseTpSlFrame as a } from "./parse-tpsl-frame.js";
 //#region src/websocket/tpsl/watch-tpsl-notifications.ts
@@ -11,12 +11,12 @@ function o(t) {
 	return new e("api", "TPSL_SOCKET_ERROR", `TP/SL socket error${n ? `: ${n.message}` : "."}`, { cause: n });
 }
 function s(e, s) {
-	let { account: c, chainId: l, onNotification: u, onStatusChange: d, onError: f } = s, p = i(e, l), m = e.getWebSocketConstructor(), h = t({
+	let { account: c, chainId: l, onNotification: u, onStatusChange: d, onError: f } = s, p = i(e, l), m = e.getWebSocketConstructor(), h = r({
 		account: c,
 		channel: p.appName,
-		protocol: "defilytics"
+		protocol: "enigma"
 	}), g = `${p.wsUrl}|${p.appName}|${c.toLowerCase()}`;
-	return r(e).acquire(g, (e) => n({
+	return n(e).acquire(g, (e) => t({
 		url: p.wsUrl,
 		webSocketConstructor: m,
 		getOpenMessages: () => [h],

package/dist/websocket/tpsl/watch-tpsl-notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch-tpsl-notifications.js","names":[],"sources":["../../../src/websocket/tpsl/watch-tpsl-notifications.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport { resolveTpSlConfig } from \"../../tpsl/internal/resolve-tpsl-config\";\nimport { buildSubscribeMessage } from \"../notifications/build-subscribe-message\";\nimport { createReconnectingSocket } from \"../socket/create-reconnecting-socket\";\nimport { getSocketPool } from \"../socket/get-socket-pool\";\nimport type { SocketStatus } from \"../socket/socket-status\";\nimport { parseTpSlFrame } from \"./parse-tpsl-frame\";\nimport type { TpSlNotification } from \"./types\";\n\n/** Idempotent disposer returned by {@link watchTpSlNotifications}. */\nexport type UnwatchTpSl = () => void;\n\n/**\n * Parameters for {@link watchTpSlNotifications}.\n */\nexport interface WatchTpSlNotificationsParameters {\n  /** SubAccount address to subscribe for. */\n  account: Address;\n  /** Target chain id. Defaults to the config's `defaultChainId`. */\n  chainId?: number;\n  /** Called for every normalized TP/SL report. */\n  onNotification: (notification: TpSlNotification) => void;\n  /** Connection status changes. */\n  onStatusChange?: (status: SocketStatus) => void;\n  /** Transport / parse errors; does not stop the subscription. */\n  onError?: (error: SymmError) => void;\n}\n\nfunction toTpSlError(event: unknown): SymmError {\n  if (event instanceof SymmError) return event;\n  const cause = event instanceof Error ? event : undefined;\n  return new SymmError(\"api\", \"TPSL_SOCKET_ERROR\", `TP/SL socket error${cause ? `: ${cause.message}` : \".\"}`, {\n    cause,\n  });\n}\n\n/**\n * Subscribe to live TP/SL notifications for an account. Reuses the\n * defilytics-protocol subscribe-frame builder and the SDK's socket pool, so\n * many watchers across the app share one underlying connection per\n * `(wsUrl, appName, account)` triple. Scoped by `tpsl.appName` (e.g.\n * `Hyper-EVM_COH-Low-Cap_Production`), distinct from the quote-state\n * notifications stream.\n *\n * @throws {SymmError} synchronously when the chain has no `tpsl` config or no\n *   WebSocket implementation is available.\n */\nexport function watchTpSlNotifications(config: Config, parameters: WatchTpSlNotificationsParameters): UnwatchTpSl {\n  const { account, chainId, onNotification, onStatusChange, onError } = parameters;\n  const tpsl = resolveTpSlConfig(config, chainId);\n  const webSocketConstructor = config.getWebSocketConstructor();\n\n  // Defilytics protocol with the TP/SL appName as the channel.\n  const subscribeMessage = buildSubscribeMessage({ account, channel: tpsl.appName, protocol: \"defilytics\" });\n\n  const key = `${tpsl.wsUrl}|${tpsl.appName}|${account.toLowerCase()}`;\n\n  return getSocketPool(config).acquire(\n    key,\n    (handlers) =>\n      createReconnectingSocket({\n        url: tpsl.wsUrl,\n        webSocketConstructor,\n        getOpenMessages: () => [subscribeMessage],\n        onMessage: handlers.onMessage,\n        onStatusChange: handlers.onStatusChange,\n        onError: handlers.onError,\n      }),\n    {\n      onMessage: (data) => {\n        try {\n          const parsed = parseTpSlFrame(data);\n          if (!parsed) return;\n          onNotification(parsed);\n        } catch (err) {\n          onError?.(toTpSlError(err));\n        }\n      },\n      onStatusChange,\n      onError: (event) => onError?.(toTpSlError(event)),\n    },\n  );\n}\n"],"mappings":";;;;;;;AA8BA,SAAS,EAAY,GAA2B;CAC9C,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EAAU,OAAO,qBAAqB,qBAAqB,IAAQ,KAAK,EAAM,YAAY,OAAO,EAC1G,SACF,CAAC;AACH;AAaA,SAAgB,EAAuB,GAAgB,GAA2D;CAChH,IAAM,EAAE,YAAS,YAAS,mBAAgB,mBAAgB,eAAY,GAChE,IAAO,EAAkB,GAAQ,CAAO,GACxC,IAAuB,EAAO,wBAAwB,GAGtD,IAAmB,EAAsB;EAAE;EAAS,SAAS,EAAK;EAAS,UAAU;CAAa,CAAC,GAEnG,IAAM,GAAG,EAAK,MAAM,GAAG,EAAK,QAAQ,GAAG,EAAQ,YAAY;CAEjE,OAAO,EAAc,CAAM,EAAE,QAC3B,IACC,MACC,EAAyB;EACvB,KAAK,EAAK;EACV;EACA,uBAAuB,CAAC,CAAgB;EACxC,WAAW,EAAS;EACpB,gBAAgB,EAAS;EACzB,SAAS,EAAS;CACpB,CAAC,GACH;EACE,YAAY,MAAS;GACnB,IAAI;IACF,IAAM,IAAS,EAAe,CAAI;IAClC,IAAI,CAAC,GAAQ;IACb,EAAe,CAAM;GACvB,SAAS,GAAK;IACZ,IAAU,EAAY,CAAG,CAAC;GAC5B;EACF;EACA;EACA,UAAU,MAAU,IAAU,EAAY,CAAK,CAAC;CAClD,CACF;AACF"}
+{"version":3,"file":"watch-tpsl-notifications.js","names":[],"sources":["../../../src/websocket/tpsl/watch-tpsl-notifications.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport { resolveTpSlConfig } from \"../../tpsl/internal/resolve-tpsl-config\";\nimport { buildSubscribeMessage } from \"../notifications/adapters/enigma-notifications\";\nimport { createReconnectingSocket } from \"../socket/create-reconnecting-socket\";\nimport { getSocketPool } from \"../socket/get-socket-pool\";\nimport type { SocketStatus } from \"../socket/socket-status\";\nimport { parseTpSlFrame } from \"./parse-tpsl-frame\";\nimport type { TpSlNotification } from \"./types\";\n\n/** Idempotent disposer returned by {@link watchTpSlNotifications}. */\nexport type UnwatchTpSl = () => void;\n\n/**\n * Parameters for {@link watchTpSlNotifications}.\n */\nexport interface WatchTpSlNotificationsParameters {\n  /** SubAccount address to subscribe for. */\n  account: Address;\n  /** Target chain id. Defaults to the config's `defaultChainId`. */\n  chainId?: number;\n  /** Called for every normalized TP/SL report. */\n  onNotification: (notification: TpSlNotification) => void;\n  /** Connection status changes. */\n  onStatusChange?: (status: SocketStatus) => void;\n  /** Transport / parse errors; does not stop the subscription. */\n  onError?: (error: SymmError) => void;\n}\n\nfunction toTpSlError(event: unknown): SymmError {\n  if (event instanceof SymmError) return event;\n  const cause = event instanceof Error ? event : undefined;\n  return new SymmError(\"api\", \"TPSL_SOCKET_ERROR\", `TP/SL socket error${cause ? `: ${cause.message}` : \".\"}`, {\n    cause,\n  });\n}\n\n/**\n * Subscribe to live TP/SL notifications for an account. Reuses the\n * enigma-protocol subscribe-frame builder and the SDK's socket pool, so\n * many watchers across the app share one underlying connection per\n * `(wsUrl, appName, account)` triple. Scoped by `tpsl.appName` (e.g.\n * `Hyper-EVM_COH-Low-Cap_Production`), distinct from the quote-state\n * notifications stream.\n *\n * @throws {SymmError} synchronously when the chain has no `tpsl` config or no\n *   WebSocket implementation is available.\n */\nexport function watchTpSlNotifications(config: Config, parameters: WatchTpSlNotificationsParameters): UnwatchTpSl {\n  const { account, chainId, onNotification, onStatusChange, onError } = parameters;\n  const tpsl = resolveTpSlConfig(config, chainId);\n  const webSocketConstructor = config.getWebSocketConstructor();\n\n  // Enigma protocol with the TP/SL appName as the channel.\n  const subscribeMessage = buildSubscribeMessage({ account, channel: tpsl.appName, protocol: \"enigma\" });\n\n  const key = `${tpsl.wsUrl}|${tpsl.appName}|${account.toLowerCase()}`;\n\n  return getSocketPool(config).acquire(\n    key,\n    (handlers) =>\n      createReconnectingSocket({\n        url: tpsl.wsUrl,\n        webSocketConstructor,\n        getOpenMessages: () => [subscribeMessage],\n        onMessage: handlers.onMessage,\n        onStatusChange: handlers.onStatusChange,\n        onError: handlers.onError,\n      }),\n    {\n      onMessage: (data) => {\n        try {\n          const parsed = parseTpSlFrame(data);\n          if (!parsed) return;\n          onNotification(parsed);\n        } catch (err) {\n          onError?.(toTpSlError(err));\n        }\n      },\n      onStatusChange,\n      onError: (event) => onError?.(toTpSlError(event)),\n    },\n  );\n}\n"],"mappings":";;;;;;;AA8BA,SAAS,EAAY,GAA2B;CAC9C,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EAAU,OAAO,qBAAqB,qBAAqB,IAAQ,KAAK,EAAM,YAAY,OAAO,EAC1G,SACF,CAAC;AACH;AAaA,SAAgB,EAAuB,GAAgB,GAA2D;CAChH,IAAM,EAAE,YAAS,YAAS,mBAAgB,mBAAgB,eAAY,GAChE,IAAO,EAAkB,GAAQ,CAAO,GACxC,IAAuB,EAAO,wBAAwB,GAGtD,IAAmB,EAAsB;EAAE;EAAS,SAAS,EAAK;EAAS,UAAU;CAAS,CAAC,GAE/F,IAAM,GAAG,EAAK,MAAM,GAAG,EAAK,QAAQ,GAAG,EAAQ,YAAY;CAEjE,OAAO,EAAc,CAAM,EAAE,QAC3B,IACC,MACC,EAAyB;EACvB,KAAK,EAAK;EACV;EACA,uBAAuB,CAAC,CAAgB;EACxC,WAAW,EAAS;EACpB,gBAAgB,EAAS;EACzB,SAAS,EAAS;CACpB,CAAC,GACH;EACE,YAAY,MAAS;GACnB,IAAI;IACF,IAAM,IAAS,EAAe,CAAI;IAClC,IAAI,CAAC,GAAQ;IACb,EAAe,CAAM;GACvB,SAAS,GAAK;IACZ,IAAU,EAAY,CAAG,CAAC;GAC5B;EACF;EACA;EACA,UAAU,MAAU,IAAU,EAAY,CAAK,CAAC;CAClD,CACF;AACF"}