@symmio/trading-core 3.5.0 → 4.0.0

package/dist/solvers/notional-cap/get-notional-cap-page.d.ts

@@ -0,0 +1,49 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../shared/types/properties.js';
+import { EnigmaNotionalCap } from './types.js';
+/**
+ * Parameters for {@link getNotionalCapPage}.
+ * Paging is optional; omit it for the first 100 rows. Totals cover only that page.
+ * @example
+ * const parameters: GetNotionalCapPageParameters = { chainId: 42161, limit: 50, offset: 100 };
+ */
+export type GetNotionalCapPageParameters = Compute<ReadSolverParameter & {
+    /** Maximum rows in this page (1–100, default 100). */
+    limit?: number;
+    /** Zero-based row offset (default 0). */
+    offset?: number;
+}>;
+/**
+ * One page of normalized caps and its aggregate totals in float dollars.
+ * Missing numeric wire fields are zero, matching the existing cap API.
+ * @example
+ * const page: GetNotionalCapPageReturnType = await getNotionalCapPage(config, { offset: 100 });
+ * console.log(page.symbols, page.totalUsed);
+ */
+export interface GetNotionalCapPageReturnType {
+    /** Number of symbols the solver returned. */
+    count: number;
+    /** Σ `openInterest` across this page (dollars). */
+    totalOpenInterest: number;
+    /** Σ `used` across this page (dollars). */
+    totalUsed: number;
+    /** Per-symbol rows. `/notional_cap` (list) is Enigma-only, so rows are always Enigma-shaped. */
+    symbols: EnigmaNotionalCap[];
+}
+/**
+ * Fetch one Enigma notional-cap page, with page-only totals in float dollars.
+ * The live endpoint accepts at most 100 rows despite the generated spec's 500.
+ * Missing numeric fields retain the existing zero fallback.
+ * @param config - SDK configuration selecting the deployment.
+ * @param parameters - Chain, solver and optional limit/offset.
+ * @returns Normalized rows and totals for this page only.
+ * @throws {SymmError} For invalid paging or an unsupported solver/chain.
+ * @throws {SymmApiError} When the upstream request fails.
+ * @example
+ * ```ts
+ * const page = await getNotionalCapPage(config, { limit: 100, offset: 100 });
+ * console.log(page.totalUsed, page.symbols);
+ * ```
+ */
+export declare function getNotionalCapPage(config: Config, parameters?: GetNotionalCapPageParameters): Promise<GetNotionalCapPageReturnType>;
+//# sourceMappingURL=get-notional-cap-page.d.ts.map

package/dist/solvers/notional-cap/get-notional-cap-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-notional-cap-page.d.ts","sourceRoot":"","sources":["../../../src/solvers/notional-cap/get-notional-cap-page.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,mBAAmB,GAAG;IACpB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,4BAAiC,GAC5C,OAAO,CAAC,4BAA4B,CAAC,CAkCvC"}

package/dist/solvers/notional-cap/get-notional-cap-page.js

@@ -0,0 +1,37 @@
+import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
+import { getNotionalCap as n } from "../types/generated/enigma-solver.js";
+import { assertSolverKind as r } from "../assert-solver-kind.js";
+import { toEnigmaNotionalCap as i } from "./adapters/enigma-notional-cap.js";
+import { isAxiosError as a } from "axios";
+import { toFiniteNumber as o } from "@symmio/utils/number";
+//#region src/solvers/notional-cap/get-notional-cap-page.ts
+async function s(s, c = {}) {
+	let l = s.getSolver({
+		chainId: c.chainId,
+		solverId: c.solverId
+	});
+	r(l, "enigma", "getNotionalCapPage");
+	let u = c.limit ?? 100, d = c.offset ?? 0;
+	if (!Number.isInteger(u) || u < 1 || u > 100 || !Number.isInteger(d) || d < 0) throw new t("validation", "INVALID_NOTIONAL_CAP_PAGE", "limit must be an integer from 1 to 100 and offset a non-negative integer.");
+	try {
+		let e = (await n({
+			limit: u,
+			offset: d
+		}, { baseURL: l.url })).data, t = Array.isArray(e.symbols) ? e.symbols : [];
+		return {
+			count: o(e.count),
+			totalOpenInterest: o(e.total_open_interest),
+			totalUsed: o(e.total_used),
+			symbols: t.map(i)
+		};
+	} catch (n) {
+		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
+			code: "FETCH_NOTIONAL_CAP_PAGE_FAILED",
+			baseURL: l.url
+		}) : new t("api", "FETCH_NOTIONAL_CAP_PAGE_FAILED", `Failed to fetch notional caps: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { s as getNotionalCapPage };
+
+//# sourceMappingURL=get-notional-cap-page.js.map

package/dist/solvers/notional-cap/get-notional-cap-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-notional-cap-page.js","names":[],"sources":["../../../src/solvers/notional-cap/get-notional-cap-page.ts"],"sourcesContent":["import { toFiniteNumber } from \"@symmio/utils/number\";\nimport { 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 { assertSolverKind } from \"../assert-solver-kind\";\nimport { getNotionalCap } from \"../types/generated/enigma-solver\";\nimport { toEnigmaNotionalCap } from \"./adapters\";\nimport type { EnigmaNotionalCap } from \"./types\";\n\n/**\n * Parameters for {@link getNotionalCapPage}.\n * Paging is optional; omit it for the first 100 rows. Totals cover only that page.\n * @example\n * const parameters: GetNotionalCapPageParameters = { chainId: 42161, limit: 50, offset: 100 };\n */\nexport type GetNotionalCapPageParameters = Compute<\n  ReadSolverParameter & {\n    /** Maximum rows in this page (1–100, default 100). */\n    limit?: number;\n    /** Zero-based row offset (default 0). */\n    offset?: number;\n  }\n>;\n\n/**\n * One page of normalized caps and its aggregate totals in float dollars.\n * Missing numeric wire fields are zero, matching the existing cap API.\n * @example\n * const page: GetNotionalCapPageReturnType = await getNotionalCapPage(config, { offset: 100 });\n * console.log(page.symbols, page.totalUsed);\n */\nexport interface GetNotionalCapPageReturnType {\n  /** Number of symbols the solver returned. */\n  count: number;\n  /** Σ `openInterest` across this page (dollars). */\n  totalOpenInterest: number;\n  /** Σ `used` across this page (dollars). */\n  totalUsed: number;\n  /** Per-symbol rows. `/notional_cap` (list) is Enigma-only, so rows are always Enigma-shaped. */\n  symbols: EnigmaNotionalCap[];\n}\n\n/**\n * Fetch one Enigma notional-cap page, with page-only totals in float dollars.\n * The live endpoint accepts at most 100 rows despite the generated spec's 500.\n * Missing numeric fields retain the existing zero fallback.\n * @param config - SDK configuration selecting the deployment.\n * @param parameters - Chain, solver and optional limit/offset.\n * @returns Normalized rows and totals for this page only.\n * @throws {SymmError} For invalid paging or an unsupported solver/chain.\n * @throws {SymmApiError} When the upstream request fails.\n * @example\n * ```ts\n * const page = await getNotionalCapPage(config, { limit: 100, offset: 100 });\n * console.log(page.totalUsed, page.symbols);\n * ```\n */\nexport async function getNotionalCapPage(\n  config: Config,\n  parameters: GetNotionalCapPageParameters = {},\n): Promise<GetNotionalCapPageReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getNotionalCapPage\");\n  const limit = parameters.limit ?? 100;\n  const offset = parameters.offset ?? 0;\n  if (!Number.isInteger(limit) || limit < 1 || limit > 100 || !Number.isInteger(offset) || offset < 0) {\n    throw new SymmError(\n      \"validation\",\n      \"INVALID_NOTIONAL_CAP_PAGE\",\n      \"limit must be an integer from 1 to 100 and offset a non-negative integer.\",\n    );\n  }\n  try {\n    const response = await getNotionalCap({ limit, offset }, { baseURL: solver.url });\n    const r = response.data as Record<string, unknown>;\n    const rawSymbols = Array.isArray(r.symbols) ? (r.symbols as Parameters<typeof toEnigmaNotionalCap>[0][]) : [];\n    return {\n      count: toFiniteNumber(r.count as number | string | undefined),\n      totalOpenInterest: toFiniteNumber(r.total_open_interest as number | string | undefined),\n      totalUsed: toFiniteNumber(r.total_used as number | string | undefined),\n      symbols: rawSymbols.map(toEnigmaNotionalCap),\n    };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_NOTIONAL_CAP_PAGE_FAILED\", baseURL: solver.url });\n    }\n    throw new SymmError(\n      \"api\",\n      \"FETCH_NOTIONAL_CAP_PAGE_FAILED\",\n      `Failed to fetch notional caps: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;;AA0DA,eAAsB,EACpB,GACA,IAA2C,CAAC,GACL;CACvC,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAC9F,EAAiB,GAAQ,UAAU,oBAAoB;CACvD,IAAM,IAAQ,EAAW,SAAS,KAC5B,IAAS,EAAW,UAAU;CACpC,IAAI,CAAC,OAAO,UAAU,CAAK,KAAK,IAAQ,KAAK,IAAQ,OAAO,CAAC,OAAO,UAAU,CAAM,KAAK,IAAS,GAChG,MAAM,IAAI,EACR,cACA,6BACA,2EACF;CAEF,IAAI;EAEF,IAAM,KAAI,MADa,EAAe;GAAE;GAAO;EAAO,GAAG,EAAE,SAAS,EAAO,IAAI,CAAC,GAC7D,MACb,IAAa,MAAM,QAAQ,EAAE,OAAO,IAAK,EAAE,UAA0D,CAAC;EAC5G,OAAO;GACL,OAAO,EAAe,EAAE,KAAoC;GAC5D,mBAAmB,EAAe,EAAE,mBAAkD;GACtF,WAAW,EAAe,EAAE,UAAyC;GACrE,SAAS,EAAW,IAAI,CAAmB;EAC7C;CACF,SAAS,GAAK;EAKZ,MAJI,aAAe,IAAiB,IAChC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAAkC,SAAS,EAAO;EAAI,CAAC,IAE7F,IAAI,EACR,OACA,kCACA,kCAAkC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KACjF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/solvers/notional-cap/index.d.ts

@@ -1,9 +1,11 @@
 export * from './check-notional-cap.js';
 export * from './get-notional-cap-all.js';
 export * from './get-notional-cap-by-symbol-id.js';
+export * from './get-notional-cap-page.js';
 export * from './get-open-interest-by-symbol-id.js';
 export * from './query.js';
 export * from './query-all.js';
 export * from './query-open-interest.js';
+export * from './query-page.js';
 export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/notional-cap/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/notional-cap/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/notional-cap/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/solvers/notional-cap/query-page.d.ts

@@ -0,0 +1,45 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetNotionalCapPageParameters, GetNotionalCapPageReturnType } from './get-notional-cap-page.js';
+/**
+ * One page of normalized cap rows and page-only totals resolved by the query.
+ * @example const page: GetNotionalCapPageData = await getNotionalCapPage(config, {});
+ */
+export type GetNotionalCapPageData = GetNotionalCapPageReturnType;
+/** Build a deployment- and page-specific query key.
+ * @param options - Paging and deployment identity.
+ * @returns A stable query-key tuple.
+ * @throws Does not throw for valid options.
+ * @example getNotionalCapPageQueryKey({ limit: 100, offset: 100 });
+ */
+export declare function getNotionalCapPageQueryKey(options: Compute<GetNotionalCapPageParameters & ConfigKeyParameter>): readonly ["getNotionalCapPage", Record<string, unknown>];
+/**
+ * Stable tuple identifying a page and its deployment in the query cache.
+ * @example const key: GetNotionalCapPageQueryKey = getNotionalCapPageQueryKey({ offset: 100 });
+ */
+export type GetNotionalCapPageQueryKey = ReturnType<typeof getNotionalCapPageQueryKey>;
+/**
+ * Page/deployment inputs and TanStack Query overrides for the page read.
+ * @example const options: GetNotionalCapPageOptions = { limit: 50, query: { enabled: false } };
+ */
+export type GetNotionalCapPageOptions = Compute<GetNotionalCapPageParameters & QueryParameter<GetNotionalCapPageData, Error, GetNotionalCapPageData, GetNotionalCapPageQueryKey>>;
+/**
+ * Executable query options with a page-specific key and normalized cap result.
+ * @example const query: GetNotionalCapPageQueryOptions = getNotionalCapPageQueryOptions(config, { offset: 100 });
+ */
+export type GetNotionalCapPageQueryOptions = SymmioQueryOptions<GetNotionalCapPageData, Error, GetNotionalCapPageData, GetNotionalCapPageQueryKey>;
+/**
+ * Build TanStack Query options for one notional-cap page.
+ * @param config - SDK configuration.
+ * @param options - Paging, deployment and query overrides.
+ * @returns Options whose key includes the page and deployment identity.
+ * @throws {SymmError} When configuration cannot be resolved; the query function propagates action errors.
+ *
+ * @example
+ * ```ts
+ * useQuery(getNotionalCapPageQueryOptions(config, {}));
+ * ```
+ */
+export declare function getNotionalCapPageQueryOptions(config: Config, options?: GetNotionalCapPageOptions): GetNotionalCapPageQueryOptions;
+//# sourceMappingURL=query-page.d.ts.map

package/dist/solvers/notional-cap/query-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-page.d.ts","sourceRoot":"","sources":["../../../src/solvers/notional-cap/query-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EAClC,MAAM,yBAAyB,CAAC;AAEjC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,4BAA4B,GAAG,kBAAkB,CAAC,4DAE7G;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,4BAA4B,GAC1B,cAAc,CAAC,sBAAsB,EAAE,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,CAAC,CACpG,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,kBAAkB,CAC7D,sBAAsB,EACtB,KAAK,EACL,sBAAsB,EACtB,0BAA0B,CAC3B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,yBAA8B,GACtC,8BAA8B,CAgBhC"}

package/dist/solvers/notional-cap/query-page.js

@@ -0,0 +1,26 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getNotionalCapPage as t } from "./get-notional-cap-page.js";
+//#region src/solvers/notional-cap/query-page.ts
+function n(t) {
+	return ["getNotionalCapPage", 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,
+			limit: r.limit,
+			offset: r.offset
+		})
+	};
+}
+//#endregion
+export { n as getNotionalCapPageQueryKey, r as getNotionalCapPageQueryOptions };
+
+//# sourceMappingURL=query-page.js.map

package/dist/solvers/notional-cap/query-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-page.js","names":[],"sources":["../../../src/solvers/notional-cap/query-page.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  getNotionalCapPage,\n  type GetNotionalCapPageParameters,\n  type GetNotionalCapPageReturnType,\n} from \"./get-notional-cap-page\";\n\n/**\n * One page of normalized cap rows and page-only totals resolved by the query.\n * @example const page: GetNotionalCapPageData = await getNotionalCapPage(config, {});\n */\nexport type GetNotionalCapPageData = GetNotionalCapPageReturnType;\n\n/** Build a deployment- and page-specific query key.\n * @param options - Paging and deployment identity.\n * @returns A stable query-key tuple.\n * @throws Does not throw for valid options.\n * @example getNotionalCapPageQueryKey({ limit: 100, offset: 100 });\n */\nexport function getNotionalCapPageQueryKey(options: Compute<GetNotionalCapPageParameters & ConfigKeyParameter>) {\n  return [\"getNotionalCapPage\", filterQueryOptions(options)] as const;\n}\n\n/**\n * Stable tuple identifying a page and its deployment in the query cache.\n * @example const key: GetNotionalCapPageQueryKey = getNotionalCapPageQueryKey({ offset: 100 });\n */\nexport type GetNotionalCapPageQueryKey = ReturnType<typeof getNotionalCapPageQueryKey>;\n\n/**\n * Page/deployment inputs and TanStack Query overrides for the page read.\n * @example const options: GetNotionalCapPageOptions = { limit: 50, query: { enabled: false } };\n */\nexport type GetNotionalCapPageOptions = Compute<\n  GetNotionalCapPageParameters &\n    QueryParameter<GetNotionalCapPageData, Error, GetNotionalCapPageData, GetNotionalCapPageQueryKey>\n>;\n\n/**\n * Executable query options with a page-specific key and normalized cap result.\n * @example const query: GetNotionalCapPageQueryOptions = getNotionalCapPageQueryOptions(config, { offset: 100 });\n */\nexport type GetNotionalCapPageQueryOptions = SymmioQueryOptions<\n  GetNotionalCapPageData,\n  Error,\n  GetNotionalCapPageData,\n  GetNotionalCapPageQueryKey\n>;\n\n/**\n * Build TanStack Query options for one notional-cap page.\n * @param config - SDK configuration.\n * @param options - Paging, deployment and query overrides.\n * @returns Options whose key includes the page and deployment identity.\n * @throws {SymmError} When configuration cannot be resolved; the query function propagates action errors.\n *\n * @example\n * ```ts\n * useQuery(getNotionalCapPageQueryOptions(config, {}));\n * ```\n */\nexport function getNotionalCapPageQueryOptions(\n  config: Config,\n  options: GetNotionalCapPageOptions = {},\n): GetNotionalCapPageQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getNotionalCapPageQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getNotionalCapPage(config, {\n        chainId: options.chainId,\n        solverId: options.solverId,\n        limit: options.limit,\n        offset: options.offset,\n      }),\n  };\n}\n"],"mappings":";;;AAsBA,SAAgB,EAA2B,GAAqE;CAC9G,OAAO,CAAC,sBAAsB,EAAmB,CAAO,CAAC;AAC3D;AAwCA,SAAgB,EACd,GACA,IAAqC,CAAC,GACN;CAChC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA2B;GACnC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAmB,GAAQ;GACzB,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,OAAO,EAAQ;GACf,QAAQ,EAAQ;EAClB,CAAC;CACL;AACF"}

package/dist/solvers/shared/index.d.ts

@@ -5,6 +5,7 @@
  * instant-* slices lives here. Slice-specific shared lives under each slice's
  * own `shared/` folder.
  */
+export * from './instant-delegation-preflight.js';
 export * from './resolvers/index.js';
 export * from './solver-close-fee.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/solvers/shared/instant-delegation-preflight.d.ts

@@ -0,0 +1,65 @@
+import { Config } from '../../core/config/index.js';
+import { SignedOperation } from '../instant-open/shared/types.js';
+/**
+ * Per-call switch for the delegation check that instant trade writes run
+ * before signing.
+ *
+ * `instantOpen`, `instantClose` and `instantCloseBulk` — and every flow built
+ * on them (`instantOpenAuto`, `limitOpenAuto`, `instantCloseAuto`,
+ * `limitCloseAuto`, `instantCloseBulkAuto`) — confirm that the signer may act
+ * for the account each operation runs under before anything is signed or sent
+ * to the solver. A session key without the InstantLayer delegation fails right
+ * there with `INSTANT_SIGNER_NOT_DELEGATED`, instead of after the solver tries
+ * to execute the trade. The account's owner needs no delegation, so an
+ * owner-signed trade skips the delegation reads.
+ *
+ * @example
+ * ```ts
+ * // The app already gates its trade button on delegation: skip the extra read.
+ * await instantClose(config, { from: sessionKey, partyA, order, preflightDelegation: false });
+ * ```
+ */
+export interface InstantDelegationPreflightParameter {
+    /**
+     * Check, before signing, that the signer holds an active InstantLayer
+     * delegation for every operation it signs, and throw
+     * `INSTANT_SIGNER_NOT_DELEGATED` when it does not. Defaults to `true`.
+     *
+     * Pass `false` when your app already gates the trade on delegation and you
+     * want to skip the extra RPC read.
+     */
+    preflightDelegation?: boolean;
+}
+/**
+ * Throw when the signer of a set of instant-trade operations lacks the
+ * InstantLayer delegation they need — before any of them is signed or sent.
+ *
+ * Built on the gasless relay's delegation pre-flight
+ * (`findUndelegatedGaslessSelectors`), so relayed writes and instant trades
+ * share one delegation check. This adds the two steps that check leaves to its
+ * caller:
+ *
+ * 1. Each operation's selector is read from its calldata, so the check covers
+ *    exactly what is about to be signed.
+ * 2. Each operation's `signerAccount` is resolved to its delegator — a live
+ *    virtual account to its parent sub-account, as the InstantLayer does.
+ *    Without it a close signed under a virtual account would skip the check.
+ *
+ * Operations are grouped by signer and delegator, so a bulk close across many
+ * virtual accounts of one sub-account costs one check.
+ *
+ * @param config - The SDK config.
+ * @param parameters - The chain, the calling action (named in the error), the
+ *   operations about to be signed, and `enabled` (`false` skips the check).
+ * @throws {SymmError} `INSTANT_SIGNER_NOT_DELEGATED` naming every signer,
+ *   sub-account and selector that lacks an active delegation.
+ *
+ * @internal
+ */
+export declare function assertInstantSignerDelegated(config: Config, parameters: {
+    chainId?: number;
+    action: string;
+    operations: readonly Pick<SignedOperation, "signer" | "callData" | "signerAccount">[];
+    enabled?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=instant-delegation-preflight.d.ts.map

package/dist/solvers/shared/instant-delegation-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant-delegation-preflight.d.ts","sourceRoot":"","sources":["../../../src/solvers/shared/instant-delegation-preflight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,mCAAmC;IAClD;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AASD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC,EAAE,CAAC;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/solvers/shared/instant-delegation-preflight.js

@@ -0,0 +1,34 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { findUndelegatedGaslessSelectors as t, getCachedDelegatorAccount as n } from "../../gasless/delegation-preflight.js";
+//#region src/solvers/shared/instant-delegation-preflight.ts
+async function r(r, i) {
+	if (i.enabled === !1 || i.operations.length === 0) return;
+	let { chainId: a } = r.getChainConfig(i.chainId), o = await Promise.all(i.operations.map(async (e) => ({
+		operation: e,
+		account: await n(r, a, e.signerAccount.addr)
+	}))), s = /* @__PURE__ */ new Map();
+	for (let { operation: e, account: t } of o) {
+		let n = `${e.signer.toLowerCase()}:${t.toLowerCase()}`, r = s.get(n) ?? {
+			signer: e.signer,
+			account: t,
+			selectors: /* @__PURE__ */ new Set()
+		};
+		r.selectors.add(e.callData.slice(0, 10).toLowerCase()), s.set(n, r);
+	}
+	let c = (await Promise.all([...s.values()].map(async (e) => ({
+		...e,
+		missing: await t(r, {
+			chainId: a,
+			signer: e.signer,
+			signerAccount: e.account,
+			selectors: [...e.selectors]
+		})
+	})))).filter((e) => e.missing.length > 0);
+	if (c.length === 0) return;
+	let l = c.map((e) => `signer ${e.signer} holds no active InstantLayer delegation from sub-account ${e.account} for selector(s) ${e.missing.join(", ")}`).join("; ");
+	throw new e("validation", "INSTANT_SIGNER_NOT_DELEGATED", `${i.action}: ${l}. Grant those selectors to the signer (getInstantTradeRequiredSelectors builds the trade set), sign with the sub-account's owner, or pass \`preflightDelegation: false\` to skip this check.`);
+}
+//#endregion
+export { r as assertInstantSignerDelegated };
+
+//# sourceMappingURL=instant-delegation-preflight.js.map

package/dist/solvers/shared/instant-delegation-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant-delegation-preflight.js","names":[],"sources":["../../../src/solvers/shared/instant-delegation-preflight.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport { findUndelegatedGaslessSelectors, getCachedDelegatorAccount } from \"../../gasless/delegation-preflight\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { SignedOperation } from \"../instant-open/shared/types\";\n\n/**\n * Per-call switch for the delegation check that instant trade writes run\n * before signing.\n *\n * `instantOpen`, `instantClose` and `instantCloseBulk` — and every flow built\n * on them (`instantOpenAuto`, `limitOpenAuto`, `instantCloseAuto`,\n * `limitCloseAuto`, `instantCloseBulkAuto`) — confirm that the signer may act\n * for the account each operation runs under before anything is signed or sent\n * to the solver. A session key without the InstantLayer delegation fails right\n * there with `INSTANT_SIGNER_NOT_DELEGATED`, instead of after the solver tries\n * to execute the trade. The account's owner needs no delegation, so an\n * owner-signed trade skips the delegation reads.\n *\n * @example\n * ```ts\n * // The app already gates its trade button on delegation: skip the extra read.\n * await instantClose(config, { from: sessionKey, partyA, order, preflightDelegation: false });\n * ```\n */\nexport interface InstantDelegationPreflightParameter {\n  /**\n   * Check, before signing, that the signer holds an active InstantLayer\n   * delegation for every operation it signs, and throw\n   * `INSTANT_SIGNER_NOT_DELEGATED` when it does not. Defaults to `true`.\n   *\n   * Pass `false` when your app already gates the trade on delegation and you\n   * want to skip the extra RPC read.\n   */\n  preflightDelegation?: boolean;\n}\n\n/** The selectors one signer signs under one delegator account. */\ninterface DelegationCheck {\n  signer: Address;\n  account: Address;\n  selectors: Set<Hex>;\n}\n\n/**\n * Throw when the signer of a set of instant-trade operations lacks the\n * InstantLayer delegation they need — before any of them is signed or sent.\n *\n * Built on the gasless relay's delegation pre-flight\n * (`findUndelegatedGaslessSelectors`), so relayed writes and instant trades\n * share one delegation check. This adds the two steps that check leaves to its\n * caller:\n *\n * 1. Each operation's selector is read from its calldata, so the check covers\n *    exactly what is about to be signed.\n * 2. Each operation's `signerAccount` is resolved to its delegator — a live\n *    virtual account to its parent sub-account, as the InstantLayer does.\n *    Without it a close signed under a virtual account would skip the check.\n *\n * Operations are grouped by signer and delegator, so a bulk close across many\n * virtual accounts of one sub-account costs one check.\n *\n * @param config - The SDK config.\n * @param parameters - The chain, the calling action (named in the error), the\n *   operations about to be signed, and `enabled` (`false` skips the check).\n * @throws {SymmError} `INSTANT_SIGNER_NOT_DELEGATED` naming every signer,\n *   sub-account and selector that lacks an active delegation.\n *\n * @internal\n */\nexport async function assertInstantSignerDelegated(\n  config: Config,\n  parameters: {\n    chainId?: number;\n    action: string;\n    operations: readonly Pick<SignedOperation, \"signer\" | \"callData\" | \"signerAccount\">[];\n    enabled?: boolean;\n  },\n): Promise<void> {\n  if (parameters.enabled === false || parameters.operations.length === 0) return;\n  const { chainId } = config.getChainConfig(parameters.chainId);\n\n  const resolved = await Promise.all(\n    parameters.operations.map(async (operation) => ({\n      operation,\n      account: await getCachedDelegatorAccount(config, chainId, operation.signerAccount.addr),\n    })),\n  );\n\n  const checks = new Map<string, DelegationCheck>();\n  for (const { operation, account } of resolved) {\n    const key = `${operation.signer.toLowerCase()}:${account.toLowerCase()}`;\n    const check = checks.get(key) ?? { signer: operation.signer, account, selectors: new Set<Hex>() };\n    check.selectors.add(operation.callData.slice(0, 10).toLowerCase() as Hex);\n    checks.set(key, check);\n  }\n\n  const results = await Promise.all(\n    [...checks.values()].map(async (check) => ({\n      ...check,\n      missing: await findUndelegatedGaslessSelectors(config, {\n        chainId,\n        signer: check.signer,\n        signerAccount: check.account,\n        selectors: [...check.selectors],\n      }),\n    })),\n  );\n  const undelegated = results.filter((result) => result.missing.length > 0);\n  if (undelegated.length === 0) return;\n\n  const detail = undelegated\n    .map(\n      (result) =>\n        `signer ${result.signer} holds no active InstantLayer delegation from sub-account ${result.account} for selector(s) ${result.missing.join(\", \")}`,\n    )\n    .join(\"; \");\n  throw new SymmError(\n    \"validation\",\n    \"INSTANT_SIGNER_NOT_DELEGATED\",\n    `${parameters.action}: ${detail}. Grant those selectors to the signer (getInstantTradeRequiredSelectors builds the trade set), sign with the sub-account's owner, or pass \\`preflightDelegation: false\\` to skip this check.`,\n  );\n}\n"],"mappings":";;;AAsEA,eAAsB,EACpB,GACA,GAMe;CACf,IAAI,EAAW,YAAY,MAAS,EAAW,WAAW,WAAW,GAAG;CACxE,IAAM,EAAE,eAAY,EAAO,eAAe,EAAW,OAAO,GAEtD,IAAW,MAAM,QAAQ,IAC7B,EAAW,WAAW,IAAI,OAAO,OAAe;EAC9C;EACA,SAAS,MAAM,EAA0B,GAAQ,GAAS,EAAU,cAAc,IAAI;CACxF,EAAE,CACJ,GAEM,oBAAS,IAAI,IAA6B;CAChD,KAAK,IAAM,EAAE,cAAW,gBAAa,GAAU;EAC7C,IAAM,IAAM,GAAG,EAAU,OAAO,YAAY,EAAE,GAAG,EAAQ,YAAY,KAC/D,IAAQ,EAAO,IAAI,CAAG,KAAK;GAAE,QAAQ,EAAU;GAAQ;GAAS,2BAAW,IAAI,IAAS;EAAE;EAEhG,AADA,EAAM,UAAU,IAAI,EAAU,SAAS,MAAM,GAAG,EAAE,EAAE,YAAY,CAAQ,GACxE,EAAO,IAAI,GAAK,CAAK;CACvB;CAaA,IAAM,KAAc,MAXE,QAAQ,IAC5B,CAAC,GAAG,EAAO,OAAO,CAAC,EAAE,IAAI,OAAO,OAAW;EACzC,GAAG;EACH,SAAS,MAAM,EAAgC,GAAQ;GACrD;GACA,QAAQ,EAAM;GACd,eAAe,EAAM;GACrB,WAAW,CAAC,GAAG,EAAM,SAAS;EAChC,CAAC;CACH,EAAE,CACJ,GAC4B,QAAQ,MAAW,EAAO,QAAQ,SAAS,CAAC;CACxE,IAAI,EAAY,WAAW,GAAG;CAE9B,IAAM,IAAS,EACZ,KACE,MACC,UAAU,EAAO,OAAO,4DAA4D,EAAO,QAAQ,mBAAmB,EAAO,QAAQ,KAAK,IAAI,GAClJ,EACC,KAAK,IAAI;CACZ,MAAM,IAAI,EACR,cACA,gCACA,GAAG,EAAW,OAAO,IAAI,EAAO,6LAClC;AACF"}

package/dist/solvers/symbols/get-symbols.d.ts

@@ -5,7 +5,7 @@ import { SolverSymbol, SymbolStateFilter, SymbolValidityFilter } from './types.j
  * Parameters for {@link getSymbols}.
  */
 export type GetSymbolsParameters = Compute<ReadSolverParameter & {
-    /** Max rows to return (solver max 500, default 100). */
+    /** Explicit page size (solver max 500, default 100). Omit both limit and offset to read all pages. */
     limit?: number;
     /** Row offset for pagination (default 0). */
     offset?: number;
@@ -30,7 +30,8 @@ export type GetSymbolsReturnType = SolverSymbol[];
  * Fetch the tradable symbol catalogue from the chain's solver `/symbols`
  * endpoint. Returns a normalized {@link SolverSymbol} per row — id, name,
  * precisions, leverage, fees, and per-side trading state — filtered and paged by
- * the given `parameters`. The solver base URL is resolved from `config` per call,
+ * the given `parameters`. With neither `limit` nor `offset`, reads every page
+ * in server order. Supplying either retains explicit single-page behavior. The solver base URL is resolved from `config` per call,
  * so multiple chains never clobber each other.
  *
  * `/symbols` is an **Enigma-only** endpoint; the action asserts the resolved

package/dist/solvers/symbols/get-symbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-symbols.d.ts","sourceRoot":"","sources":["../../../src/solvers/symbols/get-symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIlF,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,mBAAmB,GAAG;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,sCAAsC;IACtC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,uCAAuC;IACvC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CACF,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,YAAY,EAAE,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,oBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAIrH"}
+{"version":3,"file":"get-symbols.d.ts","sourceRoot":"","sources":["../../../src/solvers/symbols/get-symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIlF,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,mBAAmB,GAAG;IACpB,sGAAsG;IACtG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,sCAAsC;IACtC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,uCAAuC;IACvC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CACF,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,YAAY,EAAE,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,oBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAcrH"}

package/dist/solvers/symbols/get-symbols.js

@@ -9,11 +9,21 @@ async function o(e, t = {}) {
 		chainId: t.chainId,
 		solverId: t.solverId
 	});
-	return r(n, "enigma", "getSymbols"), s(n.url, t);
+	if (r(n, "enigma", "getSymbols"), t.limit !== void 0 || t.offset !== void 0) return (await s(n.url, t)).symbols;
+	let i = [];
+	for (let e = 0;; e += 500) {
+		let r = await s(n.url, {
+			...t,
+			limit: 500,
+			offset: e
+		});
+		if (i.push(...r.symbols), r.rawCount < 500) break;
+	}
+	return i;
 }
 async function s(r, o) {
 	try {
-		return i((await n({
+		let e = (await n({
 			limit: o.limit,
 			offset: o.offset,
 			symbol_id: o.symbolId,
@@ -23,7 +33,11 @@ async function s(r, o) {
 			is_valid: o.isValid,
 			state_long: o.stateLong,
 			state_short: o.stateShort
-		}, { baseURL: r })).data.symbols ?? []);
+		}, { baseURL: r })).data.symbols ?? [];
+		return {
+			symbols: i(e),
+			rawCount: e.length
+		};
 	} catch (n) {
 		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
 			code: "FETCH_SYMBOLS_FAILED",

package/dist/solvers/symbols/get-symbols.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-symbols.js","names":[],"sources":["../../../src/solvers/symbols/get-symbols.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 { assertSolverKind } from \"../assert-solver-kind\";\nimport { getSymbols as requestSymbols } from \"../types/generated/enigma-solver\";\nimport { toSolverSymbols } from \"./to-solver-symbol\";\nimport type { SolverSymbol, SymbolStateFilter, SymbolValidityFilter } from \"./types\";\n\n/**\n * Parameters for {@link getSymbols}.\n */\nexport type GetSymbolsParameters = Compute<\n  ReadSolverParameter & {\n    /** Max rows to return (solver max 500, default 100). */\n    limit?: number;\n    /** Row offset for pagination (default 0). */\n    offset?: number;\n    /** Restrict to a single symbol by its numeric id. */\n    symbolId?: number;\n    /** Case-insensitive substring match on the symbol name. */\n    search?: string;\n    /** Exact-match filter on the base asset. */\n    asset?: string;\n    /** Exact-match filter on the collateral token address. */\n    tokenAddress?: string;\n    /** Validity filter; the solver defaults to `\"true\"` (valid symbols only). */\n    isValid?: SymbolValidityFilter;\n    /** Long-side trading-state filter. */\n    stateLong?: SymbolStateFilter;\n    /** Short-side trading-state filter. */\n    stateShort?: SymbolStateFilter;\n  }\n>;\n\n/** Return type of {@link getSymbols}: one entry per symbol. */\nexport type GetSymbolsReturnType = SolverSymbol[];\n\n/**\n * Fetch the tradable symbol catalogue from the chain's solver `/symbols`\n * endpoint. Returns a normalized {@link SolverSymbol} per row — id, name,\n * precisions, leverage, fees, and per-side trading state — filtered and paged by\n * the given `parameters`. The solver base URL is resolved from `config` per call,\n * so multiple chains never clobber each other.\n *\n * `/symbols` is an **Enigma-only** endpoint; the action asserts the resolved\n * solver is an `enigma` solver and throws before hitting the wire otherwise.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain id, solver id, and `/symbols` filters.\n * @returns Normalized symbols, one {@link SolverSymbol} per row.\n * @throws {SymmApiError} when the API request fails.\n * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver, or when the chain is unsupported.\n *\n * @example\n * ```ts\n * const symbols = await getSymbols(config, { search: \"BTC\" });\n * const btc = symbols.find((s) => s.name === \"BTCUSDT\");\n * console.log(btc?.maxLeverage);\n * ```\n */\nexport async function getSymbols(config: Config, parameters: GetSymbolsParameters = {}): Promise<GetSymbolsReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getSymbols\");\n  return fetchSymbols(solver.url, parameters);\n}\n\n/**\n * Call the solver's `/symbols` endpoint with a per-call base URL, mapping the\n * SDK's camelCase filters onto the generated snake_case query params, and\n * normalize the response rows into the SDK's stable array.\n *\n * @internal\n */\nasync function fetchSymbols(baseURL: string, parameters: GetSymbolsParameters): Promise<SolverSymbol[]> {\n  try {\n    const response = await requestSymbols(\n      {\n        limit: parameters.limit,\n        offset: parameters.offset,\n        symbol_id: parameters.symbolId,\n        search: parameters.search,\n        asset: parameters.asset,\n        token_address: parameters.tokenAddress,\n        is_valid: parameters.isValid,\n        state_long: parameters.stateLong,\n        state_short: parameters.stateShort,\n      },\n      { baseURL },\n    );\n    return toSolverSymbols(response.data.symbols ?? []);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_SYMBOLS_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_SYMBOLS_FAILED\",\n      `Failed to fetch symbols: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA6DA,eAAsB,EAAW,GAAgB,IAAmC,CAAC,GAAkC;CACrH,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAE9F,OADA,EAAiB,GAAQ,UAAU,YAAY,GACxC,EAAa,EAAO,KAAK,CAAU;AAC5C;AASA,eAAe,EAAa,GAAiB,GAA2D;CACtG,IAAI;EAeF,OAAO,GAAgB,MAdA,EACrB;GACE,OAAO,EAAW;GAClB,QAAQ,EAAW;GACnB,WAAW,EAAW;GACtB,QAAQ,EAAW;GACnB,OAAO,EAAW;GAClB,eAAe,EAAW;GAC1B,UAAU,EAAW;GACrB,YAAY,EAAW;GACvB,aAAa,EAAW;EAC1B,GACA,EAAE,WAAQ,CACZ,GACgC,KAAK,WAAW,CAAC,CAAC;CACpD,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAAwB;EAAQ,CAAC,IAGvE,IAAI,EACR,OACA,wBACA,4BAA4B,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAC3E,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}
+{"version":3,"file":"get-symbols.js","names":[],"sources":["../../../src/solvers/symbols/get-symbols.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 { assertSolverKind } from \"../assert-solver-kind\";\nimport { getSymbols as requestSymbols } from \"../types/generated/enigma-solver\";\nimport { toSolverSymbols } from \"./to-solver-symbol\";\nimport type { SolverSymbol, SymbolStateFilter, SymbolValidityFilter } from \"./types\";\n\n/**\n * Parameters for {@link getSymbols}.\n */\nexport type GetSymbolsParameters = Compute<\n  ReadSolverParameter & {\n    /** Explicit page size (solver max 500, default 100). Omit both limit and offset to read all pages. */\n    limit?: number;\n    /** Row offset for pagination (default 0). */\n    offset?: number;\n    /** Restrict to a single symbol by its numeric id. */\n    symbolId?: number;\n    /** Case-insensitive substring match on the symbol name. */\n    search?: string;\n    /** Exact-match filter on the base asset. */\n    asset?: string;\n    /** Exact-match filter on the collateral token address. */\n    tokenAddress?: string;\n    /** Validity filter; the solver defaults to `\"true\"` (valid symbols only). */\n    isValid?: SymbolValidityFilter;\n    /** Long-side trading-state filter. */\n    stateLong?: SymbolStateFilter;\n    /** Short-side trading-state filter. */\n    stateShort?: SymbolStateFilter;\n  }\n>;\n\n/** Return type of {@link getSymbols}: one entry per symbol. */\nexport type GetSymbolsReturnType = SolverSymbol[];\n\n/**\n * Fetch the tradable symbol catalogue from the chain's solver `/symbols`\n * endpoint. Returns a normalized {@link SolverSymbol} per row — id, name,\n * precisions, leverage, fees, and per-side trading state — filtered and paged by\n * the given `parameters`. With neither `limit` nor `offset`, reads every page\n * in server order. Supplying either retains explicit single-page behavior. The solver base URL is resolved from `config` per call,\n * so multiple chains never clobber each other.\n *\n * `/symbols` is an **Enigma-only** endpoint; the action asserts the resolved\n * solver is an `enigma` solver and throws before hitting the wire otherwise.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain id, solver id, and `/symbols` filters.\n * @returns Normalized symbols, one {@link SolverSymbol} per row.\n * @throws {SymmApiError} when the API request fails.\n * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver, or when the chain is unsupported.\n *\n * @example\n * ```ts\n * const symbols = await getSymbols(config, { search: \"BTC\" });\n * const btc = symbols.find((s) => s.name === \"BTCUSDT\");\n * console.log(btc?.maxLeverage);\n * ```\n */\nexport async function getSymbols(config: Config, parameters: GetSymbolsParameters = {}): Promise<GetSymbolsReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getSymbols\");\n  if (parameters.limit !== undefined || parameters.offset !== undefined) {\n    return (await fetchSymbols(solver.url, parameters)).symbols;\n  }\n  const result: SolverSymbol[] = [];\n  const pageSize = 500;\n  for (let offset = 0; ; offset += pageSize) {\n    const page = await fetchSymbols(solver.url, { ...parameters, limit: pageSize, offset });\n    result.push(...page.symbols);\n    if (page.rawCount < pageSize) break;\n  }\n  return result;\n}\n\n/**\n * Call the solver's `/symbols` endpoint with a per-call base URL, mapping the\n * SDK's camelCase filters onto the generated snake_case query params, and\n * normalize the response rows into the SDK's stable array.\n *\n * @internal\n */\nasync function fetchSymbols(\n  baseURL: string,\n  parameters: GetSymbolsParameters,\n): Promise<{ symbols: SolverSymbol[]; rawCount: number }> {\n  try {\n    const response = await requestSymbols(\n      {\n        limit: parameters.limit,\n        offset: parameters.offset,\n        symbol_id: parameters.symbolId,\n        search: parameters.search,\n        asset: parameters.asset,\n        token_address: parameters.tokenAddress,\n        is_valid: parameters.isValid,\n        state_long: parameters.stateLong,\n        state_short: parameters.stateShort,\n      },\n      { baseURL },\n    );\n    const rows = response.data.symbols ?? [];\n    return { symbols: toSolverSymbols(rows), rawCount: rows.length };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_SYMBOLS_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_SYMBOLS_FAILED\",\n      `Failed to fetch symbols: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA8DA,eAAsB,EAAW,GAAgB,IAAmC,CAAC,GAAkC;CACrH,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAE9F,IADA,EAAiB,GAAQ,UAAU,YAAY,GAC3C,EAAW,UAAU,KAAA,KAAa,EAAW,WAAW,KAAA,GAC1D,QAAQ,MAAM,EAAa,EAAO,KAAK,CAAU,GAAG;CAEtD,IAAM,IAAyB,CAAC;CAEhC,KAAK,IAAI,IAAS,IAAK,KAAU,KAAU;EACzC,IAAM,IAAO,MAAM,EAAa,EAAO,KAAK;GAAE,GAAG;GAAY,OAAO;GAAU;EAAO,CAAC;EAEtF,IADA,EAAO,KAAK,GAAG,EAAK,OAAO,GACvB,EAAK,WAAW,KAAU;CAChC;CACA,OAAO;AACT;AASA,eAAe,EACb,GACA,GACwD;CACxD,IAAI;EAeF,IAAM,KAAO,MAdU,EACrB;GACE,OAAO,EAAW;GAClB,QAAQ,EAAW;GACnB,WAAW,EAAW;GACtB,QAAQ,EAAW;GACnB,OAAO,EAAW;GAClB,eAAe,EAAW;GAC1B,UAAU,EAAW;GACrB,YAAY,EAAW;GACvB,aAAa,EAAW;EAC1B,GACA,EAAE,WAAQ,CACZ,GACsB,KAAK,WAAW,CAAC;EACvC,OAAO;GAAE,SAAS,EAAgB,CAAI;GAAG,UAAU,EAAK;EAAO;CACjE,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAAwB;EAAQ,CAAC,IAGvE,IAAI,EACR,OACA,wBACA,4BAA4B,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAC3E,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/solvers/trade-volume/get-trade-volume.d.ts

@@ -13,7 +13,8 @@ export type GetTradeVolumeReturnType = SolverDailyVolume[];
 /**
  * Fetch the last N daily trade-volume rows for one market from the chain's
  * enigma solver `/trade-volume/{symbol_id}` endpoint. Rows are returned in
- * ascending day order. The solver base URL is resolved from `config` per call,
+ * ascending day order. Malformed rows (invalid timestamp or absent/non-numeric
+ * volume) are omitted, while genuine zero-volume observations are retained. The solver base URL is resolved from `config` per call,
  * so multiple chains never clobber each other.
  *
  * `/trade-volume/{symbol_id}` is an **Enigma-only** endpoint; the action asserts

package/dist/solvers/trade-volume/get-trade-volume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-trade-volume.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/get-trade-volume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,mBAAmB,GAAG;IACpB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,EAAE,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,wBAAwB,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAInC"}
+{"version":3,"file":"get-trade-volume.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/get-trade-volume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,mBAAmB,GAAG;IACpB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,EAAE,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,wBAAwB,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAInC"}

package/dist/solvers/trade-volume/get-trade-volume.js

@@ -13,7 +13,8 @@ async function o(e, t) {
 }
 async function s(r, o) {
 	try {
-		return ((await n(o, { baseURL: r })).data ?? []).map(i);
+		let e = await n(o, { baseURL: r });
+		return (Array.isArray(e.data) ? e.data : []).filter(c).map(i);
 	} catch (n) {
 		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
 			code: "FETCH_TRADE_VOLUME_FAILED",
@@ -21,6 +22,10 @@ async function s(r, o) {
 		}) : new t("api", "FETCH_TRADE_VOLUME_FAILED", `Failed to fetch trade volume: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
 	}
 }
+function c(e) {
+	let t = e?.timestamp, n = e?.volume;
+	return typeof t == "string" && t.trim().length > 0 && Number.isFinite(Date.parse(t)) && typeof n == "string" && n.trim().length > 0 && Number.isFinite(Number(n));
+}
 //#endregion
 export { o as getTradeVolume };
 

package/dist/solvers/trade-volume/get-trade-volume.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-trade-volume.js","names":[],"sources":["../../../src/solvers/trade-volume/get-trade-volume.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 { assertSolverKind } from \"../assert-solver-kind\";\nimport { getTradeVolumeSymbolId } from \"../types/generated/enigma-solver\";\nimport { toSolverDailyVolume } from \"./to-daily-volume\";\nimport type { SolverDailyVolume } from \"./types\";\n\n/**\n * Parameters for {@link getTradeVolume}.\n */\nexport type GetTradeVolumeParameters = Compute<\n  ReadSolverParameter & {\n    /** Solver market id (`symbol_id`) to read daily trade volume for. Required. */\n    symbolId: number;\n  }\n>;\n\n/** Return type of {@link getTradeVolume}: one entry per day, ascending. */\nexport type GetTradeVolumeReturnType = SolverDailyVolume[];\n\n/**\n * Fetch the last N daily trade-volume rows for one market from the chain's\n * enigma solver `/trade-volume/{symbol_id}` endpoint. Rows are returned in\n * ascending day order. The solver base URL is resolved from `config` per call,\n * so multiple chains never clobber each other.\n *\n * `/trade-volume/{symbol_id}` is an **Enigma-only** endpoint; the action asserts\n * the resolved solver is an `enigma` solver and throws before hitting the wire\n * otherwise.\n *\n * @param config - The SDK config.\n * @param parameters - The required `symbolId` plus optional chain id / solver.\n * @returns Normalized daily volume, one {@link SolverDailyVolume} per day.\n * @throws {SymmApiError} when the API request fails.\n * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver, or when the chain is unsupported.\n *\n * @example\n * ```ts\n * const volume = await getTradeVolume(config, { symbolId: 1 });\n * const latest = volume.at(-1);\n * console.log(latest?.volume); // notional traded on the most recent day\n * ```\n */\nexport async function getTradeVolume(\n  config: Config,\n  parameters: GetTradeVolumeParameters,\n): Promise<GetTradeVolumeReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getTradeVolume\");\n  return fetchTradeVolume(solver.url, parameters.symbolId);\n}\n\n/**\n * Call the solver's `/trade-volume/{symbol_id}` endpoint with a per-call base URL\n * and map each raw daily row into the SDK's normalized array.\n *\n * @internal\n */\nasync function fetchTradeVolume(baseURL: string, symbolId: number): Promise<SolverDailyVolume[]> {\n  try {\n    const response = await getTradeVolumeSymbolId(symbolId, { baseURL });\n    return (response.data ?? []).map(toSolverDailyVolume);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_TRADE_VOLUME_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_TRADE_VOLUME_FAILED\",\n      `Failed to fetch trade volume: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA6CA,eAAsB,EACpB,GACA,GACmC;CACnC,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAE9F,OADA,EAAiB,GAAQ,UAAU,gBAAgB,GAC5C,EAAiB,EAAO,KAAK,EAAW,QAAQ;AACzD;AAQA,eAAe,EAAiB,GAAiB,GAAgD;CAC/F,IAAI;EAEF,SAAQ,MADe,EAAuB,GAAU,EAAE,WAAQ,CAAC,GAClD,QAAQ,CAAC,GAAG,IAAI,CAAmB;CACtD,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA6B;EAAQ,CAAC,IAG5E,IAAI,EACR,OACA,6BACA,iCAAiC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAChF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}
+{"version":3,"file":"get-trade-volume.js","names":[],"sources":["../../../src/solvers/trade-volume/get-trade-volume.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 { assertSolverKind } from \"../assert-solver-kind\";\nimport { getTradeVolumeSymbolId, type ApiDailyTradeVolumeResponse } from \"../types/generated/enigma-solver\";\nimport { toSolverDailyVolume } from \"./to-daily-volume\";\nimport type { SolverDailyVolume } from \"./types\";\n\n/**\n * Parameters for {@link getTradeVolume}.\n */\nexport type GetTradeVolumeParameters = Compute<\n  ReadSolverParameter & {\n    /** Solver market id (`symbol_id`) to read daily trade volume for. Required. */\n    symbolId: number;\n  }\n>;\n\n/** Return type of {@link getTradeVolume}: one entry per day, ascending. */\nexport type GetTradeVolumeReturnType = SolverDailyVolume[];\n\n/**\n * Fetch the last N daily trade-volume rows for one market from the chain's\n * enigma solver `/trade-volume/{symbol_id}` endpoint. Rows are returned in\n * ascending day order. Malformed rows (invalid timestamp or absent/non-numeric\n * volume) are omitted, while genuine zero-volume observations are retained. The solver base URL is resolved from `config` per call,\n * so multiple chains never clobber each other.\n *\n * `/trade-volume/{symbol_id}` is an **Enigma-only** endpoint; the action asserts\n * the resolved solver is an `enigma` solver and throws before hitting the wire\n * otherwise.\n *\n * @param config - The SDK config.\n * @param parameters - The required `symbolId` plus optional chain id / solver.\n * @returns Normalized daily volume, one {@link SolverDailyVolume} per day.\n * @throws {SymmApiError} when the API request fails.\n * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver, or when the chain is unsupported.\n *\n * @example\n * ```ts\n * const volume = await getTradeVolume(config, { symbolId: 1 });\n * const latest = volume.at(-1);\n * console.log(latest?.volume); // notional traded on the most recent day\n * ```\n */\nexport async function getTradeVolume(\n  config: Config,\n  parameters: GetTradeVolumeParameters,\n): Promise<GetTradeVolumeReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getTradeVolume\");\n  return fetchTradeVolume(solver.url, parameters.symbolId);\n}\n\n/**\n * Call the solver's `/trade-volume/{symbol_id}` endpoint with a per-call base URL\n * and map each raw daily row into the SDK's normalized array.\n *\n * @internal\n */\nasync function fetchTradeVolume(baseURL: string, symbolId: number): Promise<SolverDailyVolume[]> {\n  try {\n    const response = await getTradeVolumeSymbolId(symbolId, { baseURL });\n    const rows = Array.isArray(response.data) ? response.data : [];\n    return rows.filter(isValidDailyVolume).map(toSolverDailyVolume);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_TRADE_VOLUME_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_TRADE_VOLUME_FAILED\",\n      `Failed to fetch trade volume: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n\n/** Validate wire observations before the public mapper applies its legacy defaults. */\nfunction isValidDailyVolume(raw: ApiDailyTradeVolumeResponse | null | undefined): raw is SolverDailyVolume {\n  const timestamp = raw?.timestamp;\n  const volume = raw?.volume;\n  return (\n    typeof timestamp === \"string\" &&\n    timestamp.trim().length > 0 &&\n    Number.isFinite(Date.parse(timestamp)) &&\n    typeof volume === \"string\" &&\n    volume.trim().length > 0 &&\n    Number.isFinite(Number(volume))\n  );\n}\n"],"mappings":";;;;;;AA8CA,eAAsB,EACpB,GACA,GACmC;CACnC,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAE9F,OADA,EAAiB,GAAQ,UAAU,gBAAgB,GAC5C,EAAiB,EAAO,KAAK,EAAW,QAAQ;AACzD;AAQA,eAAe,EAAiB,GAAiB,GAAgD;CAC/F,IAAI;EACF,IAAM,IAAW,MAAM,EAAuB,GAAU,EAAE,WAAQ,CAAC;EAEnE,QADa,MAAM,QAAQ,EAAS,IAAI,IAAI,EAAS,OAAO,CAAC,GACjD,OAAO,CAAkB,EAAE,IAAI,CAAmB;CAChE,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA6B;EAAQ,CAAC,IAG5E,IAAI,EACR,OACA,6BACA,iCAAiC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAChF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF;AAGA,SAAS,EAAmB,GAA+E;CACzG,IAAM,IAAY,GAAK,WACjB,IAAS,GAAK;CACpB,OACE,OAAO,KAAc,YACrB,EAAU,KAAK,EAAE,SAAS,KAC1B,OAAO,SAAS,KAAK,MAAM,CAAS,CAAC,KACrC,OAAO,KAAW,YAClB,EAAO,KAAK,EAAE,SAAS,KACvB,OAAO,SAAS,OAAO,CAAM,CAAC;AAElC"}

package/dist/solvers/trade-volume/to-daily-volume.d.ts

@@ -1,12 +1,12 @@
 import { ApiDailyTradeVolumeResponse } from '../types/generated/enigma-solver.js';
 import { SolverDailyVolume } from './types.js';
 /**
- * Map one raw `/trade-volume/{symbol_id}` row into the SDK's
- * {@link SolverDailyVolume}. The timestamp is the solver's ISO 8601 datetime
- * string, passed through unchanged; a missing timestamp or volume defaults to
- * `""` / `"0"`.
- *
- * @param raw - One raw daily-volume row from the solver.
+ * Map one daily observation, preserving the existing missing-field defaults.
+ * This mapper does not validate rows; getTradeVolume filters malformed input first.
+ * @param raw - One raw daily-volume object from the solver.
+ * @returns A row with unchanged strings; missing timestamp/volume default to ""/"0".
+ * @throws Does not throw for inputs matching the declared type.
+ * @example toSolverDailyVolume({ timestamp: "2026-10-17T00:00:00Z", volume: "0" });
  */
 export declare function toSolverDailyVolume(raw: ApiDailyTradeVolumeResponse): SolverDailyVolume;
 //# sourceMappingURL=to-daily-volume.d.ts.map

package/dist/solvers/trade-volume/to-daily-volume.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-daily-volume.js","names":[],"sources":["../../../src/solvers/trade-volume/to-daily-volume.ts"],"sourcesContent":["import type { ApiDailyTradeVolumeResponse } from \"../types/generated/enigma-solver\";\nimport type { SolverDailyVolume } from \"./types\";\n\n/**\n * Map one raw `/trade-volume/{symbol_id}` row into the SDK's\n * {@link SolverDailyVolume}. The timestamp is the solver's ISO 8601 datetime\n * string, passed through unchanged; a missing timestamp or volume defaults to\n * `\"\"` / `\"0\"`.\n *\n * @param raw - One raw daily-volume row from the solver.\n */\nexport function toSolverDailyVolume(raw: ApiDailyTradeVolumeResponse): SolverDailyVolume {\n  return {\n    timestamp: raw.timestamp ?? \"\",\n    volume: raw.volume ?? \"0\",\n  };\n}\n"],"mappings":";AAWA,SAAgB,EAAoB,GAAqD;CACvF,OAAO;EACL,WAAW,EAAI,aAAa;EAC5B,QAAQ,EAAI,UAAU;CACxB;AACF"}
+{"version":3,"file":"to-daily-volume.js","names":[],"sources":["../../../src/solvers/trade-volume/to-daily-volume.ts"],"sourcesContent":["import type { ApiDailyTradeVolumeResponse } from \"../types/generated/enigma-solver\";\nimport type { SolverDailyVolume } from \"./types\";\n\n/**\n * Map one daily observation, preserving the existing missing-field defaults.\n * This mapper does not validate rows; getTradeVolume filters malformed input first.\n * @param raw - One raw daily-volume object from the solver.\n * @returns A row with unchanged strings; missing timestamp/volume default to \"\"/\"0\".\n * @throws Does not throw for inputs matching the declared type.\n * @example toSolverDailyVolume({ timestamp: \"2026-10-17T00:00:00Z\", volume: \"0\" });\n */\nexport function toSolverDailyVolume(raw: ApiDailyTradeVolumeResponse): SolverDailyVolume {\n  return {\n    timestamp: raw.timestamp ?? \"\",\n    volume: raw.volume ?? \"0\",\n  };\n}\n"],"mappings":";AAWA,SAAgB,EAAoB,GAAqD;CACvF,OAAO;EACL,WAAW,EAAI,aAAa;EAC5B,QAAQ,EAAI,UAAU;CACxB;AACF"}

package/dist/solvers/trade-volume/types.d.ts

@@ -9,12 +9,13 @@
 export interface SolverDailyVolume {
     /**
      * The day bucket, as the ISO 8601 datetime string the solver reports (e.g.
-     * `"2026-07-09T00:00:00Z"`, midnight UTC on the bucket's day). Empty string
-     * when the solver omits it. Parse with `new Date(timestamp)` to render;
+     * `"2026-07-09T00:00:00Z"`, midnight UTC on the bucket's day). getTradeVolume
+     * omits rows with missing or invalid timestamps; direct toSolverDailyVolume
+     * calls retain the empty-string fallback. Parse with `new Date(timestamp)` to render;
      * ISO 8601 also sorts correctly as a plain string.
      */
     timestamp: string;
-    /** Notional traded that day, as the decimal string the solver reports (`"0"` when absent). */
+    /** Decimal volume, unchanged. getTradeVolume omits missing values; direct mapper calls default them to "0". */
     volume: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/solvers/trade-volume/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,+GAA+G;IAC/G,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/solvers/types/generated/enigma-solver.js

@@ -6,7 +6,7 @@ var t = (t) => e.get("/contract-symbols", t), n = (t) => e.get("/error_codes", t
 		...t,
 		...n?.params
 	}
-}), i = (t, n) => e.get("/get_funding_info", {
+}), i = (t, n) => e.get("/funding-info", {
 	...n,
 	params: {
 		...t,
@@ -18,7 +18,7 @@ var t = (t) => e.get("/contract-symbols", t), n = (t) => e.get("/error_codes", t
 		...n,
 		...r?.params
 	}
-}), o = (t) => e.get("/get_market_info", t), s = (t) => e.get("/info", t), c = (t, n) => e.get(`/instant_close/${t}`, n), l = (t, n) => e.get(`/instant_open/${t}`, n), u = (t, n) => e.get(`/instant_quote_id/${t}`, n), d = (t, n) => e.post("/instant_trade/instant_close", t, n), f = (t, n) => e.post("/instant_trade/instant_open", t, n), p = (t, n) => e.get("/notional_cap", {
+}), o = (t) => e.get("/info", t), s = (t, n) => e.get(`/instant_close/${t}`, n), c = (t, n) => e.get(`/instant_open/${t}`, n), l = (t, n) => e.get(`/instant_quote_id/${t}`, n), u = (t, n) => e.post("/instant_trade/instant_close", t, n), d = (t, n) => e.post("/instant_trade/instant_open", t, n), f = (t) => e.get("/market-info", t), p = (t, n) => e.get("/notional_cap", {
 	...n,
 	params: {
 		...t,
@@ -44,6 +44,6 @@ var t = (t) => e.get("/contract-symbols", t), n = (t) => e.get("/error_codes", t
 	}
 }), v = (t, n) => e.get(`/trade-volume/${t}`, n);
 //#endregion
-export { t as getContractSymbols, n as getErrorCodes, r as getEstimatedPrice, i as getGetFundingInfo, a as getGetLockedParamsSymbol, o as getGetMarketInfo, s as getInfo, c as getInstantCloseAccountAddress, l as getInstantOpenAccountAddress, u as getInstantQuoteIdTempQuoteId, p as getNotionalCap, m as getNotionalCapSymbolId, h as getRevenueRecords, g as getRevenueSymbolId, _ as getSymbols, v as getTradeVolumeSymbolId, d as postInstantTradeInstantClose, f as postInstantTradeInstantOpen };
+export { t as getContractSymbols, n as getErrorCodes, r as getEstimatedPrice, i as getFundingInfo, a as getGetLockedParamsSymbol, o as getInfo, s as getInstantCloseAccountAddress, c as getInstantOpenAccountAddress, l as getInstantQuoteIdTempQuoteId, f as getMarketInfo, p as getNotionalCap, m as getNotionalCapSymbolId, h as getRevenueRecords, g as getRevenueSymbolId, _ as getSymbols, v as getTradeVolumeSymbolId, u as postInstantTradeInstantClose, d as postInstantTradeInstantOpen };
 
 //# sourceMappingURL=enigma-solver.js.map