@symmio/trading-core 1.1.0 → 3.0.0

package/dist/candles/sources/binance/parse-kline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-kline.js","names":[],"sources":["../../../../src/candles/sources/binance/parse-kline.ts"],"sourcesContent":["import { SymmError } from \"../../../shared/errors/symm-error\";\nimport type { Candle } from \"../../types\";\n\n/**\n * A kline as Binance returns it: a positional tuple, not an object.\n *\n * Slots 6-11 (close time, quote volume, trade count, taker volumes, and an\n * unused field) are present on the wire but carry nothing a chart needs, so\n * they are typed loosely and ignored.\n */\nexport type RawBinanceKline = [\n  openTime: number,\n  open: string,\n  high: string,\n  low: string,\n  close: string,\n  volume: string,\n  ...rest: unknown[],\n];\n\n/**\n * The `k` payload of a Binance kline WebSocket event.\n */\nexport interface RawBinanceKlineEvent {\n  /** Bar open time, unix ms. */\n  t: number;\n  /** Interval string this bar belongs to (e.g. `\"1m\"`). */\n  i: string;\n  /** Open price. */\n  o: string;\n  /** High price. */\n  h: string;\n  /** Low price. */\n  l: string;\n  /** Close price — the latest price while the bar is still forming. */\n  c: string;\n  /** Base-asset volume. */\n  v: string;\n  /** `true` once the bar has closed and the next event starts a new one. */\n  x: boolean;\n}\n\nfunction toFiniteNumber(value: unknown, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed)) {\n    throw new SymmError(\"api\", \"INVALID_BINANCE_KLINE\", `Binance kline has a non-numeric \\`${field}\\`: ${value}.`);\n  }\n  return parsed;\n}\n\n/**\n * Convert a Binance REST kline tuple into a {@link Candle}.\n *\n * @param kline - One entry from a `/klines` response.\n * @returns The normalized bar.\n * @throws {SymmError} when the tuple is malformed or carries non-numeric prices.\n *\n * @example\n * ```ts\n * parseBinanceKline([1700000000000, \"42000.1\", \"42100\", \"41950\", \"42050\", \"12.5\"]);\n * // → { time: 1700000000000, open: 42000.1, high: 42100, low: 41950, close: 42050, volume: 12.5 }\n * ```\n */\nexport function parseBinanceKline(kline: RawBinanceKline): Candle {\n  if (!Array.isArray(kline) || kline.length < 6) {\n    throw new SymmError(\n      \"api\",\n      \"INVALID_BINANCE_KLINE\",\n      `Binance kline is not a tuple of at least 6 fields: ${JSON.stringify(kline)}.`,\n    );\n  }\n\n  return {\n    time: toFiniteNumber(kline[0], \"openTime\"),\n    open: toFiniteNumber(kline[1], \"open\"),\n    high: toFiniteNumber(kline[2], \"high\"),\n    low: toFiniteNumber(kline[3], \"low\"),\n    close: toFiniteNumber(kline[4], \"close\"),\n    volume: toFiniteNumber(kline[5], \"volume\"),\n  };\n}\n\n/**\n * Convert the `k` payload of a Binance kline WebSocket event into a {@link Candle}.\n *\n * @param event - The `k` object from a `kline` stream frame.\n * @returns The normalized bar.\n * @throws {SymmError} when the payload carries non-numeric prices.\n */\nexport function parseBinanceKlineEvent(event: RawBinanceKlineEvent): Candle {\n  return {\n    time: toFiniteNumber(event.t, \"t\"),\n    open: toFiniteNumber(event.o, \"o\"),\n    high: toFiniteNumber(event.h, \"h\"),\n    low: toFiniteNumber(event.l, \"l\"),\n    close: toFiniteNumber(event.c, \"c\"),\n    volume: toFiniteNumber(event.v, \"v\"),\n  };\n}\n"],"mappings":";;AA0CA,SAAS,EAAe,GAAgB,GAAuB;CAC7D,IAAM,IAAS,OAAO,CAAK;CAC3B,IAAI,CAAC,OAAO,SAAS,CAAM,GACzB,MAAM,IAAI,EAAU,OAAO,yBAAyB,qCAAqC,EAAM,MAAM,EAAM,EAAE;CAE/G,OAAO;AACT;AAeA,SAAgB,EAAkB,GAAgC;CAChE,IAAI,CAAC,MAAM,QAAQ,CAAK,KAAK,EAAM,SAAS,GAC1C,MAAM,IAAI,EACR,OACA,yBACA,sDAAsD,KAAK,UAAU,CAAK,EAAE,EAC9E;CAGF,OAAO;EACL,MAAM,EAAe,EAAM,IAAI,UAAU;EACzC,MAAM,EAAe,EAAM,IAAI,MAAM;EACrC,MAAM,EAAe,EAAM,IAAI,MAAM;EACrC,KAAK,EAAe,EAAM,IAAI,KAAK;EACnC,OAAO,EAAe,EAAM,IAAI,OAAO;EACvC,QAAQ,EAAe,EAAM,IAAI,QAAQ;CAC3C;AACF;AASA,SAAgB,EAAuB,GAAqC;CAC1E,OAAO;EACL,MAAM,EAAe,EAAM,GAAG,GAAG;EACjC,MAAM,EAAe,EAAM,GAAG,GAAG;EACjC,MAAM,EAAe,EAAM,GAAG,GAAG;EACjC,KAAK,EAAe,EAAM,GAAG,GAAG;EAChC,OAAO,EAAe,EAAM,GAAG,GAAG;EAClC,QAAQ,EAAe,EAAM,GAAG,GAAG;CACrC;AACF"}

package/dist/candles/sources/binance/watch-binance-klines.d.ts

@@ -0,0 +1,54 @@
+import { SymmError } from '../../../shared/errors/symm-error.js';
+import { WebSocketConstructor } from '../../../shared/types/websocket.js';
+import { Unwatch } from '../../../websocket/notifications/watch-notifications.js';
+import { SocketStatus } from '../../../websocket/socket/index.js';
+import { Candle, CandleUpdateMeta } from '../../types.js';
+/**
+ * Parameters for {@link watchBinanceKlines}.
+ */
+export interface WatchBinanceKlinesParameters {
+    /** Combined-stream WebSocket endpoint (`.../stream`). */
+    wsUrl: string;
+    /** Binance symbol, upper-case (e.g. `"BTCUSDT"`). */
+    symbol: string;
+    /** Binance interval string (e.g. `"1m"`). */
+    interval: string;
+    /** WebSocket implementation to dial with. */
+    webSocketConstructor: WebSocketConstructor;
+    /** Called for each update to the bar, and once more when it closes. */
+    onCandle: (candle: Candle, meta: CandleUpdateMeta) => void;
+    /** Called after a reconnect, when bars may have been missed. */
+    onReset?: () => void;
+    /** Called whenever the connection status changes. */
+    onStatusChange?: (status: SocketStatus) => void;
+    /** Called on a transport or parse error; does not stop the subscription. */
+    onError?: (error: SymmError) => void;
+}
+/**
+ * Stream live bar updates for one Binance symbol and interval.
+ *
+ * Each call opens its own connection. That is deliberate at this scale — a
+ * chart holds exactly one subscription — and keeps the reconnect and
+ * unsubscribe paths trivially correct. Binance drops idle connections after 24
+ * hours; the reconnecting socket re-dials and re-sends the SUBSCRIBE frame, and
+ * `onReset` fires so the consumer refetches the bars missed in the gap.
+ *
+ * Inbound frames are matched on **both** symbol and interval. Matching on
+ * symbol alone lets two charts on different intervals feed each other's series.
+ *
+ * @param parameters - Endpoint, symbol, interval, and handlers.
+ * @returns An unwatch function that closes the connection.
+ *
+ * @example
+ * ```ts
+ * const unwatch = watchBinanceKlines({
+ *   wsUrl: "wss://fstream.binance.com/stream",
+ *   symbol: "BTCUSDT",
+ *   interval: "1m",
+ *   webSocketConstructor: WebSocket,
+ *   onCandle: (candle, { closed }) => console.log(candle.close, closed),
+ * });
+ * ```
+ */
+export declare function watchBinanceKlines(parameters: WatchBinanceKlinesParameters): Unwatch;
+//# sourceMappingURL=watch-binance-klines.d.ts.map

package/dist/candles/sources/binance/watch-binance-klines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-binance-klines.d.ts","sourceRoot":"","sources":["../../../../src/candles/sources/binance/watch-binance-klines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,uEAAuE;IACvE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3D,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qDAAqD;IACrD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,4BAA4B,GAAG,OAAO,CAoDpF"}

package/dist/candles/sources/binance/watch-binance-klines.js

@@ -0,0 +1,45 @@
+import { SymmError as e } from "../../../shared/errors/symm-error.js";
+import { createReconnectingSocket as t } from "../../../websocket/socket/create-reconnecting-socket.js";
+import { parseBinanceKlineEvent as n } from "./parse-kline.js";
+//#region src/candles/sources/binance/watch-binance-klines.ts
+function r(t) {
+	if (t instanceof e) return t;
+	let n = t instanceof Error ? t : void 0;
+	return new e("api", "BINANCE_KLINES_SOCKET_ERROR", `Binance klines socket error${n ? `: ${n.message}` : "."}`, { cause: n });
+}
+function i(e) {
+	let { wsUrl: i, symbol: a, interval: o, webSocketConstructor: s, onCandle: c, onReset: l, onStatusChange: u, onError: d } = e, f = `${a.toLowerCase()}@kline_${o}`, p = JSON.stringify({
+		method: "SUBSCRIBE",
+		params: [f],
+		id: 1
+	}), m = !1, h = t({
+		url: i,
+		webSocketConstructor: s,
+		getOpenMessages: () => [p],
+		onOpen: () => {
+			m && l?.(), m = !0;
+		},
+		onStatusChange: u,
+		onError: (e) => d?.(r(e)),
+		onMessage: (e) => {
+			let t;
+			try {
+				t = JSON.parse(String(e));
+			} catch (e) {
+				d?.(r(e));
+				return;
+			}
+			let i = t.data ?? t;
+			if (!(i.e !== "kline" || !i.k) && i.s?.toUpperCase() === a.toUpperCase() && i.k.i === o) try {
+				c(n(i.k), { closed: i.k.x === !0 });
+			} catch (e) {
+				d?.(r(e));
+			}
+		}
+	});
+	return () => h.close();
+}
+//#endregion
+export { i as watchBinanceKlines };
+
+//# sourceMappingURL=watch-binance-klines.js.map

package/dist/candles/sources/binance/watch-binance-klines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-binance-klines.js","names":[],"sources":["../../../../src/candles/sources/binance/watch-binance-klines.ts"],"sourcesContent":["import { SymmError } from \"../../../shared/errors/symm-error\";\nimport type { WebSocketConstructor } from \"../../../shared/types/websocket\";\nimport type { Unwatch } from \"../../../websocket/notifications/watch-notifications\";\nimport type { SocketStatus } from \"../../../websocket/socket\";\nimport { createReconnectingSocket } from \"../../../websocket/socket/create-reconnecting-socket\";\nimport type { Candle, CandleUpdateMeta } from \"../../types\";\nimport { parseBinanceKlineEvent, type RawBinanceKlineEvent } from \"./parse-kline\";\n\n/**\n * Parameters for {@link watchBinanceKlines}.\n */\nexport interface WatchBinanceKlinesParameters {\n  /** Combined-stream WebSocket endpoint (`.../stream`). */\n  wsUrl: string;\n  /** Binance symbol, upper-case (e.g. `\"BTCUSDT\"`). */\n  symbol: string;\n  /** Binance interval string (e.g. `\"1m\"`). */\n  interval: string;\n  /** WebSocket implementation to dial with. */\n  webSocketConstructor: WebSocketConstructor;\n  /** Called for each update to the bar, and once more when it closes. */\n  onCandle: (candle: Candle, meta: CandleUpdateMeta) => void;\n  /** Called after a reconnect, when bars may have been missed. */\n  onReset?: () => void;\n  /** Called whenever the 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/** Shape of a Binance combined-stream frame carrying a kline event. */\ninterface BinanceKlineFrame {\n  stream?: string;\n  data?: { e?: string; s?: string; k?: RawBinanceKlineEvent };\n  e?: string;\n  s?: string;\n  k?: RawBinanceKlineEvent;\n}\n\nfunction toKlinesError(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    \"BINANCE_KLINES_SOCKET_ERROR\",\n    `Binance klines socket error${cause ? `: ${cause.message}` : \".\"}`,\n    {\n      cause,\n    },\n  );\n}\n\n/**\n * Stream live bar updates for one Binance symbol and interval.\n *\n * Each call opens its own connection. That is deliberate at this scale — a\n * chart holds exactly one subscription — and keeps the reconnect and\n * unsubscribe paths trivially correct. Binance drops idle connections after 24\n * hours; the reconnecting socket re-dials and re-sends the SUBSCRIBE frame, and\n * `onReset` fires so the consumer refetches the bars missed in the gap.\n *\n * Inbound frames are matched on **both** symbol and interval. Matching on\n * symbol alone lets two charts on different intervals feed each other's series.\n *\n * @param parameters - Endpoint, symbol, interval, and handlers.\n * @returns An unwatch function that closes the connection.\n *\n * @example\n * ```ts\n * const unwatch = watchBinanceKlines({\n *   wsUrl: \"wss://fstream.binance.com/stream\",\n *   symbol: \"BTCUSDT\",\n *   interval: \"1m\",\n *   webSocketConstructor: WebSocket,\n *   onCandle: (candle, { closed }) => console.log(candle.close, closed),\n * });\n * ```\n */\nexport function watchBinanceKlines(parameters: WatchBinanceKlinesParameters): Unwatch {\n  const { wsUrl, symbol, interval, webSocketConstructor, onCandle, onReset, onStatusChange, onError } = parameters;\n\n  const streamName = `${symbol.toLowerCase()}@kline_${interval}`;\n  const subscribeMessage = JSON.stringify({ method: \"SUBSCRIBE\", params: [streamName], id: 1 });\n\n  /**\n   * The first open establishes the stream; every later one follows a drop, so\n   * the consumer's cached bars have a hole in them and must be refetched.\n   */\n  let hasOpened = false;\n\n  const socket = createReconnectingSocket({\n    url: wsUrl,\n    webSocketConstructor,\n    /**\n     * Sent on every (re)open, so the subscription survives reconnects without\n     * the consumer re-subscribing.\n     */\n    getOpenMessages: () => [subscribeMessage],\n    onOpen: () => {\n      if (hasOpened) onReset?.();\n      hasOpened = true;\n    },\n    onStatusChange,\n    onError: (event) => onError?.(toKlinesError(event)),\n    onMessage: (data) => {\n      let frame: BinanceKlineFrame;\n      try {\n        frame = JSON.parse(String(data)) as BinanceKlineFrame;\n      } catch (err) {\n        onError?.(toKlinesError(err));\n        return;\n      }\n\n      /** Combined streams wrap the event in `data`; raw streams do not. */\n      const event = frame.data ?? frame;\n      if (event.e !== \"kline\" || !event.k) return;\n\n      /** Guard against cross-feeding a chart from another symbol or interval. */\n      if (event.s?.toUpperCase() !== symbol.toUpperCase()) return;\n      if (event.k.i !== interval) return;\n\n      try {\n        onCandle(parseBinanceKlineEvent(event.k), { closed: event.k.x === true });\n      } catch (err) {\n        onError?.(toKlinesError(err));\n      }\n    },\n  });\n\n  return () => socket.close();\n}\n"],"mappings":";;;;AAuCA,SAAS,EAAc,GAA2B;CAChD,IAAI,aAAiB,GAAW,OAAO;CACvC,IAAM,IAAQ,aAAiB,QAAQ,IAAQ,KAAA;CAC/C,OAAO,IAAI,EACT,OACA,+BACA,8BAA8B,IAAQ,KAAK,EAAM,YAAY,OAC7D,EACE,SACF,CACF;AACF;AA4BA,SAAgB,EAAmB,GAAmD;CACpF,IAAM,EAAE,UAAO,WAAQ,aAAU,yBAAsB,aAAU,YAAS,mBAAgB,eAAY,GAEhG,IAAa,GAAG,EAAO,YAAY,EAAE,SAAS,KAC9C,IAAmB,KAAK,UAAU;EAAE,QAAQ;EAAa,QAAQ,CAAC,CAAU;EAAG,IAAI;CAAE,CAAC,GAMxF,IAAY,IAEV,IAAS,EAAyB;EACtC,KAAK;EACL;EAKA,uBAAuB,CAAC,CAAgB;EACxC,cAAc;GAEZ,AADI,KAAW,IAAU,GACzB,IAAY;EACd;EACA;EACA,UAAU,MAAU,IAAU,EAAc,CAAK,CAAC;EAClD,YAAY,MAAS;GACnB,IAAI;GACJ,IAAI;IACF,IAAQ,KAAK,MAAM,OAAO,CAAI,CAAC;GACjC,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;IAC5B;GACF;GAGA,IAAM,IAAQ,EAAM,QAAQ;GACxB,QAAM,MAAM,WAAW,CAAC,EAAM,MAG9B,EAAM,GAAG,YAAY,MAAM,EAAO,YAAY,KAC9C,EAAM,EAAE,MAAM,GAElB,IAAI;IACF,EAAS,EAAuB,EAAM,CAAC,GAAG,EAAE,QAAQ,EAAM,EAAE,MAAM,GAAK,CAAC;GAC1E,SAAS,GAAK;IACZ,IAAU,EAAc,CAAG,CAAC;GAC9B;EACF;CACF,CAAC;CAED,aAAa,EAAO,MAAM;AAC5B"}

package/dist/candles/types.d.ts

@@ -0,0 +1,192 @@
+import { SymmError } from '../shared/errors/symm-error.js';
+import { Unwatch } from '../websocket/notifications/watch-notifications.js';
+import { SocketStatus } from '../websocket/socket/index.js';
+/**
+ * Canonical resolution codes the SDK speaks.
+ *
+ * This is the SDK's own vocabulary, not any single provider's. A
+ * {@link CandleSource} maps these onto its native interval strings and declares
+ * the subset it can actually serve via {@link CandleSource.supportedResolutions}
+ * — no venue supports all of them.
+ */
+export type CandleResolution = "1s" | "10s" | "1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "6h" | "8h" | "12h" | "1d" | "3d" | "1w" | "1M";
+/**
+ * What the prices in a candle series actually represent.
+ *
+ * Surfaced deliberately rather than hidden: a chart drawn from a reference
+ * exchange is not the price a SYMMIO trade settles at. A UI that lets a user
+ * place orders off that chart should be able to tell them so.
+ *
+ * - `reference-exchange` — mark price of a third-party perp venue (e.g. Binance USD-M).
+ * - `dex-pool` — spot price of an on-chain liquidity pool, USD-denominated.
+ * - `solver-mark` — the SYMMIO solver's own mark price, the basis execution settles against.
+ */
+export type CandlePriceBasis = "reference-exchange" | "dex-pool" | "solver-mark";
+/**
+ * A single OHLCV bar.
+ *
+ * `time` is the bar's **open** time in unix **milliseconds**, UTC, aligned to
+ * the resolution boundary by the venue. Chart libraries disagree on whether
+ * they want seconds or milliseconds — the SDK always speaks milliseconds and
+ * each adapter converts at its own edge.
+ */
+export interface Candle {
+    /** Bar open time, unix ms, aligned to the resolution boundary. */
+    time: number;
+    /** Opening price. */
+    open: number;
+    /** Highest price traded during the bar. */
+    high: number;
+    /** Lowest price traded during the bar. */
+    low: number;
+    /** Closing price — the latest price while the bar is still in progress. */
+    close: number;
+    /**
+     * Base-asset volume over the bar. `0` when the source cannot report volume,
+     * which is the case for any source that folds a price-tick stream into bars.
+     */
+    volume: number;
+}
+/**
+ * Symbol metadata a chart needs before it can render a series: how to label the
+ * instrument and how many decimals to draw its prices at.
+ */
+export interface CandleSymbol {
+    /** Market name as SYMMIO names it (e.g. `"BTCUSDT"`). */
+    marketName: string;
+    /** The same instrument in the source's own namespace (e.g. the Binance symbol). */
+    sourceSymbol: string;
+    /** Human-readable description for a chart's symbol header. */
+    description: string;
+    /** Decimal places prices should be rendered at. */
+    pricePrecision: number;
+    /** Decimal places volume should be rendered at. */
+    volumePrecision: number;
+}
+/**
+ * Parameters for {@link CandleSource.getCandles}.
+ */
+export interface GetCandlesParameters {
+    /** Market name as SYMMIO names it. */
+    marketName: string;
+    /** Bar size to fetch. Must be listed in {@link CandleSource.supportedResolutions}. */
+    resolution: CandleResolution;
+    /** Range start, unix ms, inclusive. */
+    from: number;
+    /** Range end, unix ms, exclusive. */
+    to: number;
+    /**
+     * Maximum bars to return. A source pages internally to satisfy this, so it
+     * may exceed the venue's own per-request cap.
+     */
+    limit?: number;
+    /** Aborts in-flight requests. Wired to TanStack Query cancellation by the hooks. */
+    signal?: AbortSignal;
+}
+/**
+ * Result of {@link CandleSource.getCandles}.
+ */
+export interface GetCandlesReturnType {
+    /** Bars in ascending time order, de-duplicated and clipped to the requested range. */
+    candles: Candle[];
+    /**
+     * `true` when the source has nothing at or before `from` — typically because
+     * the request predates the instrument's listing. A chart paging backwards
+     * should stop when it sees this instead of issuing requests that return empty.
+     */
+    noMoreData: boolean;
+}
+/**
+ * Metadata accompanying each {@link WatchCandlesParameters.onCandle} call.
+ */
+export interface CandleUpdateMeta {
+    /**
+     * `true` when this bar has finalized and the next update starts a new bar.
+     * `false` while it is still forming.
+     */
+    closed: boolean;
+}
+/**
+ * Parameters for {@link CandleSource.watchCandles}.
+ */
+export interface WatchCandlesParameters {
+    /** Market name as SYMMIO names it. */
+    marketName: string;
+    /** Bar size to stream. */
+    resolution: CandleResolution;
+    /**
+     * Called on every update to the in-progress bar, and once more with
+     * `closed: true` when that bar finalizes.
+     */
+    onCandle: (candle: Candle, meta: CandleUpdateMeta) => void;
+    /**
+     * Called after a reconnect, when bars may have been missed while the socket
+     * was down. A chart should drop its cached bars and refetch history rather
+     * than splice a live bar onto a stale series.
+     */
+    onReset?: () => 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;
+}
+/**
+ * A pluggable source of OHLCV data.
+ *
+ * This is the SDK's charting boundary. Every chart library needs the same three
+ * things — symbol metadata, bars for a time range, and a live subscription — so
+ * that is exactly what a source provides. Chart-library adapters
+ * (`toTradingViewDatafeed`) and framework hooks (`useCandles`) are written
+ * against this interface, never against a specific venue.
+ *
+ * Unlike most SDK actions, a source is **not** derived from {@link Config}: a
+ * reference exchange is not a SYMMIO chain deployment, and which venue to chart
+ * is the consumer's choice. Construct one and pass it in explicitly.
+ *
+ * @example
+ * ```ts
+ * const source = createBinanceCandleSource();
+ * const { candles } = await source.getCandles({
+ *   marketName: "BTCUSDT",
+ *   resolution: "1m",
+ *   from: Date.now() - 60 * 60 * 1000,
+ *   to: Date.now(),
+ * });
+ * ```
+ */
+export interface CandleSource {
+    /** Stable identifier, used to scope query keys (e.g. `"binance:usd-m-futures"`). */
+    readonly id: string;
+    /** What the prices from this source represent. */
+    readonly priceBasis: CandlePriceBasis;
+    /** Resolutions this source can serve. */
+    readonly supportedResolutions: readonly CandleResolution[];
+    /**
+     * Bars the venue returns per underlying request. {@link CandleSource.getCandles}
+     * pages transparently past this; it is exposed so a caller can size its own
+     * requests sensibly.
+     */
+    readonly maxCandlesPerRequest: number;
+    /**
+     * Resolve symbol metadata, or `undefined` when the source does not carry this
+     * market.
+     *
+     * @param marketName - Market name as SYMMIO names it.
+     */
+    getSymbol(marketName: string): Promise<CandleSymbol | undefined>;
+    /**
+     * Fetch historical bars for a range, paging internally as needed.
+     *
+     * @param parameters - Market, resolution, and range.
+     */
+    getCandles(parameters: GetCandlesParameters): Promise<GetCandlesReturnType>;
+    /**
+     * Subscribe to live bar updates. Absent when the source has no realtime feed,
+     * in which case a consumer must poll {@link CandleSource.getCandles}.
+     *
+     * @param parameters - Market, resolution, and handlers.
+     * @returns An unwatch function that releases the subscription.
+     */
+    watchCandles?(parameters: WatchCandlesParameters): Unwatch;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/chains/actions/get-chain-config.d.ts

@@ -8,7 +8,7 @@ import { SymmioChainConfig } from '../types.js';
  *
  * @example
  * ```ts
- * const config = getChainConfig(SymmioSupportedChainId.HYPER_EVM);
+ * const config = getChainConfig(SymmioSupportedChainId.ARBITRUM);
  * console.log(config.addresses.accountLayerAddress);
  * ```
  */

package/dist/core/chains/actions/get-chain-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-chain-config.js","names":[],"sources":["../../../../src/core/chains/actions/get-chain-config.ts"],"sourcesContent":["import { SymmError } from \"../../../shared/errors/symm-error\";\nimport { CHAIN_CONFIGS } from \"../registry\";\nimport type { SymmioChainConfig } from \"../types\";\n\n/**\n * Get the complete config for a chain.\n *\n * @param chainId - The chain ID to look up\n * @returns The resolved chain config\n * @throws {SymmError} when the chain is not supported\n *\n * @example\n * ```ts\n * const config = getChainConfig(SymmioSupportedChainId.HYPER_EVM);\n * console.log(config.addresses.accountLayerAddress);\n * ```\n */\nexport function getChainConfig(chainId: number): SymmioChainConfig {\n  const config = CHAIN_CONFIGS[chainId];\n\n  if (!config) {\n    throw new SymmError(\"config\", \"UNSUPPORTED_CHAIN\", `No config registered for chain ${chainId}.`);\n  }\n\n  return config;\n}\n"],"mappings":";;;AAiBA,SAAgB,EAAe,GAAoC;CACjE,IAAM,IAAS,EAAc;CAE7B,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,UAAU,qBAAqB,kCAAkC,EAAQ,EAAE;CAGjG,OAAO;AACT"}
+{"version":3,"file":"get-chain-config.js","names":[],"sources":["../../../../src/core/chains/actions/get-chain-config.ts"],"sourcesContent":["import { SymmError } from \"../../../shared/errors/symm-error\";\nimport { CHAIN_CONFIGS } from \"../registry\";\nimport type { SymmioChainConfig } from \"../types\";\n\n/**\n * Get the complete config for a chain.\n *\n * @param chainId - The chain ID to look up\n * @returns The resolved chain config\n * @throws {SymmError} when the chain is not supported\n *\n * @example\n * ```ts\n * const config = getChainConfig(SymmioSupportedChainId.ARBITRUM);\n * console.log(config.addresses.accountLayerAddress);\n * ```\n */\nexport function getChainConfig(chainId: number): SymmioChainConfig {\n  const config = CHAIN_CONFIGS[chainId];\n\n  if (!config) {\n    throw new SymmError(\"config\", \"UNSUPPORTED_CHAIN\", `No config registered for chain ${chainId}.`);\n  }\n\n  return config;\n}\n"],"mappings":";;;AAiBA,SAAgB,EAAe,GAAoC;CACjE,IAAM,IAAS,EAAc;CAE7B,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,UAAU,qBAAqB,kCAAkC,EAAQ,EAAE;CAGjG,OAAO;AACT"}

package/dist/core/chains/actions/get-default-solver.d.ts

@@ -0,0 +1,22 @@
+import { SymmioResolvedSolver } from '../types.js';
+/**
+ * Get the built-in default solver config for a chain.
+ *
+ * Mirrors {@link getChainConfig} for the solver dimension: it returns the chain's
+ * `defaultSolverId` solver. Consumers override or extend a chain's solvers via
+ * `createConfig({ symmioConfig })` and resolve the active one with
+ * `config.getSolver({ chainId, solverId })`.
+ *
+ * @param chainId - The chain to look up the default solver for.
+ * @returns The chain's default solver config.
+ * @throws {SymmError} when the chain is unsupported or its default solver is
+ *   not configured.
+ *
+ * @example
+ * ```ts
+ * const solver = getDefaultSolver(SymmioSupportedChainId.ARBITRUM);
+ * console.log(solver.url); // "https://solver.enigma.bz/api"
+ * ```
+ */
+export declare function getDefaultSolver(chainId: number): SymmioResolvedSolver;
+//# sourceMappingURL=get-default-solver.d.ts.map

package/dist/core/chains/actions/get-default-solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-solver.d.ts","sourceRoot":"","sources":["../../../../src/core/chains/actions/get-default-solver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGrD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAEtE"}

package/dist/core/chains/actions/get-default-solver.js

@@ -0,0 +1,10 @@
+import { getChainConfig as e } from "./get-chain-config.js";
+import { resolveSolver as t } from "../resolve-solver.js";
+//#region src/core/chains/actions/get-default-solver.ts
+function n(n) {
+	return t(e(n));
+}
+//#endregion
+export { n as getDefaultSolver };
+
+//# sourceMappingURL=get-default-solver.js.map

package/dist/core/chains/actions/get-default-solver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-solver.js","names":[],"sources":["../../../../src/core/chains/actions/get-default-solver.ts"],"sourcesContent":["import { resolveSolver } from \"../resolve-solver\";\nimport type { SymmioResolvedSolver } from \"../types\";\nimport { getChainConfig } from \"./get-chain-config\";\n\n/**\n * Get the built-in default solver config for a chain.\n *\n * Mirrors {@link getChainConfig} for the solver dimension: it returns the chain's\n * `defaultSolverId` solver. Consumers override or extend a chain's solvers via\n * `createConfig({ symmioConfig })` and resolve the active one with\n * `config.getSolver({ chainId, solverId })`.\n *\n * @param chainId - The chain to look up the default solver for.\n * @returns The chain's default solver config.\n * @throws {SymmError} when the chain is unsupported or its default solver is\n *   not configured.\n *\n * @example\n * ```ts\n * const solver = getDefaultSolver(SymmioSupportedChainId.ARBITRUM);\n * console.log(solver.url); // \"https://solver.enigma.bz/api\"\n * ```\n */\nexport function getDefaultSolver(chainId: number): SymmioResolvedSolver {\n  return resolveSolver(getChainConfig(chainId));\n}\n"],"mappings":";;;AAuBA,SAAgB,EAAiB,GAAuC;CACtE,OAAO,EAAc,EAAe,CAAO,CAAC;AAC9C"}

package/dist/core/chains/actions/list-supported-chains.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-supported-chains.js","names":[],"sources":["../../../../src/core/chains/actions/list-supported-chains.ts"],"sourcesContent":["import { SymmioSupportedChainId } from \"../supported-chains\";\n\n/**\n * List all chain IDs with built-in configs.\n *\n * @returns Array of supported chain IDs\n */\nexport function listSupportedChains(): SymmioSupportedChainId[] {\n  /**\n   * Numeric enums carry a reverse mapping (`{ 999: \"HYPER_EVM\", HYPER_EVM: 999 }`),\n   * so `Object.values` yields the string keys too — keep only the chain ids.\n   */\n  return Object.values(SymmioSupportedChainId).filter(\n    (value): value is SymmioSupportedChainId => typeof value === \"number\",\n  );\n}\n"],"mappings":";;AAOA,SAAgB,IAAgD;CAK9D,OAAO,OAAO,OAAO,CAAsB,EAAE,QAC1C,MAA2C,OAAO,KAAU,QAC/D;AACF"}
+{"version":3,"file":"list-supported-chains.js","names":[],"sources":["../../../../src/core/chains/actions/list-supported-chains.ts"],"sourcesContent":["import { SymmioSupportedChainId } from \"../supported-chains\";\n\n/**\n * List all chain IDs with built-in configs.\n *\n * @returns Array of supported chain IDs\n */\nexport function listSupportedChains(): SymmioSupportedChainId[] {\n  /**\n   * Numeric enums carry a reverse mapping (`{ 42161: \"ARBITRUM\", ARBITRUM: 42161 }`),\n   * so `Object.values` yields the string keys too — keep only the chain ids.\n   */\n  return Object.values(SymmioSupportedChainId).filter(\n    (value): value is SymmioSupportedChainId => typeof value === \"number\",\n  );\n}\n"],"mappings":";;AAOA,SAAgB,IAAgD;CAK9D,OAAO,OAAO,OAAO,CAAsB,EAAE,QAC1C,MAA2C,OAAO,KAAU,QAC/D;AACF"}

package/dist/core/chains/index.d.ts

@@ -1,6 +1,10 @@
 export * from './actions/get-chain-config.js';
+export * from './actions/get-default-solver.js';
 export * from './actions/is-chain-supported.js';
 export * from './actions/list-supported-chains.js';
+export * from './price-service-support.js';
+export * from './resolve-solver.js';
+export * from './solver-support.js';
 export * from './supported-chains.js';
 export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/chains/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/chains/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/chains/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/core/chains/price-service-support.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Throw when a configured price service's `type` is not one the SDK ships a
+ * client for — not in {@link SUPPORTED_PRICE_SERVICE_TYPES}, the single source
+ * the `SymmioPriceServiceType` union is derived from. Called by `createConfig`
+ * for the chain-level block **and** every solver-nested override, so an
+ * unsupported provider fails fast at config-build time rather than at the first
+ * read that would point one provider's client at another's host.
+ *
+ * @param chainId - Chain the price service is configured on, for the message.
+ * @param type - The configured `priceService.type`, possibly from untyped JSON.
+ * @param solverId - Present when validating a solver-nested override, so the
+ *   message can point at the exact block.
+ * @throws {SymmError} `UNSUPPORTED_PRICE_SERVICE_TYPE` when the type is unknown.
+ *
+ * @internal
+ */
+export declare function assertSupportedPriceServiceType(chainId: number, type: string, solverId?: string): void;
+//# sourceMappingURL=price-service-support.d.ts.map

package/dist/core/chains/price-service-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-service-support.d.ts","sourceRoot":"","sources":["../../../src/core/chains/price-service-support.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAWtG"}

package/dist/core/chains/price-service-support.js

@@ -0,0 +1,10 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { SUPPORTED_PRICE_SERVICE_TYPES as t } from "./types.js";
+//#region src/core/chains/price-service-support.ts
+function n(n, r, i) {
+	if (!t.includes(r)) throw new e("config", "UNSUPPORTED_PRICE_SERVICE_TYPE", `createConfig: price-service type "${r}" for ${i ? `solver "${i}" on chain ${n}` : `chain ${n}`} is not supported. Supported types: ${t.join(", ")}. Ship its adapter before registering it.`);
+}
+//#endregion
+export { n as assertSupportedPriceServiceType };
+
+//# sourceMappingURL=price-service-support.js.map

package/dist/core/chains/price-service-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-service-support.js","names":[],"sources":["../../../src/core/chains/price-service-support.ts"],"sourcesContent":["import { SymmError } from \"../../shared/errors/symm-error\";\nimport { SUPPORTED_PRICE_SERVICE_TYPES } from \"./types\";\n\n/**\n * Throw when a configured price service's `type` is not one the SDK ships a\n * client for — not in {@link SUPPORTED_PRICE_SERVICE_TYPES}, the single source\n * the `SymmioPriceServiceType` union is derived from. Called by `createConfig`\n * for the chain-level block **and** every solver-nested override, so an\n * unsupported provider fails fast at config-build time rather than at the first\n * read that would point one provider's client at another's host.\n *\n * @param chainId - Chain the price service is configured on, for the message.\n * @param type - The configured `priceService.type`, possibly from untyped JSON.\n * @param solverId - Present when validating a solver-nested override, so the\n *   message can point at the exact block.\n * @throws {SymmError} `UNSUPPORTED_PRICE_SERVICE_TYPE` when the type is unknown.\n *\n * @internal\n */\nexport function assertSupportedPriceServiceType(chainId: number, type: string, solverId?: string): void {\n  // The union types the field, but the runtime config may come from untyped\n  // JSON, so treat a miss as possible.\n  if ((SUPPORTED_PRICE_SERVICE_TYPES as readonly string[]).includes(type)) return;\n\n  const where = solverId ? `solver \"${solverId}\" on chain ${chainId}` : `chain ${chainId}`;\n  throw new SymmError(\n    \"config\",\n    \"UNSUPPORTED_PRICE_SERVICE_TYPE\",\n    `createConfig: price-service type \"${type}\" for ${where} is not supported. Supported types: ${SUPPORTED_PRICE_SERVICE_TYPES.join(\", \")}. Ship its adapter before registering it.`,\n  );\n}\n"],"mappings":";;;AAmBA,SAAgB,EAAgC,GAAiB,GAAc,GAAyB;CAGjG,OAAoD,SAAS,CAAI,GAGtE,MAAM,IAAI,EACR,UACA,kCACA,qCAAqC,EAAK,QAJ9B,IAAW,WAAW,EAAS,aAAa,MAAY,SAAS,IAIrB,sCAAsC,EAA8B,KAAK,IAAI,EAAE,0CACzI;AACF"}

package/dist/core/chains/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/chains/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAoD3D,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/chains/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAyI3D,CAAC"}

package/dist/core/chains/registry.js

@@ -1,48 +1,96 @@
 import { SymmioSupportedChainId as e } from "./supported-chains.js";
 //#region src/core/chains/registry.ts
-var t = { [e.HYPER_EVM]: {
-	chainId: e.HYPER_EVM,
-	addresses: {
-		symmioAddress: "0x57331038c21982116EE9b0906E4a5c5cB52dcE2e",
-		instantLayerAddress: "0x72DBF07457b2712b160F67A85D338F860c1CA620",
-		accountLayerAddress: "0x46493c376758Da47823D7E3Ae5d417eA6546eEB3",
-		affiliatesAddress: "0xBcB033C9154401fA000a1Ae60843f79f45741b7c",
-		collateralAddress: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
-		collateralDecimals: 6
+var t = {
+	[e.BASE]: {
+		chainId: e.BASE,
+		contractsVersion: "0.8.5",
+		addresses: {
+			symmioAddress: "0x91Cf2D8Ed503EC52768999aA6D8DBeA6e52dbe43",
+			instantLayerAddress: "0x0825435285ac0E5c02c7a7c443F631f3e07fE375",
+			accountLayerAddress: "0x56caf00c6C5cB5478570Bb23807B9d1D697863DC",
+			affiliatesAddress: "0x45Eecd7B4f442388ACD90467E423A5CAAC3a9C3f",
+			collateralAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+			collateralDecimals: 6
+		},
+		solvers: { rasa: {
+			name: "Rasa",
+			address: "0x81631953E0C093e72935C1CAA4C7D519B2A0E407",
+			url: "https://stage-archon.rasa.capital",
+			notifications: {
+				url: "wss://stage-archon.rasa.capital/ws/position-state-ws3",
+				protocol: "rasa"
+			},
+			capabilities: { limitOrder: !0 }
+		} },
+		defaultSolverId: "rasa",
+		subgraphs: {
+			analytics: "https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/base_analytics/latest/gn",
+			events: "https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/base_events/latest/gn"
+		},
+		priceService: {
+			type: "binance",
+			url: "https://fapi.binance.com",
+			wsUrl: "wss://fstream.binance.com/market/ws/!markPrice@arr@1s"
+		},
+		muon: { urls: [
+			"https://muon-oracle1.rasa.capital/v1/",
+			"https://muon-oracle2.rasa.capital/v1/",
+			"https://muon-oracle3.rasa.capital/v1/",
+			"https://muon-oracle4.rasa.capital/v1/"
+		] }
 	},
-	subgraphs: {
-		analytics: "https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/hyperevm_mainnet_analytics/latest/gn",
-		events: "https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/hyperevm_mainnet_events/latest/gn"
-	},
-	solver: {
-		name: "Enigma",
-		address: "0x76bc5889c0cfcC20960b0D81F541595d81a95122",
-		url: "https://solver.enigma.bz/api",
-		tpsl: {
-			url: "https://conditional-orders-handler-lowcap85.rasa.capital",
-			wsUrl: "wss://notification.rasa.capital/ws/v1/subscribe",
-			appName: "Hyper-EVM_COH-Low-Cap_Production",
-			cohWalletAddress: "0xf2afbb3f13Ca72bfb69749f3bC5EbD6528b1fc31"
-		}
-	},
-	priceService: {
-		type: "enigma",
-		url: "https://lowcap-price.enigma.bz",
-		wsUrl: "wss://lowcap-price.enigma.bz/ws"
-	},
-	notifications: {
-		url: "wss://notification.rasa.capital/ws/v1/subscribe",
-		channel: "Hyper-EVM_Solver-Low-Cap_Production",
-		protocol: "defilytics",
-		searchUrl: "https://notification.rasa.capital/notification"
-	},
-	muon: { urls: [
-		"https://muon-oracle1.rasa.capital/v1/",
-		"https://muon-oracle2.rasa.capital/v1/",
-		"https://muon-oracle3.rasa.capital/v1/",
-		"https://muon-oracle4.rasa.capital/v1/"
-	] }
-} };
+	[e.ARBITRUM]: {
+		chainId: e.ARBITRUM,
+		contractsVersion: "0.8.6",
+		addresses: {
+			symmioAddress: "0x57331027091994FCb9c5Aec48ea92cEf0a93CF6A",
+			instantLayerAddress: "0xCB8F789d6f7e59B3D266490e1Aa8e35cFb755132",
+			accountLayerAddress: "0x573310d1D6ec18cB21E1aB949414470D9bf5c24E",
+			affiliatesAddress: "0x58bB5Bdc279321507DfB7AB54B9e7EF3DdA6E24D",
+			collateralAddress: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+			collateralDecimals: 6
+		},
+		subgraphs: {
+			analytics: "https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/arbitrum-vibe-mainnet-analytics/latest/gn",
+			events: "https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/arbitrum-vibe-mainnet-events/stage/gn"
+		},
+		solvers: { enigma: {
+			name: "Enigma",
+			address: "0x0420b24359d2DCccA53904042aa36A641162445c",
+			url: "https://solver.enigma.bz/api",
+			tpsl: {
+				url: "https://tpsl.enigma.bz",
+				wsUrl: "wss://notification.rasa.capital/ws/v1/subscribe",
+				appName: "Arbitrum_COH_Production",
+				cohWalletAddress: "0xFC3a98d30AdAA220Ae4150fcaC06Bd200b6E146B"
+			},
+			notifications: {
+				url: "wss://notification.rasa.capital/ws/v1/subscribe",
+				channel: "Arbitrum_Solver-Low-Cap_Production",
+				protocol: "enigma",
+				searchUrl: "https://notification.rasa.capital/notification"
+			},
+			capabilities: {
+				groupClose: !0,
+				listingService: !0
+			}
+		} },
+		defaultSolverId: "enigma",
+		priceService: {
+			type: "enigma",
+			url: "https://lowcap-price.enigma.bz",
+			wsUrl: "wss://lowcap-price.enigma.bz/ws"
+		},
+		muon: { urls: [
+			"https://muon-oracle1.rasa.capital/v1/",
+			"https://muon-oracle2.rasa.capital/v1/",
+			"https://muon-oracle3.rasa.capital/v1/",
+			"https://muon-oracle4.rasa.capital/v1/"
+		] },
+		listing: { url: "https://listing85.enigma.bz" },
+		inventory: { url: "https://inventory85.enigma.bz" }
+	}
+};
 //#endregion
 export { t as CHAIN_CONFIGS };