@symmio/trading-core 1.0.1 → 2.0.0

package/dist/price-service/adapters/enigma-mark-prices.d.ts

@@ -0,0 +1,44 @@
+import { PriceData } from '../enigma/types/generated/enigma-price-service.js';
+import { EnigmaMarkPriceTick } from '../types.js';
+/**
+ * Map one Enigma price record onto the normalized tick.
+ *
+ * **`name` comes from the response's record KEY, never from `value.name`.**
+ * The existing `resolveMarkPrice` looks its result up by key, and `PriceData`
+ * carries its own `name` field that can differ — `"::"`-suffixed lowcap names
+ * are exactly where the two diverge. Mapping from `value.name` would silently
+ * break every lowcap instant-open, so the key is authoritative here.
+ *
+ * `markPrice` arrives as a JSON number and is stringified without reformatting,
+ * preserving the exact value the previous implementation produced.
+ *
+ * @internal
+ */
+export declare function toEnigmaMarkPriceTick(key: string, value: PriceData): EnigmaMarkPriceTick;
+/**
+ * Map an Enigma `name → PriceData` response onto normalized ticks.
+ *
+ * @internal
+ */
+export declare function toEnigmaMarkPrices(record: Record<string, PriceData>): EnigmaMarkPriceTick[];
+/**
+ * Fetch and normalize Enigma mark prices — the provider's whole fetch story for
+ * this endpoint.
+ *
+ * With `names`, hits the batch-by-names route with the identical wire call the
+ * shipped `getEnigmaPriceServicePricesByNames` makes, so the Enigma path is
+ * behaviourally unchanged. Without, reads every price the service serves.
+ *
+ * When `names` is supplied, each matched tick carries the caller's exact
+ * spelling so `ticks.find(t => t.name === yourName)` always hits.
+ *
+ * Both routes the SDK needs here are marked `@deprecated` by the vendor, and
+ * both are used deliberately: the non-deprecated `/api/v1/prices` is keyed by
+ * token **address** and rejects a call without one (verified live: `422`
+ * `addresses Field required`), so it cannot serve a name-based lookup at all.
+ * Revisit only if Enigma ships a name-keyed replacement.
+ *
+ * @internal
+ */
+export declare function fetchEnigmaMarkPrices(baseURL: string, names?: readonly string[]): Promise<EnigmaMarkPriceTick[]>;
+//# sourceMappingURL=enigma-mark-prices.d.ts.map

package/dist/price-service/adapters/enigma-mark-prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enigma-mark-prices.d.ts","sourceRoot":"","sources":["../../../src/price-service/adapters/enigma-mark-prices.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,mBAAmB,CAOxF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,mBAAmB,EAAE,CAE3F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GACxB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoBhC"}

package/dist/price-service/adapters/enigma-mark-prices.js

@@ -0,0 +1,25 @@
+import { getPricesApiV1PriceGet as e, getSymbolPricesBatchApiV1PricesNamesGet as t } from "../enigma/types/generated/enigma-price-service.js";
+//#region src/price-service/adapters/enigma-mark-prices.ts
+function n(e, t) {
+	return {
+		provider: "enigma",
+		name: e,
+		markPrice: String(t.markPrice),
+		...t.time === void 0 ? {} : { time: t.time }
+	};
+}
+async function r(r, i) {
+	if (!i) return (await e({ baseURL: r })).data.map((e) => n(e.name, e));
+	let a = i.filter((e) => e.trim().length > 0);
+	if (a.length === 0) return [];
+	let o = (await t(a.join(","), { baseURL: r })).data, s = [];
+	for (let e of a) {
+		let t = o[e];
+		t && s.push(n(e, t));
+	}
+	return s;
+}
+//#endregion
+export { r as fetchEnigmaMarkPrices };
+
+//# sourceMappingURL=enigma-mark-prices.js.map

package/dist/price-service/adapters/enigma-mark-prices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enigma-mark-prices.js","names":[],"sources":["../../../src/price-service/adapters/enigma-mark-prices.ts"],"sourcesContent":["import {\n  getPricesApiV1PriceGet,\n  getSymbolPricesBatchApiV1PricesNamesGet,\n  type PriceData,\n} from \"../enigma/types/generated/enigma-price-service\";\nimport type { EnigmaMarkPriceTick } from \"../types\";\n\n/**\n * Map one Enigma price record onto the normalized tick.\n *\n * **`name` comes from the response's record KEY, never from `value.name`.**\n * The existing `resolveMarkPrice` looks its result up by key, and `PriceData`\n * carries its own `name` field that can differ — `\"::\"`-suffixed lowcap names\n * are exactly where the two diverge. Mapping from `value.name` would silently\n * break every lowcap instant-open, so the key is authoritative here.\n *\n * `markPrice` arrives as a JSON number and is stringified without reformatting,\n * preserving the exact value the previous implementation produced.\n *\n * @internal\n */\nexport function toEnigmaMarkPriceTick(key: string, value: PriceData): EnigmaMarkPriceTick {\n  return {\n    provider: \"enigma\",\n    name: key,\n    markPrice: String(value.markPrice),\n    ...(value.time !== undefined ? { time: value.time } : {}),\n  };\n}\n\n/**\n * Map an Enigma `name → PriceData` response onto normalized ticks.\n *\n * @internal\n */\nexport function toEnigmaMarkPrices(record: Record<string, PriceData>): EnigmaMarkPriceTick[] {\n  return Object.entries(record).map(([key, value]) => toEnigmaMarkPriceTick(key, value));\n}\n\n/**\n * Fetch and normalize Enigma mark prices — the provider's whole fetch story for\n * this endpoint.\n *\n * With `names`, hits the batch-by-names route with the identical wire call the\n * shipped `getEnigmaPriceServicePricesByNames` makes, so the Enigma path is\n * behaviourally unchanged. Without, reads every price the service serves.\n *\n * When `names` is supplied, each matched tick carries the caller's exact\n * spelling so `ticks.find(t => t.name === yourName)` always hits.\n *\n * Both routes the SDK needs here are marked `@deprecated` by the vendor, and\n * both are used deliberately: the non-deprecated `/api/v1/prices` is keyed by\n * token **address** and rejects a call without one (verified live: `422`\n * `addresses Field required`), so it cannot serve a name-based lookup at all.\n * Revisit only if Enigma ships a name-keyed replacement.\n *\n * @internal\n */\nexport async function fetchEnigmaMarkPrices(\n  baseURL: string,\n  names?: readonly string[],\n): Promise<EnigmaMarkPriceTick[]> {\n  if (!names) {\n    const response = await getPricesApiV1PriceGet({ baseURL });\n    // This route returns an array, not a keyed record — there is no key to be\n    // authoritative, so `name` necessarily comes off each row.\n    return response.data.map((value) => toEnigmaMarkPriceTick(value.name, value));\n  }\n\n  const requested = names.filter((name) => name.trim().length > 0);\n  if (requested.length === 0) return [];\n\n  const response = await getSymbolPricesBatchApiV1PricesNamesGet(requested.join(\",\"), { baseURL });\n  const record = response.data;\n\n  const ticks: EnigmaMarkPriceTick[] = [];\n  for (const name of requested) {\n    const value = record[name];\n    if (value) ticks.push(toEnigmaMarkPriceTick(name, value));\n  }\n  return ticks;\n}\n"],"mappings":";;AAqBA,SAAgB,EAAsB,GAAa,GAAuC;CACxF,OAAO;EACL,UAAU;EACV,MAAM;EACN,WAAW,OAAO,EAAM,SAAS;EACjC,GAAI,EAAM,SAAS,KAAA,IAAmC,CAAC,IAAxB,EAAE,MAAM,EAAM,KAAK;CACpD;AACF;AA8BA,eAAsB,EACpB,GACA,GACgC;CAChC,IAAI,CAAC,GAIH,QAAO,MAHgB,EAAuB,EAAE,WAAQ,CAAC,GAGzC,KAAK,KAAK,MAAU,EAAsB,EAAM,MAAM,CAAK,CAAC;CAG9E,IAAM,IAAY,EAAM,QAAQ,MAAS,EAAK,KAAK,EAAE,SAAS,CAAC;CAC/D,IAAI,EAAU,WAAW,GAAG,OAAO,CAAC;CAGpC,IAAM,KAAS,MADQ,EAAwC,EAAU,KAAK,GAAG,GAAG,EAAE,WAAQ,CAAC,GACvE,MAElB,IAA+B,CAAC;CACtC,KAAK,IAAM,KAAQ,GAAW;EAC5B,IAAM,IAAQ,EAAO;EACrB,AAAI,KAAO,EAAM,KAAK,EAAsB,GAAM,CAAK,CAAC;CAC1D;CACA,OAAO;AACT"}

package/dist/price-service/adapters/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Per-provider price adapters. `@internal` — deliberately NOT re-exported from
+ * `src/price-service/index.ts` or the package root, so raw vendor shapes stay
+ * inside the SDK (AGENTS.md, per-kind divergence doctrine, step 5).
+ */
+export * from './binance-mark-prices.js';
+export * from './enigma-mark-prices.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/price-service/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/price-service/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/price-service/assert-price-service-provider.d.ts

@@ -0,0 +1,19 @@
+import { SymmioPriceServiceConfig, SymmioPriceServiceType } from '../core/chains/types.js';
+/**
+ * Throw when the resolved price service cannot serve a provider-exclusive
+ * action — the price-axis mirror of `assertSolverKind`.
+ *
+ * Without it, a provider-specific action reaching the wrong host either 404s
+ * with a confusing vendor message or, for the WebSocket watchers, fails
+ * *silently*: the socket connects, the other provider's frames parse to nothing,
+ * and the feed reports `open` while delivering zero ticks forever.
+ *
+ * @param priceService - The resolved price service (see `resolvePriceService`).
+ * @param type - The provider this action requires.
+ * @param action - Action name, for the error message.
+ * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the provider differs.
+ *
+ * @internal
+ */
+export declare function assertPriceServiceProvider(priceService: SymmioPriceServiceConfig, type: SymmioPriceServiceType, action: string): void;
+//# sourceMappingURL=assert-price-service-provider.d.ts.map

package/dist/price-service/assert-price-service-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-price-service-provider.d.ts","sourceRoot":"","sources":["../../src/price-service/assert-price-service-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG7F;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,wBAAwB,EACtC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,MAAM,GACb,IAAI,CAQN"}

package/dist/price-service/assert-price-service-provider.js

@@ -0,0 +1,9 @@
+import { SymmError as e } from "../shared/errors/symm-error.js";
+//#region src/price-service/assert-price-service-provider.ts
+function t(t, n, r) {
+	if (t.type !== n) throw new e("config", "UNSUPPORTED_BY_PRICE_SERVICE", `${r}: the resolved price service is "${t.type}", but this action requires a "${n}" price service.`);
+}
+//#endregion
+export { t as assertPriceServiceProvider };
+
+//# sourceMappingURL=assert-price-service-provider.js.map

package/dist/price-service/assert-price-service-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-price-service-provider.js","names":[],"sources":["../../src/price-service/assert-price-service-provider.ts"],"sourcesContent":["import type { SymmioPriceServiceConfig, SymmioPriceServiceType } from \"../core/chains/types\";\nimport { SymmError } from \"../shared/errors/symm-error\";\n\n/**\n * Throw when the resolved price service cannot serve a provider-exclusive\n * action — the price-axis mirror of `assertSolverKind`.\n *\n * Without it, a provider-specific action reaching the wrong host either 404s\n * with a confusing vendor message or, for the WebSocket watchers, fails\n * *silently*: the socket connects, the other provider's frames parse to nothing,\n * and the feed reports `open` while delivering zero ticks forever.\n *\n * @param priceService - The resolved price service (see `resolvePriceService`).\n * @param type - The provider this action requires.\n * @param action - Action name, for the error message.\n * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the provider differs.\n *\n * @internal\n */\nexport function assertPriceServiceProvider(\n  priceService: SymmioPriceServiceConfig,\n  type: SymmioPriceServiceType,\n  action: string,\n): void {\n  if (priceService.type !== type) {\n    throw new SymmError(\n      \"config\",\n      \"UNSUPPORTED_BY_PRICE_SERVICE\",\n      `${action}: the resolved price service is \"${priceService.type}\", but this action requires a \"${type}\" price service.`,\n    );\n  }\n}\n"],"mappings":";;AAmBA,SAAgB,EACd,GACA,GACA,GACM;CACN,IAAI,EAAa,SAAS,GACxB,MAAM,IAAI,EACR,UACA,gCACA,GAAG,EAAO,mCAAmC,EAAa,KAAK,iCAAiC,EAAK,iBACvG;AAEJ"}

package/dist/price-service/binance/client.d.ts

@@ -0,0 +1,37 @@
+import { RawBinanceExchangeInfo, RawBinancePremiumIndexRow } from './types.js';
+/**
+ * Fetch `premiumIndex` for **every** listed symbol.
+ *
+ * Measured request weight: **10**. Prefer {@link fetchBinancePremiumIndexOne}
+ * when a single symbol is needed — that form costs weight 1.
+ *
+ * @internal
+ */
+export declare function fetchBinancePremiumIndexAll(baseURL: string): Promise<RawBinancePremiumIndexRow[]>;
+/**
+ * Fetch `premiumIndex` for a single symbol — measured request weight **1**.
+ *
+ * An unknown symbol makes Binance reply `400`; that is reported as an absent
+ * price (`null`) rather than a transport failure, so an unlisted market reads
+ * the same as one the provider simply does not carry. Any other status
+ * propagates.
+ *
+ * @internal
+ */
+export declare function fetchBinancePremiumIndexOne(baseURL: string, symbol: string): Promise<RawBinancePremiumIndexRow | null>;
+/**
+ * Probe Binance liveness (`GET /fapi/v1/ping`). Resolves `true` on success.
+ *
+ * @internal
+ */
+export declare function fetchBinancePing(baseURL: string): Promise<true>;
+/**
+ * Fetch Binance exchange metadata (`GET /fapi/v1/exchangeInfo`).
+ *
+ * Cheap on request weight (1) but a **~1 MB** payload, so callers must cache it
+ * aggressively and never poll it.
+ *
+ * @internal
+ */
+export declare function fetchBinanceExchangeInfo(baseURL: string): Promise<RawBinanceExchangeInfo>;
+//# sourceMappingURL=client.d.ts.map

package/dist/price-service/binance/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/price-service/binance/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAwBjF;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAGvG;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAW3C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAG/F"}

package/dist/price-service/binance/client.js

@@ -0,0 +1,30 @@
+import e, { isAxiosError as t } from "axios";
+//#region src/price-service/binance/client.ts
+var n = "/fapi/v1/premiumIndex", r = "/fapi/v1/ping", i = "/fapi/v1/exchangeInfo";
+function a(e) {
+	return Array.isArray(e) ? e : [e];
+}
+async function o(t) {
+	return a((await e.get(n, { baseURL: t })).data);
+}
+async function s(r, i) {
+	try {
+		return a((await e.get(n, {
+			baseURL: r,
+			params: { symbol: i }
+		})).data)[0] ?? null;
+	} catch (e) {
+		if (t(e) && e.response?.status === 400) return null;
+		throw e;
+	}
+}
+async function c(t) {
+	return await e.get(r, { baseURL: t }), !0;
+}
+async function l(t) {
+	return (await e.get(i, { baseURL: t })).data;
+}
+//#endregion
+export { l as fetchBinanceExchangeInfo, c as fetchBinancePing, o as fetchBinancePremiumIndexAll, s as fetchBinancePremiumIndexOne };
+
+//# sourceMappingURL=client.js.map

package/dist/price-service/binance/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/price-service/binance/client.ts"],"sourcesContent":["import axios, { isAxiosError } from \"axios\";\nimport type { RawBinanceExchangeInfo, RawBinancePremiumIndexRow } from \"./types\";\n\n/**\n * Path of the mark/index/funding endpoint, appended to the configured\n * `priceService.url` host root.\n *\n * @internal\n */\nconst PREMIUM_INDEX_PATH = \"/fapi/v1/premiumIndex\";\n\n/** Path of the liveness probe. @internal */\nconst PING_PATH = \"/fapi/v1/ping\";\n\n/** Path of the exchange metadata listing. @internal */\nconst EXCHANGE_INFO_PATH = \"/fapi/v1/exchangeInfo\";\n\n/**\n * Normalize `?symbol=` (single object) and all-symbols (array) responses to one\n * array, so callers have a single shape to map.\n */\nfunction toRows(data: RawBinancePremiumIndexRow | RawBinancePremiumIndexRow[]): RawBinancePremiumIndexRow[] {\n  return Array.isArray(data) ? data : [data];\n}\n\n/**\n * Fetch `premiumIndex` for **every** listed symbol.\n *\n * Measured request weight: **10**. Prefer {@link fetchBinancePremiumIndexOne}\n * when a single symbol is needed — that form costs weight 1.\n *\n * @internal\n */\nexport async function fetchBinancePremiumIndexAll(baseURL: string): Promise<RawBinancePremiumIndexRow[]> {\n  const response = await axios.get<RawBinancePremiumIndexRow[]>(PREMIUM_INDEX_PATH, { baseURL });\n  return toRows(response.data);\n}\n\n/**\n * Fetch `premiumIndex` for a single symbol — measured request weight **1**.\n *\n * An unknown symbol makes Binance reply `400`; that is reported as an absent\n * price (`null`) rather than a transport failure, so an unlisted market reads\n * the same as one the provider simply does not carry. Any other status\n * propagates.\n *\n * @internal\n */\nexport async function fetchBinancePremiumIndexOne(\n  baseURL: string,\n  symbol: string,\n): Promise<RawBinancePremiumIndexRow | null> {\n  try {\n    const response = await axios.get<RawBinancePremiumIndexRow | RawBinancePremiumIndexRow[]>(PREMIUM_INDEX_PATH, {\n      baseURL,\n      params: { symbol },\n    });\n    return toRows(response.data)[0] ?? null;\n  } catch (err) {\n    if (isAxiosError(err) && err.response?.status === 400) return null;\n    throw err;\n  }\n}\n\n/**\n * Probe Binance liveness (`GET /fapi/v1/ping`). Resolves `true` on success.\n *\n * @internal\n */\nexport async function fetchBinancePing(baseURL: string): Promise<true> {\n  await axios.get(PING_PATH, { baseURL });\n  return true;\n}\n\n/**\n * Fetch Binance exchange metadata (`GET /fapi/v1/exchangeInfo`).\n *\n * Cheap on request weight (1) but a **~1 MB** payload, so callers must cache it\n * aggressively and never poll it.\n *\n * @internal\n */\nexport async function fetchBinanceExchangeInfo(baseURL: string): Promise<RawBinanceExchangeInfo> {\n  const response = await axios.get<RawBinanceExchangeInfo>(EXCHANGE_INFO_PATH, { baseURL });\n  return response.data;\n}\n"],"mappings":";;AASA,IAAM,IAAqB,yBAGrB,IAAY,iBAGZ,IAAqB;AAM3B,SAAS,EAAO,GAA4F;CAC1G,OAAO,MAAM,QAAQ,CAAI,IAAI,IAAO,CAAC,CAAI;AAC3C;AAUA,eAAsB,EAA4B,GAAuD;CAEvG,OAAO,GAAO,MADS,EAAM,IAAiC,GAAoB,EAAE,WAAQ,CAAC,GACtE,IAAI;AAC7B;AAYA,eAAsB,EACpB,GACA,GAC2C;CAC3C,IAAI;EAKF,OAAO,GAAO,MAJS,EAAM,IAA6D,GAAoB;GAC5G;GACA,QAAQ,EAAE,UAAO;EACnB,CAAC,GACsB,IAAI,EAAE,MAAM;CACrC,SAAS,GAAK;EACZ,IAAI,EAAa,CAAG,KAAK,EAAI,UAAU,WAAW,KAAK,OAAO;EAC9D,MAAM;CACR;AACF;AAOA,eAAsB,EAAiB,GAAgC;CAErE,OADA,MAAM,EAAM,IAAI,GAAW,EAAE,WAAQ,CAAC,GAC/B;AACT;AAUA,eAAsB,EAAyB,GAAkD;CAE/F,QAAO,MADgB,EAAM,IAA4B,GAAoB,EAAE,WAAQ,CAAC,GACxE;AAClB"}

package/dist/price-service/binance/health/get-binance-health.d.ts

@@ -0,0 +1,25 @@
+import { Config } from '../../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../../shared/types/properties.js';
+/** Parameters for {@link getBinanceHealth}. */
+export type GetBinanceHealthParameters = Compute<ReadSolverParameter>;
+/** Return type of {@link getBinanceHealth}: `true` when the endpoint answered. */
+export type GetBinanceHealthReturnType = boolean;
+/**
+ * Probe Binance USD-M Futures liveness (`GET /fapi/v1/ping`).
+ *
+ * The Binance twin of `getEnigmaPriceServiceHealth`. Resolves `true` on a 2xx
+ * and **`false`** on any transport failure rather than throwing, so a health
+ * indicator renders a state instead of tripping an error boundary — unreachable
+ * *is* the answer. A misconfigured provider still throws: that is a config bug,
+ * not a health signal.
+ *
+ * Mainly useful to separate "Binance is unreachable from this client"
+ * (regional restriction, dead proxy, offline) from "this market has no price".
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain and solver.
+ * @returns `true` when the endpoint answered, `false` when it did not.
+ * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the resolved provider is not Binance.
+ */
+export declare function getBinanceHealth(config: Config, parameters?: GetBinanceHealthParameters): Promise<GetBinanceHealthReturnType>;
+//# sourceMappingURL=get-binance-health.d.ts.map

package/dist/price-service/binance/health/get-binance-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-binance-health.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/health/get-binance-health.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAKrF,+CAA+C;AAC/C,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEtE,kFAAkF;AAClF,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,0BAA+B,GAC1C,OAAO,CAAC,0BAA0B,CAAC,CAmBrC"}

package/dist/price-service/binance/health/get-binance-health.js

@@ -0,0 +1,24 @@
+import { SymmError as e } from "../../../shared/errors/symm-error.js";
+import { assertPriceServiceProvider as t } from "../../assert-price-service-provider.js";
+import { resolvePriceService as n } from "../../resolve-price-service.js";
+import { fetchBinancePing as r } from "../client.js";
+import { isAxiosError as i } from "axios";
+//#region src/price-service/binance/health/get-binance-health.ts
+async function a(a, o = {}) {
+	let s = n(a, {
+		chainId: o.chainId,
+		solverId: o.solverId
+	});
+	t(s, "binance", "getBinanceHealth");
+	try {
+		return await r(s.url);
+	} catch (t) {
+		if (t instanceof e) throw t;
+		if (i(t)) return !1;
+		throw new e("api", "FETCH_BINANCE_HEALTH_FAILED", `Failed to probe Binance health: ${t instanceof Error ? t.message : String(t)}`, { cause: t instanceof Error ? t : void 0 });
+	}
+}
+//#endregion
+export { a as getBinanceHealth };
+
+//# sourceMappingURL=get-binance-health.js.map

package/dist/price-service/binance/health/get-binance-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-binance-health.js","names":[],"sources":["../../../../src/price-service/binance/health/get-binance-health.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmError } from \"../../../shared/errors/symm-error\";\nimport type { Compute, ReadSolverParameter } from \"../../../shared/types/properties\";\nimport { assertPriceServiceProvider } from \"../../assert-price-service-provider\";\nimport { resolvePriceService } from \"../../resolve-price-service\";\nimport { fetchBinancePing } from \"../client\";\n\n/** Parameters for {@link getBinanceHealth}. */\nexport type GetBinanceHealthParameters = Compute<ReadSolverParameter>;\n\n/** Return type of {@link getBinanceHealth}: `true` when the endpoint answered. */\nexport type GetBinanceHealthReturnType = boolean;\n\n/**\n * Probe Binance USD-M Futures liveness (`GET /fapi/v1/ping`).\n *\n * The Binance twin of `getEnigmaPriceServiceHealth`. Resolves `true` on a 2xx\n * and **`false`** on any transport failure rather than throwing, so a health\n * indicator renders a state instead of tripping an error boundary — unreachable\n * *is* the answer. A misconfigured provider still throws: that is a config bug,\n * not a health signal.\n *\n * Mainly useful to separate \"Binance is unreachable from this client\"\n * (regional restriction, dead proxy, offline) from \"this market has no price\".\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain and solver.\n * @returns `true` when the endpoint answered, `false` when it did not.\n * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the resolved provider is not Binance.\n */\nexport async function getBinanceHealth(\n  config: Config,\n  parameters: GetBinanceHealthParameters = {},\n): Promise<GetBinanceHealthReturnType> {\n  const priceService = resolvePriceService(config, {\n    chainId: parameters.chainId,\n    solverId: parameters.solverId,\n  });\n  assertPriceServiceProvider(priceService, \"binance\", \"getBinanceHealth\");\n\n  try {\n    return await fetchBinancePing(priceService.url);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n    if (isAxiosError(err)) return false;\n    throw new SymmError(\n      \"api\",\n      \"FETCH_BINANCE_HEALTH_FAILED\",\n      `Failed to probe Binance health: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA+BA,eAAsB,EACpB,GACA,IAAyC,CAAC,GACL;CACrC,IAAM,IAAe,EAAoB,GAAQ;EAC/C,SAAS,EAAW;EACpB,UAAU,EAAW;CACvB,CAAC;CACD,EAA2B,GAAc,WAAW,kBAAkB;CAEtE,IAAI;EACF,OAAO,MAAM,EAAiB,EAAa,GAAG;CAChD,SAAS,GAAK;EACZ,IAAI,aAAe,GAAW,MAAM;EACpC,IAAI,EAAa,CAAG,GAAG,OAAO;EAC9B,MAAM,IAAI,EACR,OACA,+BACA,mCAAmC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAClF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/price-service/binance/health/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-binance-health.js';
+export * from './query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/price-service/binance/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/health/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC"}

package/dist/price-service/binance/health/query.d.ts

@@ -0,0 +1,17 @@
+import { Config } from '../../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../../shared/types/query.js';
+import { GetBinanceHealthParameters, GetBinanceHealthReturnType } from './get-binance-health.js';
+/** Data resolved by the {@link getBinanceHealthQueryOptions} query. */
+export type GetBinanceHealthData = GetBinanceHealthReturnType;
+/** Build the TanStack Query key for {@link getBinanceHealthQueryOptions}. */
+export declare function getBinanceHealthQueryKey(options?: Compute<GetBinanceHealthParameters & ConfigKeyParameter>): readonly ["getBinanceHealth", Record<string, unknown>];
+/** Query-key type produced by {@link getBinanceHealthQueryKey}. */
+export type GetBinanceHealthQueryKey = ReturnType<typeof getBinanceHealthQueryKey>;
+/** Options accepted by {@link getBinanceHealthQueryOptions}. */
+export type GetBinanceHealthOptions = Compute<GetBinanceHealthParameters & QueryParameter<GetBinanceHealthData, Error, GetBinanceHealthData, GetBinanceHealthQueryKey>>;
+/** TanStack Query options returned by {@link getBinanceHealthQueryOptions}. */
+export type GetBinanceHealthQueryOptions = SymmioQueryOptions<GetBinanceHealthData, Error, GetBinanceHealthData, GetBinanceHealthQueryKey>;
+/** Build TanStack Query options for {@link getBinanceHealth}. */
+export declare function getBinanceHealthQueryOptions(config: Config, options?: GetBinanceHealthOptions): GetBinanceHealthQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/price-service/binance/health/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/health/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAE9B,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAE9D,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,OAAO,CAAC,0BAA0B,GAAG,kBAAkB,CAAM,0DAE9G;AAED,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnF,gEAAgE;AAChE,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC3C,0BAA0B,GACxB,cAAc,CAAC,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,CAAC,CAC9F,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,4BAA4B,GAAG,kBAAkB,CAC3D,oBAAoB,EACpB,KAAK,EACL,oBAAoB,EACpB,wBAAwB,CACzB,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,4BAA4B,CAO9B"}

package/dist/price-service/binance/health/query.js

@@ -0,0 +1,24 @@
+import { filterQueryOptions as e } from "../../../shared/utils/query.js";
+import { getBinanceHealth as t } from "./get-binance-health.js";
+//#region src/price-service/binance/health/query.ts
+function n(t = {}) {
+	return ["getBinanceHealth", e(t)];
+}
+function r(e, r = {}) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: r.query?.enabled ?? !0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			solverId: r.solverId
+		})
+	};
+}
+//#endregion
+export { n as getBinanceHealthQueryKey, r as getBinanceHealthQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/price-service/binance/health/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../../src/price-service/binance/health/query.ts"],"sourcesContent":["import type { Config } from \"../../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../../shared/types/query\";\nimport { filterQueryOptions } from \"../../../shared/utils/query\";\nimport {\n  getBinanceHealth,\n  type GetBinanceHealthParameters,\n  type GetBinanceHealthReturnType,\n} from \"./get-binance-health\";\n\n/** Data resolved by the {@link getBinanceHealthQueryOptions} query. */\nexport type GetBinanceHealthData = GetBinanceHealthReturnType;\n\n/** Build the TanStack Query key for {@link getBinanceHealthQueryOptions}. */\nexport function getBinanceHealthQueryKey(options: Compute<GetBinanceHealthParameters & ConfigKeyParameter> = {}) {\n  return [\"getBinanceHealth\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getBinanceHealthQueryKey}. */\nexport type GetBinanceHealthQueryKey = ReturnType<typeof getBinanceHealthQueryKey>;\n\n/** Options accepted by {@link getBinanceHealthQueryOptions}. */\nexport type GetBinanceHealthOptions = Compute<\n  GetBinanceHealthParameters &\n    QueryParameter<GetBinanceHealthData, Error, GetBinanceHealthData, GetBinanceHealthQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getBinanceHealthQueryOptions}. */\nexport type GetBinanceHealthQueryOptions = SymmioQueryOptions<\n  GetBinanceHealthData,\n  Error,\n  GetBinanceHealthData,\n  GetBinanceHealthQueryKey\n>;\n\n/** Build TanStack Query options for {@link getBinanceHealth}. */\nexport function getBinanceHealthQueryOptions(\n  config: Config,\n  options: GetBinanceHealthOptions = {},\n): GetBinanceHealthQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getBinanceHealthQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getBinanceHealth(config, { chainId: options.chainId, solverId: options.solverId }),\n  };\n}\n"],"mappings":";;;AAcA,SAAgB,EAAyB,IAAoE,CAAC,GAAG;CAC/G,OAAO,CAAC,oBAAoB,EAAmB,CAAO,CAAC;AACzD;AAoBA,SAAgB,EACd,GACA,IAAmC,CAAC,GACN;CAC9B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAyB;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EACvG,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAiB,GAAQ;GAAE,SAAS,EAAQ;GAAS,UAAU,EAAQ;EAAS,CAAC;CAClG;AACF"}

package/dist/price-service/binance/index.d.ts

@@ -0,0 +1,5 @@
+export * from './health/index.js';
+export * from './premium-index/index.js';
+export * from './symbols-info/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/price-service/binance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/price-service/binance/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

package/dist/price-service/binance/premium-index/get-binance-premium-index.d.ts

@@ -0,0 +1,39 @@
+import { Config } from '../../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../../shared/types/properties.js';
+import { BinanceMarkPriceTick } from '../../types.js';
+/**
+ * Parameters for {@link getBinancePremiumIndex}.
+ */
+export type GetBinancePremiumIndexParameters = Compute<ReadSolverParameter & {
+    /** Market names to price. Omit to read every symbol Binance lists. */
+    names?: readonly string[];
+}>;
+/** Return type of {@link getBinancePremiumIndex}. */
+export type GetBinancePremiumIndexReturnType = BinanceMarkPriceTick[];
+/**
+ * Read Binance USD-M Futures `GET /fapi/v1/premiumIndex` — mark price, index
+ * price, and Binance's own funding fields.
+ *
+ * The provider-specific twin of {@link getMarkPrices}. Prefer the facade unless
+ * you specifically want the Binance variant's fields without narrowing.
+ *
+ * The request form adapts to the input, because the endpoint has no
+ * multi-symbol batch form:
+ * - **exactly one name** → `?symbol=NAME`, measured request weight **1**;
+ * - **many or no names** → the all-symbols form (weight **10**), filtered
+ *   client-side.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain, solver, and name filter.
+ * @returns Binance mark-price ticks. Unlisted names are absent, not an error.
+ * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the resolved provider is not Binance.
+ * @throws {SymmApiError} `FETCH_BINANCE_PREMIUM_INDEX_FAILED` when the request fails.
+ *
+ * @example
+ * ```ts
+ * const [btc] = await getBinancePremiumIndex(config, { solverId: "rasa", names: ["BTCUSDT"] });
+ * console.log(btc?.indexPrice);
+ * ```
+ */
+export declare function getBinancePremiumIndex(config: Config, parameters?: GetBinancePremiumIndexParameters): Promise<GetBinancePremiumIndexReturnType>;
+//# sourceMappingURL=get-binance-premium-index.d.ts.map

package/dist/price-service/binance/premium-index/get-binance-premium-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-binance-premium-index.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/premium-index/get-binance-premium-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAIrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,OAAO,CACpD,mBAAmB,GAAG;IACpB,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,CACF,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,oBAAoB,EAAE,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,gCAAqC,GAChD,OAAO,CAAC,gCAAgC,CAAC,CAwB3C"}

package/dist/price-service/binance/premium-index/get-binance-premium-index.js

@@ -0,0 +1,25 @@
+import { SymmApiError as e, SymmError as t } from "../../../shared/errors/symm-error.js";
+import { assertPriceServiceProvider as n } from "../../assert-price-service-provider.js";
+import { resolvePriceService as r } from "../../resolve-price-service.js";
+import { fetchBinanceMarkPrices as i } from "../../adapters/binance-mark-prices.js";
+import { isAxiosError as a } from "axios";
+//#region src/price-service/binance/premium-index/get-binance-premium-index.ts
+async function o(o, s = {}) {
+	let c = r(o, {
+		chainId: s.chainId,
+		solverId: s.solverId
+	});
+	n(c, "binance", "getBinancePremiumIndex");
+	try {
+		return await i(c.url, s.names);
+	} catch (n) {
+		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
+			code: "FETCH_BINANCE_PREMIUM_INDEX_FAILED",
+			baseURL: c.url
+		}) : new t("api", "FETCH_BINANCE_PREMIUM_INDEX_FAILED", `Failed to fetch Binance premium index: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { o as getBinancePremiumIndex };
+
+//# sourceMappingURL=get-binance-premium-index.js.map

package/dist/price-service/binance/premium-index/get-binance-premium-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-binance-premium-index.js","names":[],"sources":["../../../../src/price-service/binance/premium-index/get-binance-premium-index.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmApiError, SymmError } from \"../../../shared/errors/symm-error\";\nimport type { Compute, ReadSolverParameter } from \"../../../shared/types/properties\";\nimport { fetchBinanceMarkPrices } from \"../../adapters/binance-mark-prices\";\nimport { assertPriceServiceProvider } from \"../../assert-price-service-provider\";\nimport { resolvePriceService } from \"../../resolve-price-service\";\nimport type { BinanceMarkPriceTick } from \"../../types\";\n\n/**\n * Parameters for {@link getBinancePremiumIndex}.\n */\nexport type GetBinancePremiumIndexParameters = Compute<\n  ReadSolverParameter & {\n    /** Market names to price. Omit to read every symbol Binance lists. */\n    names?: readonly string[];\n  }\n>;\n\n/** Return type of {@link getBinancePremiumIndex}. */\nexport type GetBinancePremiumIndexReturnType = BinanceMarkPriceTick[];\n\n/**\n * Read Binance USD-M Futures `GET /fapi/v1/premiumIndex` — mark price, index\n * price, and Binance's own funding fields.\n *\n * The provider-specific twin of {@link getMarkPrices}. Prefer the facade unless\n * you specifically want the Binance variant's fields without narrowing.\n *\n * The request form adapts to the input, because the endpoint has no\n * multi-symbol batch form:\n * - **exactly one name** → `?symbol=NAME`, measured request weight **1**;\n * - **many or no names** → the all-symbols form (weight **10**), filtered\n *   client-side.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain, solver, and name filter.\n * @returns Binance mark-price ticks. Unlisted names are absent, not an error.\n * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the resolved provider is not Binance.\n * @throws {SymmApiError} `FETCH_BINANCE_PREMIUM_INDEX_FAILED` when the request fails.\n *\n * @example\n * ```ts\n * const [btc] = await getBinancePremiumIndex(config, { solverId: \"rasa\", names: [\"BTCUSDT\"] });\n * console.log(btc?.indexPrice);\n * ```\n */\nexport async function getBinancePremiumIndex(\n  config: Config,\n  parameters: GetBinancePremiumIndexParameters = {},\n): Promise<GetBinancePremiumIndexReturnType> {\n  const priceService = resolvePriceService(config, {\n    chainId: parameters.chainId,\n    solverId: parameters.solverId,\n  });\n  assertPriceServiceProvider(priceService, \"binance\", \"getBinancePremiumIndex\");\n\n  try {\n    return await fetchBinanceMarkPrices(priceService.url, parameters.names);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, {\n        code: \"FETCH_BINANCE_PREMIUM_INDEX_FAILED\",\n        baseURL: priceService.url,\n      });\n    }\n    throw new SymmError(\n      \"api\",\n      \"FETCH_BINANCE_PREMIUM_INDEX_FAILED\",\n      `Failed to fetch Binance premium index: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA+CA,eAAsB,EACpB,GACA,IAA+C,CAAC,GACL;CAC3C,IAAM,IAAe,EAAoB,GAAQ;EAC/C,SAAS,EAAW;EACpB,UAAU,EAAW;CACvB,CAAC;CACD,EAA2B,GAAc,WAAW,wBAAwB;CAE5E,IAAI;EACF,OAAO,MAAM,EAAuB,EAAa,KAAK,EAAW,KAAK;CACxE,SAAS,GAAK;EAQZ,MAPI,aAAe,IAAiB,IAChC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAChC,MAAM;GACN,SAAS,EAAa;EACxB,CAAC,IAEG,IAAI,EACR,OACA,sCACA,0CAA0C,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KACzF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/price-service/binance/premium-index/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-binance-premium-index.js';
+export * from './query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/price-service/binance/premium-index/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/premium-index/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,SAAS,CAAC"}

package/dist/price-service/binance/premium-index/query.d.ts

@@ -0,0 +1,28 @@
+import { Config } from '../../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../../shared/types/query.js';
+import { GetBinancePremiumIndexParameters, GetBinancePremiumIndexReturnType } from './get-binance-premium-index.js';
+/** Data resolved by the {@link getBinancePremiumIndexQueryOptions} query. */
+export type GetBinancePremiumIndexData = GetBinancePremiumIndexReturnType;
+/**
+ * Build the TanStack Query key for {@link getBinancePremiumIndexQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, solver id, names, config key).
+ * @returns A stable, hashable query key.
+ */
+export declare function getBinancePremiumIndexQueryKey(options?: Compute<GetBinancePremiumIndexParameters & ConfigKeyParameter>): readonly ["getBinancePremiumIndex", Record<string, unknown>];
+/** Query-key type produced by {@link getBinancePremiumIndexQueryKey}. */
+export type GetBinancePremiumIndexQueryKey = ReturnType<typeof getBinancePremiumIndexQueryKey>;
+/** Options accepted by {@link getBinancePremiumIndexQueryOptions}. */
+export type GetBinancePremiumIndexOptions = Compute<GetBinancePremiumIndexParameters & QueryParameter<GetBinancePremiumIndexData, Error, GetBinancePremiumIndexData, GetBinancePremiumIndexQueryKey>>;
+/** TanStack Query options returned by {@link getBinancePremiumIndexQueryOptions}. */
+export type GetBinancePremiumIndexQueryOptions = SymmioQueryOptions<GetBinancePremiumIndexData, Error, GetBinancePremiumIndexData, GetBinancePremiumIndexQueryKey>;
+/**
+ * Build TanStack Query options for {@link getBinancePremiumIndex}.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ */
+export declare function getBinancePremiumIndexQueryOptions(config: Config, options?: GetBinancePremiumIndexOptions): GetBinancePremiumIndexQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/price-service/binance/premium-index/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/premium-index/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,EAEL,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACtC,MAAM,6BAA6B,CAAC;AAErC,6EAA6E;AAC7E,MAAM,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,OAAO,CAAC,gCAAgC,GAAG,kBAAkB,CAAM,gEAG7E;AAED,yEAAyE;AACzE,MAAM,MAAM,8BAA8B,GAAG,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/F,sEAAsE;AACtE,MAAM,MAAM,6BAA6B,GAAG,OAAO,CACjD,gCAAgC,GAC9B,cAAc,CAAC,0BAA0B,EAAE,KAAK,EAAE,0BAA0B,EAAE,8BAA8B,CAAC,CAChH,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,kCAAkC,GAAG,kBAAkB,CACjE,0BAA0B,EAC1B,KAAK,EACL,0BAA0B,EAC1B,8BAA8B,CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,6BAAkC,GAC1C,kCAAkC,CAgBpC"}

package/dist/price-service/binance/premium-index/query.js

@@ -0,0 +1,25 @@
+import { filterQueryOptions as e } from "../../../shared/utils/query.js";
+import { getBinancePremiumIndex as t } from "./get-binance-premium-index.js";
+//#region src/price-service/binance/premium-index/query.ts
+function n(t = {}) {
+	return ["getBinancePremiumIndex", e(t)];
+}
+function r(e, r = {}) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: r.query?.enabled ?? !0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			solverId: r.solverId,
+			names: r.names
+		})
+	};
+}
+//#endregion
+export { n as getBinancePremiumIndexQueryKey, r as getBinancePremiumIndexQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/price-service/binance/premium-index/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../../src/price-service/binance/premium-index/query.ts"],"sourcesContent":["import type { Config } from \"../../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../../shared/types/query\";\nimport { filterQueryOptions } from \"../../../shared/utils/query\";\nimport {\n  getBinancePremiumIndex,\n  type GetBinancePremiumIndexParameters,\n  type GetBinancePremiumIndexReturnType,\n} from \"./get-binance-premium-index\";\n\n/** Data resolved by the {@link getBinancePremiumIndexQueryOptions} query. */\nexport type GetBinancePremiumIndexData = GetBinancePremiumIndexReturnType;\n\n/**\n * Build the TanStack Query key for {@link getBinancePremiumIndexQueryOptions}.\n *\n * @param options - Query parameters (chain id, solver id, names, config key).\n * @returns A stable, hashable query key.\n */\nexport function getBinancePremiumIndexQueryKey(\n  options: Compute<GetBinancePremiumIndexParameters & ConfigKeyParameter> = {},\n) {\n  return [\"getBinancePremiumIndex\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getBinancePremiumIndexQueryKey}. */\nexport type GetBinancePremiumIndexQueryKey = ReturnType<typeof getBinancePremiumIndexQueryKey>;\n\n/** Options accepted by {@link getBinancePremiumIndexQueryOptions}. */\nexport type GetBinancePremiumIndexOptions = Compute<\n  GetBinancePremiumIndexParameters &\n    QueryParameter<GetBinancePremiumIndexData, Error, GetBinancePremiumIndexData, GetBinancePremiumIndexQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getBinancePremiumIndexQueryOptions}. */\nexport type GetBinancePremiumIndexQueryOptions = SymmioQueryOptions<\n  GetBinancePremiumIndexData,\n  Error,\n  GetBinancePremiumIndexData,\n  GetBinancePremiumIndexQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getBinancePremiumIndex}.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n */\nexport function getBinancePremiumIndexQueryOptions(\n  config: Config,\n  options: GetBinancePremiumIndexOptions = {},\n): GetBinancePremiumIndexQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getBinancePremiumIndexQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    /** Every identifying parameter is enumerated — see ARCHITECTURE.md §3.5. */\n    queryFn: () =>\n      getBinancePremiumIndex(config, {\n        chainId: options.chainId,\n        solverId: options.solverId,\n        names: options.names,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EACd,IAA0E,CAAC,GAC3E;CACA,OAAO,CAAC,0BAA0B,EAAmB,CAAO,CAAC;AAC/D;AA0BA,SAAgB,EACd,GACA,IAAyC,CAAC,GACN;CACpC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA+B;GACvC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EAEnC,eACE,EAAuB,GAAQ;GAC7B,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,OAAO,EAAQ;EACjB,CAAC;CACL;AACF"}

package/dist/price-service/binance/symbols-info/get-binance-symbols-info.d.ts

@@ -0,0 +1,29 @@
+import { Config } from '../../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../../shared/types/properties.js';
+import { BinanceExchangeSymbol } from '../types.js';
+/** Parameters for {@link getBinanceSymbolsInfo}. */
+export type GetBinanceSymbolsInfoParameters = Compute<ReadSolverParameter>;
+/** Return type of {@link getBinanceSymbolsInfo}: every contract Binance lists. */
+export type GetBinanceSymbolsInfoReturnType = BinanceExchangeSymbol[];
+/**
+ * Read Binance USD-M Futures `GET /fapi/v1/exchangeInfo` — the exchange's own
+ * contract listing, with each symbol's status and price/quantity precision.
+ *
+ * The Binance twin of `getEnigmaPriceServiceSymbolsInfo`, and **reference data
+ * only**. `getMarkets` remains the authority on which markets are tradable on
+ * SYMMIO; this is what *Binance* lists, which is a superset and can disagree.
+ * Use it to check whether a market has a price source at all, or to compare
+ * Binance's precision against the solver's.
+ *
+ * **~1 MB response.** Cheap on request weight (1) but expensive to transfer and
+ * parse, so cache it hard and never poll it — the query factory defaults to a
+ * one-hour `staleTime` for that reason.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain and solver.
+ * @returns Every listed contract.
+ * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the resolved provider is not Binance.
+ * @throws {SymmApiError} `FETCH_BINANCE_SYMBOLS_INFO_FAILED` when the request fails.
+ */
+export declare function getBinanceSymbolsInfo(config: Config, parameters?: GetBinanceSymbolsInfoParameters): Promise<GetBinanceSymbolsInfoReturnType>;
+//# sourceMappingURL=get-binance-symbols-info.d.ts.map

package/dist/price-service/binance/symbols-info/get-binance-symbols-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-binance-symbols-info.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/symbols-info/get-binance-symbols-info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAIrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,oDAAoD;AACpD,MAAM,MAAM,+BAA+B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE3E,kFAAkF;AAClF,MAAM,MAAM,+BAA+B,GAAG,qBAAqB,EAAE,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,+BAAoC,GAC/C,OAAO,CAAC,+BAA+B,CAAC,CAyB1C"}

package/dist/price-service/binance/symbols-info/get-binance-symbols-info.js

@@ -0,0 +1,25 @@
+import { SymmApiError as e, SymmError as t } from "../../../shared/errors/symm-error.js";
+import { assertPriceServiceProvider as n } from "../../assert-price-service-provider.js";
+import { resolvePriceService as r } from "../../resolve-price-service.js";
+import { fetchBinanceExchangeInfo as i } from "../client.js";
+import { isAxiosError as a } from "axios";
+//#region src/price-service/binance/symbols-info/get-binance-symbols-info.ts
+async function o(o, s = {}) {
+	let c = r(o, {
+		chainId: s.chainId,
+		solverId: s.solverId
+	});
+	n(c, "binance", "getBinanceSymbolsInfo");
+	try {
+		return (await i(c.url)).symbols ?? [];
+	} catch (n) {
+		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
+			code: "FETCH_BINANCE_SYMBOLS_INFO_FAILED",
+			baseURL: c.url
+		}) : new t("api", "FETCH_BINANCE_SYMBOLS_INFO_FAILED", `Failed to fetch Binance exchange info: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { o as getBinanceSymbolsInfo };
+
+//# sourceMappingURL=get-binance-symbols-info.js.map

package/dist/price-service/binance/symbols-info/get-binance-symbols-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-binance-symbols-info.js","names":[],"sources":["../../../../src/price-service/binance/symbols-info/get-binance-symbols-info.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmApiError, SymmError } from \"../../../shared/errors/symm-error\";\nimport type { Compute, ReadSolverParameter } from \"../../../shared/types/properties\";\nimport { assertPriceServiceProvider } from \"../../assert-price-service-provider\";\nimport { resolvePriceService } from \"../../resolve-price-service\";\nimport { fetchBinanceExchangeInfo } from \"../client\";\nimport type { BinanceExchangeSymbol } from \"../types\";\n\n/** Parameters for {@link getBinanceSymbolsInfo}. */\nexport type GetBinanceSymbolsInfoParameters = Compute<ReadSolverParameter>;\n\n/** Return type of {@link getBinanceSymbolsInfo}: every contract Binance lists. */\nexport type GetBinanceSymbolsInfoReturnType = BinanceExchangeSymbol[];\n\n/**\n * Read Binance USD-M Futures `GET /fapi/v1/exchangeInfo` — the exchange's own\n * contract listing, with each symbol's status and price/quantity precision.\n *\n * The Binance twin of `getEnigmaPriceServiceSymbolsInfo`, and **reference data\n * only**. `getMarkets` remains the authority on which markets are tradable on\n * SYMMIO; this is what *Binance* lists, which is a superset and can disagree.\n * Use it to check whether a market has a price source at all, or to compare\n * Binance's precision against the solver's.\n *\n * **~1 MB response.** Cheap on request weight (1) but expensive to transfer and\n * parse, so cache it hard and never poll it — the query factory defaults to a\n * one-hour `staleTime` for that reason.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain and solver.\n * @returns Every listed contract.\n * @throws {SymmError} `UNSUPPORTED_BY_PRICE_SERVICE` when the resolved provider is not Binance.\n * @throws {SymmApiError} `FETCH_BINANCE_SYMBOLS_INFO_FAILED` when the request fails.\n */\nexport async function getBinanceSymbolsInfo(\n  config: Config,\n  parameters: GetBinanceSymbolsInfoParameters = {},\n): Promise<GetBinanceSymbolsInfoReturnType> {\n  const priceService = resolvePriceService(config, {\n    chainId: parameters.chainId,\n    solverId: parameters.solverId,\n  });\n  assertPriceServiceProvider(priceService, \"binance\", \"getBinanceSymbolsInfo\");\n\n  try {\n    const info = await fetchBinanceExchangeInfo(priceService.url);\n    return info.symbols ?? [];\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, {\n        code: \"FETCH_BINANCE_SYMBOLS_INFO_FAILED\",\n        baseURL: priceService.url,\n      });\n    }\n    throw new SymmError(\n      \"api\",\n      \"FETCH_BINANCE_SYMBOLS_INFO_FAILED\",\n      `Failed to fetch Binance exchange info: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AAmCA,eAAsB,EACpB,GACA,IAA8C,CAAC,GACL;CAC1C,IAAM,IAAe,EAAoB,GAAQ;EAC/C,SAAS,EAAW;EACpB,UAAU,EAAW;CACvB,CAAC;CACD,EAA2B,GAAc,WAAW,uBAAuB;CAE3E,IAAI;EAEF,QAAO,MADY,EAAyB,EAAa,GAAG,GAChD,WAAW,CAAC;CAC1B,SAAS,GAAK;EAQZ,MAPI,aAAe,IAAiB,IAChC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAChC,MAAM;GACN,SAAS,EAAa;EACxB,CAAC,IAEG,IAAI,EACR,OACA,qCACA,0CAA0C,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KACzF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/price-service/binance/symbols-info/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-binance-symbols-info.js';
+export * from './query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/price-service/binance/symbols-info/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/price-service/binance/symbols-info/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC"}