@symmio/trading-core 1.1.0 → 2.0.0

package/dist/quotes/get-quotes-events-by-type/query-document.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Batched sibling of `QuoteEventsForQuoteByTypeDocument`: read every `QuoteEvent`
+ * of the requested types for **many** quote ids in one round-trip, merged and
+ * sorted server-side by `timestamp`. Filters on the protocol-level `quoteId`
+ * scalar via `quoteId_in` — the same batching `QuotesFundingDocument` uses — so
+ * callers never need the diamond address.
+ *
+ * The field selection is deliberately identical to the single-quote document so
+ * `toQuoteEventRow` decodes both without change.
+ *
+ * The document compiles to a typed query string via graphql-codegen.
+ */
+export declare const QuoteEventsForQuotesByTypeDocument: import('../../symmio-subgraph/types/generated/analytics/graphql.js').TypedDocumentString<import('../../symmio-subgraph/types/generated/analytics/graphql.js').QuoteEventsForQuotesByTypeQuery, {
+    quoteIds: Array<string> | string;
+    typeIn: Array<string> | string;
+    first: number;
+    skip: number;
+    orderDirection: import('../../symmio-subgraph/types/generated/analytics/graphql.js').OrderDirection;
+}>;
+//# sourceMappingURL=query-document.d.ts.map

package/dist/quotes/get-quotes-events-by-type/query-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-document.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-quotes-events-by-type/query-document.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC;;;;;;EAwB7C,CAAC"}

package/dist/quotes/get-quotes-events-by-type/query-document.js

@@ -0,0 +1,7 @@
+import { graphql as e } from "../../symmio-subgraph/types/generated/analytics/gql.js";
+//#region src/quotes/get-quotes-events-by-type/query-document.ts
+var t = e("\n  query QuoteEventsForQuotesByType(\n    $quoteIds: [BigInt!]!\n    $typeIn: [String!]!\n    $first: Int!\n    $skip: Int!\n    $orderDirection: OrderDirection!\n  ) {\n    quoteEvents(\n      first: $first\n      skip: $skip\n      orderBy: timestamp\n      orderDirection: $orderDirection\n      where: { quoteId_in: $quoteIds, type_in: $typeIn }\n    ) {\n      id\n      type\n      metadata\n      timestamp\n      blockNumber\n      transaction\n      quoteId\n    }\n  }\n");
+//#endregion
+export { t as QuoteEventsForQuotesByTypeDocument };
+
+//# sourceMappingURL=query-document.js.map

package/dist/quotes/get-quotes-events-by-type/query-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-document.js","names":[],"sources":["../../../src/quotes/get-quotes-events-by-type/query-document.ts"],"sourcesContent":["import { graphql } from \"../../symmio-subgraph/types/generated/analytics\";\n\n/**\n * Batched sibling of `QuoteEventsForQuoteByTypeDocument`: read every `QuoteEvent`\n * of the requested types for **many** quote ids in one round-trip, merged and\n * sorted server-side by `timestamp`. Filters on the protocol-level `quoteId`\n * scalar via `quoteId_in` — the same batching `QuotesFundingDocument` uses — so\n * callers never need the diamond address.\n *\n * The field selection is deliberately identical to the single-quote document so\n * `toQuoteEventRow` decodes both without change.\n *\n * The document compiles to a typed query string via graphql-codegen.\n */\nexport const QuoteEventsForQuotesByTypeDocument = graphql(`\n  query QuoteEventsForQuotesByType(\n    $quoteIds: [BigInt!]!\n    $typeIn: [String!]!\n    $first: Int!\n    $skip: Int!\n    $orderDirection: OrderDirection!\n  ) {\n    quoteEvents(\n      first: $first\n      skip: $skip\n      orderBy: timestamp\n      orderDirection: $orderDirection\n      where: { quoteId_in: $quoteIds, type_in: $typeIn }\n    ) {\n      id\n      type\n      metadata\n      timestamp\n      blockNumber\n      transaction\n      quoteId\n    }\n  }\n`);\n"],"mappings":";;AAcA,IAAa,IAAqC,EAAQ,meAwBzD"}

package/dist/quotes/get-quotes-events-by-type/query.d.ts

@@ -0,0 +1,46 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetQuotesEventsByTypeParameters, GetQuotesEventsByTypeReturnType } from './get-quotes-events-by-type.js';
+/** Data resolved by the {@link getQuotesEventsByTypeQueryOptions} query. */
+export type GetQuotesEventsByTypeData = GetQuotesEventsByTypeReturnType;
+/**
+ * Build the TanStack Query key for {@link getQuotesEventsByTypeQueryOptions}.
+ *
+ * @param options - Query parameters (quote ids, types, paging, sort, chain id, config key).
+ * @returns A stable, hashable query key. The `bigint` quote ids are stringified so
+ *   the key is JSON-safe, and sorted so id order does not fragment the cache.
+ */
+export declare function getQuotesEventsByTypeQueryKey(options: Compute<GetQuotesEventsByTypeParameters & ConfigKeyParameter>): readonly ["getQuotesEventsByType", {
+    readonly quoteIds: string[];
+    readonly types: readonly import('../index.js').QuoteEventType[];
+}];
+/** Query-key type produced by {@link getQuotesEventsByTypeQueryKey}. */
+export type GetQuotesEventsByTypeQueryKey = ReturnType<typeof getQuotesEventsByTypeQueryKey>;
+/**
+ * Options accepted by {@link getQuotesEventsByTypeQueryOptions}: the action's
+ * parameters plus TanStack overrides.
+ */
+export type GetQuotesEventsByTypeOptions = Compute<GetQuotesEventsByTypeParameters & QueryParameter<GetQuotesEventsByTypeData, Error, GetQuotesEventsByTypeData, GetQuotesEventsByTypeQueryKey>>;
+/** TanStack Query options returned by {@link getQuotesEventsByTypeQueryOptions}. */
+export type GetQuotesEventsByTypeQueryOptions = SymmioQueryOptions<GetQuotesEventsByTypeData, Error, GetQuotesEventsByTypeData, GetQuotesEventsByTypeQueryKey>;
+/**
+ * Build TanStack Query options for {@link getQuotesEventsByType}. The query is
+ * disabled until at least one quote id **and** one event type are supplied.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(
+ *   getQuotesEventsByTypeQueryOptions(config, {
+ *     quoteIds: [7334n, 7335n],
+ *     types: FUNDING_HISTORY_EVENT_TYPES,
+ *   }),
+ * );
+ * ```
+ */
+export declare function getQuotesEventsByTypeQueryOptions(config: Config, options: GetQuotesEventsByTypeOptions): GetQuotesEventsByTypeQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/quotes/get-quotes-events-by-type/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-quotes-events-by-type/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACrC,MAAM,6BAA6B,CAAC;AAErC,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AAExE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,CAAC,+BAA+B,GAAG,kBAAkB,CAAC;;;GAMnH;AAED,wEAAwE;AACxE,MAAM,MAAM,6BAA6B,GAAG,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAE7F;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,+BAA+B,GAC7B,cAAc,CAAC,yBAAyB,EAAE,KAAK,EAAE,yBAAyB,EAAE,6BAA6B,CAAC,CAC7G,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,iCAAiC,GAAG,kBAAkB,CAChE,yBAAyB,EACzB,KAAK,EACL,yBAAyB,EACzB,6BAA6B,CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,4BAA4B,GACpC,iCAAiC,CAkBnC"}

package/dist/quotes/get-quotes-events-by-type/query.js

@@ -0,0 +1,33 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { toQuoteIdKeyPart as t } from "../quote-id-key-part.js";
+import { getQuotesEventsByType as n } from "./get-quotes-events-by-type.js";
+//#region src/quotes/get-quotes-events-by-type/query.ts
+function r(n) {
+	return ["getQuotesEventsByType", {
+		...e(n),
+		quoteIds: t(n.quoteIds),
+		types: [...n.types]
+	}];
+}
+function i(e, t) {
+	return {
+		...t.query,
+		queryKey: r({
+			...t,
+			configKey: e.getChainConfigKey(t.chainId)
+		}),
+		enabled: (t.query?.enabled ?? !0) && t.quoteIds.length > 0 && t.types.length > 0,
+		queryFn: () => n(e, {
+			chainId: t.chainId,
+			quoteIds: t.quoteIds,
+			types: t.types,
+			first: t.first,
+			skip: t.skip,
+			orderDirection: t.orderDirection
+		})
+	};
+}
+//#endregion
+export { r as getQuotesEventsByTypeQueryKey, i as getQuotesEventsByTypeQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/quotes/get-quotes-events-by-type/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/quotes/get-quotes-events-by-type/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport { toQuoteIdKeyPart } from \"../quote-id-key-part\";\nimport {\n  getQuotesEventsByType,\n  type GetQuotesEventsByTypeParameters,\n  type GetQuotesEventsByTypeReturnType,\n} from \"./get-quotes-events-by-type\";\n\n/** Data resolved by the {@link getQuotesEventsByTypeQueryOptions} query. */\nexport type GetQuotesEventsByTypeData = GetQuotesEventsByTypeReturnType;\n\n/**\n * Build the TanStack Query key for {@link getQuotesEventsByTypeQueryOptions}.\n *\n * @param options - Query parameters (quote ids, types, paging, sort, chain id, config key).\n * @returns A stable, hashable query key. The `bigint` quote ids are stringified so\n *   the key is JSON-safe, and sorted so id order does not fragment the cache.\n */\nexport function getQuotesEventsByTypeQueryKey(options: Compute<GetQuotesEventsByTypeParameters & ConfigKeyParameter>) {\n  const filtered = filterQueryOptions(options);\n  return [\n    \"getQuotesEventsByType\",\n    { ...filtered, quoteIds: toQuoteIdKeyPart(options.quoteIds), types: [...options.types] },\n  ] as const;\n}\n\n/** Query-key type produced by {@link getQuotesEventsByTypeQueryKey}. */\nexport type GetQuotesEventsByTypeQueryKey = ReturnType<typeof getQuotesEventsByTypeQueryKey>;\n\n/**\n * Options accepted by {@link getQuotesEventsByTypeQueryOptions}: the action's\n * parameters plus TanStack overrides.\n */\nexport type GetQuotesEventsByTypeOptions = Compute<\n  GetQuotesEventsByTypeParameters &\n    QueryParameter<GetQuotesEventsByTypeData, Error, GetQuotesEventsByTypeData, GetQuotesEventsByTypeQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getQuotesEventsByTypeQueryOptions}. */\nexport type GetQuotesEventsByTypeQueryOptions = SymmioQueryOptions<\n  GetQuotesEventsByTypeData,\n  Error,\n  GetQuotesEventsByTypeData,\n  GetQuotesEventsByTypeQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getQuotesEventsByType}. The query is\n * disabled until at least one quote id **and** one event type are supplied.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(\n *   getQuotesEventsByTypeQueryOptions(config, {\n *     quoteIds: [7334n, 7335n],\n *     types: FUNDING_HISTORY_EVENT_TYPES,\n *   }),\n * );\n * ```\n */\nexport function getQuotesEventsByTypeQueryOptions(\n  config: Config,\n  options: GetQuotesEventsByTypeOptions,\n): GetQuotesEventsByTypeQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getQuotesEventsByTypeQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: (options.query?.enabled ?? true) && options.quoteIds.length > 0 && options.types.length > 0,\n    queryFn: () =>\n      getQuotesEventsByType(config, {\n        chainId: options.chainId,\n        quoteIds: options.quoteIds,\n        types: options.types,\n        first: options.first,\n        skip: options.skip,\n        orderDirection: options.orderDirection,\n      }),\n  };\n}\n"],"mappings":";;;;AAqBA,SAAgB,EAA8B,GAAwE;CAEpH,OAAO,CACL,yBACA;EAAE,GAHa,EAAmB,CAG7B;EAAU,UAAU,EAAiB,EAAQ,QAAQ;EAAG,OAAO,CAAC,GAAG,EAAQ,KAAK;CAAE,CACzF;AACF;AAwCA,SAAgB,EACd,GACA,GACmC;CACnC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA8B;GACtC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,UAAU,EAAQ,OAAO,WAAW,OAAS,EAAQ,SAAS,SAAS,KAAK,EAAQ,MAAM,SAAS;EACnG,eACE,EAAsB,GAAQ;GAC5B,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,OAAO,EAAQ;GACf,OAAO,EAAQ;GACf,MAAM,EAAQ;GACd,gBAAgB,EAAQ;EAC1B,CAAC;CACL;AACF"}

package/dist/quotes/get-sub-account-quotes/get-sub-account-quotes.d.ts

@@ -1,11 +1,11 @@
 import { Address } from 'viem';
 import { Config } from '../../core/config/index.js';
-import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { Compute, ReadSolverParameter } from '../../shared/types/properties.js';
 import { UnifiedQuote } from '../unified-quote.js';
 /**
  * Parameters for {@link getSubAccountQuotes}.
  */
-export type GetSubAccountQuotesParameters = Compute<ChainIdParameter & {
+export type GetSubAccountQuotesParameters = Compute<ReadSolverParameter & {
     /** The subaccount whose full quote picture to assemble. */
     subAccount: Address;
     /**

package/dist/quotes/get-sub-account-quotes/get-sub-account-quotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-sub-account-quotes.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-sub-account-quotes/get-sub-account-quotes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAS/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,OAAO,CACjD,gBAAgB,GAAG;IACjB,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qFAAqF;IACrF,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,iFAAiF;IACjF,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,6BAA6B,CAAC,CA4CxC"}
+{"version":3,"file":"get-sub-account-quotes.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-sub-account-quotes/get-sub-account-quotes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AASlF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,OAAO,CACjD,mBAAmB,GAAG;IACpB,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qFAAqF;IACrF,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,iFAAiF;IACjF,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,6BAA6B,CAAC,CA4CxC"}

package/dist/quotes/get-sub-account-quotes/get-sub-account-quotes.js

@@ -7,21 +7,23 @@ import { reconcileQuotes as a } from "../reconcile-quotes.js";
 import { resolveQuoteAccounts as o } from "../resolve-quote-accounts.js";
 //#region src/quotes/get-sub-account-quotes/get-sub-account-quotes.ts
 async function s(s, c) {
-	let { chainId: l, subAccount: u, baseUrl: d, includeVirtualAccounts: f = !0, extraAccounts: p = [] } = c, [m, h] = await Promise.all([r(s, {
+	let { chainId: l, solverId: u, subAccount: d, baseUrl: f, includeVirtualAccounts: p = !0, extraAccounts: m = [] } = c, [h, g] = await Promise.all([r(s, {
 		chainId: l,
-		partyA: u,
-		baseUrl: d
+		solverId: u,
+		partyA: d,
+		baseUrl: f
 	}), i(s, {
 		chainId: l,
-		partyA: u,
-		baseUrl: d
-	})]), { accounts: g, instantOpenVaByTempId: _ } = await o(s, {
+		solverId: u,
+		partyA: d,
+		baseUrl: f
+	})]), { accounts: _, instantOpenVaByTempId: v } = await o(s, {
 		chainId: l,
-		subAccount: u,
-		instantOpens: m,
-		includeVirtualAccounts: f,
-		extraAccounts: p
-	}), v = await Promise.all(g.map(async (r) => {
+		subAccount: d,
+		instantOpens: h,
+		includeVirtualAccounts: p,
+		extraAccounts: m
+	}), y = await Promise.all(_.map(async (r) => {
 		let [i, a] = await Promise.all([e(s, {
 			chainId: l,
 			partyA: r
@@ -36,17 +38,17 @@ async function s(s, c) {
 				quoteId: e
 			})))).filter((e) => e !== null)
 		};
-	})), { quotes: y } = a({
-		partyA: u,
-		onchainPositions: v.flatMap((e) => e.openPositions),
-		onchainPendingQuotes: v.flatMap((e) => e.pendingQuotes),
-		instantOpens: m,
-		instantCloses: h,
-		instantOpenVaByTempId: _
+	})), { quotes: b } = a({
+		partyA: d,
+		onchainPositions: y.flatMap((e) => e.openPositions),
+		onchainPendingQuotes: y.flatMap((e) => e.pendingQuotes),
+		instantOpens: h,
+		instantCloses: g,
+		instantOpenVaByTempId: v
 	});
 	return {
-		quotes: y,
-		accounts: g
+		quotes: b,
+		accounts: _
 	};
 }
 //#endregion

package/dist/quotes/get-sub-account-quotes/get-sub-account-quotes.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-sub-account-quotes.js","names":[],"sources":["../../../src/quotes/get-sub-account-quotes/get-sub-account-quotes.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { getInstantCloses } from \"../../solvers/instant-close/get-instant-closes/get-instant-closes\";\nimport { getInstantOpens } from \"../../solvers/instant-open/get-instant-opens/get-instant-opens\";\nimport { getPartyAOpenPositions } from \"../../symmio-contracts/symmio/actions/get-party-a-open-positions\";\nimport { getPartyAPendingQuotes } from \"../../symmio-contracts/symmio/actions/get-party-a-pending-quotes\";\nimport { getQuote } from \"../../symmio-contracts/symmio/actions/get-quote\";\nimport type { Quote } from \"../../symmio-contracts/symmio/types\";\nimport { reconcileQuotes } from \"../reconcile-quotes\";\nimport { resolveQuoteAccounts } from \"../resolve-quote-accounts\";\nimport type { UnifiedQuote } from \"../unified-quote\";\n\n/**\n * Parameters for {@link getSubAccountQuotes}.\n */\nexport type GetSubAccountQuotesParameters = Compute<\n  ChainIdParameter & {\n    /** The subaccount whose full quote picture to assemble. */\n    subAccount: Address;\n    /**\n     * Union the subaccount's existing on-chain Virtual Accounts (VAs) into the\n     * read. In lowcap, each isolated position lives under a VA, so this is\n     * 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    /**\n     * Hedger base URL for the off-chain instant-open / instant-close reads.\n     * Defaults to the chain config's `solver.url`.\n     */\n    baseUrl?: string;\n  }\n>;\n\n/** Return type of {@link getSubAccountQuotes}. */\nexport interface GetSubAccountQuotesReturnType {\n  /** The merged, de-duplicated, lifecycle-tagged quote rows for the subaccount. */\n  quotes: UnifiedQuote[];\n  /** The on-chain `partyA` accounts the quotes were read across (subaccount + VAs + extras). */\n  accounts: Address[];\n}\n\n/**\n * Read a subaccount's full quote picture across every account that holds it.\n *\n * Lowcap positions are isolated into Virtual Accounts (VAs), so a subaccount's\n * quotes are spread across its VAs rather than the subaccount itself. This:\n *\n * 1. fetches the subaccount's pending instant-opens and instant-closes (off-chain,\n *    sub-account scoped);\n * 2. resolves the full account set — the subaccount, its existing VAs, and the\n *    predicted VAs of its pending instant-opens — via {@link resolveQuoteAccounts};\n * 3. reads `getPartyAOpenPositions` and `getPartyAPendingQuotes` (hydrated with\n *    `getQuote`) for every account in parallel;\n * 4. reconciles all sources into one stable, de-duplicated {@link UnifiedQuote}\n *    list with {@link reconcileQuotes} (\"active quotes only\" — a pure, stateless\n *    one-shot merge).\n *\n * This is a one-shot snapshot. For live updates, poll it (or drive\n * {@link reconcileQuotes} directly with notifications) from the framework layer.\n *\n * @param config - The SDK config.\n * @param parameters - Subaccount, optional VA inclusion / extras / hedger base url, optional chain id.\n * @returns The merged quote rows plus the accounts they were read across.\n * @throws {SymmError} when the chain is not supported, or {@link SymmApiError} when a hedger read fails.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const { quotes, accounts } = await getSubAccountQuotes(config, { subAccount: \"0xsub…\" });\n * ```\n */\nexport async function getSubAccountQuotes(\n  config: Config,\n  parameters: GetSubAccountQuotesParameters,\n): Promise<GetSubAccountQuotesReturnType> {\n  const { chainId, subAccount, baseUrl, includeVirtualAccounts = true, extraAccounts = [] } = parameters;\n\n  const [instantOpens, instantCloses] = await Promise.all([\n    getInstantOpens(config, { chainId, partyA: subAccount, baseUrl }),\n    getInstantCloses(config, { chainId, partyA: subAccount, baseUrl }),\n  ]);\n\n  // TODO: could we remove instantOpens from resolveQuoteAccounts? if we drop it it can get paraller with Promise.all\n  const { accounts, instantOpenVaByTempId } = await resolveQuoteAccounts(config, {\n    chainId,\n    subAccount,\n    instantOpens,\n    includeVirtualAccounts,\n    extraAccounts,\n  });\n\n  const perAccount = await Promise.all(\n    accounts.map(async (account) => {\n      const [openPositions, pendingIds] = await Promise.all([\n        getPartyAOpenPositions(config, { chainId, partyA: account }),\n        getPartyAPendingQuotes(config, { chainId, partyA: account }),\n      ]);\n      const pendingQuotes = await Promise.all(pendingIds.map((quoteId) => getQuote(config, { chainId, quoteId })));\n      return {\n        openPositions,\n        pendingQuotes: pendingQuotes.filter((quote): quote is Quote => quote !== null),\n      };\n    }),\n  );\n\n  const onchainPositions = perAccount.flatMap((account) => account.openPositions);\n  const onchainPendingQuotes = perAccount.flatMap((account) => account.pendingQuotes);\n\n  const { quotes } = reconcileQuotes({\n    partyA: subAccount,\n    onchainPositions,\n    onchainPendingQuotes,\n    instantOpens,\n    instantCloses,\n    instantOpenVaByTempId,\n  });\n\n  return { quotes, accounts };\n}\n"],"mappings":";;;;;;;;AA2EA,eAAsB,EACpB,GACA,GACwC;CACxC,IAAM,EAAE,YAAS,eAAY,YAAS,4BAAyB,IAAM,mBAAgB,CAAC,MAAM,GAEtF,CAAC,GAAc,KAAiB,MAAM,QAAQ,IAAI,CACtD,EAAgB,GAAQ;EAAE;EAAS,QAAQ;EAAY;CAAQ,CAAC,GAChE,EAAiB,GAAQ;EAAE;EAAS,QAAQ;EAAY;CAAQ,CAAC,CACnE,CAAC,GAGK,EAAE,aAAU,6BAA0B,MAAM,EAAqB,GAAQ;EAC7E;EACA;EACA;EACA;EACA;CACF,CAAC,GAEK,IAAa,MAAM,QAAQ,IAC/B,EAAS,IAAI,OAAO,MAAY;EAC9B,IAAM,CAAC,GAAe,KAAc,MAAM,QAAQ,IAAI,CACpD,EAAuB,GAAQ;GAAE;GAAS,QAAQ;EAAQ,CAAC,GAC3D,EAAuB,GAAQ;GAAE;GAAS,QAAQ;EAAQ,CAAC,CAC7D,CAAC;EAED,OAAO;GACL;GACA,gBAAe,MAHW,QAAQ,IAAI,EAAW,KAAK,MAAY,EAAS,GAAQ;IAAE;IAAS;GAAQ,CAAC,CAAC,CAAC,GAG5E,QAAQ,MAA0B,MAAU,IAAI;EAC/E;CACF,CAAC,CACH,GAKM,EAAE,cAAW,EAAgB;EACjC,QAAQ;EACR,kBALuB,EAAW,SAAS,MAAY,EAAQ,aAK/D;EACA,sBAL2B,EAAW,SAAS,MAAY,EAAQ,aAKnE;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO;EAAE;EAAQ;CAAS;AAC5B"}
+{"version":3,"file":"get-sub-account-quotes.js","names":[],"sources":["../../../src/quotes/get-sub-account-quotes/get-sub-account-quotes.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { Compute, ReadSolverParameter } from \"../../shared/types/properties\";\nimport { getInstantCloses } from \"../../solvers/instant-close/get-instant-closes/get-instant-closes\";\nimport { getInstantOpens } from \"../../solvers/instant-open/get-instant-opens/get-instant-opens\";\nimport { getPartyAOpenPositions } from \"../../symmio-contracts/symmio/actions/get-party-a-open-positions\";\nimport { getPartyAPendingQuotes } from \"../../symmio-contracts/symmio/actions/get-party-a-pending-quotes\";\nimport { getQuote } from \"../../symmio-contracts/symmio/actions/get-quote\";\nimport type { Quote } from \"../../symmio-contracts/symmio/types\";\nimport { reconcileQuotes } from \"../reconcile-quotes\";\nimport { resolveQuoteAccounts } from \"../resolve-quote-accounts\";\nimport type { UnifiedQuote } from \"../unified-quote\";\n\n/**\n * Parameters for {@link getSubAccountQuotes}.\n */\nexport type GetSubAccountQuotesParameters = Compute<\n  ReadSolverParameter & {\n    /** The subaccount whose full quote picture to assemble. */\n    subAccount: Address;\n    /**\n     * Union the subaccount's existing on-chain Virtual Accounts (VAs) into the\n     * read. In lowcap, each isolated position lives under a VA, so this is\n     * 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    /**\n     * Hedger base URL for the off-chain instant-open / instant-close reads.\n     * Defaults to the chain config's `solver.url`.\n     */\n    baseUrl?: string;\n  }\n>;\n\n/** Return type of {@link getSubAccountQuotes}. */\nexport interface GetSubAccountQuotesReturnType {\n  /** The merged, de-duplicated, lifecycle-tagged quote rows for the subaccount. */\n  quotes: UnifiedQuote[];\n  /** The on-chain `partyA` accounts the quotes were read across (subaccount + VAs + extras). */\n  accounts: Address[];\n}\n\n/**\n * Read a subaccount's full quote picture across every account that holds it.\n *\n * Lowcap positions are isolated into Virtual Accounts (VAs), so a subaccount's\n * quotes are spread across its VAs rather than the subaccount itself. This:\n *\n * 1. fetches the subaccount's pending instant-opens and instant-closes (off-chain,\n *    sub-account scoped);\n * 2. resolves the full account set — the subaccount, its existing VAs, and the\n *    predicted VAs of its pending instant-opens — via {@link resolveQuoteAccounts};\n * 3. reads `getPartyAOpenPositions` and `getPartyAPendingQuotes` (hydrated with\n *    `getQuote`) for every account in parallel;\n * 4. reconciles all sources into one stable, de-duplicated {@link UnifiedQuote}\n *    list with {@link reconcileQuotes} (\"active quotes only\" — a pure, stateless\n *    one-shot merge).\n *\n * This is a one-shot snapshot. For live updates, poll it (or drive\n * {@link reconcileQuotes} directly with notifications) from the framework layer.\n *\n * @param config - The SDK config.\n * @param parameters - Subaccount, optional VA inclusion / extras / hedger base url, optional chain id.\n * @returns The merged quote rows plus the accounts they were read across.\n * @throws {SymmError} when the chain is not supported, or {@link SymmApiError} when a hedger read fails.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const { quotes, accounts } = await getSubAccountQuotes(config, { subAccount: \"0xsub…\" });\n * ```\n */\nexport async function getSubAccountQuotes(\n  config: Config,\n  parameters: GetSubAccountQuotesParameters,\n): Promise<GetSubAccountQuotesReturnType> {\n  const { chainId, solverId, subAccount, baseUrl, includeVirtualAccounts = true, extraAccounts = [] } = parameters;\n\n  const [instantOpens, instantCloses] = await Promise.all([\n    getInstantOpens(config, { chainId, solverId, partyA: subAccount, baseUrl }),\n    getInstantCloses(config, { chainId, solverId, partyA: subAccount, baseUrl }),\n  ]);\n\n  // TODO: could we remove instantOpens from resolveQuoteAccounts? if we drop it it can get paraller with Promise.all\n  const { accounts, instantOpenVaByTempId } = await resolveQuoteAccounts(config, {\n    chainId,\n    subAccount,\n    instantOpens,\n    includeVirtualAccounts,\n    extraAccounts,\n  });\n\n  const perAccount = await Promise.all(\n    accounts.map(async (account) => {\n      const [openPositions, pendingIds] = await Promise.all([\n        getPartyAOpenPositions(config, { chainId, partyA: account }),\n        getPartyAPendingQuotes(config, { chainId, partyA: account }),\n      ]);\n      const pendingQuotes = await Promise.all(pendingIds.map((quoteId) => getQuote(config, { chainId, quoteId })));\n      return {\n        openPositions,\n        pendingQuotes: pendingQuotes.filter((quote): quote is Quote => quote !== null),\n      };\n    }),\n  );\n\n  const onchainPositions = perAccount.flatMap((account) => account.openPositions);\n  const onchainPendingQuotes = perAccount.flatMap((account) => account.pendingQuotes);\n\n  const { quotes } = reconcileQuotes({\n    partyA: subAccount,\n    onchainPositions,\n    onchainPendingQuotes,\n    instantOpens,\n    instantCloses,\n    instantOpenVaByTempId,\n  });\n\n  return { quotes, accounts };\n}\n"],"mappings":";;;;;;;;AA2EA,eAAsB,EACpB,GACA,GACwC;CACxC,IAAM,EAAE,YAAS,aAAU,eAAY,YAAS,4BAAyB,IAAM,mBAAgB,CAAC,MAAM,GAEhG,CAAC,GAAc,KAAiB,MAAM,QAAQ,IAAI,CACtD,EAAgB,GAAQ;EAAE;EAAS;EAAU,QAAQ;EAAY;CAAQ,CAAC,GAC1E,EAAiB,GAAQ;EAAE;EAAS;EAAU,QAAQ;EAAY;CAAQ,CAAC,CAC7E,CAAC,GAGK,EAAE,aAAU,6BAA0B,MAAM,EAAqB,GAAQ;EAC7E;EACA;EACA;EACA;EACA;CACF,CAAC,GAEK,IAAa,MAAM,QAAQ,IAC/B,EAAS,IAAI,OAAO,MAAY;EAC9B,IAAM,CAAC,GAAe,KAAc,MAAM,QAAQ,IAAI,CACpD,EAAuB,GAAQ;GAAE;GAAS,QAAQ;EAAQ,CAAC,GAC3D,EAAuB,GAAQ;GAAE;GAAS,QAAQ;EAAQ,CAAC,CAC7D,CAAC;EAED,OAAO;GACL;GACA,gBAAe,MAHW,QAAQ,IAAI,EAAW,KAAK,MAAY,EAAS,GAAQ;IAAE;IAAS;GAAQ,CAAC,CAAC,CAAC,GAG5E,QAAQ,MAA0B,MAAU,IAAI;EAC/E;CACF,CAAC,CACH,GAKM,EAAE,cAAW,EAAgB;EACjC,QAAQ;EACR,kBALuB,EAAW,SAAS,MAAY,EAAQ,aAK/D;EACA,sBAL2B,EAAW,SAAS,MAAY,EAAQ,aAKnE;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO;EAAE;EAAQ;CAAS;AAC5B"}

package/dist/quotes/get-sub-account-quotes/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-sub-account-quotes/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAElC,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,CAAC,6BAA6B,GAAG,kBAAkB,CAAC,6DAE/G;AAED,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,6BAA6B,GAC3B,cAAc,CAAC,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,2BAA2B,CAAC,CACvG,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,+BAA+B,GAAG,kBAAkB,CAC9D,uBAAuB,EACvB,KAAK,EACL,uBAAuB,EACvB,2BAA2B,CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,0BAA0B,GAClC,+BAA+B,CAiBjC"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-sub-account-quotes/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAElC,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,CAAC,6BAA6B,GAAG,kBAAkB,CAAC,6DAE/G;AAED,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,6BAA6B,GAC3B,cAAc,CAAC,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,2BAA2B,CAAC,CACvG,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,+BAA+B,GAAG,kBAAkB,CAC9D,uBAAuB,EACvB,KAAK,EACL,uBAAuB,EACvB,2BAA2B,CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,0BAA0B,GAClC,+BAA+B,CAkBjC"}

package/dist/quotes/get-sub-account-quotes/query.js

@@ -14,6 +14,7 @@ function r(e, r) {
 		enabled: r.query?.enabled ?? !0,
 		queryFn: () => t(e, {
 			chainId: r.chainId,
+			solverId: r.solverId,
 			subAccount: r.subAccount,
 			includeVirtualAccounts: r.includeVirtualAccounts,
 			extraAccounts: r.extraAccounts,

package/dist/quotes/get-sub-account-quotes/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","names":[],"sources":["../../../src/quotes/get-sub-account-quotes/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  getSubAccountQuotes,\n  type GetSubAccountQuotesParameters,\n  type GetSubAccountQuotesReturnType,\n} from \"./get-sub-account-quotes\";\n\n/** Data resolved by the {@link getSubAccountQuotesQueryOptions} query. */\nexport type GetSubAccountQuotesData = GetSubAccountQuotesReturnType;\n\n/**\n * Build the TanStack Query key for {@link getSubAccountQuotesQueryOptions}.\n *\n * @param options - Query parameters (chain id, subAccount, VA inclusion, extras, base url, config key).\n * @returns A stable, hashable query key.\n */\nexport function getSubAccountQuotesQueryKey(options: Compute<GetSubAccountQuotesParameters & ConfigKeyParameter>) {\n  return [\"getSubAccountQuotes\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getSubAccountQuotesQueryKey}. */\nexport type GetSubAccountQuotesQueryKey = ReturnType<typeof getSubAccountQuotesQueryKey>;\n\n/**\n * Options accepted by {@link getSubAccountQuotesQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetSubAccountQuotesOptions = Compute<\n  GetSubAccountQuotesParameters &\n    QueryParameter<GetSubAccountQuotesData, Error, GetSubAccountQuotesData, GetSubAccountQuotesQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getSubAccountQuotesQueryOptions}. */\nexport type GetSubAccountQuotesQueryOptions = SymmioQueryOptions<\n  GetSubAccountQuotesData,\n  Error,\n  GetSubAccountQuotesData,\n  GetSubAccountQuotesQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getSubAccountQuotes}. Pass\n * `query.refetchInterval` to poll; disable from the consumer via `query.enabled`\n * (e.g. until a valid `subAccount` is entered).\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(\n *   getSubAccountQuotesQueryOptions(config, {\n *     subAccount: \"0xsub…\",\n *     query: { refetchInterval: 5_000 },\n *   }),\n * );\n * ```\n */\nexport function getSubAccountQuotesQueryOptions(\n  config: Config,\n  options: GetSubAccountQuotesOptions,\n): GetSubAccountQuotesQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getSubAccountQuotesQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getSubAccountQuotes(config, {\n        chainId: options.chainId,\n        subAccount: options.subAccount,\n        includeVirtualAccounts: options.includeVirtualAccounts,\n        extraAccounts: options.extraAccounts,\n        baseUrl: options.baseUrl,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA4B,GAAsE;CAChH,OAAO,CAAC,uBAAuB,EAAmB,CAAO,CAAC;AAC5D;AAyCA,SAAgB,EACd,GACA,GACiC;CACjC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA4B;GACpC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAoB,GAAQ;GAC1B,SAAS,EAAQ;GACjB,YAAY,EAAQ;GACpB,wBAAwB,EAAQ;GAChC,eAAe,EAAQ;GACvB,SAAS,EAAQ;EACnB,CAAC;CACL;AACF"}
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/quotes/get-sub-account-quotes/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  getSubAccountQuotes,\n  type GetSubAccountQuotesParameters,\n  type GetSubAccountQuotesReturnType,\n} from \"./get-sub-account-quotes\";\n\n/** Data resolved by the {@link getSubAccountQuotesQueryOptions} query. */\nexport type GetSubAccountQuotesData = GetSubAccountQuotesReturnType;\n\n/**\n * Build the TanStack Query key for {@link getSubAccountQuotesQueryOptions}.\n *\n * @param options - Query parameters (chain id, subAccount, VA inclusion, extras, base url, config key).\n * @returns A stable, hashable query key.\n */\nexport function getSubAccountQuotesQueryKey(options: Compute<GetSubAccountQuotesParameters & ConfigKeyParameter>) {\n  return [\"getSubAccountQuotes\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getSubAccountQuotesQueryKey}. */\nexport type GetSubAccountQuotesQueryKey = ReturnType<typeof getSubAccountQuotesQueryKey>;\n\n/**\n * Options accepted by {@link getSubAccountQuotesQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetSubAccountQuotesOptions = Compute<\n  GetSubAccountQuotesParameters &\n    QueryParameter<GetSubAccountQuotesData, Error, GetSubAccountQuotesData, GetSubAccountQuotesQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getSubAccountQuotesQueryOptions}. */\nexport type GetSubAccountQuotesQueryOptions = SymmioQueryOptions<\n  GetSubAccountQuotesData,\n  Error,\n  GetSubAccountQuotesData,\n  GetSubAccountQuotesQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getSubAccountQuotes}. Pass\n * `query.refetchInterval` to poll; disable from the consumer via `query.enabled`\n * (e.g. until a valid `subAccount` is entered).\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(\n *   getSubAccountQuotesQueryOptions(config, {\n *     subAccount: \"0xsub…\",\n *     query: { refetchInterval: 5_000 },\n *   }),\n * );\n * ```\n */\nexport function getSubAccountQuotesQueryOptions(\n  config: Config,\n  options: GetSubAccountQuotesOptions,\n): GetSubAccountQuotesQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getSubAccountQuotesQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getSubAccountQuotes(config, {\n        chainId: options.chainId,\n        solverId: options.solverId,\n        subAccount: options.subAccount,\n        includeVirtualAccounts: options.includeVirtualAccounts,\n        extraAccounts: options.extraAccounts,\n        baseUrl: options.baseUrl,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA4B,GAAsE;CAChH,OAAO,CAAC,uBAAuB,EAAmB,CAAO,CAAC;AAC5D;AAyCA,SAAgB,EACd,GACA,GACiC;CACjC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA4B;GACpC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAoB,GAAQ;GAC1B,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,YAAY,EAAQ;GACpB,wBAAwB,EAAQ;GAChC,eAAe,EAAQ;GACvB,SAAS,EAAQ;EACnB,CAAC;CACL;AACF"}

package/dist/quotes/grouping/aggregate-group-funding.d.ts

@@ -0,0 +1,109 @@
+import { QuoteFundingData } from '../get-quote-funding/types.js';
+import { UnifiedQuote } from '../unified-quote.js';
+/**
+ * Aggregated funding for one group of quotes, folded from the per-quote
+ * {@link QuoteFundingData} rows the analytics subgraph returned for its children.
+ *
+ * Every amount is 18-decimal wei `bigint`, matching {@link UnifiedQuote}.
+ *
+ * **Sign convention** — `netReceived = received − paid`, the P&L perspective. A
+ * **positive** `netReceived` means the group has **earned** funding; a negative
+ * one means it has **paid** for it. This matches
+ * {@link QuoteFundingData.netReceived} and {@link QuoteGroupUpnl.upnl}, so a
+ * "green = income" UI renders it directly. It is the inverse of the on-chain
+ * `int256`, which is cost-positive.
+ *
+ * **Settled-to-date only** — these totals cover funding the protocol has already
+ * charged and the analytics subgraph has indexed. Funding accrued since the last
+ * charge is **not** included: it is not indexed anywhere, so it cannot be part of
+ * this sum.
+ *
+ * **Completeness** — `netReceived` is always the sum over the children that *did*
+ * resolve, i.e. a lower bound while rows are still missing; it is never
+ * suppressed. Read {@link isComplete} to decide whether to trust it, and treat
+ * `isComplete: false` as "funding unknown", not as "no funding".
+ */
+export interface QuoteGroupFunding {
+    /** Σ funding partyA paid across the group's resolved children (wei). */
+    paid: bigint;
+    /** Σ funding partyA received across the group's resolved children (wei). */
+    received: bigint;
+    /**
+     * Σ `received − paid` across the group's resolved children (wei). **Positive =
+     * the group earned funding**; negative = it paid for it. A lower bound while
+     * {@link isComplete} is `false`.
+     */
+    netReceived: bigint;
+    /** Number of distinct child quote ids that produced a funding row. */
+    resolvedCount: number;
+    /**
+     * Number of distinct on-chain quote ids among the children — the rows this
+     * group expects. Optimistic children (no `quoteId` yet) are not counted.
+     */
+    expectedCount: number;
+    /**
+     * Expected quote ids with no funding row yet (subgraph indexing lag), in the
+     * order the ids first appear in the group's children.
+     */
+    missingQuoteIds: bigint[];
+    /**
+     * `true` only when the group has at least one on-chain child **and** every one
+     * of them resolved — i.e. the amounts above are the group's complete
+     * settled-to-date funding.
+     *
+     * An all-optimistic group (or an empty one) has nothing to resolve and reports
+     * `false` with `net: 0n`, so a consumer can tell "funding unknown" apart from
+     * "no funding".
+     */
+    isComplete: boolean;
+}
+/**
+ * Fold the per-quote funding rows of a group's children into a single
+ * {@link QuoteGroupFunding}.
+ *
+ * Behaviour:
+ *
+ * - **De-duplicated by `quoteId`.** The fold runs over the *distinct* on-chain
+ *   ids among `quotes`, so a quote listed twice contributes its funding once.
+ *   Duplicate rows for the same id in `rows` are likewise counted once.
+ * - **Optimistic children are skipped.** A child with no `quoteId` has nothing to
+ *   look up, so it neither inflates `expectedCount` nor lands in
+ *   `missingQuoteIds`.
+ * - **Extra rows are ignored.** A row whose `quoteId` is not among the children
+ *   is never summed — passing a shared, over-fetched row set is safe.
+ * - **`netReceived` is never suppressed.** It is the sum over whatever resolved:
+ *   a lower bound while `isComplete` is `false`.
+ * - **`isComplete` is `expectedCount > 0 && missingQuoteIds.length === 0`.** An
+ *   all-optimistic or empty group therefore reports `isComplete: false` with
+ *   zero amounts — "funding unknown", not "no funding".
+ *
+ * Sign convention: `netReceived = received − paid`, so **positive means the group
+ * earned funding** (see {@link QuoteGroupFunding}). The totals are funding
+ * **settled to date**; funding accrued since the last charge is not indexed and
+ * not included.
+ *
+ * Do **not** substitute `Σ UnifiedQuote.accumulatedPaidFunding` as a shortcut.
+ * That field is the quote's cumulative funding *rate index* on-chain
+ * (`accumulatedRate × epochsSinceStart`), not a settled amount — summing it
+ * across quotes is dimensionally meaningless, and it is cost-positive where
+ * `netReceived` is income-positive.
+ *
+ * Pure, order-independent, no IO. Empty input yields all-zero amounts with
+ * `isComplete: false`.
+ *
+ * @param quotes - The group's child quotes (optimistic children allowed).
+ * @param rows - Funding rows fetched for those quotes; extras and duplicates are tolerated.
+ * @returns The aggregated funding for the group.
+ *
+ * @example
+ * ```ts
+ * const funding = aggregateGroupFunding(group.quotes, rows);
+ * if (!funding.isComplete) {
+ *   // still indexing — show a loading state rather than "0 funding"
+ * } else if (funding.netReceived > 0n) {
+ *   // the group has earned funding
+ * }
+ * ```
+ */
+export declare function aggregateGroupFunding(quotes: readonly UnifiedQuote[], rows: readonly QuoteFundingData[]): QuoteGroupFunding;
+//# sourceMappingURL=aggregate-group-funding.d.ts.map

package/dist/quotes/grouping/aggregate-group-funding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-group-funding.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/aggregate-group-funding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;;;OAQG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAChC,iBAAiB,CA6CnB"}

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

@@ -0,0 +1,29 @@
+//#region src/quotes/grouping/aggregate-group-funding.ts
+function e(e, t) {
+	let n = [], r = /* @__PURE__ */ new Set();
+	for (let t of e) t.quoteId !== void 0 && (r.has(t.quoteId) || (r.add(t.quoteId), n.push(t.quoteId)));
+	let i = /* @__PURE__ */ new Map();
+	for (let e of t) i.has(e.quoteId) || i.set(e.quoteId, e);
+	let a = 0n, o = 0n, s = 0, c = [];
+	for (let e of n) {
+		let t = i.get(e);
+		if (t === void 0) {
+			c.push(e);
+			continue;
+		}
+		a += t.paid, o += t.received, s += 1;
+	}
+	return {
+		paid: a,
+		received: o,
+		netReceived: o - a,
+		resolvedCount: s,
+		expectedCount: n.length,
+		missingQuoteIds: c,
+		isComplete: n.length > 0 && c.length === 0
+	};
+}
+//#endregion
+export { e as aggregateGroupFunding };
+
+//# sourceMappingURL=aggregate-group-funding.js.map

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

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

package/dist/quotes/grouping/aggregate-group-upnl.d.ts

@@ -0,0 +1,143 @@
+import { UnifiedQuote } from '../unified-quote.js';
+/**
+ * Aggregated unrealized PnL for one group of quotes, valued at a single mark
+ * price. Every amount is 18-decimal wei `bigint`.
+ *
+ * **Sign convention** — plain trader convention: a **positive** `upnl` means the
+ * group is in profit. This is the same polarity as
+ * {@link QuoteGroupFunding.netReceived}, so the two folds — which sit beside each
+ * other — can be read, coloured, and added together without either being negated.
+ *
+ * **Completeness** — `upnl` is always the sum over the children that *could* be
+ * valued, i.e. a lower bound in magnitude while some could not; it is never
+ * suppressed to `0n`. Read {@link isComplete} to decide whether to trust it, and
+ * treat `isComplete: false` as "PnL unknown", not as "no PnL". The same holds
+ * for both percentages: they describe the valued subset only.
+ *
+ * **One market, one mark price.** Every built-in `QuoteGroupingStrategy` keys on
+ * `symbolId`, so a group is single-market by construction. A custom `keyOf` that
+ * mixes markets makes this fold meaningless — that is the caller's to avoid.
+ */
+export interface QuoteGroupUpnl {
+    /**
+     * Σ signed unrealized PnL across the group's valued children (wei).
+     * **Positive = the group is in profit.** A lower bound while
+     * {@link isComplete} is `false`.
+     */
+    upnl: bigint;
+    /**
+     * Σ `openQuantity × openedPrice` across the valued children (wei) — the
+     * at-entry position value {@link returnPercent} divides by. `0n` when nothing
+     * was valued.
+     */
+    openNotional: bigint;
+    /**
+     * Σ locked margin backing the still-open size of the valued children (wei) —
+     * the capital at risk {@link upnlPercent} divides by. Each child contributes
+     * every leg of its frozen `initialLockedValues` (else `lockedValues`) prorated
+     * by `openQuantity / quantity`. `0n` when nothing was valued, or when no valued
+     * child has locked collateral on record.
+     */
+    openMargin: bigint;
+    /**
+     * Unleveraged return — `upnl / openNotional × 100` as an 18-decimal
+     * fixed-point percent (`12.5% → 12_500000000000000000n`), signed with `upnl`.
+     * The return on the *position's* value, i.e. how far the market moved in the
+     * group's favour. Same convention as `GroupTpSlReturnEstimate.returnPercent`.
+     *
+     * `undefined` — never `0n` — when nothing was valued: `0n` is a real 0% return.
+     */
+    returnPercent?: bigint;
+    /**
+     * Leveraged return on capital — `upnl / openMargin × 100`, same fixed-point
+     * convention and sign. The group counterpart of `calculateQuoteUpnl`'s
+     * `upnlPercent`, and the figure to show beside the uPnL amount.
+     *
+     * Equals `returnPercent × leverage` whenever the group's children share one
+     * leverage; where they differ it stays the group's true return on deployed
+     * margin rather than a mean of per-child ratios.
+     *
+     * `undefined` when {@link openMargin} is `0n` — a group whose valued children
+     * carry no locked collateral has no capital base to return *on*.
+     */
+    upnlPercent?: bigint;
+    /** Number of children with open size that were valued against the mark price. */
+    valuedCount: number;
+    /**
+     * Number of children with open size whose open price is not settled yet, so
+     * their PnL is unknown. Resting orders and fully-closed children are not
+     * counted here — they have no unrealized PnL to be missing.
+     */
+    unvaluedCount: number;
+    /**
+     * `true` only when a mark price was given, at least one child was valued, and
+     * none was left unvalued — i.e. `upnl` is the group's complete unrealized PnL.
+     *
+     * A group with nothing to value (all-pending, all-closed, or empty) reports
+     * `false` with `upnl: 0n`, so a consumer can tell "PnL unknown" apart from
+     * "no PnL".
+     */
+    isComplete: boolean;
+}
+/**
+ * Fold a group's child quotes into a single unrealized-PnL total at the current
+ * mark price.
+ *
+ * Per child that is an active position with open size, using its **settled**
+ * `openedPrice`:
+ *
+ * ```
+ * delta  = markPrice − openedPrice
+ * signed = positionType === SHORT ? −delta : delta
+ * upnl  += openQuantity × signed / 1e18
+ * ```
+ *
+ * and, over the same valued children, the two denominators a percentage needs:
+ *
+ * ```
+ * openNotional += openQuantity × openedPrice / 1e18
+ * openMargin   += lockedLegs × openQuantity / quantity
+ * returnPercent = upnl / openNotional × 100     // unleveraged
+ * upnlPercent   = upnl / openMargin   × 100     // return on capital
+ * ```
+ *
+ * Behaviour:
+ *
+ * - **Resting orders contribute nothing and are not counted as unvalued.** A
+ *   pending order has no unrealized PnL by definition; counting it would pin
+ *   `isComplete` to `false` for any group holding one. Same for terminal rows.
+ * - **Fully-closed children** (`openQuantity ≤ 0`) are skipped and not counted —
+ *   their PnL is realized, not unrealized.
+ * - **A position with no settled `openedPrice`** (an optimistic or just-anchored
+ *   open) lands in `unvaluedCount` and contributes nothing.
+ * - **No mark price** (`undefined`) yields zero amounts with `isComplete: false`.
+ *   `markPrice: 0n` is a *real* price (a total loss on a long) — that is why the
+ *   parameter is `bigint | undefined` and never a string parsed in here. Use
+ *   {@link decimalPriceToWei}, which returns `undefined` rather than a fabricated
+ *   `0n`, to convert a price feed's decimal string.
+ * - **Both percentages are folded, not averaged.** `upnlPercent` divides the
+ *   group's total uPnL by its total open margin, which is the group's actual
+ *   return on deployed capital — deliberately not a notional-weighted mean of the
+ *   children's individual percentages. The two coincide at a shared leverage; where
+ *   leverages differ, a mean of ratios is not a return anyone earned. This also
+ *   keeps the fold consistent with `aggregateGroupMetrics`, whose `leverage` is
+ *   likewise `Σ notional / Σ margin`, so `upnlPercent ≈ returnPercent × leverage`.
+ * - Exact `bigint`, order-independent, no IO. This deliberately differs from the
+ *   per-quote `calculateQuoteUpnl`, which is decimal-string/float based. Each
+ *   child's term is floored independently (max 1 wei of error per child), matching
+ *   `estimateGroupTpSlReturn` and `calculateLiquidationPrice`.
+ *
+ * @param quotes - The group's child quotes (pass `group.quotes`).
+ * @param markPrice - Current mark price in 18-decimal wei, or `undefined` before the first tick.
+ * @returns The aggregated unrealized PnL for the group.
+ *
+ * @example
+ * ```ts
+ * const upnl = aggregateGroupUpnl(group.quotes, decimalPriceToWei(markPrice));
+ * if (!upnl.isComplete) showSkeleton();
+ * // positive = in profit; the percent is 18-decimal fixed point, so format it as wei
+ * else render(upnl.upnl, upnl.upnlPercent);
+ * ```
+ */
+export declare function aggregateGroupUpnl(quotes: readonly UnifiedQuote[], markPrice?: bigint): QuoteGroupUpnl;
+//# sourceMappingURL=aggregate-group-upnl.d.ts.map

package/dist/quotes/grouping/aggregate-group-upnl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-group-upnl.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/aggregate-group-upnl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqBrD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAqCtG"}