@symmio/trading-react 3.0.0 → 3.0.1-staging-20260926093035

package/dist/instant-layer/use-instant-close-fees.js

@@ -0,0 +1,83 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { useFeeForUser as r } from "../fees/use-fee-for-user.js";
+import { useMarkets as i } from "../markets/use-markets.js";
+import { usePriceByName as a } from "../price-service/use-price-by-name.js";
+import { useSolverInfo as o } from "../solvers/use-solver-info.js";
+import { getInstantCloseFeesQueryOptions as s } from "@symmio/trading-core";
+import { useQuery as c } from "@tanstack/react-query";
+//#region src/instant-layer/use-instant-close-fees.ts
+function l(l) {
+	let u = t(l), d = e(), f = l.chainId ?? d, { subAccountAddress: p, market: m, quantity: h, openedAt: g, now: _, solverId: v } = l, y = (l.query?.enabled ?? !0) && h.length > 0, b = u.getSolver({
+		chainId: f,
+		solverId: v
+	}).id === "enigma", x = i({
+		config: l.config,
+		chainId: f,
+		solverId: v,
+		query: {
+			enabled: y,
+			staleTime: 3e5
+		}
+	}).data?.find((e) => e.symbolId === m.id), S = m.name ?? x?.name, C = m.pricePrecision ?? x?.pricePrecision, w = m.quantityPrecision ?? x?.quantityPrecision, T = m.hedgerFeeOpen ?? x?.hedgerFeeOpen, E = m.hedgerFeeClose ?? x?.hedgerFeeClose, D = x?.kind === "enigma" ? x : void 0, O = m.hedgerFeeCloseEarlyRate ?? D?.hedgerFeeCloseEarlyRate ?? E, k = m.hedgerFeeCloseEarlyThreshold ?? D?.hedgerFeeCloseEarlyThreshold ?? 0, A = m.hedgerFeeCloseStandardThreshold ?? D?.hedgerFeeCloseStandardThreshold ?? 0, j = r({
+		config: l.config,
+		chainId: f,
+		user: p,
+		symbolId: BigInt(m.id),
+		query: {
+			enabled: y && l.feeRates === void 0,
+			staleTime: 3e5
+		}
+	}), M = l.feeRates ?? j.data, N = o({
+		config: l.config,
+		chainId: f,
+		solverId: v,
+		query: { enabled: y && b && l.solverInfo === void 0 }
+	}), P = b ? l.solverInfo ?? N.data ?? (N.isError ? {} : void 0) : void 0, F = !b || P !== void 0, I = a({
+		name: S,
+		solverId: v,
+		enabled: y && l.markPrice === void 0
+	}), L = l.markPrice ?? I.markPrice ?? void 0, R = y && S !== void 0 && C !== void 0 && w !== void 0 && M !== void 0 && L !== void 0 && (!b || T !== void 0 && E !== void 0) && F, z = s(u, {
+		subAccountAddress: p,
+		solverId: v,
+		chainId: f,
+		market: {
+			id: m.id,
+			name: S,
+			pricePrecision: C,
+			quantityPrecision: w,
+			hedgerFeeOpen: T,
+			hedgerFeeClose: E,
+			hedgerFeeCloseEarlyRate: O,
+			hedgerFeeCloseEarlyThreshold: k,
+			hedgerFeeCloseStandardThreshold: A
+		},
+		quantity: h,
+		openedAt: g,
+		now: _,
+		markPrice: L,
+		feeRates: M,
+		solverInfo: P,
+		query: {
+			...l.query,
+			enabled: R,
+			placeholderData: (e) => e
+		}
+	});
+	return c({
+		...z,
+		queryFn: async () => {
+			try {
+				return await z.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { l as useInstantCloseFees };
+
+//# sourceMappingURL=use-instant-close-fees.js.map

package/dist/instant-layer/use-instant-close-fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-instant-close-fees.js","names":[],"sources":["../../src/instant-layer/use-instant-close-fees.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getInstantCloseFeesQueryOptions,\n  type ConfigParameter,\n  type GetInstantCloseFeesOptions,\n  type GetInstantCloseFeesReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useFeeForUser } from \"../fees/use-fee-for-user\";\nimport { useMarkets } from \"../markets/use-markets\";\nimport { usePriceByName } from \"../price-service/use-price-by-name\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { useSolverInfo } from \"../solvers/use-solver-info\";\n\n/**\n * Parameters for {@link useInstantCloseFees}: the close intent\n * (`subAccountAddress`, `market`, `quantity`, `openedAt`, optional pre-fetched\n * data, TanStack `query` overrides) plus an optional `config`.\n */\nexport type UseInstantCloseFeesParameters = GetInstantCloseFeesOptions & ConfigParameter;\n\n/** Return type of {@link useInstantCloseFees}. */\nexport type UseInstantCloseFeesReturnType = UseQueryResult<GetInstantCloseFeesReturnType, SymmioRequestError>;\n\n/**\n * Preview every fee closing a position pays **right now** — the platform close\n * fee plus, on lowcap (Enigma), the holding-time solver close fee and the flat\n * static close leg. Read-only; nothing is signed. This is the close-flow\n * counterpart of `useInstantOpenFees`, which deliberately previews only the\n * open-side legs: the honest close cost exists only at close time, where the\n * notional and the decaying solver rate are real.\n *\n * Wraps `getInstantCloseFees`, but **pre-fetches every input through its own\n * cached queries and passes them in as prefills**, so the query function is\n * pure math with zero network hops: market metadata (`useMarkets`), on-chain\n * fee rates (`useFeeForUser`), and the solver's static fees (`useSolverInfo`)\n * are slow-moving and cached for minutes; the mark price rides the shared\n * price stream. Previous data is kept while inputs move, so a mark-price tick\n * updates the numbers in place.\n *\n * The holding time is stamped each time the query function runs, so a refetch\n * after the position ages re-prices the decaying solver close fee; pass `now`\n * for a deterministic preview. Narrow on `kind` to reach the lowcap-only legs\n * (`closeSolverFee`, `closeSolverFeeRate`, `holdingSeconds`,\n * `staticSolverFeeClose`).\n *\n * @example\n * ```tsx\n * const { data: fees } = useInstantCloseFees({\n *   subAccountAddress: partyA,\n *   market: { id: symbolId },\n *   quantity: quantityToClose,\n *   openedAt: position.createTimestamp,\n * });\n * // fees?.totalFee; fees?.kind === \"enigma\" && fees.closeSolverFee\n * ```\n */\nexport function useInstantCloseFees(parameters: UseInstantCloseFeesParameters): UseInstantCloseFeesReturnType {\n  const config = useSymmioConfig(parameters);\n  const contextChainId = useSymmioChainId();\n  const chainId = parameters.chainId ?? contextChainId;\n  const { subAccountAddress, market, quantity, openedAt, now, solverId } = parameters;\n  const enabled = (parameters.query?.enabled ?? true) && quantity.length > 0;\n\n  /** The solver close-fee schedule and the static leg exist only on lowcap (Enigma) solvers. */\n  const isLowcap = config.getSolver({ chainId, solverId }).id === \"enigma\";\n\n  // Market metadata — slow-moving; dedupes with any other useMarkets on the page.\n  const marketsQuery = useMarkets({\n    config: parameters.config,\n    chainId,\n    solverId,\n    query: { enabled, staleTime: 300_000 },\n  });\n  const resolvedMarket = marketsQuery.data?.find((entry) => entry.symbolId === market.id);\n  const marketName = market.name ?? resolvedMarket?.name;\n  const pricePrecision = market.pricePrecision ?? resolvedMarket?.pricePrecision;\n  const quantityPrecision = market.quantityPrecision ?? resolvedMarket?.quantityPrecision;\n  const hedgerFeeOpen = market.hedgerFeeOpen ?? resolvedMarket?.hedgerFeeOpen;\n  const hedgerFeeClose = market.hedgerFeeClose ?? resolvedMarket?.hedgerFeeClose;\n\n  // Time-decaying close-fee rates ride the same `useMarkets` read — they are\n  // Enigma-only fields on `EnigmaMarket`, so narrow on `kind` before reading.\n  const resolvedEnigmaMarket = resolvedMarket?.kind === \"enigma\" ? resolvedMarket : undefined;\n  const hedgerFeeCloseEarlyRate =\n    market.hedgerFeeCloseEarlyRate ?? resolvedEnigmaMarket?.hedgerFeeCloseEarlyRate ?? hedgerFeeClose;\n  const hedgerFeeCloseEarlyThreshold =\n    market.hedgerFeeCloseEarlyThreshold ?? resolvedEnigmaMarket?.hedgerFeeCloseEarlyThreshold ?? 0;\n  const hedgerFeeCloseStandardThreshold =\n    market.hedgerFeeCloseStandardThreshold ?? resolvedEnigmaMarket?.hedgerFeeCloseStandardThreshold ?? 0;\n\n  // On-chain platform fee rates — contract state, changes rarely; cached hard.\n  const feeQuery = useFeeForUser({\n    config: parameters.config,\n    chainId,\n    user: subAccountAddress,\n    symbolId: BigInt(market.id),\n    query: { enabled: enabled && parameters.feeRates === undefined, staleTime: 300_000 },\n  });\n  const feeRates = parameters.feeRates ?? feeQuery.data;\n\n  // Static close fee from the solver's `/info` config — lowcap only. Fail-soft:\n  // an unreachable `/info` prices the static leg at \"0\" instead of blocking the\n  // preview (mirrors the action's own resolver).\n  const solverInfoQuery = useSolverInfo({\n    config: parameters.config,\n    chainId,\n    solverId,\n    query: { enabled: enabled && isLowcap && parameters.solverInfo === undefined },\n  });\n  const solverInfo = !isLowcap\n    ? undefined\n    : (parameters.solverInfo ?? solverInfoQuery.data ?? (solverInfoQuery.isError ? {} : undefined));\n  const solverInfoSettled = !isLowcap || solverInfo !== undefined;\n\n  // Mark price — caller's cache-hot value wins; otherwise the shared stream.\n  const priceQuery = usePriceByName({\n    name: marketName,\n    solverId,\n    enabled: enabled && parameters.markPrice === undefined,\n  });\n  const markPrice = parameters.markPrice ?? priceQuery.markPrice ?? undefined;\n\n  // Every prefill present → the query function is pure math, zero fetches.\n  const ready =\n    enabled &&\n    marketName !== undefined &&\n    pricePrecision !== undefined &&\n    quantityPrecision !== undefined &&\n    feeRates !== undefined &&\n    markPrice !== undefined &&\n    (!isLowcap || (hedgerFeeOpen !== undefined && hedgerFeeClose !== undefined)) &&\n    solverInfoSettled;\n\n  const options = getInstantCloseFeesQueryOptions(config, {\n    subAccountAddress,\n    solverId,\n    chainId,\n    market: {\n      id: market.id,\n      name: marketName,\n      pricePrecision,\n      quantityPrecision,\n      hedgerFeeOpen,\n      hedgerFeeClose,\n      hedgerFeeCloseEarlyRate,\n      hedgerFeeCloseEarlyThreshold,\n      hedgerFeeCloseStandardThreshold,\n    },\n    quantity,\n    openedAt,\n    now,\n    markPrice,\n    feeRates,\n    solverInfo,\n    query: {\n      ...parameters.query,\n      enabled: ready,\n      // The mark price ticks often; keep showing the previous numbers while\n      // the pure recompute runs instead of flashing a loader.\n      placeholderData: (previous: GetInstantCloseFeesReturnType | undefined) => previous,\n    },\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseInstantCloseFeesReturnType;\n}\n"],"mappings":";;;;;;;;;;;AA6DA,SAAgB,EAAoB,GAA0E;CAC5G,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAU,EAAW,WAAW,GAChC,EAAE,sBAAmB,WAAQ,aAAU,aAAU,QAAK,gBAAa,GACnE,KAAW,EAAW,OAAO,WAAW,OAAS,EAAS,SAAS,GAGnE,IAAW,EAAO,UAAU;EAAE;EAAS;CAAS,CAAC,EAAE,OAAO,UAS1D,IANe,EAAW;EAC9B,QAAQ,EAAW;EACnB;EACA;EACA,OAAO;GAAE;GAAS,WAAW;EAAQ;CACvC,CACuB,EAAa,MAAM,MAAM,MAAU,EAAM,aAAa,EAAO,EAAE,GAChF,IAAa,EAAO,QAAQ,GAAgB,MAC5C,IAAiB,EAAO,kBAAkB,GAAgB,gBAC1D,IAAoB,EAAO,qBAAqB,GAAgB,mBAChE,IAAgB,EAAO,iBAAiB,GAAgB,eACxD,IAAiB,EAAO,kBAAkB,GAAgB,gBAI1D,IAAuB,GAAgB,SAAS,WAAW,IAAiB,KAAA,GAC5E,IACJ,EAAO,2BAA2B,GAAsB,2BAA2B,GAC/E,IACJ,EAAO,gCAAgC,GAAsB,gCAAgC,GACzF,IACJ,EAAO,mCAAmC,GAAsB,mCAAmC,GAG/F,IAAW,EAAc;EAC7B,QAAQ,EAAW;EACnB;EACA,MAAM;EACN,UAAU,OAAO,EAAO,EAAE;EAC1B,OAAO;GAAE,SAAS,KAAW,EAAW,aAAa,KAAA;GAAW,WAAW;EAAQ;CACrF,CAAC,GACK,IAAW,EAAW,YAAY,EAAS,MAK3C,IAAkB,EAAc;EACpC,QAAQ,EAAW;EACnB;EACA;EACA,OAAO,EAAE,SAAS,KAAW,KAAY,EAAW,eAAe,KAAA,EAAU;CAC/E,CAAC,GACK,IAAc,IAEf,EAAW,cAAc,EAAgB,SAAS,EAAgB,UAAU,CAAC,IAAI,KAAA,KADlF,KAAA,GAEE,IAAoB,CAAC,KAAY,MAAe,KAAA,GAGhD,IAAa,EAAe;EAChC,MAAM;EACN;EACA,SAAS,KAAW,EAAW,cAAc,KAAA;CAC/C,CAAC,GACK,IAAY,EAAW,aAAa,EAAW,aAAa,KAAA,GAG5D,IACJ,KACA,MAAe,KAAA,KACf,MAAmB,KAAA,KACnB,MAAsB,KAAA,KACtB,MAAa,KAAA,KACb,MAAc,KAAA,MACb,CAAC,KAAa,MAAkB,KAAA,KAAa,MAAmB,KAAA,MACjE,GAEI,IAAU,EAAgC,GAAQ;EACtD;EACA;EACA;EACA,QAAQ;GACN,IAAI,EAAO;GACX,MAAM;GACN;GACA;GACA;GACA;GACA;GACA;GACA;EACF;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;GACL,GAAG,EAAW;GACd,SAAS;GAGT,kBAAkB,MAAwD;EAC5E;CACF,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/instant-layer/use-instant-open-auto.d.ts

@@ -17,6 +17,11 @@ export type UseInstantOpenAutoReturnType = UseMutationResult<InstantOpenReturnTy
  * submit — use {@link useInstantOpen} after calling
  * `prepareInstantOpenParams(config, …)` directly.
  *
+ * Funding is a one-of on the variables: a typed `initialMargin`, or
+ * `fund: { mode: "full-balance", balance }` (lowcap only) to deploy the whole
+ * balance into the position's VA with the quantity sized down to fit it —
+ * see `FullBalanceFunding` in `@symmio/trading-core`.
+ *
  * @example
  * ```tsx
  * const { mutateAsync } = useInstantOpenAuto();

package/dist/instant-layer/use-instant-open-auto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-instant-open-auto.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-instant-open-auto.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAKzE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,eAAe,CAAC;AAE3D,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAC1D,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,4BAAiC,GAAG,4BAA4B,CA2B9G"}
+{"version":3,"file":"use-instant-open-auto.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-instant-open-auto.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAKzE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,eAAe,CAAC;AAE3D,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAC1D,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,4BAAiC,GAAG,4BAA4B,CA2B9G"}

package/dist/instant-layer/use-instant-open-auto.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-instant-open-auto.js","names":[],"sources":["../../src/instant-layer/use-instant-open-auto.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getInstantOpensQueryKey,\n  instantOpenAutoMutationOptions,\n  type ConfigParameter,\n  type InstantOpenReturnType,\n  type PrepareInstantOpenParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { invalidateAccountBalances, predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useInstantOpenAuto}.\n */\nexport type UseInstantOpenAutoParameters = ConfigParameter;\n\n/** Return type of {@link useInstantOpenAuto}. */\nexport type UseInstantOpenAutoReturnType = UseMutationResult<\n  InstantOpenReturnType,\n  SymmioRequestError,\n  PrepareInstantOpenParameters\n>;\n\n/**\n * Open a lowcap instant position via the wizard `instantOpenAuto` action.\n *\n * Friendly default: accepts the minimal trade intent and lets the SDK fetch\n * market metadata, mark price, locked params, and fee rates. Pre-fill any\n * optional field on the variables (e.g. cache-hot `markPrice`) to skip its\n * fetch. For full control — inspect / mutate resolved params between fetch and\n * submit — use {@link useInstantOpen} after calling\n * `prepareInstantOpenParams(config, …)` directly.\n *\n * @example\n * ```tsx\n * const { mutateAsync } = useInstantOpenAuto();\n * await mutateAsync({\n *   walletAddress, sessionKeyAddress, signTypedData,\n *   marketId: 1, positionType: \"LONG\",\n *   userInput: \"100\", leverage: 5, slippage: 1,\n * });\n * ```\n */\nexport function useInstantOpenAuto(parameters: UseInstantOpenAutoParameters = {}): UseInstantOpenAutoReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n  const base = instantOpenAutoMutationOptions(config);\n\n  return useMutation<InstantOpenReturnType, SymmioRequestError, PrepareInstantOpenParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        return await base.mutationFn({ ...variables, chainId: variables.chainId ?? chainId });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_result, variables) => {\n      /**\n       * A freshly submitted instant-open exists on the hedger but not in any\n       * cached read yet. Invalidate the instant-opens feed so it refetches and\n       * the optimistic row appears immediately — without waiting for a poll.\n       */\n      const configKey = config.getChainConfigKey(variables.chainId ?? chainId);\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getInstantOpensQueryKey, { configKey }) });\n      /** The open locks margin and charges a fee — every balance read on this chain is now suspect. */\n      invalidateAccountBalances(queryClient, { configKey });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AAgDA,SAAgB,EAAmB,IAA2C,CAAC,GAAiC;CAC9G,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAC7B,IAAO,EAA+B,CAAM;CAElD,OAAO,EAAqF;EAC1F,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,OAAO,MAAM,EAAK,WAAW;KAAE,GAAG;KAAW,SAAS,EAAU,WAAW;IAAQ,CAAC;GACtF,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GAMjC,IAAM,IAAY,EAAO,kBAAkB,EAAU,WAAW,CAAO;GAGvE,AAFA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAyB,EAAE,aAAU,CAAC,EAAE,CAAC,GAExG,EAA0B,GAAa,EAAE,aAAU,CAAC;EACtD;CACF,CAAC;AACH"}
+{"version":3,"file":"use-instant-open-auto.js","names":[],"sources":["../../src/instant-layer/use-instant-open-auto.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getInstantOpensQueryKey,\n  instantOpenAutoMutationOptions,\n  type ConfigParameter,\n  type InstantOpenReturnType,\n  type PrepareInstantOpenParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { invalidateAccountBalances, predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useInstantOpenAuto}.\n */\nexport type UseInstantOpenAutoParameters = ConfigParameter;\n\n/** Return type of {@link useInstantOpenAuto}. */\nexport type UseInstantOpenAutoReturnType = UseMutationResult<\n  InstantOpenReturnType,\n  SymmioRequestError,\n  PrepareInstantOpenParameters\n>;\n\n/**\n * Open a lowcap instant position via the wizard `instantOpenAuto` action.\n *\n * Friendly default: accepts the minimal trade intent and lets the SDK fetch\n * market metadata, mark price, locked params, and fee rates. Pre-fill any\n * optional field on the variables (e.g. cache-hot `markPrice`) to skip its\n * fetch. For full control — inspect / mutate resolved params between fetch and\n * submit — use {@link useInstantOpen} after calling\n * `prepareInstantOpenParams(config, …)` directly.\n *\n * Funding is a one-of on the variables: a typed `initialMargin`, or\n * `fund: { mode: \"full-balance\", balance }` (lowcap only) to deploy the whole\n * balance into the position's VA with the quantity sized down to fit it —\n * see `FullBalanceFunding` in `@symmio/trading-core`.\n *\n * @example\n * ```tsx\n * const { mutateAsync } = useInstantOpenAuto();\n * await mutateAsync({\n *   walletAddress, sessionKeyAddress, signTypedData,\n *   marketId: 1, positionType: \"LONG\",\n *   userInput: \"100\", leverage: 5, slippage: 1,\n * });\n * ```\n */\nexport function useInstantOpenAuto(parameters: UseInstantOpenAutoParameters = {}): UseInstantOpenAutoReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n  const base = instantOpenAutoMutationOptions(config);\n\n  return useMutation<InstantOpenReturnType, SymmioRequestError, PrepareInstantOpenParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        return await base.mutationFn({ ...variables, chainId: variables.chainId ?? chainId });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_result, variables) => {\n      /**\n       * A freshly submitted instant-open exists on the hedger but not in any\n       * cached read yet. Invalidate the instant-opens feed so it refetches and\n       * the optimistic row appears immediately — without waiting for a poll.\n       */\n      const configKey = config.getChainConfigKey(variables.chainId ?? chainId);\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getInstantOpensQueryKey, { configKey }) });\n      /** The open locks margin and charges a fee — every balance read on this chain is now suspect. */\n      invalidateAccountBalances(queryClient, { configKey });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AAqDA,SAAgB,EAAmB,IAA2C,CAAC,GAAiC;CAC9G,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAC7B,IAAO,EAA+B,CAAM;CAElD,OAAO,EAAqF;EAC1F,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,OAAO,MAAM,EAAK,WAAW;KAAE,GAAG;KAAW,SAAS,EAAU,WAAW;IAAQ,CAAC;GACtF,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GAMjC,IAAM,IAAY,EAAO,kBAAkB,EAAU,WAAW,CAAO;GAGvE,AAFA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAyB,EAAE,aAAU,CAAC,EAAE,CAAC,GAExG,EAA0B,GAAa,EAAE,aAAU,CAAC;EACtD;CACF,CAAC;AACH"}

package/dist/instant-layer/use-instant-open-fees.d.ts

@@ -3,13 +3,18 @@ import { UseQueryResult } from '@tanstack/react-query';
 import { SymmioRequestError } from '../errors/symmio-request-error.js';
 /**
  * Parameters for {@link useInstantOpenFees}: the trade intent
- * (`subAccountAddress`, `market`, `positionType`, `initialMargin`,
- * `leverage`, optional `slippage` / pre-fetched data, TanStack `query`
- * overrides) plus an optional `config`.
+ * (`subAccountAddress`, `market`, `positionType`, `initialMargin` **or**
+ * `fund` for a full-balance preview, `leverage`, optional `slippage` /
+ * pre-fetched data, TanStack `query` overrides) plus an optional `config`.
  */
 export type UseInstantOpenFeesParameters = GetInstantOpenFeesOptions & ConfigParameter;
 /** Return type of {@link useInstantOpenFees}. */
-export type UseInstantOpenFeesReturnType = UseQueryResult<GetInstantOpenFeesReturnType, SymmioRequestError>;
+export type UseInstantOpenFeesReturnType = UseQueryResult<GetInstantOpenFeesReturnType, SymmioRequestError> & {
+    /** Synchronous input error. Display before query.error; dependent queries stay disabled. */
+    validationError: SymmioRequestError | undefined;
+    /** True when all inputs and the current fee preview have settled successfully. */
+    isReady: boolean;
+};
 /**
  * Preview every fee a new instant-open quote pays — separated by leg plus the
  * total — before the user submits. Read-only; nothing is signed.
@@ -17,15 +22,33 @@ export type UseInstantOpenFeesReturnType = UseQueryResult<GetInstantOpenFeesRetu
  * Wraps `getInstantOpenFees`, but **pre-fetches every input through its own
  * cached queries and passes them in as prefills**, so the query function is
  * pure math with zero network hops: market metadata (`useMarkets`) and
- * on-chain fee rates (`useFeeForUser`) are slow-moving and cached for
- * minutes; the mark price rides the shared price stream; the lowcap dry-run
- * estimate uses `useEstimatedPrice` (debounced internally). Previous data is
+ * on-chain fee rates (`useFeeForUser`) and solver info are cached for minutes.
+ * The mark price rides the shared price stream; the lowcap dry-run estimate
+ * uses `useEstimatedPrice` (debounced internally). Previous data is
  * kept while inputs move, so a mark-price tick updates the numbers in place —
  * it never resets the result to a loading state.
  *
- * The result is a `kind`-discriminated union: both kinds carry the platform
- * legs and `totalFee`; an `"enigma"` (lowcap) result adds `openSolverFee`,
- * `closeSolverFee`, and `expectedSettlementLoss`.
+ * The result is a `kind`-discriminated union of the **open-side** legs: both
+ * kinds carry `platformOpenFee`, the sized `quantity`, and `totalFee`; an
+ * `"enigma"` (lowcap) result adds `openSolverFee`, `staticSolverFeeOpen`, and
+ * `expectedSettlementLoss`. Close fees are charged at close from the position
+ * and are deliberately not part of this preview — price them in the close flow
+ * with `useInstantCloseFees`, where the notional and holding time are real.
+ * `totalFee` includes the settlement provision by default; pass
+ * `includeSettlementInTotalFee: false` to sum the fee legs only.
+ *
+ * With `fund` (`FullBalanceFunding`) instead of `initialMargin`, the
+ * preview runs the same probe-and-rescale sizing as the open, so the legs and
+ * `quantity` equal what a full-balance open will actually charge and submit —
+ * the extra inputs it needs (locked-param percents, market quote constraints)
+ * are prefetched here through the same cached queries.
+ *
+ * With `initialMargin` and `availableBalance`, core automatically uses full-balance
+ * sizing when required funding exceeds the raw balance. `data.fundingMode` reports
+ * the effective choice; pass the same inputs to preparation and submission.
+ * Display `validationError ?? error` and check `isReady` before using the fees
+ * for the current input. Input errors are synchronous, including offline.
+ * A disabled hook or empty input remains idle without input validation.
  *
  * @example
  * ```tsx

package/dist/instant-layer/use-instant-open-fees.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-instant-open-fees.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-instant-open-fees.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAQzE;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,yBAAyB,GAAG,eAAe,CAAC;AAEvF,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,4BAA4B,EAAE,kBAAkB,CAAC,CAAC;AAE5G;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,4BAA4B,GAAG,4BAA4B,CAkJzG"}
+{"version":3,"file":"use-instant-open-fees.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-instant-open-fees.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,yBAAyB,GAAG,eAAe,CAAC;AAEvF,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,4BAA4B,EAAE,kBAAkB,CAAC,GAAG;IAC5G,4FAA4F;IAC5F,eAAe,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAChD,kFAAkF;IAClF,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,4BAA4B,GAAG,4BAA4B,CA2BzG"}

package/dist/instant-layer/use-instant-open-fees.js

@@ -1,111 +1,35 @@
 "use client";
-import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
-import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
-import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
-import { useEstimatedPrice as r } from "../estimated-price/use-estimated-price.js";
-import { useFeeForUser as i } from "../fees/use-fee-for-user.js";
-import { useMarkets as a } from "../markets/use-markets.js";
-import { usePriceByName as o } from "../price-service/use-price-by-name.js";
-import { PositionType as s, calculateTradeParams as c, getInstantOpenFeesQueryOptions as l } from "@symmio/trading-core";
-import { useMemo as u } from "react";
-import { useQuery as d } from "@tanstack/react-query";
+import { normalizeSymmError as e } from "../errors/normalize-symm-error.js";
+import { useInstantOpenInputs as t } from "./use-instant-open-inputs.js";
+import { getInstantOpenFeesQueryOptions as n } from "@symmio/trading-core";
+import { useQuery as r } from "@tanstack/react-query";
 //#region src/instant-layer/use-instant-open-fees.ts
-function f(f) {
-	let p = t(f), m = e(), h = f.chainId ?? m, { subAccountAddress: g, market: _, positionType: v, initialMargin: y, leverage: b, slippage: x, solverId: S } = f, C = (f.query?.enabled ?? !0) && y.length > 0, w = p.getSolver({
-		chainId: h,
-		solverId: S
-	}).id === "enigma", T = a({
-		config: f.config,
-		chainId: h,
-		solverId: S,
+function i(i) {
+	let a = t(i, "fees", i.query?.enabled !== !1), o = n(a.config, {
+		...i,
+		...a.prefills,
 		query: {
-			enabled: C,
-			staleTime: 3e5
+			...i.query,
+			enabled: a.ready,
+			placeholderData: (e) => a.validationError === void 0 ? e : void 0
 		}
-	}).data?.find((e) => e.symbolId === _.id), E = _.name ?? T?.name, D = _.pricePrecision ?? T?.pricePrecision, O = _.quantityPrecision ?? T?.quantityPrecision, k = _.hedgerFeeOpen ?? T?.hedgerFeeOpen, A = _.hedgerFeeClose ?? T?.hedgerFeeClose, j = T?.kind === "enigma" ? T : void 0, M = _.hedgerFeeCloseEarlyRate ?? j?.hedgerFeeCloseEarlyRate ?? A, N = _.hedgerFeeCloseEarlyThreshold ?? j?.hedgerFeeCloseEarlyThreshold ?? 0, P = _.hedgerFeeCloseStandardThreshold ?? j?.hedgerFeeCloseStandardThreshold ?? 0, F = i({
-		config: f.config,
-		chainId: h,
-		user: g,
-		symbolId: BigInt(_.id),
-		query: {
-			enabled: C && f.feeRates === void 0,
-			staleTime: 3e5
-		}
-	}), I = f.feeRates ?? F.data, L = o({
-		name: E,
-		solverId: S,
-		enabled: C && f.markPrice === void 0
-	}), R = f.markPrice ?? L.markPrice ?? void 0, z = u(() => !C || !w || R === void 0 || D === void 0 || O === void 0 ? "" : c({
-		markPrice: R,
-		slippage: 0,
-		positionType: v,
-		userInput: y,
-		inputField: "PRICE",
-		leverage: b,
-		pricePrecision: D,
-		quantityPrecision: O
-	})?.quantity ?? "", [
-		C,
-		w,
-		R,
-		D,
-		O,
-		v,
-		y,
-		b
-	]), B = R === void 0 ? "" : String(Number(R) * (v === s.SHORT ? .5 : 1.5)), V = r({
-		config: f.config,
-		chainId: h,
-		solverId: S,
-		symbolId: _.id,
-		quantity: z,
-		positionType: v,
-		entry: "open",
-		price: B,
-		query: {
-			enabled: C && w && f.estimatedOpenPrice === void 0 && z.length > 0,
-			staleTime: 3e4
-		}
-	}), H = w ? f.estimatedOpenPrice ?? V.data?.estimatedPrice ?? "0" : void 0, U = !w || f.estimatedOpenPrice !== void 0 || V.isFetched || V.isError, W = C && E !== void 0 && D !== void 0 && O !== void 0 && I !== void 0 && R !== void 0 && (!w || k !== void 0 && A !== void 0) && U, G = l(p, {
-		subAccountAddress: g,
-		solverId: S,
-		chainId: h,
-		market: {
-			id: _.id,
-			name: E,
-			pricePrecision: D,
-			quantityPrecision: O,
-			hedgerFeeOpen: k,
-			hedgerFeeClose: A,
-			hedgerFeeCloseEarlyRate: M,
-			hedgerFeeCloseEarlyThreshold: N,
-			hedgerFeeCloseStandardThreshold: P
-		},
-		positionType: v,
-		initialMargin: y,
-		leverage: b,
-		slippage: x,
-		markPrice: R,
-		feeRates: I,
-		estimatedOpenPrice: H,
-		query: {
-			...f.query,
-			enabled: W,
-			placeholderData: (e) => e
-		}
-	});
-	return d({
-		...G,
+	}), s = r({
+		...o,
 		queryFn: async () => {
 			try {
-				return await G.queryFn();
-			} catch (e) {
-				throw n(e);
+				return await o.queryFn();
+			} catch (t) {
+				throw e(t);
 			}
 		}
 	});
+	return {
+		...s,
+		validationError: a.validationError,
+		isReady: a.ready && s.isSuccess && !s.isFetching && !s.isPlaceholderData
+	};
 }
 //#endregion
-export { f as useInstantOpenFees };
+export { i as useInstantOpenFees };
 
 //# sourceMappingURL=use-instant-open-fees.js.map

package/dist/instant-layer/use-instant-open-fees.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-instant-open-fees.js","names":[],"sources":["../../src/instant-layer/use-instant-open-fees.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  calculateTradeParams,\n  getInstantOpenFeesQueryOptions,\n  PositionType,\n  type ConfigParameter,\n  type GetInstantOpenFeesOptions,\n  type GetInstantOpenFeesReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useEstimatedPrice } from \"../estimated-price/use-estimated-price\";\nimport { useFeeForUser } from \"../fees/use-fee-for-user\";\nimport { useMarkets } from \"../markets/use-markets\";\nimport { usePriceByName } from \"../price-service/use-price-by-name\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useInstantOpenFees}: the trade intent\n * (`subAccountAddress`, `market`, `positionType`, `initialMargin`,\n * `leverage`, optional `slippage` / pre-fetched data, TanStack `query`\n * overrides) plus an optional `config`.\n */\nexport type UseInstantOpenFeesParameters = GetInstantOpenFeesOptions & ConfigParameter;\n\n/** Return type of {@link useInstantOpenFees}. */\nexport type UseInstantOpenFeesReturnType = UseQueryResult<GetInstantOpenFeesReturnType, SymmioRequestError>;\n\n/**\n * Preview every fee a new instant-open quote pays — separated by leg plus the\n * total — before the user submits. Read-only; nothing is signed.\n *\n * Wraps `getInstantOpenFees`, but **pre-fetches every input through its own\n * cached queries and passes them in as prefills**, so the query function is\n * pure math with zero network hops: market metadata (`useMarkets`) and\n * on-chain fee rates (`useFeeForUser`) are slow-moving and cached for\n * minutes; the mark price rides the shared price stream; the lowcap dry-run\n * estimate uses `useEstimatedPrice` (debounced internally). Previous data is\n * kept while inputs move, so a mark-price tick updates the numbers in place —\n * it never resets the result to a loading state.\n *\n * The result is a `kind`-discriminated union: both kinds carry the platform\n * legs and `totalFee`; an `\"enigma\"` (lowcap) result adds `openSolverFee`,\n * `closeSolverFee`, and `expectedSettlementLoss`.\n *\n * @example\n * ```tsx\n * const { data: fees } = useInstantOpenFees({\n *   subAccountAddress,\n *   market: { id: symbolId },\n *   positionType,\n *   initialMargin,\n *   leverage,\n * });\n * // fees?.totalFee; fees?.kind === \"enigma\" && fees.expectedSettlementLoss\n * ```\n */\nexport function useInstantOpenFees(parameters: UseInstantOpenFeesParameters): UseInstantOpenFeesReturnType {\n  const config = useSymmioConfig(parameters);\n  const contextChainId = useSymmioChainId();\n  const chainId = parameters.chainId ?? contextChainId;\n  const { subAccountAddress, market, positionType, initialMargin, leverage, slippage, solverId } = parameters;\n  const enabled = (parameters.query?.enabled ?? true) && initialMargin.length > 0;\n\n  /** The dry-run estimate exists only on lowcap (Enigma) solvers. */\n  const isLowcap = config.getSolver({ chainId, solverId }).id === \"enigma\";\n\n  // Market metadata — slow-moving; dedupes with any other useMarkets on the page.\n  const marketsQuery = useMarkets({\n    config: parameters.config,\n    chainId,\n    solverId,\n    query: { enabled, staleTime: 300_000 },\n  });\n  const resolvedMarket = marketsQuery.data?.find((entry) => entry.symbolId === market.id);\n  const marketName = market.name ?? resolvedMarket?.name;\n  const pricePrecision = market.pricePrecision ?? resolvedMarket?.pricePrecision;\n  const quantityPrecision = market.quantityPrecision ?? resolvedMarket?.quantityPrecision;\n  const hedgerFeeOpen = market.hedgerFeeOpen ?? resolvedMarket?.hedgerFeeOpen;\n  const hedgerFeeClose = market.hedgerFeeClose ?? resolvedMarket?.hedgerFeeClose;\n\n  // Time-decaying close-fee rates ride the same `useMarkets` read — they are\n  // Enigma-only fields on `EnigmaMarket`, so narrow on `kind` before reading.\n  const resolvedEnigmaMarket = resolvedMarket?.kind === \"enigma\" ? resolvedMarket : undefined;\n  const hedgerFeeCloseEarlyRate =\n    market.hedgerFeeCloseEarlyRate ?? resolvedEnigmaMarket?.hedgerFeeCloseEarlyRate ?? hedgerFeeClose;\n  const hedgerFeeCloseEarlyThreshold =\n    market.hedgerFeeCloseEarlyThreshold ?? resolvedEnigmaMarket?.hedgerFeeCloseEarlyThreshold ?? 0;\n  const hedgerFeeCloseStandardThreshold =\n    market.hedgerFeeCloseStandardThreshold ?? resolvedEnigmaMarket?.hedgerFeeCloseStandardThreshold ?? 0;\n\n  // On-chain platform fee rates — contract state, changes rarely; cached hard.\n  const feeQuery = useFeeForUser({\n    config: parameters.config,\n    chainId,\n    user: subAccountAddress,\n    symbolId: BigInt(market.id),\n    query: { enabled: enabled && parameters.feeRates === undefined, staleTime: 300_000 },\n  });\n  const feeRates = parameters.feeRates ?? feeQuery.data;\n\n  // Mark price — caller's cache-hot value wins; otherwise the shared stream.\n  const priceQuery = usePriceByName({\n    name: marketName,\n    solverId,\n    enabled: enabled && parameters.markPrice === undefined,\n  });\n  const markPrice = parameters.markPrice ?? priceQuery.markPrice ?? undefined;\n\n  // Lowcap dry-run estimate: mark-sized quantity, wide fixed request bound so\n  // the solver's price gate never rejects the question. Debounced internally.\n  const estimateQuantity = useMemo(() => {\n    if (!enabled || !isLowcap || markPrice === undefined) return \"\";\n    if (pricePrecision === undefined || quantityPrecision === undefined) return \"\";\n    const sized = calculateTradeParams({\n      markPrice,\n      slippage: 0,\n      positionType,\n      userInput: initialMargin,\n      inputField: \"PRICE\",\n      leverage,\n      pricePrecision,\n      quantityPrecision,\n    });\n    return sized?.quantity ?? \"\";\n  }, [enabled, isLowcap, markPrice, pricePrecision, quantityPrecision, positionType, initialMargin, leverage]);\n  const estimateRequestPrice =\n    markPrice !== undefined ? String(Number(markPrice) * (positionType === PositionType.SHORT ? 0.5 : 1.5)) : \"\";\n  const estimateQuery = useEstimatedPrice({\n    config: parameters.config,\n    chainId,\n    solverId,\n    symbolId: market.id,\n    quantity: estimateQuantity,\n    positionType,\n    entry: \"open\",\n    price: estimateRequestPrice,\n    query: {\n      enabled: enabled && isLowcap && parameters.estimatedOpenPrice === undefined && estimateQuantity.length > 0,\n      staleTime: 30_000,\n    },\n  });\n  // `\"0\"` is the action's \"no usable estimate\" sentinel: it suppresses the\n  // action's own fetch (the input IS supplied) and yields a zero settlement\n  // provision — so a solver outage never puts network calls back in queryFn.\n  const estimatedOpenPrice = !isLowcap\n    ? undefined\n    : (parameters.estimatedOpenPrice ?? estimateQuery.data?.estimatedPrice ?? \"0\");\n  const estimateSettled =\n    !isLowcap || parameters.estimatedOpenPrice !== undefined || estimateQuery.isFetched || estimateQuery.isError;\n\n  // Every prefill present → the query function is pure math, zero fetches.\n  const ready =\n    enabled &&\n    marketName !== undefined &&\n    pricePrecision !== undefined &&\n    quantityPrecision !== undefined &&\n    feeRates !== undefined &&\n    markPrice !== undefined &&\n    (!isLowcap || (hedgerFeeOpen !== undefined && hedgerFeeClose !== undefined)) &&\n    estimateSettled;\n\n  const options = getInstantOpenFeesQueryOptions(config, {\n    subAccountAddress,\n    solverId,\n    chainId,\n    market: {\n      id: market.id,\n      name: marketName,\n      pricePrecision,\n      quantityPrecision,\n      hedgerFeeOpen,\n      hedgerFeeClose,\n      hedgerFeeCloseEarlyRate,\n      hedgerFeeCloseEarlyThreshold,\n      hedgerFeeCloseStandardThreshold,\n    },\n    positionType,\n    initialMargin,\n    leverage,\n    slippage,\n    markPrice,\n    feeRates,\n    estimatedOpenPrice,\n    query: {\n      ...parameters.query,\n      enabled: ready,\n      // Inputs (mark price, estimate) tick often; keep showing the previous\n      // numbers while the pure recompute runs instead of flashing a loader.\n      placeholderData: (previous: GetInstantOpenFeesReturnType | undefined) => previous,\n    },\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseInstantOpenFeesReturnType;\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-instant-open-fees.js","names":[],"sources":["../../src/instant-layer/use-instant-open-fees.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getInstantOpenFeesQueryOptions,\n  type ConfigParameter,\n  type GetInstantOpenFeesOptions,\n  type GetInstantOpenFeesReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useInstantOpenInputs } from \"./use-instant-open-inputs\";\n\n/**\n * Parameters for {@link useInstantOpenFees}: the trade intent\n * (`subAccountAddress`, `market`, `positionType`, `initialMargin` **or**\n * `fund` for a full-balance preview, `leverage`, optional `slippage` /\n * pre-fetched data, TanStack `query` overrides) plus an optional `config`.\n */\nexport type UseInstantOpenFeesParameters = GetInstantOpenFeesOptions & ConfigParameter;\n\n/** Return type of {@link useInstantOpenFees}. */\nexport type UseInstantOpenFeesReturnType = UseQueryResult<GetInstantOpenFeesReturnType, SymmioRequestError> & {\n  /** Synchronous input error. Display before query.error; dependent queries stay disabled. */\n  validationError: SymmioRequestError | undefined;\n  /** True when all inputs and the current fee preview have settled successfully. */\n  isReady: boolean;\n};\n\n/**\n * Preview every fee a new instant-open quote pays — separated by leg plus the\n * total — before the user submits. Read-only; nothing is signed.\n *\n * Wraps `getInstantOpenFees`, but **pre-fetches every input through its own\n * cached queries and passes them in as prefills**, so the query function is\n * pure math with zero network hops: market metadata (`useMarkets`) and\n * on-chain fee rates (`useFeeForUser`) and solver info are cached for minutes.\n * The mark price rides the shared price stream; the lowcap dry-run estimate\n * uses `useEstimatedPrice` (debounced internally). Previous data is\n * kept while inputs move, so a mark-price tick updates the numbers in place —\n * it never resets the result to a loading state.\n *\n * The result is a `kind`-discriminated union of the **open-side** legs: both\n * kinds carry `platformOpenFee`, the sized `quantity`, and `totalFee`; an\n * `\"enigma\"` (lowcap) result adds `openSolverFee`, `staticSolverFeeOpen`, and\n * `expectedSettlementLoss`. Close fees are charged at close from the position\n * and are deliberately not part of this preview — price them in the close flow\n * with `useInstantCloseFees`, where the notional and holding time are real.\n * `totalFee` includes the settlement provision by default; pass\n * `includeSettlementInTotalFee: false` to sum the fee legs only.\n *\n * With `fund` (`FullBalanceFunding`) instead of `initialMargin`, the\n * preview runs the same probe-and-rescale sizing as the open, so the legs and\n * `quantity` equal what a full-balance open will actually charge and submit —\n * the extra inputs it needs (locked-param percents, market quote constraints)\n * are prefetched here through the same cached queries.\n *\n * With `initialMargin` and `availableBalance`, core automatically uses full-balance\n * sizing when required funding exceeds the raw balance. `data.fundingMode` reports\n * the effective choice; pass the same inputs to preparation and submission.\n * Display `validationError ?? error` and check `isReady` before using the fees\n * for the current input. Input errors are synchronous, including offline.\n * A disabled hook or empty input remains idle without input validation.\n *\n * @example\n * ```tsx\n * const { data: fees } = useInstantOpenFees({\n *   subAccountAddress,\n *   market: { id: symbolId },\n *   positionType,\n *   initialMargin,\n *   leverage,\n * });\n * // fees?.totalFee; fees?.kind === \"enigma\" && fees.expectedSettlementLoss\n * ```\n */\nexport function useInstantOpenFees(parameters: UseInstantOpenFeesParameters): UseInstantOpenFeesReturnType {\n  const inputs = useInstantOpenInputs(parameters, \"fees\", parameters.query?.enabled !== false);\n  const options = getInstantOpenFeesQueryOptions(inputs.config, {\n    ...parameters,\n    ...inputs.prefills,\n    query: {\n      ...parameters.query,\n      enabled: inputs.ready,\n      placeholderData: (previous) => (inputs.validationError === undefined ? previous : undefined),\n    },\n  });\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<GetInstantOpenFeesReturnType, SymmioRequestError>;\n\n  return {\n    ...query,\n    validationError: inputs.validationError,\n    isReady: inputs.ready && query.isSuccess && !query.isFetching && !query.isPlaceholderData,\n  };\n}\n"],"mappings":";;;;;;AA4EA,SAAgB,EAAmB,GAAwE;CACzG,IAAM,IAAS,EAAqB,GAAY,QAAQ,EAAW,OAAO,YAAY,EAAK,GACrF,IAAU,EAA+B,EAAO,QAAQ;EAC5D,GAAG;EACH,GAAG,EAAO;EACV,OAAO;GACL,GAAG,EAAW;GACd,SAAS,EAAO;GAChB,kBAAkB,MAAc,EAAO,oBAAoB,KAAA,IAAY,IAAW,KAAA;EACpF;CACF,CAAC,GACK,IAAQ,EAAS;EACrB,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;CAED,OAAO;EACL,GAAG;EACH,iBAAiB,EAAO;EACxB,SAAS,EAAO,SAAS,EAAM,aAAa,CAAC,EAAM,cAAc,CAAC,EAAM;CAC1E;AACF"}

package/dist/instant-layer/use-instant-open-inputs.d.ts

@@ -0,0 +1,35 @@
+import { ConfigParameter, GetInstantOpenFeesParameters } from '@symmio/trading-core';
+/** Shared input orchestration for preparation and fee previews; calculations stay in core. */
+export declare function useInstantOpenInputs(parameters: GetInstantOpenFeesParameters & ConfigParameter, purpose: "prepare" | "fees", queryEnabled?: boolean): {
+    config: import('@symmio/trading-core').Config;
+    validationError: import('../index.js').SymmioRequestError | undefined;
+    ready: boolean;
+    prefills: {
+        chainId: number;
+        market: {
+            id: number;
+            name: string | undefined;
+            pricePrecision: number | undefined;
+            quantityPrecision: number | undefined;
+            minOpenSolverFeeCap: string | undefined;
+            minCloseSolverFeeCap: string | undefined;
+            hedgerFeeOpen: string | undefined;
+            hedgerFeeClose: string | undefined;
+            hedgerFeeCloseEarlyRate: string | undefined;
+            hedgerFeeCloseEarlyThreshold: number;
+            hedgerFeeCloseStandardThreshold: number;
+            minAcceptablePortionLf: string | undefined;
+            minAcceptableQuoteValue: string | undefined;
+            maxNotionalValue: number | undefined;
+            minNotionalValue: string | undefined;
+            maxQuantity: string | undefined;
+            lotSize: string | undefined;
+        };
+        markPrice: string | undefined;
+        feeRates: import('@symmio/trading-core').FeeForUser | undefined;
+        lockedParamPercent: import('@symmio/trading-core').SolverLockedParams | undefined;
+        solverInfo: import('@symmio/trading-core').EnigmaSolverInfo | undefined;
+        estimatedOpenPrice: string | null | undefined;
+    };
+};
+//# sourceMappingURL=use-instant-open-inputs.d.ts.map

package/dist/instant-layer/use-instant-open-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-instant-open-inputs.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-instant-open-inputs.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAY9B,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,4BAA4B,GAAG,eAAe,EAC1D,OAAO,EAAE,SAAS,GAAG,MAAM,EAC3B,YAAY,UAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6NpB"}

package/dist/instant-layer/use-instant-open-inputs.js

@@ -0,0 +1,134 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as ee } from "../provider/use-symmio-config.js";
+import { useFeeForUser as te } from "../fees/use-fee-for-user.js";
+import { useMarkets as ne } from "../markets/use-markets.js";
+import { usePriceByName as re } from "../price-service/use-price-by-name.js";
+import { useSolverInfo as ie } from "../solvers/use-solver-info.js";
+import { useEstimatedPrice as t } from "../estimated-price/use-estimated-price.js";
+import { useLockedParams as n } from "../locked-params/use-locked-params.js";
+import { getInstantOpenFundingError as r } from "./get-instant-open-funding-error.js";
+import { PositionType as i, calculateTradeParams as a } from "@symmio/trading-core";
+import { useMemo as ae } from "react";
+//#region src/instant-layer/use-instant-open-inputs.ts
+function o(o, s, c = !0) {
+	let l = ee(o), u = e(), d = o.chainId ?? u, { subAccountAddress: f, market: p, positionType: m, initialMargin: oe, fund: h, leverage: g, solverId: _ } = o, v = h !== void 0, y = v || o.availableBalance !== void 0, b = s === "prepare" || y, se = s === "prepare" && l.getChainConfig(d).contractsVersion === "0.8.6", x = v ? h.balance : oe ?? "", S = c && x.length > 0, C = l.getSolver({
+		chainId: d,
+		solverId: _
+	}).id === "enigma", w = S ? r({
+		...o,
+		isLowcap: C
+	}) : void 0, T = S && w === void 0, E = ne({
+		config: o.config,
+		chainId: d,
+		solverId: _,
+		query: {
+			enabled: T,
+			staleTime: 3e5
+		}
+	}).data?.find((e) => e.symbolId === p.id), D = p.name ?? E?.name, O = p.pricePrecision ?? E?.pricePrecision, k = p.quantityPrecision ?? E?.quantityPrecision, A = p.hedgerFeeOpen ?? E?.hedgerFeeOpen, j = p.hedgerFeeClose ?? E?.hedgerFeeClose, M = p.minOpenSolverFeeCap ?? (E ? E.kind === "enigma" ? E.minOpenSolverFeeCap : "0" : void 0), N = p.minCloseSolverFeeCap ?? (E ? E.kind === "enigma" ? E.minCloseSolverFeeCap : "0" : void 0), ce = !se || M !== void 0 && N !== void 0, P = E?.kind === "enigma" ? E : void 0, le = p.hedgerFeeCloseEarlyRate ?? P?.hedgerFeeCloseEarlyRate ?? j, ue = p.hedgerFeeCloseEarlyThreshold ?? P?.hedgerFeeCloseEarlyThreshold ?? 0, F = p.hedgerFeeCloseStandardThreshold ?? P?.hedgerFeeCloseStandardThreshold ?? 0, I = p.minAcceptablePortionLf ?? E?.minAcceptablePortionLf, L = p.minAcceptableQuoteValue ?? E?.minAcceptableQuoteValue, R = p.maxNotionalValue ?? E?.maxNotionalValue, z = p.minNotionalValue ?? E?.minNotionalValue, B = p.maxQuantity ?? E?.maxQuantity, V = p.lotSize ?? E?.lotSize, H = !y || I !== void 0 && L !== void 0 && R !== void 0 && z !== void 0 && B !== void 0 && V !== void 0, U = o.lockedParamPercent?.cva !== void 0 && o.lockedParamPercent.lf !== void 0 && o.lockedParamPercent.partyAmm !== void 0 && o.lockedParamPercent.partyBmm !== void 0, W = n({
+		config: o.config,
+		chainId: d,
+		solverId: _,
+		symbol: D ?? "",
+		leverage: g,
+		query: {
+			enabled: T && b && !U && D !== void 0,
+			staleTime: 3e5
+		}
+	}), G = U ? o.lockedParamPercent : W.data ? {
+		cva: W.data.cva ?? "0",
+		lf: W.data.lf ?? "0",
+		partyAmm: W.data.partyAmm ?? "0",
+		partyBmm: W.data.partyBmm ?? "0"
+	} : void 0, de = !b || G !== void 0, K = ie({
+		config: o.config,
+		chainId: d,
+		solverId: _,
+		query: {
+			enabled: T && C && o.solverInfo === void 0,
+			staleTime: 3e5,
+			retry: !1
+		}
+	}), q = o.solverInfo ?? K.data ?? (K.isError ? {} : void 0), fe = !C || q !== void 0, pe = te({
+		config: o.config,
+		chainId: d,
+		user: f,
+		symbolId: BigInt(p.id),
+		query: {
+			enabled: T && o.feeRates === void 0,
+			staleTime: 3e5
+		}
+	}), J = o.feeRates ?? pe.data, me = re({
+		name: D,
+		solverId: _,
+		enabled: T && o.markPrice === void 0
+	}), Y = o.markPrice ?? me.markPrice ?? void 0, X = ae(() => !T || !C || Y === void 0 || O === void 0 || k === void 0 ? "" : a({
+		markPrice: Y,
+		slippage: 0,
+		positionType: m,
+		userInput: x,
+		inputField: "PRICE",
+		leverage: g,
+		pricePrecision: O,
+		quantityPrecision: k
+	})?.quantity ?? "", [
+		T,
+		C,
+		Y,
+		O,
+		k,
+		m,
+		x,
+		g
+	]), he = Y === void 0 ? "" : String(Number(Y) * (m === i.SHORT ? .5 : 1.5)), Z = t({
+		config: o.config,
+		chainId: d,
+		solverId: _,
+		symbolId: p.id,
+		quantity: X,
+		positionType: m,
+		entry: "open",
+		price: he,
+		query: {
+			enabled: T && C && o.estimatedOpenPrice === void 0 && X.length > 0,
+			staleTime: 3e4
+		}
+	}), ge = C && o.estimatedOpenPrice === void 0 && (Z.isDebouncing || Z.isFetching), Q = !C || o.estimatedOpenPrice !== void 0 || !ge && (Z.isFetched || Z.isError), $ = o.estimatedOpenPrice === void 0 ? Z.data?.estimatedPrice : o.estimatedOpenPrice, _e = !C || !Q ? void 0 : $ && $ !== "0" ? $ : null;
+	return {
+		config: l,
+		validationError: w,
+		ready: T && D !== void 0 && O !== void 0 && k !== void 0 && J !== void 0 && Y !== void 0 && de && (!C || A !== void 0 && j !== void 0) && H && ce && fe && Q,
+		prefills: {
+			chainId: d,
+			market: {
+				id: p.id,
+				name: D,
+				pricePrecision: O,
+				quantityPrecision: k,
+				minOpenSolverFeeCap: M,
+				minCloseSolverFeeCap: N,
+				hedgerFeeOpen: A,
+				hedgerFeeClose: j,
+				hedgerFeeCloseEarlyRate: le,
+				hedgerFeeCloseEarlyThreshold: ue,
+				hedgerFeeCloseStandardThreshold: F,
+				minAcceptablePortionLf: I,
+				minAcceptableQuoteValue: L,
+				maxNotionalValue: R,
+				minNotionalValue: z,
+				maxQuantity: B,
+				lotSize: V
+			},
+			markPrice: Y,
+			feeRates: J,
+			lockedParamPercent: G,
+			solverInfo: q,
+			estimatedOpenPrice: _e
+		}
+	};
+}
+//#endregion
+export { o as useInstantOpenInputs };
+
+//# sourceMappingURL=use-instant-open-inputs.js.map

package/dist/instant-layer/use-instant-open-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-instant-open-inputs.js","names":[],"sources":["../../src/instant-layer/use-instant-open-inputs.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  calculateTradeParams,\n  PositionType,\n  type ConfigParameter,\n  type GetInstantOpenFeesParameters,\n} from \"@symmio/trading-core\";\nimport { useMemo } from \"react\";\nimport { useEstimatedPrice } from \"../estimated-price/use-estimated-price\";\nimport { useFeeForUser } from \"../fees/use-fee-for-user\";\nimport { useLockedParams } from \"../locked-params/use-locked-params\";\nimport { useMarkets } from \"../markets/use-markets\";\nimport { usePriceByName } from \"../price-service/use-price-by-name\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { useSolverInfo } from \"../solvers/use-solver-info\";\nimport { getInstantOpenFundingError } from \"./get-instant-open-funding-error\";\n\n/** Shared input orchestration for preparation and fee previews; calculations stay in core. */\nexport function useInstantOpenInputs(\n  parameters: GetInstantOpenFeesParameters & ConfigParameter,\n  purpose: \"prepare\" | \"fees\",\n  queryEnabled = true,\n) {\n  const config = useSymmioConfig(parameters);\n  const contextChainId = useSymmioChainId();\n  const chainId = parameters.chainId ?? contextChainId;\n  const { subAccountAddress, market, positionType, initialMargin, fund, leverage, solverId } = parameters;\n  const isFullBalance = fund !== undefined;\n  const canSizeFullBalance = isFullBalance || parameters.availableBalance !== undefined;\n  const needsLockedParams = purpose === \"prepare\" || canSizeFullBalance;\n  const needsSolverFeeCaps = purpose === \"prepare\" && config.getChainConfig(chainId).contractsVersion === \"0.8.6\";\n  /** The amount driving the sizing math — the typed margin, or the whole balance in full-balance mode. */\n  const sizingInput = isFullBalance ? fund.balance : (initialMargin ?? \"\");\n  const requested = queryEnabled && sizingInput.length > 0;\n\n  /** The dry-run estimate exists only on lowcap (Enigma) solvers. */\n  const isLowcap = config.getSolver({ chainId, solverId }).id === \"enigma\";\n  const validationError = requested ? getInstantOpenFundingError({ ...parameters, isLowcap }) : undefined;\n  const enabled = requested && validationError === undefined;\n\n  // Market metadata — slow-moving; dedupes with any other useMarkets on the page.\n  const marketsQuery = useMarkets({\n    config: parameters.config,\n    chainId,\n    solverId,\n    query: { enabled, staleTime: 300_000 },\n  });\n  const resolvedMarket = marketsQuery.data?.find((entry) => entry.symbolId === market.id);\n  const marketName = market.name ?? resolvedMarket?.name;\n  const pricePrecision = market.pricePrecision ?? resolvedMarket?.pricePrecision;\n  const quantityPrecision = market.quantityPrecision ?? resolvedMarket?.quantityPrecision;\n  const hedgerFeeOpen = market.hedgerFeeOpen ?? resolvedMarket?.hedgerFeeOpen;\n  const hedgerFeeClose = market.hedgerFeeClose ?? resolvedMarket?.hedgerFeeClose;\n\n  const minOpenSolverFeeCap =\n    market.minOpenSolverFeeCap ??\n    (resolvedMarket ? (resolvedMarket.kind === \"enigma\" ? resolvedMarket.minOpenSolverFeeCap : \"0\") : undefined);\n  const minCloseSolverFeeCap =\n    market.minCloseSolverFeeCap ??\n    (resolvedMarket ? (resolvedMarket.kind === \"enigma\" ? resolvedMarket.minCloseSolverFeeCap : \"0\") : undefined);\n  const capsReady = !needsSolverFeeCaps || (minOpenSolverFeeCap !== undefined && minCloseSolverFeeCap !== undefined);\n\n  // Time-decaying close-fee rates ride the same `useMarkets` read — Enigma-only\n  // fields on `EnigmaMarket`, so narrow on `kind` before reading.\n  const resolvedEnigmaMarket = resolvedMarket?.kind === \"enigma\" ? resolvedMarket : undefined;\n  const hedgerFeeCloseEarlyRate =\n    market.hedgerFeeCloseEarlyRate ?? resolvedEnigmaMarket?.hedgerFeeCloseEarlyRate ?? hedgerFeeClose;\n  const hedgerFeeCloseEarlyThreshold =\n    market.hedgerFeeCloseEarlyThreshold ?? resolvedEnigmaMarket?.hedgerFeeCloseEarlyThreshold ?? 0;\n  const hedgerFeeCloseStandardThreshold =\n    market.hedgerFeeCloseStandardThreshold ?? resolvedEnigmaMarket?.hedgerFeeCloseStandardThreshold ?? 0;\n\n  // Quote constraints — explicit or automatic full-balance sizing snaps to the lot grid and checks the\n  // published floors; they ride the same `useMarkets` read.\n  const minAcceptablePortionLf = market.minAcceptablePortionLf ?? resolvedMarket?.minAcceptablePortionLf;\n  const minAcceptableQuoteValue = market.minAcceptableQuoteValue ?? resolvedMarket?.minAcceptableQuoteValue;\n  const maxNotionalValue = market.maxNotionalValue ?? resolvedMarket?.maxNotionalValue;\n  const minNotionalValue = market.minNotionalValue ?? resolvedMarket?.minNotionalValue;\n  const maxQuantity = market.maxQuantity ?? resolvedMarket?.maxQuantity;\n  const lotSize = market.lotSize ?? resolvedMarket?.lotSize;\n  const constraintsReady =\n    !canSizeFullBalance ||\n    (minAcceptablePortionLf !== undefined &&\n      minAcceptableQuoteValue !== undefined &&\n      maxNotionalValue !== undefined &&\n      minNotionalValue !== undefined &&\n      maxQuantity !== undefined &&\n      lotSize !== undefined);\n\n  // Preparation always needs locks; the fee preview needs them only for balance sizing.\n  const locksPrefilled =\n    parameters.lockedParamPercent?.cva !== undefined &&\n    parameters.lockedParamPercent.lf !== undefined &&\n    parameters.lockedParamPercent.partyAmm !== undefined &&\n    parameters.lockedParamPercent.partyBmm !== undefined;\n  const lockedParamsQuery = useLockedParams({\n    config: parameters.config,\n    chainId,\n    solverId,\n    symbol: marketName ?? \"\",\n    leverage,\n    query: {\n      enabled: enabled && needsLockedParams && !locksPrefilled && marketName !== undefined,\n      staleTime: 300_000,\n    },\n  });\n  const lockedParamPercent = locksPrefilled\n    ? parameters.lockedParamPercent\n    : lockedParamsQuery.data\n      ? {\n          // The resolver skips its fetch only when all four fields are present —\n          // mirror its `\"0\"` defaults for fields the solver omits.\n          cva: lockedParamsQuery.data.cva ?? \"0\",\n          lf: lockedParamsQuery.data.lf ?? \"0\",\n          partyAmm: lockedParamsQuery.data.partyAmm ?? \"0\",\n          partyBmm: lockedParamsQuery.data.partyBmm ?? \"0\",\n        }\n      : undefined;\n  const lockedParamsReady = !needsLockedParams || lockedParamPercent !== undefined;\n\n  // Static solver fees follow the same cached input path as the other prefills.\n  // A failed optional /info read keeps core's existing zero-static-fee fallback.\n  const solverInfoQuery = useSolverInfo({\n    config: parameters.config,\n    chainId,\n    solverId,\n    query: { enabled: enabled && isLowcap && parameters.solverInfo === undefined, staleTime: 300_000, retry: false },\n  });\n  const solverInfo = parameters.solverInfo ?? solverInfoQuery.data ?? (solverInfoQuery.isError ? {} : undefined);\n  const solverInfoReady = !isLowcap || solverInfo !== undefined;\n\n  // On-chain platform fee rates — contract state, changes rarely; cached hard.\n  const feeQuery = useFeeForUser({\n    config: parameters.config,\n    chainId,\n    user: subAccountAddress,\n    symbolId: BigInt(market.id),\n    query: { enabled: enabled && parameters.feeRates === undefined, staleTime: 300_000 },\n  });\n  const feeRates = parameters.feeRates ?? feeQuery.data;\n\n  // Mark price — caller's cache-hot value wins; otherwise the shared stream.\n  const priceQuery = usePriceByName({\n    name: marketName,\n    solverId,\n    enabled: enabled && parameters.markPrice === undefined,\n  });\n  const markPrice = parameters.markPrice ?? priceQuery.markPrice ?? undefined;\n\n  // Lowcap dry-run estimate: mark-sized quantity, wide fixed request bound so the\n  // solver's price gate never rejects the question. Debounced internally.\n  const estimateQuantity = useMemo(() => {\n    if (!enabled || !isLowcap || markPrice === undefined) return \"\";\n    if (pricePrecision === undefined || quantityPrecision === undefined) return \"\";\n    const sized = calculateTradeParams({\n      markPrice,\n      slippage: 0,\n      positionType,\n      userInput: sizingInput,\n      inputField: \"PRICE\",\n      leverage,\n      pricePrecision,\n      quantityPrecision,\n    });\n    return sized?.quantity ?? \"\";\n  }, [enabled, isLowcap, markPrice, pricePrecision, quantityPrecision, positionType, sizingInput, leverage]);\n  const estimateRequestPrice =\n    markPrice !== undefined ? String(Number(markPrice) * (positionType === PositionType.SHORT ? 0.5 : 1.5)) : \"\";\n  const estimateQuery = useEstimatedPrice({\n    config: parameters.config,\n    chainId,\n    solverId,\n    symbolId: market.id,\n    quantity: estimateQuantity,\n    positionType,\n    entry: \"open\",\n    price: estimateRequestPrice,\n    query: {\n      enabled: enabled && isLowcap && parameters.estimatedOpenPrice === undefined && estimateQuantity.length > 0,\n      staleTime: 30_000,\n    },\n  });\n  // undefined = pending, string = available, null = settled but unavailable.\n  // Pass null through to core so a failed cached request is not fetched again.\n  const estimateUpdating =\n    isLowcap && parameters.estimatedOpenPrice === undefined && (estimateQuery.isDebouncing || estimateQuery.isFetching);\n  const estimateSettled =\n    !isLowcap ||\n    parameters.estimatedOpenPrice !== undefined ||\n    (!estimateUpdating && (estimateQuery.isFetched || estimateQuery.isError));\n  const resolvedEstimate =\n    parameters.estimatedOpenPrice !== undefined ? parameters.estimatedOpenPrice : estimateQuery.data?.estimatedPrice;\n  const estimatedOpenPrice =\n    !isLowcap || !estimateSettled ? undefined : resolvedEstimate && resolvedEstimate !== \"0\" ? resolvedEstimate : null;\n\n  // Every prefill present → the query function is pure, zero fetches.\n  const ready =\n    enabled &&\n    marketName !== undefined &&\n    pricePrecision !== undefined &&\n    quantityPrecision !== undefined &&\n    feeRates !== undefined &&\n    markPrice !== undefined &&\n    lockedParamsReady &&\n    (!isLowcap || (hedgerFeeOpen !== undefined && hedgerFeeClose !== undefined)) &&\n    constraintsReady &&\n    capsReady &&\n    solverInfoReady &&\n    estimateSettled;\n\n  return {\n    config,\n    validationError,\n    ready,\n    prefills: {\n      chainId,\n      market: {\n        id: market.id,\n        name: marketName,\n        pricePrecision,\n        quantityPrecision,\n        minOpenSolverFeeCap,\n        minCloseSolverFeeCap,\n        hedgerFeeOpen,\n        hedgerFeeClose,\n        hedgerFeeCloseEarlyRate,\n        hedgerFeeCloseEarlyThreshold,\n        hedgerFeeCloseStandardThreshold,\n        minAcceptablePortionLf,\n        minAcceptableQuoteValue,\n        maxNotionalValue,\n        minNotionalValue,\n        maxQuantity,\n        lotSize,\n      },\n      markPrice,\n      feeRates,\n      lockedParamPercent,\n      solverInfo,\n      estimatedOpenPrice,\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/instant-layer/use-instant-open-with-tpsl.d.ts

@@ -39,6 +39,12 @@ export type UseInstantOpenWithTpSlReturnType = UseMutationResult<UseInstantOpenW
  * `tempQuoteId`. Web layer just wires inputs; all mutation logic (both legs +
  * cache invalidation + confirming-slot write) lives in the SDK.
  *
+ * Funding follows the `PrepareInstantOpenParameters` one-of: a typed
+ * `initialMargin`, or `fund: { mode: "full-balance", balance }` (lowcap only)
+ * to deploy the whole balance. In full-balance mode the submitted quantity is
+ * the SDK-rescaled one — take the TP/SL `quantity` from `useInstantOpenFees`
+ * (its `quantity` field) rather than re-deriving it from the typed margin.
+ *
  * @example
  * ```tsx
  * const open = useInstantOpenWithTpSl();

package/dist/instant-layer/use-instant-open-with-tpsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-instant-open-with-tpsl.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-instant-open-with-tpsl.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAMzE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,+BAAgC,SAAQ,4BAA4B;IACnF,IAAI,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;CAC5D;AAED,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,qBAAqB,CAAC;IACnC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,mFAAmF;IACnF,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,kDAAkD;AAClD,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtG,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,eAAe,CAAC;AAE/D,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,iBAAiB,CAC9D,0BAA0B,EAC1B,kBAAkB,EAClB,+BAA+B,CAChC,GAAG;IACF,+DAA+D;IAC/D,KAAK,EAAE,2BAA2B,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,GAAE,gCAAqC,GAChD,gCAAgC,CAqFlC"}
+{"version":3,"file":"use-instant-open-with-tpsl.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-instant-open-with-tpsl.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAMzE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,+BAAgC,SAAQ,4BAA4B;IACnF,IAAI,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;CAC5D;AAED,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,qBAAqB,CAAC;IACnC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,mFAAmF;IACnF,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,kDAAkD;AAClD,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtG,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,eAAe,CAAC;AAE/D,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,iBAAiB,CAC9D,0BAA0B,EAC1B,kBAAkB,EAClB,+BAA+B,CAChC,GAAG;IACF,+DAA+D;IAC/D,KAAK,EAAE,2BAA2B,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,GAAE,gCAAqC,GAChD,gCAAgC,CAqFlC"}