@symmio/trading-core 0.1.0 → 0.2.0

package/dist/solvers/funding-info/get-funding-info.d.ts

@@ -0,0 +1,37 @@
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { MarketFundingInfo } from './types.js';
+/**
+ * Parameters for {@link getFundingInfo}.
+ */
+export type GetFundingInfoParameters = Compute<ChainIdParameter & {
+    /** Restrict the result to these market names. Omit to fetch every market (the endpoint default). */
+    symbols?: readonly string[];
+}>;
+/** Return type of {@link getFundingInfo}: one entry per market. */
+export type GetFundingInfoReturnType = MarketFundingInfo[];
+/**
+ * Fetch per-market funding rates from the chain's solver `/get_funding_info`
+ * endpoint. Returns the next-epoch long/short funding rate, next funding time,
+ * and epoch length for every market (or only the requested `symbols`). The
+ * solver base URL is resolved from `config` per call, so multiple chains never
+ * clobber each other.
+ *
+ * Rates are surfaced as plain per-epoch decimal fractions exactly as the solver
+ * reports them (multiply by `100` for a percentage); no scaling is applied.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain id and `symbols` filter.
+ * @returns Normalized funding info, one {@link MarketFundingInfo} per market.
+ * @throws {SymmApiError} when the API request fails.
+ * @throws {SymmError} when the chain is unsupported.
+ *
+ * @example
+ * ```ts
+ * const funding = await getFundingInfo(config);
+ * const btc = funding.find((f) => f.symbol === "BTCUSDT");
+ * console.log(btc?.nextFundingRateLong); // 0.0001 → 0.01%
+ * ```
+ */
+export declare function getFundingInfo(config: Config, parameters?: GetFundingInfoParameters): Promise<GetFundingInfoReturnType>;
+//# sourceMappingURL=get-funding-info.d.ts.map

package/dist/solvers/funding-info/get-funding-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-funding-info.d.ts","sourceRoot":"","sources":["../../../src/solvers/funding-info/get-funding-info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,gBAAgB,GAAG;IACjB,oGAAoG;IACpG,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CACF,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,EAAE,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,wBAAwB,CAAC,CAGnC"}

package/dist/solvers/funding-info/get-funding-info.js

@@ -0,0 +1,24 @@
+import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
+import { getGetFundingInfo as n } from "../types/generated/enigma-solver.js";
+import { toMarketFundingInfo as r } from "./to-funding-info.js";
+import { isAxiosError as i } from "axios";
+//#region src/solvers/funding-info/get-funding-info.ts
+async function a(e, t = {}) {
+	let { solver: n } = e.getChainConfig(t.chainId);
+	return o(n.url, t.symbols);
+}
+async function o(a, o) {
+	try {
+		let e = await n(o ? { symbols: [...o] } : void 0, { baseURL: a });
+		return Object.entries(e.data).map(([e, t]) => r(e, t));
+	} catch (n) {
+		throw n instanceof t ? n : i(n) ? e.fromAxios(n, {
+			code: "FETCH_FUNDING_INFO_FAILED",
+			baseURL: a
+		}) : new t("api", "FETCH_FUNDING_INFO_FAILED", `Failed to fetch funding info: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { a as getFundingInfo };
+
+//# sourceMappingURL=get-funding-info.js.map

package/dist/solvers/funding-info/get-funding-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-funding-info.js","names":[],"sources":["../../../src/solvers/funding-info/get-funding-info.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../core/config\";\nimport { SymmApiError, SymmError } from \"../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { getGetFundingInfo } from \"../types/generated/enigma-solver\";\nimport { toMarketFundingInfo } from \"./to-funding-info\";\nimport type { MarketFundingInfo } from \"./types\";\n\n/**\n * Parameters for {@link getFundingInfo}.\n */\nexport type GetFundingInfoParameters = Compute<\n  ChainIdParameter & {\n    /** Restrict the result to these market names. Omit to fetch every market (the endpoint default). */\n    symbols?: readonly string[];\n  }\n>;\n\n/** Return type of {@link getFundingInfo}: one entry per market. */\nexport type GetFundingInfoReturnType = MarketFundingInfo[];\n\n/**\n * Fetch per-market funding rates from the chain's solver `/get_funding_info`\n * endpoint. Returns the next-epoch long/short funding rate, next funding time,\n * and epoch length for every market (or only the requested `symbols`). The\n * solver base URL is resolved from `config` per call, so multiple chains never\n * clobber each other.\n *\n * Rates are surfaced as plain per-epoch decimal fractions exactly as the solver\n * reports them (multiply by `100` for a percentage); no scaling is applied.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain id and `symbols` filter.\n * @returns Normalized funding info, one {@link MarketFundingInfo} per market.\n * @throws {SymmApiError} when the API request fails.\n * @throws {SymmError} when the chain is unsupported.\n *\n * @example\n * ```ts\n * const funding = await getFundingInfo(config);\n * const btc = funding.find((f) => f.symbol === \"BTCUSDT\");\n * console.log(btc?.nextFundingRateLong); // 0.0001 → 0.01%\n * ```\n */\nexport async function getFundingInfo(\n  config: Config,\n  parameters: GetFundingInfoParameters = {},\n): Promise<GetFundingInfoReturnType> {\n  const { solver } = config.getChainConfig(parameters.chainId);\n  return fetchFundingInfo(solver.url, parameters.symbols);\n}\n\n/**\n * Call the solver's `/get_funding_info` endpoint with a per-call base URL and\n * map the market-keyed response into the SDK's normalized array.\n *\n * @internal\n */\nasync function fetchFundingInfo(baseURL: string, symbols?: readonly string[]): Promise<MarketFundingInfo[]> {\n  try {\n    const response = await getGetFundingInfo(symbols ? { symbols: [...symbols] } : undefined, { baseURL });\n    return Object.entries(response.data).map(([symbol, raw]) => toMarketFundingInfo(symbol, raw));\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_FUNDING_INFO_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_FUNDING_INFO_FAILED\",\n      `Failed to fetch funding info: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;AA4CA,eAAsB,EACpB,GACA,IAAuC,CAAC,GACL;CACnC,IAAM,EAAE,cAAW,EAAO,eAAe,EAAW,OAAO;CAC3D,OAAO,EAAiB,EAAO,KAAK,EAAW,OAAO;AACxD;AAQA,eAAe,EAAiB,GAAiB,GAA2D;CAC1G,IAAI;EACF,IAAM,IAAW,MAAM,EAAkB,IAAU,EAAE,SAAS,CAAC,GAAG,CAAO,EAAE,IAAI,KAAA,GAAW,EAAE,WAAQ,CAAC;EACrG,OAAO,OAAO,QAAQ,EAAS,IAAI,EAAE,KAAK,CAAC,GAAQ,OAAS,EAAoB,GAAQ,CAAG,CAAC;CAC9F,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"}

package/dist/solvers/funding-info/index.d.ts

@@ -0,0 +1,6 @@
+export * from './get-funding-info.js';
+export * from './project-funding-rate.js';
+export * from './query.js';
+export * from './to-funding-info.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/solvers/funding-info/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/funding-info/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/solvers/funding-info/project-funding-rate.d.ts

@@ -0,0 +1,30 @@
+/** Parameters for {@link projectFundingRate}. */
+export interface ProjectFundingRateParameters {
+    /** Per-epoch funding rate as a decimal fraction (e.g. `MarketFundingInfo.nextFundingRateLong`). */
+    ratePerEpoch: number;
+    /** Funding epoch length in seconds (e.g. `MarketFundingInfo.epochDurationSeconds`). */
+    epochDurationSeconds: number;
+    /** Projection window in days (fractional allowed). */
+    days: number;
+}
+/**
+ * Project a per-epoch funding rate over a number of days by **linear
+ * (non-compounded)** extrapolation — the same method the reference frontend
+ * uses for its 1D / yearly figures: multiply the per-epoch rate by how many
+ * funding epochs elapse in the window (`days × 86_400 / epochDurationSeconds`).
+ *
+ * The result keeps the input's unit — a decimal fraction, as returned on
+ * {@link MarketFundingInfo} (multiply by 100 for a percentage). It is **not**
+ * APR-compounded.
+ *
+ * @param params - The per-epoch rate, the epoch length, and the day window.
+ * @returns The projected funding rate over `days`; `0` when `epochDurationSeconds`
+ *   is non-positive (no epochs accrue).
+ *
+ * @example
+ * // 12h epoch (2 epochs/day). Per-epoch -0.0003014 over 30 days:
+ * projectFundingRate({ ratePerEpoch: -0.0003014, epochDurationSeconds: 43_200, days: 30 });
+ * // → -0.0180858  (≈ -1.81%)
+ */
+export declare function projectFundingRate({ ratePerEpoch, epochDurationSeconds, days }: ProjectFundingRateParameters): number;
+//# sourceMappingURL=project-funding-rate.d.ts.map

package/dist/solvers/funding-info/project-funding-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-funding-rate.d.ts","sourceRoot":"","sources":["../../../src/solvers/funding-info/project-funding-rate.ts"],"names":[],"mappings":"AAGA,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,YAAY,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAE,4BAA4B,GAAG,MAAM,CAIrH"}

package/dist/solvers/funding-info/project-funding-rate.js

@@ -0,0 +1,9 @@
+//#region src/solvers/funding-info/project-funding-rate.ts
+var e = 86400;
+function t({ ratePerEpoch: t, epochDurationSeconds: n, days: r }) {
+	return n <= 0 ? 0 : t * (r * e / n);
+}
+//#endregion
+export { t as projectFundingRate };
+
+//# sourceMappingURL=project-funding-rate.js.map

package/dist/solvers/funding-info/project-funding-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-funding-rate.js","names":[],"sources":["../../../src/solvers/funding-info/project-funding-rate.ts"],"sourcesContent":["/** Seconds in one day — converts a day-count into a span of funding epochs. */\nconst SECONDS_PER_DAY = 86_400;\n\n/** Parameters for {@link projectFundingRate}. */\nexport interface ProjectFundingRateParameters {\n  /** Per-epoch funding rate as a decimal fraction (e.g. `MarketFundingInfo.nextFundingRateLong`). */\n  ratePerEpoch: number;\n  /** Funding epoch length in seconds (e.g. `MarketFundingInfo.epochDurationSeconds`). */\n  epochDurationSeconds: number;\n  /** Projection window in days (fractional allowed). */\n  days: number;\n}\n\n/**\n * Project a per-epoch funding rate over a number of days by **linear\n * (non-compounded)** extrapolation — the same method the reference frontend\n * uses for its 1D / yearly figures: multiply the per-epoch rate by how many\n * funding epochs elapse in the window (`days × 86_400 / epochDurationSeconds`).\n *\n * The result keeps the input's unit — a decimal fraction, as returned on\n * {@link MarketFundingInfo} (multiply by 100 for a percentage). It is **not**\n * APR-compounded.\n *\n * @param params - The per-epoch rate, the epoch length, and the day window.\n * @returns The projected funding rate over `days`; `0` when `epochDurationSeconds`\n *   is non-positive (no epochs accrue).\n *\n * @example\n * // 12h epoch (2 epochs/day). Per-epoch -0.0003014 over 30 days:\n * projectFundingRate({ ratePerEpoch: -0.0003014, epochDurationSeconds: 43_200, days: 30 });\n * // → -0.0180858  (≈ -1.81%)\n */\nexport function projectFundingRate({ ratePerEpoch, epochDurationSeconds, days }: ProjectFundingRateParameters): number {\n  if (epochDurationSeconds <= 0) return 0;\n  const epochsInWindow = (days * SECONDS_PER_DAY) / epochDurationSeconds;\n  return ratePerEpoch * epochsInWindow;\n}\n"],"mappings":";AACA,IAAM,IAAkB;AA+BxB,SAAgB,EAAmB,EAAE,iBAAc,yBAAsB,WAA8C;CAGrH,OAFI,KAAwB,IAAU,IAE/B,KADiB,IAAO,IAAmB;AAEpD"}

package/dist/solvers/funding-info/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 { GetFundingInfoParameters, GetFundingInfoReturnType } from './get-funding-info.js';
+/** Data resolved by the {@link getFundingInfoQueryOptions} query. */
+export type GetFundingInfoData = GetFundingInfoReturnType;
+/** Build the TanStack Query key for {@link getFundingInfoQueryOptions}. */
+export declare function getFundingInfoQueryKey(options?: Compute<GetFundingInfoParameters & ConfigKeyParameter>): readonly ["getFundingInfo", Record<string, unknown>];
+/** Query-key type produced by {@link getFundingInfoQueryKey}. */
+export type GetFundingInfoQueryKey = ReturnType<typeof getFundingInfoQueryKey>;
+/** Options accepted by {@link getFundingInfoQueryOptions}. */
+export type GetFundingInfoOptions = Compute<GetFundingInfoParameters & QueryParameter<GetFundingInfoData, Error, GetFundingInfoData, GetFundingInfoQueryKey>>;
+/** TanStack Query options returned by {@link getFundingInfoQueryOptions}. */
+export type GetFundingInfoQueryOptions = SymmioQueryOptions<GetFundingInfoData, Error, GetFundingInfoData, GetFundingInfoQueryKey>;
+/**
+ * Build TanStack Query options for {@link getFundingInfo}.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters (optional `chainId` / `symbols`) and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getFundingInfoQueryOptions(config, {}));
+ * ```
+ */
+export declare function getFundingInfoQueryOptions(config: Config, options?: GetFundingInfoOptions): GetFundingInfoQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/solvers/funding-info/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/solvers/funding-info/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,EAAkB,KAAK,wBAAwB,EAAE,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAElH,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE1D,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,OAAO,CAAC,wBAAwB,GAAG,kBAAkB,CAAM,wDAE1G;AAED,iEAAiE;AACjE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/E,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,wBAAwB,GAAG,cAAc,CAAC,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,CACjH,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,CACzD,kBAAkB,EAClB,KAAK,EACL,kBAAkB,EAClB,sBAAsB,CACvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,0BAA0B,CAU5B"}

package/dist/solvers/funding-info/query.js

@@ -0,0 +1,24 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getFundingInfo as t } from "./get-funding-info.js";
+//#region src/solvers/funding-info/query.ts
+function n(t = {}) {
+	return ["getFundingInfo", 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,
+			symbols: r.symbols
+		})
+	};
+}
+//#endregion
+export { n as getFundingInfoQueryKey, r as getFundingInfoQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/solvers/funding-info/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/solvers/funding-info/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 { getFundingInfo, type GetFundingInfoParameters, type GetFundingInfoReturnType } from \"./get-funding-info\";\n\n/** Data resolved by the {@link getFundingInfoQueryOptions} query. */\nexport type GetFundingInfoData = GetFundingInfoReturnType;\n\n/** Build the TanStack Query key for {@link getFundingInfoQueryOptions}. */\nexport function getFundingInfoQueryKey(options: Compute<GetFundingInfoParameters & ConfigKeyParameter> = {}) {\n  return [\"getFundingInfo\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getFundingInfoQueryKey}. */\nexport type GetFundingInfoQueryKey = ReturnType<typeof getFundingInfoQueryKey>;\n\n/** Options accepted by {@link getFundingInfoQueryOptions}. */\nexport type GetFundingInfoOptions = Compute<\n  GetFundingInfoParameters & QueryParameter<GetFundingInfoData, Error, GetFundingInfoData, GetFundingInfoQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getFundingInfoQueryOptions}. */\nexport type GetFundingInfoQueryOptions = SymmioQueryOptions<\n  GetFundingInfoData,\n  Error,\n  GetFundingInfoData,\n  GetFundingInfoQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getFundingInfo}.\n *\n * @param config - The SDK config.\n * @param options - Query parameters (optional `chainId` / `symbols`) and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getFundingInfoQueryOptions(config, {}));\n * ```\n */\nexport function getFundingInfoQueryOptions(\n  config: Config,\n  options: GetFundingInfoOptions = {},\n): GetFundingInfoQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getFundingInfoQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getFundingInfo(config, { chainId: options.chainId, symbols: options.symbols }),\n  };\n}\n"],"mappings":";;;AAUA,SAAgB,EAAuB,IAAkE,CAAC,GAAG;CAC3G,OAAO,CAAC,kBAAkB,EAAmB,CAAO,CAAC;AACvD;AA8BA,SAAgB,EACd,GACA,IAAiC,CAAC,GACN;CAC5B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAuB;GAC/B,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAe,GAAQ;GAAE,SAAS,EAAQ;GAAS,SAAS,EAAQ;EAAQ,CAAC;CAC9F;AACF"}

package/dist/solvers/funding-info/to-funding-info.d.ts

@@ -0,0 +1,14 @@
+import { ApiFundingInfoResponse } from '../types/generated/enigma-solver.js';
+import { MarketFundingInfo } from './types.js';
+/** One market's raw entry from `ApiFundingInfoResponse` (the map value). */
+type RawFundingInfo = ApiFundingInfoResponse[string];
+/**
+ * Map one `ApiFundingInfoResponse` entry (keyed by market name) into the SDK's
+ * {@link MarketFundingInfo}. Missing numeric fields default to `0`.
+ *
+ * @param symbol - The market name (the response map key).
+ * @param raw - The raw funding entry for that market.
+ */
+export declare function toMarketFundingInfo(symbol: string, raw: RawFundingInfo): MarketFundingInfo;
+export {};
+//# sourceMappingURL=to-funding-info.d.ts.map

package/dist/solvers/funding-info/to-funding-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-funding-info.d.ts","sourceRoot":"","sources":["../../../src/solvers/funding-info/to-funding-info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,4EAA4E;AAC5E,KAAK,cAAc,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,iBAAiB,CAQ1F"}

package/dist/solvers/funding-info/to-funding-info.js

@@ -0,0 +1,15 @@
+import { toFiniteNumber as e } from "@symmio/utils/number";
+//#region src/solvers/funding-info/to-funding-info.ts
+function t(t, n) {
+	return {
+		symbol: t,
+		nextFundingRateLong: e(n.next_funding_rate_long),
+		nextFundingRateShort: e(n.next_funding_rate_short),
+		nextFundingTime: e(n.next_funding_time),
+		epochDurationSeconds: e(n.funding_rate_epoch_duration)
+	};
+}
+//#endregion
+export { t as toMarketFundingInfo };
+
+//# sourceMappingURL=to-funding-info.js.map

package/dist/solvers/funding-info/to-funding-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-funding-info.js","names":[],"sources":["../../../src/solvers/funding-info/to-funding-info.ts"],"sourcesContent":["import { toFiniteNumber } from \"@symmio/utils/number\";\nimport type { ApiFundingInfoResponse } from \"../types/generated/enigma-solver\";\nimport type { MarketFundingInfo } from \"./types\";\n\n/** One market's raw entry from `ApiFundingInfoResponse` (the map value). */\ntype RawFundingInfo = ApiFundingInfoResponse[string];\n\n/**\n * Map one `ApiFundingInfoResponse` entry (keyed by market name) into the SDK's\n * {@link MarketFundingInfo}. Missing numeric fields default to `0`.\n *\n * @param symbol - The market name (the response map key).\n * @param raw - The raw funding entry for that market.\n */\nexport function toMarketFundingInfo(symbol: string, raw: RawFundingInfo): MarketFundingInfo {\n  return {\n    symbol,\n    nextFundingRateLong: toFiniteNumber(raw.next_funding_rate_long),\n    nextFundingRateShort: toFiniteNumber(raw.next_funding_rate_short),\n    nextFundingTime: toFiniteNumber(raw.next_funding_time),\n    epochDurationSeconds: toFiniteNumber(raw.funding_rate_epoch_duration),\n  };\n}\n"],"mappings":";;AAcA,SAAgB,EAAoB,GAAgB,GAAwC;CAC1F,OAAO;EACL;EACA,qBAAqB,EAAe,EAAI,sBAAsB;EAC9D,sBAAsB,EAAe,EAAI,uBAAuB;EAChE,iBAAiB,EAAe,EAAI,iBAAiB;EACrD,sBAAsB,EAAe,EAAI,2BAA2B;CACtE;AACF"}

package/dist/solvers/funding-info/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Next-epoch funding figures for one solver market, normalized from the
+ * generated `/get_funding_info` response.
+ *
+ * Funding is charged per epoch: the long side pays (or receives) at
+ * {@link MarketFundingInfo.nextFundingRateLong} and the short side at
+ * {@link MarketFundingInfo.nextFundingRateShort}. Both rates are the plain
+ * per-epoch decimal fractions the solver reports — multiply by `100` for a
+ * percentage. A **positive** rate means that side *receives* funding; a
+ * **negative** rate means it *pays*.
+ */
+export interface MarketFundingInfo {
+    /** Market ticker and solver map key (e.g. `"BTCUSDT"`). */
+    symbol: string;
+    /**
+     * Next funding rate for the long side, as a per-epoch decimal fraction
+     * (`0.0001` = `0.01%`). Positive receives, negative pays.
+     */
+    nextFundingRateLong: number;
+    /**
+     * Next funding rate for the short side, as a per-epoch decimal fraction
+     * (`0.0001` = `0.01%`). Positive receives, negative pays.
+     */
+    nextFundingRateShort: number;
+    /**
+     * Timestamp of the next funding settlement, as reported by the solver — a Unix
+     * timestamp in **milliseconds** (e.g. `1783209600000`). `0` when the solver
+     * omits it. Consumers rendering a countdown should stay defensive about the
+     * unit (treat a value below `1e12` as seconds) in case the solver changes it.
+     */
+    nextFundingTime: number;
+    /** Length of one funding epoch, in seconds (e.g. `43200` = 12h). `0` when absent. */
+    epochDurationSeconds: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/solvers/funding-info/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/solvers/funding-info/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/solvers/instant-close/get-instant-closes/get-instant-closes.d.ts

@@ -1,7 +1,7 @@
 import { Address } from 'viem';
-import { Config } from '../../../core/config';
-import { ChainIdParameter, Compute } from '../../../shared/types/properties';
-import { PendingInstantClose } from './to-pending-instant-close';
+import { Config } from '../../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties.js';
+import { PendingInstantClose } from './to-pending-instant-close.js';
 /**
  * Parameters for {@link getInstantCloses}.
  */

package/dist/solvers/instant-close/get-instant-closes/index.d.ts

@@ -1,4 +1,4 @@
-export * from './get-instant-closes';
-export * from './query';
-export * from './to-pending-instant-close';
+export * from './get-instant-closes.js';
+export * from './query.js';
+export * from './to-pending-instant-close.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/get-instant-closes/query.d.ts

@@ -1,7 +1,7 @@
-import { Config } from '../../../core/config';
-import { Compute, ConfigKeyParameter, ExactPartial } from '../../../shared/types/properties';
-import { QueryParameter, SymmioQueryOptions } from '../../../shared/types/query';
-import { GetInstantClosesParameters, GetInstantClosesReturnType } from './get-instant-closes';
+import { Config } from '../../../core/config/index.js';
+import { Compute, ConfigKeyParameter, ExactPartial } from '../../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../../shared/types/query.js';
+import { GetInstantClosesParameters, GetInstantClosesReturnType } from './get-instant-closes.js';
 /** Data resolved by the {@link getInstantClosesQueryOptions} query. */
 export type GetInstantClosesData = GetInstantClosesReturnType;
 /**

package/dist/solvers/instant-close/get-instant-closes/to-pending-instant-close.d.ts

@@ -1,4 +1,4 @@
-import { ApiGetInstantCloseResponse } from '../../types/generated/enigma-solver';
+import { ApiGetInstantCloseResponse } from '../../types/generated/enigma-solver.js';
 /**
  * A pending instant-close record returned by a single hedger's
  * `/instant_close/{account}` endpoint.

package/dist/solvers/instant-close/index.d.ts

@@ -1,8 +1,8 @@
-export * from './get-instant-closes';
-export * from './instant-close';
-export * from './instant-close-auto';
-export * from './instant-close-bulk';
-export * from './instant-close-bulk-auto';
-export * from './prepare-instant-close-params';
-export * from './shared';
+export * from './get-instant-closes/index.js';
+export * from './instant-close/index.js';
+export * from './instant-close-auto/index.js';
+export * from './instant-close-bulk/index.js';
+export * from './instant-close-bulk-auto/index.js';
+export * from './prepare-instant-close-params/index.js';
+export * from './shared/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/instant-close/index.d.ts

@@ -1,3 +1,3 @@
-export * from './instant-close';
-export * from './query';
+export * from './instant-close.js';
+export * from './query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/instant-close/instant-close.d.ts

@@ -1,7 +1,7 @@
 import { Address, Hex } from 'viem';
-import { Config } from '../../../core/config';
-import { Compute, WriteSolverParameter } from '../../../shared/types/properties';
-import { InstantCloseOrder, InstantCloseReturnType } from '../shared/types';
+import { Config } from '../../../core/config/index.js';
+import { Compute, WriteSolverParameter } from '../../../shared/types/properties.js';
+import { InstantCloseOrder, InstantCloseReturnType } from '../shared/types.js';
 /**
  * Parameters for the pure {@link instantClose} primitive.
  *

package/dist/solvers/instant-close/instant-close/query.d.ts

@@ -1,5 +1,5 @@
-import { Config } from '../../../core/config';
-import { InstantCloseParameters } from './instant-close';
+import { Config } from '../../../core/config/index.js';
+import { InstantCloseParameters } from './instant-close.js';
 /**
  * Build TanStack Mutation options for the pure {@link instantClose} primitive.
  *
@@ -10,6 +10,6 @@ import { InstantCloseParameters } from './instant-close';
  */
 export declare function instantCloseMutationOptions(config: Config): {
     mutationKey: readonly ["instantClose"];
-    mutationFn: (variables: InstantCloseParameters) => Promise<import('..').InstantCloseReturnType>;
+    mutationFn: (variables: InstantCloseParameters) => Promise<import('../index.js').InstantCloseReturnType>;
 };
 //# sourceMappingURL=query.d.ts.map

package/dist/solvers/instant-close/instant-close-auto/index.d.ts

@@ -1,3 +1,3 @@
-export * from './instant-close-auto';
-export * from './query';
+export * from './instant-close-auto.js';
+export * from './query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/instant-close-auto/instant-close-auto.d.ts

@@ -1,6 +1,6 @@
-import { Config } from '../../../core/config';
-import { PrepareInstantCloseParameters } from '../prepare-instant-close-params/prepare-instant-close-params';
-import { InstantCloseReturnType } from '../shared/types';
+import { Config } from '../../../core/config/index.js';
+import { PrepareInstantCloseParameters } from '../prepare-instant-close-params/prepare-instant-close-params.js';
+import { InstantCloseReturnType } from '../shared/types.js';
 /**
  * Resolve missing inputs via {@link prepareInstantCloseParams} and immediately
  * submit through {@link instantClose}.

package/dist/solvers/instant-close/instant-close-auto/query.d.ts

@@ -1,5 +1,5 @@
-import { Config } from '../../../core/config';
-import { PrepareInstantCloseParameters } from '../prepare-instant-close-params/prepare-instant-close-params';
+import { Config } from '../../../core/config/index.js';
+import { PrepareInstantCloseParameters } from '../prepare-instant-close-params/prepare-instant-close-params.js';
 /**
  * Build TanStack Mutation options for {@link instantCloseAuto}.
  *
@@ -10,6 +10,6 @@ import { PrepareInstantCloseParameters } from '../prepare-instant-close-params/p
  */
 export declare function instantCloseAutoMutationOptions(config: Config): {
     mutationKey: readonly ["instantCloseAuto"];
-    mutationFn: (variables: PrepareInstantCloseParameters) => Promise<import('..').InstantCloseReturnType>;
+    mutationFn: (variables: PrepareInstantCloseParameters) => Promise<import('../index.js').InstantCloseReturnType>;
 };
 //# sourceMappingURL=query.d.ts.map

package/dist/solvers/instant-close/instant-close-bulk/index.d.ts

@@ -1,3 +1,3 @@
-export * from './instant-close-bulk';
-export * from './query';
+export * from './instant-close-bulk.js';
+export * from './query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/instant-close-bulk/instant-close-bulk.d.ts

@@ -1,7 +1,7 @@
 import { Address, Hex } from 'viem';
-import { Config } from '../../../core/config';
-import { Compute, WriteSolverParameter } from '../../../shared/types/properties';
-import { InstantCloseOrder } from '../shared/types';
+import { Config } from '../../../core/config/index.js';
+import { Compute, WriteSolverParameter } from '../../../shared/types/properties.js';
+import { InstantCloseOrder } from '../shared/types.js';
 /** Maximum orders per {@link instantCloseBulk} call (matches the hedger's `1–100` window). */
 export declare const MAX_INSTANT_CLOSE_BULK_ORDERS = 100;
 /**

package/dist/solvers/instant-close/instant-close-bulk/query.d.ts

@@ -1,5 +1,5 @@
-import { Config } from '../../../core/config';
-import { InstantCloseBulkParameters } from './instant-close-bulk';
+import { Config } from '../../../core/config/index.js';
+import { InstantCloseBulkParameters } from './instant-close-bulk.js';
 /**
  * Build TanStack Mutation options for the pure {@link instantCloseBulk}
  * primitive.
@@ -11,6 +11,6 @@ import { InstantCloseBulkParameters } from './instant-close-bulk';
  */
 export declare function instantCloseBulkMutationOptions(config: Config): {
     mutationKey: readonly ["instantCloseBulk"];
-    mutationFn: (variables: InstantCloseBulkParameters) => Promise<import('./instant-close-bulk').InstantCloseBulkReturnType>;
+    mutationFn: (variables: InstantCloseBulkParameters) => Promise<import('./instant-close-bulk.js').InstantCloseBulkReturnType>;
 };
 //# sourceMappingURL=query.d.ts.map

package/dist/solvers/instant-close/instant-close-bulk-auto/index.d.ts

@@ -1,3 +1,3 @@
-export * from './instant-close-bulk-auto';
-export * from './query';
+export * from './instant-close-bulk-auto.js';
+export * from './query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/instant-close-bulk-auto/instant-close-bulk-auto.d.ts

@@ -1,8 +1,8 @@
 import { Address, Hex } from 'viem';
-import { Config } from '../../../core/config';
-import { Compute, WriteSolverParameter } from '../../../shared/types/properties';
-import { InstantCloseBulkReturnType } from '../instant-close-bulk/instant-close-bulk';
-import { InstantCloseMarketData, PositionType } from '../shared/types';
+import { Config } from '../../../core/config/index.js';
+import { Compute, WriteSolverParameter } from '../../../shared/types/properties.js';
+import { InstantCloseBulkReturnType } from '../instant-close-bulk/instant-close-bulk.js';
+import { InstantCloseMarketData, PositionType } from '../shared/types.js';
 /**
  * One UI-shape close intent inside an {@link instantCloseBulkAuto} batch. Each
  * entry mirrors `prepareInstantCloseParams` minus the per-call `from`/`chainId`

package/dist/solvers/instant-close/instant-close-bulk-auto/query.d.ts

@@ -1,5 +1,5 @@
-import { Config } from '../../../core/config';
-import { InstantCloseBulkAutoParameters } from './instant-close-bulk-auto';
+import { Config } from '../../../core/config/index.js';
+import { InstantCloseBulkAutoParameters } from './instant-close-bulk-auto.js';
 /**
  * Build TanStack Mutation options for {@link instantCloseBulkAuto}.
  *
@@ -10,6 +10,6 @@ import { InstantCloseBulkAutoParameters } from './instant-close-bulk-auto';
  */
 export declare function instantCloseBulkAutoMutationOptions(config: Config): {
     mutationKey: readonly ["instantCloseBulkAuto"];
-    mutationFn: (variables: InstantCloseBulkAutoParameters) => Promise<import('..').InstantCloseBulkReturnType>;
+    mutationFn: (variables: InstantCloseBulkAutoParameters) => Promise<import('../index.js').InstantCloseBulkReturnType>;
 };
 //# sourceMappingURL=query.d.ts.map

package/dist/solvers/instant-close/prepare-instant-close-params/index.d.ts

@@ -1,2 +1,2 @@
-export * from './prepare-instant-close-params';
+export * from './prepare-instant-close-params.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/prepare-instant-close-params/prepare-instant-close-params.d.ts

@@ -1,8 +1,8 @@
 import { Address, Hex } from 'viem';
-import { Config } from '../../../core/config';
-import { Compute, WriteSolverParameter } from '../../../shared/types/properties';
-import { InstantCloseParameters } from '../instant-close/instant-close';
-import { InstantCloseMarketData, PositionType } from '../shared/types';
+import { Config } from '../../../core/config/index.js';
+import { Compute, WriteSolverParameter } from '../../../shared/types/properties.js';
+import { InstantCloseParameters } from '../instant-close/instant-close.js';
+import { InstantCloseMarketData, PositionType } from '../shared/types.js';
 /**
  * Parameters for {@link prepareInstantCloseParams} and `instantCloseAuto`.
  *

package/dist/solvers/instant-close/shared/close-math.d.ts

@@ -1,4 +1,4 @@
-import { PositionType } from './types';
+import { PositionType } from './types.js';
 /**
  * Parameters for {@link calculateClosePrice}.
  */

package/dist/solvers/instant-close/shared/hedger-api.d.ts

@@ -1,6 +1,6 @@
-import { Config } from '../../../core/config';
-import { ChainIdParameter, Compute } from '../../../shared/types/properties';
-import { ApiV2InstantCloseRequest } from '../../types/generated/enigma-solver';
+import { Config } from '../../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties.js';
+import { ApiV2InstantCloseRequest } from '../../types/generated/enigma-solver.js';
 /**
  * Parameters for {@link sendInstantClose}.
  *

package/dist/solvers/instant-close/shared/index.d.ts

@@ -1,6 +1,6 @@
-export * from './calldata';
-export * from './close-math';
-export * from './hedger-api';
-export * from './quote-constraints';
-export * from './types';
+export * from './calldata.js';
+export * from './close-math.js';
+export * from './hedger-api.js';
+export * from './quote-constraints.js';
+export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/shared/quote-constraints.d.ts

@@ -1,4 +1,4 @@
-import { SymbolContractSymbol } from '../../types/generated/enigma-solver';
+import { SymbolContractSymbol } from '../../types/generated/enigma-solver.js';
 /**
  * One reason a candidate instant-close quote violates the market's published
  * quote constraints. Returned in a list by

package/dist/solvers/instant-close/shared/types.d.ts

@@ -4,13 +4,13 @@ import { Hex } from 'viem';
  * place to import it from. Numeric values match the on-chain enum:
  * `LONG = 0`, `SHORT = 1`.
  */
-export { PositionType } from '../../../symmio-contracts/symmio/types';
+export { PositionType } from '../../../symmio-contracts/symmio/types.js';
 /**
  * Re-export the canonical MARKET order-type constant from the open slice.
  * Single source of truth — both instant-open and instant-close encode the
  * same on-chain enum value.
  */
-export { ORDER_TYPE_MARKET } from '../../instant-open/shared/types';
+export { ORDER_TYPE_MARKET } from '../../instant-open/shared/types.js';
 /**
  * Order-side trade values passed to `InstantCloseParameters`.
  *

package/dist/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.d.ts

@@ -1,5 +1,5 @@
-import { Config } from '../../../core/config';
-import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+import { Config } from '../../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties.js';
 /**
  * Parameters for {@link getInstantOpenQuoteId}.
  */

package/dist/solvers/instant-open/get-instant-open-quote-id/index.d.ts

@@ -1,3 +1,3 @@
-export * from './get-instant-open-quote-id';
-export * from './query';
+export * from './get-instant-open-quote-id.js';
+export * from './query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-open/get-instant-open-quote-id/query.d.ts

@@ -1,7 +1,7 @@
-import { Config } from '../../../core/config';
-import { Compute, ConfigKeyParameter } from '../../../shared/types/properties';
-import { QueryParameter, SymmioQueryOptions } from '../../../shared/types/query';
-import { GetInstantOpenQuoteIdParameters, GetInstantOpenQuoteIdReturnType } from './get-instant-open-quote-id';
+import { Config } from '../../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../../shared/types/query.js';
+import { GetInstantOpenQuoteIdParameters, GetInstantOpenQuoteIdReturnType } from './get-instant-open-quote-id.js';
 /** Data resolved by the {@link getInstantOpenQuoteIdQueryOptions} query. */
 export type GetInstantOpenQuoteIdData = GetInstantOpenQuoteIdReturnType;
 /**