@symmio/trading-react 1.1.0 → 3.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-group-funding.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quote-group-funding.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,EAAE,eAAe;IAC/G,6CAA6C;IAC7C,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,gDAAgD;IAChD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,4FAA4F;IAC5F,IAAI,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACrC,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,8BAA8B,GAAG,8BAA8B,CAiB/G"}

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

@@ -0,0 +1,26 @@
+"use client";
+import { useQuotesFunding as e } from "./use-quotes-funding.js";
+import { aggregateGroupFunding as t } from "@symmio/trading-core";
+import { useMemo as n } from "react";
+//#region src/quotes/use-quote-group-funding.ts
+function r(r) {
+	let { group: i, ...a } = r, o = i.quotes, s = e({
+		quotes: o,
+		...a
+	}), c = s.rows, l = n(() => t(o, c.filter((e) => e !== null)), [o, c]);
+	return n(() => ({
+		funding: l,
+		rows: c,
+		isLoading: s.isLoading,
+		error: s.error
+	}), [
+		l,
+		c,
+		s.isLoading,
+		s.error
+	]);
+}
+//#endregion
+export { r as useQuoteGroupFunding };
+
+//# sourceMappingURL=use-quote-group-funding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-group-funding.js","names":[],"sources":["../../src/quotes/use-quote-group-funding.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  aggregateGroupFunding,\n  type ConfigParameter,\n  type GetQuoteFundingOptions,\n  type QuoteFundingData,\n  type QuoteGroup,\n  type QuoteGroupFunding,\n} 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 useQuoteGroupFunding}.\n */\nexport interface UseQuoteGroupFundingParameters extends Omit<GetQuoteFundingOptions, \"quoteIds\">, ConfigParameter {\n  /** The group to read settled funding for. */\n  group: QuoteGroup;\n}\n\n/**\n * Return type of {@link useQuoteGroupFunding}.\n */\nexport interface UseQuoteGroupFundingReturnType {\n  /** Aggregated settled funding for the group. */\n  funding: QuoteGroupFunding;\n  /** Funding row per child quote, aligned 1:1 with `group.quotes`; `null` when unresolved. */\n  rows: Array<QuoteFundingData | null>;\n  /** `true` while the underlying subgraph query is loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Read the settled funding of a whole {@link QuoteGroup} — the group-level\n * counterpart of `useQuoteFunding`.\n *\n * Every child quote's funding is fetched in one subgraph round-trip via\n * {@link useQuotesFunding}, then folded by core's pure `aggregateGroupFunding`.\n * All arithmetic lives in core; this hook only wires the read to the fold and\n * memoizes the result, so the returned object is referentially stable while the\n * group and its rows are unchanged.\n *\n * **Sign convention** — `funding.netReceived = received − paid`, so a **positive**\n * value means the group has **earned** funding and a negative one means it has\n * **paid** for it. This matches {@link QuoteFundingData} and the uPnL folds, so\n * \"green = income\" coloring renders it as-is; it is the inverse of the\n * cost-positive on-chain `int256`.\n *\n * **Check `funding.isComplete` before presenting the total as final.**\n * `netReceived` is always the sum over the children that resolved, i.e. a lower\n * bound while the subgraph is still indexing (`funding.missingQuoteIds`\n * non-empty). An all-optimistic or empty group reports `isComplete: false` with\n * `netReceived: 0n`, so treat `isComplete: false` as \"funding unknown\", not as\n * \"no funding\".\n *\n * **Settled to date only** — these totals cover funding the protocol has already\n * charged and the analytics subgraph has indexed. Funding accrued since a\n * quote's last funding charge is not indexed anywhere and is therefore not\n * included.\n *\n * @param parameters - The group to read, plus optional chain/query/config overrides.\n * @returns The aggregated group funding, the per-child rows, and query state.\n *\n * @example\n * ```tsx\n * function GroupedPositionCard({ group }: { group: QuoteGroup }) {\n *   const { funding, isLoading } = useQuoteGroupFunding({ group });\n *\n *   if (isLoading || !funding.isComplete) return <FundingSkeleton />;\n *\n *   // Already income-positive: `netReceived > 0n` means the group EARNED funding.\n *   return <Money amount={funding.netReceived} label=\"Funding\" />;\n * }\n * ```\n */\nexport function useQuoteGroupFunding(parameters: UseQuoteGroupFundingParameters): UseQuoteGroupFundingReturnType {\n  const { group, ...rest } = parameters;\n  const quotes = group.quotes;\n\n  /** One batched round-trip for the whole group; de-duping and off-chain skipping live there. */\n  const batch = useQuotesFunding({ quotes, ...rest });\n  const rows = batch.rows;\n\n  const funding = useMemo(() => {\n    const resolvedRows = rows.filter((row): row is QuoteFundingData => row !== null);\n    return aggregateGroupFunding(quotes, resolvedRows);\n  }, [quotes, rows]);\n\n  return useMemo(\n    () => ({ funding, rows, isLoading: batch.isLoading, error: batch.error }),\n    [funding, rows, batch.isLoading, batch.error],\n  );\n}\n"],"mappings":";;;;;AA+EA,SAAgB,EAAqB,GAA4E;CAC/G,IAAM,EAAE,UAAO,GAAG,MAAS,GACrB,IAAS,EAAM,QAGf,IAAQ,EAAiB;EAAE;EAAQ,GAAG;CAAK,CAAC,GAC5C,IAAO,EAAM,MAEb,IAAU,QAEP,EAAsB,GADR,EAAK,QAAQ,MAAiC,MAAQ,IACtC,CAAY,GAChD,CAAC,GAAQ,CAAI,CAAC;CAEjB,OAAO,SACE;EAAE;EAAS;EAAM,WAAW,EAAM;EAAW,OAAO,EAAM;CAAM,IACvE;EAAC;EAAS;EAAM,EAAM;EAAW,EAAM;CAAK,CAC9C;AACF"}

package/dist/quotes/use-quote-group-margin-risk.d.ts

@@ -0,0 +1,111 @@
+import { ConfigParameter, MarginRiskMetrics, QuoteGroup, QuoteGroupUpnl } from '@symmio/trading-core';
+import { Address } from 'viem';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Parameters for {@link useQuoteGroupMarginRisk}.
+ */
+export interface UseQuoteGroupMarginRiskParameters extends ConfigParameter {
+    /** The merged position to describe. */
+    group: QuoteGroup;
+    /**
+     * Mark price override, 18-decimal wei. Omit to subscribe to the group's
+     * market. Pass it when the surrounding screen already holds the price, so the
+     * two do not open separate subscriptions or disagree by a tick.
+     */
+    markPrice?: bigint;
+    /**
+     * Account override; defaults to the group's resolved Virtual Account. The uPnL
+     * fold narrows to this account's children too, so `equity` stays consistent.
+     */
+    account?: Address;
+    /**
+     * Refetch the balance when an open/close settles on-chain.
+     * @default true
+     */
+    live?: boolean;
+    /** Optional override; defaults to the connected chain. */
+    chainId?: number;
+    /**
+     * Run the underlying reads only when `true` — gate a panel that is collapsed.
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * Return type of {@link useQuoteGroupMarginRisk}.
+ */
+export interface UseQuoteGroupMarginRiskReturnType {
+    /**
+     * Margin & risk for the group's liquidation domain. `undefined` while the
+     * balance read is in flight, **or** whenever the group spans several accounts
+     * ({@link isMultiAccount}) — blending liquidation domains is never correct.
+     */
+    metrics?: MarginRiskMetrics;
+    /**
+     * The group's aggregated unrealized PnL at {@link markPrice}. Check
+     * `upnl.isComplete` before presenting anything derived from it as final.
+     */
+    upnl: QuoteGroupUpnl;
+    /** Liquidation price of the resolved account, wei. `0n` when unavailable. */
+    liquidationPrice: bigint;
+    /** The mark price actually used, wei; `undefined` before the first tick. */
+    markPrice?: bigint;
+    /** The account {@link metrics} and {@link liquidationPrice} describe. */
+    account?: Address;
+    /** Distinct liquidation domains among the group's children (`vaAddress ?? partyA`). */
+    accounts: Address[];
+    /**
+     * `true` when the group's children live in more than one account. Each is
+     * liquidated independently, so {@link metrics} is suppressed — fan out with
+     * `useAccountMarginRisk` over {@link accounts} instead.
+     */
+    isMultiAccount: boolean;
+    /** `true` while the balance, positions, or price reads are loading. */
+    isLoading: boolean;
+    /** Normalized request error, when one occurred. */
+    error: SymmioRequestError | null;
+}
+/**
+ * Margin and liquidation-risk state of a merged position — the group-level
+ * counterpart of `useAccountMarginRisk`.
+ *
+ * Resolves the group's Virtual Account, folds its children's unrealized PnL
+ * against the mark price with core's `aggregateGroupUpnl`, and runs both through
+ * `calculateMarginRisk`. The account's liquidation price comes from the existing
+ * `useAccountLiquidationPrice`. All arithmetic lives in core; this hook only
+ * wires the reads to the folds.
+ *
+ * **Mark price**: injected wins. Pass `markPrice` (wei) and no price
+ * subscription is opened; omit it and the hook subscribes to the group's market.
+ *
+ * **One liquidation domain per result.** A group normally maps 1:1 to a Virtual
+ * Account, because the built-in grouping strategies mirror the sub-account's
+ * on-chain isolation type. When it does not — a custom `keyOf`, or grouping by
+ * `MARKET` an account isolated by `MARKET_DIRECTION` — `isMultiAccount` is `true`
+ * and `metrics` is withheld rather than blended: an account at 2% buffer averaged
+ * with one at 200% reads as safe while the first is about to be liquidated.
+ *
+ * **Equity is exact only when the group covers the account's whole book.**
+ * `equity = allocatedBalance + upnl` mixes an account-wide balance with the
+ * group's uPnL. That is the same figure the reference app shows, and it is exact
+ * whenever the grouping strategy matches the sub-account's isolation type. Group
+ * a `MARKET`-isolated account by `MARKET_DIRECTION` and each group is a *subset*
+ * of its account, which understates equity — the hook cannot detect that without
+ * a second read, so it is stated rather than guessed at.
+ *
+ * @param parameters - The group, plus optional price/account/chain/config overrides.
+ * @returns The group's metrics, uPnL, liquidation price, and query state.
+ *
+ * @example
+ * ```tsx
+ * function GroupRisk({ group }: { group: QuoteGroup }) {
+ *   const { metrics, upnl, liquidationPrice } = useQuoteGroupMarginRisk({ group });
+ *   if (!metrics) return <Skeleton />;
+ *   // The three margin rows are uPnL-independent — render them even while
+ *   // `upnl.isComplete` is false; gate only equity and the buffer on it.
+ *   return <MarginRows metrics={metrics} live={upnl.isComplete} liq={liquidationPrice} />;
+ * }
+ * ```
+ */
+export declare function useQuoteGroupMarginRisk(parameters: UseQuoteGroupMarginRiskParameters): UseQuoteGroupMarginRiskReturnType;
+//# sourceMappingURL=use-quote-group-margin-risk.d.ts.map

package/dist/quotes/use-quote-group-margin-risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-group-margin-risk.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quote-group-margin-risk.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAKzE;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,eAAe;IACxE,uCAAuC;IACvC,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iCAAiC,GAC5C,iCAAiC,CA8FnC"}

package/dist/quotes/use-quote-group-margin-risk.js

@@ -0,0 +1,63 @@
+"use client";
+import { useAccountLiquidationPrice as e } from "./use-account-liquidation-price.js";
+import { useAccountMarginRisk as t } from "../margin/use-account-margin-risk.js";
+import { useEnigmaPriceByMarketId as n } from "../price-service/use-enigma-price-by-market-id.js";
+import { aggregateGroupUpnl as r, decimalPriceToWei as i } from "@symmio/trading-core";
+import { useMemo as a } from "react";
+//#region src/quotes/use-quote-group-margin-risk.ts
+function o(o) {
+	let { group: s, markPrice: c, live: l = !0, chainId: u, enabled: d = !0, config: f } = o, p = s.quotes, m = a(() => {
+		let e = /* @__PURE__ */ new Set(), t = [];
+		for (let n of p) {
+			let r = n.vaAddress ?? n.partyA, i = r.toLowerCase();
+			e.has(i) || (e.add(i), t.push(r));
+		}
+		return t;
+	}, [p]), h = m.length > 1, g = o.account ?? s.vaAddress ?? m[0], _ = a(() => {
+		if (g === void 0) return p;
+		let e = g.toLowerCase();
+		return p.filter((t) => (t.vaAddress ?? t.partyA).toLowerCase() === e);
+	}, [p, g]), v = s.by.symbolId ?? p[0]?.symbolId, y = n({
+		marketId: v ?? 0n,
+		enabled: d && c === void 0 && v !== void 0,
+		chainId: u,
+		config: f
+	}), b = c ?? i(y.markPrice ?? ""), x = a(() => r(_, b), [_, b]), S = t({
+		account: h ? void 0 : g,
+		upnl: x.upnl,
+		live: l,
+		chainId: u,
+		config: f
+	}), C = e({
+		account: g,
+		chainId: u,
+		config: f
+	}), w = c === void 0 && y.isLoading;
+	return a(() => ({
+		metrics: h ? void 0 : S.metrics,
+		upnl: x,
+		liquidationPrice: C.liquidationPrice,
+		markPrice: b,
+		account: g,
+		accounts: m,
+		isMultiAccount: h,
+		isLoading: S.isLoading || C.isLoading || w,
+		error: S.error
+	}), [
+		S.metrics,
+		S.isLoading,
+		S.error,
+		x,
+		C.liquidationPrice,
+		C.isLoading,
+		b,
+		g,
+		m,
+		h,
+		w
+	]);
+}
+//#endregion
+export { o as useQuoteGroupMarginRisk };
+
+//# sourceMappingURL=use-quote-group-margin-risk.js.map

package/dist/quotes/use-quote-group-margin-risk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-group-margin-risk.js","names":[],"sources":["../../src/quotes/use-quote-group-margin-risk.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  aggregateGroupUpnl,\n  decimalPriceToWei,\n  type ConfigParameter,\n  type MarginRiskMetrics,\n  type QuoteGroup,\n  type QuoteGroupUpnl,\n} from \"@symmio/trading-core\";\nimport { useMemo } from \"react\";\nimport type { Address } from \"viem\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useAccountMarginRisk } from \"../margin/use-account-margin-risk\";\nimport { useEnigmaPriceByMarketId } from \"../price-service/use-enigma-price-by-market-id\";\nimport { useAccountLiquidationPrice } from \"./use-account-liquidation-price\";\n\n/**\n * Parameters for {@link useQuoteGroupMarginRisk}.\n */\nexport interface UseQuoteGroupMarginRiskParameters extends ConfigParameter {\n  /** The merged position to describe. */\n  group: QuoteGroup;\n  /**\n   * Mark price override, 18-decimal wei. Omit to subscribe to the group's\n   * market. Pass it when the surrounding screen already holds the price, so the\n   * two do not open separate subscriptions or disagree by a tick.\n   */\n  markPrice?: bigint;\n  /**\n   * Account override; defaults to the group's resolved Virtual Account. The uPnL\n   * fold narrows to this account's children too, so `equity` stays consistent.\n   */\n  account?: Address;\n  /**\n   * Refetch the balance when an open/close settles on-chain.\n   * @default true\n   */\n  live?: boolean;\n  /** Optional override; defaults to the connected chain. */\n  chainId?: number;\n  /**\n   * Run the underlying reads only when `true` — gate a panel that is collapsed.\n   * @default true\n   */\n  enabled?: boolean;\n}\n\n/**\n * Return type of {@link useQuoteGroupMarginRisk}.\n */\nexport interface UseQuoteGroupMarginRiskReturnType {\n  /**\n   * Margin & risk for the group's liquidation domain. `undefined` while the\n   * balance read is in flight, **or** whenever the group spans several accounts\n   * ({@link isMultiAccount}) — blending liquidation domains is never correct.\n   */\n  metrics?: MarginRiskMetrics;\n  /**\n   * The group's aggregated unrealized PnL at {@link markPrice}. Check\n   * `upnl.isComplete` before presenting anything derived from it as final.\n   */\n  upnl: QuoteGroupUpnl;\n  /** Liquidation price of the resolved account, wei. `0n` when unavailable. */\n  liquidationPrice: bigint;\n  /** The mark price actually used, wei; `undefined` before the first tick. */\n  markPrice?: bigint;\n  /** The account {@link metrics} and {@link liquidationPrice} describe. */\n  account?: Address;\n  /** Distinct liquidation domains among the group's children (`vaAddress ?? partyA`). */\n  accounts: Address[];\n  /**\n   * `true` when the group's children live in more than one account. Each is\n   * liquidated independently, so {@link metrics} is suppressed — fan out with\n   * `useAccountMarginRisk` over {@link accounts} instead.\n   */\n  isMultiAccount: boolean;\n  /** `true` while the balance, positions, or price reads are loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Margin and liquidation-risk state of a merged position — the group-level\n * counterpart of `useAccountMarginRisk`.\n *\n * Resolves the group's Virtual Account, folds its children's unrealized PnL\n * against the mark price with core's `aggregateGroupUpnl`, and runs both through\n * `calculateMarginRisk`. The account's liquidation price comes from the existing\n * `useAccountLiquidationPrice`. All arithmetic lives in core; this hook only\n * wires the reads to the folds.\n *\n * **Mark price**: injected wins. Pass `markPrice` (wei) and no price\n * subscription is opened; omit it and the hook subscribes to the group's market.\n *\n * **One liquidation domain per result.** A group normally maps 1:1 to a Virtual\n * Account, because the built-in grouping strategies mirror the sub-account's\n * on-chain isolation type. When it does not — a custom `keyOf`, or grouping by\n * `MARKET` an account isolated by `MARKET_DIRECTION` — `isMultiAccount` is `true`\n * and `metrics` is withheld rather than blended: an account at 2% buffer averaged\n * with one at 200% reads as safe while the first is about to be liquidated.\n *\n * **Equity is exact only when the group covers the account's whole book.**\n * `equity = allocatedBalance + upnl` mixes an account-wide balance with the\n * group's uPnL. That is the same figure the reference app shows, and it is exact\n * whenever the grouping strategy matches the sub-account's isolation type. Group\n * a `MARKET`-isolated account by `MARKET_DIRECTION` and each group is a *subset*\n * of its account, which understates equity — the hook cannot detect that without\n * a second read, so it is stated rather than guessed at.\n *\n * @param parameters - The group, plus optional price/account/chain/config overrides.\n * @returns The group's metrics, uPnL, liquidation price, and query state.\n *\n * @example\n * ```tsx\n * function GroupRisk({ group }: { group: QuoteGroup }) {\n *   const { metrics, upnl, liquidationPrice } = useQuoteGroupMarginRisk({ group });\n *   if (!metrics) return <Skeleton />;\n *   // The three margin rows are uPnL-independent — render them even while\n *   // `upnl.isComplete` is false; gate only equity and the buffer on it.\n *   return <MarginRows metrics={metrics} live={upnl.isComplete} liq={liquidationPrice} />;\n * }\n * ```\n */\nexport function useQuoteGroupMarginRisk(\n  parameters: UseQuoteGroupMarginRiskParameters,\n): UseQuoteGroupMarginRiskReturnType {\n  const { group, markPrice: markPriceOverride, live = true, chainId, enabled = true, config } = parameters;\n  const quotes = group.quotes;\n\n  /** One entry per liquidation domain the children live in, in first-appearance order. */\n  const accounts = useMemo(() => {\n    const seen = new Set<string>();\n    const result: Address[] = [];\n    for (const quote of quotes) {\n      const address = quote.vaAddress ?? quote.partyA;\n      const key = address.toLowerCase();\n      if (seen.has(key)) continue;\n      seen.add(key);\n      result.push(address);\n    }\n    return result;\n  }, [quotes]);\n\n  const isMultiAccount = accounts.length > 1;\n  const account = parameters.account ?? group.vaAddress ?? accounts[0];\n\n  /**\n   * Narrowing to the resolved account is what keeps `equity` honest: without it\n   * an `account` override would fold every child's uPnL against one account's\n   * balance.\n   */\n  const children = useMemo(() => {\n    if (account === undefined) return quotes;\n    const target = account.toLowerCase();\n    return quotes.filter((quote) => (quote.vaAddress ?? quote.partyA).toLowerCase() === target);\n  }, [quotes, account]);\n\n  /** `by.symbolId` is unset under a custom `keyOf`; the children still carry the market. */\n  const symbolId = group.by.symbolId ?? quotes[0]?.symbolId;\n\n  const priceQuery = useEnigmaPriceByMarketId({\n    marketId: symbolId ?? 0n,\n    enabled: enabled && markPriceOverride === undefined && symbolId !== undefined,\n    chainId,\n    config,\n  });\n\n  /**\n   * `decimalPriceToWei` returns `undefined` rather than `0n` for a feed that has\n   * not ticked — a fabricated `0n` would report a total loss.\n   */\n  const markPrice = markPriceOverride ?? decimalPriceToWei(priceQuery.markPrice ?? \"\");\n\n  const upnl = useMemo(() => aggregateGroupUpnl(children, markPrice), [children, markPrice]);\n\n  const risk = useAccountMarginRisk({\n    /** A blended multi-account figure would be misleading, so do not even read for it. */\n    account: isMultiAccount ? undefined : account,\n    upnl: upnl.upnl,\n    live,\n    chainId,\n    config,\n  });\n\n  const liquidation = useAccountLiquidationPrice({ account, chainId, config });\n\n  const isPriceLoading = markPriceOverride === undefined && priceQuery.isLoading;\n\n  return useMemo(\n    () => ({\n      /**\n       * Withheld explicitly, not merely by leaving the read idle: suppressing a\n       * blended cross-account figure is this hook's contract, so it must not\n       * depend on how the account hook happens to behave without an account.\n       */\n      metrics: isMultiAccount ? undefined : risk.metrics,\n      upnl,\n      liquidationPrice: liquidation.liquidationPrice,\n      markPrice,\n      account,\n      accounts,\n      isMultiAccount,\n      isLoading: risk.isLoading || liquidation.isLoading || isPriceLoading,\n      error: risk.error,\n    }),\n    [\n      risk.metrics,\n      risk.isLoading,\n      risk.error,\n      upnl,\n      liquidation.liquidationPrice,\n      liquidation.isLoading,\n      markPrice,\n      account,\n      accounts,\n      isMultiAccount,\n      isPriceLoading,\n    ],\n  );\n}\n"],"mappings":";;;;;;;AA6HA,SAAgB,EACd,GACmC;CACnC,IAAM,EAAE,UAAO,WAAW,GAAmB,UAAO,IAAM,YAAS,aAAU,IAAM,cAAW,GACxF,IAAS,EAAM,QAGf,IAAW,QAAc;EAC7B,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAoB,CAAC;EAC3B,KAAK,IAAM,KAAS,GAAQ;GAC1B,IAAM,IAAU,EAAM,aAAa,EAAM,QACnC,IAAM,EAAQ,YAAY;GAC5B,EAAK,IAAI,CAAG,MAChB,EAAK,IAAI,CAAG,GACZ,EAAO,KAAK,CAAO;EACrB;EACA,OAAO;CACT,GAAG,CAAC,CAAM,CAAC,GAEL,IAAiB,EAAS,SAAS,GACnC,IAAU,EAAW,WAAW,EAAM,aAAa,EAAS,IAO5D,IAAW,QAAc;EAC7B,IAAI,MAAY,KAAA,GAAW,OAAO;EAClC,IAAM,IAAS,EAAQ,YAAY;EACnC,OAAO,EAAO,QAAQ,OAAW,EAAM,aAAa,EAAM,QAAQ,YAAY,MAAM,CAAM;CAC5F,GAAG,CAAC,GAAQ,CAAO,CAAC,GAGd,IAAW,EAAM,GAAG,YAAY,EAAO,IAAI,UAE3C,IAAa,EAAyB;EAC1C,UAAU,KAAY;EACtB,SAAS,KAAW,MAAsB,KAAA,KAAa,MAAa,KAAA;EACpE;EACA;CACF,CAAC,GAMK,IAAY,KAAqB,EAAkB,EAAW,aAAa,EAAE,GAE7E,IAAO,QAAc,EAAmB,GAAU,CAAS,GAAG,CAAC,GAAU,CAAS,CAAC,GAEnF,IAAO,EAAqB;EAEhC,SAAS,IAAiB,KAAA,IAAY;EACtC,MAAM,EAAK;EACX;EACA;EACA;CACF,CAAC,GAEK,IAAc,EAA2B;EAAE;EAAS;EAAS;CAAO,CAAC,GAErE,IAAiB,MAAsB,KAAA,KAAa,EAAW;CAErE,OAAO,SACE;EAML,SAAS,IAAiB,KAAA,IAAY,EAAK;EAC3C;EACA,kBAAkB,EAAY;EAC9B;EACA;EACA;EACA;EACA,WAAW,EAAK,aAAa,EAAY,aAAa;EACtD,OAAO,EAAK;CACd,IACA;EACE,EAAK;EACL,EAAK;EACL,EAAK;EACL;EACA,EAAY;EACZ,EAAY;EACZ;EACA;EACA;EACA;EACA;CACF,CACF;AACF"}

package/dist/quotes/use-quote-upnl-and-pnl.d.ts

@@ -21,9 +21,10 @@ export interface UseQuoteUpnlAndPnlReturnType extends CalculateQuoteUpnlReturnTy
  * Compute unrealized PNL (open size, vs mark) and realized PNL (closed size,
  * vs the quote's recorded close price) for a single {@link UnifiedQuote}.
  *
- * Mark price is resolved live via {@link useEnigmaPriceByMarketId} on the
- * quote's `symbolId`. UPNL stays `"0"` until the first tick for that market
- * arrives.
+ * Mark price is resolved live via {@link usePriceByMarketId} on the quote's
+ * `symbolId` — from whichever price provider serves the chain's resolved solver
+ * (Enigma on lowcap chains, Binance on majors chains). UPNL stays `"0"` until
+ * the first tick for that market arrives.
  *
  * @example
  * ```tsx

package/dist/quotes/use-quote-upnl-and-pnl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote-upnl-and-pnl.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quote-upnl-and-pnl.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAI9B;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,eAAe;IACnE,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,4BAA4B,EAAE,2BAA2B;IAC7G,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;CACpB;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,4BAA4B,GAAG,4BAA4B,CAkDzG"}
+{"version":3,"file":"use-quote-upnl-and-pnl.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quote-upnl-and-pnl.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAI9B;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,eAAe;IACnE,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,4BAA4B,EAAE,2BAA2B;IAC7G,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;CACpB;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,4BAA4B,GAAG,4BAA4B,CAmDzG"}

package/dist/quotes/use-quote-upnl-and-pnl.js

@@ -1,5 +1,5 @@
 "use client";
-import { useEnigmaPriceByMarketId as e } from "../price-service/use-enigma-price-by-market-id.js";
+import { usePriceByMarketId as e } from "../price-service/use-price-by-market-id.js";
 import { calculateQuoteLeverage as t, calculateQuotePnl as n, calculateQuoteUpnl as r } from "@symmio/trading-core";
 import { useMemo as i } from "react";
 //#region src/quotes/use-quote-upnl-and-pnl.ts
@@ -22,6 +22,7 @@ function o(o) {
 		let e = s.initialLockedValues ?? s.lockedValues, i = t({
 			quantity: s.quantity,
 			requestedOpenPrice: s.requestedOpenPrice,
+			openedPrice: s.openedPrice,
 			lockedValues: e
 		}), o = s.closedAmount ?? 0n, l = c.markPrice, { upnl: u, upnlPercent: d } = l ? r({
 			markPrice: l,

package/dist/quotes/use-quote-upnl-and-pnl.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote-upnl-and-pnl.js","names":[],"sources":["../../src/quotes/use-quote-upnl-and-pnl.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  calculateQuoteLeverage,\n  calculateQuotePnl,\n  calculateQuoteUpnl,\n  type CalculateQuotePnlReturnType,\n  type CalculateQuoteUpnlReturnType,\n  type ConfigParameter,\n  type UnifiedQuote,\n} from \"@symmio/trading-core\";\nimport { useMemo } from \"react\";\nimport { useEnigmaPriceByMarketId } from \"../price-service/use-enigma-price-by-market-id\";\n\n/**\n * Parameters for {@link useQuoteUpnlAndPnl}.\n */\nexport interface UseQuoteUpnlAndPnlParameters extends ConfigParameter {\n  /** Unified quote to compute UPNL + realized PNL for. */\n  quote?: UnifiedQuote;\n}\n\n/**\n * Return type of {@link useQuoteUpnlAndPnl}.\n */\nexport interface UseQuoteUpnlAndPnlReturnType extends CalculateQuoteUpnlReturnType, CalculateQuotePnlReturnType {\n  /** Mark price used in the calc, decimal string. `null` until the first tick. */\n  markPrice: string | null;\n  /** Leverage derived from the quote's locked-margin breakdown, decimal string. */\n  leverage: string;\n  /** `true` while markets or mark-price are resolving. */\n  isLoading: boolean;\n}\n\nconst EMPTY: UseQuoteUpnlAndPnlReturnType = {\n  upnl: \"0\",\n  upnlPercent: \"0\",\n  pnl: \"0\",\n  pnlPercent: \"0\",\n  markPrice: null,\n  leverage: \"0\",\n  isLoading: false,\n};\n\n/**\n * Compute unrealized PNL (open size, vs mark) and realized PNL (closed size,\n * vs the quote's recorded close price) for a single {@link UnifiedQuote}.\n *\n * Mark price is resolved live via {@link useEnigmaPriceByMarketId} on the\n * quote's `symbolId`. UPNL stays `\"0\"` until the first tick for that market\n * arrives.\n *\n * @example\n * ```tsx\n * const { upnl, upnlPercent, pnl, pnlPercent, markPrice } = useQuoteUpnlAndPnl({ quote });\n * ```\n */\nexport function useQuoteUpnlAndPnl(parameters: UseQuoteUpnlAndPnlParameters): UseQuoteUpnlAndPnlReturnType {\n  const { quote } = parameters;\n\n  const priceQuery = useEnigmaPriceByMarketId({\n    marketId: quote?.symbolId ?? 0n,\n    enabled: quote !== undefined,\n  });\n\n  return useMemo(() => {\n    if (!quote) return EMPTY;\n\n    const lockedValuesForLeverage = quote.initialLockedValues ?? quote.lockedValues;\n    const leverage = calculateQuoteLeverage({\n      quantity: quote.quantity,\n      requestedOpenPrice: quote.requestedOpenPrice,\n      lockedValues: lockedValuesForLeverage,\n    });\n\n    const closedAmount = quote.closedAmount ?? 0n;\n    const markPrice = priceQuery.markPrice;\n\n    const { upnl, upnlPercent } = markPrice\n      ? calculateQuoteUpnl({\n          markPrice,\n          positionType: quote.positionType,\n          quantity: quote.quantity,\n          closedAmount,\n          openedPrice: quote.openedPrice ?? 0n,\n          leverage,\n        })\n      : { upnl: \"0\", upnlPercent: \"0\" };\n\n    const { pnl, pnlPercent } = calculateQuotePnl({\n      positionType: quote.positionType,\n      closedAmount,\n      closedPrice: quote.avgClosedPrice ?? 0n,\n      openedPrice: quote.openedPrice ?? 0n,\n      leverage,\n    });\n\n    return {\n      upnl,\n      upnlPercent,\n      pnl,\n      pnlPercent,\n      markPrice,\n      leverage,\n      isLoading: priceQuery.isLoading,\n    };\n  }, [quote, priceQuery.markPrice, priceQuery.isLoading]);\n}\n"],"mappings":";;;;;AAkCA,IAAM,IAAsC;CAC1C,MAAM;CACN,aAAa;CACb,KAAK;CACL,YAAY;CACZ,WAAW;CACX,UAAU;CACV,WAAW;AACb;AAeA,SAAgB,EAAmB,GAAwE;CACzG,IAAM,EAAE,aAAU,GAEZ,IAAa,EAAyB;EAC1C,UAAU,GAAO,YAAY;EAC7B,SAAS,MAAU,KAAA;CACrB,CAAC;CAED,OAAO,QAAc;EACnB,IAAI,CAAC,GAAO,OAAO;EAEnB,IAAM,IAA0B,EAAM,uBAAuB,EAAM,cAC7D,IAAW,EAAuB;GACtC,UAAU,EAAM;GAChB,oBAAoB,EAAM;GAC1B,cAAc;EAChB,CAAC,GAEK,IAAe,EAAM,gBAAgB,IACrC,IAAY,EAAW,WAEvB,EAAE,SAAM,mBAAgB,IAC1B,EAAmB;GACjB;GACA,cAAc,EAAM;GACpB,UAAU,EAAM;GAChB;GACA,aAAa,EAAM,eAAe;GAClC;EACF,CAAC,IACD;GAAE,MAAM;GAAK,aAAa;EAAI,GAE5B,EAAE,QAAK,kBAAe,EAAkB;GAC5C,cAAc,EAAM;GACpB;GACA,aAAa,EAAM,kBAAkB;GACrC,aAAa,EAAM,eAAe;GAClC;EACF,CAAC;EAED,OAAO;GACL;GACA;GACA;GACA;GACA;GACA;GACA,WAAW,EAAW;EACxB;CACF,GAAG;EAAC;EAAO,EAAW;EAAW,EAAW;CAAS,CAAC;AACxD"}
+{"version":3,"file":"use-quote-upnl-and-pnl.js","names":[],"sources":["../../src/quotes/use-quote-upnl-and-pnl.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  calculateQuoteLeverage,\n  calculateQuotePnl,\n  calculateQuoteUpnl,\n  type CalculateQuotePnlReturnType,\n  type CalculateQuoteUpnlReturnType,\n  type ConfigParameter,\n  type UnifiedQuote,\n} from \"@symmio/trading-core\";\nimport { useMemo } from \"react\";\nimport { usePriceByMarketId } from \"../price-service/use-price-by-market-id\";\n\n/**\n * Parameters for {@link useQuoteUpnlAndPnl}.\n */\nexport interface UseQuoteUpnlAndPnlParameters extends ConfigParameter {\n  /** Unified quote to compute UPNL + realized PNL for. */\n  quote?: UnifiedQuote;\n}\n\n/**\n * Return type of {@link useQuoteUpnlAndPnl}.\n */\nexport interface UseQuoteUpnlAndPnlReturnType extends CalculateQuoteUpnlReturnType, CalculateQuotePnlReturnType {\n  /** Mark price used in the calc, decimal string. `null` until the first tick. */\n  markPrice: string | null;\n  /** Leverage derived from the quote's locked-margin breakdown, decimal string. */\n  leverage: string;\n  /** `true` while markets or mark-price are resolving. */\n  isLoading: boolean;\n}\n\nconst EMPTY: UseQuoteUpnlAndPnlReturnType = {\n  upnl: \"0\",\n  upnlPercent: \"0\",\n  pnl: \"0\",\n  pnlPercent: \"0\",\n  markPrice: null,\n  leverage: \"0\",\n  isLoading: false,\n};\n\n/**\n * Compute unrealized PNL (open size, vs mark) and realized PNL (closed size,\n * vs the quote's recorded close price) for a single {@link UnifiedQuote}.\n *\n * Mark price is resolved live via {@link usePriceByMarketId} on the quote's\n * `symbolId` — from whichever price provider serves the chain's resolved solver\n * (Enigma on lowcap chains, Binance on majors chains). UPNL stays `\"0\"` until\n * the first tick for that market arrives.\n *\n * @example\n * ```tsx\n * const { upnl, upnlPercent, pnl, pnlPercent, markPrice } = useQuoteUpnlAndPnl({ quote });\n * ```\n */\nexport function useQuoteUpnlAndPnl(parameters: UseQuoteUpnlAndPnlParameters): UseQuoteUpnlAndPnlReturnType {\n  const { quote } = parameters;\n\n  const priceQuery = usePriceByMarketId({\n    marketId: quote?.symbolId ?? 0n,\n    enabled: quote !== undefined,\n  });\n\n  return useMemo(() => {\n    if (!quote) return EMPTY;\n\n    const lockedValuesForLeverage = quote.initialLockedValues ?? quote.lockedValues;\n    const leverage = calculateQuoteLeverage({\n      quantity: quote.quantity,\n      requestedOpenPrice: quote.requestedOpenPrice,\n      openedPrice: quote.openedPrice,\n      lockedValues: lockedValuesForLeverage,\n    });\n\n    const closedAmount = quote.closedAmount ?? 0n;\n    const markPrice = priceQuery.markPrice;\n\n    const { upnl, upnlPercent } = markPrice\n      ? calculateQuoteUpnl({\n          markPrice,\n          positionType: quote.positionType,\n          quantity: quote.quantity,\n          closedAmount,\n          openedPrice: quote.openedPrice ?? 0n,\n          leverage,\n        })\n      : { upnl: \"0\", upnlPercent: \"0\" };\n\n    const { pnl, pnlPercent } = calculateQuotePnl({\n      positionType: quote.positionType,\n      closedAmount,\n      closedPrice: quote.avgClosedPrice ?? 0n,\n      openedPrice: quote.openedPrice ?? 0n,\n      leverage,\n    });\n\n    return {\n      upnl,\n      upnlPercent,\n      pnl,\n      pnlPercent,\n      markPrice,\n      leverage,\n      isLoading: priceQuery.isLoading,\n    };\n  }, [quote, priceQuery.markPrice, priceQuery.isLoading]);\n}\n"],"mappings":";;;;;AAkCA,IAAM,IAAsC;CAC1C,MAAM;CACN,aAAa;CACb,KAAK;CACL,YAAY;CACZ,WAAW;CACX,UAAU;CACV,WAAW;AACb;AAgBA,SAAgB,EAAmB,GAAwE;CACzG,IAAM,EAAE,aAAU,GAEZ,IAAa,EAAmB;EACpC,UAAU,GAAO,YAAY;EAC7B,SAAS,MAAU,KAAA;CACrB,CAAC;CAED,OAAO,QAAc;EACnB,IAAI,CAAC,GAAO,OAAO;EAEnB,IAAM,IAA0B,EAAM,uBAAuB,EAAM,cAC7D,IAAW,EAAuB;GACtC,UAAU,EAAM;GAChB,oBAAoB,EAAM;GAC1B,aAAa,EAAM;GACnB,cAAc;EAChB,CAAC,GAEK,IAAe,EAAM,gBAAgB,IACrC,IAAY,EAAW,WAEvB,EAAE,SAAM,mBAAgB,IAC1B,EAAmB;GACjB;GACA,cAAc,EAAM;GACpB,UAAU,EAAM;GAChB;GACA,aAAa,EAAM,eAAe;GAClC;EACF,CAAC,IACD;GAAE,MAAM;GAAK,aAAa;EAAI,GAE5B,EAAE,QAAK,kBAAe,EAAkB;GAC5C,cAAc,EAAM;GACpB;GACA,aAAa,EAAM,kBAAkB;GACrC,aAAa,EAAM,eAAe;GAClC;EACF,CAAC;EAED,OAAO;GACL;GACA;GACA;GACA;GACA;GACA;GACA,WAAW,EAAW;EACxB;CACF,GAAG;EAAC;EAAO,EAAW;EAAW,EAAW;CAAS,CAAC;AACxD"}

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

@@ -11,8 +11,9 @@ export interface QuotesFundingInputQuote {
 export interface UseQuotesFundingParameters extends Omit<GetQuoteFundingOptions, "quoteIds">, ConfigParameter {
     /**
      * Quotes (or quote-id-bearing rows) to read funding for. Off-chain rows
-     * (`quoteId === undefined`) are silently skipped. All resolved on-chain ids
-     * are fetched in a single subgraph round-trip.
+     * (`quoteId === undefined`) are silently skipped. The resolved on-chain ids are
+     * de-duplicated and fetched in a single subgraph round-trip, so listing the
+     * same quote twice costs one request and contributes to the sums once.
      */
     quotes: readonly QuotesFundingInputQuote[];
 }
@@ -20,15 +21,35 @@ export interface UseQuotesFundingParameters extends Omit<GetQuoteFundingOptions,
  * Return type of {@link useQuotesFunding}.
  */
 export interface UseQuotesFundingReturnType {
-    /** Funding row per input quote, in input order. `null` for off-chain rows or ids the subgraph hasn't surfaced yet. */
+    /**
+     * Funding row per input quote, aligned 1:1 with `quotes` and in input order —
+     * `rows.length === quotes.length` on every path, including while loading and
+     * when nothing on-chain was requested. An entry is `null` for an off-chain row
+     * (no `quoteId`) or for an id the subgraph has not surfaced yet.
+     */
     rows: Array<QuoteFundingData | null>;
-    /** Σ paid across resolved rows (wei). */
+    /**
+     * Σ funding paid across the resolved rows (wei). Summed over the **distinct**
+     * on-chain ids, so a quote listed twice contributes once.
+     */
     paid: bigint;
-    /** Σ received across resolved rows (wei). */
+    /**
+     * Σ funding received across the resolved rows (wei). Summed over the
+     * **distinct** on-chain ids, so a quote listed twice contributes once.
+     */
     received: bigint;
-    /** Σ net (paid − received) across resolved rows (wei). */
-    net: bigint;
-    /** Subset of input ids the subgraph has not yet returned (indexing lag). */
+    /**
+     * Σ `received − paid` across the resolved rows (wei). **Positive = the position
+     * earned funding**; negative = it paid for it. A lower bound while
+     * `missingQuoteIds` is non-empty.
+     */
+    netReceived: bigint;
+    /**
+     * Requested on-chain ids that have no funding row yet. While the query is in
+     * flight — and if it fails — this is **every** requested id, since nothing has
+     * resolved; once it settles it is the subset the subgraph did not return
+     * (indexing lag). Always empty when no on-chain ids were requested.
+     */
     missingQuoteIds: bigint[];
     /** `true` while the underlying subgraph query is loading. */
     isLoading: boolean;
@@ -41,11 +62,26 @@ export interface UseQuotesFundingReturnType {
  *
  * The hook is the canonical entry point for both single-quote details panels
  * ({@link useQuoteFunding} delegates here with a 1-element list) and grouped
- * quote cards (which want `Σ net`). Off-chain rows are skipped silently.
+ * quote cards (which want `Σ netReceived`). Off-chain rows are skipped silently,
+ * and duplicate ids are fetched — and summed — exactly once.
+ *
+ * **Sign convention** — `netReceived = received − paid`, the P&L perspective, so
+ * a **positive** value means the position **earned** funding. This matches
+ * `QuoteFundingData.netReceived` and the uPnL folds, and is the inverse of the
+ * cost-positive on-chain `int256`. A "green = income" UI renders it directly.
+ *
+ * **Settled to date only** — the 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 quotes to read funding for, plus optional chain/config overrides.
+ * @returns Per-quote rows aligned with `quotes`, the aggregate sums, and query state.
  *
  * @example
  * ```tsx
- * const { rows, net, isLoading } = useQuotesFunding({ quotes: group.quotes });
+ * const { rows, netReceived, missingQuoteIds, isLoading } = useQuotesFunding({ quotes: group.quotes });
+ * // `netReceived > 0n` → the position earned funding across the resolved rows.
  * ```
  */
 export declare function useQuotesFunding(parameters: UseQuotesFundingParameters): UseQuotesFundingReturnType;

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

@@ -1 +1 @@
-{"version":3,"file":"use-quotes-funding.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quotes-funding.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,EAAE,eAAe;IAC3G;;;;OAIG;IACH,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sHAAsH;IACtH,IAAI,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACrC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,0BAA0B,CA6EnG"}
+{"version":3,"file":"use-quotes-funding.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quotes-funding.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,EAAE,eAAe;IAC3G;;;;;OAKG;IACH,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,IAAI,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACrC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,0BAA0B,CAgGnG"}

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

@@ -6,75 +6,77 @@ import { getQuoteFundingQueryOptions as r } from "@symmio/trading-core";
 import { useMemo as i } from "react";
 import { useQuery as a } from "@tanstack/react-query";
 //#region src/quotes/use-quotes-funding.ts
-var o = {
-	rows: [],
-	paid: 0n,
-	received: 0n,
-	net: 0n,
-	missingQuoteIds: [],
-	isLoading: !1,
-	error: null
-};
-function s(s) {
-	let { quotes: c, ...l } = s, u = t(s), d = e(), f = i(() => {
+function o(o) {
+	let { quotes: s, ...c } = o, l = t(o), u = e(), d = i(() => {
 		let e = /* @__PURE__ */ new Set(), t = [];
-		for (let n of c) {
+		for (let n of s) {
 			if (n.quoteId === void 0) continue;
 			let r = n.quoteId.toString();
 			e.has(r) || (e.add(r), t.push(n.quoteId));
 		}
 		return t;
-	}, [c]), p = r(u, {
-		...l,
-		chainId: l.chainId ?? d,
-		quoteIds: f
-	}), m = a({
-		...p,
+	}, [s]), f = r(l, {
+		...c,
+		chainId: c.chainId ?? u,
+		quoteIds: d
+	}), p = a({
+		...f,
 		queryFn: async () => {
 			try {
-				return await p.queryFn();
+				return await f.queryFn();
 			} catch (e) {
 				throw n(e);
 			}
 		}
 	});
 	return i(() => {
-		if (f.length === 0) return o;
-		let e = m.data;
-		if (!e) return {
-			rows: c.map(() => null),
+		if (d.length === 0) return {
+			rows: s.map(() => null),
 			paid: 0n,
 			received: 0n,
-			net: 0n,
+			netReceived: 0n,
 			missingQuoteIds: [],
-			isLoading: m.isLoading,
-			error: m.error ?? null
+			isLoading: !1,
+			error: null
+		};
+		let e = p.data;
+		if (!e) return {
+			rows: s.map(() => null),
+			paid: 0n,
+			received: 0n,
+			netReceived: 0n,
+			missingQuoteIds: [...d],
+			isLoading: p.isLoading,
+			error: p.error ?? null
 		};
 		let t = /* @__PURE__ */ new Map();
-		for (let n of e.rows) t.set(n.quoteId.toString(), n);
-		let n = 0n, r = 0n, i = 0n;
+		for (let n of e.rows) {
+			let e = n.quoteId.toString();
+			t.has(e) || t.set(e, n);
+		}
+		let n = 0n, r = 0n;
+		for (let e of d) {
+			let i = t.get(e.toString());
+			i !== void 0 && (n += i.paid, r += i.received);
+		}
 		return {
-			rows: c.map((e) => {
-				if (e.quoteId === void 0) return null;
-				let a = t.get(e.quoteId.toString()) ?? null;
-				return a && (n += a.paid, r += a.received, i += a.net), a;
-			}),
+			rows: s.map((e) => e.quoteId === void 0 ? null : t.get(e.quoteId.toString()) ?? null),
 			paid: n,
 			received: r,
-			net: i,
+			netReceived: r - n,
 			missingQuoteIds: e.missingQuoteIds,
-			isLoading: m.isLoading,
-			error: m.error ?? null
+			isLoading: p.isLoading,
+			error: p.error ?? null
 		};
 	}, [
-		f,
-		c,
-		m.data,
-		m.isLoading,
-		m.error
+		d,
+		s,
+		p.data,
+		p.isLoading,
+		p.error
 	]);
 }
 //#endregion
-export { s as useQuotesFunding };
+export { o as useQuotesFunding };
 
 //# sourceMappingURL=use-quotes-funding.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-quotes-funding.js","names":[],"sources":["../../src/quotes/use-quotes-funding.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuoteFundingQueryOptions,\n  type ConfigParameter,\n  type GetQuoteFundingOptions,\n  type QuoteFundingData,\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/** Minimum quote shape `useQuotesFunding` needs: just the on-chain id. */\nexport interface QuotesFundingInputQuote {\n  /** On-chain quote id. Off-chain (pending) rows pass `undefined` and are skipped. */\n  quoteId?: bigint;\n}\n\n/**\n * Parameters for {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingParameters extends Omit<GetQuoteFundingOptions, \"quoteIds\">, ConfigParameter {\n  /**\n   * Quotes (or quote-id-bearing rows) to read funding for. Off-chain rows\n   * (`quoteId === undefined`) are silently skipped. All resolved on-chain ids\n   * are fetched in a single subgraph round-trip.\n   */\n  quotes: readonly QuotesFundingInputQuote[];\n}\n\n/**\n * Return type of {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingReturnType {\n  /** Funding row per input quote, in input order. `null` for off-chain rows or ids the subgraph hasn't surfaced yet. */\n  rows: Array<QuoteFundingData | null>;\n  /** Σ paid across resolved rows (wei). */\n  paid: bigint;\n  /** Σ received across resolved rows (wei). */\n  received: bigint;\n  /** Σ net (paid − received) across resolved rows (wei). */\n  net: bigint;\n  /** Subset of input ids the subgraph has not yet returned (indexing lag). */\n  missingQuoteIds: bigint[];\n  /** `true` while the underlying subgraph query is loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\nconst EMPTY: UseQuotesFundingReturnType = {\n  rows: [],\n  paid: 0n,\n  received: 0n,\n  net: 0n,\n  missingQuoteIds: [],\n  isLoading: false,\n  error: null,\n};\n\n/**\n * Batch-read funding totals for a list of quotes from the analytics subgraph in\n * a single round-trip and aggregate them into running sums for the group.\n *\n * The hook is the canonical entry point for both single-quote details panels\n * ({@link useQuoteFunding} delegates here with a 1-element list) and grouped\n * quote cards (which want `Σ net`). Off-chain rows are skipped silently.\n *\n * @example\n * ```tsx\n * const { rows, net, isLoading } = useQuotesFunding({ quotes: group.quotes });\n * ```\n */\nexport function useQuotesFunding(parameters: UseQuotesFundingParameters): UseQuotesFundingReturnType {\n  const { quotes, ...rest } = parameters;\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  const onchainQuoteIds = useMemo(() => {\n    const seen = new Set<string>();\n    const ids: bigint[] = [];\n    for (const quote of 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  }, [quotes]);\n\n  const options = getQuoteFundingQueryOptions(config, {\n    ...rest,\n    chainId: rest.chainId ?? chainId,\n    quoteIds: onchainQuoteIds,\n  });\n\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<{ rows: QuoteFundingData[]; missingQuoteIds: bigint[] }, SymmioRequestError>;\n\n  return useMemo(() => {\n    if (onchainQuoteIds.length === 0) return EMPTY;\n    const data = query.data;\n    if (!data) {\n      return {\n        rows: quotes.map(() => null),\n        paid: 0n,\n        received: 0n,\n        net: 0n,\n        missingQuoteIds: [],\n        isLoading: query.isLoading,\n        error: query.error ?? null,\n      };\n    }\n\n    const byQuoteId = new Map<string, QuoteFundingData>();\n    for (const row of data.rows) byQuoteId.set(row.quoteId.toString(), row);\n\n    let paid = 0n;\n    let received = 0n;\n    let net = 0n;\n    const rows = quotes.map((quote) => {\n      if (quote.quoteId === undefined) return null;\n      const row = byQuoteId.get(quote.quoteId.toString()) ?? null;\n      if (row) {\n        paid += row.paid;\n        received += row.received;\n        net += row.net;\n      }\n      return row;\n    });\n\n    return {\n      rows,\n      paid,\n      received,\n      net,\n      missingQuoteIds: data.missingQuoteIds,\n      isLoading: query.isLoading,\n      error: query.error ?? null,\n    };\n  }, [onchainQuoteIds, quotes, query.data, query.isLoading, query.error]);\n}\n"],"mappings":";;;;;;;;AAqDA,IAAM,IAAoC;CACxC,MAAM,CAAC;CACP,MAAM;CACN,UAAU;CACV,KAAK;CACL,iBAAiB,CAAC;CAClB,WAAW;CACX,OAAO;AACT;AAeA,SAAgB,EAAiB,GAAoE;CACnG,IAAM,EAAE,WAAQ,GAAG,MAAS,GACtB,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAE3B,IAAkB,QAAc;EACpC,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAgB,CAAC;EACvB,KAAK,IAAM,KAAS,GAAQ;GAC1B,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,CAAM,CAAC,GAEL,IAAU,EAA4B,GAAQ;EAClD,GAAG;EACH,SAAS,EAAK,WAAW;EACzB,UAAU;CACZ,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;CAED,OAAO,QAAc;EACnB,IAAI,EAAgB,WAAW,GAAG,OAAO;EACzC,IAAM,IAAO,EAAM;EACnB,IAAI,CAAC,GACH,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,MAAM;GACN,UAAU;GACV,KAAK;GACL,iBAAiB,CAAC;GAClB,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;EAGF,IAAM,oBAAY,IAAI,IAA8B;EACpD,KAAK,IAAM,KAAO,EAAK,MAAM,EAAU,IAAI,EAAI,QAAQ,SAAS,GAAG,CAAG;EAEtE,IAAI,IAAO,IACP,IAAW,IACX,IAAM;EAYV,OAAO;GACL,MAZW,EAAO,KAAK,MAAU;IACjC,IAAI,EAAM,YAAY,KAAA,GAAW,OAAO;IACxC,IAAM,IAAM,EAAU,IAAI,EAAM,QAAQ,SAAS,CAAC,KAAK;IAMvD,OALI,MACF,KAAQ,EAAI,MACZ,KAAY,EAAI,UAChB,KAAO,EAAI,MAEN;GACT,CAGE;GACA;GACA;GACA;GACA,iBAAiB,EAAK;GACtB,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;CACF,GAAG;EAAC;EAAiB;EAAQ,EAAM;EAAM,EAAM;EAAW,EAAM;CAAK,CAAC;AACxE"}
+{"version":3,"file":"use-quotes-funding.js","names":[],"sources":["../../src/quotes/use-quotes-funding.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuoteFundingQueryOptions,\n  type ConfigParameter,\n  type GetQuoteFundingOptions,\n  type QuoteFundingData,\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/** Minimum quote shape `useQuotesFunding` needs: just the on-chain id. */\nexport interface QuotesFundingInputQuote {\n  /** On-chain quote id. Off-chain (pending) rows pass `undefined` and are skipped. */\n  quoteId?: bigint;\n}\n\n/**\n * Parameters for {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingParameters extends Omit<GetQuoteFundingOptions, \"quoteIds\">, ConfigParameter {\n  /**\n   * Quotes (or quote-id-bearing rows) to read funding for. Off-chain rows\n   * (`quoteId === undefined`) are silently skipped. The resolved on-chain ids are\n   * de-duplicated and fetched in a single subgraph round-trip, so listing the\n   * same quote twice costs one request and contributes to the sums once.\n   */\n  quotes: readonly QuotesFundingInputQuote[];\n}\n\n/**\n * Return type of {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingReturnType {\n  /**\n   * Funding row per input quote, aligned 1:1 with `quotes` and in input order —\n   * `rows.length === quotes.length` on every path, including while loading and\n   * when nothing on-chain was requested. An entry is `null` for an off-chain row\n   * (no `quoteId`) or for an id the subgraph has not surfaced yet.\n   */\n  rows: Array<QuoteFundingData | null>;\n  /**\n   * Σ funding paid across the resolved rows (wei). Summed over the **distinct**\n   * on-chain ids, so a quote listed twice contributes once.\n   */\n  paid: bigint;\n  /**\n   * Σ funding received across the resolved rows (wei). Summed over the\n   * **distinct** on-chain ids, so a quote listed twice contributes once.\n   */\n  received: bigint;\n  /**\n   * Σ `received − paid` across the resolved rows (wei). **Positive = the position\n   * earned funding**; negative = it paid for it. A lower bound while\n   * `missingQuoteIds` is non-empty.\n   */\n  netReceived: bigint;\n  /**\n   * Requested on-chain ids that have no funding row yet. While the query is in\n   * flight — and if it fails — this is **every** requested id, since nothing has\n   * resolved; once it settles it is the subset the subgraph did not return\n   * (indexing lag). Always empty when no on-chain ids were requested.\n   */\n  missingQuoteIds: bigint[];\n  /** `true` while the underlying subgraph query is loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Batch-read funding totals for a list of quotes from the analytics subgraph in\n * a single round-trip and aggregate them into running sums for the group.\n *\n * The hook is the canonical entry point for both single-quote details panels\n * ({@link useQuoteFunding} delegates here with a 1-element list) and grouped\n * quote cards (which want `Σ netReceived`). Off-chain rows are skipped silently,\n * and duplicate ids are fetched — and summed — exactly once.\n *\n * **Sign convention** — `netReceived = received − paid`, the P&L perspective, so\n * a **positive** value means the position **earned** funding. This matches\n * `QuoteFundingData.netReceived` and the uPnL folds, and is the inverse of the\n * cost-positive on-chain `int256`. A \"green = income\" UI renders it directly.\n *\n * **Settled to date only** — the totals cover funding the protocol has already\n * charged and the analytics subgraph has indexed. Funding accrued since a\n * quote's last funding charge is not indexed anywhere and is therefore not\n * included.\n *\n * @param parameters - The quotes to read funding for, plus optional chain/config overrides.\n * @returns Per-quote rows aligned with `quotes`, the aggregate sums, and query state.\n *\n * @example\n * ```tsx\n * const { rows, netReceived, missingQuoteIds, isLoading } = useQuotesFunding({ quotes: group.quotes });\n * // `netReceived > 0n` → the position earned funding across the resolved rows.\n * ```\n */\nexport function useQuotesFunding(parameters: UseQuotesFundingParameters): UseQuotesFundingReturnType {\n  const { quotes, ...rest } = parameters;\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  const onchainQuoteIds = useMemo(() => {\n    const seen = new Set<string>();\n    const ids: bigint[] = [];\n    for (const quote of 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  }, [quotes]);\n\n  const options = getQuoteFundingQueryOptions(config, {\n    ...rest,\n    chainId: rest.chainId ?? chainId,\n    quoteIds: onchainQuoteIds,\n  });\n\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<{ rows: QuoteFundingData[]; missingQuoteIds: bigint[] }, SymmioRequestError>;\n\n  return useMemo(() => {\n    /** Nothing on-chain to read: the query is disabled, but `rows` still owes one entry per input quote. */\n    if (onchainQuoteIds.length === 0) {\n      return {\n        rows: quotes.map(() => null),\n        paid: 0n,\n        received: 0n,\n        netReceived: 0n,\n        missingQuoteIds: [],\n        isLoading: false,\n        error: null,\n      };\n    }\n\n    const data = query.data;\n    if (!data) {\n      return {\n        rows: quotes.map(() => null),\n        paid: 0n,\n        received: 0n,\n        netReceived: 0n,\n        /** In flight (or failed): nothing resolved, so every requested id is still outstanding. */\n        missingQuoteIds: [...onchainQuoteIds],\n        isLoading: query.isLoading,\n        error: query.error ?? null,\n      };\n    }\n\n    /** First row wins per id — a repeated row for the same quote must not double-count. */\n    const byQuoteId = new Map<string, QuoteFundingData>();\n    for (const row of data.rows) {\n      const key = row.quoteId.toString();\n      if (!byQuoteId.has(key)) byQuoteId.set(key, row);\n    }\n\n    let paid = 0n;\n    let received = 0n;\n    /** Fold over the de-duped ids, never over `quotes` — the same id listed twice is fetched once and must sum once. */\n    for (const quoteId of onchainQuoteIds) {\n      const row = byQuoteId.get(quoteId.toString());\n      if (row === undefined) continue;\n      paid += row.paid;\n      received += row.received;\n    }\n\n    /** Built by lookup afterwards, so the 1:1 alignment with `quotes` is independent of the fold. */\n    const rows = quotes.map((quote) =>\n      quote.quoteId === undefined ? null : (byQuoteId.get(quote.quoteId.toString()) ?? null),\n    );\n\n    return {\n      rows,\n      paid,\n      received,\n      /** Derived from the sums so the aggregate keeps the row-level `netReceived = received − paid` invariant. */\n      netReceived: received - paid,\n      missingQuoteIds: data.missingQuoteIds,\n      isLoading: query.isLoading,\n      error: query.error ?? null,\n    };\n  }, [onchainQuoteIds, quotes, query.data, query.isLoading, query.error]);\n}\n"],"mappings":";;;;;;;;AAsGA,SAAgB,EAAiB,GAAoE;CACnG,IAAM,EAAE,WAAQ,GAAG,MAAS,GACtB,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAE3B,IAAkB,QAAc;EACpC,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAgB,CAAC;EACvB,KAAK,IAAM,KAAS,GAAQ;GAC1B,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,CAAM,CAAC,GAEL,IAAU,EAA4B,GAAQ;EAClD,GAAG;EACH,SAAS,EAAK,WAAW;EACzB,UAAU;CACZ,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;CAED,OAAO,QAAc;EAEnB,IAAI,EAAgB,WAAW,GAC7B,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,MAAM;GACN,UAAU;GACV,aAAa;GACb,iBAAiB,CAAC;GAClB,WAAW;GACX,OAAO;EACT;EAGF,IAAM,IAAO,EAAM;EACnB,IAAI,CAAC,GACH,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,MAAM;GACN,UAAU;GACV,aAAa;GAEb,iBAAiB,CAAC,GAAG,CAAe;GACpC,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;EAIF,IAAM,oBAAY,IAAI,IAA8B;EACpD,KAAK,IAAM,KAAO,EAAK,MAAM;GAC3B,IAAM,IAAM,EAAI,QAAQ,SAAS;GACjC,AAAK,EAAU,IAAI,CAAG,KAAG,EAAU,IAAI,GAAK,CAAG;EACjD;EAEA,IAAI,IAAO,IACP,IAAW;EAEf,KAAK,IAAM,KAAW,GAAiB;GACrC,IAAM,IAAM,EAAU,IAAI,EAAQ,SAAS,CAAC;GACxC,MAAQ,KAAA,MACZ,KAAQ,EAAI,MACZ,KAAY,EAAI;EAClB;EAOA,OAAO;GACL,MALW,EAAO,KAAK,MACvB,EAAM,YAAY,KAAA,IAAY,OAAQ,EAAU,IAAI,EAAM,QAAQ,SAAS,CAAC,KAAK,IAIjF;GACA;GACA;GAEA,aAAa,IAAW;GACxB,iBAAiB,EAAK;GACtB,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;CACF,GAAG;EAAC;EAAiB;EAAQ,EAAM;EAAM,EAAM;EAAW,EAAM;CAAK,CAAC;AACxE"}

package/dist/quotes/use-request-to-cancel-close-request.d.ts

@@ -0,0 +1,27 @@
+import { RequestToCancelCloseRequestParameters } from '@symmio/trading-core';
+import { UseMutationResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+import { WriteParameters, WriteResult } from '../transactions/index.js';
+/** Parameters for {@link useRequestToCancelCloseRequest}. */
+export type UseRequestToCancelCloseRequestParameters = WriteParameters;
+/** Result returned by the {@link useRequestToCancelCloseRequest} mutation. */
+export type RequestToCancelCloseRequestResult = WriteResult;
+/** Return type of {@link useRequestToCancelCloseRequest}. */
+export type UseRequestToCancelCloseRequestReturnType = UseMutationResult<RequestToCancelCloseRequestResult, SymmioRequestError, RequestToCancelCloseRequestParameters>;
+/**
+ * Cancel a pending close (`requestToCancelCloseRequest`, routed through the
+ * AccountLayer `_call` proxy) — how a partyA backs out of a resting close (e.g.
+ * a limit close) while the quote is `CLOSE_PENDING`. If partyB accepts, the quote
+ * returns to `OPENED`; if partyB stalls it enters `CANCEL_CLOSE_PENDING`, which
+ * {@link useForceCancelCloseRequest} escalates once the cooldown passes. On
+ * success (after the receipt) the subaccount's open-positions read is invalidated
+ * so the row's status refreshes.
+ *
+ * @example
+ * ```tsx
+ * const { mutate } = useRequestToCancelCloseRequest();
+ * mutate({ account: "0xsub…", quoteId: 42n });
+ * ```
+ */
+export declare function useRequestToCancelCloseRequest(parameters?: UseRequestToCancelCloseRequestParameters): UseRequestToCancelCloseRequestReturnType;
+//# sourceMappingURL=use-request-to-cancel-close-request.d.ts.map

package/dist/quotes/use-request-to-cancel-close-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-request-to-cancel-close-request.d.ts","sourceRoot":"","sources":["../../src/quotes/use-request-to-cancel-close-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,qCAAqC,EAC3C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F,6DAA6D;AAC7D,MAAM,MAAM,wCAAwC,GAAG,eAAe,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,MAAM,iCAAiC,GAAG,WAAW,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,MAAM,wCAAwC,GAAG,iBAAiB,CACtE,iCAAiC,EACjC,kBAAkB,EAClB,qCAAqC,CACtC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,GAAE,wCAA6C,GACxD,wCAAwC,CAmC1C"}