@symmio/trading-core 3.0.0 → 3.1.0

package/dist/quotes/grouping/aggregate-group-funding.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate-group-funding.js","names":[],"sources":["../../../src/quotes/grouping/aggregate-group-funding.ts"],"sourcesContent":["import type { QuoteFundingData } from \"../get-quote-funding/types\";\nimport type { UnifiedQuote } from \"../unified-quote\";\n\n/**\n * Aggregated funding for one group of quotes, folded from the per-quote\n * {@link QuoteFundingData} rows the analytics subgraph returned for its children.\n *\n * Every amount is 18-decimal wei `bigint`, matching {@link UnifiedQuote}.\n *\n * **Sign convention** — `netReceived = received − paid`, the P&L perspective. A\n * **positive** `netReceived` means the group has **earned** funding; a negative\n * one means it has **paid** for it. This matches\n * {@link QuoteFundingData.netReceived} and {@link QuoteGroupUpnl.upnl}, so a\n * \"green = income\" UI renders it directly. It is the inverse of the on-chain\n * `int256`, which is cost-positive.\n *\n * **Settled-to-date only** — these totals cover funding the protocol has already\n * charged and the analytics subgraph has indexed. Funding accrued since the last\n * charge is **not** included: it is not indexed anywhere, so it cannot be part of\n * this sum.\n *\n * **Completeness** — `netReceived` is always the sum over the children that *did*\n * resolve, i.e. a lower bound while rows are still missing; it is never\n * suppressed. Read {@link isComplete} to decide whether to trust it, and treat\n * `isComplete: false` as \"funding unknown\", not as \"no funding\".\n */\nexport interface QuoteGroupFunding {\n  /** Σ funding partyA paid across the group's resolved children (wei). */\n  paid: bigint;\n  /** Σ funding partyA received across the group's resolved children (wei). */\n  received: bigint;\n  /**\n   * Σ `received − paid` across the group's resolved children (wei). **Positive =\n   * the group earned funding**; negative = it paid for it. A lower bound while\n   * {@link isComplete} is `false`.\n   */\n  netReceived: bigint;\n  /** Number of distinct child quote ids that produced a funding row. */\n  resolvedCount: number;\n  /**\n   * Number of distinct on-chain quote ids among the children — the rows this\n   * group expects. Optimistic children (no `quoteId` yet) are not counted.\n   */\n  expectedCount: number;\n  /**\n   * Expected quote ids with no funding row yet (subgraph indexing lag), in the\n   * order the ids first appear in the group's children.\n   */\n  missingQuoteIds: bigint[];\n  /**\n   * `true` only when the group has at least one on-chain child **and** every one\n   * of them resolved — i.e. the amounts above are the group's complete\n   * settled-to-date funding.\n   *\n   * An all-optimistic group (or an empty one) has nothing to resolve and reports\n   * `false` with `net: 0n`, so a consumer can tell \"funding unknown\" apart from\n   * \"no funding\".\n   */\n  isComplete: boolean;\n}\n\n/**\n * Fold the per-quote funding rows of a group's children into a single\n * {@link QuoteGroupFunding}.\n *\n * Behaviour:\n *\n * - **De-duplicated by `quoteId`.** The fold runs over the *distinct* on-chain\n *   ids among `quotes`, so a quote listed twice contributes its funding once.\n *   Duplicate rows for the same id in `rows` are likewise counted once.\n * - **Optimistic children are skipped.** A child with no `quoteId` has nothing to\n *   look up, so it neither inflates `expectedCount` nor lands in\n *   `missingQuoteIds`.\n * - **Extra rows are ignored.** A row whose `quoteId` is not among the children\n *   is never summed — passing a shared, over-fetched row set is safe.\n * - **`netReceived` is never suppressed.** It is the sum over whatever resolved:\n *   a lower bound while `isComplete` is `false`.\n * - **`isComplete` is `expectedCount > 0 && missingQuoteIds.length === 0`.** An\n *   all-optimistic or empty group therefore reports `isComplete: false` with\n *   zero amounts — \"funding unknown\", not \"no funding\".\n *\n * Sign convention: `netReceived = received − paid`, so **positive means the group\n * earned funding** (see {@link QuoteGroupFunding}). The totals are funding\n * **settled to date**; funding accrued since the last charge is not indexed and\n * not included.\n *\n * Do **not** substitute `Σ UnifiedQuote.accumulatedPaidFunding` as a shortcut.\n * That field is the quote's cumulative funding *rate index* on-chain\n * (`accumulatedRate × epochsSinceStart`), not a settled amount — summing it\n * across quotes is dimensionally meaningless, and it is cost-positive where\n * `netReceived` is income-positive.\n *\n * Pure, order-independent, no IO. Empty input yields all-zero amounts with\n * `isComplete: false`.\n *\n * @param quotes - The group's child quotes (optimistic children allowed).\n * @param rows - Funding rows fetched for those quotes; extras and duplicates are tolerated.\n * @returns The aggregated funding for the group.\n *\n * @example\n * ```ts\n * const funding = aggregateGroupFunding(group.quotes, rows);\n * if (!funding.isComplete) {\n *   // still indexing — show a loading state rather than \"0 funding\"\n * } else if (funding.netReceived > 0n) {\n *   // the group has earned funding\n * }\n * ```\n */\nexport function aggregateGroupFunding(\n  quotes: readonly UnifiedQuote[],\n  rows: readonly QuoteFundingData[],\n): QuoteGroupFunding {\n  /** Distinct on-chain ids among the children, in first-appearance order. */\n  const expectedQuoteIds: bigint[] = [];\n  const seenQuoteIds = new Set<bigint>();\n  for (const quote of quotes) {\n    /** Optimistic / off-chain children have no id to resolve — skip them entirely. */\n    if (quote.quoteId === undefined) continue;\n    if (seenQuoteIds.has(quote.quoteId)) continue;\n    seenQuoteIds.add(quote.quoteId);\n    expectedQuoteIds.push(quote.quoteId);\n  }\n\n  /** First row per id — a repeated row for the same quote must not double-count. */\n  const rowByQuoteId = new Map<bigint, QuoteFundingData>();\n  for (const row of rows) {\n    if (!rowByQuoteId.has(row.quoteId)) rowByQuoteId.set(row.quoteId, row);\n  }\n\n  let paid = 0n;\n  let received = 0n;\n  let resolvedCount = 0;\n  const missingQuoteIds: bigint[] = [];\n\n  /** Folding over the expected ids (not over `quotes`) is what de-duplicates, and what ignores extra rows. */\n  for (const quoteId of expectedQuoteIds) {\n    const row = rowByQuoteId.get(quoteId);\n    if (row === undefined) {\n      missingQuoteIds.push(quoteId);\n      continue;\n    }\n    paid += row.paid;\n    received += row.received;\n    resolvedCount += 1;\n  }\n\n  return {\n    paid,\n    received,\n    /** Derived from the sums so the aggregate keeps the row-level `netReceived = received − paid` invariant. */\n    netReceived: received - paid,\n    resolvedCount,\n    expectedCount: expectedQuoteIds.length,\n    missingQuoteIds,\n    isComplete: expectedQuoteIds.length > 0 && missingQuoteIds.length === 0,\n  };\n}\n"],"mappings":";AA6GA,SAAgB,EACd,GACA,GACmB;CAEnB,IAAM,IAA6B,CAAC,GAC9B,oBAAe,IAAI,IAAY;CACrC,KAAK,IAAM,KAAS,GAEd,EAAM,YAAY,KAAA,MAClB,EAAa,IAAI,EAAM,OAAO,MAClC,EAAa,IAAI,EAAM,OAAO,GAC9B,EAAiB,KAAK,EAAM,OAAO;CAIrC,IAAM,oBAAe,IAAI,IAA8B;CACvD,KAAK,IAAM,KAAO,GAChB,AAAK,EAAa,IAAI,EAAI,OAAO,KAAG,EAAa,IAAI,EAAI,SAAS,CAAG;CAGvE,IAAI,IAAO,IACP,IAAW,IACX,IAAgB,GACd,IAA4B,CAAC;CAGnC,KAAK,IAAM,KAAW,GAAkB;EACtC,IAAM,IAAM,EAAa,IAAI,CAAO;EACpC,IAAI,MAAQ,KAAA,GAAW;GACrB,EAAgB,KAAK,CAAO;GAC5B;EACF;EAGA,AAFA,KAAQ,EAAI,MACZ,KAAY,EAAI,UAChB,KAAiB;CACnB;CAEA,OAAO;EACL;EACA;EAEA,aAAa,IAAW;EACxB;EACA,eAAe,EAAiB;EAChC;EACA,YAAY,EAAiB,SAAS,KAAK,EAAgB,WAAW;CACxE;AACF"}
+{"version":3,"file":"aggregate-group-funding.js","names":[],"sources":["../../../src/quotes/grouping/aggregate-group-funding.ts"],"sourcesContent":["import type { QuoteFundingData } from \"../get-quote-funding/types\";\nimport type { UnifiedQuote } from \"../unified-quote\";\n\n/**\n * Aggregated funding for one group of quotes, folded from the per-quote\n * {@link QuoteFundingData} rows the analytics subgraph returned for its children.\n *\n * Every amount is 18-decimal wei `bigint`, matching {@link UnifiedQuote}.\n *\n * **Sign convention** — `netReceived = received − paid`, the P&L perspective. A\n * **positive** `netReceived` means the group has **earned** funding; a negative\n * one means it has **paid** for it. This matches\n * {@link QuoteFundingData.netReceived} and {@link QuoteGroupUpnl.upnl}, so a\n * \"green = income\" UI renders it directly. It is the inverse of the on-chain\n * `int256`, which is cost-positive.\n *\n * **Settled-to-date only** — these totals cover funding the protocol has already\n * charged and the analytics subgraph has indexed. Funding accrued since the last\n * charge is **not** included: it is not indexed by the subgraph — read it with\n * {@link getQuotePendingFunding}. The two come from different sources at\n * different heights, so do not add them into a lifetime total.\n *\n * **Completeness** — `netReceived` is always the sum over the children that *did*\n * resolve, i.e. a lower bound while rows are still missing; it is never\n * suppressed. Read {@link isComplete} to decide whether to trust it, and treat\n * `isComplete: false` as \"funding unknown\", not as \"no funding\".\n */\nexport interface QuoteGroupFunding {\n  /** Σ funding partyA paid across the group's resolved children (wei). */\n  paid: bigint;\n  /** Σ funding partyA received across the group's resolved children (wei). */\n  received: bigint;\n  /**\n   * Σ `received − paid` across the group's resolved children (wei). **Positive =\n   * the group earned funding**; negative = it paid for it. A lower bound while\n   * {@link isComplete} is `false`.\n   */\n  netReceived: bigint;\n  /** Number of distinct child quote ids that produced a funding row. */\n  resolvedCount: number;\n  /**\n   * Number of distinct on-chain quote ids among the children — the rows this\n   * group expects. Optimistic children (no `quoteId` yet) are not counted.\n   */\n  expectedCount: number;\n  /**\n   * Expected quote ids with no funding row yet (subgraph indexing lag), in the\n   * order the ids first appear in the group's children.\n   */\n  missingQuoteIds: bigint[];\n  /**\n   * `true` only when the group has at least one on-chain child **and** every one\n   * of them resolved — i.e. the amounts above are the group's complete\n   * settled-to-date funding.\n   *\n   * An all-optimistic group (or an empty one) has nothing to resolve and reports\n   * `false` with `net: 0n`, so a consumer can tell \"funding unknown\" apart from\n   * \"no funding\".\n   */\n  isComplete: boolean;\n}\n\n/**\n * Fold the per-quote funding rows of a group's children into a single\n * {@link QuoteGroupFunding}.\n *\n * Behaviour:\n *\n * - **De-duplicated by `quoteId`.** The fold runs over the *distinct* on-chain\n *   ids among `quotes`, so a quote listed twice contributes its funding once.\n *   Duplicate rows for the same id in `rows` are likewise counted once.\n * - **Optimistic children are skipped.** A child with no `quoteId` has nothing to\n *   look up, so it neither inflates `expectedCount` nor lands in\n *   `missingQuoteIds`.\n * - **Extra rows are ignored.** A row whose `quoteId` is not among the children\n *   is never summed — passing a shared, over-fetched row set is safe.\n * - **`netReceived` is never suppressed.** It is the sum over whatever resolved:\n *   a lower bound while `isComplete` is `false`.\n * - **`isComplete` is `expectedCount > 0 && missingQuoteIds.length === 0`.** An\n *   all-optimistic or empty group therefore reports `isComplete: false` with\n *   zero amounts — \"funding unknown\", not \"no funding\".\n *\n * Sign convention: `netReceived = received − paid`, so **positive means the group\n * earned funding** (see {@link QuoteGroupFunding}). The totals are funding\n * **settled to date**; funding accrued since the last charge is not indexed by\n * the subgraph and not included — read it with {@link getQuotePendingFunding}.\n *\n * Do **not** substitute `Σ UnifiedQuote.accumulatedPaidFunding` as a shortcut.\n * That field is the quote's per-unit cumulative funding-fee *index* recorded at\n * its last settlement, not a settled amount — summing it across quotes is\n * dimensionally meaningless, and it is cost-positive where `netReceived` is\n * income-positive.\n *\n * Pure, order-independent, no IO. Empty input yields all-zero amounts with\n * `isComplete: false`.\n *\n * @param quotes - The group's child quotes (optimistic children allowed).\n * @param rows - Funding rows fetched for those quotes; extras and duplicates are tolerated.\n * @returns The aggregated funding for the group.\n *\n * @example\n * ```ts\n * const funding = aggregateGroupFunding(group.quotes, rows);\n * if (!funding.isComplete) {\n *   // still indexing — show a loading state rather than \"0 funding\"\n * } else if (funding.netReceived > 0n) {\n *   // the group has earned funding\n * }\n * ```\n */\nexport function aggregateGroupFunding(\n  quotes: readonly UnifiedQuote[],\n  rows: readonly QuoteFundingData[],\n): QuoteGroupFunding {\n  /** Distinct on-chain ids among the children, in first-appearance order. */\n  const expectedQuoteIds: bigint[] = [];\n  const seenQuoteIds = new Set<bigint>();\n  for (const quote of quotes) {\n    /** Optimistic / off-chain children have no id to resolve — skip them entirely. */\n    if (quote.quoteId === undefined) continue;\n    if (seenQuoteIds.has(quote.quoteId)) continue;\n    seenQuoteIds.add(quote.quoteId);\n    expectedQuoteIds.push(quote.quoteId);\n  }\n\n  /** First row per id — a repeated row for the same quote must not double-count. */\n  const rowByQuoteId = new Map<bigint, QuoteFundingData>();\n  for (const row of rows) {\n    if (!rowByQuoteId.has(row.quoteId)) rowByQuoteId.set(row.quoteId, row);\n  }\n\n  let paid = 0n;\n  let received = 0n;\n  let resolvedCount = 0;\n  const missingQuoteIds: bigint[] = [];\n\n  /** Folding over the expected ids (not over `quotes`) is what de-duplicates, and what ignores extra rows. */\n  for (const quoteId of expectedQuoteIds) {\n    const row = rowByQuoteId.get(quoteId);\n    if (row === undefined) {\n      missingQuoteIds.push(quoteId);\n      continue;\n    }\n    paid += row.paid;\n    received += row.received;\n    resolvedCount += 1;\n  }\n\n  return {\n    paid,\n    received,\n    /** Derived from the sums so the aggregate keeps the row-level `netReceived = received − paid` invariant. */\n    netReceived: received - paid,\n    resolvedCount,\n    expectedCount: expectedQuoteIds.length,\n    missingQuoteIds,\n    isComplete: expectedQuoteIds.length > 0 && missingQuoteIds.length === 0,\n  };\n}\n"],"mappings":";AA8GA,SAAgB,EACd,GACA,GACmB;CAEnB,IAAM,IAA6B,CAAC,GAC9B,oBAAe,IAAI,IAAY;CACrC,KAAK,IAAM,KAAS,GAEd,EAAM,YAAY,KAAA,MAClB,EAAa,IAAI,EAAM,OAAO,MAClC,EAAa,IAAI,EAAM,OAAO,GAC9B,EAAiB,KAAK,EAAM,OAAO;CAIrC,IAAM,oBAAe,IAAI,IAA8B;CACvD,KAAK,IAAM,KAAO,GAChB,AAAK,EAAa,IAAI,EAAI,OAAO,KAAG,EAAa,IAAI,EAAI,SAAS,CAAG;CAGvE,IAAI,IAAO,IACP,IAAW,IACX,IAAgB,GACd,IAA4B,CAAC;CAGnC,KAAK,IAAM,KAAW,GAAkB;EACtC,IAAM,IAAM,EAAa,IAAI,CAAO;EACpC,IAAI,MAAQ,KAAA,GAAW;GACrB,EAAgB,KAAK,CAAO;GAC5B;EACF;EAGA,AAFA,KAAQ,EAAI,MACZ,KAAY,EAAI,UAChB,KAAiB;CACnB;CAEA,OAAO;EACL;EACA;EAEA,aAAa,IAAW;EACxB;EACA,eAAe,EAAiB;EAChC;EACA,YAAY,EAAiB,SAAS,KAAK,EAAgB,WAAW;CACxE;AACF"}

package/dist/quotes/grouping/partition-quotes.d.ts

@@ -1,4 +1,34 @@
+import { QuoteStatus } from '../../symmio-contracts/symmio/types.js';
 import { UnifiedQuote } from '../unified-quote.js';
+/**
+ * Whether an on-chain status is an active position (`OPENED`, `CLOSE_PENDING`,
+ * `CANCEL_CLOSE_PENDING`, `LIQUIDATED_PENDING`) — the only statuses whose pending
+ * funding is meaningful. Same set as {@link isActivePosition}.
+ *
+ * Unlike {@link isActivePosition}, it takes a **known** status and has no
+ * lifecycle fallback: a row whose `quoteStatus` is still `undefined` (an
+ * optimistic or just-anchored row) is not something to call it with. Use it to
+ * pick which quotes to pass to {@link getQuotePendingFunding}, whose view does not
+ * check status and returns a meaningless amount for a locked-but-never-opened
+ * quote.
+ *
+ * @param status - The quote's on-chain status.
+ * @returns `true` for an active-position status.
+ *
+ * @example
+ * ```ts
+ * isActiveQuoteStatus(QuoteStatus.OPENED); // true
+ * isActiveQuoteStatus(QuoteStatus.LOCKED); // false
+ *
+ * const quoteIds = quotes.flatMap((quote) =>
+ *   quote.quoteId !== undefined && quote.quoteStatus !== undefined && isActiveQuoteStatus(quote.quoteStatus)
+ *     ? [quote.quoteId]
+ *     : [],
+ * );
+ * const rows = await getQuotePendingFunding(config, { quoteIds });
+ * ```
+ */
+export declare function isActiveQuoteStatus(status: QuoteStatus): boolean;
 /**
  * Whether a quote is a **resting/pending order** — submitted but not yet an open
  * position.

package/dist/quotes/grouping/partition-quotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partition-quotes.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/partition-quotes.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmBrE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAW3D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAe7D;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,iBAAiB,CAQlF"}
+{"version":3,"file":"partition-quotes.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/partition-quotes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmBrE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAW3D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAe7D;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,iBAAiB,CAQlF"}

package/dist/quotes/grouping/partition-quotes.js

@@ -11,11 +11,14 @@ var r = new Set([
 	t.CANCEL_CLOSE_PENDING,
 	t.LIQUIDATED_PENDING
 ]);
-function a(t) {
-	return t.quoteStatus === void 0 ? t.lifecycle === n.OPTIMISTIC || t.lifecycle === n.PRICE_FILLED || t.lifecycle === n.WRITE_ONCHAIN || t.lifecycle === n.ONCHAIN ? t.orderType === e.LIMIT : !1 : r.has(t.quoteStatus);
+function a(e) {
+	return i.has(e);
 }
 function o(t) {
-	if (t.quoteStatus !== void 0) return i.has(t.quoteStatus);
+	return t.quoteStatus === void 0 ? t.lifecycle === n.OPTIMISTIC || t.lifecycle === n.PRICE_FILLED || t.lifecycle === n.WRITE_ONCHAIN || t.lifecycle === n.ONCHAIN ? t.orderType === e.LIMIT : !1 : r.has(t.quoteStatus);
+}
+function s(t) {
+	if (t.quoteStatus !== void 0) return a(t.quoteStatus);
 	switch (t.lifecycle) {
 		case n.OPTIMISTIC:
 		case n.PRICE_FILLED:
@@ -27,15 +30,15 @@ function o(t) {
 		default: return !1;
 	}
 }
-function s(e) {
+function c(e) {
 	let t = [], n = [];
-	for (let r of e) a(r) ? n.push(r) : o(r) && t.push(r);
+	for (let r of e) o(r) ? n.push(r) : s(r) && t.push(r);
 	return {
 		positions: t,
 		pending: n
 	};
 }
 //#endregion
-export { o as isActivePosition, a as isPendingOrder, s as partitionQuotes };
+export { s as isActivePosition, a as isActiveQuoteStatus, o as isPendingOrder, c as partitionQuotes };
 
 //# sourceMappingURL=partition-quotes.js.map

package/dist/quotes/grouping/partition-quotes.js.map

@@ -1 +1 @@
-{"version":3,"file":"partition-quotes.js","names":[],"sources":["../../../src/quotes/grouping/partition-quotes.ts"],"sourcesContent":["import { OrderType, QuoteStatus } from \"../../symmio-contracts/symmio/types\";\nimport { QuoteLifecycle, type UnifiedQuote } from \"../unified-quote\";\n\n/**\n * On-chain statuses of a resting order that has **not** become a position yet.\n * These are the statuses `getPartyAPendingQuotes` returns.\n */\nconst PENDING_STATUSES = new Set<QuoteStatus>([QuoteStatus.PENDING, QuoteStatus.LOCKED, QuoteStatus.CANCEL_PENDING]);\n\n/**\n * On-chain statuses of an open position (including one with a close in flight).\n * These are the statuses `getPartyAOpenPositions` returns.\n */\nconst ACTIVE_STATUSES = new Set<QuoteStatus>([\n  QuoteStatus.OPENED,\n  QuoteStatus.CLOSE_PENDING,\n  QuoteStatus.CANCEL_CLOSE_PENDING,\n  QuoteStatus.LIQUIDATED_PENDING,\n]);\n\n/**\n * Whether a quote is a **resting/pending order** — submitted but not yet an open\n * position.\n *\n * An anchored row is classified by its on-chain {@link QuoteStatus}\n * (`PENDING` / `LOCKED` / `CANCEL_PENDING`). An off-chain optimistic row (no\n * status yet) is pending only when it is a not-yet-filled `LIMIT` order; an\n * optimistic `MARKET` open is treated as an opening position instead.\n *\n * Mutually exclusive with {@link isActivePosition}.\n *\n * @param quote - The unified quote to classify.\n * @returns `true` for a resting/pending order.\n */\nexport function isPendingOrder(quote: UnifiedQuote): boolean {\n  if (quote.quoteStatus !== undefined) return PENDING_STATUSES.has(quote.quoteStatus);\n  if (\n    quote.lifecycle === QuoteLifecycle.OPTIMISTIC ||\n    quote.lifecycle === QuoteLifecycle.PRICE_FILLED ||\n    quote.lifecycle === QuoteLifecycle.WRITE_ONCHAIN ||\n    quote.lifecycle === QuoteLifecycle.ONCHAIN\n  ) {\n    return quote.orderType === OrderType.LIMIT;\n  }\n  return false;\n}\n\n/**\n * Whether a quote is an **active position** — opened (or opening), possibly with\n * a close in flight.\n *\n * An anchored row is classified by its on-chain {@link QuoteStatus}\n * (`OPENED` / `CLOSE_PENDING` / `CANCEL_CLOSE_PENDING` / `LIQUIDATED_PENDING`).\n * A row with no `quoteStatus` yet is classified by lifecycle + order type: an\n * optimistic/price-filled or just-anchored (`WRITE_ONCHAIN` / `ONCHAIN`) `MARKET`\n * open is an active position, while the matching `LIMIT` order is still resting\n * (pending). The `WRITE_ONCHAIN`-without-`quoteStatus` case is the brief window\n * after a `SendQuoteTransaction` notification anchors the row but before the\n * on-chain poll has returned its full struct — without it the row would drop out of\n * the grouped view for a tick. Any closing-stage row (`OPTIMISTIC_CLOSE` /\n * `CLOSE_PRICE_FILLED` / `WRITE_ONCHAIN_CLOSE`) is always active; terminal rows\n * (`CLOSED` / `CANCELED` / `EXPIRED` / `LIQUIDATED`, or an off-chain `FAILED`) are\n * neither.\n *\n * Mutually exclusive with {@link isPendingOrder}.\n *\n * @param quote - The unified quote to classify.\n * @returns `true` for an active position.\n */\nexport function isActivePosition(quote: UnifiedQuote): boolean {\n  if (quote.quoteStatus !== undefined) return ACTIVE_STATUSES.has(quote.quoteStatus);\n  switch (quote.lifecycle) {\n    case QuoteLifecycle.OPTIMISTIC:\n    case QuoteLifecycle.PRICE_FILLED:\n    case QuoteLifecycle.WRITE_ONCHAIN:\n    case QuoteLifecycle.ONCHAIN:\n      return quote.orderType !== OrderType.LIMIT;\n    case QuoteLifecycle.OPTIMISTIC_CLOSE:\n    case QuoteLifecycle.CLOSE_PRICE_FILLED:\n    case QuoteLifecycle.WRITE_ONCHAIN_CLOSE:\n      return true;\n    default:\n      return false;\n  }\n}\n\n/** Result of {@link partitionQuotes}. */\nexport interface PartitionedQuotes {\n  /** Quotes that are open (or opening) positions. */\n  positions: UnifiedQuote[];\n  /** Quotes that are resting/pending orders. */\n  pending: UnifiedQuote[];\n}\n\n/**\n * Split unified quotes into active positions and resting/pending orders — the\n * grouped-view-vs-orders-tab split. Terminal rows (closed / cancelled / expired /\n * liquidated / failed) fall into neither bucket and are dropped, so\n * `positions ∪ pending` is the set of still-live quotes.\n *\n * @param quotes - The unified quotes to split.\n * @returns The `positions` and `pending` buckets, each preserving input order.\n *\n * @example\n * ```ts\n * const { positions, pending } = partitionQuotes(quotes);\n * const groups = groupQuotes(positions, SubAccountIsolationType.MARKET_DIRECTION);\n * ```\n */\nexport function partitionQuotes(quotes: readonly UnifiedQuote[]): PartitionedQuotes {\n  const positions: UnifiedQuote[] = [];\n  const pending: UnifiedQuote[] = [];\n  for (const quote of quotes) {\n    if (isPendingOrder(quote)) pending.push(quote);\n    else if (isActivePosition(quote)) positions.push(quote);\n  }\n  return { positions, pending };\n}\n"],"mappings":";;;AAOA,IAAM,IAAmB,IAAI,IAAiB;CAAC,EAAY;CAAS,EAAY;CAAQ,EAAY;AAAc,CAAC,GAM7G,IAAkB,IAAI,IAAiB;CAC3C,EAAY;CACZ,EAAY;CACZ,EAAY;CACZ,EAAY;AACd,CAAC;AAgBD,SAAgB,EAAe,GAA8B;CAU3D,OATI,EAAM,gBAAgB,KAAA,IAExB,EAAM,cAAc,EAAe,cACnC,EAAM,cAAc,EAAe,gBACnC,EAAM,cAAc,EAAe,iBACnC,EAAM,cAAc,EAAe,UAE5B,EAAM,cAAc,EAAU,QAEhC,KATqC,EAAiB,IAAI,EAAM,WAAW;AAUpF;AAwBA,SAAgB,EAAiB,GAA8B;CAC7D,IAAI,EAAM,gBAAgB,KAAA,GAAW,OAAO,EAAgB,IAAI,EAAM,WAAW;CACjF,QAAQ,EAAM,WAAd;EACE,KAAK,EAAe;EACpB,KAAK,EAAe;EACpB,KAAK,EAAe;EACpB,KAAK,EAAe,SAClB,OAAO,EAAM,cAAc,EAAU;EACvC,KAAK,EAAe;EACpB,KAAK,EAAe;EACpB,KAAK,EAAe,qBAClB,OAAO;EACT,SACE,OAAO;CACX;AACF;AAyBA,SAAgB,EAAgB,GAAoD;CAClF,IAAM,IAA4B,CAAC,GAC7B,IAA0B,CAAC;CACjC,KAAK,IAAM,KAAS,GAClB,AAAI,EAAe,CAAK,IAAG,EAAQ,KAAK,CAAK,IACpC,EAAiB,CAAK,KAAG,EAAU,KAAK,CAAK;CAExD,OAAO;EAAE;EAAW;CAAQ;AAC9B"}
+{"version":3,"file":"partition-quotes.js","names":[],"sources":["../../../src/quotes/grouping/partition-quotes.ts"],"sourcesContent":["import { OrderType, QuoteStatus } from \"../../symmio-contracts/symmio/types\";\nimport { QuoteLifecycle, type UnifiedQuote } from \"../unified-quote\";\n\n/**\n * On-chain statuses of a resting order that has **not** become a position yet.\n * These are the statuses `getPartyAPendingQuotes` returns.\n */\nconst PENDING_STATUSES = new Set<QuoteStatus>([QuoteStatus.PENDING, QuoteStatus.LOCKED, QuoteStatus.CANCEL_PENDING]);\n\n/**\n * On-chain statuses of an open position (including one with a close in flight).\n * These are the statuses `getPartyAOpenPositions` returns.\n */\nconst ACTIVE_STATUSES = new Set<QuoteStatus>([\n  QuoteStatus.OPENED,\n  QuoteStatus.CLOSE_PENDING,\n  QuoteStatus.CANCEL_CLOSE_PENDING,\n  QuoteStatus.LIQUIDATED_PENDING,\n]);\n\n/**\n * Whether an on-chain status is an active position (`OPENED`, `CLOSE_PENDING`,\n * `CANCEL_CLOSE_PENDING`, `LIQUIDATED_PENDING`) — the only statuses whose pending\n * funding is meaningful. Same set as {@link isActivePosition}.\n *\n * Unlike {@link isActivePosition}, it takes a **known** status and has no\n * lifecycle fallback: a row whose `quoteStatus` is still `undefined` (an\n * optimistic or just-anchored row) is not something to call it with. Use it to\n * pick which quotes to pass to {@link getQuotePendingFunding}, whose view does not\n * check status and returns a meaningless amount for a locked-but-never-opened\n * quote.\n *\n * @param status - The quote's on-chain status.\n * @returns `true` for an active-position status.\n *\n * @example\n * ```ts\n * isActiveQuoteStatus(QuoteStatus.OPENED); // true\n * isActiveQuoteStatus(QuoteStatus.LOCKED); // false\n *\n * const quoteIds = quotes.flatMap((quote) =>\n *   quote.quoteId !== undefined && quote.quoteStatus !== undefined && isActiveQuoteStatus(quote.quoteStatus)\n *     ? [quote.quoteId]\n *     : [],\n * );\n * const rows = await getQuotePendingFunding(config, { quoteIds });\n * ```\n */\nexport function isActiveQuoteStatus(status: QuoteStatus): boolean {\n  return ACTIVE_STATUSES.has(status);\n}\n\n/**\n * Whether a quote is a **resting/pending order** — submitted but not yet an open\n * position.\n *\n * An anchored row is classified by its on-chain {@link QuoteStatus}\n * (`PENDING` / `LOCKED` / `CANCEL_PENDING`). An off-chain optimistic row (no\n * status yet) is pending only when it is a not-yet-filled `LIMIT` order; an\n * optimistic `MARKET` open is treated as an opening position instead.\n *\n * Mutually exclusive with {@link isActivePosition}.\n *\n * @param quote - The unified quote to classify.\n * @returns `true` for a resting/pending order.\n */\nexport function isPendingOrder(quote: UnifiedQuote): boolean {\n  if (quote.quoteStatus !== undefined) return PENDING_STATUSES.has(quote.quoteStatus);\n  if (\n    quote.lifecycle === QuoteLifecycle.OPTIMISTIC ||\n    quote.lifecycle === QuoteLifecycle.PRICE_FILLED ||\n    quote.lifecycle === QuoteLifecycle.WRITE_ONCHAIN ||\n    quote.lifecycle === QuoteLifecycle.ONCHAIN\n  ) {\n    return quote.orderType === OrderType.LIMIT;\n  }\n  return false;\n}\n\n/**\n * Whether a quote is an **active position** — opened (or opening), possibly with\n * a close in flight.\n *\n * An anchored row is classified by its on-chain {@link QuoteStatus}\n * (`OPENED` / `CLOSE_PENDING` / `CANCEL_CLOSE_PENDING` / `LIQUIDATED_PENDING`).\n * A row with no `quoteStatus` yet is classified by lifecycle + order type: an\n * optimistic/price-filled or just-anchored (`WRITE_ONCHAIN` / `ONCHAIN`) `MARKET`\n * open is an active position, while the matching `LIMIT` order is still resting\n * (pending). The `WRITE_ONCHAIN`-without-`quoteStatus` case is the brief window\n * after a `SendQuoteTransaction` notification anchors the row but before the\n * on-chain poll has returned its full struct — without it the row would drop out of\n * the grouped view for a tick. Any closing-stage row (`OPTIMISTIC_CLOSE` /\n * `CLOSE_PRICE_FILLED` / `WRITE_ONCHAIN_CLOSE`) is always active; terminal rows\n * (`CLOSED` / `CANCELED` / `EXPIRED` / `LIQUIDATED`, or an off-chain `FAILED`) are\n * neither.\n *\n * Mutually exclusive with {@link isPendingOrder}.\n *\n * @param quote - The unified quote to classify.\n * @returns `true` for an active position.\n */\nexport function isActivePosition(quote: UnifiedQuote): boolean {\n  if (quote.quoteStatus !== undefined) return isActiveQuoteStatus(quote.quoteStatus);\n  switch (quote.lifecycle) {\n    case QuoteLifecycle.OPTIMISTIC:\n    case QuoteLifecycle.PRICE_FILLED:\n    case QuoteLifecycle.WRITE_ONCHAIN:\n    case QuoteLifecycle.ONCHAIN:\n      return quote.orderType !== OrderType.LIMIT;\n    case QuoteLifecycle.OPTIMISTIC_CLOSE:\n    case QuoteLifecycle.CLOSE_PRICE_FILLED:\n    case QuoteLifecycle.WRITE_ONCHAIN_CLOSE:\n      return true;\n    default:\n      return false;\n  }\n}\n\n/** Result of {@link partitionQuotes}. */\nexport interface PartitionedQuotes {\n  /** Quotes that are open (or opening) positions. */\n  positions: UnifiedQuote[];\n  /** Quotes that are resting/pending orders. */\n  pending: UnifiedQuote[];\n}\n\n/**\n * Split unified quotes into active positions and resting/pending orders — the\n * grouped-view-vs-orders-tab split. Terminal rows (closed / cancelled / expired /\n * liquidated / failed) fall into neither bucket and are dropped, so\n * `positions ∪ pending` is the set of still-live quotes.\n *\n * @param quotes - The unified quotes to split.\n * @returns The `positions` and `pending` buckets, each preserving input order.\n *\n * @example\n * ```ts\n * const { positions, pending } = partitionQuotes(quotes);\n * const groups = groupQuotes(positions, SubAccountIsolationType.MARKET_DIRECTION);\n * ```\n */\nexport function partitionQuotes(quotes: readonly UnifiedQuote[]): PartitionedQuotes {\n  const positions: UnifiedQuote[] = [];\n  const pending: UnifiedQuote[] = [];\n  for (const quote of quotes) {\n    if (isPendingOrder(quote)) pending.push(quote);\n    else if (isActivePosition(quote)) positions.push(quote);\n  }\n  return { positions, pending };\n}\n"],"mappings":";;;AAOA,IAAM,IAAmB,IAAI,IAAiB;CAAC,EAAY;CAAS,EAAY;CAAQ,EAAY;AAAc,CAAC,GAM7G,IAAkB,IAAI,IAAiB;CAC3C,EAAY;CACZ,EAAY;CACZ,EAAY;CACZ,EAAY;AACd,CAAC;AA8BD,SAAgB,EAAoB,GAA8B;CAChE,OAAO,EAAgB,IAAI,CAAM;AACnC;AAgBA,SAAgB,EAAe,GAA8B;CAU3D,OATI,EAAM,gBAAgB,KAAA,IAExB,EAAM,cAAc,EAAe,cACnC,EAAM,cAAc,EAAe,gBACnC,EAAM,cAAc,EAAe,iBACnC,EAAM,cAAc,EAAe,UAE5B,EAAM,cAAc,EAAU,QAEhC,KATqC,EAAiB,IAAI,EAAM,WAAW;AAUpF;AAwBA,SAAgB,EAAiB,GAA8B;CAC7D,IAAI,EAAM,gBAAgB,KAAA,GAAW,OAAO,EAAoB,EAAM,WAAW;CACjF,QAAQ,EAAM,WAAd;EACE,KAAK,EAAe;EACpB,KAAK,EAAe;EACpB,KAAK,EAAe;EACpB,KAAK,EAAe,SAClB,OAAO,EAAM,cAAc,EAAU;EACvC,KAAK,EAAe;EACpB,KAAK,EAAe;EACpB,KAAK,EAAe,qBAClB,OAAO;EACT,SACE,OAAO;CACX;AACF;AAyBA,SAAgB,EAAgB,GAAoD;CAClF,IAAM,IAA4B,CAAC,GAC7B,IAA0B,CAAC;CACjC,KAAK,IAAM,KAAS,GAClB,AAAI,EAAe,CAAK,IAAG,EAAQ,KAAK,CAAK,IACpC,EAAiB,CAAK,KAAG,EAAU,KAAK,CAAK;CAExD,OAAO;EAAE;EAAW;CAAQ;AAC9B"}

package/dist/quotes/index.d.ts

@@ -5,6 +5,7 @@ export * from './fingerprint.js';
 export * from './get-quote-events-by-type/index.js';
 export * from './get-quote-funding/index.js';
 export * from './get-quote-history/index.js';
+export * from './get-quote-pending-funding/index.js';
 export * from './get-quotes-events-by-type/index.js';
 export * from './get-sub-account-quotes/index.js';
 export * from './grouping/index.js';

package/dist/quotes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quotes/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quotes/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC"}

package/dist/quotes/unified-quote.d.ts

@@ -135,12 +135,12 @@ export interface UnifiedQuote {
     /** Maximum funding rate partyA accepts, when known. */
     maxFundingRate?: bigint;
     /**
-     * Cumulative funding-**rate index** already settled on the quote (18-decimal
-     * fixed point) — the position's funding rate multiplied by the epochs elapsed
-     * since the funding fee started, when known. **Not a currency amount**: the
-     * settled fee is only obtained as
-     * `openAmount × (currentFee − accumulatedPaidFunding) / 1e18`, so summing this
-     * field across quotes is meaningless. For real settled funding amounts use
+     * Per-unit cumulative funding-fee **index** recorded at the quote's last
+     * settlement (18-decimal fixed point, cost-positive), when known. **Not a
+     * currency amount**, so summing this field across quotes is meaningless:
+     * `openAmount × (currentFee − accumulatedPaidFunding) / 1e18` is the
+     * **pending**, not-yet-settled fee — read that with
+     * {@link getQuotePendingFunding}. For settled funding amounts use
      * {@link getQuoteFunding} / {@link aggregateGroupFunding}.
      */
     accumulatedPaidFunding?: bigint;

package/dist/quotes/unified-quote.js.map

@@ -1 +1 @@
-{"version":3,"file":"unified-quote.js","names":[],"sources":["../../src/quotes/unified-quote.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { PendingInstantClose } from \"../solvers/instant-close/get-instant-closes/to-pending-instant-close\";\nimport type { PendingInstantOpen } from \"../solvers/instant-open/get-instant-opens/types\";\nimport type { LockedValues, OrderType, PositionType, Quote, QuoteStatus } from \"../symmio-contracts/symmio/types\";\n\n/**\n * Where a {@link UnifiedQuote} was sourced from before reconciliation.\n *\n * - `\"onchain\"` — read from the SYMMIO core (`getPartyAOpenPositions` /\n *   `getPartyAPendingQuotes` + `getQuote`); the row carries a real `quoteId`.\n * - `\"offchain\"` — only known to a hedger so far (a pending instant-open or\n *   instant-close); the row carries a `tempQuoteId` and waits to anchor on-chain.\n */\nexport type QuoteOrigin = \"onchain\" | \"offchain\";\n\n/**\n * The stage of a quote's lifecycle as tracked across the on-chain + off-chain\n * merge. Drives row styling and polling acceleration in the consumer.\n *\n * Lifecycle tracks the **write progression** (off-chain → on-chain), not the\n * on-chain status: once a quote is on-chain it is `ONCHAIN` whether it is\n * `OPENED` or `CLOSE_PENDING` — read {@link UnifiedQuote.quoteStatus} for that\n * distinction. The off-chain stages (`OPTIMISTIC*`, `*PRICE_FILLED`,\n * `WRITE_ONCHAIN*`) are SDK-side overlays that do not exist on the on-chain\n * {@link QuoteStatus}; reconciliation assigns them from notifications and hedger\n * records.\n */\nexport enum QuoteLifecycle {\n  /** Submitted to a hedger; no on-chain quote and no fill report yet. */\n  OPTIMISTIC = \"optimistic\",\n  /** A hedger reported a fill price (`InstantRFQ` success) but the on-chain quote has not landed yet. */\n  PRICE_FILLED = \"price-filled\",\n  /**\n   * The open anchored on-chain per the notification (the `quoteId` is known), but\n   * the on-chain read has not returned the quote struct yet. The row is being\n   * \"written on-chain\": shown with its anchored id while the SDK waits for the RPC\n   * to confirm it. Resolves to {@link QuoteLifecycle.ONCHAIN} once the on-chain\n   * read returns the struct.\n   */\n  WRITE_ONCHAIN = \"write-onchain\",\n  /** Anchored on-chain; mirrors a real {@link QuoteStatus}. */\n  ONCHAIN = \"onchain\",\n  /**\n   * A close was just submitted and the hedger's pending-instant-close feed has it,\n   * but no close notification has confirmed a price yet — the close-side analog of\n   * {@link QuoteLifecycle.OPTIMISTIC}. Advances to {@link QuoteLifecycle.CLOSE_PRICE_FILLED}.\n   */\n  OPTIMISTIC_CLOSE = \"optimistic-close\",\n  /**\n   * A close notification reported the close price/fill request\n   * (`InstantRequestToClosePosition`) — the close-side analog of\n   * {@link QuoteLifecycle.PRICE_FILLED}. Advances to {@link QuoteLifecycle.WRITE_ONCHAIN_CLOSE}.\n   */\n  CLOSE_PRICE_FILLED = \"close-price-filled\",\n  /**\n   * The close fill (`FillMarketOrderInstantClose`) or the limit-close anchor\n   * (`InstantRequestToLimitClose`) was reported, or a pending instant-close\n   * overlays the row while the on-chain status still shows the position open — the\n   * close is being \"written on-chain\", awaiting the RPC. The close-side analog of\n   * {@link QuoteLifecycle.WRITE_ONCHAIN}. Resolves to {@link QuoteLifecycle.ONCHAIN}\n   * once the on-chain read returns the quote (now `CLOSE_PENDING`); read\n   * {@link UnifiedQuote.quoteStatus} to see the close is pending.\n   */\n  WRITE_ONCHAIN_CLOSE = \"write-onchain-close\",\n  /** The position is fully closed. */\n  CLOSED = \"closed\",\n  /** A hedger or notification reported the open/close failed. */\n  FAILED = \"failed\",\n}\n\n/**\n * A single quote/position row merged from every source (on-chain reads, pending\n * instant-opens, pending instant-closes, and notifications) into one stable,\n * de-duplicated shape.\n *\n * All amount and price fields are 18-decimal-wei `bigint`, matching the on-chain\n * {@link Quote}. Off-chain hedger amounts are normalized to wei before they reach\n * this type. The `key` is a stable identity for React lists and the removal\n * ledger; `raw` carries the untouched source rows for advanced use.\n */\nexport interface UnifiedQuote {\n  /** Stable identity for this row (`onchain:<id>` or `temp:<tempId>`). */\n  key: string;\n  /** Source the row was reconciled from. */\n  origin: QuoteOrigin;\n  /** Current lifecycle stage. */\n  lifecycle: QuoteLifecycle;\n  /** On-chain quote id, once anchored. */\n  quoteId?: bigint;\n  /** Hedger-local temp id, before the on-chain id exists. */\n  tempQuoteId?: number;\n  /** Sub-account (partyA) that owns the row. */\n  partyA: Address;\n  /** PartyB (hedger/solver) that locked/opened the quote, when known. */\n  partyB?: Address;\n  /** Solver-assigned Virtual Account address (lowcap), when known. */\n  vaAddress?: Address;\n  /** Market identifier (`symbolId`). */\n  symbolId: bigint;\n  /** Long or short. */\n  positionType: PositionType;\n  /** Limit or market order. */\n  orderType: OrderType;\n  /** On-chain status, when the row is anchored on-chain. */\n  quoteStatus?: QuoteStatus;\n  /** Price partyA requested to open at (wei). */\n  requestedOpenPrice: bigint;\n  /** Price partyB actually opened at (wei), when known. */\n  openedPrice?: bigint;\n  /** Initial price partyB opened at before any edits (wei), when known. */\n  initialOpenedPrice?: bigint;\n  /** Average price across executed closes (wei), when known. */\n  avgClosedPrice?: bigint;\n  /** Requested limit price for a pending close (wei), when known. */\n  requestedClosePrice?: bigint;\n  /** Market price snapshot at last state change (wei), when known. */\n  marketPrice?: bigint;\n  /** Total requested quantity (wei) — fixed for the life of the position; partial closes do not shrink it. */\n  quantity: bigint;\n  /** Quantity already closed (wei), when known. */\n  closedAmount?: bigint;\n  /**\n   * Remaining **open** size (wei): `quantity − closedAmount`, the live quantity\n   * still on the position (the figure a UI shows as \"position size\"); `0` once\n   * fully closed. Derived from the other amount fields by {@link quoteOpenQuantity}.\n   *\n   * A size, never a state: a quote that has not opened yet still reports its full\n   * `quantity`. To ask whether a row is a position, use `isPendingOrder` /\n   * `isActivePosition`, which read {@link UnifiedQuote.quoteStatus}.\n   */\n  openQuantity: bigint;\n  /** Quantity targeted by a pending close (wei), when closing. */\n  quantityToClose?: bigint;\n  /** Margin locked against the row (wei). */\n  lockedValues: LockedValues;\n  /** Margin locked at open time — basis for leverage (wei), when known. */\n  initialLockedValues?: LockedValues;\n  /** Maximum funding rate partyA accepts, when known. */\n  maxFundingRate?: bigint;\n  /**\n   * Cumulative funding-**rate index** already settled on the quote (18-decimal\n   * fixed point) — the position's funding rate multiplied by the epochs elapsed\n   * since the funding fee started, when known. **Not a currency amount**: the\n   * settled fee is only obtained as\n   * `openAmount × (currentFee − accumulatedPaidFunding) / 1e18`, so summing this\n   * field across quotes is meaningless. For real settled funding amounts use\n   * {@link getQuoteFunding} / {@link aggregateGroupFunding}.\n   */\n  accumulatedPaidFunding?: bigint;\n  /** Block timestamp funding was last applied, when known. */\n  lastFundingPaymentTimestamp?: bigint;\n  /** Quote deadline (expiry) timestamp, when known. */\n  deadline?: bigint;\n  /** Trading fee charged on the quote (wei), when known. */\n  tradingFee?: bigint;\n  /** Fee charged on close (wei), when known. */\n  closeFee?: bigint;\n  /** Affiliate address attributed to the quote, when known. */\n  affiliate?: Address;\n  /** PartyB addresses allowed to fill this quote (empty means any), when known. */\n  partyBsWhiteList?: readonly Address[];\n  /** Parent quote id for a partially-opened child, when known. */\n  parentId?: bigint;\n  /** Opaque per-quote data, when known. */\n  data?: Hex;\n  /** Block timestamp the quote was created, when known. */\n  createTimestamp?: bigint;\n  /** Block timestamp of the last status change (sort key), when known. */\n  statusModifyTimestamp?: bigint;\n  /** Untouched source rows this was reconciled from. */\n  raw: {\n    /** The on-chain quote, when the row is anchored. */\n    onchain?: Quote;\n    /** The pending instant-open record, when sourced off-chain. */\n    instantOpen?: PendingInstantOpen;\n    /** The pending instant-close record, when closing off-chain. */\n    instantClose?: PendingInstantClose;\n  };\n}\n"],"mappings":";AA2BA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,aAAA,cAEA,EAAA,eAAA,gBAQA,EAAA,gBAAA,iBAEA,EAAA,UAAA,WAMA,EAAA,mBAAA,oBAMA,EAAA,qBAAA,sBAUA,EAAA,sBAAA,uBAEA,EAAA,SAAA,UAEA,EAAA,SAAA;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"unified-quote.js","names":[],"sources":["../../src/quotes/unified-quote.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { PendingInstantClose } from \"../solvers/instant-close/get-instant-closes/to-pending-instant-close\";\nimport type { PendingInstantOpen } from \"../solvers/instant-open/get-instant-opens/types\";\nimport type { LockedValues, OrderType, PositionType, Quote, QuoteStatus } from \"../symmio-contracts/symmio/types\";\n\n/**\n * Where a {@link UnifiedQuote} was sourced from before reconciliation.\n *\n * - `\"onchain\"` — read from the SYMMIO core (`getPartyAOpenPositions` /\n *   `getPartyAPendingQuotes` + `getQuote`); the row carries a real `quoteId`.\n * - `\"offchain\"` — only known to a hedger so far (a pending instant-open or\n *   instant-close); the row carries a `tempQuoteId` and waits to anchor on-chain.\n */\nexport type QuoteOrigin = \"onchain\" | \"offchain\";\n\n/**\n * The stage of a quote's lifecycle as tracked across the on-chain + off-chain\n * merge. Drives row styling and polling acceleration in the consumer.\n *\n * Lifecycle tracks the **write progression** (off-chain → on-chain), not the\n * on-chain status: once a quote is on-chain it is `ONCHAIN` whether it is\n * `OPENED` or `CLOSE_PENDING` — read {@link UnifiedQuote.quoteStatus} for that\n * distinction. The off-chain stages (`OPTIMISTIC*`, `*PRICE_FILLED`,\n * `WRITE_ONCHAIN*`) are SDK-side overlays that do not exist on the on-chain\n * {@link QuoteStatus}; reconciliation assigns them from notifications and hedger\n * records.\n */\nexport enum QuoteLifecycle {\n  /** Submitted to a hedger; no on-chain quote and no fill report yet. */\n  OPTIMISTIC = \"optimistic\",\n  /** A hedger reported a fill price (`InstantRFQ` success) but the on-chain quote has not landed yet. */\n  PRICE_FILLED = \"price-filled\",\n  /**\n   * The open anchored on-chain per the notification (the `quoteId` is known), but\n   * the on-chain read has not returned the quote struct yet. The row is being\n   * \"written on-chain\": shown with its anchored id while the SDK waits for the RPC\n   * to confirm it. Resolves to {@link QuoteLifecycle.ONCHAIN} once the on-chain\n   * read returns the struct.\n   */\n  WRITE_ONCHAIN = \"write-onchain\",\n  /** Anchored on-chain; mirrors a real {@link QuoteStatus}. */\n  ONCHAIN = \"onchain\",\n  /**\n   * A close was just submitted and the hedger's pending-instant-close feed has it,\n   * but no close notification has confirmed a price yet — the close-side analog of\n   * {@link QuoteLifecycle.OPTIMISTIC}. Advances to {@link QuoteLifecycle.CLOSE_PRICE_FILLED}.\n   */\n  OPTIMISTIC_CLOSE = \"optimistic-close\",\n  /**\n   * A close notification reported the close price/fill request\n   * (`InstantRequestToClosePosition`) — the close-side analog of\n   * {@link QuoteLifecycle.PRICE_FILLED}. Advances to {@link QuoteLifecycle.WRITE_ONCHAIN_CLOSE}.\n   */\n  CLOSE_PRICE_FILLED = \"close-price-filled\",\n  /**\n   * The close fill (`FillMarketOrderInstantClose`) or the limit-close anchor\n   * (`InstantRequestToLimitClose`) was reported, or a pending instant-close\n   * overlays the row while the on-chain status still shows the position open — the\n   * close is being \"written on-chain\", awaiting the RPC. The close-side analog of\n   * {@link QuoteLifecycle.WRITE_ONCHAIN}. Resolves to {@link QuoteLifecycle.ONCHAIN}\n   * once the on-chain read returns the quote (now `CLOSE_PENDING`); read\n   * {@link UnifiedQuote.quoteStatus} to see the close is pending.\n   */\n  WRITE_ONCHAIN_CLOSE = \"write-onchain-close\",\n  /** The position is fully closed. */\n  CLOSED = \"closed\",\n  /** A hedger or notification reported the open/close failed. */\n  FAILED = \"failed\",\n}\n\n/**\n * A single quote/position row merged from every source (on-chain reads, pending\n * instant-opens, pending instant-closes, and notifications) into one stable,\n * de-duplicated shape.\n *\n * All amount and price fields are 18-decimal-wei `bigint`, matching the on-chain\n * {@link Quote}. Off-chain hedger amounts are normalized to wei before they reach\n * this type. The `key` is a stable identity for React lists and the removal\n * ledger; `raw` carries the untouched source rows for advanced use.\n */\nexport interface UnifiedQuote {\n  /** Stable identity for this row (`onchain:<id>` or `temp:<tempId>`). */\n  key: string;\n  /** Source the row was reconciled from. */\n  origin: QuoteOrigin;\n  /** Current lifecycle stage. */\n  lifecycle: QuoteLifecycle;\n  /** On-chain quote id, once anchored. */\n  quoteId?: bigint;\n  /** Hedger-local temp id, before the on-chain id exists. */\n  tempQuoteId?: number;\n  /** Sub-account (partyA) that owns the row. */\n  partyA: Address;\n  /** PartyB (hedger/solver) that locked/opened the quote, when known. */\n  partyB?: Address;\n  /** Solver-assigned Virtual Account address (lowcap), when known. */\n  vaAddress?: Address;\n  /** Market identifier (`symbolId`). */\n  symbolId: bigint;\n  /** Long or short. */\n  positionType: PositionType;\n  /** Limit or market order. */\n  orderType: OrderType;\n  /** On-chain status, when the row is anchored on-chain. */\n  quoteStatus?: QuoteStatus;\n  /** Price partyA requested to open at (wei). */\n  requestedOpenPrice: bigint;\n  /** Price partyB actually opened at (wei), when known. */\n  openedPrice?: bigint;\n  /** Initial price partyB opened at before any edits (wei), when known. */\n  initialOpenedPrice?: bigint;\n  /** Average price across executed closes (wei), when known. */\n  avgClosedPrice?: bigint;\n  /** Requested limit price for a pending close (wei), when known. */\n  requestedClosePrice?: bigint;\n  /** Market price snapshot at last state change (wei), when known. */\n  marketPrice?: bigint;\n  /** Total requested quantity (wei) — fixed for the life of the position; partial closes do not shrink it. */\n  quantity: bigint;\n  /** Quantity already closed (wei), when known. */\n  closedAmount?: bigint;\n  /**\n   * Remaining **open** size (wei): `quantity − closedAmount`, the live quantity\n   * still on the position (the figure a UI shows as \"position size\"); `0` once\n   * fully closed. Derived from the other amount fields by {@link quoteOpenQuantity}.\n   *\n   * A size, never a state: a quote that has not opened yet still reports its full\n   * `quantity`. To ask whether a row is a position, use `isPendingOrder` /\n   * `isActivePosition`, which read {@link UnifiedQuote.quoteStatus}.\n   */\n  openQuantity: bigint;\n  /** Quantity targeted by a pending close (wei), when closing. */\n  quantityToClose?: bigint;\n  /** Margin locked against the row (wei). */\n  lockedValues: LockedValues;\n  /** Margin locked at open time — basis for leverage (wei), when known. */\n  initialLockedValues?: LockedValues;\n  /** Maximum funding rate partyA accepts, when known. */\n  maxFundingRate?: bigint;\n  /**\n   * Per-unit cumulative funding-fee **index** recorded at the quote's last\n   * settlement (18-decimal fixed point, cost-positive), when known. **Not a\n   * currency amount**, so summing this field across quotes is meaningless:\n   * `openAmount × (currentFee − accumulatedPaidFunding) / 1e18` is the\n   * **pending**, not-yet-settled fee — read that with\n   * {@link getQuotePendingFunding}. For settled funding amounts use\n   * {@link getQuoteFunding} / {@link aggregateGroupFunding}.\n   */\n  accumulatedPaidFunding?: bigint;\n  /** Block timestamp funding was last applied, when known. */\n  lastFundingPaymentTimestamp?: bigint;\n  /** Quote deadline (expiry) timestamp, when known. */\n  deadline?: bigint;\n  /** Trading fee charged on the quote (wei), when known. */\n  tradingFee?: bigint;\n  /** Fee charged on close (wei), when known. */\n  closeFee?: bigint;\n  /** Affiliate address attributed to the quote, when known. */\n  affiliate?: Address;\n  /** PartyB addresses allowed to fill this quote (empty means any), when known. */\n  partyBsWhiteList?: readonly Address[];\n  /** Parent quote id for a partially-opened child, when known. */\n  parentId?: bigint;\n  /** Opaque per-quote data, when known. */\n  data?: Hex;\n  /** Block timestamp the quote was created, when known. */\n  createTimestamp?: bigint;\n  /** Block timestamp of the last status change (sort key), when known. */\n  statusModifyTimestamp?: bigint;\n  /** Untouched source rows this was reconciled from. */\n  raw: {\n    /** The on-chain quote, when the row is anchored. */\n    onchain?: Quote;\n    /** The pending instant-open record, when sourced off-chain. */\n    instantOpen?: PendingInstantOpen;\n    /** The pending instant-close record, when closing off-chain. */\n    instantClose?: PendingInstantClose;\n  };\n}\n"],"mappings":";AA2BA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,aAAA,cAEA,EAAA,eAAA,gBAQA,EAAA,gBAAA,iBAEA,EAAA,UAAA,WAMA,EAAA,mBAAA,oBAMA,EAAA,qBAAA,sBAUA,EAAA,sBAAA,uBAEA,EAAA,SAAA,UAEA,EAAA,SAAA;AACF,EAAA,CAAA,CAAA"}

package/dist/shared/errors/redact-url.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Strip the credential-bearing parts of a URL before it lands in an error: the
+ * userinfo, the query string and the fragment. What remains (scheme, host and
+ * path) still says where the request went.
+ *
+ * Works on the raw string, so a URL with nothing to strip comes back
+ * unchanged, and relative URLs (a same-origin proxy path) are handled too.
+ *
+ * @param url - Absolute, protocol-relative or relative request URL.
+ * @returns The URL without userinfo, query string or fragment.
+ *
+ * @internal
+ */
+export declare function redactUrl(url: string): string;
+//# sourceMappingURL=redact-url.d.ts.map

package/dist/shared/errors/redact-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact-url.d.ts","sourceRoot":"","sources":["../../../src/shared/errors/redact-url.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/shared/errors/redact-url.js

@@ -0,0 +1,9 @@
+//#region src/shared/errors/redact-url.ts
+var e = /^((?:[a-z][a-z\d+.-]*:)?\/\/)[^/?#]*@/i, t = /[?#].*$/s;
+function n(n) {
+	return n.replace(e, "$1").replace(t, "");
+}
+//#endregion
+export { n as redactUrl };
+
+//# sourceMappingURL=redact-url.js.map

package/dist/shared/errors/redact-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact-url.js","names":[],"sources":["../../../src/shared/errors/redact-url.ts"],"sourcesContent":["/**\n * Userinfo (`user:password@`) right after an absolute or protocol-relative\n * scheme. The authority stops at the first `/`, `?` or `#`; the greedy class\n * runs to the last `@` inside it, which is where the WHATWG parser splits the\n * userinfo from the host.\n */\nconst USERINFO = /^((?:[a-z][a-z\\d+.-]*:)?\\/\\/)[^/?#]*@/i;\n\n/** The query string and fragment: everything from the first `?` or `#`. */\nconst QUERY_AND_FRAGMENT = /[?#].*$/s;\n\n/**\n * Strip the credential-bearing parts of a URL before it lands in an error: the\n * userinfo, the query string and the fragment. What remains (scheme, host and\n * path) still says where the request went.\n *\n * Works on the raw string, so a URL with nothing to strip comes back\n * unchanged, and relative URLs (a same-origin proxy path) are handled too.\n *\n * @param url - Absolute, protocol-relative or relative request URL.\n * @returns The URL without userinfo, query string or fragment.\n *\n * @internal\n */\nexport function redactUrl(url: string): string {\n  return url.replace(USERINFO, \"$1\").replace(QUERY_AND_FRAGMENT, \"\");\n}\n"],"mappings":";AAMA,IAAM,IAAW,0CAGX,IAAqB;AAe3B,SAAgB,EAAU,GAAqB;CAC7C,OAAO,EAAI,QAAQ,GAAU,IAAI,EAAE,QAAQ,GAAoB,EAAE;AACnE"}

package/dist/shared/errors/retry-after.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parse an HTTP `Retry-After` value into a delay in milliseconds.
+ *
+ * Accepts both forms RFC 9110 §10.2.3 defines: delay-seconds (`"120"`) and an
+ * HTTP-date (`"Wed, 21 Oct 2026 07:28:00 GMT"`). A date is measured against
+ * `now` and clamps to `0` once it has passed. Anything else — a negative or
+ * fractional number, an unparseable date, a delay too large to be a safe
+ * integer of milliseconds — yields `null`.
+ *
+ * @param value - The raw header value, or `undefined` when the header is absent.
+ * @param now - Reference time in epoch ms for an HTTP-date. Defaults to `Date.now()`.
+ * @returns The delay in ms, or `null` when the header carries no usable value.
+ *
+ * @internal
+ */
+export declare function parseRetryAfterMs(value?: string, now?: number): number | null;
+//# sourceMappingURL=retry-after.d.ts.map

package/dist/shared/errors/retry-after.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.d.ts","sourceRoot":"","sources":["../../../src/shared/errors/retry-after.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAgBzF"}

package/dist/shared/errors/retry-after.js

@@ -0,0 +1,16 @@
+//#region src/shared/errors/retry-after.ts
+function e(e, t = Date.now()) {
+	let n = e?.trim();
+	if (!n) return null;
+	if (/^\d+$/.test(n)) {
+		let e = Number(n) * 1e3;
+		return Number.isSafeInteger(e) ? e : null;
+	}
+	if (!/[a-z]/i.test(n)) return null;
+	let r = Date.parse(n);
+	return Number.isNaN(r) ? null : Math.max(0, r - t);
+}
+//#endregion
+export { e as parseRetryAfterMs };
+
+//# sourceMappingURL=retry-after.js.map

package/dist/shared/errors/retry-after.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.js","names":[],"sources":["../../../src/shared/errors/retry-after.ts"],"sourcesContent":["/**\n * Parse an HTTP `Retry-After` value into a delay in milliseconds.\n *\n * Accepts both forms RFC 9110 §10.2.3 defines: delay-seconds (`\"120\"`) and an\n * HTTP-date (`\"Wed, 21 Oct 2026 07:28:00 GMT\"`). A date is measured against\n * `now` and clamps to `0` once it has passed. Anything else — a negative or\n * fractional number, an unparseable date, a delay too large to be a safe\n * integer of milliseconds — yields `null`.\n *\n * @param value - The raw header value, or `undefined` when the header is absent.\n * @param now - Reference time in epoch ms for an HTTP-date. Defaults to `Date.now()`.\n * @returns The delay in ms, or `null` when the header carries no usable value.\n *\n * @internal\n */\nexport function parseRetryAfterMs(value?: string, now: number = Date.now()): number | null {\n  const trimmed = value?.trim();\n  if (!trimmed) return null;\n\n  if (/^\\d+$/.test(trimmed)) {\n    const ms = Number(trimmed) * 1000;\n    return Number.isSafeInteger(ms) ? ms : null;\n  }\n\n  /**\n   * An HTTP-date always spells out a weekday or month. Without a letter the\n   * value is a malformed number, which `Date.parse` would happily read as a year.\n   */\n  if (!/[a-z]/i.test(trimmed)) return null;\n  const at = Date.parse(trimmed);\n  return Number.isNaN(at) ? null : Math.max(0, at - now);\n}\n"],"mappings":";AAeA,SAAgB,EAAkB,GAAgB,IAAc,KAAK,IAAI,GAAkB;CACzF,IAAM,IAAU,GAAO,KAAK;CAC5B,IAAI,CAAC,GAAS,OAAO;CAErB,IAAI,QAAQ,KAAK,CAAO,GAAG;EACzB,IAAM,IAAK,OAAO,CAAO,IAAI;EAC7B,OAAO,OAAO,cAAc,CAAE,IAAI,IAAK;CACzC;CAMA,IAAI,CAAC,SAAS,KAAK,CAAO,GAAG,OAAO;CACpC,IAAM,IAAK,KAAK,MAAM,CAAO;CAC7B,OAAO,OAAO,MAAM,CAAE,IAAI,OAAO,KAAK,IAAI,GAAG,IAAK,CAAG;AACvD"}

package/dist/shared/errors/sanitized-api-error.d.ts

@@ -0,0 +1,32 @@
+import { AxiosError } from 'axios';
+import { SymmApiError } from './symm-error.js';
+/**
+ * Build a {@link SymmApiError} from an axios error without keeping the request
+ * headers or body.
+ *
+ * {@link SymmApiError.fromAxios} keeps the axios error as `cause`, and that
+ * error's request config holds the request headers (an `Authorization` key)
+ * and the serialized body (signed payloads). This variant keeps every field
+ * `fromAxios` derives (`status`, `statusText`, `method`, `responseData`,
+ * `retryAfterMs`) but:
+ *
+ * - replaces `cause` with a sanitized `Error` carrying only the axios `name`,
+ *   `message` and `code`, plus the request's `status`, `method` and `url`;
+ * - strips userinfo, the query string and the fragment from `url`, from the
+ *   composed message and from the cause.
+ *
+ * `responseData` stays the raw response body. A server that echoes request
+ * input in its error body (a FastAPI `422` puts it in `detail[].input`) still
+ * exposes those values there.
+ *
+ * @param err - The axios error.
+ * @param options - The SDK error code and the request's base URL, as for `fromAxios`.
+ * @returns A `SymmApiError` whose `cause` holds no request headers or body.
+ *
+ * @internal
+ */
+export declare function toSanitizedApiError(err: AxiosError, options: {
+    code: string;
+    baseURL: string;
+}): SymmApiError;
+//# sourceMappingURL=sanitized-api-error.d.ts.map

package/dist/shared/errors/sanitized-api-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitized-api-error.d.ts","sourceRoot":"","sources":["../../../src/shared/errors/sanitized-api-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,EAAyB,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAe7G"}

package/dist/shared/errors/sanitized-api-error.js

@@ -0,0 +1,41 @@
+import { SymmApiError as e, formatApiErrorMessage as t } from "./symm-error.js";
+import { redactUrl as n } from "./redact-url.js";
+//#region src/shared/errors/sanitized-api-error.ts
+function r(r, a) {
+	let o = e.fromAxios(r, a), { code: s, status: c, statusText: l, method: u } = o, d = n(o.url);
+	return new e({
+		code: s,
+		message: t({
+			code: s,
+			message: r.message,
+			method: u,
+			url: d,
+			status: c,
+			statusText: l
+		}),
+		status: c,
+		statusText: l,
+		responseData: o.responseData,
+		url: d,
+		method: u,
+		retryAfterMs: o.retryAfterMs,
+		cause: i(r, {
+			status: c,
+			method: u,
+			url: d
+		})
+	});
+}
+function i(e, t) {
+	let n = Error(typeof e.message == "string" ? e.message : "");
+	return n.name = typeof e.name == "string" && e.name !== "" ? e.name : "AxiosError", Object.assign(n, {
+		...typeof e.code == "string" ? { code: e.code } : {},
+		status: t.status,
+		method: t.method,
+		url: t.url
+	});
+}
+//#endregion
+export { r as toSanitizedApiError };
+
+//# sourceMappingURL=sanitized-api-error.js.map

package/dist/shared/errors/sanitized-api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitized-api-error.js","names":[],"sources":["../../../src/shared/errors/sanitized-api-error.ts"],"sourcesContent":["import type { AxiosError } from \"axios\";\nimport { redactUrl } from \"./redact-url\";\nimport { formatApiErrorMessage, SymmApiError } from \"./symm-error\";\n\n/**\n * Build a {@link SymmApiError} from an axios error without keeping the request\n * headers or body.\n *\n * {@link SymmApiError.fromAxios} keeps the axios error as `cause`, and that\n * error's request config holds the request headers (an `Authorization` key)\n * and the serialized body (signed payloads). This variant keeps every field\n * `fromAxios` derives (`status`, `statusText`, `method`, `responseData`,\n * `retryAfterMs`) but:\n *\n * - replaces `cause` with a sanitized `Error` carrying only the axios `name`,\n *   `message` and `code`, plus the request's `status`, `method` and `url`;\n * - strips userinfo, the query string and the fragment from `url`, from the\n *   composed message and from the cause.\n *\n * `responseData` stays the raw response body. A server that echoes request\n * input in its error body (a FastAPI `422` puts it in `detail[].input`) still\n * exposes those values there.\n *\n * @param err - The axios error.\n * @param options - The SDK error code and the request's base URL, as for `fromAxios`.\n * @returns A `SymmApiError` whose `cause` holds no request headers or body.\n *\n * @internal\n */\nexport function toSanitizedApiError(err: AxiosError, options: { code: string; baseURL: string }): SymmApiError {\n  const error = SymmApiError.fromAxios(err, options);\n  const { code, status, statusText, method } = error;\n  const url = redactUrl(error.url);\n  return new SymmApiError({\n    code,\n    message: formatApiErrorMessage({ code, message: err.message, method, url, status, statusText }),\n    status,\n    statusText,\n    responseData: error.responseData,\n    url,\n    method,\n    retryAfterMs: error.retryAfterMs,\n    cause: toSanitizedHttpCause(err, { status, method, url }),\n  });\n}\n\n/**\n * A credential-free stand-in for an axios error, used as a sanitized\n * `SymmApiError`'s `cause`. It keeps what a log line needs (the axios `name`,\n * `message` and `code`, plus the request's `status`, `method` and\n * already-redacted `url`) and drops `config`, `request` and `response`, which\n * hold the request headers and body.\n */\nfunction toSanitizedHttpCause(err: AxiosError, request: { status: number; method: string; url: string }): Error {\n  const cause = new Error(typeof err.message === \"string\" ? err.message : \"\");\n  cause.name = typeof err.name === \"string\" && err.name !== \"\" ? err.name : \"AxiosError\";\n  return Object.assign(cause, {\n    ...(typeof err.code === \"string\" ? { code: err.code } : {}),\n    status: request.status,\n    method: request.method,\n    url: request.url,\n  });\n}\n"],"mappings":";;;AA6BA,SAAgB,EAAoB,GAAiB,GAA0D;CAC7G,IAAM,IAAQ,EAAa,UAAU,GAAK,CAAO,GAC3C,EAAE,SAAM,WAAQ,eAAY,cAAW,GACvC,IAAM,EAAU,EAAM,GAAG;CAC/B,OAAO,IAAI,EAAa;EACtB;EACA,SAAS,EAAsB;GAAE;GAAM,SAAS,EAAI;GAAS;GAAQ;GAAK;GAAQ;EAAW,CAAC;EAC9F;EACA;EACA,cAAc,EAAM;EACpB;EACA;EACA,cAAc,EAAM;EACpB,OAAO,EAAqB,GAAK;GAAE;GAAQ;GAAQ;EAAI,CAAC;CAC1D,CAAC;AACH;AASA,SAAS,EAAqB,GAAiB,GAAiE;CAC9G,IAAM,IAAY,MAAM,OAAO,EAAI,WAAY,WAAW,EAAI,UAAU,EAAE;CAE1E,OADA,EAAM,OAAO,OAAO,EAAI,QAAS,YAAY,EAAI,SAAS,KAAK,EAAI,OAAO,cACnE,OAAO,OAAO,GAAO;EAC1B,GAAI,OAAO,EAAI,QAAS,WAAW,EAAE,MAAM,EAAI,KAAK,IAAI,CAAC;EACzD,QAAQ,EAAQ;EAChB,QAAQ,EAAQ;EAChB,KAAK,EAAQ;CACf,CAAC;AACH"}

package/dist/shared/errors/symm-error.d.ts

@@ -48,6 +48,17 @@ export declare class SymmApiError extends SymmError {
     readonly url: string;
     /** HTTP method (e.g., "GET", "POST"). */
     readonly method: string;
+    /**
+     * How long the server asked the client to wait before retrying, in
+     * milliseconds, parsed from a `Retry-After` response header (delay-seconds or
+     * an HTTP-date). `null` when the response carried no usable header, or when
+     * there was no response at all.
+     *
+     * A cross-origin browser only sees `Retry-After` when the server lists it in
+     * `Access-Control-Expose-Headers`, so `null` means "unknown", not "retry
+     * immediately". Back off anyway, e.g. at least one second plus jitter.
+     */
+    readonly retryAfterMs: number | null;
     constructor(options: {
         code: string;
         message: string;
@@ -56,17 +67,24 @@ export declare class SymmApiError extends SymmError {
         responseData?: unknown;
         url: string;
         method: string;
+        /** Retry delay in ms from `Retry-After`. Defaults to `null`. */
+        retryAfterMs?: number | null;
         cause?: Error;
     });
     /**
      * Build a `SymmApiError` from an axios error.
      *
-     * Pulls `status`, `statusText`, `url`, `method`, and `responseData` off the
-     * axios error and keeps the original axios error as `cause`. The composed
-     * message is `"<code>: <axios message> (<METHOD> <URL> → <status> <statusText>)"`
-     * so a single log line carries the code, original message, and request
+     * Pulls `status`, `statusText`, `url`, `method`, `responseData` and
+     * `retryAfterMs` off the axios error and keeps the original axios error as
+     * `cause`. The composed message is
+     * `"<code>: <axios message> (<METHOD> <URL> → <status> <statusText>)"` so a
+     * single log line carries the code, original message, and request
      * coordinates.
      *
+     * The axios error keeps its request config, headers and body included, so
+     * redact `cause` before forwarding it to third-party logging when the request
+     * carried a credential.
+     *
      * Use inside an action's `catch` after re-throwing any pre-existing
      * `SymmError`:
      *
@@ -91,4 +109,21 @@ export declare class SymmApiError extends SymmError {
         baseURL: string;
     }): SymmApiError;
 }
+/**
+ * Compose the one-line message {@link SymmApiError.fromAxios} gives an HTTP
+ * failure: `"<code>: <message> (<METHOD> <URL> → <status> <statusText>)"`.
+ *
+ * @param parts - The SDK code, the transport's own message and the request coordinates.
+ * @returns The composed message.
+ *
+ * @internal
+ */
+export declare function formatApiErrorMessage(parts: {
+    code: string;
+    message: string;
+    method: string;
+    url: string;
+    status: number;
+    statusText: string;
+}): string;
 //# sourceMappingURL=symm-error.d.ts.map

package/dist/shared/errors/symm-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symm-error.d.ts","sourceRoot":"","sources":["../../../src/shared/errors/symm-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;AAE5D;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAkB,IAAI,EAAE,MAAM,CAAe;IAE7C,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKvF;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;IASD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,SAAS,CACd,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;QACP,kEAAkE;QAClE,IAAI,EAAE,MAAM,CAAC;QACb,gFAAgF;QAChF,OAAO,EAAE,MAAM,CAAC;KACjB,GACA,YAAY;CAiBhB"}
+{"version":3,"file":"symm-error.d.ts","sourceRoot":"","sources":["../../../src/shared/errors/symm-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIxC;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;AAE5D;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAkB,IAAI,EAAE,MAAM,CAAe;IAE7C,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKvF;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;;;;;OASG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEzB,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,gEAAgE;QAChE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;IAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,SAAS,CACd,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;QACP,kEAAkE;QAClE,IAAI,EAAE,MAAM,CAAC;QACb,gFAAgF;QAChF,OAAO,EAAE,MAAM,CAAC;KACjB,GACA,YAAY;CAkBhB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAET"}

package/dist/shared/errors/symm-error.js

@@ -1,35 +1,49 @@
+import { readHttpHeader as e } from "../utils/http-header.js";
+import { parseRetryAfterMs as t } from "./retry-after.js";
 //#region src/shared/errors/symm-error.ts
-var e = class extends Error {
+var n = class extends Error {
 	name = "SymmError";
 	kind;
 	code;
 	constructor(e, t, n, r) {
 		super(n, r), this.kind = e, this.code = t;
 	}
-}, t = class t extends e {
+}, r = class r extends n {
 	status;
 	statusText;
 	responseData;
 	url;
 	method;
+	retryAfterMs;
 	constructor(e) {
-		super("api", e.code, e.message, { cause: e.cause }), this.status = e.status, this.statusText = e.statusText, this.responseData = e.responseData, this.url = e.url, this.method = e.method;
+		super("api", e.code, e.message, { cause: e.cause }), this.status = e.status, this.statusText = e.statusText, this.responseData = e.responseData, this.url = e.url, this.method = e.method, this.retryAfterMs = e.retryAfterMs ?? null;
 	}
-	static fromAxios(e, n) {
-		let r = e.response?.status ?? 0, i = e.response?.statusText ?? "Unknown", a = e.config?.url ? `${n.baseURL}${e.config.url}` : n.baseURL, o = e.config?.method?.toUpperCase() ?? "GET";
-		return new t({
-			code: n.code,
-			message: `${n.code}: ${e.message} (${o} ${a} → ${r} ${i})`,
-			status: r,
-			statusText: i,
-			responseData: e.response?.data,
-			url: a,
-			method: o,
-			cause: e
+	static fromAxios(n, a) {
+		let o = n.response?.status ?? 0, s = n.response?.statusText ?? "Unknown", c = n.config?.url ? `${a.baseURL}${n.config.url}` : a.baseURL, l = n.config?.method?.toUpperCase() ?? "GET";
+		return new r({
+			code: a.code,
+			message: i({
+				code: a.code,
+				message: n.message,
+				method: l,
+				url: c,
+				status: o,
+				statusText: s
+			}),
+			status: o,
+			statusText: s,
+			responseData: n.response?.data,
+			url: c,
+			method: l,
+			retryAfterMs: t(e(n.response?.headers, "retry-after")),
+			cause: n
 		});
 	}
 };
+function i(e) {
+	return `${e.code}: ${e.message} (${e.method} ${e.url} → ${e.status} ${e.statusText})`;
+}
 //#endregion
-export { t as SymmApiError, e as SymmError };
+export { r as SymmApiError, n as SymmError, i as formatApiErrorMessage };
 
 //# sourceMappingURL=symm-error.js.map

package/dist/shared/errors/symm-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"symm-error.js","names":[],"sources":["../../../src/shared/errors/symm-error.ts"],"sourcesContent":["/**\n * Broad classification of SDK errors.\n *\n * - `config` — SDK configuration issues (missing chain, no wallet client).\n * - `api` — HTTP/REST API failures (solver, price service).\n * - `validation` — Input validation failures (missing required params).\n */\nexport type SymmErrorKind = \"config\" | \"api\" | \"validation\";\n\n/**\n * Base error class for SDK-level failures.\n *\n * Every SDK error includes:\n * - `kind` — broad category for error handling branches\n * - `code` — specific error identifier within that kind\n *\n * On-chain failures surface as viem errors and are not wrapped.\n */\nexport class SymmError extends Error {\n  override readonly name: string = \"SymmError\";\n\n  /** Broad classification (e.g., \"config\", \"api\", \"validation\"). */\n  readonly kind: SymmErrorKind;\n\n  /** Specific error identifier (e.g., \"UNSUPPORTED_CHAIN\", \"MISSING_USER\"). */\n  readonly code: string;\n\n  constructor(kind: SymmErrorKind, code: string, message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.kind = kind;\n    this.code = code;\n  }\n}\n\nimport type { AxiosError } from \"axios\";\n\n/**\n * Error class for HTTP/API failures from solver or other REST endpoints.\n *\n * Captures full request/response context for debugging and error handling.\n * Always has `kind: \"api\"`.\n */\nexport class SymmApiError extends SymmError {\n  /** HTTP status code (e.g., 400, 401, 500). */\n  readonly status: number;\n\n  /** HTTP status text (e.g., \"Bad Request\", \"Unauthorized\"). */\n  readonly statusText: string;\n\n  /**\n   * Raw response body from the server.\n   *\n   * For solver/hedger endpoints this is typically the documented\n   * `XfiberErrorResponse`-style payload: `{code?, error_category?,\n   * error_message?, error_detail?}`. Consumers cast it to the shape they expect\n   * and render whatever fields they care about.\n   */\n  readonly responseData: unknown;\n\n  /** Request URL that failed. */\n  readonly url: string;\n\n  /** HTTP method (e.g., \"GET\", \"POST\"). */\n  readonly method: string;\n\n  constructor(options: {\n    code: string;\n    message: string;\n    status: number;\n    statusText: string;\n    responseData?: unknown;\n    url: string;\n    method: string;\n    cause?: Error;\n  }) {\n    super(\"api\", options.code, options.message, { cause: options.cause });\n    this.status = options.status;\n    this.statusText = options.statusText;\n    this.responseData = options.responseData;\n    this.url = options.url;\n    this.method = options.method;\n  }\n\n  /**\n   * Build a `SymmApiError` from an axios error.\n   *\n   * Pulls `status`, `statusText`, `url`, `method`, and `responseData` off the\n   * axios error and keeps the original axios error as `cause`. The composed\n   * message is `\"<code>: <axios message> (<METHOD> <URL> → <status> <statusText>)\"`\n   * so a single log line carries the code, original message, and request\n   * coordinates.\n   *\n   * Use inside an action's `catch` after re-throwing any pre-existing\n   * `SymmError`:\n   *\n   * @example\n   * ```ts\n   * try {\n   *   const response = await getMarketsApi({ baseURL });\n   *   return response.data;\n   * } catch (err) {\n   *   if (err instanceof SymmError) throw err;\n   *   if (isAxiosError(err)) {\n   *     throw SymmApiError.fromAxios(err, { code: \"FETCH_MARKETS_FAILED\", baseURL });\n   *   }\n   *   throw new SymmError(\"api\", \"FETCH_MARKETS_FAILED\", `Failed to fetch markets: ${String(err)}`);\n   * }\n   * ```\n   */\n  static fromAxios(\n    err: AxiosError,\n    options: {\n      /** Specific error identifier (e.g., `\"FETCH_MARKETS_FAILED\"`). */\n      code: string;\n      /** Base URL of the request; combined with `err.config.url` for the full URL. */\n      baseURL: string;\n    },\n  ): SymmApiError {\n    const status = err.response?.status ?? 0;\n    const statusText = err.response?.statusText ?? \"Unknown\";\n    const url = err.config?.url ? `${options.baseURL}${err.config.url}` : options.baseURL;\n    const method = err.config?.method?.toUpperCase() ?? \"GET\";\n\n    return new SymmApiError({\n      code: options.code,\n      message: `${options.code}: ${err.message} (${method} ${url} → ${status} ${statusText})`,\n      status,\n      statusText,\n      responseData: err.response?.data,\n      url,\n      method,\n      cause: err,\n    });\n  }\n}\n"],"mappings":";AAkBA,IAAa,IAAb,cAA+B,MAAM;CACnC,OAAiC;CAGjC;CAGA;CAEA,YAAY,GAAqB,GAAc,GAAiB,GAAwB;EAGtF,AAFA,MAAM,GAAS,CAAO,GACtB,KAAK,OAAO,GACZ,KAAK,OAAO;CACd;AACF,GAUa,IAAb,MAAa,UAAqB,EAAU;CAE1C;CAGA;CAUA;CAGA;CAGA;CAEA,YAAY,GAST;EAMD,AALA,MAAM,OAAO,EAAQ,MAAM,EAAQ,SAAS,EAAE,OAAO,EAAQ,MAAM,CAAC,GACpE,KAAK,SAAS,EAAQ,QACtB,KAAK,aAAa,EAAQ,YAC1B,KAAK,eAAe,EAAQ,cAC5B,KAAK,MAAM,EAAQ,KACnB,KAAK,SAAS,EAAQ;CACxB;CA4BA,OAAO,UACL,GACA,GAMc;EACd,IAAM,IAAS,EAAI,UAAU,UAAU,GACjC,IAAa,EAAI,UAAU,cAAc,WACzC,IAAM,EAAI,QAAQ,MAAM,GAAG,EAAQ,UAAU,EAAI,OAAO,QAAQ,EAAQ,SACxE,IAAS,EAAI,QAAQ,QAAQ,YAAY,KAAK;EAEpD,OAAO,IAAI,EAAa;GACtB,MAAM,EAAQ;GACd,SAAS,GAAG,EAAQ,KAAK,IAAI,EAAI,QAAQ,IAAI,EAAO,GAAG,EAAI,KAAK,EAAO,GAAG,EAAW;GACrF;GACA;GACA,cAAc,EAAI,UAAU;GAC5B;GACA;GACA,OAAO;EACT,CAAC;CACH;AACF"}
+{"version":3,"file":"symm-error.js","names":[],"sources":["../../../src/shared/errors/symm-error.ts"],"sourcesContent":["import type { AxiosError } from \"axios\";\nimport { readHttpHeader } from \"../utils/http-header\";\nimport { parseRetryAfterMs } from \"./retry-after\";\n\n/**\n * Broad classification of SDK errors.\n *\n * - `config` — SDK configuration issues (missing chain, no wallet client).\n * - `api` — HTTP/REST API failures (solver, price service).\n * - `validation` — Input validation failures (missing required params).\n */\nexport type SymmErrorKind = \"config\" | \"api\" | \"validation\";\n\n/**\n * Base error class for SDK-level failures.\n *\n * Every SDK error includes:\n * - `kind` — broad category for error handling branches\n * - `code` — specific error identifier within that kind\n *\n * On-chain failures surface as viem errors and are not wrapped.\n */\nexport class SymmError extends Error {\n  override readonly name: string = \"SymmError\";\n\n  /** Broad classification (e.g., \"config\", \"api\", \"validation\"). */\n  readonly kind: SymmErrorKind;\n\n  /** Specific error identifier (e.g., \"UNSUPPORTED_CHAIN\", \"MISSING_USER\"). */\n  readonly code: string;\n\n  constructor(kind: SymmErrorKind, code: string, message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.kind = kind;\n    this.code = code;\n  }\n}\n\n/**\n * Error class for HTTP/API failures from solver or other REST endpoints.\n *\n * Captures full request/response context for debugging and error handling.\n * Always has `kind: \"api\"`.\n */\nexport class SymmApiError extends SymmError {\n  /** HTTP status code (e.g., 400, 401, 500). */\n  readonly status: number;\n\n  /** HTTP status text (e.g., \"Bad Request\", \"Unauthorized\"). */\n  readonly statusText: string;\n\n  /**\n   * Raw response body from the server.\n   *\n   * For solver/hedger endpoints this is typically the documented\n   * `XfiberErrorResponse`-style payload: `{code?, error_category?,\n   * error_message?, error_detail?}`. Consumers cast it to the shape they expect\n   * and render whatever fields they care about.\n   */\n  readonly responseData: unknown;\n\n  /** Request URL that failed. */\n  readonly url: string;\n\n  /** HTTP method (e.g., \"GET\", \"POST\"). */\n  readonly method: string;\n\n  /**\n   * How long the server asked the client to wait before retrying, in\n   * milliseconds, parsed from a `Retry-After` response header (delay-seconds or\n   * an HTTP-date). `null` when the response carried no usable header, or when\n   * there was no response at all.\n   *\n   * A cross-origin browser only sees `Retry-After` when the server lists it in\n   * `Access-Control-Expose-Headers`, so `null` means \"unknown\", not \"retry\n   * immediately\". Back off anyway, e.g. at least one second plus jitter.\n   */\n  readonly retryAfterMs: number | null;\n\n  constructor(options: {\n    code: string;\n    message: string;\n    status: number;\n    statusText: string;\n    responseData?: unknown;\n    url: string;\n    method: string;\n    /** Retry delay in ms from `Retry-After`. Defaults to `null`. */\n    retryAfterMs?: number | null;\n    cause?: Error;\n  }) {\n    super(\"api\", options.code, options.message, { cause: options.cause });\n    this.status = options.status;\n    this.statusText = options.statusText;\n    this.responseData = options.responseData;\n    this.url = options.url;\n    this.method = options.method;\n    this.retryAfterMs = options.retryAfterMs ?? null;\n  }\n\n  /**\n   * Build a `SymmApiError` from an axios error.\n   *\n   * Pulls `status`, `statusText`, `url`, `method`, `responseData` and\n   * `retryAfterMs` off the axios error and keeps the original axios error as\n   * `cause`. The composed message is\n   * `\"<code>: <axios message> (<METHOD> <URL> → <status> <statusText>)\"` so a\n   * single log line carries the code, original message, and request\n   * coordinates.\n   *\n   * The axios error keeps its request config, headers and body included, so\n   * redact `cause` before forwarding it to third-party logging when the request\n   * carried a credential.\n   *\n   * Use inside an action's `catch` after re-throwing any pre-existing\n   * `SymmError`:\n   *\n   * @example\n   * ```ts\n   * try {\n   *   const response = await getMarketsApi({ baseURL });\n   *   return response.data;\n   * } catch (err) {\n   *   if (err instanceof SymmError) throw err;\n   *   if (isAxiosError(err)) {\n   *     throw SymmApiError.fromAxios(err, { code: \"FETCH_MARKETS_FAILED\", baseURL });\n   *   }\n   *   throw new SymmError(\"api\", \"FETCH_MARKETS_FAILED\", `Failed to fetch markets: ${String(err)}`);\n   * }\n   * ```\n   */\n  static fromAxios(\n    err: AxiosError,\n    options: {\n      /** Specific error identifier (e.g., `\"FETCH_MARKETS_FAILED\"`). */\n      code: string;\n      /** Base URL of the request; combined with `err.config.url` for the full URL. */\n      baseURL: string;\n    },\n  ): SymmApiError {\n    const status = err.response?.status ?? 0;\n    const statusText = err.response?.statusText ?? \"Unknown\";\n    const url = err.config?.url ? `${options.baseURL}${err.config.url}` : options.baseURL;\n    const method = err.config?.method?.toUpperCase() ?? \"GET\";\n\n    return new SymmApiError({\n      code: options.code,\n      message: formatApiErrorMessage({ code: options.code, message: err.message, method, url, status, statusText }),\n      status,\n      statusText,\n      responseData: err.response?.data,\n      url,\n      method,\n      retryAfterMs: parseRetryAfterMs(readHttpHeader(err.response?.headers, \"retry-after\")),\n      cause: err,\n    });\n  }\n}\n\n/**\n * Compose the one-line message {@link SymmApiError.fromAxios} gives an HTTP\n * failure: `\"<code>: <message> (<METHOD> <URL> → <status> <statusText>)\"`.\n *\n * @param parts - The SDK code, the transport's own message and the request coordinates.\n * @returns The composed message.\n *\n * @internal\n */\nexport function formatApiErrorMessage(parts: {\n  code: string;\n  message: string;\n  method: string;\n  url: string;\n  status: number;\n  statusText: string;\n}): string {\n  return `${parts.code}: ${parts.message} (${parts.method} ${parts.url} → ${parts.status} ${parts.statusText})`;\n}\n"],"mappings":";;;AAsBA,IAAa,IAAb,cAA+B,MAAM;CACnC,OAAiC;CAGjC;CAGA;CAEA,YAAY,GAAqB,GAAc,GAAiB,GAAwB;EAGtF,AAFA,MAAM,GAAS,CAAO,GACtB,KAAK,OAAO,GACZ,KAAK,OAAO;CACd;AACF,GAQa,IAAb,MAAa,UAAqB,EAAU;CAE1C;CAGA;CAUA;CAGA;CAGA;CAYA;CAEA,YAAY,GAWT;EAOD,AANA,MAAM,OAAO,EAAQ,MAAM,EAAQ,SAAS,EAAE,OAAO,EAAQ,MAAM,CAAC,GACpE,KAAK,SAAS,EAAQ,QACtB,KAAK,aAAa,EAAQ,YAC1B,KAAK,eAAe,EAAQ,cAC5B,KAAK,MAAM,EAAQ,KACnB,KAAK,SAAS,EAAQ,QACtB,KAAK,eAAe,EAAQ,gBAAgB;CAC9C;CAiCA,OAAO,UACL,GACA,GAMc;EACd,IAAM,IAAS,EAAI,UAAU,UAAU,GACjC,IAAa,EAAI,UAAU,cAAc,WACzC,IAAM,EAAI,QAAQ,MAAM,GAAG,EAAQ,UAAU,EAAI,OAAO,QAAQ,EAAQ,SACxE,IAAS,EAAI,QAAQ,QAAQ,YAAY,KAAK;EAEpD,OAAO,IAAI,EAAa;GACtB,MAAM,EAAQ;GACd,SAAS,EAAsB;IAAE,MAAM,EAAQ;IAAM,SAAS,EAAI;IAAS;IAAQ;IAAK;IAAQ;GAAW,CAAC;GAC5G;GACA;GACA,cAAc,EAAI,UAAU;GAC5B;GACA;GACA,cAAc,EAAkB,EAAe,EAAI,UAAU,SAAS,aAAa,CAAC;GACpF,OAAO;EACT,CAAC;CACH;AACF;AAWA,SAAgB,EAAsB,GAO3B;CACT,OAAO,GAAG,EAAM,KAAK,IAAI,EAAM,QAAQ,IAAI,EAAM,OAAO,GAAG,EAAM,IAAI,KAAK,EAAM,OAAO,GAAG,EAAM,WAAW;AAC7G"}