@symmio/trading-core 3.1.0 → 3.3.0

package/dist/quotes/get-quote-history/solver-fees.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The solver fees a single `QuoteEvent` charged, decoded from its `metadata`
+ * `solverFees` list. All amounts are 18-decimal wei of collateral.
+ */
+export interface QuoteSolverFees {
+    /** The `SOLVER_FEE` entry, or `null` when the event carried none. */
+    solverFee: bigint | null;
+    /** The `STATIC_SOLVER_FEE` entry, or `null` when the event carried none. */
+    staticSolverFee: bigint | null;
+    /**
+     * Sum of every entry in the list — including tags this version does not name
+     * individually — or `null` when the event recorded no `solverFees` at all.
+     */
+    totalSolverFee: bigint | null;
+}
+/**
+ * Decode the `solverFees` value of a `QuoteEvent`'s `metadata` snapshot.
+ *
+ * The subgraph records the contract's `SolverFeeEntry[]` as a list of
+ * `[tag, amount]` tuples, e.g.
+ * `[["SOLVER_FEE", "659102399999999"], ["STATIC_SOLVER_FEE", "100000000000000000"]]`.
+ * Only the fill-close and open-position events carry it; liquidation and ADL
+ * events, and deployments indexed before the fee was recorded, omit it entirely.
+ *
+ * `totalSolverFee` sums **every** well-formed entry, so a tag added by a future
+ * contract release still lands in the total even though it has no named field
+ * here. Entries whose amount is missing, unparsable, or negative are skipped.
+ *
+ * @param solverFees - The `solverFees` value off the already-parsed metadata object.
+ * @returns The named fees plus their total, each `null` when the list is absent or not a list.
+ *
+ * @example
+ * ```ts
+ * const metadata = JSON.parse(event.metadata);
+ * const { solverFee, staticSolverFee, totalSolverFee } = parseSolverFees(metadata.solverFees);
+ * ```
+ */
+export declare function parseSolverFees(solverFees: unknown): QuoteSolverFees;
+//# sourceMappingURL=solver-fees.d.ts.map

package/dist/quotes/get-quote-history/solver-fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver-fees.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-quote-history/solver-fees.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAyBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,OAAO,GAAG,eAAe,CAmBpE"}

package/dist/quotes/get-quote-history/solver-fees.js

@@ -0,0 +1,36 @@
+//#region src/quotes/get-quote-history/solver-fees.ts
+var e = "SOLVER_FEE", t = "STATIC_SOLVER_FEE", n = {
+	solverFee: null,
+	staticSolverFee: null,
+	totalSolverFee: null
+};
+function r(e) {
+	if (e == null) return null;
+	let t = String(e).trim();
+	if (t === "") return null;
+	let n;
+	try {
+		n = BigInt(t);
+	} catch {
+		return null;
+	}
+	return n >= 0n ? n : null;
+}
+function i(i) {
+	if (!Array.isArray(i)) return n;
+	let a = null, o = null, s = 0n;
+	for (let n of i) {
+		if (!Array.isArray(n)) continue;
+		let i = r(n[1]);
+		i !== null && (s += i, n[0] === e ? a = i : n[0] === t && (o = i));
+	}
+	return {
+		solverFee: a,
+		staticSolverFee: o,
+		totalSolverFee: s
+	};
+}
+//#endregion
+export { i as parseSolverFees };
+
+//# sourceMappingURL=solver-fees.js.map

package/dist/quotes/get-quote-history/solver-fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver-fees.js","names":[],"sources":["../../../src/quotes/get-quote-history/solver-fees.ts"],"sourcesContent":["/**\n * Metadata tag of the rate-based solver fee — `notional × rate`, so it scales\n * with the size the event settled.\n */\nconst SOLVER_FEE_TAG = \"SOLVER_FEE\";\n\n/**\n * Metadata tag of the flat solver fee — a fixed per-event charge, independent of\n * the settled size.\n */\nconst STATIC_SOLVER_FEE_TAG = \"STATIC_SOLVER_FEE\";\n\n/**\n * The solver fees a single `QuoteEvent` charged, decoded from its `metadata`\n * `solverFees` list. All amounts are 18-decimal wei of collateral.\n */\nexport interface QuoteSolverFees {\n  /** The `SOLVER_FEE` entry, or `null` when the event carried none. */\n  solverFee: bigint | null;\n  /** The `STATIC_SOLVER_FEE` entry, or `null` when the event carried none. */\n  staticSolverFee: bigint | null;\n  /**\n   * Sum of every entry in the list — including tags this version does not name\n   * individually — or `null` when the event recorded no `solverFees` at all.\n   */\n  totalSolverFee: bigint | null;\n}\n\n/** The decoded shape for an event that recorded no `solverFees` list. */\nconst NO_SOLVER_FEES: QuoteSolverFees = { solverFee: null, staticSolverFee: null, totalSolverFee: null };\n\n/**\n * Read one entry's amount as a non-negative `bigint`, or `null` when it is\n * absent, unparsable, or negative (a fee is never negative, so a negative value\n * is malformed and must not skew the total).\n */\nfunction toFeeAmount(value: unknown): bigint | null {\n  if (value === undefined || value === null) return null;\n\n  const text = String(value).trim();\n  if (text === \"\") return null;\n\n  let parsed: bigint;\n  try {\n    parsed = BigInt(text);\n  } catch {\n    return null;\n  }\n  return parsed >= 0n ? parsed : null;\n}\n\n/**\n * Decode the `solverFees` value of a `QuoteEvent`'s `metadata` snapshot.\n *\n * The subgraph records the contract's `SolverFeeEntry[]` as a list of\n * `[tag, amount]` tuples, e.g.\n * `[[\"SOLVER_FEE\", \"659102399999999\"], [\"STATIC_SOLVER_FEE\", \"100000000000000000\"]]`.\n * Only the fill-close and open-position events carry it; liquidation and ADL\n * events, and deployments indexed before the fee was recorded, omit it entirely.\n *\n * `totalSolverFee` sums **every** well-formed entry, so a tag added by a future\n * contract release still lands in the total even though it has no named field\n * here. Entries whose amount is missing, unparsable, or negative are skipped.\n *\n * @param solverFees - The `solverFees` value off the already-parsed metadata object.\n * @returns The named fees plus their total, each `null` when the list is absent or not a list.\n *\n * @example\n * ```ts\n * const metadata = JSON.parse(event.metadata);\n * const { solverFee, staticSolverFee, totalSolverFee } = parseSolverFees(metadata.solverFees);\n * ```\n */\nexport function parseSolverFees(solverFees: unknown): QuoteSolverFees {\n  if (!Array.isArray(solverFees)) return NO_SOLVER_FEES;\n\n  let solverFee: bigint | null = null;\n  let staticSolverFee: bigint | null = null;\n  let totalSolverFee = 0n;\n\n  for (const entry of solverFees) {\n    if (!Array.isArray(entry)) continue;\n\n    const amount = toFeeAmount(entry[1]);\n    if (amount === null) continue;\n\n    totalSolverFee += amount;\n    if (entry[0] === SOLVER_FEE_TAG) solverFee = amount;\n    else if (entry[0] === STATIC_SOLVER_FEE_TAG) staticSolverFee = amount;\n  }\n\n  return { solverFee, staticSolverFee, totalSolverFee };\n}\n"],"mappings":";AAIA,IAAM,IAAiB,cAMjB,IAAwB,qBAmBxB,IAAkC;CAAE,WAAW;CAAM,iBAAiB;CAAM,gBAAgB;AAAK;AAOvG,SAAS,EAAY,GAA+B;CAClD,IAAI,KAAiC,MAAM,OAAO;CAElD,IAAM,IAAO,OAAO,CAAK,EAAE,KAAK;CAChC,IAAI,MAAS,IAAI,OAAO;CAExB,IAAI;CACJ,IAAI;EACF,IAAS,OAAO,CAAI;CACtB,QAAQ;EACN,OAAO;CACT;CACA,OAAO,KAAU,KAAK,IAAS;AACjC;AAwBA,SAAgB,EAAgB,GAAsC;CACpE,IAAI,CAAC,MAAM,QAAQ,CAAU,GAAG,OAAO;CAEvC,IAAI,IAA2B,MAC3B,IAAiC,MACjC,IAAiB;CAErB,KAAK,IAAM,KAAS,GAAY;EAC9B,IAAI,CAAC,MAAM,QAAQ,CAAK,GAAG;EAE3B,IAAM,IAAS,EAAY,EAAM,EAAE;EAC/B,MAAW,SAEf,KAAkB,GACd,EAAM,OAAO,IAAgB,IAAY,IACpC,EAAM,OAAO,MAAuB,IAAkB;CACjE;CAEA,OAAO;EAAE;EAAW;EAAiB;CAAe;AACtD"}

package/dist/quotes/get-quote-history/to-history-row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-history-row.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-quote-history/to-history-row.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AAE1G,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpE,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAqCjF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAiDxE"}
+{"version":3,"file":"to-history-row.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-quote-history/to-history-row.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AAG1G,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpE,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAqCjF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAqDxE"}

package/dist/quotes/get-quote-history/to-history-row.js

@@ -1,10 +1,11 @@
 import { LIQUIDATION_EVENT_TYPES as e, eventTypeToQuoteStatus as t } from "./close-type.js";
-import { getAddress as n } from "viem";
+import { parseSolverFees as n } from "./solver-fees.js";
+import { getAddress as r } from "viem";
 //#region src/quotes/get-quote-history/to-history-row.ts
-function r(e) {
+function i(e) {
 	return e ? BigInt(e) : 0n;
 }
-function i(e) {
+function a(e) {
 	if (!e) return null;
 	try {
 		return JSON.parse(e);
@@ -12,7 +13,7 @@ function i(e) {
 		return null;
 	}
 }
-function a(e) {
+function o(e) {
 	if (e == null) return null;
 	let t = String(e).trim();
 	if (t === "") return null;
@@ -24,35 +25,38 @@ function a(e) {
 	}
 	return n > 0n ? n : null;
 }
-function o(o) {
-	let s = o.type, c = o.quote, l = e.has(s), u = i(o.metadata), d = u ? a(u.amount) : null, f = u ? a(u.closePrice) : null, p = u ? a(u.openedPrice) : null, m = d ?? r(c.closedAmount), h = d ?? r(c.quantityToClose), g = f ?? r(c.averageClosedPrice), _ = p ?? r(c.openedPrice), v = l ? d ?? r(c.liquidateAmount) : r(c.liquidateAmount), y = l ? f ?? r(c.liquidatePrice) : r(c.liquidatePrice);
+function s(s) {
+	let c = s.type, l = s.quote, u = e.has(c), d = a(s.metadata), f = d ? o(d.amount) : null, p = d ? o(d.closePrice) : null, m = d ? o(d.openedPrice) : null, h = n(d?.solverFees), g = f ?? i(l.closedAmount), _ = f ?? i(l.quantityToClose), v = p ?? i(l.averageClosedPrice), y = m ?? i(l.openedPrice), b = u ? f ?? i(l.liquidateAmount) : i(l.liquidateAmount), x = u ? p ?? i(l.liquidatePrice) : i(l.liquidatePrice);
 	return {
-		eventId: o.id,
-		closeEventType: s,
-		closedAt: Number(o.timestamp),
-		quoteId: r(o.quoteId),
-		marketId: c.symbolId ? Number(c.symbolId) : 0,
-		symbol: c.symbol ?? null,
-		positionType: c.positionType ?? 0,
-		orderType: c.orderTypeOpen ?? 0,
-		quoteStatus: t[s] ?? c.quoteStatus ?? 0,
-		quantity: r(c.quantity),
-		openedPrice: _,
-		requestedOpenPrice: r(c.requestedOpenPrice),
-		avgClosedPrice: g,
-		closedAmount: m,
-		quantityToClose: h,
-		liquidateAmount: v,
-		liquidatePrice: y,
-		partyA: n(c.partyA),
-		partyB: c.partyB ? n(c.partyB) : null,
-		subAccount: c.subAccount ? n(c.subAccount.id) : null,
-		blockNumber: o.blockNumber ? BigInt(o.blockNumber) : void 0,
-		transaction: o.transaction ? o.transaction : void 0,
-		rawMetadata: o.metadata
+		eventId: s.id,
+		closeEventType: c,
+		closedAt: Number(s.timestamp),
+		quoteId: i(s.quoteId),
+		marketId: l.symbolId ? Number(l.symbolId) : 0,
+		symbol: l.symbol ?? null,
+		positionType: l.positionType ?? 0,
+		orderType: l.orderTypeOpen ?? 0,
+		quoteStatus: t[c] ?? l.quoteStatus ?? 0,
+		quantity: i(l.quantity),
+		openedPrice: y,
+		requestedOpenPrice: i(l.requestedOpenPrice),
+		avgClosedPrice: v,
+		closedAmount: g,
+		quantityToClose: _,
+		liquidateAmount: b,
+		liquidatePrice: x,
+		solverFee: h.solverFee,
+		staticSolverFee: h.staticSolverFee,
+		totalSolverFee: h.totalSolverFee,
+		partyA: r(l.partyA),
+		partyB: l.partyB ? r(l.partyB) : null,
+		subAccount: l.subAccount ? r(l.subAccount.id) : null,
+		blockNumber: s.blockNumber ? BigInt(s.blockNumber) : void 0,
+		transaction: s.transaction ? s.transaction : void 0,
+		rawMetadata: s.metadata
 	};
 }
 //#endregion
-export { o as toQuoteHistoryRow };
+export { s as toQuoteHistoryRow };
 
 //# sourceMappingURL=to-history-row.js.map

package/dist/quotes/get-quote-history/to-history-row.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-history-row.js","names":[],"sources":["../../../src/quotes/get-quote-history/to-history-row.ts"],"sourcesContent":["import { getAddress, type Hex } from \"viem\";\nimport type { OrderType, PositionType, QuoteStatus } from \"../../symmio-contracts/symmio/types\";\nimport type { QuoteEventsForHistoryQuery } from \"../../symmio-subgraph/types/generated/analytics/graphql\";\nimport { eventTypeToQuoteStatus, LIQUIDATION_EVENT_TYPES } from \"./close-type\";\nimport { QuoteCloseEventType, type QuoteHistoryRow } from \"./types\";\n\n/** A single `quoteEvents` row as returned by the history query. */\nexport type RawQuoteEventRow = QuoteEventsForHistoryQuery[\"quoteEvents\"][number];\n\n/** Parse a wei string to `bigint`, defaulting null/undefined to `0n`. */\nfunction toBigInt(value: string | null | undefined): bigint {\n  return value ? BigInt(value) : 0n;\n}\n\n/** Parse the event `metadata` JSON, returning `null` on absence or malformed input. */\nfunction parseMetadata(raw: string | null): Record<string, unknown> | null {\n  if (!raw) return null;\n  try {\n    return JSON.parse(raw) as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read a wei field from the metadata snapshot as a positive `bigint`, or `null`\n * when it is absent, malformed, or non-positive (so a missing snapshot field\n * falls back to the quote's mutable value rather than overwriting it with zero).\n */\nfunction positiveWei(value: unknown): bigint | null {\n  if (value === undefined || value === null) return null;\n\n  const text = String(value).trim();\n  if (text === \"\") return null;\n\n  let parsed: bigint;\n  try {\n    parsed = BigInt(text);\n  } catch {\n    return null;\n  }\n  return parsed > 0n ? parsed : null;\n}\n\n/**\n * Build a {@link QuoteHistoryRow} from one immutable `quoteEvents` row, overlaying\n * the event's frozen `metadata` snapshot (amount, close price, open price) onto\n * the otherwise-mutable quote. Without this overlay, every partial-close row of a\n * quote would show its final mutable state instead of the amount/price of that\n * individual close.\n *\n * @param row - One `quoteEvents` row from {@link \"QuoteEventsForHistoryDocument\"}.\n * @returns The decoded, snapshot-applied history row.\n */\nexport function toQuoteHistoryRow(row: RawQuoteEventRow): QuoteHistoryRow {\n  const eventType = row.type as QuoteCloseEventType;\n  const quote = row.quote;\n  const isLiquidation = LIQUIDATION_EVENT_TYPES.has(eventType);\n\n  const metadata = parseMetadata(row.metadata);\n  const snapshotAmount = metadata ? positiveWei(metadata.amount) : null;\n  const snapshotClosePrice = metadata ? positiveWei(metadata.closePrice) : null;\n  const snapshotOpenedPrice = metadata ? positiveWei(metadata.openedPrice) : null;\n\n  // Overlay the immutable per-event snapshot over the mutable quote values. The\n  // snapshot `amount` is this event's settled size — it drives both the closed\n  // amount and the close-request quantity (mirrors the reference frontend's applyHistoryCloseEventMetadata).\n  const closedAmount = snapshotAmount ?? toBigInt(quote.closedAmount);\n  const quantityToClose = snapshotAmount ?? toBigInt(quote.quantityToClose);\n  const avgClosedPrice = snapshotClosePrice ?? toBigInt(quote.averageClosedPrice);\n  const openedPrice = snapshotOpenedPrice ?? toBigInt(quote.openedPrice);\n  const liquidateAmount = isLiquidation\n    ? (snapshotAmount ?? toBigInt(quote.liquidateAmount))\n    : toBigInt(quote.liquidateAmount);\n  const liquidatePrice = isLiquidation\n    ? (snapshotClosePrice ?? toBigInt(quote.liquidatePrice))\n    : toBigInt(quote.liquidatePrice);\n\n  return {\n    eventId: row.id,\n    closeEventType: eventType,\n    closedAt: Number(row.timestamp),\n    quoteId: toBigInt(row.quoteId),\n    marketId: quote.symbolId ? Number(quote.symbolId) : 0,\n    symbol: quote.symbol ?? null,\n    positionType: (quote.positionType ?? 0) as PositionType,\n    orderType: (quote.orderTypeOpen ?? 0) as OrderType,\n    quoteStatus: eventTypeToQuoteStatus[eventType] ?? ((quote.quoteStatus ?? 0) as QuoteStatus),\n    quantity: toBigInt(quote.quantity),\n    openedPrice,\n    requestedOpenPrice: toBigInt(quote.requestedOpenPrice),\n    avgClosedPrice,\n    closedAmount,\n    quantityToClose,\n    liquidateAmount,\n    liquidatePrice,\n    partyA: getAddress(quote.partyA),\n    partyB: quote.partyB ? getAddress(quote.partyB) : null,\n    subAccount: quote.subAccount ? getAddress(quote.subAccount.id) : null,\n    blockNumber: row.blockNumber ? BigInt(row.blockNumber) : undefined,\n    transaction: row.transaction ? (row.transaction as Hex) : undefined,\n    rawMetadata: row.metadata,\n  };\n}\n"],"mappings":";;;AAUA,SAAS,EAAS,GAA0C;CAC1D,OAAO,IAAQ,OAAO,CAAK,IAAI;AACjC;AAGA,SAAS,EAAc,GAAoD;CACzE,IAAI,CAAC,GAAK,OAAO;CACjB,IAAI;EACF,OAAO,KAAK,MAAM,CAAG;CACvB,QAAQ;EACN,OAAO;CACT;AACF;AAOA,SAAS,EAAY,GAA+B;CAClD,IAAI,KAAiC,MAAM,OAAO;CAElD,IAAM,IAAO,OAAO,CAAK,EAAE,KAAK;CAChC,IAAI,MAAS,IAAI,OAAO;CAExB,IAAI;CACJ,IAAI;EACF,IAAS,OAAO,CAAI;CACtB,QAAQ;EACN,OAAO;CACT;CACA,OAAO,IAAS,KAAK,IAAS;AAChC;AAYA,SAAgB,EAAkB,GAAwC;CACxE,IAAM,IAAY,EAAI,MAChB,IAAQ,EAAI,OACZ,IAAgB,EAAwB,IAAI,CAAS,GAErD,IAAW,EAAc,EAAI,QAAQ,GACrC,IAAiB,IAAW,EAAY,EAAS,MAAM,IAAI,MAC3D,IAAqB,IAAW,EAAY,EAAS,UAAU,IAAI,MACnE,IAAsB,IAAW,EAAY,EAAS,WAAW,IAAI,MAKrE,IAAe,KAAkB,EAAS,EAAM,YAAY,GAC5D,IAAkB,KAAkB,EAAS,EAAM,eAAe,GAClE,IAAiB,KAAsB,EAAS,EAAM,kBAAkB,GACxE,IAAc,KAAuB,EAAS,EAAM,WAAW,GAC/D,IAAkB,IACnB,KAAkB,EAAS,EAAM,eAAe,IACjD,EAAS,EAAM,eAAe,GAC5B,IAAiB,IAClB,KAAsB,EAAS,EAAM,cAAc,IACpD,EAAS,EAAM,cAAc;CAEjC,OAAO;EACL,SAAS,EAAI;EACb,gBAAgB;EAChB,UAAU,OAAO,EAAI,SAAS;EAC9B,SAAS,EAAS,EAAI,OAAO;EAC7B,UAAU,EAAM,WAAW,OAAO,EAAM,QAAQ,IAAI;EACpD,QAAQ,EAAM,UAAU;EACxB,cAAe,EAAM,gBAAgB;EACrC,WAAY,EAAM,iBAAiB;EACnC,aAAa,EAAuB,MAAgB,EAAM,eAAe;EACzE,UAAU,EAAS,EAAM,QAAQ;EACjC;EACA,oBAAoB,EAAS,EAAM,kBAAkB;EACrD;EACA;EACA;EACA;EACA;EACA,QAAQ,EAAW,EAAM,MAAM;EAC/B,QAAQ,EAAM,SAAS,EAAW,EAAM,MAAM,IAAI;EAClD,YAAY,EAAM,aAAa,EAAW,EAAM,WAAW,EAAE,IAAI;EACjE,aAAa,EAAI,cAAc,OAAO,EAAI,WAAW,IAAI,KAAA;EACzD,aAAa,EAAI,cAAe,EAAI,cAAsB,KAAA;EAC1D,aAAa,EAAI;CACnB;AACF"}
+{"version":3,"file":"to-history-row.js","names":[],"sources":["../../../src/quotes/get-quote-history/to-history-row.ts"],"sourcesContent":["import { getAddress, type Hex } from \"viem\";\nimport type { OrderType, PositionType, QuoteStatus } from \"../../symmio-contracts/symmio/types\";\nimport type { QuoteEventsForHistoryQuery } from \"../../symmio-subgraph/types/generated/analytics/graphql\";\nimport { eventTypeToQuoteStatus, LIQUIDATION_EVENT_TYPES } from \"./close-type\";\nimport { parseSolverFees } from \"./solver-fees\";\nimport { QuoteCloseEventType, type QuoteHistoryRow } from \"./types\";\n\n/** A single `quoteEvents` row as returned by the history query. */\nexport type RawQuoteEventRow = QuoteEventsForHistoryQuery[\"quoteEvents\"][number];\n\n/** Parse a wei string to `bigint`, defaulting null/undefined to `0n`. */\nfunction toBigInt(value: string | null | undefined): bigint {\n  return value ? BigInt(value) : 0n;\n}\n\n/** Parse the event `metadata` JSON, returning `null` on absence or malformed input. */\nfunction parseMetadata(raw: string | null): Record<string, unknown> | null {\n  if (!raw) return null;\n  try {\n    return JSON.parse(raw) as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read a wei field from the metadata snapshot as a positive `bigint`, or `null`\n * when it is absent, malformed, or non-positive (so a missing snapshot field\n * falls back to the quote's mutable value rather than overwriting it with zero).\n */\nfunction positiveWei(value: unknown): bigint | null {\n  if (value === undefined || value === null) return null;\n\n  const text = String(value).trim();\n  if (text === \"\") return null;\n\n  let parsed: bigint;\n  try {\n    parsed = BigInt(text);\n  } catch {\n    return null;\n  }\n  return parsed > 0n ? parsed : null;\n}\n\n/**\n * Build a {@link QuoteHistoryRow} from one immutable `quoteEvents` row, overlaying\n * the event's frozen `metadata` snapshot (amount, close price, open price) onto\n * the otherwise-mutable quote. Without this overlay, every partial-close row of a\n * quote would show its final mutable state instead of the amount/price of that\n * individual close.\n *\n * @param row - One `quoteEvents` row from {@link \"QuoteEventsForHistoryDocument\"}.\n * @returns The decoded, snapshot-applied history row.\n */\nexport function toQuoteHistoryRow(row: RawQuoteEventRow): QuoteHistoryRow {\n  const eventType = row.type as QuoteCloseEventType;\n  const quote = row.quote;\n  const isLiquidation = LIQUIDATION_EVENT_TYPES.has(eventType);\n\n  const metadata = parseMetadata(row.metadata);\n  const snapshotAmount = metadata ? positiveWei(metadata.amount) : null;\n  const snapshotClosePrice = metadata ? positiveWei(metadata.closePrice) : null;\n  const snapshotOpenedPrice = metadata ? positiveWei(metadata.openedPrice) : null;\n  const solverFees = parseSolverFees(metadata?.solverFees);\n\n  // Overlay the immutable per-event snapshot over the mutable quote values. The\n  // snapshot `amount` is this event's settled size — it drives both the closed\n  // amount and the close-request quantity (mirrors the reference frontend's applyHistoryCloseEventMetadata).\n  const closedAmount = snapshotAmount ?? toBigInt(quote.closedAmount);\n  const quantityToClose = snapshotAmount ?? toBigInt(quote.quantityToClose);\n  const avgClosedPrice = snapshotClosePrice ?? toBigInt(quote.averageClosedPrice);\n  const openedPrice = snapshotOpenedPrice ?? toBigInt(quote.openedPrice);\n  const liquidateAmount = isLiquidation\n    ? (snapshotAmount ?? toBigInt(quote.liquidateAmount))\n    : toBigInt(quote.liquidateAmount);\n  const liquidatePrice = isLiquidation\n    ? (snapshotClosePrice ?? toBigInt(quote.liquidatePrice))\n    : toBigInt(quote.liquidatePrice);\n\n  return {\n    eventId: row.id,\n    closeEventType: eventType,\n    closedAt: Number(row.timestamp),\n    quoteId: toBigInt(row.quoteId),\n    marketId: quote.symbolId ? Number(quote.symbolId) : 0,\n    symbol: quote.symbol ?? null,\n    positionType: (quote.positionType ?? 0) as PositionType,\n    orderType: (quote.orderTypeOpen ?? 0) as OrderType,\n    quoteStatus: eventTypeToQuoteStatus[eventType] ?? ((quote.quoteStatus ?? 0) as QuoteStatus),\n    quantity: toBigInt(quote.quantity),\n    openedPrice,\n    requestedOpenPrice: toBigInt(quote.requestedOpenPrice),\n    avgClosedPrice,\n    closedAmount,\n    quantityToClose,\n    liquidateAmount,\n    liquidatePrice,\n    solverFee: solverFees.solverFee,\n    staticSolverFee: solverFees.staticSolverFee,\n    totalSolverFee: solverFees.totalSolverFee,\n    partyA: getAddress(quote.partyA),\n    partyB: quote.partyB ? getAddress(quote.partyB) : null,\n    subAccount: quote.subAccount ? getAddress(quote.subAccount.id) : null,\n    blockNumber: row.blockNumber ? BigInt(row.blockNumber) : undefined,\n    transaction: row.transaction ? (row.transaction as Hex) : undefined,\n    rawMetadata: row.metadata,\n  };\n}\n"],"mappings":";;;;AAWA,SAAS,EAAS,GAA0C;CAC1D,OAAO,IAAQ,OAAO,CAAK,IAAI;AACjC;AAGA,SAAS,EAAc,GAAoD;CACzE,IAAI,CAAC,GAAK,OAAO;CACjB,IAAI;EACF,OAAO,KAAK,MAAM,CAAG;CACvB,QAAQ;EACN,OAAO;CACT;AACF;AAOA,SAAS,EAAY,GAA+B;CAClD,IAAI,KAAiC,MAAM,OAAO;CAElD,IAAM,IAAO,OAAO,CAAK,EAAE,KAAK;CAChC,IAAI,MAAS,IAAI,OAAO;CAExB,IAAI;CACJ,IAAI;EACF,IAAS,OAAO,CAAI;CACtB,QAAQ;EACN,OAAO;CACT;CACA,OAAO,IAAS,KAAK,IAAS;AAChC;AAYA,SAAgB,EAAkB,GAAwC;CACxE,IAAM,IAAY,EAAI,MAChB,IAAQ,EAAI,OACZ,IAAgB,EAAwB,IAAI,CAAS,GAErD,IAAW,EAAc,EAAI,QAAQ,GACrC,IAAiB,IAAW,EAAY,EAAS,MAAM,IAAI,MAC3D,IAAqB,IAAW,EAAY,EAAS,UAAU,IAAI,MACnE,IAAsB,IAAW,EAAY,EAAS,WAAW,IAAI,MACrE,IAAa,EAAgB,GAAU,UAAU,GAKjD,IAAe,KAAkB,EAAS,EAAM,YAAY,GAC5D,IAAkB,KAAkB,EAAS,EAAM,eAAe,GAClE,IAAiB,KAAsB,EAAS,EAAM,kBAAkB,GACxE,IAAc,KAAuB,EAAS,EAAM,WAAW,GAC/D,IAAkB,IACnB,KAAkB,EAAS,EAAM,eAAe,IACjD,EAAS,EAAM,eAAe,GAC5B,IAAiB,IAClB,KAAsB,EAAS,EAAM,cAAc,IACpD,EAAS,EAAM,cAAc;CAEjC,OAAO;EACL,SAAS,EAAI;EACb,gBAAgB;EAChB,UAAU,OAAO,EAAI,SAAS;EAC9B,SAAS,EAAS,EAAI,OAAO;EAC7B,UAAU,EAAM,WAAW,OAAO,EAAM,QAAQ,IAAI;EACpD,QAAQ,EAAM,UAAU;EACxB,cAAe,EAAM,gBAAgB;EACrC,WAAY,EAAM,iBAAiB;EACnC,aAAa,EAAuB,MAAgB,EAAM,eAAe;EACzE,UAAU,EAAS,EAAM,QAAQ;EACjC;EACA,oBAAoB,EAAS,EAAM,kBAAkB;EACrD;EACA;EACA;EACA;EACA;EACA,WAAW,EAAW;EACtB,iBAAiB,EAAW;EAC5B,gBAAgB,EAAW;EAC3B,QAAQ,EAAW,EAAM,MAAM;EAC/B,QAAQ,EAAM,SAAS,EAAW,EAAM,MAAM,IAAI;EAClD,YAAY,EAAM,aAAa,EAAW,EAAM,WAAW,EAAE,IAAI;EACjE,aAAa,EAAI,cAAc,OAAO,EAAI,WAAW,IAAI,KAAA;EACzD,aAAa,EAAI,cAAe,EAAI,cAAsB,KAAA;EAC1D,aAAa,EAAI;CACnB;AACF"}

package/dist/quotes/get-quote-history/types.d.ts

@@ -92,6 +92,26 @@ export interface QuoteHistoryRow {
     liquidateAmount: bigint;
     /** Liquidation price (set only for liquidation rows). */
     liquidatePrice: bigint;
+    /**
+     * Rate-based solver fee charged by this event (`SOLVER_FEE`), or `null` when
+     * the event carried none.
+     */
+    solverFee: bigint | null;
+    /**
+     * Flat solver fee charged by this event (`STATIC_SOLVER_FEE`), or `null` when
+     * the event carried none.
+     */
+    staticSolverFee: bigint | null;
+    /**
+     * Sum of every solver fee on the event — including tags this version does not
+     * name individually — or `null` when the event recorded none at all.
+     *
+     * @remarks
+     * Only fill-close events carry solver fees: liquidation and ADL rows, and
+     * deployments indexed before the fee was recorded, read `null` on all three
+     * fee fields. The untruncated list stays on {@link QuoteHistoryRow.rawMetadata}.
+     */
+    totalSolverFee: bigint | null;
     /** PartyA (the SubAccount or Virtual Account that owns the quote). */
     partyA: Address;
     /** PartyB (the hedger/solver), or `null` when absent. */

package/dist/quotes/get-quote-history/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-quote-history/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEhG;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,yCAAyC;IACzC,GAAG,QAAQ;IACX,mCAAmC;IACnC,MAAM,WAAW;IACjB,mCAAmC;IACnC,WAAW,gBAAgB;IAC3B,2CAA2C;IAC3C,eAAe,oBAAoB;IACnC,6CAA6C;IAC7C,SAAS,cAAc;IACvB,0EAA0E;IAC1E,UAAU,eAAe;CAC1B;AAED;;;;;;;GAOG;AACH,oBAAY,mBAAmB;IAC7B,wCAAwC;IACxC,SAAS,eAAe;IACxB,qBAAqB;IACrB,UAAU,gBAAgB;IAC1B,0BAA0B;IAC1B,cAAc,oBAAoB;IAClC,kCAAkC;IAClC,QAAQ,cAAc;IACtB,4CAA4C;IAC5C,eAAe,sBAAsB;IACrC,4CAA4C;IAC5C,eAAe,sBAAsB;IACrC,mDAAmD;IACnD,sBAAsB,6BAA6B;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,cAAc,EAAE,mBAAmB,CAAC;IACpC,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qBAAqB;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,yCAAyC;IACzC,SAAS,EAAE,SAAS,CAAC;IACrB,+EAA+E;IAC/E,WAAW,EAAE,WAAW,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,mEAAmE;IACnE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-quote-history/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEhG;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,yCAAyC;IACzC,GAAG,QAAQ;IACX,mCAAmC;IACnC,MAAM,WAAW;IACjB,mCAAmC;IACnC,WAAW,gBAAgB;IAC3B,2CAA2C;IAC3C,eAAe,oBAAoB;IACnC,6CAA6C;IAC7C,SAAS,cAAc;IACvB,0EAA0E;IAC1E,UAAU,eAAe;CAC1B;AAED;;;;;;;GAOG;AACH,oBAAY,mBAAmB;IAC7B,wCAAwC;IACxC,SAAS,eAAe;IACxB,qBAAqB;IACrB,UAAU,gBAAgB;IAC1B,0BAA0B;IAC1B,cAAc,oBAAoB;IAClC,kCAAkC;IAClC,QAAQ,cAAc;IACtB,4CAA4C;IAC5C,eAAe,sBAAsB;IACrC,4CAA4C;IAC5C,eAAe,sBAAsB;IACrC,mDAAmD;IACnD,sBAAsB,6BAA6B;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,cAAc,EAAE,mBAAmB,CAAC;IACpC,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qBAAqB;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,yCAAyC;IACzC,SAAS,EAAE,SAAS,CAAC;IACrB,+EAA+E;IAC/E,WAAW,EAAE,WAAW,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;;;;OAQG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,mEAAmE;IACnE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}

package/dist/quotes/get-quote-history/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/quotes/get-quote-history/types.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { OrderType, PositionType, QuoteStatus } from \"../../symmio-contracts/symmio/types\";\n\n/**\n * Close-type filter for quote history.\n *\n * Selects which terminal events a history read returns. Maps to the subgraph's\n * `QuoteEvent.type` values via {@link \"closeTypeToEventTypes\"}.\n */\nexport enum QuoteCloseType {\n  /** Every close and liquidation event. */\n  All = \"All\",\n  /** Normal close (`FILL_CLOSE`). */\n  Closed = \"Closed\",\n  /** Force close (`FORCE_CLOSE`). */\n  ForceClosed = \"ForceClosed\",\n  /** Emergency close (`EMERGENCY_CLOSE`). */\n  EmergencyClosed = \"EmergencyClosed\",\n  /** Auto-deleveraging close (`ADL_CLOSE`). */\n  AdlClosed = \"AdlClosed\",\n  /** Liquidation (`LIQUIDATE_PARTY_A` / `_PARTY_B` / `_CLEARING_HOUSE`). */\n  Liquidated = \"Liquidated\",\n}\n\n/**\n * Subgraph `QuoteEvent.type` values that terminate a (partial) position and\n * therefore appear in history. Each carries an immutable `metadata` snapshot.\n *\n * @remarks\n * Mirrors the event-type strings emitted by the SYMMIO subgraphs (v0.8.6+);\n * see the subgraphs `0.8.6_migration` doc — QuoteEvent metadata.\n */\nexport enum QuoteCloseEventType {\n  /** A normal (partial or full) close. */\n  FillClose = \"FILL_CLOSE\",\n  /** A force close. */\n  ForceClose = \"FORCE_CLOSE\",\n  /** An emergency close. */\n  EmergencyClose = \"EMERGENCY_CLOSE\",\n  /** An auto-deleveraging close. */\n  AdlClose = \"ADL_CLOSE\",\n  /** Liquidation initiated against partyA. */\n  LiquidatePartyA = \"LIQUIDATE_PARTY_A\",\n  /** Liquidation initiated against partyB. */\n  LiquidatePartyB = \"LIQUIDATE_PARTY_B\",\n  /** Liquidation initiated by the clearing house. */\n  LiquidateClearingHouse = \"LIQUIDATE_CLEARING_HOUSE\",\n}\n\n/**\n * One row of quote history — a single immutable `QuoteEvent` with its per-event\n * `metadata` snapshot overlaid onto the (otherwise mutable) quote it belongs to.\n *\n * Because the underlying `Quote` entity is mutable, a quote closed across several\n * partial closes produces several history rows that would otherwise show the same\n * final state. The snapshot overlay restores each event's own amount/price, so\n * every partial-close row is distinct.\n *\n * @remarks\n * Amounts and prices are raw `bigint` (18-decimal fixed point, no scaling),\n * matching the SDK's on-chain {@link \"Quote\"} reads. Enum fields are decoded.\n */\nexport interface QuoteHistoryRow {\n  /** Stable id of the underlying immutable `QuoteEvent` (use as a row key). */\n  eventId: string;\n  /** The close / liquidation event that produced this row. */\n  closeEventType: QuoteCloseEventType;\n  /** Event block timestamp in seconds (the row's \"close time\"). */\n  closedAt: number;\n  /** Protocol quote id. */\n  quoteId: bigint;\n  /** Market identifier (`symbolId`). */\n  marketId: number;\n  /** Market ticker resolved by the subgraph, when known. */\n  symbol: string | null;\n  /** Long or short. */\n  positionType: PositionType;\n  /** Limit or market order (open side). */\n  orderType: OrderType;\n  /** Lifecycle status, forced to `CLOSED` / `LIQUIDATED` from the event type. */\n  quoteStatus: QuoteStatus;\n  /** Total quote quantity. */\n  quantity: bigint;\n  /** Open price (snapshot-overlaid when the event carried one). */\n  openedPrice: bigint;\n  /** Price partyA originally requested to open at. */\n  requestedOpenPrice: bigint;\n  /** Average close price (snapshot-overlaid with this event's close price). */\n  avgClosedPrice: bigint;\n  /** Amount closed by this event (snapshot `amount`). */\n  closedAmount: bigint;\n  /** Quantity of the close request this event settled. */\n  quantityToClose: bigint;\n  /** Liquidated amount (set only for liquidation rows). */\n  liquidateAmount: bigint;\n  /** Liquidation price (set only for liquidation rows). */\n  liquidatePrice: bigint;\n  /** PartyA (the SubAccount or Virtual Account that owns the quote). */\n  partyA: Address;\n  /** PartyB (the hedger/solver), or `null` when absent. */\n  partyB: Address | null;\n  /** The account-layer SubAccount address, or `null` when absent. */\n  subAccount: Address | null;\n  /** Block number of the event, when available. */\n  blockNumber?: bigint;\n  /** Transaction hash of the event, when available. */\n  transaction?: Hex;\n  /** Raw event `metadata` JSON string, preserved for power users. */\n  rawMetadata: string | null;\n}\n"],"mappings":";AASA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,SAAA,UAEA,EAAA,cAAA,eAEA,EAAA,kBAAA,mBAEA,EAAA,YAAA,aAEA,EAAA,aAAA;AACF,EAAA,CAAA,CAAA,GAUY,IAAL,yBAAA,GAAA;QAEL,EAAA,YAAA,cAEA,EAAA,aAAA,eAEA,EAAA,iBAAA,mBAEA,EAAA,WAAA,aAEA,EAAA,kBAAA,qBAEA,EAAA,kBAAA,qBAEA,EAAA,yBAAA;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/quotes/get-quote-history/types.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { OrderType, PositionType, QuoteStatus } from \"../../symmio-contracts/symmio/types\";\n\n/**\n * Close-type filter for quote history.\n *\n * Selects which terminal events a history read returns. Maps to the subgraph's\n * `QuoteEvent.type` values via {@link \"closeTypeToEventTypes\"}.\n */\nexport enum QuoteCloseType {\n  /** Every close and liquidation event. */\n  All = \"All\",\n  /** Normal close (`FILL_CLOSE`). */\n  Closed = \"Closed\",\n  /** Force close (`FORCE_CLOSE`). */\n  ForceClosed = \"ForceClosed\",\n  /** Emergency close (`EMERGENCY_CLOSE`). */\n  EmergencyClosed = \"EmergencyClosed\",\n  /** Auto-deleveraging close (`ADL_CLOSE`). */\n  AdlClosed = \"AdlClosed\",\n  /** Liquidation (`LIQUIDATE_PARTY_A` / `_PARTY_B` / `_CLEARING_HOUSE`). */\n  Liquidated = \"Liquidated\",\n}\n\n/**\n * Subgraph `QuoteEvent.type` values that terminate a (partial) position and\n * therefore appear in history. Each carries an immutable `metadata` snapshot.\n *\n * @remarks\n * Mirrors the event-type strings emitted by the SYMMIO subgraphs (v0.8.6+);\n * see the subgraphs `0.8.6_migration` doc — QuoteEvent metadata.\n */\nexport enum QuoteCloseEventType {\n  /** A normal (partial or full) close. */\n  FillClose = \"FILL_CLOSE\",\n  /** A force close. */\n  ForceClose = \"FORCE_CLOSE\",\n  /** An emergency close. */\n  EmergencyClose = \"EMERGENCY_CLOSE\",\n  /** An auto-deleveraging close. */\n  AdlClose = \"ADL_CLOSE\",\n  /** Liquidation initiated against partyA. */\n  LiquidatePartyA = \"LIQUIDATE_PARTY_A\",\n  /** Liquidation initiated against partyB. */\n  LiquidatePartyB = \"LIQUIDATE_PARTY_B\",\n  /** Liquidation initiated by the clearing house. */\n  LiquidateClearingHouse = \"LIQUIDATE_CLEARING_HOUSE\",\n}\n\n/**\n * One row of quote history — a single immutable `QuoteEvent` with its per-event\n * `metadata` snapshot overlaid onto the (otherwise mutable) quote it belongs to.\n *\n * Because the underlying `Quote` entity is mutable, a quote closed across several\n * partial closes produces several history rows that would otherwise show the same\n * final state. The snapshot overlay restores each event's own amount/price, so\n * every partial-close row is distinct.\n *\n * @remarks\n * Amounts and prices are raw `bigint` (18-decimal fixed point, no scaling),\n * matching the SDK's on-chain {@link \"Quote\"} reads. Enum fields are decoded.\n */\nexport interface QuoteHistoryRow {\n  /** Stable id of the underlying immutable `QuoteEvent` (use as a row key). */\n  eventId: string;\n  /** The close / liquidation event that produced this row. */\n  closeEventType: QuoteCloseEventType;\n  /** Event block timestamp in seconds (the row's \"close time\"). */\n  closedAt: number;\n  /** Protocol quote id. */\n  quoteId: bigint;\n  /** Market identifier (`symbolId`). */\n  marketId: number;\n  /** Market ticker resolved by the subgraph, when known. */\n  symbol: string | null;\n  /** Long or short. */\n  positionType: PositionType;\n  /** Limit or market order (open side). */\n  orderType: OrderType;\n  /** Lifecycle status, forced to `CLOSED` / `LIQUIDATED` from the event type. */\n  quoteStatus: QuoteStatus;\n  /** Total quote quantity. */\n  quantity: bigint;\n  /** Open price (snapshot-overlaid when the event carried one). */\n  openedPrice: bigint;\n  /** Price partyA originally requested to open at. */\n  requestedOpenPrice: bigint;\n  /** Average close price (snapshot-overlaid with this event's close price). */\n  avgClosedPrice: bigint;\n  /** Amount closed by this event (snapshot `amount`). */\n  closedAmount: bigint;\n  /** Quantity of the close request this event settled. */\n  quantityToClose: bigint;\n  /** Liquidated amount (set only for liquidation rows). */\n  liquidateAmount: bigint;\n  /** Liquidation price (set only for liquidation rows). */\n  liquidatePrice: bigint;\n  /**\n   * Rate-based solver fee charged by this event (`SOLVER_FEE`), or `null` when\n   * the event carried none.\n   */\n  solverFee: bigint | null;\n  /**\n   * Flat solver fee charged by this event (`STATIC_SOLVER_FEE`), or `null` when\n   * the event carried none.\n   */\n  staticSolverFee: bigint | null;\n  /**\n   * Sum of every solver fee on the event — including tags this version does not\n   * name individually — or `null` when the event recorded none at all.\n   *\n   * @remarks\n   * Only fill-close events carry solver fees: liquidation and ADL rows, and\n   * deployments indexed before the fee was recorded, read `null` on all three\n   * fee fields. The untruncated list stays on {@link QuoteHistoryRow.rawMetadata}.\n   */\n  totalSolverFee: bigint | null;\n  /** PartyA (the SubAccount or Virtual Account that owns the quote). */\n  partyA: Address;\n  /** PartyB (the hedger/solver), or `null` when absent. */\n  partyB: Address | null;\n  /** The account-layer SubAccount address, or `null` when absent. */\n  subAccount: Address | null;\n  /** Block number of the event, when available. */\n  blockNumber?: bigint;\n  /** Transaction hash of the event, when available. */\n  transaction?: Hex;\n  /** Raw event `metadata` JSON string, preserved for power users. */\n  rawMetadata: string | null;\n}\n"],"mappings":";AASA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,SAAA,UAEA,EAAA,cAAA,eAEA,EAAA,kBAAA,mBAEA,EAAA,YAAA,aAEA,EAAA,aAAA;AACF,EAAA,CAAA,CAAA,GAUY,IAAL,yBAAA,GAAA;QAEL,EAAA,YAAA,cAEA,EAAA,aAAA,eAEA,EAAA,iBAAA,mBAEA,EAAA,WAAA,aAEA,EAAA,kBAAA,qBAEA,EAAA,kBAAA,qBAEA,EAAA,yBAAA;AACF,EAAA,CAAA,CAAA"}

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

@@ -0,0 +1,36 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../shared/types/properties.js';
+/**
+ * Static solver-fee configuration from the Enigma-only `GET /info` endpoint.
+ *
+ * A flat camelCase mirror of the wire shape; amounts are USD decimal strings
+ * exactly as the solver reports them.
+ */
+export interface EnigmaSolverInfo {
+    /**
+     * Configured USD amount charged per instant open, before signed fee-cap
+     * adjustments. `undefined` when the solver omits it.
+     */
+    staticSolverFeeOpen?: string;
+    /**
+     * Configured USD amount charged per instant close (including each partial
+     * close), before signed fee-cap adjustments. `undefined` when the solver
+     * omits it.
+     */
+    staticSolverFeeClose?: string;
+}
+/** Parameters for {@link getSolverInfo}. */
+export type GetSolverInfoParameters = Compute<ReadSolverParameter>;
+/** Return type of {@link getSolverInfo}. */
+export type GetSolverInfoReturnType = EnigmaSolverInfo;
+/**
+ * Fetch the solver's general information via the Enigma-only `/info` endpoint.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain/solver.
+ * @returns The solver's static fee configuration ({@link EnigmaSolverInfo}).
+ * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver.
+ * @throws {SymmApiError} when the API request fails.
+ */
+export declare function getSolverInfo(config: Config, parameters?: GetSolverInfoParameters): Promise<GetSolverInfoReturnType>;
+//# sourceMappingURL=get-solver-info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-solver-info.d.ts","sourceRoot":"","sources":["../../../src/solvers/get-solver-info/get-solver-info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIlF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,4CAA4C;AAC5C,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEnE,4CAA4C;AAC5C,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,uBAA4B,GACvC,OAAO,CAAC,uBAAuB,CAAC,CAqBlC"}

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

@@ -0,0 +1,28 @@
+import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
+import { getInfo as n } from "../types/generated/enigma-solver.js";
+import { assertSolverKind as r } from "../assert-solver-kind.js";
+import { isAxiosError as i } from "axios";
+//#region src/solvers/get-solver-info/get-solver-info.ts
+async function a(a, o = {}) {
+	let s = a.getSolver({
+		chainId: o.chainId,
+		solverId: o.solverId
+	});
+	r(s, "enigma", "getSolverInfo");
+	try {
+		let e = await n({ baseURL: s.url });
+		return {
+			staticSolverFeeOpen: e.data.static_solver_fee_open,
+			staticSolverFeeClose: e.data.static_solver_fee_close
+		};
+	} catch (n) {
+		throw n instanceof t ? n : i(n) ? e.fromAxios(n, {
+			code: "FETCH_SOLVER_INFO_FAILED",
+			baseURL: s.url
+		}) : new t("api", "FETCH_SOLVER_INFO_FAILED", `Failed to fetch solver info: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { a as getSolverInfo };
+
+//# sourceMappingURL=get-solver-info.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-solver-info.js","names":[],"sources":["../../../src/solvers/get-solver-info/get-solver-info.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../core/config\";\nimport { SymmApiError, SymmError } from \"../../shared/errors/symm-error\";\nimport type { Compute, ReadSolverParameter } from \"../../shared/types/properties\";\nimport { assertSolverKind } from \"../assert-solver-kind\";\nimport { getInfo } from \"../types/generated/enigma-solver\";\n\n/**\n * Static solver-fee configuration from the Enigma-only `GET /info` endpoint.\n *\n * A flat camelCase mirror of the wire shape; amounts are USD decimal strings\n * exactly as the solver reports them.\n */\nexport interface EnigmaSolverInfo {\n  /**\n   * Configured USD amount charged per instant open, before signed fee-cap\n   * adjustments. `undefined` when the solver omits it.\n   */\n  staticSolverFeeOpen?: string;\n  /**\n   * Configured USD amount charged per instant close (including each partial\n   * close), before signed fee-cap adjustments. `undefined` when the solver\n   * omits it.\n   */\n  staticSolverFeeClose?: string;\n}\n\n/** Parameters for {@link getSolverInfo}. */\nexport type GetSolverInfoParameters = Compute<ReadSolverParameter>;\n\n/** Return type of {@link getSolverInfo}. */\nexport type GetSolverInfoReturnType = EnigmaSolverInfo;\n\n/**\n * Fetch the solver's general information via the Enigma-only `/info` endpoint.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain/solver.\n * @returns The solver's static fee configuration ({@link EnigmaSolverInfo}).\n * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver.\n * @throws {SymmApiError} when the API request fails.\n */\nexport async function getSolverInfo(\n  config: Config,\n  parameters: GetSolverInfoParameters = {},\n): Promise<GetSolverInfoReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getSolverInfo\");\n  try {\n    const response = await getInfo({ baseURL: solver.url });\n    return {\n      staticSolverFeeOpen: response.data.static_solver_fee_open,\n      staticSolverFeeClose: response.data.static_solver_fee_close,\n    };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_SOLVER_INFO_FAILED\", baseURL: solver.url });\n    }\n    throw new SymmError(\n      \"api\",\n      \"FETCH_SOLVER_INFO_FAILED\",\n      `Failed to fetch solver info: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;AA0CA,eAAsB,EACpB,GACA,IAAsC,CAAC,GACL;CAClC,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAC9F,EAAiB,GAAQ,UAAU,eAAe;CAClD,IAAI;EACF,IAAM,IAAW,MAAM,EAAQ,EAAE,SAAS,EAAO,IAAI,CAAC;EACtD,OAAO;GACL,qBAAqB,EAAS,KAAK;GACnC,sBAAsB,EAAS,KAAK;EACtC;CACF,SAAS,GAAK;EAKZ,MAJI,aAAe,IAAiB,IAChC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA4B,SAAS,EAAO;EAAI,CAAC,IAEvF,IAAI,EACR,OACA,4BACA,gCAAgC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAC/E,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/solvers/get-solver-info/index.d.ts

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

package/dist/solvers/get-solver-info/index.d.ts.map

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

package/dist/solvers/get-solver-info/query.d.ts

@@ -0,0 +1,29 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetSolverInfoParameters, GetSolverInfoReturnType } from './get-solver-info.js';
+/** Data resolved by the {@link getSolverInfoQueryOptions} query. */
+export type GetSolverInfoData = GetSolverInfoReturnType;
+/**
+ * Build the TanStack Query key for {@link getSolverInfoQueryOptions}.
+ *
+ * @param options - Partial query parameters (chain id, solver).
+ * @returns A stable, hashable query key.
+ */
+export declare function getSolverInfoQueryKey(options?: Compute<GetSolverInfoParameters & ConfigKeyParameter>): readonly ["getSolverInfo", Record<string, unknown>];
+/** Query-key type produced by {@link getSolverInfoQueryKey}. */
+export type GetSolverInfoQueryKey = ReturnType<typeof getSolverInfoQueryKey>;
+/** Options accepted by {@link getSolverInfoQueryOptions}. */
+export type GetSolverInfoOptions = Compute<GetSolverInfoParameters & QueryParameter<GetSolverInfoData, Error, GetSolverInfoData, GetSolverInfoQueryKey>>;
+/** TanStack Query options returned by {@link getSolverInfoQueryOptions}. */
+export type GetSolverInfoQueryOptions = SymmioQueryOptions<GetSolverInfoData, Error, GetSolverInfoData, GetSolverInfoQueryKey>;
+/**
+ * Build TanStack Query options for {@link getSolverInfo}. A non-enigma solver
+ * surfaces `UNSUPPORTED_BY_SOLVER` from the query function.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ */
+export declare function getSolverInfoQueryOptions(config: Config, options?: GetSolverInfoOptions): GetSolverInfoQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/solvers/get-solver-info/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/solvers/get-solver-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,EAAiB,KAAK,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE9G,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,OAAO,CAAC,uBAAuB,GAAG,kBAAkB,CAAM,uDAExG;AAED,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7E,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,uBAAuB,GAAG,cAAc,CAAC,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,CAAC,CAC7G,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CACxD,iBAAiB,EACjB,KAAK,EACL,iBAAiB,EACjB,qBAAqB,CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,yBAAyB,CAU3B"}

package/dist/solvers/get-solver-info/query.js

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

package/dist/solvers/get-solver-info/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/solvers/get-solver-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 { getSolverInfo, type GetSolverInfoParameters, type GetSolverInfoReturnType } from \"./get-solver-info\";\n\n/** Data resolved by the {@link getSolverInfoQueryOptions} query. */\nexport type GetSolverInfoData = GetSolverInfoReturnType;\n\n/**\n * Build the TanStack Query key for {@link getSolverInfoQueryOptions}.\n *\n * @param options - Partial query parameters (chain id, solver).\n * @returns A stable, hashable query key.\n */\nexport function getSolverInfoQueryKey(options: Compute<GetSolverInfoParameters & ConfigKeyParameter> = {}) {\n  return [\"getSolverInfo\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getSolverInfoQueryKey}. */\nexport type GetSolverInfoQueryKey = ReturnType<typeof getSolverInfoQueryKey>;\n\n/** Options accepted by {@link getSolverInfoQueryOptions}. */\nexport type GetSolverInfoOptions = Compute<\n  GetSolverInfoParameters & QueryParameter<GetSolverInfoData, Error, GetSolverInfoData, GetSolverInfoQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getSolverInfoQueryOptions}. */\nexport type GetSolverInfoQueryOptions = SymmioQueryOptions<\n  GetSolverInfoData,\n  Error,\n  GetSolverInfoData,\n  GetSolverInfoQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getSolverInfo}. A non-enigma solver\n * surfaces `UNSUPPORTED_BY_SOLVER` from the query function.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n */\nexport function getSolverInfoQueryOptions(\n  config: Config,\n  options: GetSolverInfoOptions = {},\n): GetSolverInfoQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getSolverInfoQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getSolverInfo(config, { chainId: options.chainId, solverId: options.solverId }),\n  };\n}\n"],"mappings":";;;AAeA,SAAgB,EAAsB,IAAiE,CAAC,GAAG;CACzG,OAAO,CAAC,iBAAiB,EAAmB,CAAO,CAAC;AACtD;AA0BA,SAAgB,EACd,GACA,IAAgC,CAAC,GACN;CAC3B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAsB;GAC9B,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAc,GAAQ;GAAE,SAAS,EAAQ;GAAS,UAAU,EAAQ;EAAS,CAAC;CAC/F;AACF"}

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

@@ -0,0 +1,152 @@
+import { Address } from 'viem';
+import { Config } from '../../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../../shared/types/properties.js';
+import { FeeForUser } from '../../../symmio-contracts/symmio/actions/get-fee-for-user.js';
+import { EnigmaSolverInfo } from '../../get-solver-info/index.js';
+/**
+ * Market identification for {@link getInstantCloseFees} — the id plus optional
+ * pre-fetched metadata; every pre-filled field skips part of the market fetch.
+ */
+export interface InstantCloseFeesMarketData {
+    /** Market / symbol id. */
+    id: number;
+    /** Pre-fetched market name. */
+    name?: string;
+    /** Pre-fetched price precision (decimals). */
+    pricePrecision?: number;
+    /** Pre-fetched quantity precision (decimals). */
+    quantityPrecision?: number;
+    /** Pre-fetched solver open-fee rate — only consulted for the resolver short-circuit. */
+    hedgerFeeOpen?: string;
+    /** Pre-fetched solver standard (floor) close-fee rate (decimal fraction string). */
+    hedgerFeeClose?: string;
+    /** Pre-fetched early (peak) close-fee rate (decimal fraction string). */
+    hedgerFeeCloseEarlyRate?: string;
+    /** Pre-fetched early-window length in seconds. */
+    hedgerFeeCloseEarlyThreshold?: number;
+    /** Pre-fetched standard-rate threshold in seconds. */
+    hedgerFeeCloseStandardThreshold?: number;
+}
+/**
+ * Parameters for {@link getInstantCloseFees}.
+ */
+export type GetInstantCloseFeesParameters = Compute<ReadSolverParameter & {
+    /** PartyA the platform close-fee rate is read for (`getFeeForUser`). */
+    subAccountAddress: Address;
+    /** Market identification + optional pre-fetched metadata. */
+    market: InstantCloseFeesMarketData;
+    /** Leveraged base-asset quantity being closed (decimal string). */
+    quantity: string;
+    /**
+     * When the position opened, in unix seconds — the holding time the solver
+     * close-fee schedule is priced at is `now − openedAt`. When omitted on a
+     * lowcap solver the schedule is priced at holding time `0` (the early-rate
+     * worst case) — the conservative default for an unknown age.
+     */
+    openedAt?: bigint | number;
+    /**
+     * Override for "now" in unix seconds. Defaults to the current clock at
+     * call time; pass a fixed value for deterministic previews and tests.
+     */
+    now?: number;
+    /** Pre-fetched mark price as decimal string. When omitted, fetched via the price service. */
+    markPrice?: string;
+    /** Pre-fetched on-chain fee rates (matches `getFeeForUser` return). When omitted, fetched. */
+    feeRates?: FeeForUser;
+    /**
+     * Pre-fetched solver static fees (matches `getSolverInfo` return) —
+     * **lowcap/Enigma only**; ignored on any other solver kind. When omitted on
+     * a lowcap solver, fetched via `getSolverInfo` (fail-soft: an unreachable
+     * `/info` prices the static close leg at `"0"`).
+     */
+    solverInfo?: EnigmaSolverInfo;
+}>;
+/**
+ * Fee legs every solver kind charges **at close**.
+ */
+export interface BaseInstantCloseFees {
+    /**
+     * Platform close fee: `getFeeForUser.closeFee × notional / 1e18` (decimal
+     * string). Charged on-chain from the allocated balance after PnL settlement.
+     */
+    platformCloseFee: string;
+    /** Close notional the rates were applied to: `quantity × markPrice` (decimal string). */
+    notional: string;
+    /** Sum of every close leg this kind charges (decimal string). */
+    totalFee: string;
+}
+/**
+ * Fee breakdown for a **lowcap (Enigma)** instant close. Extends the platform
+ * leg with the solver legs charged at close execution.
+ */
+export interface EnigmaInstantCloseFees extends BaseInstantCloseFees {
+    /** Discriminant: these fees were priced for an Enigma (lowcap) solver. */
+    kind: "enigma";
+    /**
+     * Solver close fee at the priced holding time (decimal string) — the
+     * schedule decays from the early (peak) rate to the standard rate as the
+     * position ages. Capped on-chain by the `closeRateCap` the open signed.
+     */
+    closeSolverFee: string;
+    /** The close-fee rate the leg was priced at (decimal fraction string) — for rate displays. */
+    closeSolverFeeRate: string;
+    /** Holding time the schedule was evaluated at, in seconds. */
+    holdingSeconds: number;
+    /**
+     * Static solver close fee — a flat USD amount from the solver's `/info`
+     * config, independent of the notional (decimal string). `"0"` when the
+     * solver publishes none.
+     */
+    staticSolverFeeClose: string;
+}
+/**
+ * Fee breakdown for a **majors (Rasa)** instant close — the platform close leg
+ * only.
+ */
+export interface RasaInstantCloseFees extends BaseInstantCloseFees {
+    /** Discriminant: these fees were priced for a Rasa (majors) solver. */
+    kind: "rasa";
+}
+/**
+ * Return type of {@link getInstantCloseFees}. Narrow on `kind` to reach the
+ * lowcap-only legs.
+ */
+export type GetInstantCloseFeesReturnType = EnigmaInstantCloseFees | RasaInstantCloseFees;
+/**
+ * Preview every fee closing a position pays **right now** — priced from the
+ * current mark price and the position's real holding time, without signing or
+ * submitting anything. The open flow deliberately does not preview these legs
+ * (`getInstantOpenFees` is open-side only): at open the close notional and the
+ * holding-time rate are unknown, so the honest number only exists here.
+ *
+ * - **Both kinds**: `platformCloseFee` (on-chain `getFeeForUser.closeFee` ×
+ *   close notional) — the contract charges it from the allocated balance after
+ *   PnL settlement.
+ * - **Lowcap (Enigma) only**: `closeSolverFee` — the close-fee schedule
+ *   (early → standard decay) evaluated at `now − openedAt` seconds, capped
+ *   on-chain by the `closeRateCap` the open signed — plus the flat
+ *   `staticSolverFeeClose` from the solver's `/info` config.
+ *
+ * The holding time is stamped at call time: `now` defaults to the current
+ * clock; pass it explicitly for deterministic previews. An omitted `openedAt`
+ * prices the worst case (holding time `0`, the peak rate).
+ *
+ * @throws {SymmError} `INVALID_TRADE_PARAMETERS` when `quantity` is not a
+ *   positive number or the mark price resolves to zero/NaN;
+ *   `RESOLVE_MARKET_NOT_FOUND` / `RESOLVE_MARK_PRICE_NOT_FOUND` for
+ *   unresolvable inputs.
+ *
+ * @example
+ * ```ts
+ * const fees = await getInstantCloseFees(config, {
+ *   subAccountAddress,
+ *   market: { id: 1 },
+ *   quantity: "2.5",
+ *   openedAt: position.createTimestamp,
+ * });
+ * if (fees.kind === "enigma") console.log(fees.closeSolverFee, fees.holdingSeconds);
+ * console.log(fees.totalFee);
+ * ```
+ */
+export declare function getInstantCloseFees(config: Config, parameters: GetInstantCloseFeesParameters): Promise<GetInstantCloseFeesReturnType>;
+//# sourceMappingURL=get-instant-close-fees.d.ts.map

package/dist/solvers/instant-close/get-instant-close-fees/get-instant-close-fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-instant-close-fees.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-close/get-instant-close-fees/get-instant-close-fees.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2DAA2D,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9D;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kDAAkD;IAClD,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,sDAAsD;IACtD,+BAA+B,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,OAAO,CACjD,mBAAmB,GAAG;IACpB,wEAAwE;IACxE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,0BAA0B,CAAC;IACnC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,0EAA0E;IAC1E,IAAI,EAAE,QAAQ,CAAC;IACf;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,6BAA6B,CAAC,CAoGxC"}