@symmio/trading-core 1.1.0 → 3.0.0

package/dist/quotes/reconcile-quotes.js.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile-quotes.js","names":[],"sources":["../../src/quotes/reconcile-quotes.ts"],"sourcesContent":["import type { Address } 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/to-pending-instant-open\";\nimport type { Quote } from \"../symmio-contracts/symmio/types\";\nimport type { Notification } from \"../websocket/notifications/types\";\nimport { applyNotificationToQuotes } from \"./apply-notification\";\nimport { fingerprintQuote } from \"./fingerprint\";\nimport { toUnifiedQuoteFromInstantOpen, toUnifiedQuoteFromOnchain } from \"./to-unified-quote\";\nimport { QuoteLifecycle, type UnifiedQuote } from \"./unified-quote\";\n\n/**\n * Inputs to {@link reconcileQuotes}: one snapshot of every quote source. The\n * result is \"active quotes only\" — a quote appears in the output iff it is\n * present in at least one of these sources this tick.\n */\nexport interface ReconcileQuotesInput {\n  /** Sub-account (partyA) the snapshot belongs to. */\n  partyA: Address;\n  /** On-chain open positions (`getPartyAOpenPositions`). */\n  onchainPositions: readonly Quote[];\n  /** On-chain pending quotes hydrated via `getQuote`. */\n  onchainPendingQuotes: readonly Quote[];\n  /** Pending instant-open records from the hedger. */\n  instantOpens: readonly PendingInstantOpen[];\n  /** Pending instant-close records from the hedger. */\n  instantCloses: readonly PendingInstantClose[];\n  /**\n   * Map from a pending instant-open's `tempQuoteId` to the Virtual Account (VA)\n   * address its position will land in (from `resolveQuoteAccounts`). When a temp\n   * id is present here, the optimistic row is stamped with its eventual VA so the\n   * UI can show the VA before the trade anchors on-chain.\n   */\n  instantOpenVaByTempId?: Record<number, Address>;\n  /** Notifications to apply after the merge, in arrival order. */\n  notifications?: readonly Notification[];\n  /**\n   * Rows that anchored on-chain on a prior tick (a notification set their\n   * `quoteId`) but whose on-chain struct has not been read yet — the\n   * `pendingAnchors` returned by the previous {@link reconcileQuotes} call. The\n   * consumer feeds them back so an anchored row survives the gap between \"the\n   * hedger drops the pending open\" and \"the on-chain read returns the quote\"\n   * instead of vanishing for a tick. Each is dropped automatically once the\n   * matching on-chain read arrives (its `key` is already populated with the real\n   * struct, so the retained copy is ignored).\n   */\n  retainedAnchors?: readonly UnifiedQuote[];\n}\n\n/** Output of {@link reconcileQuotes}: the merged rows plus the temp ↔ on-chain links. */\nexport interface ReconcileQuotesResult {\n  /** Merged, de-duplicated, lifecycle-tagged rows, newest first. */\n  quotes: UnifiedQuote[];\n  /**\n   * Map from `tempQuoteId` to the on-chain row `key` it resolved to, recorded\n   * **only once the row has anchored on-chain** (`quoteId` present). A\n   * still-optimistic temp id is absent until then, so consumers can use this to\n   * clear an optimistic seed exactly when its on-chain twin exists.\n   */\n  links: Record<number, string>;\n  /**\n   * Rows currently in {@link QuoteLifecycle.WRITE_ONCHAIN} — anchored per a\n   * notification but not yet returned by the on-chain read. The consumer retains\n   * these and feeds them back as {@link ReconcileQuotesInput.retainedAnchors} on\n   * the next tick so they do not flicker out while the RPC catches up.\n   */\n  pendingAnchors: UnifiedQuote[];\n}\n\n/**\n * Merge every quote source for a sub-account into one stable, de-duplicated,\n * lifecycle-tagged list — **active quotes only**: a quote appears iff it is in at\n * least one source this tick, so a quote that has left every source is simply\n * absent (no lingering \"removed\" rows). **Pure** and stateless: given the same\n * `input` it always returns the same result, reading no clock and no randomness.\n *\n * Pipeline:\n *\n * 1. On-chain positions + pending quotes become anchored rows; `retainedAnchors`\n *    re-seed any anchored-but-not-yet-read row so it does not flicker out.\n * 2. Pending instant-closes overlay the matching on-chain row — `CLOSING` once the\n *    on-chain status shows the close pending, else `WRITE_ONCHAIN_CLOSE`.\n * 3. Pending instant-opens become `OPTIMISTIC` rows, **dropped** when an on-chain\n *    row already carries the same {@link fingerprintQuote} (the trade landed).\n * 4. Notifications are applied in order to link temp ↔ on-chain ids and advance\n *    lifecycles (an anchored-but-unread row sits at `WRITE_ONCHAIN`); `collapseByKey`\n *    then merges a rekeyed optimistic row into its on-chain twin, so the off-chain\n *    row drops once on-chain.\n * 5. Rows are sorted by `statusModifyTimestamp` descending (newest first), and the\n *    `WRITE_ONCHAIN` rows are returned as `pendingAnchors` for the next tick.\n *\n * @param input - One snapshot of all sources.\n * @returns The merged rows plus the temp ↔ on-chain `links`.\n *\n * @example\n * ```ts\n * const { quotes } = reconcileQuotes({\n *   partyA,\n *   onchainPositions,\n *   onchainPendingQuotes,\n *   instantOpens,\n *   instantCloses,\n *   notifications,\n * });\n * ```\n */\nexport function reconcileQuotes(input: ReconcileQuotesInput): ReconcileQuotesResult {\n  const byKey = new Map<string, UnifiedQuote>();\n\n  for (const quote of input.onchainPositions) {\n    const row = withVaAddress(toUnifiedQuoteFromOnchain(quote), input.partyA);\n    byKey.set(row.key, row);\n  }\n  for (const quote of input.onchainPendingQuotes) {\n    const row = withVaAddress(toUnifiedQuoteFromOnchain(quote), input.partyA);\n    if (!byKey.has(row.key)) byKey.set(row.key, row);\n  }\n  /**\n   * Re-seed rows that anchored on a prior tick but have no on-chain struct yet, so\n   * they survive the hedger-drop → on-chain-read gap. Skipped the moment the real\n   * on-chain read populates the same `key` (inserted above), so retention ends\n   * itself once the RPC confirms.\n   */\n  for (const anchor of input.retainedAnchors ?? []) {\n    if (!byKey.has(anchor.key)) byKey.set(anchor.key, anchor);\n  }\n  for (const close of input.instantCloses) {\n    const key = `onchain:${close.quoteId}`;\n    const existing = byKey.get(key);\n    /**\n     * An instant-close always references a quote that already exists on-chain, so\n     * we only overlay the close onto its matching row. If the on-chain row has not\n     * loaded yet we skip it rather than synthesize a placeholder with no market or\n     * side; the overlay applies on the next tick once the position read catches up.\n     */\n    if (!existing) continue;\n    byKey.set(key, {\n      ...existing,\n      lifecycle: overlayCloseLifecycle(existing),\n      quantityToClose: close.quantityToClose,\n      raw: { ...existing.raw, instantClose: close },\n    });\n  }\n\n  const onchainFingerprints = new Set<string>();\n\n  for (const row of byKey.values()) {\n    if (row.origin === \"onchain\") onchainFingerprints.add(fingerprintQuote(row));\n  }\n  for (const open of input.instantOpens) {\n    const row = toUnifiedQuoteFromInstantOpen(open);\n    if (onchainFingerprints.has(fingerprintQuote(row))) continue;\n    const vaAddress = input.instantOpenVaByTempId?.[open.tempQuoteId];\n    if (vaAddress) row.vaAddress = vaAddress;\n    if (!byKey.has(row.key)) byKey.set(row.key, row);\n  }\n  let merged = [...byKey.values()];\n  for (const notification of input.notifications ?? []) {\n    merged = applyNotificationToQuotes(merged, notification);\n  }\n  merged = collapseByKey(merged);\n  merged.sort((a, b) => {\n    const aTs = a.statusModifyTimestamp ?? 0n;\n    const bTs = b.statusModifyTimestamp ?? 0n;\n    if (aTs !== bTs) return aTs > bTs ? -1 : 1;\n    const aId = stableSortKey(a);\n    const bId = stableSortKey(b);\n    if (aId !== bId) return aId > bId ? -1 : 1;\n    return 0;\n  });\n  const links: Record<number, string> = {};\n  for (const row of merged) {\n    /**\n     * Only record a temp ↔ on-chain link once the row has actually anchored\n     * (`quoteId` set). A still-optimistic row carries only its own `temp:` key —\n     * recording that as a \"link\" would let the consumer clear its optimistic seed\n     * before the on-chain twin exists, dropping the row for a tick (the\n     * appear→disappear→reappear flicker).\n     */\n    if (row.tempQuoteId !== undefined && row.quoteId !== undefined) links[row.tempQuoteId] = row.key;\n  }\n  const pendingAnchors = merged.filter((row) => row.lifecycle === QuoteLifecycle.WRITE_ONCHAIN);\n  return { quotes: merged, links, pendingAnchors };\n}\n\n/**\n * Lifecycle for an on-chain row that a pending instant-close overlays. Keep a\n * terminal `CLOSED` as-is; keep `CLOSING` when the on-chain status already shows\n * the close pending; otherwise the close is in-flight but the read still shows the\n * position open — surface {@link QuoteLifecycle.OPTIMISTIC_CLOSE} as the base close\n * stage. Close notifications (applied after this overlay) then advance it to\n * `CLOSE_PRICE_FILLED` → `WRITE_ONCHAIN_CLOSE`; the poll moves it to `CLOSING` once\n * the on-chain status reflects the pending close.\n */\nfunction overlayCloseLifecycle(existing: UnifiedQuote): QuoteLifecycle {\n  if (existing.lifecycle === QuoteLifecycle.CLOSED) return QuoteLifecycle.CLOSED;\n  if (existing.lifecycle === QuoteLifecycle.CLOSING) return QuoteLifecycle.CLOSING;\n  return QuoteLifecycle.OPTIMISTIC_CLOSE;\n}\n\n/**\n * Collapse rows that ended up sharing a `key` after a notification rekeyed an\n * optimistic row (`temp:<id>` → `onchain:<id>`) onto an on-chain twin the poll\n * already returned. Without this the same quote can appear twice — once from the\n * poll and once from the rekeyed optimistic row — yielding duplicate React keys.\n * The genuine on-chain row (the one carrying `raw.onchain`) wins; the optimistic\n * row's `tempQuoteId` / `raw.instantOpen` are grafted on so the temp ↔ on-chain\n * link survives and the optimistic entry can be cleared.\n */\nfunction collapseByKey(rows: UnifiedQuote[]): UnifiedQuote[] {\n  const byKey = new Map<string, UnifiedQuote>();\n  for (const row of rows) {\n    const existing = byKey.get(row.key);\n    byKey.set(row.key, existing ? mergeDuplicateRows(existing, row) : row);\n  }\n  return [...byKey.values()];\n}\n\n/**\n * Merge two rows that resolved to the same `key`, preferring the one that carries\n * the polled on-chain struct and grafting the off-chain identifiers from the other.\n */\nfunction mergeDuplicateRows(a: UnifiedQuote, b: UnifiedQuote): UnifiedQuote {\n  const primary = a.raw.onchain ? a : b;\n  const secondary = primary === a ? b : a;\n  return {\n    ...primary,\n    tempQuoteId: primary.tempQuoteId ?? secondary.tempQuoteId,\n    vaAddress: primary.vaAddress ?? secondary.vaAddress,\n    openedPrice: primary.openedPrice ?? secondary.openedPrice,\n    avgClosedPrice: primary.avgClosedPrice ?? secondary.avgClosedPrice,\n    quantityToClose: primary.quantityToClose ?? secondary.quantityToClose,\n    raw: { ...secondary.raw, ...primary.raw },\n  };\n}\n\n/**\n * Stamp the row's Virtual Account on `vaAddress` when it was read from a VA — in\n * lowcap a VA-scoped position's `partyA` IS its VA, so when the row's `partyA`\n * differs from the sub-account being reconciled we surface it on the dedicated\n * `vaAddress` field for the consumer.\n */\nfunction withVaAddress(row: UnifiedQuote, subAccount: Address): UnifiedQuote {\n  if (row.partyA.toLowerCase() === subAccount.toLowerCase()) return row;\n  return { ...row, vaAddress: row.partyA };\n}\n\n/**\n * Deterministic tiebreak key for rows that share a `statusModifyTimestamp`: the\n * on-chain quote id when anchored, else the (negative) temp id. Keeps the sort\n * order reproducible regardless of the unstable on-chain read order — the\n * contract stores positions with swap-and-pop, so the raw read order reshuffles\n * on every open/close.\n */\nfunction stableSortKey(quote: UnifiedQuote): bigint {\n  if (quote.quoteId !== undefined) return quote.quoteId;\n  if (quote.tempQuoteId !== undefined) return BigInt(quote.tempQuoteId);\n  return 0n;\n}\n"],"mappings":"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"}
+{"version":3,"file":"reconcile-quotes.js","names":[],"sources":["../../src/quotes/reconcile-quotes.ts"],"sourcesContent":["import type { Address } 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 { QuoteStatus, type Quote } from \"../symmio-contracts/symmio/types\";\nimport type { Notification } from \"../websocket/notifications/types\";\nimport { applyNotificationToQuotes } from \"./apply-notification\";\nimport { fingerprintQuote } from \"./fingerprint\";\nimport { toUnifiedQuoteFromInstantOpen, toUnifiedQuoteFromOnchain } from \"./to-unified-quote\";\nimport { QuoteLifecycle, type UnifiedQuote } from \"./unified-quote\";\n\n/**\n * Inputs to {@link reconcileQuotes}: one snapshot of every quote source. The\n * result is \"active quotes only\" — a quote appears in the output iff it is\n * present in at least one of these sources this tick.\n */\nexport interface ReconcileQuotesInput {\n  /** Sub-account (partyA) the snapshot belongs to. */\n  partyA: Address;\n  /** On-chain open positions (`getPartyAOpenPositions`). */\n  onchainPositions: readonly Quote[];\n  /** On-chain pending quotes hydrated via `getQuote`. */\n  onchainPendingQuotes: readonly Quote[];\n  /** Pending instant-open records from the hedger. */\n  instantOpens: readonly PendingInstantOpen[];\n  /** Pending instant-close records from the hedger. */\n  instantCloses: readonly PendingInstantClose[];\n  /**\n   * Map from a pending instant-open's `tempQuoteId` to the Virtual Account (VA)\n   * address its position will land in (from `resolveQuoteAccounts`). When a temp\n   * id is present here, the optimistic row is stamped with its eventual VA so the\n   * UI can show the VA before the trade anchors on-chain.\n   */\n  instantOpenVaByTempId?: Record<number, Address>;\n  /** Notifications to apply after the merge, in arrival order. */\n  notifications?: readonly Notification[];\n  /**\n   * Rows that anchored on-chain on a prior tick (a notification set their\n   * `quoteId`) but whose on-chain struct has not been read yet — the\n   * `pendingAnchors` returned by the previous {@link reconcileQuotes} call. The\n   * consumer feeds them back so an anchored row survives the gap between \"the\n   * hedger drops the pending open\" and \"the on-chain read returns the quote\"\n   * instead of vanishing for a tick. Each is dropped automatically once the\n   * matching on-chain read arrives (its `key` is already populated with the real\n   * struct, so the retained copy is ignored).\n   */\n  retainedAnchors?: readonly UnifiedQuote[];\n  /**\n   * On-chain quote ids (decimal strings) whose close is **in flight** — filled\n   * off-chain but not yet reflected by the on-chain read. The close-side mirror\n   * of {@link retainedAnchors}: the poll rebuilds a filled-but-unsettled close as\n   * `ONCHAIN` (`OPENED`) every tick, and a replayed close notification cannot\n   * restore the stage on a poll-confirmed row (apply-notification's `inClosingFlow`\n   * guard), so a row still read `OPENED` whose id is here is held at\n   * {@link QuoteLifecycle.WRITE_ONCHAIN_CLOSE}. The caller bounds the set with its\n   * close-confirm hold, so it clears at `CLOSE_PENDING` / removal / budget.\n   */\n  closingQuoteIds?: readonly string[];\n}\n\n/** Output of {@link reconcileQuotes}: the merged rows plus the temp ↔ on-chain links. */\nexport interface ReconcileQuotesResult {\n  /** Merged, de-duplicated, lifecycle-tagged rows, newest first. */\n  quotes: UnifiedQuote[];\n  /**\n   * Map from `tempQuoteId` to the on-chain row `key` it resolved to, recorded\n   * **only once the row has anchored on-chain** (`quoteId` present). A\n   * still-optimistic temp id is absent until then, so consumers can use this to\n   * clear an optimistic seed exactly when its on-chain twin exists.\n   */\n  links: Record<number, string>;\n  /**\n   * Rows currently in {@link QuoteLifecycle.WRITE_ONCHAIN} — anchored per a\n   * notification but not yet returned by the on-chain read. The consumer retains\n   * these and feeds them back as {@link ReconcileQuotesInput.retainedAnchors} on\n   * the next tick so they do not flicker out while the RPC catches up.\n   */\n  pendingAnchors: UnifiedQuote[];\n}\n\n/**\n * Merge every quote source for a sub-account into one stable, de-duplicated,\n * lifecycle-tagged list — **active quotes only**: a quote appears iff it is in at\n * least one source this tick, so a quote that has left every source is simply\n * absent (no lingering \"removed\" rows). **Pure** and stateless: given the same\n * `input` it always returns the same result, reading no clock and no randomness.\n *\n * Pipeline:\n *\n * 1. On-chain positions + pending quotes become anchored rows; `retainedAnchors`\n *    re-seed any anchored-but-not-yet-read row so it does not flicker out.\n * 2. Pending instant-closes overlay the matching on-chain row — `CLOSING` once the\n *    on-chain status shows the close pending, else `WRITE_ONCHAIN_CLOSE`.\n * 3. Pending instant-opens become `OPTIMISTIC` rows, **dropped** when an on-chain\n *    row already carries the same {@link fingerprintQuote} (the trade landed).\n * 4. Notifications are applied in order to link temp ↔ on-chain ids and advance\n *    lifecycles (an anchored-but-unread row sits at `WRITE_ONCHAIN`); `collapseByKey`\n *    then merges a rekeyed optimistic row into its on-chain twin, so the off-chain\n *    row drops once on-chain.\n * 5. Rows are sorted by `statusModifyTimestamp` descending (newest first), and the\n *    `WRITE_ONCHAIN` rows are returned as `pendingAnchors` for the next tick.\n *\n * @param input - One snapshot of all sources.\n * @returns The merged rows plus the temp ↔ on-chain `links`.\n *\n * @example\n * ```ts\n * const { quotes } = reconcileQuotes({\n *   partyA,\n *   onchainPositions,\n *   onchainPendingQuotes,\n *   instantOpens,\n *   instantCloses,\n *   notifications,\n * });\n * ```\n */\nexport function reconcileQuotes(input: ReconcileQuotesInput): ReconcileQuotesResult {\n  const byKey = new Map<string, UnifiedQuote>();\n\n  for (const quote of input.onchainPositions) {\n    const row = withVaAddress(toUnifiedQuoteFromOnchain(quote), input.partyA);\n    byKey.set(row.key, row);\n  }\n  for (const quote of input.onchainPendingQuotes) {\n    const row = withVaAddress(toUnifiedQuoteFromOnchain(quote), input.partyA);\n    if (!byKey.has(row.key)) byKey.set(row.key, row);\n  }\n  /**\n   * Re-seed rows that anchored on a prior tick but have no on-chain struct yet, so\n   * they survive the hedger-drop → on-chain-read gap. Skipped the moment the real\n   * on-chain read populates the same `key` (inserted above), so retention ends\n   * itself once the RPC confirms.\n   */\n  for (const anchor of input.retainedAnchors ?? []) {\n    if (!byKey.has(anchor.key)) byKey.set(anchor.key, anchor);\n  }\n  for (const close of input.instantCloses) {\n    const key = `onchain:${close.quoteId}`;\n    const existing = byKey.get(key);\n    /**\n     * An instant-close always references a quote that already exists on-chain, so\n     * we only overlay the close onto its matching row. If the on-chain row has not\n     * loaded yet we skip it rather than synthesize a placeholder with no market or\n     * side; the overlay applies on the next tick once the position read catches up.\n     */\n    if (!existing) continue;\n    byKey.set(key, {\n      ...existing,\n      lifecycle: overlayCloseLifecycle(existing),\n      quantityToClose: close.quantityToClose,\n      raw: { ...existing.raw, instantClose: close },\n    });\n  }\n\n  const onchainFingerprints = new Set<string>();\n\n  for (const row of byKey.values()) {\n    if (row.origin === \"onchain\") onchainFingerprints.add(fingerprintQuote(row));\n  }\n  for (const open of input.instantOpens) {\n    const row = toUnifiedQuoteFromInstantOpen(open);\n    if (onchainFingerprints.has(fingerprintQuote(row))) continue;\n    const vaAddress = input.instantOpenVaByTempId?.[open.tempQuoteId];\n    if (vaAddress) row.vaAddress = vaAddress;\n    if (!byKey.has(row.key)) byKey.set(row.key, row);\n  }\n  let merged = [...byKey.values()];\n  for (const notification of input.notifications ?? []) {\n    merged = applyNotificationToQuotes(merged, notification);\n  }\n  merged = collapseByKey(merged);\n  /**\n   * Close-side retention (mirror of `retainedAnchors`). A close that filled\n   * off-chain sits at `WRITE_ONCHAIN_CLOSE`, but the poll keeps reading the quote\n   * `OPENED` until the settle mines and rebuilds the row as `ONCHAIN` — and the\n   * replayed close notification cannot restore the stage on that poll-confirmed\n   * row (`applyNotificationToQuotes`' `inClosingFlow` guard). So a still-`OPENED`\n   * row whose close the caller is chasing is held at `WRITE_ONCHAIN_CLOSE` until\n   * the chain reflects the close (`CLOSE_PENDING` / removed) or the caller drops it.\n   */\n  if (input.closingQuoteIds?.length) {\n    const closing = new Set(input.closingQuoteIds);\n    merged = merged.map((row) =>\n      row.quoteId !== undefined &&\n      closing.has(`${row.quoteId}`) &&\n      row.lifecycle === QuoteLifecycle.ONCHAIN &&\n      row.quoteStatus === QuoteStatus.OPENED\n        ? { ...row, lifecycle: QuoteLifecycle.WRITE_ONCHAIN_CLOSE }\n        : row,\n    );\n  }\n  // Drop terminal quotes: a `CLOSED` lifecycle only comes from an on-chain\n  // terminal status (`CANCELED` / `CLOSED` / `EXPIRED`) — a done quote a lagging\n  // read still lists (e.g. a just force-cancelled limit order). It is not active,\n  // so it must not linger in the list. (Off-chain rows never reach `CLOSED`.)\n  merged = merged.filter((row) => row.lifecycle !== QuoteLifecycle.CLOSED);\n  merged.sort((a, b) => {\n    const aTs = a.statusModifyTimestamp ?? 0n;\n    const bTs = b.statusModifyTimestamp ?? 0n;\n    if (aTs !== bTs) return aTs > bTs ? -1 : 1;\n    const aId = stableSortKey(a);\n    const bId = stableSortKey(b);\n    if (aId !== bId) return aId > bId ? -1 : 1;\n    return 0;\n  });\n  const links: Record<number, string> = {};\n  for (const row of merged) {\n    /**\n     * Only record a temp ↔ on-chain link once the row has actually anchored\n     * (`quoteId` set). A still-optimistic row carries only its own `temp:` key —\n     * recording that as a \"link\" would let the consumer clear its optimistic seed\n     * before the on-chain twin exists, dropping the row for a tick (the\n     * appear→disappear→reappear flicker).\n     */\n    if (row.tempQuoteId !== undefined && row.quoteId !== undefined) links[row.tempQuoteId] = row.key;\n  }\n  const pendingAnchors = merged.filter((row) => row.lifecycle === QuoteLifecycle.WRITE_ONCHAIN);\n  return { quotes: merged, links, pendingAnchors };\n}\n\n/**\n * Lifecycle for an on-chain row that a pending instant-close overlays. Keep a\n * terminal `CLOSED` as-is; keep the row's on-chain lifecycle (`ONCHAIN`) when the\n * on-chain status **already** reflects the close (`CLOSE_PENDING` /\n * `CANCEL_CLOSE_PENDING`) — the close landed, don't drag it backwards; otherwise\n * the read still shows the position open while the close is in-flight, so surface\n * {@link QuoteLifecycle.OPTIMISTIC_CLOSE} as the base close stage. Close\n * notifications (applied after this overlay) then advance it to\n * `CLOSE_PRICE_FILLED` → `WRITE_ONCHAIN_CLOSE`, and once the on-chain read reflects\n * the pending close it resolves to `ONCHAIN` (with `quoteStatus: CLOSE_PENDING`).\n */\nfunction overlayCloseLifecycle(existing: UnifiedQuote): QuoteLifecycle {\n  if (existing.lifecycle === QuoteLifecycle.CLOSED) return QuoteLifecycle.CLOSED;\n  if (existing.quoteStatus === QuoteStatus.CLOSE_PENDING || existing.quoteStatus === QuoteStatus.CANCEL_CLOSE_PENDING) {\n    return existing.lifecycle;\n  }\n  return QuoteLifecycle.OPTIMISTIC_CLOSE;\n}\n\n/**\n * Collapse rows that ended up sharing a `key` after a notification rekeyed an\n * optimistic row (`temp:<id>` → `onchain:<id>`) onto an on-chain twin the poll\n * already returned. Without this the same quote can appear twice — once from the\n * poll and once from the rekeyed optimistic row — yielding duplicate React keys.\n * The genuine on-chain row (the one carrying `raw.onchain`) wins; the optimistic\n * row's `tempQuoteId` / `raw.instantOpen` are grafted on so the temp ↔ on-chain\n * link survives and the optimistic entry can be cleared.\n */\nfunction collapseByKey(rows: UnifiedQuote[]): UnifiedQuote[] {\n  const byKey = new Map<string, UnifiedQuote>();\n  for (const row of rows) {\n    const existing = byKey.get(row.key);\n    byKey.set(row.key, existing ? mergeDuplicateRows(existing, row) : row);\n  }\n  return [...byKey.values()];\n}\n\n/**\n * Merge two rows that resolved to the same `key`, preferring the one that carries\n * the polled on-chain struct and grafting the off-chain identifiers from the other.\n */\nfunction mergeDuplicateRows(a: UnifiedQuote, b: UnifiedQuote): UnifiedQuote {\n  const primary = a.raw.onchain ? a : b;\n  const secondary = primary === a ? b : a;\n  return {\n    ...primary,\n    tempQuoteId: primary.tempQuoteId ?? secondary.tempQuoteId,\n    vaAddress: primary.vaAddress ?? secondary.vaAddress,\n    openedPrice: primary.openedPrice ?? secondary.openedPrice,\n    avgClosedPrice: primary.avgClosedPrice ?? secondary.avgClosedPrice,\n    quantityToClose: primary.quantityToClose ?? secondary.quantityToClose,\n    raw: { ...secondary.raw, ...primary.raw },\n  };\n}\n\n/**\n * Stamp the row's Virtual Account on `vaAddress` when it was read from a VA — in\n * lowcap a VA-scoped position's `partyA` IS its VA, so when the row's `partyA`\n * differs from the sub-account being reconciled we surface it on the dedicated\n * `vaAddress` field for the consumer.\n */\nfunction withVaAddress(row: UnifiedQuote, subAccount: Address): UnifiedQuote {\n  if (row.partyA.toLowerCase() === subAccount.toLowerCase()) return row;\n  return { ...row, vaAddress: row.partyA };\n}\n\n/**\n * Deterministic tiebreak key for rows that share a `statusModifyTimestamp`: the\n * on-chain quote id when anchored, else the (negative) temp id. Keeps the sort\n * order reproducible regardless of the unstable on-chain read order — the\n * contract stores positions with swap-and-pop, so the raw read order reshuffles\n * on every open/close.\n */\nfunction stableSortKey(quote: UnifiedQuote): bigint {\n  if (quote.quoteId !== undefined) return quote.quoteId;\n  if (quote.tempQuoteId !== undefined) return BigInt(quote.tempQuoteId);\n  return 0n;\n}\n"],"mappings":"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"}

package/dist/quotes/resolve-quote-accounts.d.ts

@@ -1,7 +1,7 @@
 import { Address } from 'viem';
 import { Config } from '../core/config/index.js';
 import { ChainIdParameter, Compute } from '../shared/types/properties.js';
-import { PendingInstantOpen } from '../solvers/instant-open/get-instant-opens/to-pending-instant-open.js';
+import { PendingInstantOpen } from '../solvers/instant-open/get-instant-opens/types.js';
 /**
  * Parameters for {@link resolveQuoteAccounts}.
  */

package/dist/quotes/resolve-quote-accounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-quote-accounts.d.ts","sourceRoot":"","sources":["../../src/quotes/resolve-quote-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mEAAmE,CAAC;AAK5G;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAClD,gBAAgB,GAAG;IACjB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7C;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACpC,CACF,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,8BAA8B,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAwDrC"}
+{"version":3,"file":"resolve-quote-accounts.d.ts","sourceRoot":"","sources":["../../src/quotes/resolve-quote-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAK1F;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAClD,gBAAgB,GAAG;IACjB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7C;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACpC,CACF,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,8BAA8B,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAwDrC"}

package/dist/quotes/resolve-quote-accounts.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-quote-accounts.js","names":[],"sources":["../../src/quotes/resolve-quote-accounts.ts"],"sourcesContent":["import { getAddress, type Address } from \"viem\";\nimport type { Config } from \"../core/config\";\nimport type { ChainIdParameter, Compute } from \"../shared/types/properties\";\nimport type { PendingInstantOpen } from \"../solvers/instant-open/get-instant-opens/to-pending-instant-open\";\nimport { isolationTypeForSide } from \"../solvers/instant-open/shared/types\";\nimport { getVirtualAccountsAddressesOfSubAccount } from \"../symmio-contracts/account-layer/actions/get-virtual-accounts-addresses-of-sub-account\";\nimport { getPredictedNextVirtualAccount } from \"../symmio-contracts/account-layer/actions/predict-next-virtual-account\";\n\n/**\n * Parameters for {@link resolveQuoteAccounts}.\n */\nexport type ResolveQuoteAccountsParameters = Compute<\n  ChainIdParameter & {\n    /** The subaccount whose full quote picture is being assembled. */\n    subAccount: Address;\n    /**\n     * Pending instant-opens for the subaccount. Each lands in a Virtual Account\n     * (VA) that may not exist on-chain yet; its address is predicted up front.\n     */\n    instantOpens?: readonly PendingInstantOpen[];\n    /**\n     * Union the subaccount's existing on-chain VAs into the result.\n     * @default true\n     */\n    includeVirtualAccounts?: boolean;\n    /** Extra accounts to union in (e.g. VAs already known to the consumer). */\n    extraAccounts?: readonly Address[];\n  }\n>;\n\n/** Result of {@link resolveQuoteAccounts}. */\nexport interface ResolveQuoteAccountsResult {\n  /**\n   * The deduplicated, checksummed set of on-chain `partyA` accounts to read\n   * quotes across — the subaccount itself, its existing VAs, the predicted VAs\n   * of its pending instant-opens, and any `extraAccounts`. Order is preserved\n   * (subaccount first, then VAs, then predicted VAs, then extras).\n   */\n  accounts: Address[];\n  /**\n   * Map from a pending instant-open's `tempQuoteId` to the predicted VA address\n   * its position will land in. Lets the caller stamp the optimistic quote row\n   * with its eventual VA before the trade anchors on-chain.\n   */\n  instantOpenVaByTempId: Record<number, Address>;\n}\n\n/**\n * Resolve the full set of on-chain `partyA` accounts that together hold a\n * subaccount's quote picture.\n *\n * In lowcap, each isolated position lives under a Virtual Account (VA), and the\n * VA — not the subaccount — is the on-chain `partyA` for quote reads. A\n * brand-new instant-open lands in a VA that does not exist on-chain yet, so its\n * address is predicted from `(subAccount, isolationType, symbolId)` via\n * {@link getPredictedNextVirtualAccount}. This assembles:\n *\n * 1. the subaccount itself;\n * 2. its existing VAs (when `includeVirtualAccounts`, default `true`);\n * 3. one predicted VA per pending instant-open (predictions are deduped by\n *    `(isolationType, symbolId)` and run in parallel);\n * 4. any `extraAccounts`.\n *\n * Addresses are deduped case-insensitively, returned checksummed, and kept in\n * the order above.\n *\n * @param config - The SDK config.\n * @param parameters - Subaccount, optional pending opens / VA inclusion / extras, optional chain id.\n * @returns The account set plus the `tempQuoteId` → predicted-VA map.\n * @throws {SymmError} when the chain is not supported.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const { accounts, instantOpenVaByTempId } = await resolveQuoteAccounts(config, {\n *   subAccount: \"0xsub…\",\n *   instantOpens,\n * });\n * ```\n */\nexport async function resolveQuoteAccounts(\n  config: Config,\n  parameters: ResolveQuoteAccountsParameters,\n): Promise<ResolveQuoteAccountsResult> {\n  const { chainId, subAccount, instantOpens = [], includeVirtualAccounts = true, extraAccounts = [] } = parameters;\n\n  /**\n   * `seen` tracks lowercased addresses already collected so dedupe is\n   * case-insensitive; `accounts` keeps the checksummed addresses in order.\n   */\n  const seen = new Set<string>();\n  const accounts: Address[] = [];\n\n  const add = (address: Address) => {\n    const checksummed = getAddress(address);\n    const lower = checksummed.toLowerCase();\n    if (seen.has(lower)) return;\n    seen.add(lower);\n    accounts.push(checksummed);\n  };\n\n  add(subAccount);\n\n  if (includeVirtualAccounts) {\n    const virtualAccounts = await getVirtualAccountsAddressesOfSubAccount(config, { chainId, subAccount });\n    for (const virtualAccount of virtualAccounts) add(virtualAccount);\n  }\n\n  /**\n   * TODO: dose we need to predict the VA's?\n   * Predict each pending open's VA. Many opens may share the same\n   * `(isolationType, symbolId)` — the prediction is identical for those (until\n   * the nonce advances), so dedupe the on-chain reads while still mapping every\n   * `tempQuoteId` to its address.\n   */\n  const predictionByKey = new Map<string, Promise<Address>>();\n  const predictPromises = instantOpens.map((open) => {\n    const isolationType = isolationTypeForSide(open.positionType);\n    const symbolId = BigInt(open.marketId);\n    const key = `${isolationType}:${symbolId}`;\n    let prediction = predictionByKey.get(key);\n    if (!prediction) {\n      prediction = getPredictedNextVirtualAccount(config, { chainId, subAccount, isolationType, symbolId });\n      predictionByKey.set(key, prediction);\n    }\n    return prediction.then((predictedVa) => ({ tempQuoteId: open.tempQuoteId, predictedVa }));\n  });\n  const predicted = await Promise.all(predictPromises);\n\n  const instantOpenVaByTempId: Record<number, Address> = {};\n  for (const { tempQuoteId, predictedVa } of predicted) {\n    const checksummed = getAddress(predictedVa);\n    instantOpenVaByTempId[tempQuoteId] = checksummed;\n    add(checksummed);\n  }\n\n  for (const extra of extraAccounts) add(extra);\n\n  return { accounts, instantOpenVaByTempId };\n}\n"],"mappings":";;;;;AAgFA,eAAsB,EACpB,GACA,GACqC;CACrC,IAAM,EAAE,YAAS,eAAY,kBAAe,CAAC,GAAG,4BAAyB,IAAM,mBAAgB,CAAC,MAAM,GAMhG,oBAAO,IAAI,IAAY,GACvB,IAAsB,CAAC,GAEvB,KAAO,MAAqB;EAChC,IAAM,IAAc,EAAW,CAAO,GAChC,IAAQ,EAAY,YAAY;EAClC,EAAK,IAAI,CAAK,MAClB,EAAK,IAAI,CAAK,GACd,EAAS,KAAK,CAAW;CAC3B;CAIA,IAFA,EAAI,CAAU,GAEV,GAAwB;EAC1B,IAAM,IAAkB,MAAM,EAAwC,GAAQ;GAAE;GAAS;EAAW,CAAC;EACrG,KAAK,IAAM,KAAkB,GAAiB,EAAI,CAAc;CAClE;CASA,IAAM,oBAAkB,IAAI,IAA8B,GACpD,IAAkB,EAAa,KAAK,MAAS;EACjD,IAAM,IAAgB,EAAqB,EAAK,YAAY,GACtD,IAAW,OAAO,EAAK,QAAQ,GAC/B,IAAM,GAAG,EAAc,GAAG,KAC5B,IAAa,EAAgB,IAAI,CAAG;EAKxC,OAJK,MACH,IAAa,EAA+B,GAAQ;GAAE;GAAS;GAAY;GAAe;EAAS,CAAC,GACpG,EAAgB,IAAI,GAAK,CAAU,IAE9B,EAAW,MAAM,OAAiB;GAAE,aAAa,EAAK;GAAa;EAAY,EAAE;CAC1F,CAAC,GACK,IAAY,MAAM,QAAQ,IAAI,CAAe,GAE7C,IAAiD,CAAC;CACxD,KAAK,IAAM,EAAE,gBAAa,oBAAiB,GAAW;EACpD,IAAM,IAAc,EAAW,CAAW;EAE1C,AADA,EAAsB,KAAe,GACrC,EAAI,CAAW;CACjB;CAEA,KAAK,IAAM,KAAS,GAAe,EAAI,CAAK;CAE5C,OAAO;EAAE;EAAU;CAAsB;AAC3C"}
+{"version":3,"file":"resolve-quote-accounts.js","names":[],"sources":["../../src/quotes/resolve-quote-accounts.ts"],"sourcesContent":["import { getAddress, type Address } from \"viem\";\nimport type { Config } from \"../core/config\";\nimport type { ChainIdParameter, Compute } from \"../shared/types/properties\";\nimport type { PendingInstantOpen } from \"../solvers/instant-open/get-instant-opens/types\";\nimport { isolationTypeForSide } from \"../solvers/instant-open/shared/types\";\nimport { getVirtualAccountsAddressesOfSubAccount } from \"../symmio-contracts/account-layer/actions/get-virtual-accounts-addresses-of-sub-account\";\nimport { getPredictedNextVirtualAccount } from \"../symmio-contracts/account-layer/actions/predict-next-virtual-account\";\n\n/**\n * Parameters for {@link resolveQuoteAccounts}.\n */\nexport type ResolveQuoteAccountsParameters = Compute<\n  ChainIdParameter & {\n    /** The subaccount whose full quote picture is being assembled. */\n    subAccount: Address;\n    /**\n     * Pending instant-opens for the subaccount. Each lands in a Virtual Account\n     * (VA) that may not exist on-chain yet; its address is predicted up front.\n     */\n    instantOpens?: readonly PendingInstantOpen[];\n    /**\n     * Union the subaccount's existing on-chain VAs into the result.\n     * @default true\n     */\n    includeVirtualAccounts?: boolean;\n    /** Extra accounts to union in (e.g. VAs already known to the consumer). */\n    extraAccounts?: readonly Address[];\n  }\n>;\n\n/** Result of {@link resolveQuoteAccounts}. */\nexport interface ResolveQuoteAccountsResult {\n  /**\n   * The deduplicated, checksummed set of on-chain `partyA` accounts to read\n   * quotes across — the subaccount itself, its existing VAs, the predicted VAs\n   * of its pending instant-opens, and any `extraAccounts`. Order is preserved\n   * (subaccount first, then VAs, then predicted VAs, then extras).\n   */\n  accounts: Address[];\n  /**\n   * Map from a pending instant-open's `tempQuoteId` to the predicted VA address\n   * its position will land in. Lets the caller stamp the optimistic quote row\n   * with its eventual VA before the trade anchors on-chain.\n   */\n  instantOpenVaByTempId: Record<number, Address>;\n}\n\n/**\n * Resolve the full set of on-chain `partyA` accounts that together hold a\n * subaccount's quote picture.\n *\n * In lowcap, each isolated position lives under a Virtual Account (VA), and the\n * VA — not the subaccount — is the on-chain `partyA` for quote reads. A\n * brand-new instant-open lands in a VA that does not exist on-chain yet, so its\n * address is predicted from `(subAccount, isolationType, symbolId)` via\n * {@link getPredictedNextVirtualAccount}. This assembles:\n *\n * 1. the subaccount itself;\n * 2. its existing VAs (when `includeVirtualAccounts`, default `true`);\n * 3. one predicted VA per pending instant-open (predictions are deduped by\n *    `(isolationType, symbolId)` and run in parallel);\n * 4. any `extraAccounts`.\n *\n * Addresses are deduped case-insensitively, returned checksummed, and kept in\n * the order above.\n *\n * @param config - The SDK config.\n * @param parameters - Subaccount, optional pending opens / VA inclusion / extras, optional chain id.\n * @returns The account set plus the `tempQuoteId` → predicted-VA map.\n * @throws {SymmError} when the chain is not supported.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const { accounts, instantOpenVaByTempId } = await resolveQuoteAccounts(config, {\n *   subAccount: \"0xsub…\",\n *   instantOpens,\n * });\n * ```\n */\nexport async function resolveQuoteAccounts(\n  config: Config,\n  parameters: ResolveQuoteAccountsParameters,\n): Promise<ResolveQuoteAccountsResult> {\n  const { chainId, subAccount, instantOpens = [], includeVirtualAccounts = true, extraAccounts = [] } = parameters;\n\n  /**\n   * `seen` tracks lowercased addresses already collected so dedupe is\n   * case-insensitive; `accounts` keeps the checksummed addresses in order.\n   */\n  const seen = new Set<string>();\n  const accounts: Address[] = [];\n\n  const add = (address: Address) => {\n    const checksummed = getAddress(address);\n    const lower = checksummed.toLowerCase();\n    if (seen.has(lower)) return;\n    seen.add(lower);\n    accounts.push(checksummed);\n  };\n\n  add(subAccount);\n\n  if (includeVirtualAccounts) {\n    const virtualAccounts = await getVirtualAccountsAddressesOfSubAccount(config, { chainId, subAccount });\n    for (const virtualAccount of virtualAccounts) add(virtualAccount);\n  }\n\n  /**\n   * TODO: dose we need to predict the VA's?\n   * Predict each pending open's VA. Many opens may share the same\n   * `(isolationType, symbolId)` — the prediction is identical for those (until\n   * the nonce advances), so dedupe the on-chain reads while still mapping every\n   * `tempQuoteId` to its address.\n   */\n  const predictionByKey = new Map<string, Promise<Address>>();\n  const predictPromises = instantOpens.map((open) => {\n    const isolationType = isolationTypeForSide(open.positionType);\n    const symbolId = BigInt(open.marketId);\n    const key = `${isolationType}:${symbolId}`;\n    let prediction = predictionByKey.get(key);\n    if (!prediction) {\n      prediction = getPredictedNextVirtualAccount(config, { chainId, subAccount, isolationType, symbolId });\n      predictionByKey.set(key, prediction);\n    }\n    return prediction.then((predictedVa) => ({ tempQuoteId: open.tempQuoteId, predictedVa }));\n  });\n  const predicted = await Promise.all(predictPromises);\n\n  const instantOpenVaByTempId: Record<number, Address> = {};\n  for (const { tempQuoteId, predictedVa } of predicted) {\n    const checksummed = getAddress(predictedVa);\n    instantOpenVaByTempId[tempQuoteId] = checksummed;\n    add(checksummed);\n  }\n\n  for (const extra of extraAccounts) add(extra);\n\n  return { accounts, instantOpenVaByTempId };\n}\n"],"mappings":";;;;;AAgFA,eAAsB,EACpB,GACA,GACqC;CACrC,IAAM,EAAE,YAAS,eAAY,kBAAe,CAAC,GAAG,4BAAyB,IAAM,mBAAgB,CAAC,MAAM,GAMhG,oBAAO,IAAI,IAAY,GACvB,IAAsB,CAAC,GAEvB,KAAO,MAAqB;EAChC,IAAM,IAAc,EAAW,CAAO,GAChC,IAAQ,EAAY,YAAY;EAClC,EAAK,IAAI,CAAK,MAClB,EAAK,IAAI,CAAK,GACd,EAAS,KAAK,CAAW;CAC3B;CAIA,IAFA,EAAI,CAAU,GAEV,GAAwB;EAC1B,IAAM,IAAkB,MAAM,EAAwC,GAAQ;GAAE;GAAS;EAAW,CAAC;EACrG,KAAK,IAAM,KAAkB,GAAiB,EAAI,CAAc;CAClE;CASA,IAAM,oBAAkB,IAAI,IAA8B,GACpD,IAAkB,EAAa,KAAK,MAAS;EACjD,IAAM,IAAgB,EAAqB,EAAK,YAAY,GACtD,IAAW,OAAO,EAAK,QAAQ,GAC/B,IAAM,GAAG,EAAc,GAAG,KAC5B,IAAa,EAAgB,IAAI,CAAG;EAKxC,OAJK,MACH,IAAa,EAA+B,GAAQ;GAAE;GAAS;GAAY;GAAe;EAAS,CAAC,GACpG,EAAgB,IAAI,GAAK,CAAU,IAE9B,EAAW,MAAM,OAAiB;GAAE,aAAa,EAAK;GAAa;EAAY,EAAE;CAC1F,CAAC,GACK,IAAY,MAAM,QAAQ,IAAI,CAAe,GAE7C,IAAiD,CAAC;CACxD,KAAK,IAAM,EAAE,gBAAa,oBAAiB,GAAW;EACpD,IAAM,IAAc,EAAW,CAAW;EAE1C,AADA,EAAsB,KAAe,GACrC,EAAI,CAAW;CACjB;CAEA,KAAK,IAAM,KAAS,GAAe,EAAI,CAAK;CAE5C,OAAO;EAAE;EAAU;CAAsB;AAC3C"}

package/dist/quotes/should-accelerate.d.ts

@@ -4,10 +4,13 @@ import { ReconcileQuotesResult } from './reconcile-quotes.js';
  *
  * Returns `true` while any row is mid-transition (the open stages `OPTIMISTIC` /
  * `PRICE_FILLED` / `WRITE_ONCHAIN`, or the close stages `OPTIMISTIC_CLOSE` /
- * `CLOSE_PRICE_FILLED` / `WRITE_ONCHAIN_CLOSE` / `CLOSING`) — those rows are waiting
- * on an on-chain change the SDK can only observe by re-reading, so the consumer
- * should shorten its `refetchInterval` until everything settles, then fall back to
- * the idle interval.
+ * `CLOSE_PRICE_FILLED` / `WRITE_ONCHAIN_CLOSE`) — those rows are waiting on an
+ * on-chain change the SDK can only observe by re-reading, so the consumer should
+ * shorten its `refetchInterval` until everything settles, then fall back to the
+ * idle interval. Once a close is confirmed on-chain (`ONCHAIN` with
+ * `quoteStatus: CLOSE_PENDING`) it no longer accelerates here — a market close's
+ * settle chase is driven by the close-confirm hold, and a resting limit close
+ * simply sits.
  *
  * @param result - The latest reconciliation result.
  * @returns `true` when at least one transitioning row exists.
@@ -23,9 +26,9 @@ export declare function shouldAccelerateQuotePolling(result: ReconcileQuotesResu
  * interval — the RPC-lag retry. Unlike {@link shouldAccelerateQuotePolling} (which is
  * `true` for every mid-transition stage, including the purely off-chain ones), this is
  * `true` only while a row awaits on-chain confirmation (`WRITE_ONCHAIN` /
- * `WRITE_ONCHAIN_CLOSE` / `CLOSING`). The off-chain stages (`OPTIMISTIC` /
- * `PRICE_FILLED` / `OPTIMISTIC_CLOSE` / `CLOSE_PRICE_FILLED`) have nothing on-chain to
- * read before the anchor, so they must not drive on-chain polling.
+ * `WRITE_ONCHAIN_CLOSE`). The off-chain stages (`OPTIMISTIC` / `PRICE_FILLED` /
+ * `OPTIMISTIC_CLOSE` / `CLOSE_PRICE_FILLED`) have nothing on-chain to read before
+ * the anchor, so they must not drive on-chain polling.
  *
  * @param result - The latest reconciliation result.
  * @returns `true` when at least one row is awaiting on-chain confirmation.

package/dist/quotes/should-accelerate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"should-accelerate.d.ts","sourceRoot":"","sources":["../../src/quotes/should-accelerate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAmBhE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAEnF;AAcD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAEnF"}
+{"version":3,"file":"should-accelerate.d.ts","sourceRoot":"","sources":["../../src/quotes/should-accelerate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAkBhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAEnF;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAEnF"}

package/dist/quotes/should-accelerate.js

@@ -6,17 +6,12 @@ var t = new Set([
 	e.WRITE_ONCHAIN,
 	e.OPTIMISTIC_CLOSE,
 	e.CLOSE_PRICE_FILLED,
-	e.WRITE_ONCHAIN_CLOSE,
-	e.CLOSING
+	e.WRITE_ONCHAIN_CLOSE
 ]);
 function n(e) {
 	return e.quotes.some((e) => t.has(e.lifecycle));
 }
-var r = new Set([
-	e.WRITE_ONCHAIN,
-	e.WRITE_ONCHAIN_CLOSE,
-	e.CLOSING
-]);
+var r = new Set([e.WRITE_ONCHAIN, e.WRITE_ONCHAIN_CLOSE]);
 function i(e) {
 	return e.quotes.some((e) => r.has(e.lifecycle));
 }

package/dist/quotes/should-accelerate.js.map

@@ -1 +1 @@
-{"version":3,"file":"should-accelerate.js","names":[],"sources":["../../src/quotes/should-accelerate.ts"],"sourcesContent":["import type { ReconcileQuotesResult } from \"./reconcile-quotes\";\nimport { QuoteLifecycle } from \"./unified-quote\";\n\n/**\n * Lifecycle stages that mean a quote is mid-transition and the consumer should\n * poll the on-chain reads faster until it settles. The `WRITE_ONCHAIN(_CLOSE)`\n * stages are explicitly waiting on the on-chain read to confirm an anchor/close,\n * so they accelerate too.\n */\nconst ACCELERATING_LIFECYCLES = new Set<QuoteLifecycle>([\n  QuoteLifecycle.OPTIMISTIC,\n  QuoteLifecycle.PRICE_FILLED,\n  QuoteLifecycle.WRITE_ONCHAIN,\n  QuoteLifecycle.OPTIMISTIC_CLOSE,\n  QuoteLifecycle.CLOSE_PRICE_FILLED,\n  QuoteLifecycle.WRITE_ONCHAIN_CLOSE,\n  QuoteLifecycle.CLOSING,\n]);\n\n/**\n * Decide whether quote polling should run at the accelerated interval.\n *\n * Returns `true` while any row is mid-transition (the open stages `OPTIMISTIC` /\n * `PRICE_FILLED` / `WRITE_ONCHAIN`, or the close stages `OPTIMISTIC_CLOSE` /\n * `CLOSE_PRICE_FILLED` / `WRITE_ONCHAIN_CLOSE` / `CLOSING`) — those rows are waiting\n * on an on-chain change the SDK can only observe by re-reading, so the consumer\n * should shorten its `refetchInterval` until everything settles, then fall back to\n * the idle interval.\n *\n * @param result - The latest reconciliation result.\n * @returns `true` when at least one transitioning row exists.\n *\n * @example\n * ```ts\n * const interval = shouldAccelerateQuotePolling(result) ? 1_500 : 10_000;\n * ```\n */\nexport function shouldAccelerateQuotePolling(result: ReconcileQuotesResult): boolean {\n  return result.quotes.some((quote) => ACCELERATING_LIFECYCLES.has(quote.lifecycle));\n}\n\n/**\n * Lifecycle stages where the SDK is waiting on the **on-chain read** to confirm a\n * change it already knows is coming — an anchored open (`WRITE_ONCHAIN`) or a\n * requested close (`WRITE_ONCHAIN_CLOSE` / `CLOSING`): the notification/overlay has\n * advanced the row but `raw.onchain` has not caught up yet.\n */\nconst ONCHAIN_PENDING_LIFECYCLES = new Set<QuoteLifecycle>([\n  QuoteLifecycle.WRITE_ONCHAIN,\n  QuoteLifecycle.WRITE_ONCHAIN_CLOSE,\n  QuoteLifecycle.CLOSING,\n]);\n\n/**\n * Decide whether the **on-chain reads** specifically should poll at the accelerated\n * interval — the RPC-lag retry. Unlike {@link shouldAccelerateQuotePolling} (which is\n * `true` for every mid-transition stage, including the purely off-chain ones), this is\n * `true` only while a row awaits on-chain confirmation (`WRITE_ONCHAIN` /\n * `WRITE_ONCHAIN_CLOSE` / `CLOSING`). The off-chain stages (`OPTIMISTIC` /\n * `PRICE_FILLED` / `OPTIMISTIC_CLOSE` / `CLOSE_PRICE_FILLED`) have nothing on-chain to\n * read before the anchor, so they must not drive on-chain polling.\n *\n * @param result - The latest reconciliation result.\n * @returns `true` when at least one row is awaiting on-chain confirmation.\n *\n * @example\n * ```ts\n * const onchainInterval = shouldAccelerateOnchainReads(result) ? 1_500 : false;\n * ```\n */\nexport function shouldAccelerateOnchainReads(result: ReconcileQuotesResult): boolean {\n  return result.quotes.some((quote) => ONCHAIN_PENDING_LIFECYCLES.has(quote.lifecycle));\n}\n"],"mappings":";;AASA,IAAM,IAA0B,IAAI,IAAoB;CACtD,EAAe;CACf,EAAe;CACf,EAAe;CACf,EAAe;CACf,EAAe;CACf,EAAe;CACf,EAAe;AACjB,CAAC;AAoBD,SAAgB,EAA6B,GAAwC;CACnF,OAAO,EAAO,OAAO,MAAM,MAAU,EAAwB,IAAI,EAAM,SAAS,CAAC;AACnF;AAQA,IAAM,IAA6B,IAAI,IAAoB;CACzD,EAAe;CACf,EAAe;CACf,EAAe;AACjB,CAAC;AAmBD,SAAgB,EAA6B,GAAwC;CACnF,OAAO,EAAO,OAAO,MAAM,MAAU,EAA2B,IAAI,EAAM,SAAS,CAAC;AACtF"}
+{"version":3,"file":"should-accelerate.js","names":[],"sources":["../../src/quotes/should-accelerate.ts"],"sourcesContent":["import type { ReconcileQuotesResult } from \"./reconcile-quotes\";\nimport { QuoteLifecycle } from \"./unified-quote\";\n\n/**\n * Lifecycle stages that mean a quote is mid-transition and the consumer should\n * poll the on-chain reads faster until it settles. The `WRITE_ONCHAIN(_CLOSE)`\n * stages are explicitly waiting on the on-chain read to confirm an anchor/close,\n * so they accelerate too.\n */\nconst ACCELERATING_LIFECYCLES = new Set<QuoteLifecycle>([\n  QuoteLifecycle.OPTIMISTIC,\n  QuoteLifecycle.PRICE_FILLED,\n  QuoteLifecycle.WRITE_ONCHAIN,\n  QuoteLifecycle.OPTIMISTIC_CLOSE,\n  QuoteLifecycle.CLOSE_PRICE_FILLED,\n  QuoteLifecycle.WRITE_ONCHAIN_CLOSE,\n]);\n\n/**\n * Decide whether quote polling should run at the accelerated interval.\n *\n * Returns `true` while any row is mid-transition (the open stages `OPTIMISTIC` /\n * `PRICE_FILLED` / `WRITE_ONCHAIN`, or the close stages `OPTIMISTIC_CLOSE` /\n * `CLOSE_PRICE_FILLED` / `WRITE_ONCHAIN_CLOSE`) — those rows are waiting on an\n * on-chain change the SDK can only observe by re-reading, so the consumer should\n * shorten its `refetchInterval` until everything settles, then fall back to the\n * idle interval. Once a close is confirmed on-chain (`ONCHAIN` with\n * `quoteStatus: CLOSE_PENDING`) it no longer accelerates here — a market close's\n * settle chase is driven by the close-confirm hold, and a resting limit close\n * simply sits.\n *\n * @param result - The latest reconciliation result.\n * @returns `true` when at least one transitioning row exists.\n *\n * @example\n * ```ts\n * const interval = shouldAccelerateQuotePolling(result) ? 1_500 : 10_000;\n * ```\n */\nexport function shouldAccelerateQuotePolling(result: ReconcileQuotesResult): boolean {\n  return result.quotes.some((quote) => ACCELERATING_LIFECYCLES.has(quote.lifecycle));\n}\n\n/**\n * Lifecycle stages where the SDK is waiting on the **on-chain read** to confirm a\n * change it already knows is coming — an anchored open (`WRITE_ONCHAIN`) or a\n * requested close (`WRITE_ONCHAIN_CLOSE`): the notification/overlay has advanced\n * the row but `raw.onchain` has not caught up yet.\n */\nconst ONCHAIN_PENDING_LIFECYCLES = new Set<QuoteLifecycle>([\n  QuoteLifecycle.WRITE_ONCHAIN,\n  QuoteLifecycle.WRITE_ONCHAIN_CLOSE,\n]);\n\n/**\n * Decide whether the **on-chain reads** specifically should poll at the accelerated\n * interval — the RPC-lag retry. Unlike {@link shouldAccelerateQuotePolling} (which is\n * `true` for every mid-transition stage, including the purely off-chain ones), this is\n * `true` only while a row awaits on-chain confirmation (`WRITE_ONCHAIN` /\n * `WRITE_ONCHAIN_CLOSE`). The off-chain stages (`OPTIMISTIC` / `PRICE_FILLED` /\n * `OPTIMISTIC_CLOSE` / `CLOSE_PRICE_FILLED`) have nothing on-chain to read before\n * the anchor, so they must not drive on-chain polling.\n *\n * @param result - The latest reconciliation result.\n * @returns `true` when at least one row is awaiting on-chain confirmation.\n *\n * @example\n * ```ts\n * const onchainInterval = shouldAccelerateOnchainReads(result) ? 1_500 : false;\n * ```\n */\nexport function shouldAccelerateOnchainReads(result: ReconcileQuotesResult): boolean {\n  return result.quotes.some((quote) => ONCHAIN_PENDING_LIFECYCLES.has(quote.lifecycle));\n}\n"],"mappings":";;AASA,IAAM,IAA0B,IAAI,IAAoB;CACtD,EAAe;CACf,EAAe;CACf,EAAe;CACf,EAAe;CACf,EAAe;CACf,EAAe;AACjB,CAAC;AAuBD,SAAgB,EAA6B,GAAwC;CACnF,OAAO,EAAO,OAAO,MAAM,MAAU,EAAwB,IAAI,EAAM,SAAS,CAAC;AACnF;AAQA,IAAM,IAA6B,IAAI,IAAoB,CACzD,EAAe,eACf,EAAe,mBACjB,CAAC;AAmBD,SAAgB,EAA6B,GAAwC;CACnF,OAAO,EAAO,OAAO,MAAM,MAAU,EAA2B,IAAI,EAAM,SAAS,CAAC;AACtF"}

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

@@ -1,12 +1,14 @@
 import { Address } from 'viem';
 import { PendingInstantClose } from '../solvers/instant-close/get-instant-closes/to-pending-instant-close.js';
-import { PendingInstantOpen } from '../solvers/instant-open/get-instant-opens/to-pending-instant-open.js';
+import { PendingInstantOpen } from '../solvers/instant-open/get-instant-opens/types.js';
 import { QuoteStatus, Quote } from '../symmio-contracts/symmio/types.js';
 import { QuoteLifecycle, UnifiedQuote } from './unified-quote.js';
 /**
- * Map an on-chain {@link QuoteStatus} to a {@link QuoteLifecycle}. Open and
- * pending statuses stay `ONCHAIN`; a pending close becomes `CLOSING`; a fully
- * closed/cancelled/expired quote becomes `CLOSED`.
+ * Map an on-chain {@link QuoteStatus} to a {@link QuoteLifecycle}. Every
+ * non-terminal on-chain status (including `CLOSE_PENDING` /
+ * `CANCEL_CLOSE_PENDING`) is `ONCHAIN` — lifecycle tracks the write progression,
+ * not the close status; a fully closed/cancelled/expired quote is `CLOSED`, a
+ * liquidated one `FAILED`.
  *
  * @param status - The on-chain quote status.
  * @returns The lifecycle stage to surface for an anchored row.

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

@@ -1 +1 @@
-{"version":3,"file":"to-unified-quote.d.ts","sourceRoot":"","sources":["../../src/quotes/to-unified-quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sEAAsE,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mEAAmE,CAAC;AAE5G,OAAO,EAAE,WAAW,EAAqB,KAAK,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAUpE;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAc5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAuCpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAsBvF;AAED;;;;GAIG;AACH,MAAM,WAAW,qCAAqC;IACpD,gEAAgE;IAChE,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,yCAAyC;IACzC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC3C,+CAA+C;IAC/C,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,qCAAqC,GAC7C,YAAY,CAiBd"}
+{"version":3,"file":"to-unified-quote.d.ts","sourceRoot":"","sources":["../../src/quotes/to-unified-quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sEAAsE,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,EAAE,WAAW,EAAqB,KAAK,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAUpE;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAa5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAuCpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAsBvF;AAED;;;;GAIG;AACH,MAAM,WAAW,qCAAqC;IACpD,gEAAgE;IAChE,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,yCAAyC;IACzC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC3C,+CAA+C;IAC/C,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,qCAAqC,GAC7C,YAAY,CAiBd"}

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

@@ -11,8 +11,6 @@ var i = {
 };
 function a(t) {
 	switch (t) {
-		case e.CLOSE_PENDING:
-		case e.CANCEL_CLOSE_PENDING: return n.CLOSING;
 		case e.CLOSED:
 		case e.CANCELED:
 		case e.EXPIRED: return n.CLOSED;
@@ -90,7 +88,7 @@ function c(e, t) {
 	return {
 		key: `onchain:${e.quoteId}`,
 		origin: "onchain",
-		lifecycle: n.CLOSING,
+		lifecycle: n.WRITE_ONCHAIN_CLOSE,
 		quoteId: e.quoteId,
 		partyA: t.partyA,
 		symbolId: t.symbolId,

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

@@ -1 +1 @@
-{"version":3,"file":"to-unified-quote.js","names":[],"sources":["../../src/quotes/to-unified-quote.ts"],"sourcesContent":["import type { Address } 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/to-pending-instant-open\";\nimport { toWeiBigInt } from \"../solvers/instant-open/shared/trade-math\";\nimport { QuoteStatus, type LockedValues, type Quote } from \"../symmio-contracts/symmio/types\";\nimport { quoteOpenQuantity } from \"./open-quantity\";\nimport { QuoteLifecycle, type UnifiedQuote } from \"./unified-quote\";\n\n/** All-zero locked values, used when an off-chain row has no per-leg margin yet. */\nconst EMPTY_LOCKED_VALUES: LockedValues = {\n  cva: 0n,\n  lf: 0n,\n  partyAmm: 0n,\n  partyBmm: 0n,\n};\n\n/**\n * Map an on-chain {@link QuoteStatus} to a {@link QuoteLifecycle}. Open and\n * pending statuses stay `ONCHAIN`; a pending close becomes `CLOSING`; a fully\n * closed/cancelled/expired quote becomes `CLOSED`.\n *\n * @param status - The on-chain quote status.\n * @returns The lifecycle stage to surface for an anchored row.\n */\nexport function lifecycleFromQuoteStatus(status: QuoteStatus): QuoteLifecycle {\n  switch (status) {\n    case QuoteStatus.CLOSE_PENDING:\n    case QuoteStatus.CANCEL_CLOSE_PENDING:\n      return QuoteLifecycle.CLOSING;\n    case QuoteStatus.CLOSED:\n    case QuoteStatus.CANCELED:\n    case QuoteStatus.EXPIRED:\n      return QuoteLifecycle.CLOSED;\n    case QuoteStatus.LIQUIDATED:\n      return QuoteLifecycle.FAILED;\n    default:\n      return QuoteLifecycle.ONCHAIN;\n  }\n}\n\n/**\n * Build a {@link UnifiedQuote} from an on-chain {@link Quote}.\n *\n * The lifecycle is derived from the quote's {@link QuoteStatus} via\n * {@link lifecycleFromQuoteStatus}. Every amount is already 18-decimal wei on the\n * on-chain struct, so it carries through untouched.\n *\n * @param quote - The on-chain quote/position struct.\n * @returns The unified row, keyed `onchain:<id>`.\n *\n * @example\n * ```ts\n * const row = toUnifiedQuoteFromOnchain(quote);\n * ```\n */\nexport function toUnifiedQuoteFromOnchain(quote: Quote): UnifiedQuote {\n  const lifecycle = lifecycleFromQuoteStatus(quote.quoteStatus);\n  return {\n    key: `onchain:${quote.id}`,\n    origin: \"onchain\",\n    lifecycle,\n    quoteId: quote.id,\n    partyA: quote.partyA,\n    partyB: quote.partyB,\n    symbolId: quote.symbolId,\n    positionType: quote.positionType,\n    orderType: quote.orderType,\n    quoteStatus: quote.quoteStatus,\n    requestedOpenPrice: quote.requestedOpenPrice,\n    openedPrice: quote.openedPrice,\n    initialOpenedPrice: quote.initialOpenedPrice,\n    avgClosedPrice: quote.avgClosedPrice,\n    requestedClosePrice: quote.requestedClosePrice,\n    marketPrice: quote.marketPrice,\n    quantity: quote.quantity,\n    closedAmount: quote.closedAmount,\n    openQuantity: quoteOpenQuantity({ quantity: quote.quantity, closedAmount: quote.closedAmount }),\n    quantityToClose: quote.quantityToClose,\n    lockedValues: quote.lockedValues,\n    initialLockedValues: quote.initialLockedValues,\n    maxFundingRate: quote.maxFundingRate,\n    accumulatedPaidFunding: quote.accumulatedPaidFunding,\n    lastFundingPaymentTimestamp: quote.lastFundingPaymentTimestamp,\n    deadline: quote.deadline,\n    tradingFee: quote.tradingFee,\n    closeFee: quote.closeFee,\n    affiliate: quote.affiliate,\n    partyBsWhiteList: quote.partyBsWhiteList,\n    parentId: quote.parentId,\n    data: quote.data,\n    createTimestamp: quote.createTimestamp,\n    statusModifyTimestamp: quote.statusModifyTimestamp,\n    raw: { onchain: quote },\n  };\n}\n\n/**\n * Build an optimistic {@link UnifiedQuote} from a pending instant-open record.\n *\n * The hedger reports human-scaled decimal strings; this normalizes price,\n * quantity, and the locked legs to 18-decimal wei via {@link toWeiBigInt}. The\n * row is `OPTIMISTIC` (no fill, no on-chain id yet) and keyed `temp:<tempId>`.\n *\n * @param pending - A normalized pending instant-open record.\n * @returns The unified row.\n *\n * @example\n * ```ts\n * const row = toUnifiedQuoteFromInstantOpen(pending);\n * ```\n */\nexport function toUnifiedQuoteFromInstantOpen(pending: PendingInstantOpen): UnifiedQuote {\n  const quantity = toWeiBigInt(pending.quantity);\n  return {\n    key: `temp:${pending.tempQuoteId}`,\n    origin: \"offchain\",\n    lifecycle: QuoteLifecycle.OPTIMISTIC,\n    tempQuoteId: pending.tempQuoteId,\n    partyA: pending.partyA,\n    symbolId: BigInt(pending.marketId),\n    positionType: pending.positionType,\n    orderType: pending.orderType,\n    requestedOpenPrice: toWeiBigInt(pending.requestedOpenPrice),\n    quantity,\n    openQuantity: quantity,\n    lockedValues: {\n      cva: toWeiBigInt(pending.cva),\n      lf: toWeiBigInt(pending.lf),\n      partyAmm: toWeiBigInt(pending.partyAmm),\n      partyBmm: toWeiBigInt(pending.partyBmm),\n    },\n    raw: { instantOpen: pending },\n  };\n}\n\n/**\n * Inputs identifying the position a pending instant-close targets. A close\n * record only carries the quote id and close amounts, so the market/side fields\n * come from the already-known on-chain row (or sensible zero defaults).\n */\nexport interface ToUnifiedQuoteFromInstantCloseContext {\n  /** Sub-account (partyA) that owns the position being closed. */\n  partyA: Address;\n  /** Market identifier of the position being closed. */\n  symbolId: UnifiedQuote[\"symbolId\"];\n  /** Side of the position being closed. */\n  positionType: UnifiedQuote[\"positionType\"];\n  /** Order type of the position being closed. */\n  orderType: UnifiedQuote[\"orderType\"];\n}\n\n/**\n * Build a `CLOSING` {@link UnifiedQuote} from a pending instant-close record.\n *\n * A close record carries only the quote id and close amounts (already wei), so\n * market/side metadata is supplied via `context` (typically copied from the\n * matching on-chain row). Reconciliation overlays closes onto the existing\n * on-chain row directly; this helper is exposed for consumers that want to render\n * a standalone close-only row when the on-chain row is not available.\n *\n * @param pending - A normalized pending instant-close record.\n * @param context - Market/side metadata for the targeted position.\n * @returns The unified row, keyed `onchain:<quoteId>`.\n */\nexport function toUnifiedQuoteFromInstantClose(\n  pending: PendingInstantClose,\n  context: ToUnifiedQuoteFromInstantCloseContext,\n): UnifiedQuote {\n  return {\n    key: `onchain:${pending.quoteId}`,\n    origin: \"onchain\",\n    lifecycle: QuoteLifecycle.CLOSING,\n    quoteId: pending.quoteId,\n    partyA: context.partyA,\n    symbolId: context.symbolId,\n    positionType: context.positionType,\n    orderType: context.orderType,\n    requestedOpenPrice: 0n,\n    quantity: 0n,\n    openQuantity: 0n,\n    quantityToClose: pending.quantityToClose,\n    lockedValues: EMPTY_LOCKED_VALUES,\n    raw: { instantClose: pending },\n  };\n}\n"],"mappings":";;;;;AASA,IAAM,IAAoC;CACxC,KAAK;CACL,IAAI;CACJ,UAAU;CACV,UAAU;AACZ;AAUA,SAAgB,EAAyB,GAAqC;CAC5E,QAAQ,GAAR;EACE,KAAK,EAAY;EACjB,KAAK,EAAY,sBACf,OAAO,EAAe;EACxB,KAAK,EAAY;EACjB,KAAK,EAAY;EACjB,KAAK,EAAY,SACf,OAAO,EAAe;EACxB,KAAK,EAAY,YACf,OAAO,EAAe;EACxB,SACE,OAAO,EAAe;CAC1B;AACF;AAiBA,SAAgB,EAA0B,GAA4B;CACpE,IAAM,IAAY,EAAyB,EAAM,WAAW;CAC5D,OAAO;EACL,KAAK,WAAW,EAAM;EACtB,QAAQ;EACR;EACA,SAAS,EAAM;EACf,QAAQ,EAAM;EACd,QAAQ,EAAM;EACd,UAAU,EAAM;EAChB,cAAc,EAAM;EACpB,WAAW,EAAM;EACjB,aAAa,EAAM;EACnB,oBAAoB,EAAM;EAC1B,aAAa,EAAM;EACnB,oBAAoB,EAAM;EAC1B,gBAAgB,EAAM;EACtB,qBAAqB,EAAM;EAC3B,aAAa,EAAM;EACnB,UAAU,EAAM;EAChB,cAAc,EAAM;EACpB,cAAc,EAAkB;GAAE,UAAU,EAAM;GAAU,cAAc,EAAM;EAAa,CAAC;EAC9F,iBAAiB,EAAM;EACvB,cAAc,EAAM;EACpB,qBAAqB,EAAM;EAC3B,gBAAgB,EAAM;EACtB,wBAAwB,EAAM;EAC9B,6BAA6B,EAAM;EACnC,UAAU,EAAM;EAChB,YAAY,EAAM;EAClB,UAAU,EAAM;EAChB,WAAW,EAAM;EACjB,kBAAkB,EAAM;EACxB,UAAU,EAAM;EAChB,MAAM,EAAM;EACZ,iBAAiB,EAAM;EACvB,uBAAuB,EAAM;EAC7B,KAAK,EAAE,SAAS,EAAM;CACxB;AACF;AAiBA,SAAgB,EAA8B,GAA2C;CACvF,IAAM,IAAW,EAAY,EAAQ,QAAQ;CAC7C,OAAO;EACL,KAAK,QAAQ,EAAQ;EACrB,QAAQ;EACR,WAAW,EAAe;EAC1B,aAAa,EAAQ;EACrB,QAAQ,EAAQ;EAChB,UAAU,OAAO,EAAQ,QAAQ;EACjC,cAAc,EAAQ;EACtB,WAAW,EAAQ;EACnB,oBAAoB,EAAY,EAAQ,kBAAkB;EAC1D;EACA,cAAc;EACd,cAAc;GACZ,KAAK,EAAY,EAAQ,GAAG;GAC5B,IAAI,EAAY,EAAQ,EAAE;GAC1B,UAAU,EAAY,EAAQ,QAAQ;GACtC,UAAU,EAAY,EAAQ,QAAQ;EACxC;EACA,KAAK,EAAE,aAAa,EAAQ;CAC9B;AACF;AA+BA,SAAgB,EACd,GACA,GACc;CACd,OAAO;EACL,KAAK,WAAW,EAAQ;EACxB,QAAQ;EACR,WAAW,EAAe;EAC1B,SAAS,EAAQ;EACjB,QAAQ,EAAQ;EAChB,UAAU,EAAQ;EAClB,cAAc,EAAQ;EACtB,WAAW,EAAQ;EACnB,oBAAoB;EACpB,UAAU;EACV,cAAc;EACd,iBAAiB,EAAQ;EACzB,cAAc;EACd,KAAK,EAAE,cAAc,EAAQ;CAC/B;AACF"}
+{"version":3,"file":"to-unified-quote.js","names":[],"sources":["../../src/quotes/to-unified-quote.ts"],"sourcesContent":["import type { Address } 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 { toWeiBigInt } from \"../solvers/instant-open/shared/trade-math\";\nimport { QuoteStatus, type LockedValues, type Quote } from \"../symmio-contracts/symmio/types\";\nimport { quoteOpenQuantity } from \"./open-quantity\";\nimport { QuoteLifecycle, type UnifiedQuote } from \"./unified-quote\";\n\n/** All-zero locked values, used when an off-chain row has no per-leg margin yet. */\nconst EMPTY_LOCKED_VALUES: LockedValues = {\n  cva: 0n,\n  lf: 0n,\n  partyAmm: 0n,\n  partyBmm: 0n,\n};\n\n/**\n * Map an on-chain {@link QuoteStatus} to a {@link QuoteLifecycle}. Every\n * non-terminal on-chain status (including `CLOSE_PENDING` /\n * `CANCEL_CLOSE_PENDING`) is `ONCHAIN` — lifecycle tracks the write progression,\n * not the close status; a fully closed/cancelled/expired quote is `CLOSED`, a\n * liquidated one `FAILED`.\n *\n * @param status - The on-chain quote status.\n * @returns The lifecycle stage to surface for an anchored row.\n */\nexport function lifecycleFromQuoteStatus(status: QuoteStatus): QuoteLifecycle {\n  switch (status) {\n    case QuoteStatus.CLOSED:\n    case QuoteStatus.CANCELED:\n    case QuoteStatus.EXPIRED:\n      return QuoteLifecycle.CLOSED;\n    case QuoteStatus.LIQUIDATED:\n      return QuoteLifecycle.FAILED;\n    // Anything on-chain and non-terminal (OPENED, CLOSE_PENDING,\n    // CANCEL_CLOSE_PENDING, …) is ONCHAIN — read `quoteStatus` for the detail.\n    default:\n      return QuoteLifecycle.ONCHAIN;\n  }\n}\n\n/**\n * Build a {@link UnifiedQuote} from an on-chain {@link Quote}.\n *\n * The lifecycle is derived from the quote's {@link QuoteStatus} via\n * {@link lifecycleFromQuoteStatus}. Every amount is already 18-decimal wei on the\n * on-chain struct, so it carries through untouched.\n *\n * @param quote - The on-chain quote/position struct.\n * @returns The unified row, keyed `onchain:<id>`.\n *\n * @example\n * ```ts\n * const row = toUnifiedQuoteFromOnchain(quote);\n * ```\n */\nexport function toUnifiedQuoteFromOnchain(quote: Quote): UnifiedQuote {\n  const lifecycle = lifecycleFromQuoteStatus(quote.quoteStatus);\n  return {\n    key: `onchain:${quote.id}`,\n    origin: \"onchain\",\n    lifecycle,\n    quoteId: quote.id,\n    partyA: quote.partyA,\n    partyB: quote.partyB,\n    symbolId: quote.symbolId,\n    positionType: quote.positionType,\n    orderType: quote.orderType,\n    quoteStatus: quote.quoteStatus,\n    requestedOpenPrice: quote.requestedOpenPrice,\n    openedPrice: quote.openedPrice,\n    initialOpenedPrice: quote.initialOpenedPrice,\n    avgClosedPrice: quote.avgClosedPrice,\n    requestedClosePrice: quote.requestedClosePrice,\n    marketPrice: quote.marketPrice,\n    quantity: quote.quantity,\n    closedAmount: quote.closedAmount,\n    openQuantity: quoteOpenQuantity({ quantity: quote.quantity, closedAmount: quote.closedAmount }),\n    quantityToClose: quote.quantityToClose,\n    lockedValues: quote.lockedValues,\n    initialLockedValues: quote.initialLockedValues,\n    maxFundingRate: quote.maxFundingRate,\n    accumulatedPaidFunding: quote.accumulatedPaidFunding,\n    lastFundingPaymentTimestamp: quote.lastFundingPaymentTimestamp,\n    deadline: quote.deadline,\n    tradingFee: quote.tradingFee,\n    closeFee: quote.closeFee,\n    affiliate: quote.affiliate,\n    partyBsWhiteList: quote.partyBsWhiteList,\n    parentId: quote.parentId,\n    data: quote.data,\n    createTimestamp: quote.createTimestamp,\n    statusModifyTimestamp: quote.statusModifyTimestamp,\n    raw: { onchain: quote },\n  };\n}\n\n/**\n * Build an optimistic {@link UnifiedQuote} from a pending instant-open record.\n *\n * The hedger reports human-scaled decimal strings; this normalizes price,\n * quantity, and the locked legs to 18-decimal wei via {@link toWeiBigInt}. The\n * row is `OPTIMISTIC` (no fill, no on-chain id yet) and keyed `temp:<tempId>`.\n *\n * @param pending - A normalized pending instant-open record.\n * @returns The unified row.\n *\n * @example\n * ```ts\n * const row = toUnifiedQuoteFromInstantOpen(pending);\n * ```\n */\nexport function toUnifiedQuoteFromInstantOpen(pending: PendingInstantOpen): UnifiedQuote {\n  const quantity = toWeiBigInt(pending.quantity);\n  return {\n    key: `temp:${pending.tempQuoteId}`,\n    origin: \"offchain\",\n    lifecycle: QuoteLifecycle.OPTIMISTIC,\n    tempQuoteId: pending.tempQuoteId,\n    partyA: pending.partyA,\n    symbolId: BigInt(pending.marketId),\n    positionType: pending.positionType,\n    orderType: pending.orderType,\n    requestedOpenPrice: toWeiBigInt(pending.requestedOpenPrice),\n    quantity,\n    openQuantity: quantity,\n    lockedValues: {\n      cva: toWeiBigInt(pending.cva),\n      lf: toWeiBigInt(pending.lf),\n      partyAmm: toWeiBigInt(pending.partyAmm),\n      partyBmm: toWeiBigInt(pending.partyBmm),\n    },\n    raw: { instantOpen: pending },\n  };\n}\n\n/**\n * Inputs identifying the position a pending instant-close targets. A close\n * record only carries the quote id and close amounts, so the market/side fields\n * come from the already-known on-chain row (or sensible zero defaults).\n */\nexport interface ToUnifiedQuoteFromInstantCloseContext {\n  /** Sub-account (partyA) that owns the position being closed. */\n  partyA: Address;\n  /** Market identifier of the position being closed. */\n  symbolId: UnifiedQuote[\"symbolId\"];\n  /** Side of the position being closed. */\n  positionType: UnifiedQuote[\"positionType\"];\n  /** Order type of the position being closed. */\n  orderType: UnifiedQuote[\"orderType\"];\n}\n\n/**\n * Build a `CLOSING` {@link UnifiedQuote} from a pending instant-close record.\n *\n * A close record carries only the quote id and close amounts (already wei), so\n * market/side metadata is supplied via `context` (typically copied from the\n * matching on-chain row). Reconciliation overlays closes onto the existing\n * on-chain row directly; this helper is exposed for consumers that want to render\n * a standalone close-only row when the on-chain row is not available.\n *\n * @param pending - A normalized pending instant-close record.\n * @param context - Market/side metadata for the targeted position.\n * @returns The unified row, keyed `onchain:<quoteId>`.\n */\nexport function toUnifiedQuoteFromInstantClose(\n  pending: PendingInstantClose,\n  context: ToUnifiedQuoteFromInstantCloseContext,\n): UnifiedQuote {\n  return {\n    key: `onchain:${pending.quoteId}`,\n    origin: \"onchain\",\n    lifecycle: QuoteLifecycle.WRITE_ONCHAIN_CLOSE,\n    quoteId: pending.quoteId,\n    partyA: context.partyA,\n    symbolId: context.symbolId,\n    positionType: context.positionType,\n    orderType: context.orderType,\n    requestedOpenPrice: 0n,\n    quantity: 0n,\n    openQuantity: 0n,\n    quantityToClose: pending.quantityToClose,\n    lockedValues: EMPTY_LOCKED_VALUES,\n    raw: { instantClose: pending },\n  };\n}\n"],"mappings":";;;;;AASA,IAAM,IAAoC;CACxC,KAAK;CACL,IAAI;CACJ,UAAU;CACV,UAAU;AACZ;AAYA,SAAgB,EAAyB,GAAqC;CAC5E,QAAQ,GAAR;EACE,KAAK,EAAY;EACjB,KAAK,EAAY;EACjB,KAAK,EAAY,SACf,OAAO,EAAe;EACxB,KAAK,EAAY,YACf,OAAO,EAAe;EAGxB,SACE,OAAO,EAAe;CAC1B;AACF;AAiBA,SAAgB,EAA0B,GAA4B;CACpE,IAAM,IAAY,EAAyB,EAAM,WAAW;CAC5D,OAAO;EACL,KAAK,WAAW,EAAM;EACtB,QAAQ;EACR;EACA,SAAS,EAAM;EACf,QAAQ,EAAM;EACd,QAAQ,EAAM;EACd,UAAU,EAAM;EAChB,cAAc,EAAM;EACpB,WAAW,EAAM;EACjB,aAAa,EAAM;EACnB,oBAAoB,EAAM;EAC1B,aAAa,EAAM;EACnB,oBAAoB,EAAM;EAC1B,gBAAgB,EAAM;EACtB,qBAAqB,EAAM;EAC3B,aAAa,EAAM;EACnB,UAAU,EAAM;EAChB,cAAc,EAAM;EACpB,cAAc,EAAkB;GAAE,UAAU,EAAM;GAAU,cAAc,EAAM;EAAa,CAAC;EAC9F,iBAAiB,EAAM;EACvB,cAAc,EAAM;EACpB,qBAAqB,EAAM;EAC3B,gBAAgB,EAAM;EACtB,wBAAwB,EAAM;EAC9B,6BAA6B,EAAM;EACnC,UAAU,EAAM;EAChB,YAAY,EAAM;EAClB,UAAU,EAAM;EAChB,WAAW,EAAM;EACjB,kBAAkB,EAAM;EACxB,UAAU,EAAM;EAChB,MAAM,EAAM;EACZ,iBAAiB,EAAM;EACvB,uBAAuB,EAAM;EAC7B,KAAK,EAAE,SAAS,EAAM;CACxB;AACF;AAiBA,SAAgB,EAA8B,GAA2C;CACvF,IAAM,IAAW,EAAY,EAAQ,QAAQ;CAC7C,OAAO;EACL,KAAK,QAAQ,EAAQ;EACrB,QAAQ;EACR,WAAW,EAAe;EAC1B,aAAa,EAAQ;EACrB,QAAQ,EAAQ;EAChB,UAAU,OAAO,EAAQ,QAAQ;EACjC,cAAc,EAAQ;EACtB,WAAW,EAAQ;EACnB,oBAAoB,EAAY,EAAQ,kBAAkB;EAC1D;EACA,cAAc;EACd,cAAc;GACZ,KAAK,EAAY,EAAQ,GAAG;GAC5B,IAAI,EAAY,EAAQ,EAAE;GAC1B,UAAU,EAAY,EAAQ,QAAQ;GACtC,UAAU,EAAY,EAAQ,QAAQ;EACxC;EACA,KAAK,EAAE,aAAa,EAAQ;CAC9B;AACF;AA+BA,SAAgB,EACd,GACA,GACc;CACd,OAAO;EACL,KAAK,WAAW,EAAQ;EACxB,QAAQ;EACR,WAAW,EAAe;EAC1B,SAAS,EAAQ;EACjB,QAAQ,EAAQ;EAChB,UAAU,EAAQ;EAClB,cAAc,EAAQ;EACtB,WAAW,EAAQ;EACnB,oBAAoB;EACpB,UAAU;EACV,cAAc;EACd,iBAAiB,EAAQ;EACzB,cAAc;EACd,KAAK,EAAE,cAAc,EAAQ;CAC/B;AACF"}

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

@@ -1,6 +1,6 @@
 import { Address, Hex } from 'viem';
 import { PendingInstantClose } from '../solvers/instant-close/get-instant-closes/to-pending-instant-close.js';
-import { PendingInstantOpen } from '../solvers/instant-open/get-instant-opens/to-pending-instant-open.js';
+import { PendingInstantOpen } from '../solvers/instant-open/get-instant-opens/types.js';
 import { LockedValues, OrderType, PositionType, Quote, QuoteStatus } from '../symmio-contracts/symmio/types.js';
 /**
  * Where a {@link UnifiedQuote} was sourced from before reconciliation.
@@ -15,8 +15,11 @@ export type QuoteOrigin = "onchain" | "offchain";
  * The stage of a quote's lifecycle as tracked across the on-chain + off-chain
  * merge. Drives row styling and polling acceleration in the consumer.
  *
- * The off-chain stages (`OPTIMISTIC`, `PRICE_FILLED`) and the transient `CLOSING`
- * stage are SDK-side overlays — they do not exist on the on-chain
+ * Lifecycle tracks the **write progression** (off-chain → on-chain), not the
+ * on-chain status: once a quote is on-chain it is `ONCHAIN` whether it is
+ * `OPENED` or `CLOSE_PENDING` — read {@link UnifiedQuote.quoteStatus} for that
+ * distinction. The off-chain stages (`OPTIMISTIC*`, `*PRICE_FILLED`,
+ * `WRITE_ONCHAIN*`) are SDK-side overlays that do not exist on the on-chain
  * {@link QuoteStatus}; reconciliation assigns them from notifications and hedger
  * records.
  */
@@ -48,15 +51,15 @@ export declare enum QuoteLifecycle {
      */
     CLOSE_PRICE_FILLED = "close-price-filled",
     /**
-     * The close fill (`FillMarketOrderInstantClose`) was reported, or a pending
-     * instant-close overlays the row while the on-chain status still shows the
-     * position open — the close is being "written on-chain", awaiting the RPC. The
-     * close-side analog of {@link QuoteLifecycle.WRITE_ONCHAIN}. Resolves to
-     * {@link QuoteLifecycle.CLOSING} when the on-chain status reflects the pending close.
+     * The close fill (`FillMarketOrderInstantClose`) or the limit-close anchor
+     * (`InstantRequestToLimitClose`) was reported, or a pending instant-close
+     * overlays the row while the on-chain status still shows the position open — the
+     * close is being "written on-chain", awaiting the RPC. The close-side analog of
+     * {@link QuoteLifecycle.WRITE_ONCHAIN}. Resolves to {@link QuoteLifecycle.ONCHAIN}
+     * once the on-chain read returns the quote (now `CLOSE_PENDING`); read
+     * {@link UnifiedQuote.quoteStatus} to see the close is pending.
      */
     WRITE_ONCHAIN_CLOSE = "write-onchain-close",
-    /** The close is confirmed pending on-chain — on-chain `CLOSE_PENDING` / `CANCEL_CLOSE_PENDING`. */
-    CLOSING = "closing",
     /** The position is fully closed. */
     CLOSED = "closed",
     /** A hedger or notification reported the open/close failed. */
@@ -117,6 +120,10 @@ export interface UnifiedQuote {
      * Remaining **open** size (wei): `quantity − closedAmount`, the live quantity
      * still on the position (the figure a UI shows as "position size"); `0` once
      * fully closed. Derived from the other amount fields by {@link quoteOpenQuantity}.
+     *
+     * A size, never a state: a quote that has not opened yet still reports its full
+     * `quantity`. To ask whether a row is a position, use `isPendingOrder` /
+     * `isActivePosition`, which read {@link UnifiedQuote.quoteStatus}.
      */
     openQuantity: bigint;
     /** Quantity targeted by a pending close (wei), when closing. */
@@ -127,7 +134,15 @@ export interface UnifiedQuote {
     initialLockedValues?: LockedValues;
     /** Maximum funding rate partyA accepts, when known. */
     maxFundingRate?: bigint;
-    /** Net funding paid (positive) or received (negative) over the position's life (wei), when known. */
+    /**
+     * 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
+     * {@link getQuoteFunding} / {@link aggregateGroupFunding}.
+     */
     accumulatedPaidFunding?: bigint;
     /** Block timestamp funding was last applied, when known. */
     lastFundingPaymentTimestamp?: bigint;

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

@@ -1 +1 @@
-{"version":3,"file":"unified-quote.d.ts","sourceRoot":"","sources":["../../src/quotes/unified-quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sEAAsE,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mEAAmE,CAAC;AAC5G,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAElH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjD;;;;;;;;GAQG;AACH,oBAAY,cAAc;IACxB,uEAAuE;IACvE,UAAU,eAAe;IACzB,uGAAuG;IACvG,YAAY,iBAAiB;IAC7B;;;;;;OAMG;IACH,aAAa,kBAAkB;IAC/B,6DAA6D;IAC7D,OAAO,YAAY;IACnB;;;;OAIG;IACH,gBAAgB,qBAAqB;IACrC;;;;OAIG;IACH,kBAAkB,uBAAuB;IACzC;;;;;;OAMG;IACH,mBAAmB,wBAAwB;IAC3C,mGAAmG;IACnG,OAAO,YAAY;IACnB,oCAAoC;IACpC,MAAM,WAAW;IACjB,+DAA+D;IAC/D,MAAM,WAAW;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,MAAM,EAAE,WAAW,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,cAAc,CAAC;IAC1B,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,6BAA6B;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,YAAY,CAAC;IACnC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qGAAqG;IACrG,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,GAAG,EAAE;QACH,oDAAoD;QACpD,OAAO,CAAC,EAAE,KAAK,CAAC;QAChB,+DAA+D;QAC/D,WAAW,CAAC,EAAE,kBAAkB,CAAC;QACjC,gEAAgE;QAChE,YAAY,CAAC,EAAE,mBAAmB,CAAC;KACpC,CAAC;CACH"}
+{"version":3,"file":"unified-quote.d.ts","sourceRoot":"","sources":["../../src/quotes/unified-quote.ts"],"names":[],"mappings":"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"}

package/dist/quotes/unified-quote.js

@@ -1,6 +1,6 @@
 //#region src/quotes/unified-quote.ts
 var e = /* @__PURE__ */ function(e) {
-	return e.OPTIMISTIC = "optimistic", e.PRICE_FILLED = "price-filled", e.WRITE_ONCHAIN = "write-onchain", e.ONCHAIN = "onchain", e.OPTIMISTIC_CLOSE = "optimistic-close", e.CLOSE_PRICE_FILLED = "close-price-filled", e.WRITE_ONCHAIN_CLOSE = "write-onchain-close", e.CLOSING = "closing", e.CLOSED = "closed", e.FAILED = "failed", e;
+	return e.OPTIMISTIC = "optimistic", e.PRICE_FILLED = "price-filled", e.WRITE_ONCHAIN = "write-onchain", e.ONCHAIN = "onchain", e.OPTIMISTIC_CLOSE = "optimistic-close", e.CLOSE_PRICE_FILLED = "close-price-filled", e.WRITE_ONCHAIN_CLOSE = "write-onchain-close", e.CLOSED = "closed", e.FAILED = "failed", e;
 }({});
 //#endregion
 export { e as QuoteLifecycle };

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/to-pending-instant-open\";\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 * The off-chain stages (`OPTIMISTIC`, `PRICE_FILLED`) and the transient `CLOSING`\n * stage are SDK-side overlays — they 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`) was reported, or a pending\n   * instant-close overlays the row while the on-chain status still shows the\n   * position open — the close is being \"written on-chain\", awaiting the RPC. The\n   * close-side analog of {@link QuoteLifecycle.WRITE_ONCHAIN}. Resolves to\n   * {@link QuoteLifecycle.CLOSING} when the on-chain status reflects the pending close.\n   */\n  WRITE_ONCHAIN_CLOSE = \"write-onchain-close\",\n  /** The close is confirmed pending on-chain — on-chain `CLOSE_PENDING` / `CANCEL_CLOSE_PENDING`. */\n  CLOSING = \"closing\",\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  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  /** Net funding paid (positive) or received (negative) over the position's life (wei), when known. */\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":";AAwBA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,aAAA,cAEA,EAAA,eAAA,gBAQA,EAAA,gBAAA,iBAEA,EAAA,UAAA,WAMA,EAAA,mBAAA,oBAMA,EAAA,qBAAA,sBAQA,EAAA,sBAAA,uBAEA,EAAA,UAAA,WAEA,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   * 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"}

package/dist/quotes/upnl/calculate-quote-leverage.d.ts

@@ -4,7 +4,11 @@
 export interface CalculateQuoteLeverageParameters {
     /** Quote quantity. */
     quantity: bigint;
-    /** Quote's requested open price (used as the notional reference price). */
+    /** Original open price the position first opened at — the preferred reference. */
+    initialOpenedPrice?: bigint;
+    /** Settled open price (wei) — reference used when `initialOpenedPrice` is absent. */
+    openedPrice?: bigint;
+    /** Current requested open price (wei) — last-resort reference; may drift after edits. */
     requestedOpenPrice: bigint;
     /** Locked-margin legs (partyA + partyB) committed when the quote opened. */
     lockedValues: {
@@ -17,7 +21,9 @@ export interface CalculateQuoteLeverageParameters {
 /**
  * Quote leverage as a decimal string.
  *
- * `leverage = quantity × requestedOpenPrice / (CVA + LF + partyAMM + partyBMM)`.
+ * `leverage = quantity × (initialOpenedPrice ?? openedPrice ?? requestedOpenPrice) / (CVA + LF + partyAMM + partyBMM)`
+ * — the original open price is the reference; the settled `openedPrice` then the
+ * current `requestedOpenPrice` step in as it is absent (see {@link leveragePriceOf}).
  *
  * Returns `"0"` when the locked-margin sum is zero (i.e. the quote has no
  * partyA-locked collateral on record yet) or when any input is non-finite.

package/dist/quotes/upnl/calculate-quote-leverage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculate-quote-leverage.d.ts","sourceRoot":"","sources":["../../../src/quotes/upnl/calculate-quote-leverage.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,gCAAgC,GAAG,MAAM,CAiB3F"}
+{"version":3,"file":"calculate-quote-leverage.d.ts","sourceRoot":"","sources":["../../../src/quotes/upnl/calculate-quote-leverage.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,gCAAgC,GAAG,MAAM,CAkB3F"}

package/dist/quotes/upnl/calculate-quote-leverage.js

@@ -1,13 +1,14 @@
-import { formatUnits as e } from "viem";
+import { leveragePriceOf as e } from "../open-price.js";
+import { formatUnits as t } from "viem";
 //#region src/quotes/upnl/calculate-quote-leverage.ts
-var t = 18;
-function n(n) {
-	let r = Number(e(n.quantity, t)), i = Number(e(n.requestedOpenPrice, t)), a = Number(e(n.lockedValues.cva + n.lockedValues.lf + n.lockedValues.partyAmm + n.lockedValues.partyBmm, t));
-	if (!Number.isFinite(r) || !Number.isFinite(i) || !Number.isFinite(a) || a === 0) return "0";
-	let o = r * i / a;
-	return Number.isFinite(o) ? String(o) : "0";
+var n = 18;
+function r(r) {
+	let i = e(r), a = Number(t(r.quantity, n)), o = Number(t(i, n)), s = Number(t(r.lockedValues.cva + r.lockedValues.lf + r.lockedValues.partyAmm + r.lockedValues.partyBmm, n));
+	if (!Number.isFinite(a) || !Number.isFinite(o) || !Number.isFinite(s) || s === 0) return "0";
+	let c = a * o / s;
+	return Number.isFinite(c) ? String(c) : "0";
 }
 //#endregion
-export { n as calculateQuoteLeverage };
+export { r as calculateQuoteLeverage };
 
 //# sourceMappingURL=calculate-quote-leverage.js.map

package/dist/quotes/upnl/calculate-quote-leverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"calculate-quote-leverage.js","names":[],"sources":["../../../src/quotes/upnl/calculate-quote-leverage.ts"],"sourcesContent":["import { formatUnits } from \"viem\";\n\n/** Decimal places of an 18-decimal-wei fixed-point value. */\nconst WEI_DECIMALS = 18;\n\n/**\n * Inputs for {@link calculateQuoteLeverage}. All bigint fields are 18-decimal wei.\n */\nexport interface CalculateQuoteLeverageParameters {\n  /** Quote quantity. */\n  quantity: bigint;\n  /** Quote's requested open price (used as the notional reference price). */\n  requestedOpenPrice: bigint;\n  /** Locked-margin legs (partyA + partyB) committed when the quote opened. */\n  lockedValues: { cva: bigint; lf: bigint; partyAmm: bigint; partyBmm: bigint };\n}\n\n/**\n * Quote leverage as a decimal string.\n *\n * `leverage = quantity × requestedOpenPrice / (CVA + LF + partyAMM + partyBMM)`.\n *\n * Returns `\"0\"` when the locked-margin sum is zero (i.e. the quote has no\n * partyA-locked collateral on record yet) or when any input is non-finite.\n *\n * @example\n * ```ts\n * const lev = calculateQuoteLeverage({\n *   quantity: 1_000_000_000_000_000_000n,\n *   requestedOpenPrice: 50_000_000_000_000_000_000n,\n *   lockedValues: { cva: 1_000_000_000_000_000_000n, lf: 500_000_000_000_000_000n, partyAmm: 1_500_000_000_000_000_000n },\n * });\n * ```\n */\nexport function calculateQuoteLeverage(parameters: CalculateQuoteLeverageParameters): string {\n  const quantity = Number(formatUnits(parameters.quantity, WEI_DECIMALS));\n  const requestedOpenPrice = Number(formatUnits(parameters.requestedOpenPrice, WEI_DECIMALS));\n  const lockedSum = Number(\n    formatUnits(\n      parameters.lockedValues.cva +\n        parameters.lockedValues.lf +\n        parameters.lockedValues.partyAmm +\n        parameters.lockedValues.partyBmm,\n      WEI_DECIMALS,\n    ),\n  );\n  if (!Number.isFinite(quantity) || !Number.isFinite(requestedOpenPrice) || !Number.isFinite(lockedSum)) return \"0\";\n  if (lockedSum === 0) return \"0\";\n  const leverage = (quantity * requestedOpenPrice) / lockedSum;\n  if (!Number.isFinite(leverage)) return \"0\";\n  return String(leverage);\n}\n"],"mappings":";;AAGA,IAAM,IAAe;AA+BrB,SAAgB,EAAuB,GAAsD;CAC3F,IAAM,IAAW,OAAO,EAAY,EAAW,UAAU,CAAY,CAAC,GAChE,IAAqB,OAAO,EAAY,EAAW,oBAAoB,CAAY,CAAC,GACpF,IAAY,OAChB,EACE,EAAW,aAAa,MACtB,EAAW,aAAa,KACxB,EAAW,aAAa,WACxB,EAAW,aAAa,UAC1B,CACF,CACF;CAEA,IADI,CAAC,OAAO,SAAS,CAAQ,KAAK,CAAC,OAAO,SAAS,CAAkB,KAAK,CAAC,OAAO,SAAS,CAAS,KAChG,MAAc,GAAG,OAAO;CAC5B,IAAM,IAAY,IAAW,IAAsB;CAEnD,OADK,OAAO,SAAS,CAAQ,IACtB,OAAO,CAAQ,IADiB;AAEzC"}
+{"version":3,"file":"calculate-quote-leverage.js","names":[],"sources":["../../../src/quotes/upnl/calculate-quote-leverage.ts"],"sourcesContent":["import { formatUnits } from \"viem\";\nimport { leveragePriceOf } from \"../open-price\";\n\n/** Decimal places of an 18-decimal-wei fixed-point value. */\nconst WEI_DECIMALS = 18;\n\n/**\n * Inputs for {@link calculateQuoteLeverage}. All bigint fields are 18-decimal wei.\n */\nexport interface CalculateQuoteLeverageParameters {\n  /** Quote quantity. */\n  quantity: bigint;\n  /** Original open price the position first opened at — the preferred reference. */\n  initialOpenedPrice?: bigint;\n  /** Settled open price (wei) — reference used when `initialOpenedPrice` is absent. */\n  openedPrice?: bigint;\n  /** Current requested open price (wei) — last-resort reference; may drift after edits. */\n  requestedOpenPrice: bigint;\n  /** Locked-margin legs (partyA + partyB) committed when the quote opened. */\n  lockedValues: { cva: bigint; lf: bigint; partyAmm: bigint; partyBmm: bigint };\n}\n\n/**\n * Quote leverage as a decimal string.\n *\n * `leverage = quantity × (initialOpenedPrice ?? openedPrice ?? requestedOpenPrice) / (CVA + LF + partyAMM + partyBMM)`\n * — the original open price is the reference; the settled `openedPrice` then the\n * current `requestedOpenPrice` step in as it is absent (see {@link leveragePriceOf}).\n *\n * Returns `\"0\"` when the locked-margin sum is zero (i.e. the quote has no\n * partyA-locked collateral on record yet) or when any input is non-finite.\n *\n * @example\n * ```ts\n * const lev = calculateQuoteLeverage({\n *   quantity: 1_000_000_000_000_000_000n,\n *   requestedOpenPrice: 50_000_000_000_000_000_000n,\n *   lockedValues: { cva: 1_000_000_000_000_000_000n, lf: 500_000_000_000_000_000n, partyAmm: 1_500_000_000_000_000_000n },\n * });\n * ```\n */\nexport function calculateQuoteLeverage(parameters: CalculateQuoteLeverageParameters): string {\n  const referencePriceWei = leveragePriceOf(parameters);\n  const quantity = Number(formatUnits(parameters.quantity, WEI_DECIMALS));\n  const referencePrice = Number(formatUnits(referencePriceWei, WEI_DECIMALS));\n  const lockedSum = Number(\n    formatUnits(\n      parameters.lockedValues.cva +\n        parameters.lockedValues.lf +\n        parameters.lockedValues.partyAmm +\n        parameters.lockedValues.partyBmm,\n      WEI_DECIMALS,\n    ),\n  );\n  if (!Number.isFinite(quantity) || !Number.isFinite(referencePrice) || !Number.isFinite(lockedSum)) return \"0\";\n  if (lockedSum === 0) return \"0\";\n  const leverage = (quantity * referencePrice) / lockedSum;\n  if (!Number.isFinite(leverage)) return \"0\";\n  return String(leverage);\n}\n"],"mappings":";;;AAIA,IAAM,IAAe;AAqCrB,SAAgB,EAAuB,GAAsD;CAC3F,IAAM,IAAoB,EAAgB,CAAU,GAC9C,IAAW,OAAO,EAAY,EAAW,UAAU,CAAY,CAAC,GAChE,IAAiB,OAAO,EAAY,GAAmB,CAAY,CAAC,GACpE,IAAY,OAChB,EACE,EAAW,aAAa,MACtB,EAAW,aAAa,KACxB,EAAW,aAAa,WACxB,EAAW,aAAa,UAC1B,CACF,CACF;CAEA,IADI,CAAC,OAAO,SAAS,CAAQ,KAAK,CAAC,OAAO,SAAS,CAAc,KAAK,CAAC,OAAO,SAAS,CAAS,KAC5F,MAAc,GAAG,OAAO;CAC5B,IAAM,IAAY,IAAW,IAAkB;CAE/C,OADK,OAAO,SAAS,CAAQ,IACtB,OAAO,CAAQ,IADiB;AAEzC"}

package/dist/quotes/upnl/calculate-quote-upnl-wei.d.ts

@@ -0,0 +1,39 @@
+import { PositionType } from '../../symmio-contracts/symmio/types.js';
+/**
+ * Inputs for {@link calculateQuoteUpnlWei}. All amounts are 18-decimal wei.
+ */
+export interface CalculateQuoteUpnlWeiParameters {
+    /** Trade side — flips the sign of the mark-vs-open difference. */
+    positionType: PositionType;
+    /** Remaining open size (`quantity − closedAmount`), wei. */
+    openQuantity: bigint;
+    /** Settled open price, wei. */
+    openedPrice: bigint;
+    /** Current mark price, wei. */
+    markPrice: bigint;
+}
+/**
+ * A single position's unrealized PnL as a signed 18-decimal wei `bigint`:
+ *
+ * `upnl = openQuantity × (markPrice − openedPrice)` for LONG, negated for
+ * SHORT, rescaled to wei.
+ *
+ * The exact-`bigint` sibling of `calculateQuoteUpnl` (which formats decimal
+ * strings for display): use this wherever the uPnL feeds further wei math —
+ * e.g. summing an account's positions for `calculateAvailableForOrder`.
+ *
+ * @param parameters - Side, open size, open price, and mark price.
+ * @returns The signed unrealized PnL, wei.
+ *
+ * @example
+ * ```ts
+ * const upnl = calculateQuoteUpnlWei({
+ *   positionType: PositionType.LONG,
+ *   openQuantity: 2n * 10n ** 18n,
+ *   openedPrice: 100n * 10n ** 18n,
+ *   markPrice: 110n * 10n ** 18n,
+ * }); // → 20e18
+ * ```
+ */
+export declare function calculateQuoteUpnlWei(parameters: CalculateQuoteUpnlWeiParameters): bigint;
+//# sourceMappingURL=calculate-quote-upnl-wei.d.ts.map

package/dist/quotes/upnl/calculate-quote-upnl-wei.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-quote-upnl-wei.d.ts","sourceRoot":"","sources":["../../../src/quotes/upnl/calculate-quote-upnl-wei.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,kEAAkE;IAClE,YAAY,EAAE,YAAY,CAAC;IAC3B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,+BAA+B,GAAG,MAAM,CAIzF"}

package/dist/quotes/upnl/calculate-quote-upnl-wei.js

@@ -0,0 +1,11 @@
+import { PositionType as e } from "../../symmio-contracts/symmio/types.js";
+import { WEI as t } from "../../shared/utils/wei.js";
+//#region src/quotes/upnl/calculate-quote-upnl-wei.ts
+function n(n) {
+	let r = n.markPrice - n.openedPrice, i = n.positionType === e.LONG ? r : -r;
+	return n.openQuantity * i / t;
+}
+//#endregion
+export { n as calculateQuoteUpnlWei };
+
+//# sourceMappingURL=calculate-quote-upnl-wei.js.map

package/dist/quotes/upnl/calculate-quote-upnl-wei.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-quote-upnl-wei.js","names":[],"sources":["../../../src/quotes/upnl/calculate-quote-upnl-wei.ts"],"sourcesContent":["import { WEI } from \"../../shared/utils/wei\";\nimport { PositionType } from \"../../symmio-contracts/symmio/types\";\n\n/**\n * Inputs for {@link calculateQuoteUpnlWei}. All amounts are 18-decimal wei.\n */\nexport interface CalculateQuoteUpnlWeiParameters {\n  /** Trade side — flips the sign of the mark-vs-open difference. */\n  positionType: PositionType;\n  /** Remaining open size (`quantity − closedAmount`), wei. */\n  openQuantity: bigint;\n  /** Settled open price, wei. */\n  openedPrice: bigint;\n  /** Current mark price, wei. */\n  markPrice: bigint;\n}\n\n/**\n * A single position's unrealized PnL as a signed 18-decimal wei `bigint`:\n *\n * `upnl = openQuantity × (markPrice − openedPrice)` for LONG, negated for\n * SHORT, rescaled to wei.\n *\n * The exact-`bigint` sibling of `calculateQuoteUpnl` (which formats decimal\n * strings for display): use this wherever the uPnL feeds further wei math —\n * e.g. summing an account's positions for `calculateAvailableForOrder`.\n *\n * @param parameters - Side, open size, open price, and mark price.\n * @returns The signed unrealized PnL, wei.\n *\n * @example\n * ```ts\n * const upnl = calculateQuoteUpnlWei({\n *   positionType: PositionType.LONG,\n *   openQuantity: 2n * 10n ** 18n,\n *   openedPrice: 100n * 10n ** 18n,\n *   markPrice: 110n * 10n ** 18n,\n * }); // → 20e18\n * ```\n */\nexport function calculateQuoteUpnlWei(parameters: CalculateQuoteUpnlWeiParameters): bigint {\n  const difference = parameters.markPrice - parameters.openedPrice;\n  const signed = parameters.positionType === PositionType.LONG ? difference : -difference;\n  return (parameters.openQuantity * signed) / WEI;\n}\n"],"mappings":";;;AAwCA,SAAgB,EAAsB,GAAqD;CACzF,IAAM,IAAa,EAAW,YAAY,EAAW,aAC/C,IAAS,EAAW,iBAAiB,EAAa,OAAO,IAAa,CAAC;CAC7E,OAAQ,EAAW,eAAe,IAAU;AAC9C"}