@symmio/trading-react 1.1.0 → 3.0.0

package/dist/price-service/use-price-by-market-id.js

@@ -0,0 +1,33 @@
+"use client";
+import { useMarkets as e } from "../markets/use-markets.js";
+import { usePriceByName as t } from "./use-price-by-name.js";
+import { useMemo as n } from "react";
+//#region src/price-service/use-price-by-market-id.ts
+function r(e) {
+	return typeof e == "number" ? e : Number(e);
+}
+function i(i) {
+	let { marketId: a, chainId: o, solverId: s, enabled: c = !0, ...l } = i, u = e({
+		chainId: o,
+		solverId: s,
+		...l
+	}), d = n(() => r(a), [a]), f = n(() => u.data ? u.data.find((e) => e.symbolId === d)?.name ?? null : null, [u.data, d]), p = t({
+		...l,
+		chainId: o,
+		solverId: s,
+		name: f ?? void 0,
+		enabled: c && f !== null
+	});
+	return {
+		markPrice: p.markPrice,
+		marketName: f,
+		tick: p.tick,
+		status: p.status,
+		error: p.error,
+		isLoading: u.isLoading || f !== null && p.markPrice === null
+	};
+}
+//#endregion
+export { i as usePriceByMarketId };
+
+//# sourceMappingURL=use-price-by-market-id.js.map

package/dist/price-service/use-price-by-market-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-price-by-market-id.js","names":[],"sources":["../../src/price-service/use-price-by-market-id.ts"],"sourcesContent":["\"use client\";\n\nimport type { ConfigParameter, MarkPriceTick, SocketStatus, SolverId } from \"@symmio/trading-core\";\nimport { useMemo } from \"react\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useMarkets } from \"../markets/use-markets\";\nimport { usePriceByName } from \"./use-price-by-name\";\nimport type { UsePricesRestFallback } from \"./use-prices\";\n\n/**\n * Parameters for {@link usePriceByMarketId}.\n */\nexport interface UsePriceByMarketIdParameters extends ConfigParameter {\n  /** Solver market id (`symbol_id`). */\n  marketId: number | bigint | string;\n  /** Target chain id. Defaults to the SDK's active chain. */\n  chainId?: number;\n  /** Solver whose markets and price provider serve this id. Defaults to the chain's default solver. */\n  solverId?: SolverId;\n  /** Subscribe only when `true` (and the market resolves). Default `true`. */\n  enabled?: boolean;\n  /** REST snapshot polling while the socket is degraded. See {@link usePrices}. */\n  restFallback?: UsePricesRestFallback;\n}\n\n/**\n * Value returned by {@link usePriceByMarketId}.\n */\nexport interface UsePriceByMarketIdReturnType {\n  /** Latest mark price for the resolved market, or `null` until the first tick. */\n  markPrice: string | null;\n  /** Symbol name resolved from {@link useMarkets}, or `null` if not found yet. */\n  marketName: string | null;\n  /** The full tick, for provider-specific fields. Narrow on `provider`. */\n  tick: MarkPriceTick | null;\n  /** Live socket status. */\n  status: SocketStatus;\n  /** Last transport/parse error, normalized, or `null`. */\n  error: SymmioRequestError | null;\n  /** True while markets are loading or the price has not ticked yet. */\n  isLoading: boolean;\n}\n\nfunction toMarketIdNumber(value: number | bigint | string): number {\n  if (typeof value === \"number\") return value;\n  if (typeof value === \"bigint\") return Number(value);\n  return Number(value);\n}\n\n/**\n * Stream the live mark price for a market resolved by its solver `symbol_id`,\n * from **whichever price provider serves the resolved solver** — Enigma on a\n * lowcap chain, Binance USD-M Futures on a majors chain.\n *\n * Composes {@link useMarkets} (to translate `marketId → name`) with\n * {@link usePriceByName} (to subscribe to just that symbol on the resolved\n * provider). This is the provider-agnostic replacement for\n * `useEnigmaPriceByMarketId`, which asserts an Enigma price service and\n * therefore fails on chains priced by Binance.\n *\n * @example\n * ```tsx\n * const { markPrice, marketName, isLoading } = usePriceByMarketId({ marketId: 132 });\n * ```\n */\nexport function usePriceByMarketId(parameters: UsePriceByMarketIdParameters): UsePriceByMarketIdReturnType {\n  const { marketId, chainId, solverId, enabled = true, ...rest } = parameters;\n\n  const marketsQuery = useMarkets({ chainId, solverId, ...rest });\n  const targetId = useMemo(() => toMarketIdNumber(marketId), [marketId]);\n\n  const marketName = useMemo<string | null>(() => {\n    if (!marketsQuery.data) return null;\n    const market = marketsQuery.data.find((entry) => entry.symbolId === targetId);\n    return market?.name ?? null;\n  }, [marketsQuery.data, targetId]);\n\n  const priceQuery = usePriceByName({\n    ...rest,\n    chainId,\n    solverId,\n    name: marketName ?? undefined,\n    enabled: enabled && marketName !== null,\n  });\n\n  return {\n    markPrice: priceQuery.markPrice,\n    marketName,\n    tick: priceQuery.tick,\n    status: priceQuery.status,\n    error: priceQuery.error,\n    isLoading: marketsQuery.isLoading || (marketName !== null && priceQuery.markPrice === null),\n  };\n}\n"],"mappings":";;;;;AA2CA,SAAS,EAAiB,GAAyC;CAGjE,OAFI,OAAO,KAAU,WAAiB,IACA,OAAO,CAAK;AAEpD;AAkBA,SAAgB,EAAmB,GAAwE;CACzG,IAAM,EAAE,aAAU,YAAS,aAAU,aAAU,IAAM,GAAG,MAAS,GAE3D,IAAe,EAAW;EAAE;EAAS;EAAU,GAAG;CAAK,CAAC,GACxD,IAAW,QAAc,EAAiB,CAAQ,GAAG,CAAC,CAAQ,CAAC,GAE/D,IAAa,QACZ,EAAa,OACH,EAAa,KAAK,MAAM,MAAU,EAAM,aAAa,CAC7D,GAAQ,QAAQ,OAFQ,MAG9B,CAAC,EAAa,MAAM,CAAQ,CAAC,GAE1B,IAAa,EAAe;EAChC,GAAG;EACH;EACA;EACA,MAAM,KAAc,KAAA;EACpB,SAAS,KAAW,MAAe;CACrC,CAAC;CAED,OAAO;EACL,WAAW,EAAW;EACtB;EACA,MAAM,EAAW;EACjB,QAAQ,EAAW;EACnB,OAAO,EAAW;EAClB,WAAW,EAAa,aAAc,MAAe,QAAQ,EAAW,cAAc;CACxF;AACF"}

package/dist/price-service/use-price-by-name.d.ts

@@ -0,0 +1,48 @@
+import { ConfigParameter, MarkPriceTick, SocketStatus, SolverId } from '@symmio/trading-core';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+import { UsePricesRestFallback } from './use-prices.js';
+/**
+ * Parameters for {@link usePriceByName}.
+ */
+export interface UsePriceByNameParameters extends ConfigParameter {
+    /** Market name to price, e.g. `"BTCUSDT"`. Subscription is disabled while undefined. */
+    name?: string;
+    /** Target chain id. Defaults to the SDK's active chain. */
+    chainId?: number;
+    /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */
+    solverId?: SolverId;
+    /** Subscribe only when `true`. Default `true`. */
+    enabled?: boolean;
+    /** REST snapshot polling while the socket is degraded. See {@link usePrices}. */
+    restFallback?: UsePricesRestFallback;
+}
+/**
+ * Value returned by {@link usePriceByName}.
+ */
+export interface UsePriceByNameReturnType {
+    /** Latest mark price as a decimal string, or `null` before the first tick. */
+    markPrice: string | null;
+    /** The full tick, for provider-specific fields. Narrow on `provider`. */
+    tick: MarkPriceTick | null;
+    /** Live socket status. */
+    status: SocketStatus;
+    /** Last transport/parse error, normalized, or `null`. */
+    error: SymmioRequestError | null;
+}
+/**
+ * Track one market's mark price from whichever provider serves the resolved
+ * solver.
+ *
+ * Subscribes with a single-name filter, so on Binance — whose stream pushes every
+ * listed symbol once per second — this re-renders on that one market's ticks
+ * rather than on all ~740. A ref gate suppresses re-renders when a tick repeats
+ * the price already held.
+ *
+ * @example
+ * ```tsx
+ * const { markPrice, status } = usePriceByName({ name: "BTCUSDT", solverId: "rasa" });
+ * return <span>{markPrice ?? "—"} ({status})</span>;
+ * ```
+ */
+export declare function usePriceByName(parameters: UsePriceByNameParameters): UsePriceByNameReturnType;
+//# sourceMappingURL=use-price-by-name.d.ts.map

package/dist/price-service/use-price-by-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-price-by-name.d.ts","sourceRoot":"","sources":["../../src/price-service/use-price-by-name.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAa,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iFAAiF;IACjF,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yEAAyE;IACzE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,wBAAwB,GAAG,wBAAwB,CAiB7F"}

package/dist/price-service/use-price-by-name.js

@@ -0,0 +1,23 @@
+"use client";
+import { usePrices as e } from "./use-prices.js";
+import { useRef as t } from "react";
+//#region src/price-service/use-price-by-name.ts
+function n(n) {
+	let { name: r, enabled: i = !0, ...a } = n, { ticks: o, status: s, error: c } = e({
+		...a,
+		names: r ? [r] : void 0,
+		enabled: i && !!r
+	}), l = r ? o[r] ?? null : null, u = t(null);
+	l && (u.current = l);
+	let d = l ?? u.current;
+	return {
+		markPrice: d?.markPrice ?? null,
+		tick: d,
+		status: s,
+		error: c
+	};
+}
+//#endregion
+export { n as usePriceByName };
+
+//# sourceMappingURL=use-price-by-name.js.map

package/dist/price-service/use-price-by-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-price-by-name.js","names":[],"sources":["../../src/price-service/use-price-by-name.ts"],"sourcesContent":["\"use client\";\n\nimport type { ConfigParameter, MarkPriceTick, SocketStatus, SolverId } from \"@symmio/trading-core\";\nimport { useRef } from \"react\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { usePrices, type UsePricesRestFallback } from \"./use-prices\";\n\n/**\n * Parameters for {@link usePriceByName}.\n */\nexport interface UsePriceByNameParameters extends ConfigParameter {\n  /** Market name to price, e.g. `\"BTCUSDT\"`. Subscription is disabled while undefined. */\n  name?: string;\n  /** Target chain id. Defaults to the SDK's active chain. */\n  chainId?: number;\n  /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */\n  solverId?: SolverId;\n  /** Subscribe only when `true`. Default `true`. */\n  enabled?: boolean;\n  /** REST snapshot polling while the socket is degraded. See {@link usePrices}. */\n  restFallback?: UsePricesRestFallback;\n}\n\n/**\n * Value returned by {@link usePriceByName}.\n */\nexport interface UsePriceByNameReturnType {\n  /** Latest mark price as a decimal string, or `null` before the first tick. */\n  markPrice: string | null;\n  /** The full tick, for provider-specific fields. Narrow on `provider`. */\n  tick: MarkPriceTick | null;\n  /** Live socket status. */\n  status: SocketStatus;\n  /** Last transport/parse error, normalized, or `null`. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Track one market's mark price from whichever provider serves the resolved\n * solver.\n *\n * Subscribes with a single-name filter, so on Binance — whose stream pushes every\n * listed symbol once per second — this re-renders on that one market's ticks\n * rather than on all ~740. A ref gate suppresses re-renders when a tick repeats\n * the price already held.\n *\n * @example\n * ```tsx\n * const { markPrice, status } = usePriceByName({ name: \"BTCUSDT\", solverId: \"rasa\" });\n * return <span>{markPrice ?? \"—\"} ({status})</span>;\n * ```\n */\nexport function usePriceByName(parameters: UsePriceByNameParameters): UsePriceByNameReturnType {\n  const { name, enabled = true, ...rest } = parameters;\n\n  const { ticks, status, error } = usePrices({\n    ...rest,\n    names: name ? [name] : undefined,\n    enabled: enabled && Boolean(name),\n  });\n\n  const tick = name ? (ticks[name] ?? null) : null;\n\n  // Hold the last non-null tick so a transient gap does not blank the display.\n  const lastTickRef = useRef<MarkPriceTick | null>(null);\n  if (tick) lastTickRef.current = tick;\n  const resolved = tick ?? lastTickRef.current;\n\n  return { markPrice: resolved?.markPrice ?? null, tick: resolved, status, error };\n}\n"],"mappings":";;;;AAoDA,SAAgB,EAAe,GAAgE;CAC7F,IAAM,EAAE,SAAM,aAAU,IAAM,GAAG,MAAS,GAEpC,EAAE,UAAO,WAAQ,aAAU,EAAU;EACzC,GAAG;EACH,OAAO,IAAO,CAAC,CAAI,IAAI,KAAA;EACvB,SAAS,KAAW,EAAQ;CAC9B,CAAC,GAEK,IAAO,IAAQ,EAAM,MAAS,OAAQ,MAGtC,IAAc,EAA6B,IAAI;CACrD,AAAI,MAAM,EAAY,UAAU;CAChC,IAAM,IAAW,KAAQ,EAAY;CAErC,OAAO;EAAE,WAAW,GAAU,aAAa;EAAM,MAAM;EAAU;EAAQ;CAAM;AACjF"}

package/dist/price-service/use-prices.d.ts

@@ -0,0 +1,87 @@
+import { ConfigParameter, MarkPriceTick, SocketStatus, SolverId } from '@symmio/trading-core';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * REST-fallback behaviour for {@link usePrices}.
+ */
+export interface UsePricesRestFallback {
+    /** Poll a REST snapshot while the socket is degraded. Default `true`. */
+    enabled?: boolean;
+    /** Poll interval in ms. Default `5000`. */
+    intervalMs?: number;
+}
+/**
+ * Parameters for {@link usePrices}.
+ */
+export interface UsePricesParameters extends ConfigParameter {
+    /** Target chain id. Defaults to the SDK's active chain. */
+    chainId?: number;
+    /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */
+    solverId?: SolverId;
+    /**
+     * Restrict the accumulated map to these market names.
+     *
+     * **Strongly recommended on Binance**, whose stream pushes every listed symbol
+     * (~740) once per second — filtering turns that into a handful of state
+     * updates instead of a full-map churn every tick.
+     */
+    names?: readonly string[];
+    /** Subscribe only when `true`. Default `true`. */
+    enabled?: boolean;
+    /** Imperative per-tick callback, invoked in addition to map updates. */
+    onTick?: (ticks: MarkPriceTick[]) => void;
+    /**
+     * REST snapshot polling while the socket is not `"open"`.
+     *
+     * Implemented as a `useQuery` with `refetchInterval`, so it is visible in
+     * devtools, deduplicated by query key, pausable by the app, and stops the
+     * moment the socket reports `open`. Deliberately composed here rather than
+     * hidden inside `watchPrices`: a watcher that silently became an HTTP poller
+     * would report a socket status that no longer described where the data came
+     * from.
+     */
+    restFallback?: UsePricesRestFallback;
+}
+/**
+ * Value returned by {@link usePrices}.
+ */
+export interface UsePricesReturnType {
+    /**
+     * Latest full tick keyed by market name. Narrow on `provider` to reach
+     * provider-specific fields such as Binance's `indexPrice`.
+     */
+    ticks: Record<string, MarkPriceTick>;
+    /** Latest mark price keyed by market name — the ergonomic shape for display. */
+    prices: Record<string, string>;
+    /** Live socket status. */
+    status: SocketStatus;
+    /** Last transport/parse error, normalized, or `null`. */
+    error: SymmioRequestError | null;
+}
+/**
+ * Subscribe to the live mark-price feed of whichever provider serves the
+ * resolved solver — Enigma's lowcap service, or Binance USD-M Futures for
+ * majors.
+ *
+ * Accumulates the latest tick per market name and updates as ticks arrive. The
+ * subscription is shared across hook instances via the SDK socket pool, so
+ * several `usePrices()` mounts on one chain cost one connection even when they
+ * ask for different `names`.
+ *
+ * Returns **both** shapes on purpose: `prices` for the common display case, and
+ * `ticks` so a Binance consumer does not lose `indexPrice` and the funding
+ * fields that only exist on the full tick.
+ *
+ * @example
+ * ```tsx
+ * const { prices, ticks, status } = usePrices({ solverId: "rasa", names: ["BTCUSDT"] });
+ * const tick = ticks["BTCUSDT"];
+ * return (
+ *   <span>
+ *     BTC {prices["BTCUSDT"] ?? "—"} ({status})
+ *     {tick?.provider === "binance" ? ` index ${tick.indexPrice}` : null}
+ *   </span>
+ * );
+ * ```
+ */
+export declare function usePrices(parameters?: UsePricesParameters): UsePricesReturnType;
+//# sourceMappingURL=use-prices.d.ts.map

package/dist/price-service/use-prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-prices.d.ts","sourceRoot":"","sources":["../../src/price-service/use-prices.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAOzE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IAC1C;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,0BAA0B;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,UAAU,GAAE,mBAAwB,GAAG,mBAAmB,CA+GnF"}

package/dist/price-service/use-prices.js

@@ -0,0 +1,77 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getMarkPricesQueryOptions as r, watchPrices as i } from "@symmio/trading-core";
+import { useEffect as a, useMemo as o, useRef as s, useState as c } from "react";
+import { useQuery as l } from "@tanstack/react-query";
+//#region src/price-service/use-prices.ts
+var u = 5e3;
+function d(d = {}) {
+	let { chainId: f, solverId: p, names: m, enabled: h = !0, onTick: g, restFallback: _ } = d, v = t(d), y = e(), b = f ?? y, [x, S] = c({}), [C, w] = c("closed"), [T, E] = c(null), D = s(g);
+	D.current = g;
+	let O = m ? m.join(",") : void 0, k = `${b}|${p ?? ""}|${O ?? ""}`, A = s(k);
+	A.current !== k && (A.current = k, S({})), a(() => {
+		if (!h) {
+			w("closed");
+			return;
+		}
+		E(null);
+		let e;
+		try {
+			e = i(v, {
+				chainId: b,
+				solverId: p,
+				names: O ? O.split(",") : void 0,
+				onPrices: (e) => {
+					S((t) => {
+						let n = !1, r = { ...t };
+						for (let t of e) r[t.name]?.markPrice !== t.markPrice && (r[t.name] = t, n = !0);
+						return n ? r : t;
+					}), D.current?.(e);
+				},
+				onStatusChange: w,
+				onError: (e) => E(n(e))
+			});
+		} catch (e) {
+			E(n(e)), w("closed");
+		}
+		return () => e?.();
+	}, [
+		h,
+		v,
+		b,
+		p,
+		O
+	]);
+	let j = h && (_?.enabled ?? !0) && C !== "open", M = l({
+		...r(v, {
+			chainId: b,
+			solverId: p,
+			names: O ? O.split(",") : void 0
+		}),
+		enabled: j,
+		refetchInterval: _?.intervalMs ?? u,
+		retry: !1
+	});
+	return a(() => {
+		M.data?.length && S((e) => {
+			let t = !1, n = { ...e };
+			for (let e of M.data) n[e.name]?.markPrice !== e.markPrice && (n[e.name] = e, t = !0);
+			return t ? n : e;
+		});
+	}, [M.data]), {
+		ticks: x,
+		prices: o(() => {
+			let e = {};
+			for (let [t, n] of Object.entries(x)) e[t] = n.markPrice;
+			return e;
+		}, [x]),
+		status: C,
+		error: T
+	};
+}
+//#endregion
+export { d as usePrices };
+
+//# sourceMappingURL=use-prices.js.map

package/dist/price-service/use-prices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-prices.js","names":[],"sources":["../../src/price-service/use-prices.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getMarkPricesQueryOptions,\n  watchPrices,\n  type ConfigParameter,\n  type MarkPriceTick,\n  type SocketStatus,\n  type SolverId,\n} from \"@symmio/trading-core\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { useEffect, useMemo, useRef, useState } from \"react\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/** Default polling cadence while the socket is not `open`. */\nconst DEFAULT_REST_FALLBACK_INTERVAL_MS = 5_000;\n\n/**\n * REST-fallback behaviour for {@link usePrices}.\n */\nexport interface UsePricesRestFallback {\n  /** Poll a REST snapshot while the socket is degraded. Default `true`. */\n  enabled?: boolean;\n  /** Poll interval in ms. Default `5000`. */\n  intervalMs?: number;\n}\n\n/**\n * Parameters for {@link usePrices}.\n */\nexport interface UsePricesParameters extends ConfigParameter {\n  /** Target chain id. Defaults to the SDK's active chain. */\n  chainId?: number;\n  /** Solver whose price provider to subscribe to. Defaults to the chain's default solver. */\n  solverId?: SolverId;\n  /**\n   * Restrict the accumulated map to these market names.\n   *\n   * **Strongly recommended on Binance**, whose stream pushes every listed symbol\n   * (~740) once per second — filtering turns that into a handful of state\n   * updates instead of a full-map churn every tick.\n   */\n  names?: readonly string[];\n  /** Subscribe only when `true`. Default `true`. */\n  enabled?: boolean;\n  /** Imperative per-tick callback, invoked in addition to map updates. */\n  onTick?: (ticks: MarkPriceTick[]) => void;\n  /**\n   * REST snapshot polling while the socket is not `\"open\"`.\n   *\n   * Implemented as a `useQuery` with `refetchInterval`, so it is visible in\n   * devtools, deduplicated by query key, pausable by the app, and stops the\n   * moment the socket reports `open`. Deliberately composed here rather than\n   * hidden inside `watchPrices`: a watcher that silently became an HTTP poller\n   * would report a socket status that no longer described where the data came\n   * from.\n   */\n  restFallback?: UsePricesRestFallback;\n}\n\n/**\n * Value returned by {@link usePrices}.\n */\nexport interface UsePricesReturnType {\n  /**\n   * Latest full tick keyed by market name. Narrow on `provider` to reach\n   * provider-specific fields such as Binance's `indexPrice`.\n   */\n  ticks: Record<string, MarkPriceTick>;\n  /** Latest mark price keyed by market name — the ergonomic shape for display. */\n  prices: Record<string, string>;\n  /** Live socket status. */\n  status: SocketStatus;\n  /** Last transport/parse error, normalized, or `null`. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Subscribe to the live mark-price feed of whichever provider serves the\n * resolved solver — Enigma's lowcap service, or Binance USD-M Futures for\n * majors.\n *\n * Accumulates the latest tick per market name and updates as ticks arrive. The\n * subscription is shared across hook instances via the SDK socket pool, so\n * several `usePrices()` mounts on one chain cost one connection even when they\n * ask for different `names`.\n *\n * Returns **both** shapes on purpose: `prices` for the common display case, and\n * `ticks` so a Binance consumer does not lose `indexPrice` and the funding\n * fields that only exist on the full tick.\n *\n * @example\n * ```tsx\n * const { prices, ticks, status } = usePrices({ solverId: \"rasa\", names: [\"BTCUSDT\"] });\n * const tick = ticks[\"BTCUSDT\"];\n * return (\n *   <span>\n *     BTC {prices[\"BTCUSDT\"] ?? \"—\"} ({status})\n *     {tick?.provider === \"binance\" ? ` index ${tick.indexPrice}` : null}\n *   </span>\n * );\n * ```\n */\nexport function usePrices(parameters: UsePricesParameters = {}): UsePricesReturnType {\n  const { chainId, solverId, names, enabled = true, onTick, restFallback } = parameters;\n  const config = useSymmioConfig(parameters);\n  const defaultChainId = useSymmioChainId();\n  const resolvedChainId = chainId ?? defaultChainId;\n\n  const [ticks, setTicks] = useState<Record<string, MarkPriceTick>>({});\n  const [status, setStatus] = useState<SocketStatus>(\"closed\");\n  const [error, setError] = useState<SymmioRequestError | null>(null);\n\n  const onTickRef = useRef(onTick);\n  onTickRef.current = onTick;\n\n  // Identity-stable across renders so an inline `names` array literal does not\n  // resubscribe the socket on every render.\n  const namesKey = names ? names.join(\",\") : undefined;\n\n  /**\n   * Drop accumulated ticks when the subscription target changes.\n   *\n   * Without this, switching solver (and therefore provider) leaves the previous\n   * provider's ticks in the map, so a component renders Enigma prices while\n   * labelled as Binance — and a name the new provider does not serve never\n   * disappears. Keyed on the target rather than on `enabled`, so stopping and\n   * restarting the same feed keeps its last values.\n   */\n  const subscriptionKey = `${resolvedChainId}|${solverId ?? \"\"}|${namesKey ?? \"\"}`;\n  const lastSubscriptionKeyRef = useRef(subscriptionKey);\n  if (lastSubscriptionKeyRef.current !== subscriptionKey) {\n    lastSubscriptionKeyRef.current = subscriptionKey;\n    setTicks({});\n  }\n\n  useEffect(() => {\n    if (!enabled) {\n      setStatus(\"closed\");\n      return;\n    }\n\n    setError(null);\n\n    let unwatch: (() => void) | undefined;\n    try {\n      unwatch = watchPrices(config, {\n        chainId: resolvedChainId,\n        solverId,\n        names: namesKey ? namesKey.split(\",\") : undefined,\n        onPrices: (batch) => {\n          setTicks((prev) => {\n            let mutated = false;\n            const next = { ...prev };\n            for (const tick of batch) {\n              if (next[tick.name]?.markPrice !== tick.markPrice) {\n                next[tick.name] = tick;\n                mutated = true;\n              }\n            }\n            return mutated ? next : prev;\n          });\n          onTickRef.current?.(batch);\n        },\n        onStatusChange: setStatus,\n        onError: (err) => setError(normalizeSymmError(err)),\n      });\n    } catch (err) {\n      setError(normalizeSymmError(err));\n      setStatus(\"closed\");\n    }\n\n    return () => unwatch?.();\n  }, [enabled, config, resolvedChainId, solverId, namesKey]);\n\n  /**\n   * The fallback runs only while the socket is not delivering, so a healthy feed\n   * costs no HTTP at all. `retry: false` keeps a degraded feed from retrying\n   * into Binance's 429 → 418 IP-ban escalation.\n   */\n  const fallbackEnabled = enabled && (restFallback?.enabled ?? true) && status !== \"open\";\n  const snapshot = useQuery({\n    ...getMarkPricesQueryOptions(config, {\n      chainId: resolvedChainId,\n      solverId,\n      names: namesKey ? namesKey.split(\",\") : undefined,\n    }),\n    enabled: fallbackEnabled,\n    refetchInterval: restFallback?.intervalMs ?? DEFAULT_REST_FALLBACK_INTERVAL_MS,\n    retry: false,\n  });\n\n  useEffect(() => {\n    if (!snapshot.data?.length) return;\n    setTicks((prev) => {\n      let mutated = false;\n      const next = { ...prev };\n      for (const tick of snapshot.data) {\n        if (next[tick.name]?.markPrice !== tick.markPrice) {\n          next[tick.name] = tick;\n          mutated = true;\n        }\n      }\n      return mutated ? next : prev;\n    });\n  }, [snapshot.data]);\n\n  const prices = useMemo(() => {\n    const out: Record<string, string> = {};\n    for (const [name, tick] of Object.entries(ticks)) out[name] = tick.markPrice;\n    return out;\n  }, [ticks]);\n\n  return { ticks, prices, status, error };\n}\n"],"mappings":";;;;;;;;AAkBA,IAAM,IAAoC;AAwF1C,SAAgB,EAAU,IAAkC,CAAC,GAAwB;CACnF,IAAM,EAAE,YAAS,aAAU,UAAO,aAAU,IAAM,WAAQ,oBAAiB,GACrE,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAkB,KAAW,GAE7B,CAAC,GAAO,KAAY,EAAwC,CAAC,CAAC,GAC9D,CAAC,GAAQ,KAAa,EAAuB,QAAQ,GACrD,CAAC,GAAO,KAAY,EAAoC,IAAI,GAE5D,IAAY,EAAO,CAAM;CAC/B,EAAU,UAAU;CAIpB,IAAM,IAAW,IAAQ,EAAM,KAAK,GAAG,IAAI,KAAA,GAWrC,IAAkB,GAAG,EAAgB,GAAG,KAAY,GAAG,GAAG,KAAY,MACtE,IAAyB,EAAO,CAAe;CAMrD,AALI,EAAuB,YAAY,MACrC,EAAuB,UAAU,GACjC,EAAS,CAAC,CAAC,IAGb,QAAgB;EACd,IAAI,CAAC,GAAS;GACZ,EAAU,QAAQ;GAClB;EACF;EAEA,EAAS,IAAI;EAEb,IAAI;EACJ,IAAI;GACF,IAAU,EAAY,GAAQ;IAC5B,SAAS;IACT;IACA,OAAO,IAAW,EAAS,MAAM,GAAG,IAAI,KAAA;IACxC,WAAW,MAAU;KAYnB,AAXA,GAAU,MAAS;MACjB,IAAI,IAAU,IACR,IAAO,EAAE,GAAG,EAAK;MACvB,KAAK,IAAM,KAAQ,GACjB,AAAI,EAAK,EAAK,OAAO,cAAc,EAAK,cACtC,EAAK,EAAK,QAAQ,GAClB,IAAU;MAGd,OAAO,IAAU,IAAO;KAC1B,CAAC,GACD,EAAU,UAAU,CAAK;IAC3B;IACA,gBAAgB;IAChB,UAAU,MAAQ,EAAS,EAAmB,CAAG,CAAC;GACpD,CAAC;EACH,SAAS,GAAK;GAEZ,AADA,EAAS,EAAmB,CAAG,CAAC,GAChC,EAAU,QAAQ;EACpB;EAEA,aAAa,IAAU;CACzB,GAAG;EAAC;EAAS;EAAQ;EAAiB;EAAU;CAAQ,CAAC;CAOzD,IAAM,IAAkB,MAAY,GAAc,WAAW,OAAS,MAAW,QAC3E,IAAW,EAAS;EACxB,GAAG,EAA0B,GAAQ;GACnC,SAAS;GACT;GACA,OAAO,IAAW,EAAS,MAAM,GAAG,IAAI,KAAA;EAC1C,CAAC;EACD,SAAS;EACT,iBAAiB,GAAc,cAAc;EAC7C,OAAO;CACT,CAAC;CAuBD,OArBA,QAAgB;EACT,EAAS,MAAM,UACpB,GAAU,MAAS;GACjB,IAAI,IAAU,IACR,IAAO,EAAE,GAAG,EAAK;GACvB,KAAK,IAAM,KAAQ,EAAS,MAC1B,AAAI,EAAK,EAAK,OAAO,cAAc,EAAK,cACtC,EAAK,EAAK,QAAQ,GAClB,IAAU;GAGd,OAAO,IAAU,IAAO;EAC1B,CAAC;CACH,GAAG,CAAC,EAAS,IAAI,CAAC,GAQX;EAAE;EAAO,QAND,QAAc;GAC3B,IAAM,IAA8B,CAAC;GACrC,KAAK,IAAM,CAAC,GAAM,MAAS,OAAO,QAAQ,CAAK,GAAG,EAAI,KAAQ,EAAK;GACnE,OAAO;EACT,GAAG,CAAC,CAAK,CAEO;EAAQ;EAAQ;CAAM;AACxC"}

package/dist/provider/symmio-provider.d.ts

@@ -20,7 +20,13 @@ export interface SymmioProviderProps {
      * built-in default affiliate and lose attribution.
      */
     symmioConfig: CreateConfigParameters["symmioConfig"];
-    /** Chain used when a hook or action omits `chainId`. Defaults to the first supported chain. */
+    /**
+     * Fallback chain used when a hook or action omits `chainId` **and** the
+     * connected wallet is not on a supported SYMMIO chain (or is disconnected).
+     * When the wallet *is* on a supported chain, that chain becomes the default
+     * instead — so a no-arg `config.getChainConfig()` always follows the active
+     * chain. Defaults to the SDK's first supported chain.
+     */
     defaultChainId?: number;
     /**
      * Custom wallet-client resolver. Receives `{ chainId, from? }` from the SDK
@@ -44,7 +50,7 @@ export interface SymmioProviderProps {
  * ```tsx
  * <WagmiProvider config={wagmiConfig}>
  *   <QueryClientProvider client={queryClient}>
- *     <SymmioProvider symmioConfig={{ [SymmioSupportedChainId.HYPER_EVM]: { addresses: { affiliatesAddress: "0x…" } } }}>
+ *     <SymmioProvider symmioConfig={{ [SymmioSupportedChainId.ARBITRUM]: { addresses: { affiliatesAddress: "0x…" } } }}>
  *       <App />
  *     </SymmioProvider>
  *   </QueryClientProvider>

package/dist/provider/symmio-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symmio-provider.d.ts","sourceRoot":"","sources":["../../src/provider/symmio-provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACrD,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EAAE,mBAAmB,GACrC,EAAE,mBAAmB,+BAsCrB"}
+{"version":3,"file":"symmio-provider.d.ts","sourceRoot":"","sources":["../../src/provider/symmio-provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACrD;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,eAAe,EAAE,mBAAmB,GACrC,EAAE,mBAAmB,+BAkDrB"}

package/dist/provider/symmio-provider.js

@@ -1,39 +1,39 @@
 "use client";
 import { SymmioConfigContext as e } from "./symmio-config-context.js";
-import { SymmError as t, createConfig as n } from "@symmio/trading-core";
-import { useMemo as r } from "react";
-import { useConfig as i } from "wagmi";
-import { getPublicClient as a, getWalletClient as o } from "wagmi/actions";
-import { jsx as s } from "react/jsx-runtime";
+import { SymmError as t, createConfig as n, listSupportedChains as r } from "@symmio/trading-core";
+import { useMemo as i } from "react";
+import { useChainId as a, useConfig as o } from "wagmi";
+import { getPublicClient as s, getWalletClient as c } from "wagmi/actions";
+import { jsx as l } from "react/jsx-runtime";
 //#region src/provider/symmio-provider.tsx
-function c({ children: c, symmioConfig: l, defaultChainId: u, getWalletClient: d }) {
-	let f = i(), p = r(() => n({
-		symmioConfig: l,
-		defaultChainId: u,
+function u({ children: u, symmioConfig: d, defaultChainId: f, getWalletClient: p }) {
+	let m = o(), h = a(), g = r().some((e) => e === h) ? h : f, _ = i(() => n({
+		symmioConfig: d,
+		defaultChainId: g,
 		getClient: ({ chainId: e } = {}) => {
-			let n = a(f, { chainId: e });
+			let n = s(m, { chainId: e });
 			if (!n) throw new t("config", "NO_PUBLIC_CLIENT", `No public client available for chain ${e ?? "(default)"}.`);
 			return n;
 		},
-		getWalletClient: d ?? (async ({ chainId: e }) => {
+		getWalletClient: p ?? (async ({ chainId: e }) => {
 			try {
-				return await o(f, { chainId: e });
+				return await c(m, { chainId: e });
 			} catch (e) {
 				throw new t("config", "NO_WALLET_CONNECTED", "No connected wallet. Connect a wallet before sending transactions.", { cause: e instanceof Error ? e : void 0 });
 			}
 		})
 	}), [
-		l,
-		u,
 		d,
-		f
+		g,
+		p,
+		m
 	]);
-	return /* @__PURE__ */ s(e.Provider, {
-		value: p,
-		children: c
+	return /* @__PURE__ */ l(e.Provider, {
+		value: _,
+		children: u
 	});
 }
 //#endregion
-export { c as SymmioProvider };
+export { u as SymmioProvider };
 
 //# sourceMappingURL=symmio-provider.js.map

package/dist/provider/symmio-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"symmio-provider.js","names":[],"sources":["../../src/provider/symmio-provider.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  createConfig,\n  SymmError,\n  type Config,\n  type CreateConfigParameters,\n  type GetWalletClientFn,\n} from \"@symmio/trading-core\";\nimport { useMemo, type ReactNode } from \"react\";\nimport type { PublicClient } from \"viem\";\nimport { useConfig } from \"wagmi\";\nimport { getPublicClient, getWalletClient } from \"wagmi/actions\";\nimport { SymmioConfigContext } from \"./symmio-config-context\";\n\n/**\n * Props for {@link SymmioProvider}.\n */\nexport interface SymmioProviderProps {\n  /** React subtree that may use SYMMIO SDK hooks. */\n  children: ReactNode;\n  /**\n   * Per-chain SYMMIO configuration, keyed by chain id — deep-merged onto the\n   * SDK's built-in defaults (addresses, subgraphs, solver, …).\n   *\n   * **Required.** Every supported chain must set a non-zero\n   * `addresses.affiliatesAddress` — your frontend's on-chain affiliate (your\n   * identity in SYMMIO on that chain), attached to every quote so the protocol\n   * attributes the trade to you and routes your fee share. Affiliate addresses\n   * are per chain (a registration on one chain is not valid on another). The\n   * provider throws `AFFILIATE_ADDRESS_REQUIRED` (via `createConfig`) for any\n   * supported chain missing it, so trades can never silently fall back to the\n   * built-in default affiliate and lose attribution.\n   */\n  symmioConfig: CreateConfigParameters[\"symmioConfig\"];\n  /** Chain used when a hook or action omits `chainId`. Defaults to the first supported chain. */\n  defaultChainId?: number;\n  /**\n   * Custom wallet-client resolver. Receives `{ chainId, from? }` from the SDK\n   * and returns the wallet client to sign with. Use this to plug in\n   * session-key, multi-signer, or any non-wagmi flow — the resolver decides.\n   *\n   * When omitted, the provider falls back to wagmi's connected wallet (ignores\n   * `from`).\n   */\n  getWalletClient?: GetWalletClientFn;\n}\n\n/**\n * Provides the SYMMIO {@link Config} to descendant hooks. The config's viem\n * clients are resolved from the host's wagmi config, so this is the only place\n * the SDK touches wagmi.\n *\n * **Mount order matters**: this reads wagmi context and (transitively) the\n * host's `@tanstack/react-query` `QueryClient`. Both must be mounted **outside**\n * `SymmioProvider`:\n *\n * ```tsx\n * <WagmiProvider config={wagmiConfig}>\n *   <QueryClientProvider client={queryClient}>\n *     <SymmioProvider symmioConfig={{ [SymmioSupportedChainId.HYPER_EVM]: { addresses: { affiliatesAddress: \"0x…\" } } }}>\n *       <App />\n *     </SymmioProvider>\n *   </QueryClientProvider>\n * </WagmiProvider>\n * ```\n *\n * The SDK never mounts wagmi or a `QueryClient` for the host — those (which\n * connectors, which RPC URLs, which shared `QueryClient`) belong to the host.\n */\nexport function SymmioProvider({\n  children,\n  symmioConfig,\n  defaultChainId,\n  getWalletClient: getWalletClientProp,\n}: SymmioProviderProps) {\n  const wagmiConfig = useConfig();\n\n  const config = useMemo<Config>(\n    () =>\n      createConfig({\n        symmioConfig,\n        defaultChainId,\n        getClient: ({ chainId } = {}): PublicClient => {\n          const client = getPublicClient(wagmiConfig, { chainId });\n\n          if (!client)\n            throw new SymmError(\n              \"config\",\n              \"NO_PUBLIC_CLIENT\",\n              `No public client available for chain ${chainId ?? \"(default)\"}.`,\n            );\n          return client;\n        },\n        getWalletClient:\n          getWalletClientProp ??\n          (async ({ chainId }) => {\n            try {\n              return await getWalletClient(wagmiConfig, { chainId });\n            } catch (err) {\n              throw new SymmError(\n                \"config\",\n                \"NO_WALLET_CONNECTED\",\n                \"No connected wallet. Connect a wallet before sending transactions.\",\n                { cause: err instanceof Error ? err : undefined },\n              );\n            }\n          }),\n      }),\n    [symmioConfig, defaultChainId, getWalletClientProp, wagmiConfig],\n  );\n\n  return <SymmioConfigContext.Provider value={config}>{children}</SymmioConfigContext.Provider>;\n}\n"],"mappings":";;;;;;;;AAsEA,SAAgB,EAAe,EAC7B,aACA,iBACA,mBACA,iBAAiB,KACK;CACtB,IAAM,IAAc,EAAU,GAExB,IAAS,QAEX,EAAa;EACX;EACA;EACA,YAAY,EAAE,eAAY,CAAC,MAAoB;GAC7C,IAAM,IAAS,EAAgB,GAAa,EAAE,WAAQ,CAAC;GAEvD,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,oBACA,wCAAwC,KAAW,YAAY,EACjE;GACF,OAAO;EACT;EACA,iBACE,MACC,OAAO,EAAE,iBAAc;GACtB,IAAI;IACF,OAAO,MAAM,EAAgB,GAAa,EAAE,WAAQ,CAAC;GACvD,SAAS,GAAK;IACZ,MAAM,IAAI,EACR,UACA,uBACA,sEACA,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;GACF;EACF;CACJ,CAAC,GACH;EAAC;EAAc;EAAgB;EAAqB;CAAW,CACjE;CAEA,OAAO,kBAAC,EAAoB,UAArB;EAA8B,OAAO;EAAS;CAAuC,CAAA;AAC9F"}
+{"version":3,"file":"symmio-provider.js","names":[],"sources":["../../src/provider/symmio-provider.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  createConfig,\n  listSupportedChains,\n  SymmError,\n  type Config,\n  type CreateConfigParameters,\n  type GetWalletClientFn,\n} from \"@symmio/trading-core\";\nimport { useMemo, type ReactNode } from \"react\";\nimport type { PublicClient } from \"viem\";\nimport { useChainId, useConfig } from \"wagmi\";\nimport { getPublicClient, getWalletClient } from \"wagmi/actions\";\nimport { SymmioConfigContext } from \"./symmio-config-context\";\n\n/**\n * Props for {@link SymmioProvider}.\n */\nexport interface SymmioProviderProps {\n  /** React subtree that may use SYMMIO SDK hooks. */\n  children: ReactNode;\n  /**\n   * Per-chain SYMMIO configuration, keyed by chain id — deep-merged onto the\n   * SDK's built-in defaults (addresses, subgraphs, solver, …).\n   *\n   * **Required.** Every supported chain must set a non-zero\n   * `addresses.affiliatesAddress` — your frontend's on-chain affiliate (your\n   * identity in SYMMIO on that chain), attached to every quote so the protocol\n   * attributes the trade to you and routes your fee share. Affiliate addresses\n   * are per chain (a registration on one chain is not valid on another). The\n   * provider throws `AFFILIATE_ADDRESS_REQUIRED` (via `createConfig`) for any\n   * supported chain missing it, so trades can never silently fall back to the\n   * built-in default affiliate and lose attribution.\n   */\n  symmioConfig: CreateConfigParameters[\"symmioConfig\"];\n  /**\n   * Fallback chain used when a hook or action omits `chainId` **and** the\n   * connected wallet is not on a supported SYMMIO chain (or is disconnected).\n   * When the wallet *is* on a supported chain, that chain becomes the default\n   * instead — so a no-arg `config.getChainConfig()` always follows the active\n   * chain. Defaults to the SDK's first supported chain.\n   */\n  defaultChainId?: number;\n  /**\n   * Custom wallet-client resolver. Receives `{ chainId, from? }` from the SDK\n   * and returns the wallet client to sign with. Use this to plug in\n   * session-key, multi-signer, or any non-wagmi flow — the resolver decides.\n   *\n   * When omitted, the provider falls back to wagmi's connected wallet (ignores\n   * `from`).\n   */\n  getWalletClient?: GetWalletClientFn;\n}\n\n/**\n * Provides the SYMMIO {@link Config} to descendant hooks. The config's viem\n * clients are resolved from the host's wagmi config, so this is the only place\n * the SDK touches wagmi.\n *\n * **Mount order matters**: this reads wagmi context and (transitively) the\n * host's `@tanstack/react-query` `QueryClient`. Both must be mounted **outside**\n * `SymmioProvider`:\n *\n * ```tsx\n * <WagmiProvider config={wagmiConfig}>\n *   <QueryClientProvider client={queryClient}>\n *     <SymmioProvider symmioConfig={{ [SymmioSupportedChainId.ARBITRUM]: { addresses: { affiliatesAddress: \"0x…\" } } }}>\n *       <App />\n *     </SymmioProvider>\n *   </QueryClientProvider>\n * </WagmiProvider>\n * ```\n *\n * The SDK never mounts wagmi or a `QueryClient` for the host — those (which\n * connectors, which RPC URLs, which shared `QueryClient`) belong to the host.\n */\nexport function SymmioProvider({\n  children,\n  symmioConfig,\n  defaultChainId,\n  getWalletClient: getWalletClientProp,\n}: SymmioProviderProps) {\n  const wagmiConfig = useConfig();\n  const connectedChainId = useChainId();\n\n  // Track the connected wallet's chain as the config default whenever it is a\n  // supported SYMMIO chain, so a no-arg `config.getChainConfig()` — and any hook\n  // that omits `chainId` — resolves to the ACTIVE chain rather than a hardcoded\n  // first chain. Single fix for the whole class of \"reads the wrong chain's\n  // addresses after switching\". Falls back to the explicit `defaultChainId` prop\n  // (then the SDK's first supported chain) when the wallet is on an unsupported\n  // chain or disconnected.\n  const effectiveDefaultChainId = listSupportedChains().some((id) => id === connectedChainId)\n    ? connectedChainId\n    : defaultChainId;\n\n  const config = useMemo<Config>(\n    () =>\n      createConfig({\n        symmioConfig,\n        defaultChainId: effectiveDefaultChainId,\n        getClient: ({ chainId } = {}): PublicClient => {\n          const client = getPublicClient(wagmiConfig, { chainId });\n\n          if (!client)\n            throw new SymmError(\n              \"config\",\n              \"NO_PUBLIC_CLIENT\",\n              `No public client available for chain ${chainId ?? \"(default)\"}.`,\n            );\n          return client;\n        },\n        getWalletClient:\n          getWalletClientProp ??\n          (async ({ chainId }) => {\n            try {\n              return await getWalletClient(wagmiConfig, { chainId });\n            } catch (err) {\n              throw new SymmError(\n                \"config\",\n                \"NO_WALLET_CONNECTED\",\n                \"No connected wallet. Connect a wallet before sending transactions.\",\n                { cause: err instanceof Error ? err : undefined },\n              );\n            }\n          }),\n      }),\n    [symmioConfig, effectiveDefaultChainId, getWalletClientProp, wagmiConfig],\n  );\n\n  return <SymmioConfigContext.Provider value={config}>{children}</SymmioConfigContext.Provider>;\n}\n"],"mappings":";;;;;;;;AA6EA,SAAgB,EAAe,EAC7B,aACA,iBACA,mBACA,iBAAiB,KACK;CACtB,IAAM,IAAc,EAAU,GACxB,IAAmB,EAAW,GAS9B,IAA0B,EAAoB,EAAE,MAAM,MAAO,MAAO,CAAgB,IACtF,IACA,GAEE,IAAS,QAEX,EAAa;EACX;EACA,gBAAgB;EAChB,YAAY,EAAE,eAAY,CAAC,MAAoB;GAC7C,IAAM,IAAS,EAAgB,GAAa,EAAE,WAAQ,CAAC;GAEvD,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,oBACA,wCAAwC,KAAW,YAAY,EACjE;GACF,OAAO;EACT;EACA,iBACE,MACC,OAAO,EAAE,iBAAc;GACtB,IAAI;IACF,OAAO,MAAM,EAAgB,GAAa,EAAE,WAAQ,CAAC;GACvD,SAAS,GAAK;IACZ,MAAM,IAAI,EACR,UACA,uBACA,sEACA,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;GACF;EACF;CACJ,CAAC,GACH;EAAC;EAAc;EAAyB;EAAqB;CAAW,CAC1E;CAEA,OAAO,kBAAC,EAAoB,UAArB;EAA8B,OAAO;EAAS;CAAuC,CAAA;AAC9F"}

package/dist/quotes/confirm-hold.d.ts

@@ -0,0 +1,121 @@
+import { UnifiedQuote } from '@symmio/trading-core';
+/**
+ * Next interval (ms) for a confirm-hold backoff: double the current delay, capped
+ * at `max`. After the immediate refetch the schedule is `first`, `first * 2`, … up to
+ * `max`, then steady at `max` until the hold is released.
+ *
+ * @param current - the current backoff interval (ms).
+ * @param max - the ceiling interval (ms).
+ */
+export declare function nextConfirmDelay(current: number, max: number): number;
+/**
+ * One close-confirm hold entry: its deadline (ms epoch) plus the `closedAmount`
+ * the position had **when the fill was seen**. The chase (and the row's
+ * `WRITE_ONCHAIN_CLOSE` retention) releases the moment the on-chain `closedAmount`
+ * advances past this baseline — a **partial** settle back to a live position —
+ * the same as a full settle (row removed) or a `CLOSE_PENDING` status.
+ */
+export interface CloseConfirmEntry {
+    deadline: number;
+    baseClosed: bigint;
+}
+/**
+ * Whether the chain has acknowledged a close for a quote that is **still present**
+ * in the active set. Releases the close-confirm hold when the on-chain status
+ * reflects the pending close (`quoteStatus` `CLOSE_PENDING` / `CANCEL_CLOSE_PENDING`),
+ * the quote is terminally `CLOSED`, or `closedAmount` caught up to the full
+ * `quantity`. A quote that dropped out of the active set entirely (a full close)
+ * is handled by the caller, not here.
+ */
+export declare function isCloseConfirmedOnchain(quote: UnifiedQuote): boolean;
+/**
+ * Prune the close-confirm hold **in place** against the current active quotes.
+ *
+ * The hold keeps the managed-quotes on-chain reads accelerated after a close
+ * notification until the chain reflects the close — it exists because a rasa
+ * instant-close reports `FillMarketOrderInstantClose` while the on-chain read
+ * still shows the quote OPENED, and the stateless reconcile would otherwise revert
+ * the row to `ONCHAIN` and stop the accelerated poll before the settle lands.
+ *
+ * Deletes an entry when the chain confirms the close — the row dropped from the
+ * active set (full close), or {@link isCloseConfirmedOnchain} for a still-present
+ * row — or when its deadline has passed. Returns the ids dropped **only** because
+ * their deadline expired without confirmation (a close that never settled), so the
+ * caller can surface them; confirmed and absent entries are not returned.
+ *
+ * @param pending - map of on-chain quoteId → deadline (ms epoch); mutated in place.
+ * @param quotes - the current reconciled active quotes.
+ * @param now - current time (ms epoch), e.g. `Date.now()`.
+ * @returns the quoteIds dropped due to an expired deadline.
+ */
+export declare function pruneCloseConfirmHold(pending: Map<string, CloseConfirmEntry>, quotes: readonly UnifiedQuote[], now: number): string[];
+/**
+ * Whether the on-chain read has caught up with an anchored open: the row carries
+ * the polled struct (`raw.onchain`), so `getPartyAOpenPositions` /
+ * `getPartyAPendingQuotes` have actually returned the quote. A row that exists only
+ * because a notification anchored it (`WRITE_ONCHAIN`, or a retained anchor) is
+ * **not** confirmed — that row is precisely what the hold is waiting to replace.
+ */
+export declare function isOpenConfirmedOnchain(quote: UnifiedQuote): boolean;
+/**
+ * Prune the open-confirm hold **in place** against the current active quotes.
+ *
+ * The hold chases the on-chain reads after an open-anchor notification
+ * (`SendQuoteTransaction` / `SendQuote` / `FillLimitOrderOpen`) until the read
+ * returns the quote. The solver emits that frame when it **broadcasts** the
+ * transaction, so the single invalidation it triggers races the block and usually
+ * loses; without the chase the position stays invisible until something else
+ * happens to refetch, because with the notifications socket live there is no idle
+ * poll and the accelerated retry only runs while a `WRITE_ONCHAIN` row exists —
+ * which requires a pre-chain row from the hedger feed that may already be gone.
+ *
+ * Mirror of {@link pruneCloseConfirmHold} with one deliberate difference: for a
+ * close, a row **absent** from the active set means the close landed; for an open,
+ * absence is the very condition being chased, so it keeps the entry.
+ *
+ * @param pending - map of on-chain quoteId → deadline (ms epoch); mutated in place.
+ * @param quotes - the current reconciled active quotes.
+ * @param now - current time (ms epoch), e.g. `Date.now()`.
+ * @returns the quoteIds dropped due to an expired deadline (an anchor the read never confirmed).
+ */
+export declare function pruneOpenConfirmHold(pending: Map<string, number>, quotes: readonly UnifiedQuote[], now: number): string[];
+/**
+ * Whether the chain has settled a cancel for a quote that is **still present** in the
+ * active set — only the terminal `CLOSED` lifecycle counts (`CANCELED` / `EXPIRED` /
+ * `CLOSED` on-chain). A quote that dropped out of the active set entirely is the
+ * normal outcome and is handled by the caller.
+ *
+ * Deliberately **not** released on `quoteStatus !== CANCEL_PENDING`: the hold is
+ * registered off the cancel-request notification, which the solver publishes around
+ * the time the request transaction is broadcast, so the read at that moment usually
+ * still says `LOCKED`. Releasing on "not CANCEL_PENDING" would end the chase on that
+ * stale pre-request read and leave the row stuck exactly as before. Holding through
+ * `LOCKED` → `CANCEL_PENDING` → gone is the point.
+ */
+export declare function isCancelConfirmedOnchain(quote: UnifiedQuote): boolean;
+/**
+ * Prune the cancel-confirm hold **in place** against the current active quotes.
+ *
+ * The hold chases the on-chain reads after a cancel notification until the chain
+ * settles the cancel. It exists because cancelling a `LOCKED` order is a
+ * **two-transaction** flow of which only the first is announced:
+ * `requestToCancelQuote` moves the quote to `CANCEL_PENDING` and leaves it in
+ * `partyAPendingQuotes`, and the solver's later `acceptCancelRequest` — the one that
+ * sets `CANCELED` and removes it — publishes no notification frame at all. With the
+ * event channel live there is no idle poll and a `CANCEL_PENDING` row does not
+ * accelerate anything (its lifecycle is the generic `ONCHAIN`), so without this chase
+ * a cancelled order stays on screen until something unrelated happens to refetch.
+ *
+ * Same shape as {@link pruneCloseConfirmHold}: an entry whose row is **absent** from
+ * the active set is confirmed (the accept removed it from the pending array), as is
+ * one whose row went terminal ({@link isCancelConfirmedOnchain}). Returns the ids
+ * dropped **only** because their deadline passed — a cancel the solver never answered
+ * — so the caller can surface them.
+ *
+ * @param pending - map of on-chain quoteId → deadline (ms epoch); mutated in place.
+ * @param quotes - the current reconciled active quotes.
+ * @param now - current time (ms epoch), e.g. `Date.now()`.
+ * @returns the quoteIds dropped due to an expired deadline.
+ */
+export declare function pruneCancelConfirmHold(pending: Map<string, number>, quotes: readonly UnifiedQuote[], now: number): string[];
+//# sourceMappingURL=confirm-hold.d.ts.map

package/dist/quotes/confirm-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-hold.d.ts","sourceRoot":"","sources":["../../src/quotes/confirm-hold.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEtF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAOpE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACvC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAkBV;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAEnE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAeV;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAErE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,EAAE,CAeV"}

package/dist/quotes/confirm-hold.js

@@ -0,0 +1,59 @@
+import { QuoteLifecycle as e, QuoteStatus as t } from "@symmio/trading-core";
+//#region src/quotes/confirm-hold.ts
+function n(e, t) {
+	return Math.min(e * 2, t);
+}
+function r(n) {
+	if (n.lifecycle === e.CLOSED || n.quoteStatus === t.CLOSE_PENDING || n.quoteStatus === t.CANCEL_CLOSE_PENDING) return !0;
+	let r = n.closedAmount ?? 0n;
+	return n.quantity > 0n && r >= n.quantity;
+}
+function i(e, t, n) {
+	if (e.size === 0) return [];
+	let i = [];
+	for (let [a, { deadline: o, baseClosed: s }] of e) {
+		let c = t.find((e) => `${e.quoteId}` === a);
+		if (!c || r(c) || (c.closedAmount ?? 0n) > s) {
+			e.delete(a);
+			continue;
+		}
+		n > o && (e.delete(a), i.push(a));
+	}
+	return i;
+}
+function a(e) {
+	return e.raw.onchain !== void 0;
+}
+function o(e, t, n) {
+	if (e.size === 0) return [];
+	let r = [];
+	for (let [i, o] of e) {
+		let s = t.find((e) => `${e.quoteId}` === i);
+		if (s && a(s)) {
+			e.delete(i);
+			continue;
+		}
+		n > o && (e.delete(i), r.push(i));
+	}
+	return r;
+}
+function s(t) {
+	return t.lifecycle === e.CLOSED;
+}
+function c(e, t, n) {
+	if (e.size === 0) return [];
+	let r = [];
+	for (let [i, a] of e) {
+		let o = t.find((e) => `${e.quoteId}` === i);
+		if (!o || s(o)) {
+			e.delete(i);
+			continue;
+		}
+		n > a && (e.delete(i), r.push(i));
+	}
+	return r;
+}
+//#endregion
+export { n as nextConfirmDelay, c as pruneCancelConfirmHold, i as pruneCloseConfirmHold, o as pruneOpenConfirmHold };
+
+//# sourceMappingURL=confirm-hold.js.map