@symmio/trading-core 1.1.0 → 2.0.0

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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gDAAgD,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,UAAU,GAAG,aAAa,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,UAAU,EAAE,gBAAgB,CAAC;IAC7B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sFAAsF;IACtF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3D;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,yCAAyC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3D;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC;;;;;OAKG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACjE;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC5E;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,UAAU,EAAE,sBAAsB,GAAG,OAAO,CAAC;CAC5D"}

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.HYPER_EVM);
+ * 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.HYPER_EVM);\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/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,CAoJ3D,CAAC"}

package/dist/core/chains/registry.js

@@ -1,48 +1,94 @@
 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.HYPER_EVM]: {
+		chainId: e.HYPER_EVM,
+		addresses: {
+			symmioAddress: "0x57331038c21982116EE9b0906E4a5c5cB52dcE2e",
+			instantLayerAddress: "0x72DBF07457b2712b160F67A85D338F860c1CA620",
+			accountLayerAddress: "0x46493c376758Da47823D7E3Ae5d417eA6546eEB3",
+			affiliatesAddress: "0xBcB033C9154401fA000a1Ae60843f79f45741b7c",
+			collateralAddress: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+			collateralDecimals: 6
+		},
+		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"
+		},
+		solvers: { enigma: {
+			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"
+			},
+			notifications: {
+				url: "wss://notification.rasa.capital/ws/v1/subscribe",
+				channel: "Hyper-EVM_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" }
 	},
-	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.BASE]: {
+		chainId: e.BASE,
+		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/"
+		] }
+	}
+};
 //#endregion
 export { t as CHAIN_CONFIGS };
 

package/dist/core/chains/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../../src/core/chains/registry.ts"],"sourcesContent":["import { SymmioSupportedChainId } from \"./supported-chains\";\nimport type { SymmioChainConfig } from \"./types\";\n\n/**\n * Built-in SYMMIO deployment configs keyed by chain ID.\n *\n * @internal\n */\nexport const CHAIN_CONFIGS: Record<number, SymmioChainConfig> = {\n  [SymmioSupportedChainId.HYPER_EVM]: {\n    chainId: SymmioSupportedChainId.HYPER_EVM,\n    addresses: {\n      symmioAddress: \"0x57331038c21982116EE9b0906E4a5c5cB52dcE2e\",\n      instantLayerAddress: \"0x72DBF07457b2712b160F67A85D338F860c1CA620\",\n      accountLayerAddress: \"0x46493c376758Da47823D7E3Ae5d417eA6546eEB3\",\n      affiliatesAddress: \"0xBcB033C9154401fA000a1Ae60843f79f45741b7c\",\n      collateralAddress: \"0xb88339CB7199b77E23DB6E890353E22632Ba630f\",\n      collateralDecimals: 6,\n    },\n    subgraphs: {\n      analytics:\n        \"https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/hyperevm_mainnet_analytics/latest/gn\",\n      events:\n        \"https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/hyperevm_mainnet_events/latest/gn\",\n    },\n    solver: {\n      name: \"Enigma\",\n      address: \"0x76bc5889c0cfcC20960b0D81F541595d81a95122\",\n      url: \"https://solver.enigma.bz/api\",\n      tpsl: {\n        url: \"https://conditional-orders-handler-lowcap85.rasa.capital\",\n        wsUrl: \"wss://notification.rasa.capital/ws/v1/subscribe\",\n        appName: \"Hyper-EVM_COH-Low-Cap_Production\",\n        cohWalletAddress: \"0xf2afbb3f13Ca72bfb69749f3bC5EbD6528b1fc31\",\n      },\n    },\n    priceService: {\n      type: \"enigma\",\n      url: \"https://lowcap-price.enigma.bz\",\n      wsUrl: \"wss://lowcap-price.enigma.bz/ws\",\n    },\n    notifications: {\n      url: \"wss://notification.rasa.capital/ws/v1/subscribe\",\n      channel: \"Hyper-EVM_Solver-Low-Cap_Production\",\n      protocol: \"defilytics\",\n      // Same host as the WebSocket stream; the REST search API is served under\n      // the `/notification` prefix (OpenAPI `servers[0].url`).\n      searchUrl: \"https://notification.rasa.capital/notification\",\n    },\n    muon: {\n      // Muon oracle gateways (https://docs.symm.io/api-endpoints-and-deployments/muon-api),\n      // tried in order until one returns a successful attestation.\n      urls: [\n        \"https://muon-oracle1.rasa.capital/v1/\",\n        \"https://muon-oracle2.rasa.capital/v1/\",\n        \"https://muon-oracle3.rasa.capital/v1/\",\n        \"https://muon-oracle4.rasa.capital/v1/\",\n      ],\n    },\n  },\n};\n"],"mappings":";;AAQA,IAAa,IAAmD,GAC7D,EAAuB,YAAY;CAClC,SAAS,EAAuB;CAChC,WAAW;EACT,eAAe;EACf,qBAAqB;EACrB,qBAAqB;EACrB,mBAAmB;EACnB,mBAAmB;EACnB,oBAAoB;CACtB;CACA,WAAW;EACT,WACE;EACF,QACE;CACJ;CACA,QAAQ;EACN,MAAM;EACN,SAAS;EACT,KAAK;EACL,MAAM;GACJ,KAAK;GACL,OAAO;GACP,SAAS;GACT,kBAAkB;EACpB;CACF;CACA,cAAc;EACZ,MAAM;EACN,KAAK;EACL,OAAO;CACT;CACA,eAAe;EACb,KAAK;EACL,SAAS;EACT,UAAU;EAGV,WAAW;CACb;CACA,MAAM,EAGJ,MAAM;EACJ;EACA;EACA;EACA;CACF,EACF;AACF,EACF"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../../src/core/chains/registry.ts"],"sourcesContent":["import { SymmioSupportedChainId } from \"./supported-chains\";\nimport type { SymmioChainConfig } from \"./types\";\n\n/**\n * Built-in SYMMIO deployment configs keyed by chain ID.\n *\n * @internal\n */\nexport const CHAIN_CONFIGS: Record<number, SymmioChainConfig> = {\n  [SymmioSupportedChainId.HYPER_EVM]: {\n    chainId: SymmioSupportedChainId.HYPER_EVM,\n    addresses: {\n      symmioAddress: \"0x57331038c21982116EE9b0906E4a5c5cB52dcE2e\",\n      instantLayerAddress: \"0x72DBF07457b2712b160F67A85D338F860c1CA620\",\n      accountLayerAddress: \"0x46493c376758Da47823D7E3Ae5d417eA6546eEB3\",\n      affiliatesAddress: \"0xBcB033C9154401fA000a1Ae60843f79f45741b7c\",\n      collateralAddress: \"0xb88339CB7199b77E23DB6E890353E22632Ba630f\",\n      collateralDecimals: 6,\n    },\n    subgraphs: {\n      analytics:\n        \"https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/hyperevm_mainnet_analytics/latest/gn\",\n      events:\n        \"https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/hyperevm_mainnet_events/latest/gn\",\n    },\n    solvers: {\n      enigma: {\n        name: \"Enigma\",\n        address: \"0x76bc5889c0cfcC20960b0D81F541595d81a95122\",\n        url: \"https://solver.enigma.bz/api\",\n        tpsl: {\n          url: \"https://conditional-orders-handler-lowcap85.rasa.capital\",\n          wsUrl: \"wss://notification.rasa.capital/ws/v1/subscribe\",\n          appName: \"Hyper-EVM_COH-Low-Cap_Production\",\n          cohWalletAddress: \"0xf2afbb3f13Ca72bfb69749f3bC5EbD6528b1fc31\",\n        },\n        notifications: {\n          url: \"wss://notification.rasa.capital/ws/v1/subscribe\",\n          channel: \"Hyper-EVM_Solver-Low-Cap_Production\",\n          protocol: \"enigma\",\n          // Same host as the WebSocket stream; the REST search API is served under\n          // the `/notification` prefix (OpenAPI `servers[0].url`).\n          searchUrl: \"https://notification.rasa.capital/notification\",\n        },\n        // VA-per-market/side isolation supports folding a group into one close.\n        // `listingService`: declares this solver does the lowcap Pools/listing —\n        // declarative only; the listing functions resolve the backend at chain level.\n        capabilities: { groupClose: true, listingService: true },\n      },\n    },\n    defaultSolverId: \"enigma\",\n    priceService: {\n      type: \"enigma\",\n      url: \"https://lowcap-price.enigma.bz\",\n      wsUrl: \"wss://lowcap-price.enigma.bz/ws\",\n    },\n    muon: {\n      // Muon oracle gateways (https://docs.symm.io/api-endpoints-and-deployments/muon-api),\n      // tried in order until one returns a successful attestation.\n      urls: [\n        \"https://muon-oracle1.rasa.capital/v1/\",\n        \"https://muon-oracle2.rasa.capital/v1/\",\n        \"https://muon-oracle3.rasa.capital/v1/\",\n        \"https://muon-oracle4.rasa.capital/v1/\",\n      ],\n    },\n    listing: {\n      // Pools listing backend. Host root only — the generated client's paths\n      // already carry `/v2`, so a versioned base would 404.\n      // Staging: https://listing-staging.enigma.bz\n      url: \"https://listing85.enigma.bz\",\n    },\n    inventory: {\n      // Custody backend behind the Pools; source of system-wide TVL. Host root\n      // only — the generated client's paths already carry `/api/v1`.\n      // Staging: https://inventory-staging.enigma.bz\n      url: \"https://inventory85.enigma.bz\",\n    },\n  },\n\n  [SymmioSupportedChainId.BASE]: {\n    chainId: SymmioSupportedChainId.BASE,\n    addresses: {\n      symmioAddress: \"0x91Cf2D8Ed503EC52768999aA6D8DBeA6e52dbe43\",\n      instantLayerAddress: \"0x0825435285ac0E5c02c7a7c443F631f3e07fE375\",\n      accountLayerAddress: \"0x56caf00c6C5cB5478570Bb23807B9d1D697863DC\",\n      affiliatesAddress: \"0x45Eecd7B4f442388ACD90467E423A5CAAC3a9C3f\",\n      collateralAddress: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\", // USDC on Base\n      collateralDecimals: 6,\n    },\n    // Rasa — Base's real solver. Rasa's API shares Enigma's paths for the\n    // shared reads (contract-symbols, funding, locked params, error codes,\n    // notional_cap/{id}, instant lists), so those work today; the diverging\n    // endpoints (`/instant_trade/open|close` execution, `/estimated-price`,\n    // `/notional_cap` list) return 404 until per-kind dispatch is wired into\n    // the solver actions.\n    // No `tpsl` block: Base COH deployment not confirmed yet — absence marks\n    // conditional orders unsupported (add the block when the vendor provides it).\n    solvers: {\n      rasa: {\n        name: \"Rasa\",\n        address: \"0x81631953E0C093e72935C1CAA4C7D519B2A0E407\",\n        // Staging URL — swap to the production solver URL when published.\n        url: \"https://stage-archon.rasa.capital\",\n        // Rasa's own position-state stream — real Base data. No `searchUrl`: the\n        // rasa protocol serves notification history from the solver's own\n        // position-state endpoint (via `searchNotifications`), not a REST service.\n        notifications: {\n          url: \"wss://stage-archon.rasa.capital/ws/position-state-ws3\",\n          protocol: \"rasa\",\n        },\n        // Majors support LIMIT orders (pending open at a user-set price).\n        capabilities: { limitOrder: true },\n      },\n    },\n    defaultSolverId: \"rasa\",\n    // Base's own analytics and events subgraphs (Goldsky) — real, production endpoints.\n    subgraphs: {\n      analytics:\n        \"https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/base_analytics/latest/gn\",\n      events: \"https://api.goldsky.com/api/public/project_cm1hfr4527p0f01u85mz499u8/subgraphs/base_events/latest/gn\",\n    },\n    // Rasa serves majors and has no mark-price feed of its own — no REST mark\n    // price, no mark-price WebSocket, no index price. Binance USD-M Futures is\n    // the price source, matching how the reference UI configures this solver.\n    //\n    // Both URLs are public constants but stay in config on purpose: they are the\n    // escape hatch for Binance's regional restrictions, so an integrator whose\n    // users are blocked repoints them at their own proxy with no SDK change.\n    priceService: {\n      type: \"binance\",\n      /** USD-M Futures REST root. The client appends `/fapi/v1/…`. */\n      url: \"https://fapi.binance.com\",\n      /**\n       * All-symbols mark-price broadcast, 1 push/sec.\n       *\n       * The `/market/ws/` prefix is deliberate and was verified against the live\n       * endpoint: Binance's *documented* `/ws/<stream>` form (and\n       * `/stream?streams=`) connect and then never push a frame, which would ship\n       * a feed that reports `open` and silently never ticks.\n       */\n      wsUrl: \"wss://fstream.binance.com/market/ws/!markPrice@arr@1s\",\n    },\n    // Muon is deployment-agnostic: one `symmio` app on one shared gateway set\n    // serves every SYMMIO deployment, and the per-deployment input is the\n    // `symmio` request param (this chain's diamond, from `addresses` above).\n    // So these are Base's real gateways, not a HyperEVM stand-in.\n    muon: {\n      urls: [\n        \"https://muon-oracle1.rasa.capital/v1/\",\n        \"https://muon-oracle2.rasa.capital/v1/\",\n        \"https://muon-oracle3.rasa.capital/v1/\",\n        \"https://muon-oracle4.rasa.capital/v1/\",\n      ],\n    },\n  },\n};\n"],"mappings":";;AAQA,IAAa,IAAmD;EAC7D,EAAuB,YAAY;EAClC,SAAS,EAAuB;EAChC,WAAW;GACT,eAAe;GACf,qBAAqB;GACrB,qBAAqB;GACrB,mBAAmB;GACnB,mBAAmB;GACnB,oBAAoB;EACtB;EACA,WAAW;GACT,WACE;GACF,QACE;EACJ;EACA,SAAS,EACP,QAAQ;GACN,MAAM;GACN,SAAS;GACT,KAAK;GACL,MAAM;IACJ,KAAK;IACL,OAAO;IACP,SAAS;IACT,kBAAkB;GACpB;GACA,eAAe;IACb,KAAK;IACL,SAAS;IACT,UAAU;IAGV,WAAW;GACb;GAIA,cAAc;IAAE,YAAY;IAAM,gBAAgB;GAAK;EACzD,EACF;EACA,iBAAiB;EACjB,cAAc;GACZ,MAAM;GACN,KAAK;GACL,OAAO;EACT;EACA,MAAM,EAGJ,MAAM;GACJ;GACA;GACA;GACA;EACF,EACF;EACA,SAAS,EAIP,KAAK,8BACP;EACA,WAAW,EAIT,KAAK,gCACP;CACF;EAEC,EAAuB,OAAO;EAC7B,SAAS,EAAuB;EAChC,WAAW;GACT,eAAe;GACf,qBAAqB;GACrB,qBAAqB;GACrB,mBAAmB;GACnB,mBAAmB;GACnB,oBAAoB;EACtB;EASA,SAAS,EACP,MAAM;GACJ,MAAM;GACN,SAAS;GAET,KAAK;GAIL,eAAe;IACb,KAAK;IACL,UAAU;GACZ;GAEA,cAAc,EAAE,YAAY,GAAK;EACnC,EACF;EACA,iBAAiB;EAEjB,WAAW;GACT,WACE;GACF,QAAQ;EACV;EAQA,cAAc;GACZ,MAAM;GAEN,KAAK;GASL,OAAO;EACT;EAKA,MAAM,EACJ,MAAM;GACJ;GACA;GACA;GACA;EACF,EACF;CACF;AACF"}

package/dist/core/chains/resolve-solver.d.ts

@@ -0,0 +1,14 @@
+import { SolverId, SymmioChainConfig, SymmioResolvedSolver } from './types.js';
+/**
+ * Resolve a chain's solver by id. When `solverId` is omitted, the chain's
+ * `defaultSolverId` is used. Returns the stored config with its resolved `id`
+ * (which is the solver's kind) attached, so callers can dispatch by kind without
+ * re-deriving it.
+ *
+ * @throws {SymmError} `UNKNOWN_SOLVER` when no solver with that id is configured
+ *   for the chain.
+ *
+ * @internal
+ */
+export declare function resolveSolver(chainConfig: SymmioChainConfig, solverId?: SolverId): SymmioResolvedSolver;
+//# sourceMappingURL=resolve-solver.d.ts.map

package/dist/core/chains/resolve-solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-solver.d.ts","sourceRoot":"","sources":["../../../src/core/chains/resolve-solver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEjF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,oBAAoB,CAQvG"}