@symmio/trading-core 1.0.1 → 2.0.0

package/dist/solvers/revenue/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Trailing window a revenue read is scoped to.
+ *
+ * A closed set: the solver validates it and rejects anything else with
+ * `TimeRange must be one of [1h 24h 7d 30d lifetime]`. `"lifetime"` is also the
+ * default when the parameter is omitted.
+ */
+export type SolverRevenueTimeRange = "1h" | "24h" | "7d" | "30d" | "lifetime";
+/**
+ * Revenue totals for a window, split by where the revenue came from.
+ *
+ * Every figure is a plain `number` in the **dollar units the solver already
+ * reports** — no decimal scaling (`165.49` means $165.49). `totalRevenue` is the
+ * sum of {@link SolverRevenue.hedgerFeeRevenue} and
+ * {@link SolverRevenue.fundingRevenue}.
+ */
+export interface SolverRevenue {
+    /** Total revenue over the window (dollars). */
+    totalRevenue: number;
+    /** The share earned from hedger fees (dollars). */
+    hedgerFeeRevenue: number;
+    /** The share earned from funding payments (dollars). */
+    fundingRevenue: number;
+    /**
+     * Number of underlying revenue rows behind the totals.
+     *
+     * Worth surfacing: it separates "the window genuinely earned nothing"
+     * (`recordCount > 0`, totals `0`) from "there is no data for this window"
+     * (`recordCount === 0`).
+     */
+    recordCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/solvers/revenue/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/solvers/revenue/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/solvers/revenue-records/get-revenue-records.d.ts

@@ -0,0 +1,36 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../shared/types/properties.js';
+import { GetRevenueRecordsReturnType } from './types.js';
+/**
+ * Parameters for {@link getRevenueRecords}.
+ */
+export type GetRevenueRecordsParameters = Compute<ReadSolverParameter & {
+    /** Last-seen revenue record id, used as the cursor for the next page. */
+    id?: number;
+    /** Restrict the result to these market symbol ids (max 100). */
+    symbolIds?: readonly number[];
+    /** Number of records to skip before the page. */
+    offset?: number;
+    /** Maximum number of records to return (max 500, default 100). */
+    limit?: number;
+}>;
+/**
+ * Fetch incremental revenue records from the chain's solver `/revenue/records`
+ * endpoint. Records are cursor-paginated: pass the `id` of the last record seen
+ * to fetch the next page. The solver base URL is resolved from `config` per
+ * call, so multiple chains never clobber each other.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain id, cursor `id`, `symbolIds` filter, and paging.
+ * @returns The page of normalized revenue records plus the total available count.
+ * @throws {SymmApiError} when the API request fails.
+ * @throws {SymmError} when the chain is unsupported.
+ *
+ * @example
+ * ```ts
+ * const { records, count } = await getRevenueRecords(config, { limit: 50 });
+ * const nextCursor = records.at(-1)?.id;
+ * ```
+ */
+export declare function getRevenueRecords(config: Config, parameters?: GetRevenueRecordsParameters): Promise<GetRevenueRecordsReturnType>;
+//# sourceMappingURL=get-revenue-records.d.ts.map

package/dist/solvers/revenue-records/get-revenue-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-revenue-records.d.ts","sourceRoot":"","sources":["../../../src/solvers/revenue-records/get-revenue-records.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,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAC/C,mBAAmB,GAAG;IACpB,yEAAyE;IACzE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,2BAAgC,GAC3C,OAAO,CAAC,2BAA2B,CAAC,CAItC"}

package/dist/solvers/revenue-records/get-revenue-records.js

@@ -0,0 +1,36 @@
+import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
+import { getRevenueRecords as n } from "../types/generated/enigma-solver.js";
+import { assertSolverKind as r } from "../assert-solver-kind.js";
+import { toRevenueRecord as i } from "./to-revenue-record.js";
+import { isAxiosError as a } from "axios";
+//#region src/solvers/revenue-records/get-revenue-records.ts
+async function o(e, t = {}) {
+	let n = e.getSolver({
+		chainId: t.chainId,
+		solverId: t.solverId
+	});
+	return r(n, "enigma", "getRevenueRecords"), s(n.url, t);
+}
+async function s(r, o) {
+	try {
+		let e = await n({
+			id: o.id,
+			symbolIds: o.symbolIds ? [...o.symbolIds] : void 0,
+			offset: o.offset,
+			limit: o.limit
+		}, { baseURL: r });
+		return {
+			records: (e.data.records ?? []).map(i),
+			count: e.data.count ?? 0
+		};
+	} catch (n) {
+		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
+			code: "FETCH_REVENUE_RECORDS_FAILED",
+			baseURL: r
+		}) : new t("api", "FETCH_REVENUE_RECORDS_FAILED", `Failed to fetch revenue records: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { o as getRevenueRecords };
+
+//# sourceMappingURL=get-revenue-records.js.map

package/dist/solvers/revenue-records/get-revenue-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-revenue-records.js","names":[],"sources":["../../../src/solvers/revenue-records/get-revenue-records.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 { getRevenueRecords as requestRevenueRecords } from \"../types/generated/enigma-solver\";\nimport { toRevenueRecord } from \"./to-revenue-record\";\nimport type { GetRevenueRecordsReturnType } from \"./types\";\n\n/**\n * Parameters for {@link getRevenueRecords}.\n */\nexport type GetRevenueRecordsParameters = Compute<\n  ReadSolverParameter & {\n    /** Last-seen revenue record id, used as the cursor for the next page. */\n    id?: number;\n    /** Restrict the result to these market symbol ids (max 100). */\n    symbolIds?: readonly number[];\n    /** Number of records to skip before the page. */\n    offset?: number;\n    /** Maximum number of records to return (max 500, default 100). */\n    limit?: number;\n  }\n>;\n\n/**\n * Fetch incremental revenue records from the chain's solver `/revenue/records`\n * endpoint. Records are cursor-paginated: pass the `id` of the last record seen\n * to fetch the next page. The solver base URL is resolved from `config` per\n * call, so multiple chains never clobber each other.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain id, cursor `id`, `symbolIds` filter, and paging.\n * @returns The page of normalized revenue records plus the total available count.\n * @throws {SymmApiError} when the API request fails.\n * @throws {SymmError} when the chain is unsupported.\n *\n * @example\n * ```ts\n * const { records, count } = await getRevenueRecords(config, { limit: 50 });\n * const nextCursor = records.at(-1)?.id;\n * ```\n */\nexport async function getRevenueRecords(\n  config: Config,\n  parameters: GetRevenueRecordsParameters = {},\n): Promise<GetRevenueRecordsReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getRevenueRecords\");\n  return fetchRevenueRecords(solver.url, parameters);\n}\n\n/**\n * Call the solver's `/revenue/records` endpoint with a per-call base URL and map\n * the response into the SDK's normalized shape.\n *\n * @internal\n */\nasync function fetchRevenueRecords(\n  baseURL: string,\n  parameters: GetRevenueRecordsParameters,\n): Promise<GetRevenueRecordsReturnType> {\n  try {\n    const response = await requestRevenueRecords(\n      {\n        id: parameters.id,\n        symbolIds: parameters.symbolIds ? [...parameters.symbolIds] : undefined,\n        offset: parameters.offset,\n        limit: parameters.limit,\n      },\n      { baseURL },\n    );\n    return {\n      records: (response.data.records ?? []).map(toRevenueRecord),\n      count: response.data.count ?? 0,\n    };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_REVENUE_RECORDS_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_REVENUE_RECORDS_FAILED\",\n      `Failed to fetch revenue records: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA2CA,eAAsB,EACpB,GACA,IAA0C,CAAC,GACL;CACtC,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAE9F,OADA,EAAiB,GAAQ,UAAU,mBAAmB,GAC/C,EAAoB,EAAO,KAAK,CAAU;AACnD;AAQA,eAAe,EACb,GACA,GACsC;CACtC,IAAI;EACF,IAAM,IAAW,MAAM,EACrB;GACE,IAAI,EAAW;GACf,WAAW,EAAW,YAAY,CAAC,GAAG,EAAW,SAAS,IAAI,KAAA;GAC9D,QAAQ,EAAW;GACnB,OAAO,EAAW;EACpB,GACA,EAAE,WAAQ,CACZ;EACA,OAAO;GACL,UAAU,EAAS,KAAK,WAAW,CAAC,GAAG,IAAI,CAAe;GAC1D,OAAO,EAAS,KAAK,SAAS;EAChC;CACF,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAAgC;EAAQ,CAAC,IAG/E,IAAI,EACR,OACA,gCACA,oCAAoC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KACnF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/solvers/revenue-records/index.d.ts

@@ -0,0 +1,5 @@
+export * from './get-revenue-records.js';
+export * from './query.js';
+export * from './to-revenue-record.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/solvers/revenue-records/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/revenue-records/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/solvers/revenue-records/query.d.ts

@@ -0,0 +1,29 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetRevenueRecordsParameters } from './get-revenue-records.js';
+import { GetRevenueRecordsReturnType } from './types.js';
+/** Data resolved by the {@link getRevenueRecordsQueryOptions} query. */
+export type GetRevenueRecordsData = GetRevenueRecordsReturnType;
+/** Build the TanStack Query key for {@link getRevenueRecordsQueryOptions}. */
+export declare function getRevenueRecordsQueryKey(options?: Compute<GetRevenueRecordsParameters & ConfigKeyParameter>): readonly ["getRevenueRecords", Record<string, unknown>];
+/** Query-key type produced by {@link getRevenueRecordsQueryKey}. */
+export type GetRevenueRecordsQueryKey = ReturnType<typeof getRevenueRecordsQueryKey>;
+/** Options accepted by {@link getRevenueRecordsQueryOptions}. */
+export type GetRevenueRecordsOptions = Compute<GetRevenueRecordsParameters & QueryParameter<GetRevenueRecordsData, Error, GetRevenueRecordsData, GetRevenueRecordsQueryKey>>;
+/** TanStack Query options returned by {@link getRevenueRecordsQueryOptions}. */
+export type GetRevenueRecordsQueryOptions = SymmioQueryOptions<GetRevenueRecordsData, Error, GetRevenueRecordsData, GetRevenueRecordsQueryKey>;
+/**
+ * Build TanStack Query options for {@link getRevenueRecords}.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters (optional `chainId`, cursor `id`, `symbolIds`, paging) and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getRevenueRecordsQueryOptions(config, { limit: 50 }));
+ * ```
+ */
+export declare function getRevenueRecordsQueryOptions(config: Config, options?: GetRevenueRecordsOptions): GetRevenueRecordsQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/solvers/revenue-records/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/solvers/revenue-records/query.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,EAAqB,KAAK,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAE3D,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEhE,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,OAAO,CAAC,2BAA2B,GAAG,kBAAkB,CAAM,2DAEhH;AAED,oEAAoE;AACpE,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErF,iEAAiE;AACjE,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,2BAA2B,GACzB,cAAc,CAAC,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,CAAC,CACjG,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,CAC5D,qBAAqB,EACrB,KAAK,EACL,qBAAqB,EACrB,yBAAyB,CAC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,6BAA6B,CAkB/B"}

package/dist/solvers/revenue-records/query.js

@@ -0,0 +1,28 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getRevenueRecords as t } from "./get-revenue-records.js";
+//#region src/solvers/revenue-records/query.ts
+function n(t = {}) {
+	return ["getRevenueRecords", 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,
+			id: r.id,
+			symbolIds: r.symbolIds,
+			offset: r.offset,
+			limit: r.limit
+		})
+	};
+}
+//#endregion
+export { n as getRevenueRecordsQueryKey, r as getRevenueRecordsQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/solvers/revenue-records/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/solvers/revenue-records/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 { getRevenueRecords, type GetRevenueRecordsParameters } from \"./get-revenue-records\";\nimport type { GetRevenueRecordsReturnType } from \"./types\";\n\n/** Data resolved by the {@link getRevenueRecordsQueryOptions} query. */\nexport type GetRevenueRecordsData = GetRevenueRecordsReturnType;\n\n/** Build the TanStack Query key for {@link getRevenueRecordsQueryOptions}. */\nexport function getRevenueRecordsQueryKey(options: Compute<GetRevenueRecordsParameters & ConfigKeyParameter> = {}) {\n  return [\"getRevenueRecords\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getRevenueRecordsQueryKey}. */\nexport type GetRevenueRecordsQueryKey = ReturnType<typeof getRevenueRecordsQueryKey>;\n\n/** Options accepted by {@link getRevenueRecordsQueryOptions}. */\nexport type GetRevenueRecordsOptions = Compute<\n  GetRevenueRecordsParameters &\n    QueryParameter<GetRevenueRecordsData, Error, GetRevenueRecordsData, GetRevenueRecordsQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getRevenueRecordsQueryOptions}. */\nexport type GetRevenueRecordsQueryOptions = SymmioQueryOptions<\n  GetRevenueRecordsData,\n  Error,\n  GetRevenueRecordsData,\n  GetRevenueRecordsQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getRevenueRecords}.\n *\n * @param config - The SDK config.\n * @param options - Query parameters (optional `chainId`, cursor `id`, `symbolIds`, paging) and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getRevenueRecordsQueryOptions(config, { limit: 50 }));\n * ```\n */\nexport function getRevenueRecordsQueryOptions(\n  config: Config,\n  options: GetRevenueRecordsOptions = {},\n): GetRevenueRecordsQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getRevenueRecordsQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getRevenueRecords(config, {\n        chainId: options.chainId,\n        solverId: options.solverId,\n        id: options.id,\n        symbolIds: options.symbolIds,\n        offset: options.offset,\n        limit: options.limit,\n      }),\n  };\n}\n"],"mappings":";;;AAWA,SAAgB,EAA0B,IAAqE,CAAC,GAAG;CACjH,OAAO,CAAC,qBAAqB,EAAmB,CAAO,CAAC;AAC1D;AA+BA,SAAgB,EACd,GACA,IAAoC,CAAC,GACN;CAC/B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA0B;GAClC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAkB,GAAQ;GACxB,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,IAAI,EAAQ;GACZ,WAAW,EAAQ;GACnB,QAAQ,EAAQ;GAChB,OAAO,EAAQ;EACjB,CAAC;CACL;AACF"}

package/dist/solvers/revenue-records/to-revenue-record.d.ts

@@ -0,0 +1,11 @@
+import { ApiRevenueRecordItem } from '../types/generated/enigma-solver.js';
+import { SolverRevenueRecord } from './types.js';
+/**
+ * Map one raw `ApiRevenueRecordItem` from the solver's `/revenue/records`
+ * response into the SDK's normalized {@link SolverRevenueRecord}. Missing fields
+ * default to `0` (numbers) or `""` (strings).
+ *
+ * @param raw - The raw revenue record item.
+ */
+export declare function toRevenueRecord(raw: ApiRevenueRecordItem): SolverRevenueRecord;
+//# sourceMappingURL=to-revenue-record.d.ts.map

package/dist/solvers/revenue-records/to-revenue-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-revenue-record.d.ts","sourceRoot":"","sources":["../../../src/solvers/revenue-records/to-revenue-record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,oBAAoB,GAAG,mBAAmB,CAO9E"}

package/dist/solvers/revenue-records/to-revenue-record.js

@@ -0,0 +1,13 @@
+//#region src/solvers/revenue-records/to-revenue-record.ts
+function e(e) {
+	return {
+		id: e.id ?? 0,
+		symbolId: e.symbol_id ?? 0,
+		amount: e.amount ?? "0",
+		createdAt: e.created_at ?? ""
+	};
+}
+//#endregion
+export { e as toRevenueRecord };
+
+//# sourceMappingURL=to-revenue-record.js.map

package/dist/solvers/revenue-records/to-revenue-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-revenue-record.js","names":[],"sources":["../../../src/solvers/revenue-records/to-revenue-record.ts"],"sourcesContent":["import type { ApiRevenueRecordItem } from \"../types/generated/enigma-solver\";\nimport type { SolverRevenueRecord } from \"./types\";\n\n/**\n * Map one raw `ApiRevenueRecordItem` from the solver's `/revenue/records`\n * response into the SDK's normalized {@link SolverRevenueRecord}. Missing fields\n * default to `0` (numbers) or `\"\"` (strings).\n *\n * @param raw - The raw revenue record item.\n */\nexport function toRevenueRecord(raw: ApiRevenueRecordItem): SolverRevenueRecord {\n  return {\n    id: raw.id ?? 0,\n    symbolId: raw.symbol_id ?? 0,\n    amount: raw.amount ?? \"0\",\n    createdAt: raw.created_at ?? \"\",\n  };\n}\n"],"mappings":";AAUA,SAAgB,EAAgB,GAAgD;CAC9E,OAAO;EACL,IAAI,EAAI,MAAM;EACd,UAAU,EAAI,aAAa;EAC3B,QAAQ,EAAI,UAAU;EACtB,WAAW,EAAI,cAAc;CAC/B;AACF"}

package/dist/solvers/revenue-records/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * One normalized revenue record from the Enigma solver's `/revenue/records`
+ * endpoint. Records are incremental: page through them with the `id` of the
+ * last record seen (see {@link GetRevenueRecordsReturnType.count}).
+ */
+export interface SolverRevenueRecord {
+    /** Monotonic record id, used as the cursor for incremental fetches. */
+    id: number;
+    /** Market symbol id this revenue record belongs to. */
+    symbolId: number;
+    /** Revenue amount as a decimal string, exactly as the solver reports it. */
+    amount: string;
+    /** Raw solver timestamp string for when the record was created. */
+    createdAt: string;
+}
+/** Return type of the revenue-records read: the page of records plus the total count. */
+export interface GetRevenueRecordsReturnType {
+    /** The page of normalized revenue records. */
+    records: SolverRevenueRecord[];
+    /**
+     * Total number of records available. Use with cursor pagination: pass the
+     * `id` of the last record seen to fetch the next page.
+     */
+    count: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/solvers/revenue-records/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/solvers/revenue-records/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yFAAyF;AACzF,MAAM,WAAW,2BAA2B;IAC1C,8CAA8C;IAC9C,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/solvers/shared/resolvers/resolve-mark-price.d.ts

@@ -1,20 +1,32 @@
+import { SolverId } from '../../../core/chains/types.js';
 import { Config } from '../../../core/config/index.js';
 /**
  * Parameters for {@link resolveMarkPrice}.
  */
 export interface ResolveMarkPriceParameters {
     chainId?: number;
+    /**
+     * Solver the trade targets. Its configured price provider supplies the mark.
+     * **Must match the solver the trade is sent to** — the resolved price is
+     * signed into the EIP-712 payload. Defaults to the chain's `defaultSolverId`.
+     */
+    solverId?: SolverId;
     marketName: string;
     markPrice?: string;
 }
 /**
- * Resolve a mark price for `marketName`. Returns the caller-supplied value
- * when present; otherwise fetches the Enigma price service.
+ * Resolve a mark price for `marketName`. Returns the caller-supplied value when
+ * present; otherwise reads the price provider configured for the resolved solver
+ * — Enigma's lowcap service for lowcap solvers, Binance USD-M Futures for
+ * majors.
  *
- * Shared by the instant-open and instant-close wizards.
+ * Shared by the instant-open and instant-close wizards, so the resolved value is
+ * signed into an EIP-712 operation. Getting the provider wrong here is a wrong
+ * price on-chain, not a display bug — which is why `solverId` must reach this
+ * function and must match the solver the trade is sent to.
  *
- * @throws {SymmError} `RESOLVE_MARK_PRICE_NOT_FOUND` when the price service
- *   omits the requested name from its response.
+ * @throws {SymmError} `RESOLVE_MARK_PRICE_NOT_FOUND` when the provider omits the
+ *   requested name from its response.
  */
 export declare function resolveMarkPrice(config: Config, parameters: ResolveMarkPriceParameters): Promise<string>;
 //# sourceMappingURL=resolve-mark-price.d.ts.map

package/dist/solvers/shared/resolvers/resolve-mark-price.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-mark-price.d.ts","sourceRoot":"","sources":["../../../../src/solvers/shared/resolvers/resolve-mark-price.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB9G"}
+{"version":3,"file":"resolve-mark-price.d.ts","sourceRoot":"","sources":["../../../../src/solvers/shared/resolvers/resolve-mark-price.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAKnD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B9G"}

package/dist/solvers/shared/resolvers/resolve-mark-price.js

@@ -1,16 +1,23 @@
 import { SymmError as e } from "../../../shared/errors/symm-error.js";
-import { getEnigmaPriceServicePricesByNames as t } from "../../../price-service/enigma/prices-by-names/get-enigma-price-service-prices-by-names.js";
+import { resolvePriceService as t } from "../../../price-service/resolve-price-service.js";
+import { getMarkPrices as n } from "../../../price-service/get-mark-prices/get-mark-prices.js";
 //#region src/solvers/shared/resolvers/resolve-mark-price.ts
-async function n(n, r) {
-	if (r.markPrice !== void 0) return r.markPrice;
-	let i = (await t(n, {
-		chainId: r.chainId,
-		names: [r.marketName]
-	}))[r.marketName];
-	if (!i) throw new e("api", "RESOLVE_MARK_PRICE_NOT_FOUND", `Mark price not returned by Enigma price service for market "${r.marketName}".`);
-	return String(i.markPrice);
+async function r(r, i) {
+	if (i.markPrice !== void 0) return i.markPrice;
+	let a = {
+		chainId: i.chainId,
+		solverId: i.solverId
+	}, o = i.marketName, s = await n(r, {
+		...a,
+		names: [o]
+	}), c = s.find((e) => e.name === o) ?? s.find((e) => e.name.toUpperCase() === o.toUpperCase());
+	if (!c) {
+		let { type: n } = t(r, a);
+		throw new e("api", "RESOLVE_MARK_PRICE_NOT_FOUND", `Mark price not returned by the "${n}" price service for market "${o}".${n === "binance" && o.includes("::") ? ` "${o}" looks like a lowcap market name; Binance USD-M Futures serves plain symbols such as "BTCUSDT".` : ""}`);
+	}
+	return c.markPrice;
 }
 //#endregion
-export { n as resolveMarkPrice };
+export { r as resolveMarkPrice };
 
 //# sourceMappingURL=resolve-mark-price.js.map

package/dist/solvers/shared/resolvers/resolve-mark-price.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-mark-price.js","names":[],"sources":["../../../../src/solvers/shared/resolvers/resolve-mark-price.ts"],"sourcesContent":["import type { Config } from \"../../../core/config\";\nimport { getEnigmaPriceServicePricesByNames } from \"../../../price-service/enigma/prices-by-names/get-enigma-price-service-prices-by-names\";\nimport { SymmError } from \"../../../shared/errors/symm-error\";\n\n/**\n * Parameters for {@link resolveMarkPrice}.\n */\nexport interface ResolveMarkPriceParameters {\n  chainId?: number;\n  marketName: string;\n  markPrice?: string;\n}\n\n/**\n * Resolve a mark price for `marketName`. Returns the caller-supplied value\n * when present; otherwise fetches the Enigma price service.\n *\n * Shared by the instant-open and instant-close wizards.\n *\n * @throws {SymmError} `RESOLVE_MARK_PRICE_NOT_FOUND` when the price service\n *   omits the requested name from its response.\n */\nexport async function resolveMarkPrice(config: Config, parameters: ResolveMarkPriceParameters): Promise<string> {\n  if (parameters.markPrice !== undefined) return parameters.markPrice;\n\n  const prices = await getEnigmaPriceServicePricesByNames(config, {\n    chainId: parameters.chainId,\n    names: [parameters.marketName],\n  });\n  const entry = prices[parameters.marketName];\n  if (!entry) {\n    throw new SymmError(\n      \"api\",\n      \"RESOLVE_MARK_PRICE_NOT_FOUND\",\n      `Mark price not returned by Enigma price service for market \"${parameters.marketName}\".`,\n    );\n  }\n  return String(entry.markPrice);\n}\n"],"mappings":";;;AAsBA,eAAsB,EAAiB,GAAgB,GAAyD;CAC9G,IAAI,EAAW,cAAc,KAAA,GAAW,OAAO,EAAW;CAM1D,IAAM,KAAQ,MAJO,EAAmC,GAAQ;EAC9D,SAAS,EAAW;EACpB,OAAO,CAAC,EAAW,UAAU;CAC/B,CAAC,GACoB,EAAW;CAChC,IAAI,CAAC,GACH,MAAM,IAAI,EACR,OACA,gCACA,+DAA+D,EAAW,WAAW,GACvF;CAEF,OAAO,OAAO,EAAM,SAAS;AAC/B"}
+{"version":3,"file":"resolve-mark-price.js","names":[],"sources":["../../../../src/solvers/shared/resolvers/resolve-mark-price.ts"],"sourcesContent":["import type { SolverId } from \"../../../core/chains/types\";\nimport type { Config } from \"../../../core/config\";\nimport { getMarkPrices } from \"../../../price-service/get-mark-prices/get-mark-prices\";\nimport { resolvePriceService } from \"../../../price-service/resolve-price-service\";\nimport { SymmError } from \"../../../shared/errors/symm-error\";\n\n/**\n * Parameters for {@link resolveMarkPrice}.\n */\nexport interface ResolveMarkPriceParameters {\n  chainId?: number;\n  /**\n   * Solver the trade targets. Its configured price provider supplies the mark.\n   * **Must match the solver the trade is sent to** — the resolved price is\n   * signed into the EIP-712 payload. Defaults to the chain's `defaultSolverId`.\n   */\n  solverId?: SolverId;\n  marketName: string;\n  markPrice?: string;\n}\n\n/**\n * Resolve a mark price for `marketName`. Returns the caller-supplied value when\n * present; otherwise reads the price provider configured for the resolved solver\n * — Enigma's lowcap service for lowcap solvers, Binance USD-M Futures for\n * majors.\n *\n * Shared by the instant-open and instant-close wizards, so the resolved value is\n * signed into an EIP-712 operation. Getting the provider wrong here is a wrong\n * price on-chain, not a display bug — which is why `solverId` must reach this\n * function and must match the solver the trade is sent to.\n *\n * @throws {SymmError} `RESOLVE_MARK_PRICE_NOT_FOUND` when the provider omits the\n *   requested name from its response.\n */\nexport async function resolveMarkPrice(config: Config, parameters: ResolveMarkPriceParameters): Promise<string> {\n  if (parameters.markPrice !== undefined) return parameters.markPrice;\n\n  const target = { chainId: parameters.chainId, solverId: parameters.solverId };\n  const wanted = parameters.marketName;\n  const ticks = await getMarkPrices(config, { ...target, names: [wanted] });\n\n  // Exact match first so the caller's spelling wins; the case-insensitive pass\n  // only covers a provider that canonicalizes casing differently.\n  const tick =\n    ticks.find((entry) => entry.name === wanted) ??\n    ticks.find((entry) => entry.name.toUpperCase() === wanted.toUpperCase());\n\n  if (!tick) {\n    const { type } = resolvePriceService(config, target);\n    // The single most likely failure while majors migrate onto Binance: a lowcap\n    // market name sent to a provider that only serves plain exchange symbols.\n    const hint =\n      type === \"binance\" && wanted.includes(\"::\")\n        ? ` \"${wanted}\" looks like a lowcap market name; Binance USD-M Futures serves plain symbols such as \"BTCUSDT\".`\n        : \"\";\n    throw new SymmError(\n      \"api\",\n      \"RESOLVE_MARK_PRICE_NOT_FOUND\",\n      `Mark price not returned by the \"${type}\" price service for market \"${wanted}\".${hint}`,\n    );\n  }\n  return tick.markPrice;\n}\n"],"mappings":";;;;AAmCA,eAAsB,EAAiB,GAAgB,GAAyD;CAC9G,IAAI,EAAW,cAAc,KAAA,GAAW,OAAO,EAAW;CAE1D,IAAM,IAAS;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,GACtE,IAAS,EAAW,YACpB,IAAQ,MAAM,EAAc,GAAQ;EAAE,GAAG;EAAQ,OAAO,CAAC,CAAM;CAAE,CAAC,GAIlE,IACJ,EAAM,MAAM,MAAU,EAAM,SAAS,CAAM,KAC3C,EAAM,MAAM,MAAU,EAAM,KAAK,YAAY,MAAM,EAAO,YAAY,CAAC;CAEzE,IAAI,CAAC,GAAM;EACT,IAAM,EAAE,YAAS,EAAoB,GAAQ,CAAM;EAOnD,MAAM,IAAI,EACR,OACA,gCACA,mCAAmC,EAAK,8BAA8B,EAAO,IAN7E,MAAS,aAAa,EAAO,SAAS,IAAI,IACtC,KAAK,EAAO,oGACZ,IAKN;CACF;CACA,OAAO,EAAK;AACd"}

package/dist/solvers/shared/resolvers/resolve-market.d.ts

@@ -1,3 +1,4 @@
+import { SolverId } from '../../../core/chains/types.js';
 import { Config } from '../../../core/config/index.js';
 import { ResolvedMarket } from './types.js';
 /**
@@ -5,6 +6,12 @@ import { ResolvedMarket } from './types.js';
  */
 export interface ResolveMarketParameters {
     chainId?: number;
+    /**
+     * Solver whose `/contract-symbols` listing to read. **Must match the solver
+     * the trade is sent to** — the resolved `name` and precisions are encoded into
+     * the signed quote. Defaults to the chain's `defaultSolverId`.
+     */
+    solverId?: SolverId;
     marketId: number;
     marketName?: string;
     pricePrecision?: number;
@@ -13,13 +20,13 @@ export interface ResolveMarketParameters {
 /**
  * Resolve market metadata (`name`, `pricePrecision`, `quantityPrecision`) for
  * `marketId`. Returns caller-supplied values when all three are pre-filled;
- * otherwise fetches `/contract-symbols` and extracts the matching record.
+ * otherwise fetches `/contract-symbols` and extracts the matching record. The
+ * normalized {@link Market} shape guarantees these fields, so only "not found"
+ * can fail here.
  *
  * Shared by the instant-open and instant-close wizards.
  *
  * @throws {SymmError} `RESOLVE_MARKET_NOT_FOUND` when no record matches.
- * @throws {SymmError} `RESOLVE_MARKET_METADATA_INCOMPLETE` when the solver
- *   record is missing required fields.
  */
 export declare function resolveMarket(config: Config, parameters: ResolveMarketParameters): Promise<ResolvedMarket>;
 //# sourceMappingURL=resolve-market.d.ts.map

package/dist/solvers/shared/resolvers/resolve-market.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-market.d.ts","sourceRoot":"","sources":["../../../../src/solvers/shared/resolvers/resolve-market.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BhH"}
+{"version":3,"file":"resolve-market.d.ts","sourceRoot":"","sources":["../../../../src/solvers/shared/resolvers/resolve-market.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqBhH"}

package/dist/solvers/shared/resolvers/resolve-market.js

@@ -8,14 +8,15 @@ async function n(n, r) {
 		pricePrecision: a,
 		quantityPrecision: o
 	};
-	let s = (await t(n, { chainId: r.chainId })).find((e) => e.symbol_id === r.marketId);
+	let s = (await t(n, {
+		chainId: r.chainId,
+		solverId: r.solverId
+	})).find((e) => e.symbolId === r.marketId);
 	if (!s) throw new e("api", "RESOLVE_MARKET_NOT_FOUND", `Market id ${r.marketId} not returned by solver /contract-symbols.`);
-	let c = i ?? s.name, l = a ?? s.price_precision, u = o ?? s.quantity_precision;
-	if (c === void 0 || l === void 0 || u === void 0) throw new e("api", "RESOLVE_MARKET_METADATA_INCOMPLETE", `Solver returned incomplete metadata for market id ${r.marketId} (name/price_precision/quantity_precision missing).`);
 	return {
-		name: c,
-		pricePrecision: l,
-		quantityPrecision: u
+		name: i ?? s.name,
+		pricePrecision: a ?? s.pricePrecision,
+		quantityPrecision: o ?? s.quantityPrecision
 	};
 }
 //#endregion

package/dist/solvers/shared/resolvers/resolve-market.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-market.js","names":[],"sources":["../../../../src/solvers/shared/resolvers/resolve-market.ts"],"sourcesContent":["import type { Config } from \"../../../core/config\";\nimport { SymmError } from \"../../../shared/errors/symm-error\";\nimport { getMarkets } from \"../../markets/get-markets\";\nimport type { ResolvedMarket } from \"./types\";\n\n/**\n * Parameters for {@link resolveMarket}.\n */\nexport interface ResolveMarketParameters {\n  chainId?: number;\n  marketId: number;\n  marketName?: string;\n  pricePrecision?: number;\n  quantityPrecision?: number;\n}\n\n/**\n * Resolve market metadata (`name`, `pricePrecision`, `quantityPrecision`) for\n * `marketId`. Returns caller-supplied values when all three are pre-filled;\n * otherwise fetches `/contract-symbols` and extracts the matching record.\n *\n * Shared by the instant-open and instant-close wizards.\n *\n * @throws {SymmError} `RESOLVE_MARKET_NOT_FOUND` when no record matches.\n * @throws {SymmError} `RESOLVE_MARKET_METADATA_INCOMPLETE` when the solver\n *   record is missing required fields.\n */\nexport async function resolveMarket(config: Config, parameters: ResolveMarketParameters): Promise<ResolvedMarket> {\n  const { marketName, pricePrecision, quantityPrecision } = parameters;\n  if (marketName !== undefined && pricePrecision !== undefined && quantityPrecision !== undefined) {\n    return { name: marketName, pricePrecision, quantityPrecision };\n  }\n\n  const markets = await getMarkets(config, { chainId: parameters.chainId });\n  const match = markets.find((m) => m.symbol_id === parameters.marketId);\n  if (!match) {\n    throw new SymmError(\n      \"api\",\n      \"RESOLVE_MARKET_NOT_FOUND\",\n      `Market id ${parameters.marketId} not returned by solver /contract-symbols.`,\n    );\n  }\n\n  const name = marketName ?? match.name;\n  const resolvedPricePrecision = pricePrecision ?? match.price_precision;\n  const resolvedQuantityPrecision = quantityPrecision ?? match.quantity_precision;\n  if (name === undefined || resolvedPricePrecision === undefined || resolvedQuantityPrecision === undefined) {\n    throw new SymmError(\n      \"api\",\n      \"RESOLVE_MARKET_METADATA_INCOMPLETE\",\n      `Solver returned incomplete metadata for market id ${parameters.marketId} (name/price_precision/quantity_precision missing).`,\n    );\n  }\n  return { name, pricePrecision: resolvedPricePrecision, quantityPrecision: resolvedQuantityPrecision };\n}\n"],"mappings":";;;AA2BA,eAAsB,EAAc,GAAgB,GAA8D;CAChH,IAAM,EAAE,eAAY,mBAAgB,yBAAsB;CAC1D,IAAI,MAAe,KAAA,KAAa,MAAmB,KAAA,KAAa,MAAsB,KAAA,GACpF,OAAO;EAAE,MAAM;EAAY;EAAgB;CAAkB;CAI/D,IAAM,KAAQ,MADQ,EAAW,GAAQ,EAAE,SAAS,EAAW,QAAQ,CAAC,GAClD,MAAM,MAAM,EAAE,cAAc,EAAW,QAAQ;CACrE,IAAI,CAAC,GACH,MAAM,IAAI,EACR,OACA,4BACA,aAAa,EAAW,SAAS,2CACnC;CAGF,IAAM,IAAO,KAAc,EAAM,MAC3B,IAAyB,KAAkB,EAAM,iBACjD,IAA4B,KAAqB,EAAM;CAC7D,IAAI,MAAS,KAAA,KAAa,MAA2B,KAAA,KAAa,MAA8B,KAAA,GAC9F,MAAM,IAAI,EACR,OACA,sCACA,qDAAqD,EAAW,SAAS,oDAC3E;CAEF,OAAO;EAAE;EAAM,gBAAgB;EAAwB,mBAAmB;CAA0B;AACtG"}
+{"version":3,"file":"resolve-market.js","names":[],"sources":["../../../../src/solvers/shared/resolvers/resolve-market.ts"],"sourcesContent":["import type { SolverId } from \"../../../core/chains/types\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmError } from \"../../../shared/errors/symm-error\";\nimport { getMarkets } from \"../../markets/get-markets\";\nimport type { ResolvedMarket } from \"./types\";\n\n/**\n * Parameters for {@link resolveMarket}.\n */\nexport interface ResolveMarketParameters {\n  chainId?: number;\n  /**\n   * Solver whose `/contract-symbols` listing to read. **Must match the solver\n   * the trade is sent to** — the resolved `name` and precisions are encoded into\n   * the signed quote. Defaults to the chain's `defaultSolverId`.\n   */\n  solverId?: SolverId;\n  marketId: number;\n  marketName?: string;\n  pricePrecision?: number;\n  quantityPrecision?: number;\n}\n\n/**\n * Resolve market metadata (`name`, `pricePrecision`, `quantityPrecision`) for\n * `marketId`. Returns caller-supplied values when all three are pre-filled;\n * otherwise fetches `/contract-symbols` and extracts the matching record. The\n * normalized {@link Market} shape guarantees these fields, so only \"not found\"\n * can fail here.\n *\n * Shared by the instant-open and instant-close wizards.\n *\n * @throws {SymmError} `RESOLVE_MARKET_NOT_FOUND` when no record matches.\n */\nexport async function resolveMarket(config: Config, parameters: ResolveMarketParameters): Promise<ResolvedMarket> {\n  const { marketName, pricePrecision, quantityPrecision } = parameters;\n  if (marketName !== undefined && pricePrecision !== undefined && quantityPrecision !== undefined) {\n    return { name: marketName, pricePrecision, quantityPrecision };\n  }\n\n  const markets = await getMarkets(config, { chainId: parameters.chainId, solverId: parameters.solverId });\n  const match = markets.find((m) => m.symbolId === parameters.marketId);\n  if (!match) {\n    throw new SymmError(\n      \"api\",\n      \"RESOLVE_MARKET_NOT_FOUND\",\n      `Market id ${parameters.marketId} not returned by solver /contract-symbols.`,\n    );\n  }\n\n  return {\n    name: marketName ?? match.name,\n    pricePrecision: pricePrecision ?? match.pricePrecision,\n    quantityPrecision: quantityPrecision ?? match.quantityPrecision,\n  };\n}\n"],"mappings":";;;AAkCA,eAAsB,EAAc,GAAgB,GAA8D;CAChH,IAAM,EAAE,eAAY,mBAAgB,yBAAsB;CAC1D,IAAI,MAAe,KAAA,KAAa,MAAmB,KAAA,KAAa,MAAsB,KAAA,GACpF,OAAO;EAAE,MAAM;EAAY;EAAgB;CAAkB;CAI/D,IAAM,KAAQ,MADQ,EAAW,GAAQ;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC,GACjF,MAAM,MAAM,EAAE,aAAa,EAAW,QAAQ;CACpE,IAAI,CAAC,GACH,MAAM,IAAI,EACR,OACA,4BACA,aAAa,EAAW,SAAS,2CACnC;CAGF,OAAO;EACL,MAAM,KAAc,EAAM;EAC1B,gBAAgB,KAAkB,EAAM;EACxC,mBAAmB,KAAqB,EAAM;CAChD;AACF"}

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

@@ -0,0 +1,53 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../shared/types/properties.js';
+import { SolverSymbol, SymbolStateFilter, SymbolValidityFilter } from './types.js';
+/**
+ * Parameters for {@link getSymbols}.
+ */
+export type GetSymbolsParameters = Compute<ReadSolverParameter & {
+    /** Max rows to return (solver max 500, default 100). */
+    limit?: number;
+    /** Row offset for pagination (default 0). */
+    offset?: number;
+    /** Restrict to a single symbol by its numeric id. */
+    symbolId?: number;
+    /** Case-insensitive substring match on the symbol name. */
+    search?: string;
+    /** Exact-match filter on the base asset. */
+    asset?: string;
+    /** Exact-match filter on the collateral token address. */
+    tokenAddress?: string;
+    /** Validity filter; the solver defaults to `"true"` (valid symbols only). */
+    isValid?: SymbolValidityFilter;
+    /** Long-side trading-state filter. */
+    stateLong?: SymbolStateFilter;
+    /** Short-side trading-state filter. */
+    stateShort?: SymbolStateFilter;
+}>;
+/** Return type of {@link getSymbols}: one entry per symbol. */
+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,
+ * so multiple chains never clobber each other.
+ *
+ * `/symbols` is an **Enigma-only** endpoint; the action asserts the resolved
+ * solver is an `enigma` solver and throws before hitting the wire otherwise.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain id, solver id, and `/symbols` filters.
+ * @returns Normalized symbols, one {@link SolverSymbol} per row.
+ * @throws {SymmApiError} when the API request fails.
+ * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver, or when the chain is unsupported.
+ *
+ * @example
+ * ```ts
+ * const symbols = await getSymbols(config, { search: "BTC" });
+ * const btc = symbols.find((s) => s.name === "BTCUSDT");
+ * console.log(btc?.maxLeverage);
+ * ```
+ */
+export declare function getSymbols(config: Config, parameters?: GetSymbolsParameters): Promise<GetSymbolsReturnType>;
+//# sourceMappingURL=get-symbols.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,37 @@
+import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
+import { getSymbols as n } from "../types/generated/enigma-solver.js";
+import { assertSolverKind as r } from "../assert-solver-kind.js";
+import { toSolverSymbols as i } from "./to-solver-symbol.js";
+import { isAxiosError as a } from "axios";
+//#region src/solvers/symbols/get-symbols.ts
+async function o(e, t = {}) {
+	let n = e.getSolver({
+		chainId: t.chainId,
+		solverId: t.solverId
+	});
+	return r(n, "enigma", "getSymbols"), s(n.url, t);
+}
+async function s(r, o) {
+	try {
+		return i((await n({
+			limit: o.limit,
+			offset: o.offset,
+			symbol_id: o.symbolId,
+			search: o.search,
+			asset: o.asset,
+			token_address: o.tokenAddress,
+			is_valid: o.isValid,
+			state_long: o.stateLong,
+			state_short: o.stateShort
+		}, { baseURL: r })).data.symbols ?? []);
+	} catch (n) {
+		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
+			code: "FETCH_SYMBOLS_FAILED",
+			baseURL: r
+		}) : new t("api", "FETCH_SYMBOLS_FAILED", `Failed to fetch symbols: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { o as getSymbols };
+
+//# sourceMappingURL=get-symbols.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+export * from './get-symbols.js';
+export * from './query.js';
+export * from './to-solver-symbol.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/symbols/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/solvers/symbols/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 { GetSymbolsParameters, GetSymbolsReturnType } from './get-symbols.js';
+/** Data resolved by the {@link getSymbolsQueryOptions} query. */
+export type GetSymbolsData = GetSymbolsReturnType;
+/** Build the TanStack Query key for {@link getSymbolsQueryOptions}. */
+export declare function getSymbolsQueryKey(options?: Compute<GetSymbolsParameters & ConfigKeyParameter>): readonly ["getSymbols", Record<string, unknown>];
+/** Query-key type produced by {@link getSymbolsQueryKey}. */
+export type GetSymbolsQueryKey = ReturnType<typeof getSymbolsQueryKey>;
+/** Options accepted by {@link getSymbolsQueryOptions}. */
+export type GetSymbolsOptions = Compute<GetSymbolsParameters & QueryParameter<GetSymbolsData, Error, GetSymbolsData, GetSymbolsQueryKey>>;
+/** TanStack Query options returned by {@link getSymbolsQueryOptions}. */
+export type GetSymbolsQueryOptions = SymmioQueryOptions<GetSymbolsData, Error, GetSymbolsData, GetSymbolsQueryKey>;
+/**
+ * Build TanStack Query options for {@link getSymbols}.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters (optional `chainId` / `solverId` / `/symbols` filters) and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getSymbolsQueryOptions(config, { search: "BTC" }));
+ * ```
+ */
+export declare function getSymbolsQueryOptions(config: Config, options?: GetSymbolsOptions): GetSymbolsQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/solvers/symbols/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/solvers/symbols/query.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,EAAc,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEjG,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,OAAO,CAAC,oBAAoB,GAAG,kBAAkB,CAAM,oDAElG;AAED,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEvE,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC,oBAAoB,GAAG,cAAc,CAAC,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,kBAAkB,CAAC,CACjG,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;AAEnH;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,sBAAsB,CAuB9G"}