@symmio/trading-react 1.1.0 → 3.0.0

package/dist/quotes/use-managed-quotes.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-managed-quotes.js","names":[],"sources":["../../src/quotes/use-managed-quotes.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  classifyQuoteNotificationAction,\n  getInstantClosesQueryKey,\n  getInstantOpensQueryKey,\n  getPartyAOpenPositionsQueryKey,\n  getPartyAOpenPositionsQueryOptions,\n  getPartyAPendingQuotesQueryKey,\n  getPartyAPendingQuotesQueryOptions,\n  getPredictedNextVirtualAccountQueryOptions,\n  getQuoteQueryKey,\n  getQuoteQueryOptions,\n  isolationTypeForSide,\n  QuoteLifecycle,\n  reconcileQuotes,\n  shouldAccelerateOnchainReads,\n  type Notification,\n  type Quote,\n  type ReconcileQuotesResult,\n  type SocketStatus,\n  type UnifiedQuote,\n} from \"@symmio/trading-core\";\nimport { useQueries, useQueryClient } from \"@tanstack/react-query\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { getAddress, type Address } from \"viem\";\nimport { useVirtualAccountsAddressesOfSubAccount } from \"../account-layer/use-virtual-accounts-addresses-of-sub-account\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useInstantCloses } from \"../instant-layer/use-instant-closes\";\nimport { useInstantOpens } from \"../instant-layer/use-instant-opens\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { useTpSlStore } from \"../tpsl/tpsl-store\";\nimport { predicateMatch } from \"../utils\";\nimport { useNotifications } from \"../websocket/use-notifications\";\nimport { useOptimisticQuotesStore } from \"./optimistic-quotes-store\";\n\n/**\n * Baseline poll interval (ms) used **only as a fallback** when the live event channel\n * is unavailable (`live` is off, or the notifications socket is not `open`). With the\n * socket up the feature is events-first: there is no idle on-chain poll unless the\n * consumer opts into one via `pollingInterval`.\n */\nconst FALLBACK_POLLING_INTERVAL = 5_000;\n\n/** Accelerated quote-polling interval (ms) while a row is mid-transition. */\nconst ACCELERATED_POLLING_INTERVAL = 1_500;\n\n/**\n * Cap on the live-notification buffer fed back into the merge. Reconciliation is\n * idempotent over already-applied notifications, so only a recent window is kept\n * to bound memory and reprocessing.\n *\n * TODO: check this and packages/trading-react/src/quotes/use-managed-quotes.ts#L188-L206\n */\nconst NOTIFICATION_BUFFER_LIMIT = 100;\n\n/** Stable empty array so the `accounts` memo doesn't churn while no VAs are retained. */\nconst NO_RETAINED_VAS: readonly Address[] = [];\n\n/** Debounce (ms) for coalescing a burst of notifications into one set of read invalidations. */\nconst NOTIFICATION_INVALIDATE_DEBOUNCE = 250;\n\n/**\n * Lifecycle stages that mean an open is in flight, so the hedger instant-opens\n * feed is worth polling. Outside these stages the feed has nothing new (a\n * settled position is tracked by the on-chain reads), so polling it is wasted.\n */\nconst OPEN_INTENT_LIFECYCLES = new Set<QuoteLifecycle>([\n  QuoteLifecycle.OPTIMISTIC,\n  QuoteLifecycle.PRICE_FILLED,\n  QuoteLifecycle.WRITE_ONCHAIN,\n]);\n\n/**\n * Lifecycle stages that mean a close is in flight, so the hedger instant-closes\n * feed is worth polling. Outside these stages there is no pending close, so\n * polling the feed (merely holding open positions) is wasted.\n */\nconst CLOSE_INTENT_LIFECYCLES = new Set<QuoteLifecycle>([QuoteLifecycle.WRITE_ONCHAIN_CLOSE, QuoteLifecycle.CLOSING]);\n\n/**\n * Which underlying quote sources {@link useManagedQuotes} should read. Every\n * source defaults to `true`; set one to `false` to skip its query/subscription\n * entirely (e.g. a screen that never opens instant trades).\n */\nexport interface ManagedQuotesSources {\n  /** Read on-chain open positions via `usePartyAOpenPositions`. Default `true`. */\n  openPositions?: boolean;\n  /** Read on-chain pending quote ids (hydrated per-id) via `usePartyAPendingQuotes`. Default `true`. */\n  pendingQuotes?: boolean;\n  /** Read pending instant-opens from the hedger via `useInstantOpens`. Default `true`. */\n  instantOpens?: boolean;\n  /** Read pending instant-closes from the hedger via `useInstantCloses`. Default `true`. */\n  instantCloses?: boolean;\n}\n\n/**\n * Parameters for {@link useManagedQuotes}.\n */\nexport interface UseManagedQuotesParameters {\n  /** Sub-account (partyA) to manage quotes for. The hook is idle until this is set. */\n  partyA?: Address;\n  /** Target chain id. Defaults to the connected chain. */\n  chainId?: number;\n  /**\n   * Opt-in idle polling cadence (ms). **Default off** — with `live` notifications the\n   * feature is events-first: it does not poll at idle, only (a) accelerates on-chain\n   * reads briefly while a row awaits on-chain confirmation (the RPC-lag retry), and\n   * (b) falls back to a baseline poll when the event channel is down. Set this to make\n   * it poll on a fixed cadence regardless (e.g. a live-inspector panel).\n   */\n  pollingInterval?: number;\n  /** Subscribe to the live notifications stream. Default `true`; set `false` for poll-only. */\n  live?: boolean;\n  /** Master switch. When `false` every source is idle regardless of `sources`. Default `true`. */\n  enabled?: boolean;\n  /**\n   * Union the sub-account's existing on-chain Virtual Accounts (VAs) — plus the\n   * predicted VAs of its pending instant-opens and any VAs seen on the\n   * notifications stream — into the on-chain reads. In lowcap each isolated\n   * position lives under a VA, so this is required to see the full picture.\n   * Default `true`.\n   */\n  includeVirtualAccounts?: boolean;\n  /** Extra accounts to read quotes across (e.g. VAs already known to the consumer). */\n  extraAccounts?: readonly Address[];\n  /** Per-source toggles; omit to read every source. */\n  sources?: ManagedQuotesSources;\n}\n\n/**\n * Value returned by {@link useManagedQuotes}.\n */\nexport interface UseManagedQuotesResult {\n  /** Merged, de-duplicated, lifecycle-tagged rows, newest first. */\n  quotes: UnifiedQuote[];\n  /** The same rows indexed by their stable {@link UnifiedQuote.key}. */\n  byKey: Record<string, UnifiedQuote>;\n  /** The on-chain `partyA` accounts the quotes were read across (sub-account + VAs + predicted + extras). */\n  accounts: Address[];\n  /** `true` while any enabled source has not produced its first result. */\n  isLoading: boolean;\n  /** `true` while any enabled source is fetching (background refetch included). */\n  isFetching: boolean;\n  /** Live connection status of the notifications socket (`\"closed\"` when `live` is off). */\n  socketStatus: SocketStatus;\n  /** The first error surfaced by any source, normalized, or `null`. */\n  error: SymmioRequestError | null;\n  /** Force every enabled source to refetch immediately. */\n  refetch: () => void;\n}\n\n/**\n * Orchestrate every quote source for one sub-account — fanned out across every\n * account that holds its positions — into a single, stable, lifecycle-tagged\n * table.\n *\n * In lowcap, isolated positions live under Virtual Accounts (VAs), so a\n * sub-account's quotes are spread across its VAs rather than the sub-account\n * itself. This resolves the full account set — the sub-account, its existing\n * VAs (`useVirtualAccountsAddressesOfSubAccount`), the predicted VAs of its\n * pending instant-opens (`getPredictedNextVirtualAccount`), VAs seen on the\n * notifications stream, and any `extraAccounts` — then reads\n * `getPartyAOpenPositions` and `getPartyAPendingQuotes` (+ per-id `getQuote`\n * hydration) across that set via `useQueries`. Off-chain hedger reads\n * (`useInstantOpens` / `useInstantCloses`) stay scoped to the sub-account.\n *\n * Every source is gated by `sources`, `enabled`, and a set `partyA`, then their\n * snapshots flow through the pure core `reconcileQuotes` (\"active quotes only\" —\n * a quote shows iff it is in a source this tick), stamping each optimistic\n * instant-open with its predicted VA via `instantOpenVaByTempId`. Live\n * notifications (via `useNotifications`, unless `live` is `false`) are applied in\n * the same merge. With `live` notifications the feature is **events-first**: it does\n * not poll at idle, only accelerating the on-chain reads briefly while a row awaits\n * on-chain confirmation (`shouldAccelerateOnchainReads`, the RPC-lag retry), and\n * falling back to a baseline poll only when the event channel is down.\n *\n * Optimistic instant-opens seeded into {@link useOptimisticQuotesStore} are\n * merged in as extra `instantOpens` so a just-submitted trade shows instantly,\n * then cleared once the same `tempQuoteId` lands on-chain.\n *\n * @example\n * ```tsx\n * const { quotes, accounts, socketStatus, isLoading } = useManagedQuotes({ partyA });\n * ```\n */\nexport function useManagedQuotes(parameters: UseManagedQuotesParameters): UseManagedQuotesResult {\n  const { partyA, chainId, pollingInterval, live = true, enabled = true } = parameters;\n  const config = useSymmioConfig();\n  const defaultChainId = useSymmioChainId();\n  const resolvedChainId = chainId ?? defaultChainId;\n  const includeVirtualAccounts = parameters.includeVirtualAccounts ?? true;\n  const extraAccounts = parameters.extraAccounts;\n  const sources = parameters.sources;\n  const wantOpenPositions = sources?.openPositions ?? true;\n  const wantPendingQuotes = sources?.pendingQuotes ?? true;\n  const wantInstantOpens = sources?.instantOpens ?? true;\n  const wantInstantCloses = sources?.instantCloses ?? true;\n  const active = enabled && Boolean(partyA);\n\n  /**\n   * Identity of the current account set's owner. VA retention (below) is scoped\n   * to this `(chainId, partyA)` so switching sub-accounts never carries another\n   * account's VAs into the read set.\n   */\n  const retentionOwner = active && partyA ? `${resolvedChainId}:${partyA.toLowerCase()}` : undefined;\n\n  /**\n   * VAs retained across the optimistic→on-chain hand-off. A predicted VA leaves\n   * `predictedVas` the instant its instant-open lands on-chain (the hedger drops\n   * the pending open), while `getVirtualAccountsAddressesOfSubAccount` and the\n   * notification `va_address` can lag a poll behind — so without retention we'd\n   * stop polling the exact VA the position just landed in, and the row would\n   * vanish for a tick before reappearing as its `ONCHAIN` twin. VAs are\n   * append-only on-chain, so once discovered we keep reading them while the owner\n   * is unchanged. See reference-va-address-resolution in agent memory.\n   */\n  const [retained, setRetained] = useState<{ owner?: string; vas: Address[] }>({ vas: [] });\n  const retainedVas = retained.owner === retentionOwner ? retained.vas : NO_RETAINED_VAS;\n\n  /**\n   * Notification-driven invalidation. Reads are kept in sync off the live\n   * notifications stream — not polling — so the feature works with polling off.\n   * `queryClient` and the cache scope (`configKey`) are mirrored into refs so the\n   * `onNotification` callback below can stay referentially stable (a new callback\n   * identity would resubscribe the socket). The debounce timer coalesces a burst\n   * of notifications into one invalidation pass.\n   */\n  const queryClient = useQueryClient();\n  const queryClientRef = useRef(queryClient);\n  queryClientRef.current = queryClient;\n  const configKey = config.getChainConfigKey(resolvedChainId);\n  const configKeyRef = useRef(configKey);\n  configKeyRef.current = configKey;\n  const invalidateTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n  /**\n   * Which hedger feeds a debounced notification burst should invalidate. A burst\n   * can mix open and close events, so the kinds are accumulated here across the\n   * debounce window and read (then reset) when the timer fires — scoping the\n   * invalidation to the feeds the events can actually affect.\n   */\n  const pendingInvalidationRef = useRef<{ opens: boolean; closes: boolean }>({ opens: false, closes: false });\n\n  /**\n   * Last reconciliation result, kept in a ref so it survives renders without\n   * triggering one. Its only remaining job is to feed\n   * {@link shouldAccelerateOnchainReads} (and the feed-intent gates) the previous\n   * tick's result, since the source queries set their `refetchInterval` before this\n   * render's result exists. (\"Active quotes only\" dropped the grace window, and\n   * `links` are recomputed fresh on each merge.)\n   */\n  const previousRef = useRef<ReconcileQuotesResult | undefined>(undefined);\n\n  /**\n   * Rows anchored on a prior tick (a notification set their `quoteId`) but not yet\n   * returned by the on-chain read — the previous merge's `pendingAnchors`. Fed back\n   * into {@link reconcileQuotes} so an anchored row keeps showing while the RPC\n   * catches up, instead of vanishing once the hedger drops its pending open. Held in\n   * a ref so it survives renders without triggering one; the source query that\n   * dropped the row drives the recompute that reads it.\n   */\n  const retainedAnchorsRef = useRef<UnifiedQuote[]>([]);\n\n  /**\n   * Last tick's socket status, read one render behind (like `previousRef`) to decide\n   * whether the live event channel is up. Updated right after `useNotifications` below.\n   * When the channel is live the feature is events-first (no idle poll); when it is\n   * down we fall back to polling so state still advances without notifications.\n   */\n  const socketStatusRef = useRef<SocketStatus>(\"closed\");\n\n  const optimisticEntries = useOptimisticQuotesStore((state) => state.entries);\n  const clearSettled = useOptimisticQuotesStore((state) => state.clearSettled);\n\n  /** Live event channel = subscribed (`live`) and the socket was `open` last render. */\n  const eventChannelLive = live && socketStatusRef.current === \"open\";\n  /** Consumer's opt-in idle cadence (off by default). */\n  const idleInterval = pollingInterval && pollingInterval > 0 ? pollingInterval : false;\n\n  /**\n   * On-chain reads accelerate to {@link ACCELERATED_POLLING_INTERVAL} **only** while a\n   * row awaits on-chain confirmation (`WRITE_ONCHAIN` / `WRITE_ONCHAIN_CLOSE` /\n   * `CLOSING`) — the RPC-lag retry. Otherwise: no idle poll when the event channel is\n   * live (events drive updates) unless the consumer opted into `idleInterval`; a\n   * baseline fallback when the channel is down so state still progresses. Read from the\n   * previous result because the queries set their interval before this render's result\n   * exists (an on-chain poll / notification re-render advances it a tick later).\n   */\n  const accelerateOnchain = previousRef.current ? shouldAccelerateOnchainReads(previousRef.current) : false;\n  const onchainIdleInterval = eventChannelLive ? idleInterval : idleInterval || FALLBACK_POLLING_INTERVAL;\n  const refetchInterval = active ? (accelerateOnchain ? ACCELERATED_POLLING_INTERVAL : onchainIdleInterval) : false;\n\n  /**\n   * Hedger feeds are event-driven while the channel is live: the open/close mutation\n   * invalidates the matching feed once and the notifications advance the stage, so they\n   * do not poll (unless the consumer opted into `idleInterval`). When the channel is\n   * down they poll while the matching flow is in flight, to track it without\n   * notifications. `hasOpenIntent` / `hasCloseIntent` come from the previous tick.\n   */\n  const previousQuotes = previousRef.current?.quotes;\n  const hasOpenIntent = previousQuotes?.some((quote) => OPEN_INTENT_LIFECYCLES.has(quote.lifecycle)) ?? false;\n  const hasCloseIntent = previousQuotes?.some((quote) => CLOSE_INTENT_LIFECYCLES.has(quote.lifecycle)) ?? false;\n  const feedInterval = (hasIntent: boolean) =>\n    !eventChannelLive && hasIntent ? ACCELERATED_POLLING_INTERVAL : idleInterval;\n  const instantOpensInterval = active && wantInstantOpens ? feedInterval(hasOpenIntent) : false;\n  const instantClosesInterval = active && wantInstantCloses ? feedInterval(hasCloseIntent) : false;\n\n  /**\n   * Off-chain hedger reads — always scoped to the sub-account, never the VAs. Kept\n   * `enabled` so a mutation's `onSuccess` invalidation can fetch them on demand, but\n   * polled only while the matching flow is in flight (see the interval gates above).\n   */\n  const instantOpens = useInstantOpens({\n    partyA: partyA as Address,\n    chainId: resolvedChainId,\n    query: { enabled: active && wantInstantOpens, refetchInterval: instantOpensInterval },\n  });\n\n  const instantCloses = useInstantCloses({\n    partyA: partyA as Address,\n    chainId: resolvedChainId,\n    query: { enabled: active && wantInstantCloses, refetchInterval: instantClosesInterval },\n  });\n\n  /** The sub-account's existing on-chain VAs. Empty (harmless) when `partyA` is itself a VA. */\n  const virtualAccounts = useVirtualAccountsAddressesOfSubAccount({\n    subAccount: partyA,\n    chainId: resolvedChainId,\n    query: { enabled: active && includeVirtualAccounts, refetchInterval },\n  });\n\n  /**\n   * Brand-new-VA bridge: a position can open in a market the sub-account has\n   * never traded, landing in a freshly created VA that is not yet in\n   * `getVirtualAccountsAddressesOfSubAccount`. The predicted VA below covers it\n   * while the instant-open is pending; once it lands on-chain the hedger drops the\n   * open and the prediction with it, so VA retention (`retained`, above) keeps the\n   * VA in the poll set across the hand-off — the row transitions to `ONCHAIN` in\n   * place instead of flickering out and back.\n   */\n\n  /**\n   * Predict the VA each pending instant-open will land in. The set of opens is\n   * dynamic, but `useQueries` over a dynamic array is allowed — the hook count\n   * stays one regardless of length.\n   */\n  const pendingOpens = wantInstantOpens ? (instantOpens.data ?? []) : [];\n  const predictedVas = useQueries({\n    queries: pendingOpens.map((open) => ({\n      ...getPredictedNextVirtualAccountQueryOptions(config, {\n        subAccount: partyA,\n        chainId: resolvedChainId,\n        isolationType: isolationTypeForSide(open.positionType),\n        symbolId: BigInt(open.marketId),\n        query: { enabled: active && includeVirtualAccounts, refetchInterval },\n      }),\n    })),\n    combine: (results) => ({\n      byTempId: pendingOpens.reduce<Record<number, Address>>((map, open, index) => {\n        const predicted = results[index]?.data;\n        if (predicted) map[open.tempQuoteId] = getAddress(predicted);\n        return map;\n      }, {}),\n      addresses: results.map((result) => result.data).filter((address): address is Address => Boolean(address)),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n    }),\n  });\n\n  const [notifications, setNotifications] = useState<Notification[]>([]);\n  const { status: socketStatus } = useNotifications({\n    account: partyA,\n    chainId: resolvedChainId,\n    enabled: active && live,\n    onNotification: useCallback((notification: Notification) => {\n      setNotifications((prev) => [...prev, notification].slice(-NOTIFICATION_BUFFER_LIMIT));\n      // Solver notification carries both `tempQuoteId` and the on-chain\n      // `quoteId` on the frame that anchors a pre-chain quote. Link the two\n      // in the TP/SL store so a record that was written under the temp id\n      // (via `useSetQuoteTpSl` post-instant-open) is instantly reachable via\n      // the on-chain id once the anchor lands — no re-fetch needed.\n      const tempId = notification.tempQuoteId;\n      const onchainStr = notification.quoteId;\n      if (tempId && onchainStr && onchainStr !== `${tempId}`) {\n        useTpSlStore.getState().link(BigInt(tempId), BigInt(onchainStr));\n      }\n      /**\n       * Refetch the authoritative reads off the live event so both tables stay in\n       * sync without polling. The on-chain reads always refresh (any lifecycle event\n       * can change them); the hedger feeds refresh only for the matching flow, so an\n       * open event never re-fetches the closes feed and vice versa. Kinds are\n       * accumulated across the debounce window because a burst can mix open and close\n       * events. Scoped to this chain (`configKey`); React Query dedups concurrent\n       * refetches of the same query.\n       */\n      const kind = classifyQuoteNotificationAction(notification.lastSeenAction);\n      const pending = pendingInvalidationRef.current;\n      if (kind === \"open\") pending.opens = true;\n      else if (kind === \"close\") pending.closes = true;\n      else {\n        pending.opens = true;\n        pending.closes = true;\n      }\n      if (invalidateTimerRef.current) clearTimeout(invalidateTimerRef.current);\n      invalidateTimerRef.current = setTimeout(() => {\n        const client = queryClientRef.current;\n        const scope = { configKey: configKeyRef.current };\n        const { opens, closes } = pendingInvalidationRef.current;\n        pendingInvalidationRef.current = { opens: false, closes: false };\n        void client.invalidateQueries({ predicate: predicateMatch(getPartyAOpenPositionsQueryKey, scope) });\n        void client.invalidateQueries({ predicate: predicateMatch(getPartyAPendingQuotesQueryKey, scope) });\n        void client.invalidateQueries({ predicate: predicateMatch(getQuoteQueryKey, scope) });\n        if (opens) void client.invalidateQueries({ predicate: predicateMatch(getInstantOpensQueryKey, scope) });\n        if (closes) void client.invalidateQueries({ predicate: predicateMatch(getInstantClosesQueryKey, scope) });\n      }, NOTIFICATION_INVALIDATE_DEBOUNCE);\n    }, []),\n  });\n\n  /** Mirror the live socket status into the ref the interval gating reads next render. */\n  socketStatusRef.current = socketStatus;\n\n  /**\n   * One-shot re-sync when the notifications socket **reconnects**. The stream does not\n   * replay messages missed while it was down, so on a re-`open` we invalidate the reads\n   * once to catch up — this replaces a continuous fallback poll. The first connect is\n   * skipped (the queries already fetched on mount).\n   */\n  const hasBeenOpenRef = useRef(false);\n  useEffect(() => {\n    if (!live || socketStatus !== \"open\") return;\n    if (hasBeenOpenRef.current) {\n      const client = queryClientRef.current;\n      const scope = { configKey: configKeyRef.current };\n      void client.invalidateQueries({ predicate: predicateMatch(getPartyAOpenPositionsQueryKey, scope) });\n      void client.invalidateQueries({ predicate: predicateMatch(getPartyAPendingQuotesQueryKey, scope) });\n      void client.invalidateQueries({ predicate: predicateMatch(getQuoteQueryKey, scope) });\n      void client.invalidateQueries({ predicate: predicateMatch(getInstantOpensQueryKey, scope) });\n      void client.invalidateQueries({ predicate: predicateMatch(getInstantClosesQueryKey, scope) });\n    }\n    hasBeenOpenRef.current = true;\n  }, [socketStatus, live]);\n\n  /** Clear the pending invalidation timer on unmount. */\n  useEffect(() => {\n    return () => {\n      if (invalidateTimerRef.current) clearTimeout(invalidateTimerRef.current);\n    };\n  }, []);\n\n  /** Distinct VA addresses seen on the notifications stream. */\n  const notificationVas = useMemo<Address[]>(() => {\n    const seen = new Set<string>();\n    const result: Address[] = [];\n    for (const notification of notifications) {\n      if (!notification.vaAddress) continue;\n      const checksummed = getAddress(notification.vaAddress);\n      const lower = checksummed.toLowerCase();\n      if (seen.has(lower)) continue;\n      seen.add(lower);\n      result.push(checksummed);\n    }\n    return result;\n  }, [notifications]);\n\n  /**\n   * The deduplicated (case-insensitive), checksummed set of on-chain accounts to\n   * read quotes across — the sub-account, its VAs, the predicted VAs, the\n   * notification VAs, and any extras. Order: sub-account first, then the rest.\n   */\n  const accounts = useMemo<Address[]>(() => {\n    if (!active || !partyA) return [];\n    const seen = new Set<string>();\n    const result: Address[] = [];\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      result.push(checksummed);\n    };\n    add(partyA);\n    if (includeVirtualAccounts) {\n      for (const virtualAccount of virtualAccounts.data ?? []) add(virtualAccount);\n      for (const predicted of predictedVas.addresses) add(predicted);\n      for (const notificationVa of notificationVas) add(notificationVa);\n      for (const retainedVa of retainedVas) add(retainedVa);\n    }\n    for (const extra of extraAccounts ?? []) add(extra);\n    return result;\n  }, [\n    active,\n    partyA,\n    includeVirtualAccounts,\n    virtualAccounts.data,\n    predictedVas.addresses,\n    notificationVas,\n    retainedVas,\n    extraAccounts,\n  ]);\n\n  /**\n   * Accumulate every VA we discover (list + predicted + notification) into the\n   * retained set so none ever leaves the poll set mid-hand-off. Monotonic per\n   * owner; resets when the owner `(chainId, partyA)` changes. Setting state only\n   * when something new appears keeps this from looping.\n   */\n  useEffect(() => {\n    if (!retentionOwner) return;\n    const discovered = [...(virtualAccounts.data ?? []), ...predictedVas.addresses, ...notificationVas];\n    setRetained((prev) => {\n      const carryOver = prev.owner === retentionOwner ? prev.vas : [];\n      const seen = new Set(carryOver.map((address) => address.toLowerCase()));\n      const next = [...carryOver];\n      let changed = prev.owner !== retentionOwner;\n      for (const va of discovered) {\n        const checksummed = getAddress(va);\n        const lower = checksummed.toLowerCase();\n        if (seen.has(lower)) continue;\n        seen.add(lower);\n        next.push(checksummed);\n        changed = true;\n      }\n      return changed ? { owner: retentionOwner, vas: next } : prev;\n    });\n  }, [retentionOwner, virtualAccounts.data, predictedVas.addresses, notificationVas]);\n\n  /** On-chain open positions, fanned out across every account, flattened to one `Quote[]`. */\n  const openPositions = useQueries({\n    queries: accounts.map((account) => {\n      const options = getPartyAOpenPositionsQueryOptions(config, {\n        partyA: account,\n        chainId: resolvedChainId,\n        query: { enabled: active && wantOpenPositions, refetchInterval },\n      });\n      return {\n        ...options,\n        queryFn: async () => {\n          try {\n            return await options.queryFn();\n          } catch (err) {\n            throw normalizeSymmError(err);\n          }\n        },\n      };\n    }),\n    combine: (results) => ({\n      quotes: results.flatMap((result) => result.data ?? []),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n      error: (results.find((result) => result.error)?.error as SymmioRequestError | undefined) ?? null,\n      refetch: () => results.forEach((result) => result.refetch()),\n    }),\n  });\n  /** Pending quote ids, fanned out across every account, then hydrated per id. */\n  const pendingQuoteIds = useQueries({\n    queries: accounts.map((account) => {\n      const options = getPartyAPendingQuotesQueryOptions(config, {\n        partyA: account,\n        chainId: resolvedChainId,\n        query: { enabled: active && wantPendingQuotes, refetchInterval },\n      });\n      return {\n        ...options,\n        queryFn: async () => {\n          try {\n            return await options.queryFn();\n          } catch (err) {\n            throw normalizeSymmError(err);\n          }\n        },\n      };\n    }),\n    combine: (results) => ({\n      ids: results.flatMap((result) => result.data ?? []),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n      error: (results.find((result) => result.error)?.error as SymmioRequestError | undefined) ?? null,\n      refetch: () => results.forEach((result) => result.refetch()),\n    }),\n  });\n\n  const hydratedPending = useQueries({\n    queries: pendingQuoteIds.ids.map((quoteId) => {\n      const options = getQuoteQueryOptions(config, {\n        quoteId,\n        chainId: resolvedChainId,\n        query: { enabled: active && wantPendingQuotes, refetchInterval },\n      });\n      return {\n        ...options,\n        queryFn: async () => {\n          try {\n            return await options.queryFn();\n          } catch (err) {\n            throw normalizeSymmError(err);\n          }\n        },\n      };\n    }),\n    combine: (results) => ({\n      quotes: results.map((result) => result.data).filter((quote): quote is Quote => Boolean(quote)),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n      error: (results.find((result) => result.error)?.error as SymmioRequestError | undefined) ?? null,\n    }),\n  });\n\n  const result = useMemo<ReconcileQuotesResult>(() => {\n    if (!active || !partyA) {\n      previousRef.current = undefined;\n      retainedAnchorsRef.current = [];\n      return { quotes: [], links: {}, pendingAnchors: [] };\n    }\n    const seededInstantOpens = [...(instantOpens.data ?? []), ...Object.values(optimisticEntries)];\n    const next = reconcileQuotes({\n      partyA,\n      onchainPositions: wantOpenPositions ? openPositions.quotes : [],\n      onchainPendingQuotes: wantPendingQuotes ? hydratedPending.quotes : [],\n      instantOpens: wantInstantOpens ? seededInstantOpens : [],\n      instantCloses: wantInstantCloses ? (instantCloses.data ?? []) : [],\n      instantOpenVaByTempId: predictedVas.byTempId,\n      notifications,\n      retainedAnchors: retainedAnchorsRef.current,\n    });\n    previousRef.current = next;\n    retainedAnchorsRef.current = next.pendingAnchors;\n    return next;\n  }, [\n    active,\n    partyA,\n    openPositions.quotes,\n    hydratedPending.quotes,\n    instantOpens.data,\n    instantCloses.data,\n    predictedVas.byTempId,\n    optimisticEntries,\n    notifications,\n    wantOpenPositions,\n    wantPendingQuotes,\n    wantInstantOpens,\n    wantInstantCloses,\n  ]);\n\n  const byKey = useMemo<Record<string, UnifiedQuote>>(() => {\n    const map: Record<string, UnifiedQuote> = {};\n    for (const quote of result.quotes) map[quote.key] = quote;\n    return map;\n  }, [result.quotes]);\n\n  /**\n   * Drop optimistic seeds once their `tempQuoteId` has been **confirmed by the\n   * on-chain read** — the linked row carries the polled struct (`raw.onchain`).\n   * Clearing on the notification link alone would drop the seed while the row is\n   * still `WRITE_ONCHAIN`, before any source but the notification holds it, so the\n   * row would flicker out until the RPC catches up.\n   */\n  useEffect(() => {\n    const settled = Object.keys(optimisticEntries)\n      .map(Number)\n      .filter((tempQuoteId) => {\n        const key = result.links[tempQuoteId];\n        return key !== undefined && byKey[key]?.raw.onchain !== undefined;\n      });\n    if (settled.length > 0) clearSettled(settled);\n  }, [result, byKey, optimisticEntries, clearSettled]);\n\n  const isLoading =\n    (active && includeVirtualAccounts && virtualAccounts.isLoading) ||\n    (active && includeVirtualAccounts && predictedVas.isLoading) ||\n    (active && wantOpenPositions && openPositions.isLoading) ||\n    (active && wantPendingQuotes && (pendingQuoteIds.isLoading || hydratedPending.isLoading)) ||\n    (active && wantInstantOpens && instantOpens.isLoading) ||\n    (active && wantInstantCloses && instantCloses.isLoading);\n\n  const isFetching =\n    (includeVirtualAccounts && (virtualAccounts.isFetching || predictedVas.isFetching)) ||\n    (wantOpenPositions && openPositions.isFetching) ||\n    (wantPendingQuotes && (pendingQuoteIds.isFetching || hydratedPending.isFetching)) ||\n    (wantInstantOpens && instantOpens.isFetching) ||\n    (wantInstantCloses && instantCloses.isFetching);\n\n  const error =\n    openPositions.error ??\n    pendingQuoteIds.error ??\n    hydratedPending.error ??\n    virtualAccounts.error ??\n    instantOpens.error ??\n    instantCloses.error ??\n    null;\n\n  /**\n   * `openPositions` / `pendingQuoteIds` are `useQueries` fan-outs (no single\n   * query handle), so their combined results expose a `refetch` that fires every\n   * per-account query. Refetching the ids re-drives the per-id hydration.\n   */\n  const refetchOpenPositions = openPositions.refetch;\n  const refetchPendingQuoteIds = pendingQuoteIds.refetch;\n  const refetch = useCallback(() => {\n    if (includeVirtualAccounts) virtualAccounts.refetch();\n    if (wantOpenPositions) refetchOpenPositions();\n    if (wantPendingQuotes) refetchPendingQuoteIds();\n    if (wantInstantOpens) instantOpens.refetch();\n    if (wantInstantCloses) instantCloses.refetch();\n  }, [\n    includeVirtualAccounts,\n    wantOpenPositions,\n    wantPendingQuotes,\n    wantInstantOpens,\n    wantInstantCloses,\n    virtualAccounts,\n    refetchOpenPositions,\n    refetchPendingQuoteIds,\n    instantOpens,\n    instantCloses,\n  ]);\n\n  return {\n    quotes: result.quotes,\n    byKey,\n    accounts,\n    isLoading: Boolean(isLoading),\n    isFetching: Boolean(isFetching),\n    socketStatus: live ? socketStatus : \"closed\",\n    error,\n    refetch,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-managed-quotes.js","names":[],"sources":["../../src/quotes/use-managed-quotes.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  classifyQuoteNotificationAction,\n  getInstantClosesQueryKey,\n  getInstantOpensQueryKey,\n  getPartyAOpenPositionsQueryKey,\n  getPartyAOpenPositionsQueryOptions,\n  getPartyAPendingQuotesQueryKey,\n  getPartyAPendingQuotesQueryOptions,\n  getPredictedNextVirtualAccountQueryOptions,\n  getQuoteQueryKey,\n  getQuoteQueryOptions,\n  isCancelAction,\n  isCloseFillAction,\n  isolationTypeForSide,\n  isOpenAnchorAction,\n  NotificationType,\n  QuoteLifecycle,\n  reconcileQuotes,\n  shouldAccelerateOnchainReads,\n  type Notification,\n  type Quote,\n  type ReconcileQuotesResult,\n  type SocketStatus,\n  type UnifiedQuote,\n} from \"@symmio/trading-core\";\nimport { useQueries, useQueryClient, type QueryClient } from \"@tanstack/react-query\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { getAddress, type Address } from \"viem\";\nimport { useVirtualAccountsAddressesOfSubAccount } from \"../account-layer/use-virtual-accounts-addresses-of-sub-account\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useInstantCloses } from \"../instant-layer/use-instant-closes\";\nimport { useInstantOpens } from \"../instant-layer/use-instant-opens\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { useTpSlStore } from \"../tpsl/tpsl-store\";\nimport { invalidateAccountBalances, predicateMatch } from \"../utils\";\nimport { useNotifications } from \"../websocket/use-notifications\";\nimport {\n  nextConfirmDelay,\n  pruneCancelConfirmHold,\n  pruneCloseConfirmHold,\n  pruneOpenConfirmHold,\n  type CloseConfirmEntry,\n} from \"./confirm-hold\";\nimport { useOptimisticQuotesStore } from \"./optimistic-quotes-store\";\n\n/**\n * Baseline poll interval (ms) used **only as a fallback** when the live event channel\n * is unavailable (`live` is off, or the notifications socket is not `open`). With the\n * socket up the feature is events-first: there is no idle on-chain poll unless the\n * consumer opts into one via `pollingInterval`.\n */\nconst FALLBACK_POLLING_INTERVAL = 5_000;\n\n/** Accelerated quote-polling interval (ms) while a row is mid-transition. */\nconst ACCELERATED_POLLING_INTERVAL = 1_500;\n\n/**\n * Confirm-hold backoff (see `openConfirmRef` / `closeConfirmRef` / `pumpConfirm`).\n * A notification reports a state change the on-chain read lags behind, so the reads\n * are refetched immediately and then again on a backoff that starts at\n * {@link CONFIRM_FIRST_DELAY}, doubles each round, and caps at\n * {@link CONFIRM_MAX_INTERVAL} — until the chain reflects the change or the total\n * {@link CONFIRM_MAX_MS} budget passes. It covers both directions:\n *\n * - an **open** anchor (`SendQuoteTransaction` & friends), which the solver emits when\n *   it *broadcasts* the transaction: the single invalidation that frame triggers races\n *   the block and usually loses, and it is the last frame of an instant open, so\n *   without the chase the position stays invisible until something else refetches;\n * - a **close** fill, the rasa case where the quote lingers OPENED after\n *   `FillMarketOrderInstantClose` and the settle lags;\n * - a **cancel** request, where the confirming transaction is the solver's\n *   `acceptCancelRequest` and is never announced at all (see\n *   {@link CANCEL_CONFIRM_MAX_MS}).\n */\nconst CONFIRM_FIRST_DELAY = 500;\n/** Ceiling for the doubling confirm-hold backoff interval (ms). */\nconst CONFIRM_MAX_INTERVAL = 60_000;\n/** Total budget (ms) to chase a reported change before giving up (a stuck / failed action). */\nconst CONFIRM_MAX_MS = 120_000;\n/**\n * Budget (ms) for the **cancel** confirm hold, longer than {@link CONFIRM_MAX_MS}\n * because a cancel can legitimately sit unanswered far longer than an open or a\n * close: `requestToCancelQuote` on a `LOCKED` quote only asks, and partyA cannot\n * force the issue until the market-agent force-cancel cooldown elapses (150 s on\n * Base at the time of writing, read from `coolDownsOfMA()[1]`). Giving up at two\n * minutes would go blind right as that window closes. The backoff is capped at\n * {@link CONFIRM_MAX_INTERVAL}, so a long wait costs about one read per minute, and\n * the hold releases itself the moment the chain drops the quote.\n */\nconst CANCEL_CONFIRM_MAX_MS = 600_000;\n\n/**\n * Cap on the live-notification buffer fed back into the merge. Reconciliation is\n * idempotent over already-applied notifications, so only a recent window is kept\n * to bound memory and reprocessing.\n *\n * TODO: check this and packages/trading-react/src/quotes/use-managed-quotes.ts#L188-L206\n */\nconst NOTIFICATION_BUFFER_LIMIT = 100;\n\n/** Stable empty array so the `accounts` memo doesn't churn while no VAs are retained. */\nconst NO_RETAINED_VAS: readonly Address[] = [];\n\n/**\n * Invalidate the authoritative on-chain quote reads for one chain scope — the open\n * positions and the pending-quote ids, fanned out across every account. Scoped by\n * `configKey`, so another chain's cache is untouched; React Query dedups concurrent\n * refetches of the same query.\n */\nfunction invalidateOnchainQuoteReads(client: QueryClient, scope: { configKey: string }): void {\n  void client.invalidateQueries({ predicate: predicateMatch(getPartyAOpenPositionsQueryKey, scope) });\n  void client.invalidateQueries({ predicate: predicateMatch(getPartyAPendingQuotesQueryKey, scope) });\n}\n\n/** Debounce (ms) for coalescing a burst of notifications into one set of read invalidations. */\nconst NOTIFICATION_INVALIDATE_DEBOUNCE = 250;\n\n/**\n * Lifecycle stages that mean an open is in flight, so the hedger instant-opens\n * feed is worth polling. Outside these stages the feed has nothing new (a\n * settled position is tracked by the on-chain reads), so polling it is wasted.\n */\nconst OPEN_INTENT_LIFECYCLES = new Set<QuoteLifecycle>([\n  QuoteLifecycle.OPTIMISTIC,\n  QuoteLifecycle.PRICE_FILLED,\n  QuoteLifecycle.WRITE_ONCHAIN,\n]);\n\n/**\n * Lifecycle stages that mean a close is in flight, so the hedger instant-closes\n * feed is worth polling. Outside these stages there is no in-flight close (the\n * close has either not started or already landed on-chain, where the feed drops\n * it and the close-confirm hold takes over), so polling the feed is wasted.\n */\nconst CLOSE_INTENT_LIFECYCLES = new Set<QuoteLifecycle>([QuoteLifecycle.WRITE_ONCHAIN_CLOSE]);\n\n/**\n * Which underlying quote sources {@link useManagedQuotes} should read. Every\n * source defaults to `true`; set one to `false` to skip its query/subscription\n * entirely (e.g. a screen that never opens instant trades).\n */\nexport interface ManagedQuotesSources {\n  /** Read on-chain open positions via `usePartyAOpenPositions`. Default `true`. */\n  openPositions?: boolean;\n  /** Read on-chain pending quote ids (hydrated per-id) via `usePartyAPendingQuotes`. Default `true`. */\n  pendingQuotes?: boolean;\n  /** Read pending instant-opens from the hedger via `useInstantOpens`. Default `true`. */\n  instantOpens?: boolean;\n  /** Read pending instant-closes from the hedger via `useInstantCloses`. Default `true`. */\n  instantCloses?: boolean;\n}\n\n/**\n * Parameters for {@link useManagedQuotes}.\n */\nexport interface UseManagedQuotesParameters {\n  /** Sub-account (partyA) to manage quotes for. The hook is idle until this is set. */\n  partyA?: Address;\n  /** Target chain id. Defaults to the connected chain. */\n  chainId?: number;\n  /**\n   * Opt-in idle polling cadence (ms). **Default off** — with `live` notifications the\n   * feature is events-first: it does not poll at idle, only (a) accelerates on-chain\n   * reads briefly while a row awaits on-chain confirmation (the RPC-lag retry), and\n   * (b) falls back to a baseline poll when the event channel is down. Set this to make\n   * it poll on a fixed cadence regardless (e.g. a live-inspector panel).\n   */\n  pollingInterval?: number;\n  /** Subscribe to the live notifications stream. Default `true`; set `false` for poll-only. */\n  live?: boolean;\n  /** Master switch. When `false` every source is idle regardless of `sources`. Default `true`. */\n  enabled?: boolean;\n  /**\n   * Union the sub-account's existing on-chain Virtual Accounts (VAs) — plus the\n   * predicted VAs of its pending instant-opens and any VAs seen on the\n   * notifications stream — into the on-chain reads. In lowcap each isolated\n   * position lives under a VA, so this is required to see the full picture.\n   * Default `true`.\n   */\n  includeVirtualAccounts?: boolean;\n  /** Extra accounts to read quotes across (e.g. VAs already known to the consumer). */\n  extraAccounts?: readonly Address[];\n  /** Per-source toggles; omit to read every source. */\n  sources?: ManagedQuotesSources;\n}\n\n/**\n * Value returned by {@link useManagedQuotes}.\n */\nexport interface UseManagedQuotesResult {\n  /** Merged, de-duplicated, lifecycle-tagged rows, newest first. */\n  quotes: UnifiedQuote[];\n  /** The same rows indexed by their stable {@link UnifiedQuote.key}. */\n  byKey: Record<string, UnifiedQuote>;\n  /** The on-chain `partyA` accounts the quotes were read across (sub-account + VAs + predicted + extras). */\n  accounts: Address[];\n  /** `true` while any enabled source has not produced its first result. */\n  isLoading: boolean;\n  /** `true` while any enabled source is fetching (background refetch included). */\n  isFetching: boolean;\n  /** Live connection status of the notifications socket (`\"closed\"` when `live` is off). */\n  socketStatus: SocketStatus;\n  /** The first error surfaced by any source, normalized, or `null`. */\n  error: SymmioRequestError | null;\n  /** Force every enabled source to refetch immediately. */\n  refetch: () => void;\n}\n\n/**\n * Orchestrate every quote source for one sub-account — fanned out across every\n * account that holds its positions — into a single, stable, lifecycle-tagged\n * table.\n *\n * In lowcap, isolated positions live under Virtual Accounts (VAs), so a\n * sub-account's quotes are spread across its VAs rather than the sub-account\n * itself. This resolves the full account set — the sub-account, its existing\n * VAs (`useVirtualAccountsAddressesOfSubAccount`), the predicted VAs of its\n * pending instant-opens (`getPredictedNextVirtualAccount`), VAs seen on the\n * notifications stream, and any `extraAccounts` — then reads\n * `getPartyAOpenPositions` and `getPartyAPendingQuotes` (+ per-id `getQuote`\n * hydration) across that set via `useQueries`. Off-chain hedger reads\n * (`useInstantOpens` / `useInstantCloses`) stay scoped to the sub-account.\n *\n * Every source is gated by `sources`, `enabled`, and a set `partyA`, then their\n * snapshots flow through the pure core `reconcileQuotes` (\"active quotes only\" —\n * a quote shows iff it is in a source this tick), stamping each optimistic\n * instant-open with its predicted VA via `instantOpenVaByTempId`. Live\n * notifications (via `useNotifications`, unless `live` is `false`) are applied in\n * the same merge. With `live` notifications the feature is **events-first**: it does\n * not poll at idle, only accelerating the on-chain reads briefly while a row awaits\n * on-chain confirmation (`shouldAccelerateOnchainReads`, the RPC-lag retry), and\n * falling back to a baseline poll only when the event channel is down.\n *\n * Optimistic instant-opens seeded into {@link useOptimisticQuotesStore} are\n * merged in as extra `instantOpens` so a just-submitted trade shows instantly,\n * then cleared once the same `tempQuoteId` lands on-chain.\n *\n * @example\n * ```tsx\n * const { quotes, accounts, socketStatus, isLoading } = useManagedQuotes({ partyA });\n * ```\n */\nexport function useManagedQuotes(parameters: UseManagedQuotesParameters): UseManagedQuotesResult {\n  const { partyA, chainId, pollingInterval, live = true, enabled = true } = parameters;\n  const config = useSymmioConfig();\n  const defaultChainId = useSymmioChainId();\n  const resolvedChainId = chainId ?? defaultChainId;\n  const includeVirtualAccounts = parameters.includeVirtualAccounts ?? true;\n  const extraAccounts = parameters.extraAccounts;\n  const sources = parameters.sources;\n  const wantOpenPositions = sources?.openPositions ?? true;\n  const wantPendingQuotes = sources?.pendingQuotes ?? true;\n  const wantInstantOpens = sources?.instantOpens ?? true;\n  const wantInstantCloses = sources?.instantCloses ?? true;\n  const active = enabled && Boolean(partyA);\n\n  /**\n   * Identity of the current account set's owner. VA retention (below) is scoped\n   * to this `(chainId, partyA)` so switching sub-accounts never carries another\n   * account's VAs into the read set.\n   */\n  const retentionOwner = active && partyA ? `${resolvedChainId}:${partyA.toLowerCase()}` : undefined;\n\n  /**\n   * VAs retained across the optimistic→on-chain hand-off. A predicted VA leaves\n   * `predictedVas` the instant its instant-open lands on-chain (the hedger drops\n   * the pending open), while `getVirtualAccountsAddressesOfSubAccount` and the\n   * notification `va_address` can lag a poll behind — so without retention we'd\n   * stop polling the exact VA the position just landed in, and the row would\n   * vanish for a tick before reappearing as its `ONCHAIN` twin. VAs are\n   * append-only on-chain, so once discovered we keep reading them while the owner\n   * is unchanged. See reference-va-address-resolution in agent memory.\n   */\n  const [retained, setRetained] = useState<{ owner?: string; vas: Address[] }>({ vas: [] });\n  const retainedVas = retained.owner === retentionOwner ? retained.vas : NO_RETAINED_VAS;\n\n  /**\n   * Notification-driven invalidation. Reads are kept in sync off the live\n   * notifications stream — not polling — so the feature works with polling off.\n   * `queryClient` and the cache scope (`configKey`) are mirrored into refs so the\n   * `onNotification` callback below can stay referentially stable (a new callback\n   * identity would resubscribe the socket). The debounce timer coalesces a burst\n   * of notifications into one invalidation pass.\n   */\n  const queryClient = useQueryClient();\n  const queryClientRef = useRef(queryClient);\n  queryClientRef.current = queryClient;\n  const configKey = config.getChainConfigKey(resolvedChainId);\n  const configKeyRef = useRef(configKey);\n  configKeyRef.current = configKey;\n  const invalidateTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n  /**\n   * Which hedger feeds a debounced notification burst should invalidate. A burst\n   * can mix open and close events, so the kinds are accumulated here across the\n   * debounce window and read (then reset) when the timer fires — scoping the\n   * invalidation to the feeds the events can actually affect.\n   */\n  const pendingInvalidationRef = useRef<{ opens: boolean; closes: boolean }>({ opens: false, closes: false });\n\n  /**\n   * Last reconciliation result, kept in a ref so it survives renders without\n   * triggering one. Its only remaining job is to feed\n   * {@link shouldAccelerateOnchainReads} (and the feed-intent gates) the previous\n   * tick's result, since the source queries set their `refetchInterval` before this\n   * render's result exists. (\"Active quotes only\" dropped the grace window, and\n   * `links` are recomputed fresh on each merge.)\n   */\n  const previousRef = useRef<ReconcileQuotesResult | undefined>(undefined);\n\n  /**\n   * Open-confirm hold: on-chain quoteId → deadline (ms). An open-anchor notification\n   * (`onNotification`) records the quote here and kicks off `pumpConfirm`, which\n   * refetches the on-chain reads on a doubling backoff until the read returns the\n   * quote. The solver emits that frame when it *broadcasts* the transaction, so the\n   * one invalidation it triggers races the block — and it is the **last** frame of an\n   * instant open, so nothing else would ever re-read: with the event channel live\n   * there is no idle poll, and the accelerated retry needs a `WRITE_ONCHAIN` row,\n   * which only exists if a pre-chain row from the hedger feed was still there to\n   * anchor. Entries are pruned once the polled struct lands or the\n   * {@link CONFIRM_MAX_MS} budget passes.\n   */\n  const openConfirmRef = useRef<Map<string, number>>(new Map());\n  /**\n   * Close-confirm hold: on-chain quoteId → deadline (ms). A close notification\n   * (`onNotification`) records the quote here and kicks off `pumpConfirm`, which\n   * refetches the on-chain reads on a doubling backoff until the chain reflects the\n   * close — the rasa case, where the quote lingers OPENED after\n   * `FillMarketOrderInstantClose` and the stateless reconcile reverts the row to\n   * `ONCHAIN`. Entries are pruned once the chain confirms the close (row dropped /\n   * closed) or the {@link CONFIRM_MAX_MS} budget passes; when every map empties the\n   * backoff stops.\n   */\n  const closeConfirmRef = useRef<Map<string, CloseConfirmEntry>>(new Map());\n  /**\n   * Cancel-confirm hold: on-chain quoteId → deadline (ms). A cancel notification\n   * (`onNotification`) records the quote here and kicks off `pumpConfirm`, which\n   * refetches the on-chain reads on a doubling backoff until the chain settles the\n   * cancel. Cancelling a `LOCKED` order takes two transactions and only the first is\n   * announced: `requestToCancelQuote` moves the quote to `CANCEL_PENDING` and leaves\n   * it in `partyAPendingQuotes`, then the solver's `acceptCancelRequest` sets\n   * `CANCELED` and removes it — with **no** notification frame. A `CANCEL_PENDING`\n   * row is lifecycle `ONCHAIN`, so it accelerates nothing either; without this chase\n   * the cancelled order stays on screen indefinitely. Entries are pruned once the\n   * chain drops the quote or the {@link CANCEL_CONFIRM_MAX_MS} budget passes.\n   */\n  const cancelConfirmRef = useRef<Map<string, number>>(new Map());\n  /** Pending confirm-hold backoff timer (the next scheduled refetch), if any. */\n  const confirmTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n  /** Current confirm-hold backoff interval (ms); doubles each round up to the cap. */\n  const confirmDelayRef = useRef(CONFIRM_FIRST_DELAY);\n  /** Latest `pumpConfirm`, called from the backoff timer (assigned below each render). */\n  const pumpConfirmRef = useRef<() => void>(() => {});\n\n  /**\n   * (Re)start the confirm-hold backoff from its first delay — called whenever a\n   * notification registers a new hold, so a fresh event always gets a prompt retry\n   * even if a long-running chase had already backed off to the cap. Stable (refs\n   * only), so it never re-creates `onNotification` and never resubscribes the socket.\n   */\n  const restartConfirmChase = useCallback(() => {\n    confirmDelayRef.current = CONFIRM_FIRST_DELAY;\n    if (confirmTimerRef.current) clearTimeout(confirmTimerRef.current);\n    confirmTimerRef.current = setTimeout(() => pumpConfirmRef.current(), CONFIRM_FIRST_DELAY);\n  }, []);\n\n  /**\n   * Rows anchored on a prior tick (a notification set their `quoteId`) but not yet\n   * returned by the on-chain read — the previous merge's `pendingAnchors`. Fed back\n   * into {@link reconcileQuotes} so an anchored row keeps showing while the RPC\n   * catches up, instead of vanishing once the hedger drops its pending open. Held in\n   * a ref so it survives renders without triggering one; the source query that\n   * dropped the row drives the recompute that reads it.\n   */\n  const retainedAnchorsRef = useRef<UnifiedQuote[]>([]);\n\n  /**\n   * Last tick's socket status, read one render behind (like `previousRef`) to decide\n   * whether the live event channel is up. Updated right after `useNotifications` below.\n   * When the channel is live the feature is events-first (no idle poll); when it is\n   * down we fall back to polling so state still advances without notifications.\n   */\n  const socketStatusRef = useRef<SocketStatus>(\"closed\");\n\n  const optimisticEntries = useOptimisticQuotesStore((state) => state.entries);\n  const clearSettled = useOptimisticQuotesStore((state) => state.clearSettled);\n\n  /** Live event channel = subscribed (`live`) and the socket was `open` last render. */\n  const eventChannelLive = live && socketStatusRef.current === \"open\";\n  /** Consumer's opt-in idle cadence (off by default). */\n  const idleInterval = pollingInterval && pollingInterval > 0 ? pollingInterval : false;\n\n  /**\n   * On-chain reads accelerate to {@link ACCELERATED_POLLING_INTERVAL} **only** while a\n   * row awaits on-chain confirmation (`WRITE_ONCHAIN` / `WRITE_ONCHAIN_CLOSE` /\n   * `CLOSING`) — the RPC-lag retry. (An anchor or a close the read has not caught up\n   * with is chased separately by `pumpConfirm`'s backoff, which needs no row at all,\n   * not by this steady interval.) Otherwise:\n   * no idle poll when the event channel is live (events drive updates) unless the\n   * consumer opted into `idleInterval`; a baseline fallback when the channel is down so\n   * state still progresses. Read from the previous result because the queries set their\n   * interval before this render's result exists (an on-chain poll / notification\n   * re-render advances it a tick later).\n   */\n  const accelerateOnchain = previousRef.current ? shouldAccelerateOnchainReads(previousRef.current) : false;\n  const onchainIdleInterval = eventChannelLive ? idleInterval : idleInterval || FALLBACK_POLLING_INTERVAL;\n  const refetchInterval = active ? (accelerateOnchain ? ACCELERATED_POLLING_INTERVAL : onchainIdleInterval) : false;\n\n  /**\n   * Hedger feeds are event-driven while the channel is live: the open/close mutation\n   * invalidates the matching feed once and the notifications advance the stage, so they\n   * do not poll (unless the consumer opted into `idleInterval`). When the channel is\n   * down they poll while the matching flow is in flight, to track it without\n   * notifications. `hasOpenIntent` / `hasCloseIntent` come from the previous tick.\n   */\n  const previousQuotes = previousRef.current?.quotes;\n  const hasOpenIntent = previousQuotes?.some((quote) => OPEN_INTENT_LIFECYCLES.has(quote.lifecycle)) ?? false;\n  const hasCloseIntent = previousQuotes?.some((quote) => CLOSE_INTENT_LIFECYCLES.has(quote.lifecycle)) ?? false;\n  const feedInterval = (hasIntent: boolean) =>\n    !eventChannelLive && hasIntent ? ACCELERATED_POLLING_INTERVAL : idleInterval;\n  const instantOpensInterval = active && wantInstantOpens ? feedInterval(hasOpenIntent) : false;\n  const instantClosesInterval = active && wantInstantCloses ? feedInterval(hasCloseIntent) : false;\n\n  /**\n   * Off-chain hedger reads — always scoped to the sub-account, never the VAs. Kept\n   * `enabled` so a mutation's `onSuccess` invalidation can fetch them on demand, but\n   * polled only while the matching flow is in flight (see the interval gates above).\n   */\n  const instantOpens = useInstantOpens({\n    partyA: partyA as Address,\n    chainId: resolvedChainId,\n    query: { enabled: active && wantInstantOpens, refetchInterval: instantOpensInterval },\n  });\n\n  const instantCloses = useInstantCloses({\n    partyA: partyA as Address,\n    chainId: resolvedChainId,\n    query: { enabled: active && wantInstantCloses, refetchInterval: instantClosesInterval },\n  });\n\n  /** The sub-account's existing on-chain VAs. Empty (harmless) when `partyA` is itself a VA. */\n  const virtualAccounts = useVirtualAccountsAddressesOfSubAccount({\n    subAccount: partyA,\n    chainId: resolvedChainId,\n    query: { enabled: active && includeVirtualAccounts, refetchInterval },\n  });\n\n  /**\n   * Brand-new-VA bridge: a position can open in a market the sub-account has\n   * never traded, landing in a freshly created VA that is not yet in\n   * `getVirtualAccountsAddressesOfSubAccount`. The predicted VA below covers it\n   * while the instant-open is pending; once it lands on-chain the hedger drops the\n   * open and the prediction with it, so VA retention (`retained`, above) keeps the\n   * VA in the poll set across the hand-off — the row transitions to `ONCHAIN` in\n   * place instead of flickering out and back.\n   */\n\n  /**\n   * Predict the VA each pending instant-open will land in. The set of opens is\n   * dynamic, but `useQueries` over a dynamic array is allowed — the hook count\n   * stays one regardless of length.\n   */\n  const pendingOpens = wantInstantOpens ? (instantOpens.data ?? []) : [];\n  const predictedVas = useQueries({\n    queries: pendingOpens.map((open) => ({\n      ...getPredictedNextVirtualAccountQueryOptions(config, {\n        subAccount: partyA,\n        chainId: resolvedChainId,\n        isolationType: isolationTypeForSide(open.positionType),\n        symbolId: BigInt(open.marketId),\n        query: { enabled: active && includeVirtualAccounts, refetchInterval },\n      }),\n    })),\n    combine: (results) => ({\n      byTempId: pendingOpens.reduce<Record<number, Address>>((map, open, index) => {\n        const predicted = results[index]?.data;\n        if (predicted) map[open.tempQuoteId] = getAddress(predicted);\n        return map;\n      }, {}),\n      addresses: results.map((result) => result.data).filter((address): address is Address => Boolean(address)),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n    }),\n  });\n\n  const [notifications, setNotifications] = useState<Notification[]>([]);\n  const { status: socketStatus } = useNotifications({\n    account: partyA,\n    chainId: resolvedChainId,\n    enabled: active && live,\n    onNotification: useCallback(\n      (notification: Notification) => {\n        setNotifications((prev) => [...prev, notification].slice(-NOTIFICATION_BUFFER_LIMIT));\n        // Solver notification carries both `tempQuoteId` and the on-chain\n        // `quoteId` on the frame that anchors a pre-chain quote. Link the two\n        // in the TP/SL store so a record that was written under the temp id\n        // (via `useSetQuoteTpSl` post-instant-open) is instantly reachable via\n        // the on-chain id once the anchor lands — no re-fetch needed.\n        const tempId = notification.tempQuoteId;\n        const onchainStr = notification.quoteId;\n        if (tempId && onchainStr && onchainStr !== \"0\" && onchainStr !== `${tempId}`) {\n          useTpSlStore.getState().link(BigInt(tempId), BigInt(onchainStr));\n        }\n        /**\n         * Refetch the authoritative reads off the live event so both tables stay in\n         * sync without polling. The on-chain reads always refresh (any lifecycle event\n         * can change them); the hedger feeds refresh only for the matching flow, so an\n         * open event never re-fetches the closes feed and vice versa. Kinds are\n         * accumulated across the debounce window because a burst can mix open and close\n         * events. Scoped to this chain (`configKey`); React Query dedups concurrent\n         * refetches of the same query.\n         */\n        const kind = classifyQuoteNotificationAction(notification.lastSeenAction);\n        const pending = pendingInvalidationRef.current;\n        if (kind === \"open\") pending.opens = true;\n        else if (kind === \"close\") pending.closes = true;\n        else {\n          pending.opens = true;\n          pending.closes = true;\n        }\n        /**\n         * The quote **anchored on-chain**: the solver reports this when it broadcasts\n         * the transaction, so the read is typically still a block behind and the\n         * debounced invalidation below lands on the pre-anchor state. Register the hold\n         * and chase it (`pumpConfirm`) until the read returns the quote — this is the\n         * last frame of an instant open, so without the chase a confirmed position can\n         * stay out of the table indefinitely. Only for a `SUCCESS` frame carrying a real\n         * on-chain id (still-off-chain frames repeat the negative temp id), so a\n         * reverted anchor is not chased for the full budget.\n         */\n        if (\n          notification.type === NotificationType.SUCCESS &&\n          isOpenAnchorAction(notification.lastSeenAction) &&\n          onchainStr &&\n          onchainStr !== \"0\" &&\n          onchainStr !== `${tempId}`\n        ) {\n          openConfirmRef.current.set(onchainStr, Date.now() + CONFIRM_MAX_MS);\n          invalidateOnchainQuoteReads(queryClientRef.current, { configKey: configKeyRef.current });\n          restartConfirmChase();\n        }\n        // Close *filled* successfully (not merely requested, and not a failed fill):\n        // refetch the on-chain reads immediately, then chase the settle on a doubling\n        // backoff (`pumpConfirm`) until the chain reflects it or the budget passes.\n        // Covers rasa, where the quote lingers OPENED after `FillMarketOrderInstantClose`\n        // and the row would otherwise revert to ONCHAIN before the settle lands. The\n        // `closedAmount` at fill-time is captured so a **partial** settle (closedAmount\n        // advances, quote stays OPENED) releases the hold instead of hanging at \"closing\".\n        if (\n          notification.type === NotificationType.SUCCESS &&\n          isCloseFillAction(notification.lastSeenAction) &&\n          onchainStr &&\n          onchainStr !== \"0\"\n        ) {\n          const baseClosed = previousRef.current?.quotes.find((q) => `${q.quoteId}` === onchainStr)?.closedAmount ?? 0n;\n          closeConfirmRef.current.set(onchainStr, { deadline: Date.now() + CONFIRM_MAX_MS, baseClosed });\n          invalidateOnchainQuoteReads(queryClientRef.current, { configKey: configKeyRef.current });\n          restartConfirmChase();\n        }\n        // A close that **failed** (reverted / rejected): release the hold so the row\n        // drops back to its on-chain state (still OPENED) instead of hanging at\n        // `WRITE_ONCHAIN_CLOSE`, and re-read in case the revert moved anything.\n        if (\n          notification.type === NotificationType.FAILED &&\n          classifyQuoteNotificationAction(notification.lastSeenAction) === \"close\" &&\n          onchainStr &&\n          onchainStr !== \"0\"\n        ) {\n          closeConfirmRef.current.delete(onchainStr);\n          invalidateOnchainQuoteReads(queryClientRef.current, { configKey: configKeyRef.current });\n        }\n        /**\n         * A cancel was **requested**. The frame arrives around the time the request\n         * transaction is broadcast, so the debounced invalidation below still reads\n         * `LOCKED` or at best `CANCEL_PENDING` — and the transaction that actually ends\n         * the order, the solver's `acceptCancelRequest`, is never announced. Register\n         * the hold and chase the read until the chain drops the quote. Unlike the open\n         * anchor this deliberately does **not** require `type === SUCCESS`: a failed\n         * cancel frame still means the chain may have moved, and the hold costs one read\n         * that releases itself immediately if nothing changed.\n         */\n        if (isCancelAction(notification.lastSeenAction) && onchainStr && onchainStr !== \"0\") {\n          cancelConfirmRef.current.set(onchainStr, Date.now() + CANCEL_CONFIRM_MAX_MS);\n          invalidateOnchainQuoteReads(queryClientRef.current, { configKey: configKeyRef.current });\n          invalidateAccountBalances(queryClientRef.current, { configKey: configKeyRef.current });\n          restartConfirmChase();\n        }\n        if (invalidateTimerRef.current) clearTimeout(invalidateTimerRef.current);\n        invalidateTimerRef.current = setTimeout(() => {\n          const client = queryClientRef.current;\n          const scope = { configKey: configKeyRef.current };\n          const { opens, closes } = pendingInvalidationRef.current;\n          pendingInvalidationRef.current = { opens: false, closes: false };\n          invalidateOnchainQuoteReads(client, scope);\n          void client.invalidateQueries({ predicate: predicateMatch(getQuoteQueryKey, scope) });\n          if (opens) void client.invalidateQueries({ predicate: predicateMatch(getInstantOpensQueryKey, scope) });\n          if (closes) void client.invalidateQueries({ predicate: predicateMatch(getInstantClosesQueryKey, scope) });\n        }, NOTIFICATION_INVALIDATE_DEBOUNCE);\n      },\n      [restartConfirmChase],\n    ),\n  });\n\n  /** Mirror the live socket status into the ref the interval gating reads next render. */\n  socketStatusRef.current = socketStatus;\n\n  /**\n   * One-shot re-sync when the notifications socket **reconnects**. The stream does not\n   * replay messages missed while it was down, so on a re-`open` we invalidate the reads\n   * once to catch up — this replaces a continuous fallback poll. The first connect is\n   * skipped (the queries already fetched on mount).\n   */\n  const hasBeenOpenRef = useRef(false);\n  useEffect(() => {\n    if (!live || socketStatus !== \"open\") return;\n    if (hasBeenOpenRef.current) {\n      const client = queryClientRef.current;\n      const scope = { configKey: configKeyRef.current };\n      invalidateOnchainQuoteReads(client, scope);\n      void client.invalidateQueries({ predicate: predicateMatch(getQuoteQueryKey, scope) });\n      void client.invalidateQueries({ predicate: predicateMatch(getInstantOpensQueryKey, scope) });\n      void client.invalidateQueries({ predicate: predicateMatch(getInstantClosesQueryKey, scope) });\n    }\n    hasBeenOpenRef.current = true;\n  }, [socketStatus, live]);\n\n  /** Clear the pending invalidation timer on unmount. */\n  useEffect(() => {\n    return () => {\n      if (invalidateTimerRef.current) clearTimeout(invalidateTimerRef.current);\n    };\n  }, []);\n\n  /** Distinct VA addresses seen on the notifications stream. */\n  const notificationVas = useMemo<Address[]>(() => {\n    const seen = new Set<string>();\n    const result: Address[] = [];\n    for (const notification of notifications) {\n      if (!notification.vaAddress) continue;\n      const checksummed = getAddress(notification.vaAddress);\n      const lower = checksummed.toLowerCase();\n      if (seen.has(lower)) continue;\n      seen.add(lower);\n      result.push(checksummed);\n    }\n    return result;\n  }, [notifications]);\n\n  /**\n   * The deduplicated (case-insensitive), checksummed set of on-chain accounts to\n   * read quotes across — the sub-account, its VAs, the predicted VAs, the\n   * notification VAs, and any extras. Order: sub-account first, then the rest.\n   */\n  const accounts = useMemo<Address[]>(() => {\n    if (!active || !partyA) return [];\n    const seen = new Set<string>();\n    const result: Address[] = [];\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      result.push(checksummed);\n    };\n    add(partyA);\n    if (includeVirtualAccounts) {\n      for (const virtualAccount of virtualAccounts.data ?? []) add(virtualAccount);\n      for (const predicted of predictedVas.addresses) add(predicted);\n      for (const notificationVa of notificationVas) add(notificationVa);\n      for (const retainedVa of retainedVas) add(retainedVa);\n    }\n    for (const extra of extraAccounts ?? []) add(extra);\n    return result;\n  }, [\n    active,\n    partyA,\n    includeVirtualAccounts,\n    virtualAccounts.data,\n    predictedVas.addresses,\n    notificationVas,\n    retainedVas,\n    extraAccounts,\n  ]);\n\n  /**\n   * Accumulate every VA we discover (list + predicted + notification) into the\n   * retained set so none ever leaves the poll set mid-hand-off. Monotonic per\n   * owner; resets when the owner `(chainId, partyA)` changes. Setting state only\n   * when something new appears keeps this from looping.\n   */\n  useEffect(() => {\n    if (!retentionOwner) return;\n    const discovered = [...(virtualAccounts.data ?? []), ...predictedVas.addresses, ...notificationVas];\n    setRetained((prev) => {\n      const carryOver = prev.owner === retentionOwner ? prev.vas : [];\n      const seen = new Set(carryOver.map((address) => address.toLowerCase()));\n      const next = [...carryOver];\n      let changed = prev.owner !== retentionOwner;\n      for (const va of discovered) {\n        const checksummed = getAddress(va);\n        const lower = checksummed.toLowerCase();\n        if (seen.has(lower)) continue;\n        seen.add(lower);\n        next.push(checksummed);\n        changed = true;\n      }\n      return changed ? { owner: retentionOwner, vas: next } : prev;\n    });\n  }, [retentionOwner, virtualAccounts.data, predictedVas.addresses, notificationVas]);\n\n  /** On-chain open positions, fanned out across every account, flattened to one `Quote[]`. */\n  const openPositions = useQueries({\n    queries: accounts.map((account) => {\n      const options = getPartyAOpenPositionsQueryOptions(config, {\n        partyA: account,\n        chainId: resolvedChainId,\n        query: { enabled: active && wantOpenPositions, refetchInterval },\n      });\n      return {\n        ...options,\n        queryFn: async () => {\n          try {\n            return await options.queryFn();\n          } catch (err) {\n            throw normalizeSymmError(err);\n          }\n        },\n      };\n    }),\n    combine: (results) => ({\n      quotes: results.flatMap((result) => result.data ?? []),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n      error: (results.find((result) => result.error)?.error as SymmioRequestError | undefined) ?? null,\n      refetch: () => results.forEach((result) => result.refetch()),\n    }),\n  });\n  /** Pending quote ids, fanned out across every account, then hydrated per id. */\n  const pendingQuoteIds = useQueries({\n    queries: accounts.map((account) => {\n      const options = getPartyAPendingQuotesQueryOptions(config, {\n        partyA: account,\n        chainId: resolvedChainId,\n        query: { enabled: active && wantPendingQuotes, refetchInterval },\n      });\n      return {\n        ...options,\n        queryFn: async () => {\n          try {\n            return await options.queryFn();\n          } catch (err) {\n            throw normalizeSymmError(err);\n          }\n        },\n      };\n    }),\n    combine: (results) => ({\n      ids: results.flatMap((result) => result.data ?? []),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n      error: (results.find((result) => result.error)?.error as SymmioRequestError | undefined) ?? null,\n      refetch: () => results.forEach((result) => result.refetch()),\n    }),\n  });\n\n  const hydratedPending = useQueries({\n    queries: pendingQuoteIds.ids.map((quoteId) => {\n      const options = getQuoteQueryOptions(config, {\n        quoteId,\n        chainId: resolvedChainId,\n        query: { enabled: active && wantPendingQuotes, refetchInterval },\n      });\n      return {\n        ...options,\n        queryFn: async () => {\n          try {\n            return await options.queryFn();\n          } catch (err) {\n            throw normalizeSymmError(err);\n          }\n        },\n      };\n    }),\n    combine: (results) => ({\n      quotes: results.map((result) => result.data).filter((quote): quote is Quote => Boolean(quote)),\n      isLoading: results.some((result) => result.isLoading),\n      isFetching: results.some((result) => result.isFetching),\n      error: (results.find((result) => result.error)?.error as SymmioRequestError | undefined) ?? null,\n    }),\n  });\n\n  const result = useMemo<ReconcileQuotesResult>(() => {\n    if (!active || !partyA) {\n      previousRef.current = undefined;\n      retainedAnchorsRef.current = [];\n      return { quotes: [], links: {}, pendingAnchors: [] };\n    }\n    const seededInstantOpens = [...(instantOpens.data ?? []), ...Object.values(optimisticEntries)];\n    const onchainPositions = wantOpenPositions ? openPositions.quotes : [];\n    /**\n     * On-chain ids whose close is filled-but-unsettled — held at\n     * WRITE_ONCHAIN_CLOSE across ticks so the row does not flash back to \"Opened\"\n     * while the settle mines. Dropped the moment the on-chain `closedAmount` moves\n     * past the fill-time baseline (a partial settle back to a live position); the\n     * full-settle and CLOSE_PENDING cases fall out of the reconcile on their own,\n     * and a failed close already released its hold on the FAILED frame.\n     */\n    const closingQuoteIds: string[] = [];\n    for (const [id, { baseClosed }] of closeConfirmRef.current) {\n      const onchainClosed = onchainPositions.find((q) => `${q.id}` === id)?.closedAmount;\n      if (onchainClosed !== undefined && onchainClosed > baseClosed) continue;\n      closingQuoteIds.push(id);\n    }\n    const next = reconcileQuotes({\n      partyA,\n      onchainPositions,\n      onchainPendingQuotes: wantPendingQuotes ? hydratedPending.quotes : [],\n      instantOpens: wantInstantOpens ? seededInstantOpens : [],\n      instantCloses: wantInstantCloses ? (instantCloses.data ?? []) : [],\n      instantOpenVaByTempId: predictedVas.byTempId,\n      notifications,\n      retainedAnchors: retainedAnchorsRef.current,\n      closingQuoteIds,\n    });\n    previousRef.current = next;\n    retainedAnchorsRef.current = next.pendingAnchors;\n    return next;\n  }, [\n    active,\n    partyA,\n    openPositions.quotes,\n    hydratedPending.quotes,\n    instantOpens.data,\n    instantCloses.data,\n    predictedVas.byTempId,\n    optimisticEntries,\n    notifications,\n    wantOpenPositions,\n    wantPendingQuotes,\n    wantInstantOpens,\n    wantInstantCloses,\n  ]);\n\n  /**\n   * One backoff round for every confirm hold. Prunes the entries the on-chain read has\n   * caught up with — an anchored open the read now returns ({@link pruneOpenConfirmHold}),\n   * a close the chain reflects ({@link pruneCloseConfirmHold}), or a cancel the chain\n   * settled ({@link pruneCancelConfirmHold}), all against the latest reconcile — plus\n   * any whose budget passed; if any map still holds something, refetches the on-chain\n   * reads and reschedules itself with a doubled interval (capped). When they are all\n   * empty it stops, so the chase self-terminates the moment the chain catches up. Reads\n   * only refs, so it always sees the latest quotes / config; reassigned each render and\n   * invoked through {@link pumpConfirmRef} from the timer.\n   */\n  pumpConfirmRef.current = () => {\n    const quotes = previousRef.current?.quotes ?? [];\n    const now = Date.now();\n    const expiredOpens = pruneOpenConfirmHold(openConfirmRef.current, quotes, now);\n    const expiredCloses = pruneCloseConfirmHold(closeConfirmRef.current, quotes, now);\n    const expiredCancels = pruneCancelConfirmHold(cancelConfirmRef.current, quotes, now);\n    if (process.env.NODE_ENV !== \"production\") {\n      if (expiredOpens.length > 0) {\n        console.debug(\"[useManagedQuotes] open-confirm hold expired without on-chain confirmation\", expiredOpens);\n      }\n      if (expiredCloses.length > 0) {\n        console.debug(\"[useManagedQuotes] close-confirm hold expired without on-chain confirmation\", expiredCloses);\n      }\n      if (expiredCancels.length > 0) {\n        console.debug(\"[useManagedQuotes] cancel-confirm hold expired without on-chain confirmation\", expiredCancels);\n      }\n    }\n    if (\n      openConfirmRef.current.size === 0 &&\n      closeConfirmRef.current.size === 0 &&\n      cancelConfirmRef.current.size === 0\n    ) {\n      confirmTimerRef.current = undefined;\n      return;\n    }\n    invalidateOnchainQuoteReads(queryClientRef.current, { configKey: configKeyRef.current });\n    /**\n     * A cancel still in flight also owes the account a refund: `acceptCancelRequest`\n     * (and `forceCancelQuote`) return the open trading fee and release the reserved\n     * margin. That transaction is not the consumer's own — no mutation `onSuccess`\n     * covers it — and no frame announces it, so the balance reads only come back\n     * with this chase. The open and close holds are not included: their balance\n     * moves land in the consumer's own instant-layer mutation, which already\n     * invalidates on success.\n     */\n    if (cancelConfirmRef.current.size > 0) {\n      invalidateAccountBalances(queryClientRef.current, { configKey: configKeyRef.current });\n    }\n    confirmDelayRef.current = nextConfirmDelay(confirmDelayRef.current, CONFIRM_MAX_INTERVAL);\n    confirmTimerRef.current = setTimeout(() => pumpConfirmRef.current(), confirmDelayRef.current);\n  };\n\n  /** Stop the confirm-hold backoff on unmount so a pending timer cannot fire after teardown. */\n  useEffect(\n    () => () => {\n      if (confirmTimerRef.current) clearTimeout(confirmTimerRef.current);\n    },\n    [],\n  );\n\n  const byKey = useMemo<Record<string, UnifiedQuote>>(() => {\n    const map: Record<string, UnifiedQuote> = {};\n    for (const quote of result.quotes) map[quote.key] = quote;\n    return map;\n  }, [result.quotes]);\n\n  /**\n   * Drop optimistic seeds once their `tempQuoteId` has been **confirmed by the\n   * on-chain read** — the linked row carries the polled struct (`raw.onchain`).\n   * Clearing on the notification link alone would drop the seed while the row is\n   * still `WRITE_ONCHAIN`, before any source but the notification holds it, so the\n   * row would flicker out until the RPC catches up.\n   */\n  useEffect(() => {\n    const settled = Object.keys(optimisticEntries)\n      .map(Number)\n      .filter((tempQuoteId) => {\n        const key = result.links[tempQuoteId];\n        return key !== undefined && byKey[key]?.raw.onchain !== undefined;\n      });\n    if (settled.length > 0) clearSettled(settled);\n  }, [result, byKey, optimisticEntries, clearSettled]);\n\n  const isLoading =\n    (active && includeVirtualAccounts && virtualAccounts.isLoading) ||\n    (active && includeVirtualAccounts && predictedVas.isLoading) ||\n    (active && wantOpenPositions && openPositions.isLoading) ||\n    (active && wantPendingQuotes && (pendingQuoteIds.isLoading || hydratedPending.isLoading)) ||\n    (active && wantInstantOpens && instantOpens.isLoading) ||\n    (active && wantInstantCloses && instantCloses.isLoading);\n\n  const isFetching =\n    (includeVirtualAccounts && (virtualAccounts.isFetching || predictedVas.isFetching)) ||\n    (wantOpenPositions && openPositions.isFetching) ||\n    (wantPendingQuotes && (pendingQuoteIds.isFetching || hydratedPending.isFetching)) ||\n    (wantInstantOpens && instantOpens.isFetching) ||\n    (wantInstantCloses && instantCloses.isFetching);\n\n  const error =\n    openPositions.error ??\n    pendingQuoteIds.error ??\n    hydratedPending.error ??\n    virtualAccounts.error ??\n    instantOpens.error ??\n    instantCloses.error ??\n    null;\n\n  /**\n   * `openPositions` / `pendingQuoteIds` are `useQueries` fan-outs (no single\n   * query handle), so their combined results expose a `refetch` that fires every\n   * per-account query. Refetching the ids re-drives the per-id hydration.\n   */\n  const refetchOpenPositions = openPositions.refetch;\n  const refetchPendingQuoteIds = pendingQuoteIds.refetch;\n  const refetch = useCallback(() => {\n    if (includeVirtualAccounts) virtualAccounts.refetch();\n    if (wantOpenPositions) refetchOpenPositions();\n    if (wantPendingQuotes) refetchPendingQuoteIds();\n    if (wantInstantOpens) instantOpens.refetch();\n    if (wantInstantCloses) instantCloses.refetch();\n  }, [\n    includeVirtualAccounts,\n    wantOpenPositions,\n    wantPendingQuotes,\n    wantInstantOpens,\n    wantInstantCloses,\n    virtualAccounts,\n    refetchOpenPositions,\n    refetchPendingQuoteIds,\n    instantOpens,\n    instantCloses,\n  ]);\n\n  return {\n    quotes: result.quotes,\n    byKey,\n    accounts,\n    isLoading: Boolean(isLoading),\n    isFetching: Boolean(isFetching),\n    socketStatus: live ? socketStatus : \"closed\",\n    error,\n    refetch,\n  };\n}\n"],"mappings":"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"}

package/dist/quotes/use-party-a-open-positions.d.ts

@@ -3,20 +3,40 @@ import { UseQueryResult } from '@tanstack/react-query';
 import { SymmioRequestError } from '../errors/symmio-request-error.js';
 /**
  * Parameters for {@link usePartyAOpenPositions}: the core query options (partyA,
- * pagination, chain id, TanStack `query` overrides) plus an optional `config`.
+ * pagination, chain id, TanStack `query` overrides) plus an optional `config`
+ * and a `live` flag.
  */
-export type UsePartyAOpenPositionsParameters = GetPartyAOpenPositionsOptions & ConfigParameter;
+export type UsePartyAOpenPositionsParameters = GetPartyAOpenPositionsOptions & ConfigParameter & {
+    /**
+     * Subscribe to settle notifications and burst-refetch when an open/close
+     * settles on-chain — so a just-closed position drops (or a partial close's
+     * remaining quantity updates) without a manual refresh. Shared WebSocket;
+     * requires the provider tree.
+     *
+     * Settle frames key on the **sub-account**. This resolves the right stream
+     * automatically: a Virtual Account (`partyA` on Enigma) is looked up via
+     * `getVirtualAccount` and its `parentAccount` sub-account is watched; a
+     * cross-margin sub-account (`partyA` on Rasa, `parentAccount == 0x0`) is its
+     * own stream. Works for both kinds without the caller supplying the
+     * sub-account. `@default false`
+     */
+    live?: boolean;
+};
 /** Return type of {@link usePartyAOpenPositions}. */
 export type UsePartyAOpenPositionsReturnType = UseQueryResult<GetPartyAOpenPositionsReturnType, SymmioRequestError>;
 /**
  * Read a partyA's open positions (full `Quote` structs) from the SYMMIO core.
- * `partyA` is a virtual account (lowcap). The query is disabled until `partyA`
- * is set. `chainId` defaults to the connected chain. Errors are normalized to
- * {@link SymmioRequestError}.
+ * `partyA` is a virtual account (lowcap) or the sub-account itself
+ * (cross-margin). The query is disabled until `partyA` is set. `chainId`
+ * defaults to the connected chain. Errors are normalized to
+ * {@link SymmioRequestError}. Pass `live: true` to auto-refetch when a close /
+ * open settles on-chain — it resolves the owning sub-account's notification
+ * stream for you (VA → `parentAccount`, sub-account → itself).
  *
  * @example
  * ```tsx
- * const { data: positions, isLoading } = usePartyAOpenPositions({ partyA: "0xva…" });
+ * // Rasa (partyA = sub-account) or Enigma (partyA = VA) — `live` handles both.
+ * const { data } = usePartyAOpenPositions({ partyA, live: true });
  * ```
  */
 export declare function usePartyAOpenPositions(parameters?: UsePartyAOpenPositionsParameters): UsePartyAOpenPositionsReturnType;

package/dist/quotes/use-party-a-open-positions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-party-a-open-positions.d.ts","sourceRoot":"","sources":["../../src/quotes/use-party-a-open-positions.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACtC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG,6BAA6B,GAAG,eAAe,CAAC;AAE/F,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,cAAc,CAAC,gCAAgC,EAAE,kBAAkB,CAAC,CAAC;AAEpH;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,GAAE,gCAAqC,GAChD,gCAAgC,CAkBlC"}
+{"version":3,"file":"use-party-a-open-positions.d.ts","sourceRoot":"","sources":["../../src/quotes/use-party-a-open-positions.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EAEtC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAOzE;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GAAG,6BAA6B,GAC1E,eAAe,GAAG;IAChB;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEJ,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,cAAc,CAAC,gCAAgC,EAAE,kBAAkB,CAAC,CAAC;AAEpH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,GAAE,gCAAqC,GAChD,gCAAgC,CA2ElC"}

package/dist/quotes/use-party-a-open-positions.js

@@ -2,26 +2,46 @@
 import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
 import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
 import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
-import { getPartyAOpenPositionsQueryOptions as r } from "@symmio/trading-core";
-import { useQuery as i } from "@tanstack/react-query";
+import { SETTLE_REFETCH_DELAYS_MS as r, isSettleNotification as i } from "../websocket/is-settle-notification.js";
+import { useNotifications as a } from "../websocket/use-notifications.js";
+import { predicateMatch as o } from "../utils/predicate-match.js";
+import { useVirtualAccount as s } from "../account-layer/use-virtual-account.js";
+import { NotificationType as c, getPartyAOpenPositionsQueryKey as l, getPartyAOpenPositionsQueryOptions as u } from "@symmio/trading-core";
+import { useCallback as d } from "react";
+import { zeroAddress as f } from "viem";
+import { useQuery as p, useQueryClient as m } from "@tanstack/react-query";
 //#region src/quotes/use-party-a-open-positions.ts
-function a(a = {}) {
-	let o = t(a), s = e(), c = r(o, {
-		...a,
-		chainId: a.chainId ?? s
-	});
-	return i({
-		...c,
+function h(h = {}) {
+	let { live: g, ..._ } = h, v = t(_), y = e(), b = _.chainId ?? y, x = _.partyA, S = u(v, {
+		..._,
+		chainId: b
+	}), C = p({
+		...S,
 		queryFn: async () => {
 			try {
-				return await c.queryFn();
+				return await S.queryFn();
 			} catch (e) {
 				throw n(e);
 			}
 		}
-	});
+	}), w = s({
+		account: x ?? f,
+		chainId: b,
+		config: _.config,
+		query: { enabled: !!(g && x) }
+	}).data?.parentAccount, T = w && w !== f ? w : x, E = m();
+	return a({
+		account: T,
+		chainId: b,
+		config: _.config,
+		enabled: !!(g && T) && _.query?.enabled !== !1,
+		onNotification: d((e) => {
+			let t = e.type === c.SUCCESS && e.lastSeenAction === "InstantRequestToLimitClose";
+			if (!(!i(e) && !t) && x) for (let e of r) setTimeout(() => void E.invalidateQueries({ predicate: o(l, { partyA: x }) }), e);
+		}, [E, x])
+	}), C;
 }
 //#endregion
-export { a as usePartyAOpenPositions };
+export { h as usePartyAOpenPositions };
 
 //# sourceMappingURL=use-party-a-open-positions.js.map

package/dist/quotes/use-party-a-open-positions.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-party-a-open-positions.js","names":[],"sources":["../../src/quotes/use-party-a-open-positions.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getPartyAOpenPositionsQueryOptions,\n  type ConfigParameter,\n  type GetPartyAOpenPositionsOptions,\n  type GetPartyAOpenPositionsReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link usePartyAOpenPositions}: the core query options (partyA,\n * pagination, chain id, TanStack `query` overrides) plus an optional `config`.\n */\nexport type UsePartyAOpenPositionsParameters = GetPartyAOpenPositionsOptions & ConfigParameter;\n\n/** Return type of {@link usePartyAOpenPositions}. */\nexport type UsePartyAOpenPositionsReturnType = UseQueryResult<GetPartyAOpenPositionsReturnType, SymmioRequestError>;\n\n/**\n * Read a partyA's open positions (full `Quote` structs) from the SYMMIO core.\n * `partyA` is a virtual account (lowcap). The query is disabled until `partyA`\n * is set. `chainId` defaults to the connected chain. Errors are normalized to\n * {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const { data: positions, isLoading } = usePartyAOpenPositions({ partyA: \"0xva…\" });\n * ```\n */\nexport function usePartyAOpenPositions(\n  parameters: UsePartyAOpenPositionsParameters = {},\n): UsePartyAOpenPositionsReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getPartyAOpenPositionsQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UsePartyAOpenPositionsReturnType;\n}\n"],"mappings":";;;;;;;AAkCA,SAAgB,EACd,IAA+C,CAAC,GACd;CAClC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAAmC,GAAQ;EACzD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}
+{"version":3,"file":"use-party-a-open-positions.js","names":[],"sources":["../../src/quotes/use-party-a-open-positions.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getPartyAOpenPositionsQueryKey,\n  getPartyAOpenPositionsQueryOptions,\n  NotificationType,\n  type ConfigParameter,\n  type GetPartyAOpenPositionsOptions,\n  type GetPartyAOpenPositionsReturnType,\n  type Notification,\n} from \"@symmio/trading-core\";\nimport { useQuery, useQueryClient, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useCallback } from \"react\";\nimport { zeroAddress } from \"viem\";\nimport { useVirtualAccount } from \"../account-layer/use-virtual-account\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { predicateMatch } from \"../utils\";\nimport { isSettleNotification, SETTLE_REFETCH_DELAYS_MS } from \"../websocket/is-settle-notification\";\nimport { useNotifications } from \"../websocket/use-notifications\";\n\n/**\n * Parameters for {@link usePartyAOpenPositions}: the core query options (partyA,\n * pagination, chain id, TanStack `query` overrides) plus an optional `config`\n * and a `live` flag.\n */\nexport type UsePartyAOpenPositionsParameters = GetPartyAOpenPositionsOptions &\n  ConfigParameter & {\n    /**\n     * Subscribe to settle notifications and burst-refetch when an open/close\n     * settles on-chain — so a just-closed position drops (or a partial close's\n     * remaining quantity updates) without a manual refresh. Shared WebSocket;\n     * requires the provider tree.\n     *\n     * Settle frames key on the **sub-account**. This resolves the right stream\n     * automatically: a Virtual Account (`partyA` on Enigma) is looked up via\n     * `getVirtualAccount` and its `parentAccount` sub-account is watched; a\n     * cross-margin sub-account (`partyA` on Rasa, `parentAccount == 0x0`) is its\n     * own stream. Works for both kinds without the caller supplying the\n     * sub-account. `@default false`\n     */\n    live?: boolean;\n  };\n\n/** Return type of {@link usePartyAOpenPositions}. */\nexport type UsePartyAOpenPositionsReturnType = UseQueryResult<GetPartyAOpenPositionsReturnType, SymmioRequestError>;\n\n/**\n * Read a partyA's open positions (full `Quote` structs) from the SYMMIO core.\n * `partyA` is a virtual account (lowcap) or the sub-account itself\n * (cross-margin). The query is disabled until `partyA` is set. `chainId`\n * defaults to the connected chain. Errors are normalized to\n * {@link SymmioRequestError}. Pass `live: true` to auto-refetch when a close /\n * open settles on-chain — it resolves the owning sub-account's notification\n * stream for you (VA → `parentAccount`, sub-account → itself).\n *\n * @example\n * ```tsx\n * // Rasa (partyA = sub-account) or Enigma (partyA = VA) — `live` handles both.\n * const { data } = usePartyAOpenPositions({ partyA, live: true });\n * ```\n */\nexport function usePartyAOpenPositions(\n  parameters: UsePartyAOpenPositionsParameters = {},\n): UsePartyAOpenPositionsReturnType {\n  const { live, ...queryParameters } = parameters;\n  const config = useSymmioConfig(queryParameters);\n  const chainId = useSymmioChainId();\n  const resolvedChainId = queryParameters.chainId ?? chainId;\n  const partyA = queryParameters.partyA;\n  const options = getPartyAOpenPositionsQueryOptions(config, {\n    ...queryParameters,\n    chainId: resolvedChainId,\n  });\n\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UsePartyAOpenPositionsReturnType;\n\n  // Resolve the account whose notification stream carries `partyA`'s settle\n  // frames: a VA's frames arrive on its `parentAccount` sub-account; a\n  // sub-account (parent `0x0`) is its own. The mapping is fixed at creation so\n  // this caches forever, and read only when `live`. If it errors or is still\n  // loading, we fall back to `partyA` — already correct for a cross-margin\n  // sub-account, so a failed read never breaks the Rasa case.\n  const vaDetail = useVirtualAccount({\n    account: partyA ?? zeroAddress,\n    chainId: resolvedChainId,\n    config: queryParameters.config,\n    query: { enabled: Boolean(live && partyA) },\n  });\n  const parentAccount = vaDetail.data?.parentAccount;\n  const notificationAccount = parentAccount && parentAccount !== zeroAddress ? parentAccount : partyA;\n\n  const queryClient = useQueryClient();\n  useNotifications({\n    account: notificationAccount,\n    chainId: resolvedChainId,\n    config: queryParameters.config,\n    enabled: Boolean(live && notificationAccount) && queryParameters.query?.enabled !== false,\n    onNotification: useCallback(\n      (notification: Notification) => {\n        // Settle frames (open anchored / close filled) already cover market closes\n        // — a market close's fill is a settle. The one close that isn't a settle is\n        // the **limit-close anchor** (`InstantRequestToLimitClose`): a resting close\n        // that flips the position to CLOSE_PENDING with no fill and no balance move,\n        // so refetch on exactly that in addition to settles.\n        const isLimitCloseAnchor =\n          notification.type === NotificationType.SUCCESS &&\n          notification.lastSeenAction === \"InstantRequestToLimitClose\";\n        if (!isSettleNotification(notification) && !isLimitCloseAnchor) return;\n        if (!partyA) return;\n        // Invalidate (not `refetch`) so every consumer of this partyA's open\n        // positions updates — including `useManagedQuotes`, which reads the same\n        // data under a different query key (no `start`/`size`); a partial-key\n        // predicate matches them all. The on-chain read lags the block, so fire a\n        // short burst until the updated positions land.\n        for (const ms of SETTLE_REFETCH_DELAYS_MS) {\n          setTimeout(\n            () =>\n              void queryClient.invalidateQueries({\n                predicate: predicateMatch(getPartyAOpenPositionsQueryKey, { partyA }),\n              }),\n            ms,\n          );\n        }\n      },\n      [queryClient, partyA],\n    ),\n  });\n\n  return query;\n}\n"],"mappings":";;;;;;;;;;;;;AAgEA,SAAgB,EACd,IAA+C,CAAC,GACd;CAClC,IAAM,EAAE,SAAM,GAAG,MAAoB,GAC/B,IAAS,EAAgB,CAAe,GACxC,IAAU,EAAiB,GAC3B,IAAkB,EAAgB,WAAW,GAC7C,IAAS,EAAgB,QACzB,IAAU,EAAmC,GAAQ;EACzD,GAAG;EACH,SAAS;CACX,CAAC,GAEK,IAAQ,EAAS;EACrB,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC,GAcK,IANW,EAAkB;EACjC,SAAS,KAAU;EACnB,SAAS;EACT,QAAQ,EAAgB;EACxB,OAAO,EAAE,SAAS,GAAQ,KAAQ,GAAQ;CAC5C,CACsB,EAAS,MAAM,eAC/B,IAAsB,KAAiB,MAAkB,IAAc,IAAgB,GAEvF,IAAc,EAAe;CAqCnC,OApCA,EAAiB;EACf,SAAS;EACT,SAAS;EACT,QAAQ,EAAgB;EACxB,SAAS,GAAQ,KAAQ,MAAwB,EAAgB,OAAO,YAAY;EACpF,gBAAgB,GACb,MAA+B;GAM9B,IAAM,IACJ,EAAa,SAAS,EAAiB,WACvC,EAAa,mBAAmB;GAC9B,OAAC,EAAqB,CAAY,KAAK,CAAC,MACvC,GAML,KAAK,IAAM,KAAM,GACf,iBAEI,KAAK,EAAY,kBAAkB,EACjC,WAAW,EAAe,GAAgC,EAAE,UAAO,CAAC,EACtE,CAAC,GACH,CACF;EAEJ,GACA,CAAC,GAAa,CAAM,CACtB;CACF,CAAC,GAEM;AACT"}

package/dist/quotes/use-quote-funding.d.ts

@@ -21,8 +21,8 @@ export interface UseQuoteFundingReturnType {
     error: SymmioRequestError | null;
 }
 /**
- * Read funding totals (paid / received / net) for a single on-chain quote.
- * Disabled while `quoteId` is `undefined` (off-chain row).
+ * Read funding totals (paid / received / netReceived) for a single on-chain
+ * quote. Disabled while `quoteId` is `undefined` (off-chain row).
  *
  * Thin wrapper over {@link useQuotesFunding} with a one-element batch.
  *

package/dist/quotes/use-quote-funding.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote-funding.js","names":[],"sources":["../../src/quotes/use-quote-funding.ts"],"sourcesContent":["\"use client\";\n\nimport type { ConfigParameter, QuoteFundingData } from \"@symmio/trading-core\";\nimport { useMemo } from \"react\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useQuotesFunding } from \"./use-quotes-funding\";\n\n/**\n * Parameters for {@link useQuoteFunding}.\n */\nexport interface UseQuoteFundingParameters extends ConfigParameter {\n  /** On-chain quote id. `undefined` (off-chain) disables the query. */\n  quoteId?: bigint;\n  /** Optional chain id override; defaults to the connected chain. */\n  chainId?: number;\n}\n\n/**\n * Return type of {@link useQuoteFunding}.\n */\nexport interface UseQuoteFundingReturnType {\n  /** The funding row for this quote, or `null` until it resolves. */\n  data: QuoteFundingData | null;\n  /** `true` while the subgraph query is loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\nconst EMPTY_QUOTES: readonly { quoteId?: bigint }[] = [];\n\n/**\n * Read funding totals (paid / received / net) for a single on-chain quote.\n * Disabled while `quoteId` is `undefined` (off-chain row).\n *\n * Thin wrapper over {@link useQuotesFunding} with a one-element batch.\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useQuoteFunding({ quoteId: quote.quoteId });\n * ```\n */\nexport function useQuoteFunding(parameters: UseQuoteFundingParameters): UseQuoteFundingReturnType {\n  const { quoteId, chainId, config } = parameters;\n\n  const quotes = useMemo(() => (quoteId === undefined ? EMPTY_QUOTES : [{ quoteId }]), [quoteId]);\n\n  const batch = useQuotesFunding({ quotes, chainId, config });\n\n  return {\n    data: batch.rows[0] ?? null,\n    isLoading: batch.isLoading,\n    error: batch.error,\n  };\n}\n"],"mappings":";;;;AA6BA,IAAM,IAAgD,CAAC;AAavD,SAAgB,EAAgB,GAAkE;CAChG,IAAM,EAAE,YAAS,YAAS,cAAW,GAI/B,IAAQ,EAAiB;EAAE,QAFlB,QAAe,MAAY,KAAA,IAAY,IAAe,CAAC,EAAE,WAAQ,CAAC,GAAI,CAAC,CAAO,CAE5D;EAAQ;EAAS;CAAO,CAAC;CAE1D,OAAO;EACL,MAAM,EAAM,KAAK,MAAM;EACvB,WAAW,EAAM;EACjB,OAAO,EAAM;CACf;AACF"}
+{"version":3,"file":"use-quote-funding.js","names":[],"sources":["../../src/quotes/use-quote-funding.ts"],"sourcesContent":["\"use client\";\n\nimport type { ConfigParameter, QuoteFundingData } from \"@symmio/trading-core\";\nimport { useMemo } from \"react\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useQuotesFunding } from \"./use-quotes-funding\";\n\n/**\n * Parameters for {@link useQuoteFunding}.\n */\nexport interface UseQuoteFundingParameters extends ConfigParameter {\n  /** On-chain quote id. `undefined` (off-chain) disables the query. */\n  quoteId?: bigint;\n  /** Optional chain id override; defaults to the connected chain. */\n  chainId?: number;\n}\n\n/**\n * Return type of {@link useQuoteFunding}.\n */\nexport interface UseQuoteFundingReturnType {\n  /** The funding row for this quote, or `null` until it resolves. */\n  data: QuoteFundingData | null;\n  /** `true` while the subgraph query is loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\nconst EMPTY_QUOTES: readonly { quoteId?: bigint }[] = [];\n\n/**\n * Read funding totals (paid / received / netReceived) for a single on-chain\n * quote. Disabled while `quoteId` is `undefined` (off-chain row).\n *\n * Thin wrapper over {@link useQuotesFunding} with a one-element batch.\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useQuoteFunding({ quoteId: quote.quoteId });\n * ```\n */\nexport function useQuoteFunding(parameters: UseQuoteFundingParameters): UseQuoteFundingReturnType {\n  const { quoteId, chainId, config } = parameters;\n\n  const quotes = useMemo(() => (quoteId === undefined ? EMPTY_QUOTES : [{ quoteId }]), [quoteId]);\n\n  const batch = useQuotesFunding({ quotes, chainId, config });\n\n  return {\n    data: batch.rows[0] ?? null,\n    isLoading: batch.isLoading,\n    error: batch.error,\n  };\n}\n"],"mappings":";;;;AA6BA,IAAM,IAAgD,CAAC;AAavD,SAAgB,EAAgB,GAAkE;CAChG,IAAM,EAAE,YAAS,YAAS,cAAW,GAI/B,IAAQ,EAAiB;EAAE,QAFlB,QAAe,MAAY,KAAA,IAAY,IAAe,CAAC,EAAE,WAAQ,CAAC,GAAI,CAAC,CAAO,CAE5D;EAAQ;EAAS;CAAO,CAAC;CAE1D,OAAO;EACL,MAAM,EAAM,KAAK,MAAM;EACvB,WAAW,EAAM;EACjB,OAAO,EAAM;CACf;AACF"}

package/dist/quotes/use-quote-group-funding-history.d.ts

@@ -0,0 +1,70 @@
+import { ConfigParameter, GetQuotesEventsByTypeOptions, GetQuotesEventsByTypeReturnType, QuoteGroup } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Parameters for {@link useQuoteGroupFundingHistory}: the batched core query
+ * options minus the two fields this hook owns — `quoteIds` (derived from the
+ * group's children) and `types` (locked to {@link FUNDING_HISTORY_EVENT_TYPES}) —
+ * plus an optional `config`.
+ */
+export type UseQuoteGroupFundingHistoryParameters = Omit<GetQuotesEventsByTypeOptions, "quoteIds" | "types"> & ConfigParameter & {
+    /** The group whose children's funding ticks are merged into one timeline. */
+    group: QuoteGroup;
+};
+/** Return type of {@link useQuoteGroupFundingHistory}. */
+export type UseQuoteGroupFundingHistoryReturnType = UseQueryResult<GetQuotesEventsByTypeReturnType, SymmioRequestError>;
+/**
+ * Read the funding history of a whole {@link QuoteGroup} as **one merged,
+ * time-sorted timeline** — the group analogue of `useQuotePriceHistory`.
+ *
+ * Every on-chain child of the group is fetched in a single subgraph round-trip
+ * and the rows come back already interleaved and sorted by `timestamp` (newest
+ * first unless `orderDirection: "asc"` is passed). Each row carries its own
+ * `quoteId`, so a caller that wants a per-position breakdown groups by that
+ * field client-side.
+ *
+ * Per-row funding fields are `fundingPaid` / `fundingReceived` (18-decimal wei)
+ * plus the `rate` applied for that tick (a signed `int256` as wei). Those fields
+ * are verbatim from the subgraph; net a row the way the rest of the SDK does —
+ * `fundingReceived − fundingPaid`, so a **positive** net means the position
+ * **earned** funding on that tick, matching `QuoteFundingData.netReceived`.
+ *
+ * Children with no on-chain `quoteId` (optimistic rows that have not anchored
+ * yet) have no subgraph events and are dropped from the request; ids are
+ * de-duplicated so a group holding the same quote twice does not fragment the
+ * cache. When the group has no on-chain children the query stays disabled.
+ *
+ * Paging is over the **merged** stream, not per quote id: pass `first` / `skip`
+ * and page while `data.hasMore` is `true`. Omitting `first` asks for the 1000-row
+ * ceiling the subgraph enforces, so an un-paged call loads the whole timeline
+ * unless the group has more ticks than a single request can return.
+ *
+ * `chainId` defaults to the connected chain. Errors are normalized to
+ * {@link SymmioRequestError}.
+ *
+ * @remarks
+ * This is funding **settled to date** — what the analytics subgraph has indexed.
+ * Funding that has accrued since the last on-chain charge is not indexed and is
+ * therefore absent from this timeline.
+ *
+ * @remarks
+ * On current deployments effectively every row is `CHARGE_FUNDING_RATE`.
+ * `CHARGE_ACCUMULATED_FUNDING_FEE` is part of {@link FUNDING_HISTORY_EVENT_TYPES}
+ * for completeness but is not yet emitted, so do not rely on seeing it.
+ *
+ * @param parameters - The group, optional paging/sort/chain id, TanStack `query`
+ *   overrides, and an optional `config`.
+ * @returns A TanStack query result holding the merged `rows` and a `hasMore` flag.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useQuoteGroupFundingHistory({ group, first: 100 });
+ *
+ * for (const row of data?.rows ?? []) {
+ *   const net = (row.fundingPaid ?? 0n) - (row.fundingReceived ?? 0n);
+ *   // net > 0n → the user paid funding on this tick.
+ * }
+ * ```
+ */
+export declare function useQuoteGroupFundingHistory(parameters: UseQuoteGroupFundingHistoryParameters): UseQuoteGroupFundingHistoryReturnType;
+//# sourceMappingURL=use-quote-group-funding-history.d.ts.map

package/dist/quotes/use-quote-group-funding-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-group-funding-history.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quote-group-funding-history.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;;;GAKG;AACH,MAAM,MAAM,qCAAqC,GAAG,IAAI,CAAC,4BAA4B,EAAE,UAAU,GAAG,OAAO,CAAC,GAC1G,eAAe,GAAG;IAChB,6EAA6E;IAC7E,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC;AAEJ,0DAA0D;AAC1D,MAAM,MAAM,qCAAqC,GAAG,cAAc,CAAC,+BAA+B,EAAE,kBAAkB,CAAC,CAAC;AAExH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,qCAAqC,GAChD,qCAAqC,CAwCvC"}

package/dist/quotes/use-quote-group-funding-history.js

@@ -0,0 +1,38 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { FUNDING_HISTORY_EVENT_TYPES as r, getQuotesEventsByTypeQueryOptions as i } from "@symmio/trading-core";
+import { useMemo as a } from "react";
+import { useQuery as o } from "@tanstack/react-query";
+//#region src/quotes/use-quote-group-funding-history.ts
+function s(s) {
+	let { group: c, ...l } = s, u = t(s), d = e(), f = a(() => {
+		let e = /* @__PURE__ */ new Set(), t = [];
+		for (let n of c.quotes) {
+			if (n.quoteId === void 0) continue;
+			let r = n.quoteId.toString();
+			e.has(r) || (e.add(r), t.push(n.quoteId));
+		}
+		return t;
+	}, [c.quotes]), p = i(u, {
+		...l,
+		chainId: l.chainId ?? d,
+		quoteIds: f,
+		types: r
+	});
+	return o({
+		...p,
+		queryFn: async () => {
+			try {
+				return await p.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { s as useQuoteGroupFundingHistory };
+
+//# sourceMappingURL=use-quote-group-funding-history.js.map

package/dist/quotes/use-quote-group-funding-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-group-funding-history.js","names":[],"sources":["../../src/quotes/use-quote-group-funding-history.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  FUNDING_HISTORY_EVENT_TYPES,\n  getQuotesEventsByTypeQueryOptions,\n  type ConfigParameter,\n  type GetQuotesEventsByTypeOptions,\n  type GetQuotesEventsByTypeReturnType,\n  type QuoteGroup,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useQuoteGroupFundingHistory}: the batched core query\n * options minus the two fields this hook owns — `quoteIds` (derived from the\n * group's children) and `types` (locked to {@link FUNDING_HISTORY_EVENT_TYPES}) —\n * plus an optional `config`.\n */\nexport type UseQuoteGroupFundingHistoryParameters = Omit<GetQuotesEventsByTypeOptions, \"quoteIds\" | \"types\"> &\n  ConfigParameter & {\n    /** The group whose children's funding ticks are merged into one timeline. */\n    group: QuoteGroup;\n  };\n\n/** Return type of {@link useQuoteGroupFundingHistory}. */\nexport type UseQuoteGroupFundingHistoryReturnType = UseQueryResult<GetQuotesEventsByTypeReturnType, SymmioRequestError>;\n\n/**\n * Read the funding history of a whole {@link QuoteGroup} as **one merged,\n * time-sorted timeline** — the group analogue of `useQuotePriceHistory`.\n *\n * Every on-chain child of the group is fetched in a single subgraph round-trip\n * and the rows come back already interleaved and sorted by `timestamp` (newest\n * first unless `orderDirection: \"asc\"` is passed). Each row carries its own\n * `quoteId`, so a caller that wants a per-position breakdown groups by that\n * field client-side.\n *\n * Per-row funding fields are `fundingPaid` / `fundingReceived` (18-decimal wei)\n * plus the `rate` applied for that tick (a signed `int256` as wei). Those fields\n * are verbatim from the subgraph; net a row the way the rest of the SDK does —\n * `fundingReceived − fundingPaid`, so a **positive** net means the position\n * **earned** funding on that tick, matching `QuoteFundingData.netReceived`.\n *\n * Children with no on-chain `quoteId` (optimistic rows that have not anchored\n * yet) have no subgraph events and are dropped from the request; ids are\n * de-duplicated so a group holding the same quote twice does not fragment the\n * cache. When the group has no on-chain children the query stays disabled.\n *\n * Paging is over the **merged** stream, not per quote id: pass `first` / `skip`\n * and page while `data.hasMore` is `true`. Omitting `first` asks for the 1000-row\n * ceiling the subgraph enforces, so an un-paged call loads the whole timeline\n * unless the group has more ticks than a single request can return.\n *\n * `chainId` defaults to the connected chain. Errors are normalized to\n * {@link SymmioRequestError}.\n *\n * @remarks\n * This is funding **settled to date** — what the analytics subgraph has indexed.\n * Funding that has accrued since the last on-chain charge is not indexed and is\n * therefore absent from this timeline.\n *\n * @remarks\n * On current deployments effectively every row is `CHARGE_FUNDING_RATE`.\n * `CHARGE_ACCUMULATED_FUNDING_FEE` is part of {@link FUNDING_HISTORY_EVENT_TYPES}\n * for completeness but is not yet emitted, so do not rely on seeing it.\n *\n * @param parameters - The group, optional paging/sort/chain id, TanStack `query`\n *   overrides, and an optional `config`.\n * @returns A TanStack query result holding the merged `rows` and a `hasMore` flag.\n *\n * @example\n * ```tsx\n * const { data, isLoading } = useQuoteGroupFundingHistory({ group, first: 100 });\n *\n * for (const row of data?.rows ?? []) {\n *   const net = (row.fundingPaid ?? 0n) - (row.fundingReceived ?? 0n);\n *   // net > 0n → the user paid funding on this tick.\n * }\n * ```\n */\nexport function useQuoteGroupFundingHistory(\n  parameters: UseQuoteGroupFundingHistoryParameters,\n): UseQuoteGroupFundingHistoryReturnType {\n  const { group, ...rest } = parameters;\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  /**\n   * On-chain ids of the group's children: optimistic rows (no `quoteId`) have no\n   * subgraph events and are dropped, and duplicates are collapsed so the query\n   * key stays stable.\n   */\n  const quoteIds = useMemo(() => {\n    const seen = new Set<string>();\n    const ids: bigint[] = [];\n    for (const quote of group.quotes) {\n      if (quote.quoteId === undefined) continue;\n      const key = quote.quoteId.toString();\n      if (seen.has(key)) continue;\n      seen.add(key);\n      ids.push(quote.quoteId);\n    }\n    return ids;\n  }, [group.quotes]);\n\n  const options = getQuotesEventsByTypeQueryOptions(config, {\n    ...rest,\n    chainId: rest.chainId ?? chainId,\n    quoteIds,\n    types: FUNDING_HISTORY_EVENT_TYPES,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQuoteGroupFundingHistoryReturnType;\n}\n"],"mappings":";;;;;;;;AAqFA,SAAgB,EACd,GACuC;CACvC,IAAM,EAAE,UAAO,GAAG,MAAS,GACrB,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAO3B,IAAW,QAAc;EAC7B,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAgB,CAAC;EACvB,KAAK,IAAM,KAAS,EAAM,QAAQ;GAChC,IAAI,EAAM,YAAY,KAAA,GAAW;GACjC,IAAM,IAAM,EAAM,QAAQ,SAAS;GAC/B,EAAK,IAAI,CAAG,MAChB,EAAK,IAAI,CAAG,GACZ,EAAI,KAAK,EAAM,OAAO;EACxB;EACA,OAAO;CACT,GAAG,CAAC,EAAM,MAAM,CAAC,GAEX,IAAU,EAAkC,GAAQ;EACxD,GAAG;EACH,SAAS,EAAK,WAAW;EACzB;EACA,OAAO;CACT,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/quotes/use-quote-group-funding.d.ts

@@ -0,0 +1,67 @@
+import { ConfigParameter, GetQuoteFundingOptions, QuoteFundingData, QuoteGroup, QuoteGroupFunding } from '@symmio/trading-core';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Parameters for {@link useQuoteGroupFunding}.
+ */
+export interface UseQuoteGroupFundingParameters extends Omit<GetQuoteFundingOptions, "quoteIds">, ConfigParameter {
+    /** The group to read settled funding for. */
+    group: QuoteGroup;
+}
+/**
+ * Return type of {@link useQuoteGroupFunding}.
+ */
+export interface UseQuoteGroupFundingReturnType {
+    /** Aggregated settled funding for the group. */
+    funding: QuoteGroupFunding;
+    /** Funding row per child quote, aligned 1:1 with `group.quotes`; `null` when unresolved. */
+    rows: Array<QuoteFundingData | null>;
+    /** `true` while the underlying subgraph query is loading. */
+    isLoading: boolean;
+    /** Normalized request error, when one occurred. */
+    error: SymmioRequestError | null;
+}
+/**
+ * Read the settled funding of a whole {@link QuoteGroup} — the group-level
+ * counterpart of `useQuoteFunding`.
+ *
+ * Every child quote's funding is fetched in one subgraph round-trip via
+ * {@link useQuotesFunding}, then folded by core's pure `aggregateGroupFunding`.
+ * All arithmetic lives in core; this hook only wires the read to the fold and
+ * memoizes the result, so the returned object is referentially stable while the
+ * group and its rows are unchanged.
+ *
+ * **Sign convention** — `funding.netReceived = received − paid`, so a **positive**
+ * value means the group has **earned** funding and a negative one means it has
+ * **paid** for it. This matches {@link QuoteFundingData} and the uPnL folds, so
+ * "green = income" coloring renders it as-is; it is the inverse of the
+ * cost-positive on-chain `int256`.
+ *
+ * **Check `funding.isComplete` before presenting the total as final.**
+ * `netReceived` is always the sum over the children that resolved, i.e. a lower
+ * bound while the subgraph is still indexing (`funding.missingQuoteIds`
+ * non-empty). An all-optimistic or empty group reports `isComplete: false` with
+ * `netReceived: 0n`, so treat `isComplete: false` as "funding unknown", not as
+ * "no funding".
+ *
+ * **Settled to date only** — these totals cover funding the protocol has already
+ * charged and the analytics subgraph has indexed. Funding accrued since a
+ * quote's last funding charge is not indexed anywhere and is therefore not
+ * included.
+ *
+ * @param parameters - The group to read, plus optional chain/query/config overrides.
+ * @returns The aggregated group funding, the per-child rows, and query state.
+ *
+ * @example
+ * ```tsx
+ * function GroupedPositionCard({ group }: { group: QuoteGroup }) {
+ *   const { funding, isLoading } = useQuoteGroupFunding({ group });
+ *
+ *   if (isLoading || !funding.isComplete) return <FundingSkeleton />;
+ *
+ *   // Already income-positive: `netReceived > 0n` means the group EARNED funding.
+ *   return <Money amount={funding.netReceived} label="Funding" />;
+ * }
+ * ```
+ */
+export declare function useQuoteGroupFunding(parameters: UseQuoteGroupFundingParameters): UseQuoteGroupFundingReturnType;
+//# sourceMappingURL=use-quote-group-funding.d.ts.map