@symmio/trading-core 1.1.0 → 2.0.0

package/dist/websocket/notifications/index.d.ts

@@ -1,6 +1,8 @@
-export * from './build-subscribe-message.js';
+export * from './adapters/index.js';
 export * from './normalize-notification.js';
+export * from './parse-frame-payload.js';
 export * from './parse-notification-frame.js';
+export * from './to-notifications-error.js';
 export * from './types.js';
 export * from './watch-notifications.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/websocket/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/websocket/notifications/normalize-notification.d.ts

@@ -7,9 +7,12 @@ import { NotificationType, Notification, RawPositionNotification } from './types
  */
 export declare function classifyNotification(actionStatus: string | null): NotificationType;
 /**
- * Normalize a raw wire frame into a {@link Notification}: camelCase fields, a
- * resolved `quoteId` (on-chain id when present, else the temp id), and a
- * classified `type`.
+ * Normalize a raw wire frame — either protocol variant — into a
+ * {@link Notification}: camelCase fields, a resolved `quoteId` (on-chain id
+ * when present, else the temp id), a classified `type`, and the per-wire
+ * value quirks reconciled (rasa's numeric zero-sentinel amounts become
+ * `null`/empty; enigma-only fields default on rasa frames). The wire-faithful
+ * frame is preserved on `raw`.
  *
  * @param raw - The raw position-state frame.
  */

package/dist/websocket/notifications/normalize-notification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-notification.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/normalize-notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE1G;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,CAWlF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,YAAY,CAyBhF"}
+{"version":3,"file":"normalize-notification.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/normalize-notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE1G;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,CAWlF;AAcD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,YAAY,CAyBhF"}

package/dist/websocket/notifications/normalize-notification.js

@@ -9,6 +9,9 @@ function n(n) {
 	}
 }
 function r(e) {
+	return e == null ? null : typeof e == "number" ? e === 0 ? null : `${e}` : e;
+}
+function i(e) {
 	let t = (!e.quote_id || e.quote_id === 0 ? e.temp_quote_id : e.quote_id) || 0;
 	return {
 		id: e.id ?? "",
@@ -18,14 +21,14 @@ function r(e) {
 		actionStatus: e.action_status ?? null,
 		lastSeenAction: e.last_seen_action ?? null,
 		account: e.address ?? null,
-		vaAddress: e.va_address ?? null,
+		vaAddress: ("va_address" in e ? e.va_address : null) ?? null,
 		counterpartyAddress: e.counterparty_address ?? "",
-		filledAmountOpen: e.filled_amount_open ?? null,
-		filledAmountClose: e.filled_amount_close ?? null,
-		avgPriceOpen: e.avg_price_open ?? "",
-		avgPriceClose: e.avg_price_close ?? "",
+		filledAmountOpen: r(e.filled_amount_open),
+		filledAmountClose: r(e.filled_amount_close),
+		avgPriceOpen: r(e.avg_price_open) ?? "",
+		avgPriceClose: r(e.avg_price_close) ?? "",
 		failureType: e.failure_type ?? null,
-		failureMessage: e.failure_message ?? null,
+		failureMessage: ("failure_message" in e ? e.failure_message : null) ?? null,
 		errorCode: e.error_code ?? null,
 		stateType: e.state_type ?? null,
 		createTime: `${e.create_time ?? ""}`,
@@ -34,6 +37,6 @@ function r(e) {
 	};
 }
 //#endregion
-export { n as classifyNotification, r as normalizeNotification };
+export { n as classifyNotification, i as normalizeNotification };
 
 //# sourceMappingURL=normalize-notification.js.map

package/dist/websocket/notifications/normalize-notification.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-notification.js","names":[],"sources":["../../../src/websocket/notifications/normalize-notification.ts"],"sourcesContent":["import { ActionStatus, NotificationType, type Notification, type RawPositionNotification } from \"./types\";\n\n/**\n * Classify a raw `action_status` into a {@link NotificationType}. Unknown or\n * missing statuses are treated as {@link NotificationType.FAILED}.\n *\n * @param actionStatus - The raw `action_status` field.\n */\nexport function classifyNotification(actionStatus: string | null): NotificationType {\n  switch (actionStatus) {\n    case ActionStatus.SUCCESS:\n      return NotificationType.SUCCESS;\n    case ActionStatus.SEEN:\n      return NotificationType.SEEN;\n    case ActionStatus.FAILED:\n      return NotificationType.FAILED;\n    default:\n      return NotificationType.FAILED;\n  }\n}\n\n/**\n * Normalize a raw wire frame into a {@link Notification}: camelCase fields, a\n * resolved `quoteId` (on-chain id when present, else the temp id), and a\n * classified `type`.\n *\n * @param raw - The raw position-state frame.\n */\nexport function normalizeNotification(raw: RawPositionNotification): Notification {\n  const resolvedQuoteId = (!raw.quote_id || raw.quote_id === 0 ? raw.temp_quote_id : raw.quote_id) || 0;\n\n  return {\n    id: raw.id ?? \"\",\n    quoteId: `${resolvedQuoteId}`,\n    tempQuoteId: raw.temp_quote_id ?? 0,\n    type: classifyNotification(raw.action_status ?? null),\n    actionStatus: raw.action_status ?? null,\n    lastSeenAction: raw.last_seen_action ?? null,\n    account: raw.address ?? null,\n    vaAddress: raw.va_address ?? null,\n    counterpartyAddress: raw.counterparty_address ?? \"\",\n    filledAmountOpen: raw.filled_amount_open ?? null,\n    filledAmountClose: raw.filled_amount_close ?? null,\n    avgPriceOpen: raw.avg_price_open ?? \"\",\n    avgPriceClose: raw.avg_price_close ?? \"\",\n    failureType: raw.failure_type ?? null,\n    failureMessage: raw.failure_message ?? null,\n    errorCode: raw.error_code ?? null,\n    stateType: raw.state_type ?? null,\n    createTime: `${raw.create_time ?? \"\"}`,\n    modifyTime: `${raw.modify_time ?? \"\"}`,\n    raw,\n  };\n}\n"],"mappings":";;AAQA,SAAgB,EAAqB,GAA+C;CAClF,QAAQ,GAAR;EACE,KAAK,EAAa,SAChB,OAAO,EAAiB;EAC1B,KAAK,EAAa,MAChB,OAAO,EAAiB;EAC1B,KAAK,EAAa,QAChB,OAAO,EAAiB;EAC1B,SACE,OAAO,EAAiB;CAC5B;AACF;AASA,SAAgB,EAAsB,GAA4C;CAChF,IAAM,KAAmB,CAAC,EAAI,YAAY,EAAI,aAAa,IAAI,EAAI,gBAAgB,EAAI,aAAa;CAEpG,OAAO;EACL,IAAI,EAAI,MAAM;EACd,SAAS,GAAG;EACZ,aAAa,EAAI,iBAAiB;EAClC,MAAM,EAAqB,EAAI,iBAAiB,IAAI;EACpD,cAAc,EAAI,iBAAiB;EACnC,gBAAgB,EAAI,oBAAoB;EACxC,SAAS,EAAI,WAAW;EACxB,WAAW,EAAI,cAAc;EAC7B,qBAAqB,EAAI,wBAAwB;EACjD,kBAAkB,EAAI,sBAAsB;EAC5C,mBAAmB,EAAI,uBAAuB;EAC9C,cAAc,EAAI,kBAAkB;EACpC,eAAe,EAAI,mBAAmB;EACtC,aAAa,EAAI,gBAAgB;EACjC,gBAAgB,EAAI,mBAAmB;EACvC,WAAW,EAAI,cAAc;EAC7B,WAAW,EAAI,cAAc;EAC7B,YAAY,GAAG,EAAI,eAAe;EAClC,YAAY,GAAG,EAAI,eAAe;EAClC;CACF;AACF"}
+{"version":3,"file":"normalize-notification.js","names":[],"sources":["../../../src/websocket/notifications/normalize-notification.ts"],"sourcesContent":["import { ActionStatus, NotificationType, type Notification, type RawPositionNotification } from \"./types\";\n\n/**\n * Classify a raw `action_status` into a {@link NotificationType}. Unknown or\n * missing statuses are treated as {@link NotificationType.FAILED}.\n *\n * @param actionStatus - The raw `action_status` field.\n */\nexport function classifyNotification(actionStatus: string | null): NotificationType {\n  switch (actionStatus) {\n    case ActionStatus.SUCCESS:\n      return NotificationType.SUCCESS;\n    case ActionStatus.SEEN:\n      return NotificationType.SEEN;\n    case ActionStatus.FAILED:\n      return NotificationType.FAILED;\n    default:\n      return NotificationType.FAILED;\n  }\n}\n\n/**\n * Reconcile a wire amount/price field to `string | null`. The enigma wire\n * sends decimal strings (or nothing); the rasa wire sends the numeric `0` for\n * \"no value\" and a decimal string when the frame carries one. A nonzero number\n * is kept as its string form defensively; strings pass through untouched.\n */\nfunction wireDecimalToString(value: number | string | null | undefined): string | null {\n  if (value === null || value === undefined) return null;\n  if (typeof value === \"number\") return value === 0 ? null : `${value}`;\n  return value;\n}\n\n/**\n * Normalize a raw wire frame — either protocol variant — into a\n * {@link Notification}: camelCase fields, a resolved `quoteId` (on-chain id\n * when present, else the temp id), a classified `type`, and the per-wire\n * value quirks reconciled (rasa's numeric zero-sentinel amounts become\n * `null`/empty; enigma-only fields default on rasa frames). The wire-faithful\n * frame is preserved on `raw`.\n *\n * @param raw - The raw position-state frame.\n */\nexport function normalizeNotification(raw: RawPositionNotification): Notification {\n  const resolvedQuoteId = (!raw.quote_id || raw.quote_id === 0 ? raw.temp_quote_id : raw.quote_id) || 0;\n\n  return {\n    id: raw.id ?? \"\",\n    quoteId: `${resolvedQuoteId}`,\n    tempQuoteId: raw.temp_quote_id ?? 0,\n    type: classifyNotification(raw.action_status ?? null),\n    actionStatus: raw.action_status ?? null,\n    lastSeenAction: raw.last_seen_action ?? null,\n    account: raw.address ?? null,\n    vaAddress: (\"va_address\" in raw ? raw.va_address : null) ?? null,\n    counterpartyAddress: raw.counterparty_address ?? \"\",\n    filledAmountOpen: wireDecimalToString(raw.filled_amount_open),\n    filledAmountClose: wireDecimalToString(raw.filled_amount_close),\n    avgPriceOpen: wireDecimalToString(raw.avg_price_open) ?? \"\",\n    avgPriceClose: wireDecimalToString(raw.avg_price_close) ?? \"\",\n    failureType: raw.failure_type ?? null,\n    failureMessage: (\"failure_message\" in raw ? raw.failure_message : null) ?? null,\n    errorCode: raw.error_code ?? null,\n    stateType: raw.state_type ?? null,\n    createTime: `${raw.create_time ?? \"\"}`,\n    modifyTime: `${raw.modify_time ?? \"\"}`,\n    raw,\n  };\n}\n"],"mappings":";;AAQA,SAAgB,EAAqB,GAA+C;CAClF,QAAQ,GAAR;EACE,KAAK,EAAa,SAChB,OAAO,EAAiB;EAC1B,KAAK,EAAa,MAChB,OAAO,EAAiB;EAC1B,KAAK,EAAa,QAChB,OAAO,EAAiB;EAC1B,SACE,OAAO,EAAiB;CAC5B;AACF;AAQA,SAAS,EAAoB,GAA0D;CAGrF,OAFI,KAAU,OAAoC,OAC9C,OAAO,KAAU,WAAiB,MAAU,IAAI,OAAO,GAAG,MACvD;AACT;AAYA,SAAgB,EAAsB,GAA4C;CAChF,IAAM,KAAmB,CAAC,EAAI,YAAY,EAAI,aAAa,IAAI,EAAI,gBAAgB,EAAI,aAAa;CAEpG,OAAO;EACL,IAAI,EAAI,MAAM;EACd,SAAS,GAAG;EACZ,aAAa,EAAI,iBAAiB;EAClC,MAAM,EAAqB,EAAI,iBAAiB,IAAI;EACpD,cAAc,EAAI,iBAAiB;EACnC,gBAAgB,EAAI,oBAAoB;EACxC,SAAS,EAAI,WAAW;EACxB,YAAY,gBAAgB,IAAM,EAAI,aAAa,SAAS;EAC5D,qBAAqB,EAAI,wBAAwB;EACjD,kBAAkB,EAAoB,EAAI,kBAAkB;EAC5D,mBAAmB,EAAoB,EAAI,mBAAmB;EAC9D,cAAc,EAAoB,EAAI,cAAc,KAAK;EACzD,eAAe,EAAoB,EAAI,eAAe,KAAK;EAC3D,aAAa,EAAI,gBAAgB;EACjC,iBAAiB,qBAAqB,IAAM,EAAI,kBAAkB,SAAS;EAC3E,WAAW,EAAI,cAAc;EAC7B,WAAW,EAAI,cAAc;EAC7B,YAAY,GAAG,EAAI,eAAe;EAClC,YAAY,GAAG,EAAI,eAAe;EAClC;CACF;AACF"}

package/dist/websocket/notifications/parse-frame-payload.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Decode an inbound `event.data` into a plain object, or `null` when it is not
+ * one (malformed JSON, primitives, binary). Shared first step of every
+ * protocol adapter's frame parser.
+ */
+export declare function parseFramePayload(data: unknown): Record<string, unknown> | null;
+//# sourceMappingURL=parse-frame-payload.d.ts.map

package/dist/websocket/notifications/parse-frame-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-frame-payload.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/parse-frame-payload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAW/E"}

package/dist/websocket/notifications/parse-frame-payload.js

@@ -0,0 +1,14 @@
+//#region src/websocket/notifications/parse-frame-payload.ts
+function e(e) {
+	let t = e;
+	if (typeof e == "string") try {
+		t = JSON.parse(e);
+	} catch {
+		return null;
+	}
+	return !t || typeof t != "object" ? null : t;
+}
+//#endregion
+export { e as parseFramePayload };
+
+//# sourceMappingURL=parse-frame-payload.js.map

package/dist/websocket/notifications/parse-frame-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-frame-payload.js","names":[],"sources":["../../../src/websocket/notifications/parse-frame-payload.ts"],"sourcesContent":["/**\n * Decode an inbound `event.data` into a plain object, or `null` when it is not\n * one (malformed JSON, primitives, binary). Shared first step of every\n * protocol adapter's frame parser.\n */\nexport function parseFramePayload(data: unknown): Record<string, unknown> | null {\n  let parsed: unknown = data;\n  if (typeof data === \"string\") {\n    try {\n      parsed = JSON.parse(data);\n    } catch {\n      return null;\n    }\n  }\n  if (!parsed || typeof parsed !== \"object\") return null;\n  return parsed as Record<string, unknown>;\n}\n"],"mappings":";AAKA,SAAgB,EAAkB,GAA+C;CAC/E,IAAI,IAAkB;CACtB,IAAI,OAAO,KAAS,UAClB,IAAI;EACF,IAAS,KAAK,MAAM,CAAI;CAC1B,QAAQ;EACN,OAAO;CACT;CAGF,OADI,CAAC,KAAU,OAAO,KAAW,WAAiB,OAC3C;AACT"}

package/dist/websocket/notifications/parse-notification-frame.d.ts

@@ -1,15 +1,22 @@
 import { SymmioNotificationsProtocol } from '../../core/chains/index.js';
-import { RawPositionNotification } from './types.js';
+import { RawEnigmaPositionNotification, RawPositionNotification, RawRasaPositionNotification } from './types.js';
 /**
- * Parse an inbound socket frame into a {@link RawPositionNotification}, or
- * `null` when the frame is not a notification (control/ack frames, malformed
- * JSON, or a missing payload — all skipped silently by the caller).
+ * Parse an inbound socket frame into the protocol's wire-faithful
+ * {@link RawPositionNotification} variant, or `null` when the frame is not a
+ * notification (control/ack frames, malformed JSON, or a missing payload — all
+ * skipped silently by the caller). A literal `protocol` narrows the return to
+ * that protocol's variant.
  *
- * For `defilytics`, the notification is unwrapped from its `{ data, address }`
- * envelope and the top-level `address` is hoisted onto the frame.
+ * Thin protocol dispatch — each protocol's quirks live in its adapter. For
+ * `enigma`, the notification is unwrapped from its `{ data, address }`
+ * envelope and the top-level `address` is hoisted onto the frame. For `rasa`,
+ * the frame arrives bare and is kept as sent (numeric zero-sentinels included
+ * — `normalizeNotification` reconciles them).
  *
  * @param data - The raw `event.data` (a JSON string, or an already-parsed object).
  * @param protocol - The endpoint's wire protocol.
  */
+export declare function parseNotificationFrame(data: unknown, protocol: "enigma"): RawEnigmaPositionNotification | null;
+export declare function parseNotificationFrame(data: unknown, protocol: "rasa"): RawRasaPositionNotification | null;
 export declare function parseNotificationFrame(data: unknown, protocol: SymmioNotificationsProtocol): RawPositionNotification | null;
 //# sourceMappingURL=parse-notification-frame.d.ts.map

package/dist/websocket/notifications/parse-notification-frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-notification-frame.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/parse-notification-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAkC,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,2BAA2B,GACpC,uBAAuB,GAAG,IAAI,CAsBhC"}
+{"version":3,"file":"parse-notification-frame.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/parse-notification-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,KAAK,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAEnH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,6BAA6B,GAAG,IAAI,CAAC;AAChH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI,CAAC;AAC5G,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,2BAA2B,GACpC,uBAAuB,GAAG,IAAI,CAAC"}

package/dist/websocket/notifications/parse-notification-frame.js

@@ -1,22 +1,13 @@
+import { parseEnigmaNotificationFrame as e } from "./adapters/enigma-notifications.js";
+import { parseRasaNotificationFrame as t } from "./adapters/rasa-notifications.js";
 //#region src/websocket/notifications/parse-notification-frame.ts
-function e(e, t) {
-	let n = e;
-	if (typeof e == "string") try {
-		n = JSON.parse(e);
-	} catch {
-		return null;
+function n(n, r) {
+	switch (r) {
+		case "enigma": return e(n);
+		case "rasa": return t(n);
 	}
-	if (!n || typeof n != "object") return null;
-	if (t === "defilytics") {
-		let e = n, t = e.data;
-		return !t || typeof t != "object" ? null : {
-			...t,
-			address: e.address ?? t.address
-		};
-	}
-	return n;
 }
 //#endregion
-export { e as parseNotificationFrame };
+export { n as parseNotificationFrame };
 
 //# sourceMappingURL=parse-notification-frame.js.map

package/dist/websocket/notifications/parse-notification-frame.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-notification-frame.js","names":[],"sources":["../../../src/websocket/notifications/parse-notification-frame.ts"],"sourcesContent":["import type { SymmioNotificationsProtocol } from \"../../core/chains\";\nimport type { DefilyticsNotificationEnvelope, RawPositionNotification } from \"./types\";\n\n/**\n * Parse an inbound socket frame into a {@link RawPositionNotification}, or\n * `null` when the frame is not a notification (control/ack frames, malformed\n * JSON, or a missing payload — all skipped silently by the caller).\n *\n * For `defilytics`, the notification is unwrapped from its `{ data, address }`\n * envelope and the top-level `address` is hoisted onto the frame.\n *\n * @param data - The raw `event.data` (a JSON string, or an already-parsed object).\n * @param protocol - The endpoint's wire protocol.\n */\nexport function parseNotificationFrame(\n  data: unknown,\n  protocol: SymmioNotificationsProtocol,\n): RawPositionNotification | null {\n  let parsed: unknown = data;\n  if (typeof data === \"string\") {\n    try {\n      parsed = JSON.parse(data);\n    } catch {\n      return null;\n    }\n  }\n  if (!parsed || typeof parsed !== \"object\") return null;\n\n  if (protocol === \"defilytics\") {\n    const envelope = parsed as Partial<DefilyticsNotificationEnvelope>;\n    const inner = envelope.data;\n    // A notification frame nests its payload under `data`; control/ack frames\n    // (no `data` object) are skipped. The payload itself may omit `id`.\n    if (!inner || typeof inner !== \"object\") return null;\n    return { ...inner, address: envelope.address ?? inner.address };\n  }\n\n  // Non-enveloped protocols deliver the notification frame directly.\n  return parsed as RawPositionNotification;\n}\n"],"mappings":";AAcA,SAAgB,EACd,GACA,GACgC;CAChC,IAAI,IAAkB;CACtB,IAAI,OAAO,KAAS,UAClB,IAAI;EACF,IAAS,KAAK,MAAM,CAAI;CAC1B,QAAQ;EACN,OAAO;CACT;CAEF,IAAI,CAAC,KAAU,OAAO,KAAW,UAAU,OAAO;CAElD,IAAI,MAAa,cAAc;EAC7B,IAAM,IAAW,GACX,IAAQ,EAAS;EAIvB,OADI,CAAC,KAAS,OAAO,KAAU,WAAiB,OACzC;GAAE,GAAG;GAAO,SAAS,EAAS,WAAW,EAAM;EAAQ;CAChE;CAGA,OAAO;AACT"}
+{"version":3,"file":"parse-notification-frame.js","names":[],"sources":["../../../src/websocket/notifications/parse-notification-frame.ts"],"sourcesContent":["import type { SymmioNotificationsProtocol } from \"../../core/chains\";\nimport { parseEnigmaNotificationFrame } from \"./adapters/enigma-notifications\";\nimport { parseRasaNotificationFrame } from \"./adapters/rasa-notifications\";\nimport type { RawEnigmaPositionNotification, RawPositionNotification, RawRasaPositionNotification } from \"./types\";\n\n/**\n * Parse an inbound socket frame into the protocol's wire-faithful\n * {@link RawPositionNotification} variant, or `null` when the frame is not a\n * notification (control/ack frames, malformed JSON, or a missing payload — all\n * skipped silently by the caller). A literal `protocol` narrows the return to\n * that protocol's variant.\n *\n * Thin protocol dispatch — each protocol's quirks live in its adapter. For\n * `enigma`, the notification is unwrapped from its `{ data, address }`\n * envelope and the top-level `address` is hoisted onto the frame. For `rasa`,\n * the frame arrives bare and is kept as sent (numeric zero-sentinels included\n * — `normalizeNotification` reconciles them).\n *\n * @param data - The raw `event.data` (a JSON string, or an already-parsed object).\n * @param protocol - The endpoint's wire protocol.\n */\nexport function parseNotificationFrame(data: unknown, protocol: \"enigma\"): RawEnigmaPositionNotification | null;\nexport function parseNotificationFrame(data: unknown, protocol: \"rasa\"): RawRasaPositionNotification | null;\nexport function parseNotificationFrame(\n  data: unknown,\n  protocol: SymmioNotificationsProtocol,\n): RawPositionNotification | null;\nexport function parseNotificationFrame(\n  data: unknown,\n  protocol: SymmioNotificationsProtocol,\n): RawPositionNotification | null {\n  switch (protocol) {\n    case \"enigma\":\n      return parseEnigmaNotificationFrame(data);\n    case \"rasa\":\n      return parseRasaNotificationFrame(data);\n  }\n}\n"],"mappings":";;;AA2BA,SAAgB,EACd,GACA,GACgC;CAChC,QAAQ,GAAR;EACE,KAAK,UACH,OAAO,EAA6B,CAAI;EAC1C,KAAK,QACH,OAAO,EAA2B,CAAI;CAC1C;AACF"}

package/dist/websocket/notifications/to-notifications-error.d.ts

@@ -0,0 +1,8 @@
+import { SymmError } from '../../shared/errors/symm-error.js';
+/**
+ * Wrap a transport or parse failure from a notifications socket in the SDK's
+ * typed error, passing an already-typed {@link SymmError} through untouched.
+ * Shared by every protocol adapter so consumers see one error shape.
+ */
+export declare function toNotificationsError(event: unknown): SymmError;
+//# sourceMappingURL=to-notifications-error.d.ts.map

package/dist/websocket/notifications/to-notifications-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-notifications-error.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/to-notifications-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAW9D"}

package/dist/websocket/notifications/to-notifications-error.js

@@ -0,0 +1,11 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+//#region src/websocket/notifications/to-notifications-error.ts
+function t(t) {
+	if (t instanceof e) return t;
+	let n = t instanceof Error ? t : void 0;
+	return new e("api", "NOTIFICATIONS_SOCKET_ERROR", `Notifications socket error${n ? `: ${n.message}` : "."}`, { cause: n });
+}
+//#endregion
+export { t as toNotificationsError };
+
+//# sourceMappingURL=to-notifications-error.js.map

package/dist/websocket/notifications/to-notifications-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-notifications-error.js","names":[],"sources":["../../../src/websocket/notifications/to-notifications-error.ts"],"sourcesContent":["import { SymmError } from \"../../shared/errors/symm-error\";\n\n/**\n * Wrap a transport or parse failure from a notifications socket in the SDK's\n * typed error, passing an already-typed {@link SymmError} through untouched.\n * Shared by every protocol adapter so consumers see one error shape.\n */\nexport function toNotificationsError(event: unknown): SymmError {\n  if (event instanceof SymmError) return event;\n  const cause = event instanceof Error ? event : undefined;\n  return new SymmError(\n    \"api\",\n    \"NOTIFICATIONS_SOCKET_ERROR\",\n    `Notifications socket error${cause ? `: ${cause.message}` : \".\"}`,\n    {\n      cause,\n    },\n  );\n}\n"],"mappings":";;AAOA,SAAgB,EAAqB,GAA2B;CAC9D,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EACT,OACA,8BACA,6BAA6B,IAAQ,KAAK,EAAM,YAAY,OAC5D,EACE,SACF,CACF;AACF"}

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

@@ -1,46 +1,116 @@
+import { Address } from 'viem';
+import { SolverId } from '../../core/chains/index.js';
+import { SymmError } from '../../shared/errors/symm-error.js';
+import { SocketStatus } from '../socket/socket-status.js';
 /**
- * Raw position-state notification frame as it arrives on the wire (snake_case),
- * mirroring the hedger/solver payload. Consumers normally receive the
- * normalized {@link Notification}; the raw frame is retained on it as `raw`.
- *
- * The endpoint omits fields that do not apply to a given frame (e.g. an
+ * Stop a {@link watchNotifications} subscription. Idempotent; the shared socket
+ * closes once the last watcher on an endpoint releases.
+ */
+export type Unwatch = () => void;
+/**
+ * Parameters for `watchNotifications`.
+ */
+export interface WatchNotificationsParameters {
+    /** SubAccount address to subscribe for. */
+    account: Address;
+    /** Target chain id. Defaults to the config's `defaultChainId`. */
+    chainId?: number;
+    /** Target solver. Defaults to the chain's default solver; selects the notifications endpoint + protocol. */
+    solverId?: SolverId;
+    /** Called for every normalized notification frame. */
+    onNotification: (notification: Notification) => 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;
+}
+/**
+ * Fields every notifications wire returns, snake_case as they arrive. The
+ * endpoints omit fields that do not apply to a given frame (e.g. an
  * `InstantRFQ` report carries no `id`), so almost every field is optional;
- * {@link normalizeNotification} fills sensible defaults.
+ * {@link normalizeNotification} fills sensible defaults and reconciles the
+ * per-wire value quirks.
+ *
+ * Amount/price fields are typed to the **widest** wire form here (`number |
+ * string | null`) because that is what covers every wire: the rasa endpoint
+ * sends a numeric `0` for "no value", the enigma endpoint only ever sends a
+ * decimal string. Only fields **exclusive** to one wire live on the variants
+ * below.
  */
-export interface RawPositionNotification {
+interface RawPositionNotificationBase {
     id?: string;
-    /** On-chain quote id, or `0` while the order is still off-chain. */
+    /** On-chain quote id — `0` (enigma) or the negative temp id (rasa) while the order is still off-chain. */
     quote_id?: number;
     /** Negative placeholder id assigned before the on-chain quote id exists. */
     temp_quote_id?: number;
     create_time?: number;
     modify_time?: number;
     counterparty_address?: string;
-    /** SubAccount address the notification belongs to. */
+    /**
+     * SubAccount address the notification belongs to. On the enigma wire it is
+     * hoisted from the envelope; rasa frames do not carry it — the watcher
+     * stamps it from its own subscription.
+     */
     address?: string;
-    /** Solver-assigned Virtual Account address (lowcap), when present. */
-    va_address?: string;
-    filled_amount_open?: string | null;
-    filled_amount_close?: string | null;
+    /**
+     * Filled base amount on the open leg. Decimal string when present (enigma
+     * always; rasa on a `report`); numeric `0` on a rasa `alert` duplicate;
+     * absent/`null` otherwise. Same for the three fields below.
+     */
+    filled_amount_open?: number | string | null;
+    filled_amount_close?: number | string | null;
+    avg_price_open?: number | string | null;
+    avg_price_close?: number | string | null;
     /** Last solver action seen for this quote (e.g. `SendQuoteTransaction`). */
     last_seen_action?: string | null;
     /** `success` | `failed` | `seen`. */
     action_status?: string | null;
     failure_type?: string | null;
-    failure_message?: string | null;
     error_code?: number | null;
     /** `report` | `alert`. */
     state_type?: string | null;
+}
+/**
+ * Raw frame as the enigma (channel-scoped) endpoint sends it, after the
+ * `{ data, address }` envelope unwrap. Adds the fields only this wire carries;
+ * on this wire the shared amount/price fields are always decimal strings (or
+ * `null`/absent), never numbers.
+ */
+export interface RawEnigmaPositionNotification extends RawPositionNotificationBase {
+    /** Solver-assigned Virtual Account address (lowcap), when present. */
+    va_address?: string;
+    failure_message?: string | null;
     version?: number;
-    avg_price_open?: string;
-    avg_price_close?: string;
 }
 /**
- * Envelope used by the `defilytics` endpoint: the notification is nested under
+ * Raw frame as the rasa position-state endpoint sends it, bare (no envelope).
+ * Wire quirks, preserved as-is (the shared {@link normalizeNotification}
+ * reconciles them):
+ *
+ * - the shared amount/price fields are the numeric `0` when the frame carries
+ *   no value (an `alert` duplicate) and a decimal **string** when it does (a
+ *   `report`);
+ * - there is no `address` / `va_address` on the wire — the SubAccount arrives
+ *   as `counterparty_address` only, and `quote_id` equals the negative
+ *   `temp_quote_id` until the on-chain id is assigned.
+ */
+export interface RawRasaPositionNotification extends RawPositionNotificationBase {
+    /** Order type discriminant the rasa wire attaches (e.g. `1`). */
+    order_type?: number;
+}
+/**
+ * Raw position-state notification frame as it arrives on the wire — one
+ * variant per notifications protocol. Consumers normally receive the
+ * normalized {@link Notification}; the wire-faithful frame is retained on it
+ * as `raw`.
+ */
+export type RawPositionNotification = RawEnigmaPositionNotification | RawRasaPositionNotification;
+/**
+ * Envelope used by the `enigma` endpoint: the notification is nested under
  * `data`, with the SubAccount address hoisted to the top level.
  */
-export interface DefilyticsNotificationEnvelope {
-    data: RawPositionNotification;
+export interface EnigmaNotificationEnvelope {
+    data: RawEnigmaPositionNotification;
     address: string;
 }
 /**
@@ -97,4 +167,5 @@ export interface Notification {
     /** The original wire frame. */
     raw: RawPositionNotification;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/websocket/notifications/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,EAAE,gBAAgB,CAAC;IACvB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8CAA8C;IAC9C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sEAAsE;IACtE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,GAAG,EAAE,uBAAuB,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sDAAsD;IACtD,cAAc,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IACrD,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;;;;;;;;;;;;GAYG;AACH,UAAU,2BAA2B;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5C,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA8B,SAAQ,2BAA2B;IAChF,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,GAAG,2BAA2B,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,EAAE,gBAAgB,CAAC;IACvB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8CAA8C;IAC9C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sEAAsE;IACtE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,GAAG,EAAE,uBAAuB,CAAC;CAC9B"}

package/dist/websocket/notifications/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/websocket/notifications/types.ts"],"sourcesContent":["/**\n * Raw position-state notification frame as it arrives on the wire (snake_case),\n * mirroring the hedger/solver payload. Consumers normally receive the\n * normalized {@link Notification}; the raw frame is retained on it as `raw`.\n *\n * The endpoint omits fields that do not apply to a given frame (e.g. an\n * `InstantRFQ` report carries no `id`), so almost every field is optional;\n * {@link normalizeNotification} fills sensible defaults.\n */\nexport interface RawPositionNotification {\n  id?: string;\n  /** On-chain quote id, or `0` while the order is still off-chain. */\n  quote_id?: number;\n  /** Negative placeholder id assigned before the on-chain quote id exists. */\n  temp_quote_id?: number;\n  create_time?: number;\n  modify_time?: number;\n  counterparty_address?: string;\n  /** SubAccount address the notification belongs to. */\n  address?: string;\n  /** Solver-assigned Virtual Account address (lowcap), when present. */\n  va_address?: string;\n  filled_amount_open?: string | null;\n  filled_amount_close?: string | null;\n  /** Last solver action seen for this quote (e.g. `SendQuoteTransaction`). */\n  last_seen_action?: string | null;\n  /** `success` | `failed` | `seen`. */\n  action_status?: string | null;\n  failure_type?: string | null;\n  failure_message?: string | null;\n  error_code?: number | null;\n  /** `report` | `alert`. */\n  state_type?: string | null;\n  version?: number;\n  avg_price_open?: string;\n  avg_price_close?: string;\n}\n\n/**\n * Envelope used by the `defilytics` endpoint: the notification is nested under\n * `data`, with the SubAccount address hoisted to the top level.\n */\nexport interface DefilyticsNotificationEnvelope {\n  data: RawPositionNotification;\n  address: string;\n}\n\n/**\n * The `action_status` values a notification can carry.\n */\nexport enum ActionStatus {\n  SUCCESS = \"success\",\n  FAILED = \"failed\",\n  SEEN = \"seen\",\n}\n\n/**\n * Classification of a notification, derived from its {@link ActionStatus}.\n * Unknown statuses are treated as {@link NotificationType.FAILED}.\n */\nexport enum NotificationType {\n  SUCCESS = \"success\",\n  FAILED = \"failed\",\n  SEEN = \"seen\",\n}\n\n/**\n * A normalized, classified notification the SDK delivers to consumers.\n *\n * camelCase, with `quoteId` resolved to the on-chain id when available (falling\n * back to the temp id), and `type` classified from `actionStatus`. The original\n * wire frame is preserved on `raw` for advanced use.\n */\nexport interface Notification {\n  id: string;\n  /** On-chain quote id as a string, or the temp id when no on-chain id exists yet. */\n  quoteId: string;\n  /** The temp (pre-chain) quote id; negative until the on-chain id is assigned. */\n  tempQuoteId: number;\n  /** Classification derived from {@link Notification.actionStatus}. */\n  type: NotificationType;\n  /** Raw `action_status` (`success` | `failed` | `seen`), or `null`. */\n  actionStatus: string | null;\n  /** Last solver action seen for this quote. */\n  lastSeenAction: string | null;\n  /** SubAccount address this notification belongs to. */\n  account: string | null;\n  /** Solver-assigned Virtual Account address (lowcap), when present. */\n  vaAddress: string | null;\n  counterpartyAddress: string;\n  filledAmountOpen: string | null;\n  filledAmountClose: string | null;\n  avgPriceOpen: string;\n  avgPriceClose: string;\n  failureType: string | null;\n  failureMessage: string | null;\n  errorCode: number | null;\n  stateType: string | null;\n  createTime: string;\n  modifyTime: string;\n  /** The original wire frame. */\n  raw: RawPositionNotification;\n}\n"],"mappings":";AAkDA,IAAY,IAAL,yBAAA,GAAA;QACL,EAAA,UAAA,WACA,EAAA,SAAA,UACA,EAAA,OAAA;AACF,EAAA,CAAA,CAAA,GAMY,IAAL,yBAAA,GAAA;QACL,EAAA,UAAA,WACA,EAAA,SAAA,UACA,EAAA,OAAA;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/websocket/notifications/types.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { SolverId } from \"../../core/chains\";\nimport type { SymmError } from \"../../shared/errors/symm-error\";\nimport type { SocketStatus } from \"../socket/socket-status\";\n\n/**\n * Stop a {@link watchNotifications} subscription. Idempotent; the shared socket\n * closes once the last watcher on an endpoint releases.\n */\nexport type Unwatch = () => void;\n\n/**\n * Parameters for `watchNotifications`.\n */\nexport interface WatchNotificationsParameters {\n  /** SubAccount address to subscribe for. */\n  account: Address;\n  /** Target chain id. Defaults to the config's `defaultChainId`. */\n  chainId?: number;\n  /** Target solver. Defaults to the chain's default solver; selects the notifications endpoint + protocol. */\n  solverId?: SolverId;\n  /** Called for every normalized notification frame. */\n  onNotification: (notification: Notification) => 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 * Fields every notifications wire returns, snake_case as they arrive. The\n * endpoints omit fields that do not apply to a given frame (e.g. an\n * `InstantRFQ` report carries no `id`), so almost every field is optional;\n * {@link normalizeNotification} fills sensible defaults and reconciles the\n * per-wire value quirks.\n *\n * Amount/price fields are typed to the **widest** wire form here (`number |\n * string | null`) because that is what covers every wire: the rasa endpoint\n * sends a numeric `0` for \"no value\", the enigma endpoint only ever sends a\n * decimal string. Only fields **exclusive** to one wire live on the variants\n * below.\n */\ninterface RawPositionNotificationBase {\n  id?: string;\n  /** On-chain quote id — `0` (enigma) or the negative temp id (rasa) while the order is still off-chain. */\n  quote_id?: number;\n  /** Negative placeholder id assigned before the on-chain quote id exists. */\n  temp_quote_id?: number;\n  create_time?: number;\n  modify_time?: number;\n  counterparty_address?: string;\n  /**\n   * SubAccount address the notification belongs to. On the enigma wire it is\n   * hoisted from the envelope; rasa frames do not carry it — the watcher\n   * stamps it from its own subscription.\n   */\n  address?: string;\n  /**\n   * Filled base amount on the open leg. Decimal string when present (enigma\n   * always; rasa on a `report`); numeric `0` on a rasa `alert` duplicate;\n   * absent/`null` otherwise. Same for the three fields below.\n   */\n  filled_amount_open?: number | string | null;\n  filled_amount_close?: number | string | null;\n  avg_price_open?: number | string | null;\n  avg_price_close?: number | string | null;\n  /** Last solver action seen for this quote (e.g. `SendQuoteTransaction`). */\n  last_seen_action?: string | null;\n  /** `success` | `failed` | `seen`. */\n  action_status?: string | null;\n  failure_type?: string | null;\n  error_code?: number | null;\n  /** `report` | `alert`. */\n  state_type?: string | null;\n}\n\n/**\n * Raw frame as the enigma (channel-scoped) endpoint sends it, after the\n * `{ data, address }` envelope unwrap. Adds the fields only this wire carries;\n * on this wire the shared amount/price fields are always decimal strings (or\n * `null`/absent), never numbers.\n */\nexport interface RawEnigmaPositionNotification extends RawPositionNotificationBase {\n  /** Solver-assigned Virtual Account address (lowcap), when present. */\n  va_address?: string;\n  failure_message?: string | null;\n  version?: number;\n}\n\n/**\n * Raw frame as the rasa position-state endpoint sends it, bare (no envelope).\n * Wire quirks, preserved as-is (the shared {@link normalizeNotification}\n * reconciles them):\n *\n * - the shared amount/price fields are the numeric `0` when the frame carries\n *   no value (an `alert` duplicate) and a decimal **string** when it does (a\n *   `report`);\n * - there is no `address` / `va_address` on the wire — the SubAccount arrives\n *   as `counterparty_address` only, and `quote_id` equals the negative\n *   `temp_quote_id` until the on-chain id is assigned.\n */\nexport interface RawRasaPositionNotification extends RawPositionNotificationBase {\n  /** Order type discriminant the rasa wire attaches (e.g. `1`). */\n  order_type?: number;\n}\n\n/**\n * Raw position-state notification frame as it arrives on the wire — one\n * variant per notifications protocol. Consumers normally receive the\n * normalized {@link Notification}; the wire-faithful frame is retained on it\n * as `raw`.\n */\nexport type RawPositionNotification = RawEnigmaPositionNotification | RawRasaPositionNotification;\n\n/**\n * Envelope used by the `enigma` endpoint: the notification is nested under\n * `data`, with the SubAccount address hoisted to the top level.\n */\nexport interface EnigmaNotificationEnvelope {\n  data: RawEnigmaPositionNotification;\n  address: string;\n}\n\n/**\n * The `action_status` values a notification can carry.\n */\nexport enum ActionStatus {\n  SUCCESS = \"success\",\n  FAILED = \"failed\",\n  SEEN = \"seen\",\n}\n\n/**\n * Classification of a notification, derived from its {@link ActionStatus}.\n * Unknown statuses are treated as {@link NotificationType.FAILED}.\n */\nexport enum NotificationType {\n  SUCCESS = \"success\",\n  FAILED = \"failed\",\n  SEEN = \"seen\",\n}\n\n/**\n * A normalized, classified notification the SDK delivers to consumers.\n *\n * camelCase, with `quoteId` resolved to the on-chain id when available (falling\n * back to the temp id), and `type` classified from `actionStatus`. The original\n * wire frame is preserved on `raw` for advanced use.\n */\nexport interface Notification {\n  id: string;\n  /** On-chain quote id as a string, or the temp id when no on-chain id exists yet. */\n  quoteId: string;\n  /** The temp (pre-chain) quote id; negative until the on-chain id is assigned. */\n  tempQuoteId: number;\n  /** Classification derived from {@link Notification.actionStatus}. */\n  type: NotificationType;\n  /** Raw `action_status` (`success` | `failed` | `seen`), or `null`. */\n  actionStatus: string | null;\n  /** Last solver action seen for this quote. */\n  lastSeenAction: string | null;\n  /** SubAccount address this notification belongs to. */\n  account: string | null;\n  /** Solver-assigned Virtual Account address (lowcap), when present. */\n  vaAddress: string | null;\n  counterpartyAddress: string;\n  filledAmountOpen: string | null;\n  filledAmountClose: string | null;\n  avgPriceOpen: string;\n  avgPriceClose: string;\n  failureType: string | null;\n  failureMessage: string | null;\n  errorCode: number | null;\n  stateType: string | null;\n  createTime: string;\n  modifyTime: string;\n  /** The original wire frame. */\n  raw: RawPositionNotification;\n}\n"],"mappings":";AA8HA,IAAY,IAAL,yBAAA,GAAA;QACL,EAAA,UAAA,WACA,EAAA,SAAA,UACA,EAAA,OAAA;AACF,EAAA,CAAA,CAAA,GAMY,IAAL,yBAAA,GAAA;QACL,EAAA,UAAA,WACA,EAAA,SAAA,UACA,EAAA,OAAA;AACF,EAAA,CAAA,CAAA"}

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

@@ -1,36 +1,20 @@
-import { Address } from 'viem';
 import { Config } from '../../core/config/index.js';
-import { SymmError } from '../../shared/errors/symm-error.js';
-import { SocketStatus } from '../socket/socket-status.js';
-import { Notification } from './types.js';
-/**
- * Stop a {@link watchNotifications} subscription. Idempotent; the shared socket
- * closes once the last watcher on an endpoint+account releases.
- */
-export type Unwatch = () => void;
-/**
- * Parameters for {@link watchNotifications}.
- */
-export interface WatchNotificationsParameters {
-    /** SubAccount address to subscribe for. */
-    account: Address;
-    /** Target chain id. Defaults to the config's `defaultChainId`. */
-    chainId?: number;
-    /** Called for every normalized notification frame. */
-    onNotification: (notification: Notification) => 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;
-}
+import { Unwatch, WatchNotificationsParameters } from './types.js';
+export type { Unwatch } from './types.js';
 /**
  * Subscribe to live position/quote state notifications for an account.
  *
  * Opens (or reuses) one reconnecting socket to the chain's notifications
  * endpoint, sends the subscribe frame on every (re)connect, normalizes inbound
- * frames into {@link Notification}s, and invokes the handlers. Watchers sharing
- * the same endpoint+account share one socket; it closes when the last one
- * unwatches.
+ * frames into `Notification`s, and invokes the handlers. Thin protocol
+ * dispatch — each protocol's subscribe, parse, and socket-sharing story lives
+ * in its adapter:
+ *
+ * - `enigma`: watchers sharing the same endpoint+account share one socket.
+ * - `rasa`: watchers multiplex every account onto one socket per endpoint (the
+ *   subscribe frame carries the full address list).
+ *
+ * Either way, the socket closes when the last watcher unwatches.
  *
  * @param config - The SDK config.
  * @param parameters - The account to watch and the handlers to invoke.

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

@@ -1 +1 @@
-{"version":3,"file":"watch-notifications.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/watch-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,cAAc,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IACrD,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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,4BAA4B,GAAG,OAAO,CA4CpG"}
+{"version":3,"file":"watch-notifications.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/watch-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAIrE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,4BAA4B,GAAG,OAAO,CAQpG"}

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

@@ -1,48 +1,17 @@
-import { SymmError as e } from "../../shared/errors/symm-error.js";
-import { buildSubscribeMessage as t } from "./build-subscribe-message.js";
-import { normalizeNotification as n } from "./normalize-notification.js";
-import { parseNotificationFrame as r } from "./parse-notification-frame.js";
-import { createReconnectingSocket as i } from "../socket/create-reconnecting-socket.js";
-import { getSocketPool as a } from "../socket/get-socket-pool.js";
+import { watchEnigmaNotifications as e } from "./adapters/enigma-notifications.js";
+import { watchRasaNotifications as t } from "./adapters/rasa-notifications.js";
 //#region src/websocket/notifications/watch-notifications.ts
-function o(t) {
-	if (t instanceof e) return t;
-	let n = t instanceof Error ? t : void 0;
-	return new e("api", "NOTIFICATIONS_SOCKET_ERROR", `Notifications socket error${n ? `: ${n.message}` : "."}`, { cause: n });
-}
-function s(e, s) {
-	let { account: c, chainId: l, onNotification: u, onStatusChange: d, onError: f } = s, { notifications: p } = e.getChainConfig(l), m = e.getWebSocketConstructor(), h = t({
-		account: c,
-		channel: p.channel,
-		protocol: p.protocol
-	}), g = `${p.url}|${p.protocol}|${c.toLowerCase()}`;
-	return a(e).acquire(g, (e) => i({
-		url: p.url,
-		webSocketConstructor: m,
-		getOpenMessages: () => [h],
-		onMessage: e.onMessage,
-		onStatusChange: e.onStatusChange,
-		onError: e.onError
-	}), {
-		onMessage: (e) => {
-			let t;
-			try {
-				t = r(e, p.protocol);
-			} catch (e) {
-				f?.(o(e));
-				return;
-			}
-			if (t) try {
-				u(n(t));
-			} catch (e) {
-				f?.(o(e));
-			}
-		},
-		onStatusChange: d,
-		onError: (e) => f?.(o(e))
+function n(n, r) {
+	let { notifications: i } = n.getSolver({
+		chainId: r.chainId,
+		solverId: r.solverId
 	});
+	switch (i.protocol) {
+		case "enigma": return e(n, i, r);
+		case "rasa": return t(n, i, r);
+	}
 }
 //#endregion
-export { s as watchNotifications };
+export { n as watchNotifications };
 
 //# sourceMappingURL=watch-notifications.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"watch-notifications.js","names":[],"sources":["../../../src/websocket/notifications/watch-notifications.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport { createReconnectingSocket } from \"../socket/create-reconnecting-socket\";\nimport { getSocketPool } from \"../socket/get-socket-pool\";\nimport type { SocketStatus } from \"../socket/socket-status\";\nimport { buildSubscribeMessage } from \"./build-subscribe-message\";\nimport { normalizeNotification } from \"./normalize-notification\";\nimport { parseNotificationFrame } from \"./parse-notification-frame\";\nimport type { Notification } from \"./types\";\n\n/**\n * Stop a {@link watchNotifications} subscription. Idempotent; the shared socket\n * closes once the last watcher on an endpoint+account releases.\n */\nexport type Unwatch = () => void;\n\n/**\n * Parameters for {@link watchNotifications}.\n */\nexport interface WatchNotificationsParameters {\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 notification frame. */\n  onNotification: (notification: Notification) => 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 toNotificationsError(event: unknown): SymmError {\n  if (event instanceof SymmError) return event;\n  const cause = event instanceof Error ? event : undefined;\n  return new SymmError(\n    \"api\",\n    \"NOTIFICATIONS_SOCKET_ERROR\",\n    `Notifications socket error${cause ? `: ${cause.message}` : \".\"}`,\n    {\n      cause,\n    },\n  );\n}\n\n/**\n * Subscribe to live position/quote state notifications for an account.\n *\n * Opens (or reuses) one reconnecting socket to the chain's notifications\n * endpoint, sends the subscribe frame on every (re)connect, normalizes inbound\n * frames into {@link Notification}s, and invokes the handlers. Watchers sharing\n * the same endpoint+account share one socket; it closes when the last one\n * unwatches.\n *\n * @param config - The SDK config.\n * @param parameters - The account to watch and the handlers to invoke.\n * @returns An unwatch function that releases this subscription.\n * @throws {SymmError} synchronously when the chain is unsupported or no\n *   `WebSocket` implementation is available.\n *\n * @example\n * ```ts\n * const unwatch = watchNotifications(config, {\n *   account: \"0xabc…\",\n *   onNotification: (n) => console.log(n.type, n.quoteId),\n *   onStatusChange: (status) => console.log(status),\n * });\n * // later\n * unwatch();\n * ```\n */\nexport function watchNotifications(config: Config, parameters: WatchNotificationsParameters): Unwatch {\n  const { account, chainId, onNotification, onStatusChange, onError } = parameters;\n\n  const { notifications } = config.getChainConfig(chainId);\n  const webSocketConstructor = config.getWebSocketConstructor();\n  const subscribeMessage = buildSubscribeMessage({\n    account,\n    channel: notifications.channel,\n    protocol: notifications.protocol,\n  });\n\n  const key = `${notifications.url}|${notifications.protocol}|${account.toLowerCase()}`;\n\n  return getSocketPool(config).acquire(\n    key,\n    (handlers) =>\n      createReconnectingSocket({\n        url: notifications.url,\n        webSocketConstructor,\n        getOpenMessages: () => [subscribeMessage],\n        onMessage: handlers.onMessage,\n        onStatusChange: handlers.onStatusChange,\n        onError: handlers.onError,\n      }),\n    {\n      onMessage: (data) => {\n        let raw;\n        try {\n          raw = parseNotificationFrame(data, notifications.protocol);\n        } catch (err) {\n          onError?.(toNotificationsError(err));\n          return;\n        }\n        if (!raw) return;\n        try {\n          onNotification(normalizeNotification(raw));\n        } catch (err) {\n          onError?.(toNotificationsError(err));\n        }\n      },\n      onStatusChange,\n      onError: (event) => onError?.(toNotificationsError(event)),\n    },\n  );\n}\n"],"mappings":";;;;;;;AAiCA,SAAS,EAAqB,GAA2B;CACvD,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EACT,OACA,8BACA,6BAA6B,IAAQ,KAAK,EAAM,YAAY,OAC5D,EACE,SACF,CACF;AACF;AA4BA,SAAgB,EAAmB,GAAgB,GAAmD;CACpG,IAAM,EAAE,YAAS,YAAS,mBAAgB,mBAAgB,eAAY,GAEhE,EAAE,qBAAkB,EAAO,eAAe,CAAO,GACjD,IAAuB,EAAO,wBAAwB,GACtD,IAAmB,EAAsB;EAC7C;EACA,SAAS,EAAc;EACvB,UAAU,EAAc;CAC1B,CAAC,GAEK,IAAM,GAAG,EAAc,IAAI,GAAG,EAAc,SAAS,GAAG,EAAQ,YAAY;CAElF,OAAO,EAAc,CAAM,EAAE,QAC3B,IACC,MACC,EAAyB;EACvB,KAAK,EAAc;EACnB;EACA,uBAAuB,CAAC,CAAgB;EACxC,WAAW,EAAS;EACpB,gBAAgB,EAAS;EACzB,SAAS,EAAS;CACpB,CAAC,GACH;EACE,YAAY,MAAS;GACnB,IAAI;GACJ,IAAI;IACF,IAAM,EAAuB,GAAM,EAAc,QAAQ;GAC3D,SAAS,GAAK;IACZ,IAAU,EAAqB,CAAG,CAAC;IACnC;GACF;GACK,OACL,IAAI;IACF,EAAe,EAAsB,CAAG,CAAC;GAC3C,SAAS,GAAK;IACZ,IAAU,EAAqB,CAAG,CAAC;GACrC;EACF;EACA;EACA,UAAU,MAAU,IAAU,EAAqB,CAAK,CAAC;CAC3D,CACF;AACF"}
+{"version":3,"file":"watch-notifications.js","names":[],"sources":["../../../src/websocket/notifications/watch-notifications.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport { watchEnigmaNotifications } from \"./adapters/enigma-notifications\";\nimport { watchRasaNotifications } from \"./adapters/rasa-notifications\";\nimport type { Unwatch, WatchNotificationsParameters } from \"./types\";\n\n// `Unwatch` (the return type of `watchNotifications`) is declared in `./types`;\n// re-export it here so importers keep resolving it from this module.\nexport type { Unwatch } from \"./types\";\n\n/**\n * Subscribe to live position/quote state notifications for an account.\n *\n * Opens (or reuses) one reconnecting socket to the chain's notifications\n * endpoint, sends the subscribe frame on every (re)connect, normalizes inbound\n * frames into `Notification`s, and invokes the handlers. Thin protocol\n * dispatch — each protocol's subscribe, parse, and socket-sharing story lives\n * in its adapter:\n *\n * - `enigma`: watchers sharing the same endpoint+account share one socket.\n * - `rasa`: watchers multiplex every account onto one socket per endpoint (the\n *   subscribe frame carries the full address list).\n *\n * Either way, the socket closes when the last watcher unwatches.\n *\n * @param config - The SDK config.\n * @param parameters - The account to watch and the handlers to invoke.\n * @returns An unwatch function that releases this subscription.\n * @throws {SymmError} synchronously when the chain is unsupported or no\n *   `WebSocket` implementation is available.\n *\n * @example\n * ```ts\n * const unwatch = watchNotifications(config, {\n *   account: \"0xabc…\",\n *   onNotification: (n) => console.log(n.type, n.quoteId),\n *   onStatusChange: (status) => console.log(status),\n * });\n * // later\n * unwatch();\n * ```\n */\nexport function watchNotifications(config: Config, parameters: WatchNotificationsParameters): Unwatch {\n  const { notifications } = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  switch (notifications.protocol) {\n    case \"enigma\":\n      return watchEnigmaNotifications(config, notifications, parameters);\n    case \"rasa\":\n      return watchRasaNotifications(config, notifications, parameters);\n  }\n}\n"],"mappings":";;;AAyCA,SAAgB,EAAmB,GAAgB,GAAmD;CACpG,IAAM,EAAE,qBAAkB,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CACzG,QAAQ,EAAc,UAAtB;EACE,KAAK,UACH,OAAO,EAAyB,GAAQ,GAAe,CAAU;EACnE,KAAK,QACH,OAAO,EAAuB,GAAQ,GAAe,CAAU;CACnE;AACF"}

package/dist/websocket/prices/index.d.ts

@@ -1,4 +1,7 @@
+export * from './parse-binance-price-frame.js';
 export * from './parse-price-frame.js';
 export * from './types.js';
+export * from './watch-binance-prices.js';
 export * from './watch-enigma-prices.js';
+export * from './watch-prices.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/websocket/prices/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/prices/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/prices/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC"}