@symmio/trading-core 0.1.0

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

@@ -0,0 +1,64 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { UnifiedQuote } from '../unified-quote';
+/**
+ * Parameters for {@link getSubAccountQuotes}.
+ */
+export type GetSubAccountQuotesParameters = Compute<ChainIdParameter & {
+    /** The subaccount whose full quote picture to assemble. */
+    subAccount: Address;
+    /**
+     * Union the subaccount's existing on-chain Virtual Accounts (VAs) into the
+     * read. In lowcap, each isolated position lives under a VA, so this is
+     * required to see the full picture.
+     * @default true
+     */
+    includeVirtualAccounts?: boolean;
+    /** Extra accounts to read quotes across (e.g. VAs already known to the consumer). */
+    extraAccounts?: readonly Address[];
+    /**
+     * Hedger base URL for the off-chain instant-open / instant-close reads.
+     * Defaults to the chain config's `solver.url`.
+     */
+    baseUrl?: string;
+}>;
+/** Return type of {@link getSubAccountQuotes}. */
+export interface GetSubAccountQuotesReturnType {
+    /** The merged, de-duplicated, lifecycle-tagged quote rows for the subaccount. */
+    quotes: UnifiedQuote[];
+    /** The on-chain `partyA` accounts the quotes were read across (subaccount + VAs + extras). */
+    accounts: Address[];
+}
+/**
+ * Read a subaccount's full quote picture across every account that holds it.
+ *
+ * Lowcap positions are isolated into Virtual Accounts (VAs), so a subaccount's
+ * quotes are spread across its VAs rather than the subaccount itself. This:
+ *
+ * 1. fetches the subaccount's pending instant-opens and instant-closes (off-chain,
+ *    sub-account scoped);
+ * 2. resolves the full account set — the subaccount, its existing VAs, and the
+ *    predicted VAs of its pending instant-opens — via {@link resolveQuoteAccounts};
+ * 3. reads `getPartyAOpenPositions` and `getPartyAPendingQuotes` (hydrated with
+ *    `getQuote`) for every account in parallel;
+ * 4. reconciles all sources into one stable, de-duplicated {@link UnifiedQuote}
+ *    list with {@link reconcileQuotes} ("active quotes only" — a pure, stateless
+ *    one-shot merge).
+ *
+ * This is a one-shot snapshot. For live updates, poll it (or drive
+ * {@link reconcileQuotes} directly with notifications) from the framework layer.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Subaccount, optional VA inclusion / extras / hedger base url, optional chain id.
+ * @returns The merged quote rows plus the accounts they were read across.
+ * @throws {SymmError} when the chain is not supported, or {@link SymmApiError} when a hedger read fails.
+ * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.
+ *
+ * @example
+ * ```ts
+ * const { quotes, accounts } = await getSubAccountQuotes(config, { subAccount: "0xsub…" });
+ * ```
+ */
+export declare function getSubAccountQuotes(config: Config, parameters: GetSubAccountQuotesParameters): Promise<GetSubAccountQuotesReturnType>;
+//# sourceMappingURL=get-sub-account-quotes.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,55 @@
+import { getPartyAOpenPositions as e } from "../../symmio-contracts/symmio/actions/get-party-a-open-positions.js";
+import { getPartyAPendingQuotes as t } from "../../symmio-contracts/symmio/actions/get-party-a-pending-quotes.js";
+import { getQuote as n } from "../../symmio-contracts/symmio/actions/get-quote.js";
+import { getInstantOpens as r } from "../../solvers/instant-open/get-instant-opens/get-instant-opens.js";
+import { getInstantCloses as i } from "../../solvers/instant-close/get-instant-closes/get-instant-closes.js";
+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, {
+		chainId: l,
+		partyA: u,
+		baseUrl: d
+	}), i(s, {
+		chainId: l,
+		partyA: u,
+		baseUrl: d
+	})]), { accounts: g, instantOpenVaByTempId: _ } = await o(s, {
+		chainId: l,
+		subAccount: u,
+		instantOpens: m,
+		includeVirtualAccounts: f,
+		extraAccounts: p
+	}), v = await Promise.all(g.map(async (r) => {
+		let [i, a] = await Promise.all([e(s, {
+			chainId: l,
+			partyA: r
+		}), t(s, {
+			chainId: l,
+			partyA: r
+		})]);
+		return {
+			openPositions: i,
+			pendingQuotes: (await Promise.all(a.map((e) => n(s, {
+				chainId: l,
+				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: _
+	});
+	return {
+		quotes: y,
+		accounts: g
+	};
+}
+//#endregion
+export { s as getSubAccountQuotes };
+
+//# sourceMappingURL=get-sub-account-quotes.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+export * from './get-sub-account-quotes';
+export * from './query';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/quotes/get-sub-account-quotes/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,43 @@
+import { Config } from '../../core/config';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query';
+import { GetSubAccountQuotesParameters, GetSubAccountQuotesReturnType } from './get-sub-account-quotes';
+/** Data resolved by the {@link getSubAccountQuotesQueryOptions} query. */
+export type GetSubAccountQuotesData = GetSubAccountQuotesReturnType;
+/**
+ * Build the TanStack Query key for {@link getSubAccountQuotesQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, subAccount, VA inclusion, extras, base url, config key).
+ * @returns A stable, hashable query key.
+ */
+export declare function getSubAccountQuotesQueryKey(options: Compute<GetSubAccountQuotesParameters & ConfigKeyParameter>): readonly ["getSubAccountQuotes", Record<string, unknown>];
+/** Query-key type produced by {@link getSubAccountQuotesQueryKey}. */
+export type GetSubAccountQuotesQueryKey = ReturnType<typeof getSubAccountQuotesQueryKey>;
+/**
+ * Options accepted by {@link getSubAccountQuotesQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetSubAccountQuotesOptions = Compute<GetSubAccountQuotesParameters & QueryParameter<GetSubAccountQuotesData, Error, GetSubAccountQuotesData, GetSubAccountQuotesQueryKey>>;
+/** TanStack Query options returned by {@link getSubAccountQuotesQueryOptions}. */
+export type GetSubAccountQuotesQueryOptions = SymmioQueryOptions<GetSubAccountQuotesData, Error, GetSubAccountQuotesData, GetSubAccountQuotesQueryKey>;
+/**
+ * Build TanStack Query options for {@link getSubAccountQuotes}. Pass
+ * `query.refetchInterval` to poll; disable from the consumer via `query.enabled`
+ * (e.g. until a valid `subAccount` is entered).
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(
+ *   getSubAccountQuotesQueryOptions(config, {
+ *     subAccount: "0xsub…",
+ *     query: { refetchInterval: 5_000 },
+ *   }),
+ * );
+ * ```
+ */
+export declare function getSubAccountQuotesQueryOptions(config: Config, options: GetSubAccountQuotesOptions): GetSubAccountQuotesQueryOptions;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,27 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getSubAccountQuotes as t } from "./get-sub-account-quotes.js";
+//#region src/quotes/get-sub-account-quotes/query.ts
+function n(t) {
+	return ["getSubAccountQuotes", e(t)];
+}
+function r(e, r) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: r.query?.enabled ?? !0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			subAccount: r.subAccount,
+			includeVirtualAccounts: r.includeVirtualAccounts,
+			extraAccounts: r.extraAccounts,
+			baseUrl: r.baseUrl
+		})
+	};
+}
+//#endregion
+export { n as getSubAccountQuotesQueryKey, r as getSubAccountQuotesQueryOptions };
+
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +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"}

package/dist/quotes/grouping/aggregate-metrics.d.ts

@@ -0,0 +1,22 @@
+import { UnifiedQuote } from '../unified-quote';
+import { QuoteGroupMetrics } from './quote-group';
+/**
+ * Compute the pure, price-independent {@link QuoteGroupMetrics} for a set of
+ * child quotes.
+ *
+ * - `openQuantity` / `quantity` are plain sums (wei).
+ * - `notional = Σ(openQuantity × openPrice)`, rescaled to wei.
+ * - `weightedOpenPrice = notionalₙᵤₘ / Σ openQuantity`, suppressed (`undefined`)
+ *   when there is no open size or any child has an unsettled open price.
+ * - `lockedValues` sums each margin leg.
+ * - `leverage = notional / (Σ cva + lf + partyAmm)`, as an 18-decimal fixed-point
+ *   `bigint`, `undefined` when that margin is `0`.
+ *
+ * Pure and order-independent. Empty input yields all-zero amounts with the
+ * optional fields `undefined`.
+ *
+ * @param quotes - The group's child quotes.
+ * @returns The aggregated metrics.
+ */
+export declare function aggregateGroupMetrics(quotes: readonly UnifiedQuote[]): QuoteGroupMetrics;
+//# sourceMappingURL=aggregate-metrics.d.ts.map

package/dist/quotes/grouping/aggregate-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-metrics.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/aggregate-metrics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAYvD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,iBAAiB,CA4CxF"}

package/dist/quotes/grouping/aggregate-metrics.js

@@ -0,0 +1,34 @@
+import { WEI as e } from "../../shared/utils/wei.js";
+import { isActivePosition as t, isPendingOrder as n } from "./partition-quotes.js";
+//#region src/quotes/grouping/aggregate-metrics.ts
+function r(e) {
+	return e.openedPrice !== void 0 && e.openedPrice !== 0n ? e.openedPrice : e.requestedOpenPrice;
+}
+function i(e) {
+	return e.openedPrice === void 0 || e.openedPrice === 0n;
+}
+function a(a) {
+	let o = 0n, s = 0n, c = 0n, l = 0n, u = 0n, d = 0n, f = 0n, p = 0, m = 0, h = !1;
+	for (let e of a) o += e.quantity, s += e.openQuantity, c += e.openQuantity * r(e), l += e.lockedValues.cva, u += e.lockedValues.lf, d += e.lockedValues.partyAmm, f += e.lockedValues.partyBmm, i(e) && (h = !0), n(e) ? m += 1 : t(e) && (p += 1);
+	let g = {
+		cva: l,
+		lf: u,
+		partyAmm: d,
+		partyBmm: f
+	}, _ = c / e, v = l + u + d, y = s > 0n && !h ? c / s : void 0, b = v > 0n ? _ * e / v : void 0;
+	return {
+		quoteCount: a.length,
+		openCount: p,
+		pendingCount: m,
+		quantity: o,
+		openQuantity: s,
+		weightedOpenPrice: y,
+		notional: _,
+		lockedValues: g,
+		leverage: b
+	};
+}
+//#endregion
+export { a as aggregateGroupMetrics };
+
+//# sourceMappingURL=aggregate-metrics.js.map

package/dist/quotes/grouping/aggregate-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-metrics.js","names":[],"sources":["../../../src/quotes/grouping/aggregate-metrics.ts"],"sourcesContent":["import { WEI } from \"../../shared/utils/wei\";\nimport type { LockedValues } from \"../../symmio-contracts/symmio/types\";\nimport type { UnifiedQuote } from \"../unified-quote\";\nimport { isActivePosition, isPendingOrder } from \"./partition-quotes\";\nimport type { QuoteGroupMetrics } from \"./quote-group\";\n\n/** A quote's open price for valuation: the settled `openedPrice`, else the requested one. */\nfunction openPriceOf(quote: UnifiedQuote): bigint {\n  return quote.openedPrice !== undefined && quote.openedPrice !== 0n ? quote.openedPrice : quote.requestedOpenPrice;\n}\n\n/** Whether a quote still lacks a settled open price (a pending or optimistic open). */\nfunction hasUnsettledOpenPrice(quote: UnifiedQuote): boolean {\n  return quote.openedPrice === undefined || quote.openedPrice === 0n;\n}\n\n/**\n * Compute the pure, price-independent {@link QuoteGroupMetrics} for a set of\n * child quotes.\n *\n * - `openQuantity` / `quantity` are plain sums (wei).\n * - `notional = Σ(openQuantity × openPrice)`, rescaled to wei.\n * - `weightedOpenPrice = notionalₙᵤₘ / Σ openQuantity`, suppressed (`undefined`)\n *   when there is no open size or any child has an unsettled open price.\n * - `lockedValues` sums each margin leg.\n * - `leverage = notional / (Σ cva + lf + partyAmm)`, as an 18-decimal fixed-point\n *   `bigint`, `undefined` when that margin is `0`.\n *\n * Pure and order-independent. Empty input yields all-zero amounts with the\n * optional fields `undefined`.\n *\n * @param quotes - The group's child quotes.\n * @returns The aggregated metrics.\n */\nexport function aggregateGroupMetrics(quotes: readonly UnifiedQuote[]): QuoteGroupMetrics {\n  let quantity = 0n;\n  let openQuantity = 0n;\n  /** Σ(openQuantity × openPrice), scaled by `WEI²` until the final rescale. */\n  let notionalNumerator = 0n;\n  let cva = 0n;\n  let lf = 0n;\n  let partyAmm = 0n;\n  let partyBmm = 0n;\n  let openCount = 0;\n  let pendingCount = 0;\n  let anyUnsettledOpenPrice = false;\n\n  for (const quote of quotes) {\n    quantity += quote.quantity;\n    openQuantity += quote.openQuantity;\n    notionalNumerator += quote.openQuantity * openPriceOf(quote);\n    cva += quote.lockedValues.cva;\n    lf += quote.lockedValues.lf;\n    partyAmm += quote.lockedValues.partyAmm;\n    partyBmm += quote.lockedValues.partyBmm;\n    if (hasUnsettledOpenPrice(quote)) anyUnsettledOpenPrice = true;\n    if (isPendingOrder(quote)) pendingCount += 1;\n    else if (isActivePosition(quote)) openCount += 1;\n  }\n\n  const lockedValues: LockedValues = { cva, lf, partyAmm, partyBmm };\n  const notional = notionalNumerator / WEI;\n  const partyAMargin = cva + lf + partyAmm;\n\n  const weightedOpenPrice = openQuantity > 0n && !anyUnsettledOpenPrice ? notionalNumerator / openQuantity : undefined;\n  const leverage = partyAMargin > 0n ? (notional * WEI) / partyAMargin : undefined;\n\n  return {\n    quoteCount: quotes.length,\n    openCount,\n    pendingCount,\n    quantity,\n    openQuantity,\n    weightedOpenPrice,\n    notional,\n    lockedValues,\n    leverage,\n  };\n}\n"],"mappings":";;;AAOA,SAAS,EAAY,GAA6B;CAChD,OAAO,EAAM,gBAAgB,KAAA,KAAa,EAAM,gBAAgB,KAAK,EAAM,cAAc,EAAM;AACjG;AAGA,SAAS,EAAsB,GAA8B;CAC3D,OAAO,EAAM,gBAAgB,KAAA,KAAa,EAAM,gBAAgB;AAClE;AAoBA,SAAgB,EAAsB,GAAoD;CACxF,IAAI,IAAW,IACX,IAAe,IAEf,IAAoB,IACpB,IAAM,IACN,IAAK,IACL,IAAW,IACX,IAAW,IACX,IAAY,GACZ,IAAe,GACf,IAAwB;CAE5B,KAAK,IAAM,KAAS,GASlB,AARA,KAAY,EAAM,UAClB,KAAgB,EAAM,cACtB,KAAqB,EAAM,eAAe,EAAY,CAAK,GAC3D,KAAO,EAAM,aAAa,KAC1B,KAAM,EAAM,aAAa,IACzB,KAAY,EAAM,aAAa,UAC/B,KAAY,EAAM,aAAa,UAC3B,EAAsB,CAAK,MAAG,IAAwB,KACtD,EAAe,CAAK,IAAG,KAAgB,IAClC,EAAiB,CAAK,MAAG,KAAa;CAGjD,IAAM,IAA6B;EAAE;EAAK;EAAI;EAAU;CAAS,GAC3D,IAAW,IAAoB,GAC/B,IAAe,IAAM,IAAK,GAE1B,IAAoB,IAAe,MAAM,CAAC,IAAwB,IAAoB,IAAe,KAAA,GACrG,IAAW,IAAe,KAAM,IAAW,IAAO,IAAe,KAAA;CAEvE,OAAO;EACL,YAAY,EAAO;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

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

@@ -0,0 +1,34 @@
+import { UnifiedQuote } from '../unified-quote';
+import { QuoteGroup, QuoteGroupingStrategy } from './quote-group';
+/** Options for {@link groupQuotes}. */
+export interface GroupQuotesOptions {
+    /**
+     * Comparator for the returned groups. Defaults to newest-group-first (by each
+     * group's newest child). Child quotes within a group are always sorted
+     * newest-first regardless.
+     */
+    sort?: (a: QuoteGroup, b: QuoteGroup) => number;
+}
+/**
+ * Fold quotes into {@link QuoteGroup}s under a {@link QuoteGroupingStrategy}.
+ *
+ * Pure and deterministic: it groups exactly the array it is given (partition into
+ * positions vs pending orders first with `partitionQuotes` if you only want to
+ * group open positions). Each group carries its child quotes (newest first), its
+ * resolved Virtual Account, an `isAggregate` flag, and pure
+ * {@link QuoteGroupMetrics}. Groups are returned newest-first by default.
+ *
+ * @param quotes - The quotes to group.
+ * @param strategy - A {@link SubAccountIsolationType} or a custom `{ keyOf }`.
+ * @param options - Optional group ordering override.
+ * @returns The groups.
+ *
+ * @example
+ * ```ts
+ * const { positions } = partitionQuotes(quotes);
+ * const groups = groupQuotes(positions, SubAccountIsolationType.MARKET_DIRECTION);
+ * // groups[0].metrics.openQuantity, groups[0].metrics.weightedOpenPrice, …
+ * ```
+ */
+export declare function groupQuotes(quotes: readonly UnifiedQuote[], strategy: QuoteGroupingStrategy, options?: GroupQuotesOptions): QuoteGroup[];
+//# sourceMappingURL=group-quotes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-quotes.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/group-quotes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAgB,qBAAqB,EAAE,MAAM,eAAe,CAAC;AA+BrF,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CA0Bd"}

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

@@ -0,0 +1,44 @@
+import { aggregateGroupMetrics as e } from "./aggregate-metrics.js";
+import { resolveQuoteGroupingStrategy as t } from "./group-strategy.js";
+//#region src/quotes/grouping/group-quotes.ts
+function n(e) {
+	return e.statusModifyTimestamp ?? e.createTimestamp ?? 0n;
+}
+function r(e, t) {
+	let r = n(e), i = n(t);
+	return r === i ? e.key < t.key ? -1 : +(e.key > t.key) : i > r ? 1 : -1;
+}
+function i(e, t) {
+	let r = e.quotes[0] ? n(e.quotes[0]) : 0n, i = t.quotes[0] ? n(t.quotes[0]) : 0n;
+	return r === i ? e.key < t.key ? -1 : +(e.key > t.key) : i > r ? 1 : -1;
+}
+function a(e) {
+	return e.find((e) => e.origin === "onchain" && e.vaAddress)?.vaAddress ?? e.find((e) => e.vaAddress)?.vaAddress;
+}
+function o(n, o, s) {
+	let c = t(o), l = /* @__PURE__ */ new Map();
+	for (let e of n) {
+		let { key: t, by: n } = c(e), r = l.get(t);
+		r ? r.quotes.push(e) : l.set(t, {
+			by: n,
+			quotes: [e]
+		});
+	}
+	let u = [];
+	for (let [t, n] of l) {
+		let i = n.quotes.sort(r);
+		u.push({
+			key: t,
+			by: n.by,
+			vaAddress: a(i),
+			quotes: i,
+			isAggregate: i.length > 1,
+			metrics: e(i)
+		});
+	}
+	return u.sort(s?.sort ?? i);
+}
+//#endregion
+export { o as groupQuotes };
+
+//# sourceMappingURL=group-quotes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-quotes.js","names":[],"sources":["../../../src/quotes/grouping/group-quotes.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { UnifiedQuote } from \"../unified-quote\";\nimport { aggregateGroupMetrics } from \"./aggregate-metrics\";\nimport { resolveQuoteGroupingStrategy } from \"./group-strategy\";\nimport type { QuoteGroup, QuoteGroupBy, QuoteGroupingStrategy } from \"./quote-group\";\n\n/** Best-known ordering timestamp for a quote — last status change, else creation. */\nfunction orderingTimestamp(quote: UnifiedQuote): bigint {\n  return quote.statusModifyTimestamp ?? quote.createTimestamp ?? 0n;\n}\n\n/** Newest-first by ordering timestamp, breaking ties by `key` for a stable sort. */\nfunction byNewestQuote(a: UnifiedQuote, b: UnifiedQuote): number {\n  const ta = orderingTimestamp(a);\n  const tb = orderingTimestamp(b);\n  if (ta !== tb) return tb > ta ? 1 : -1;\n  return a.key < b.key ? -1 : a.key > b.key ? 1 : 0;\n}\n\n/** Default group order: newest group first (by its newest child), ties broken by `key`. */\nfunction byNewestGroup(a: QuoteGroup, b: QuoteGroup): number {\n  const ta = a.quotes[0] ? orderingTimestamp(a.quotes[0]) : 0n;\n  const tb = b.quotes[0] ? orderingTimestamp(b.quotes[0]) : 0n;\n  if (ta !== tb) return tb > ta ? 1 : -1;\n  return a.key < b.key ? -1 : a.key > b.key ? 1 : 0;\n}\n\n/** The VA a group resolves to: from its first on-chain child, else any child that carries one. */\nfunction resolveGroupVaAddress(quotes: readonly UnifiedQuote[]): Address | undefined {\n  return (\n    quotes.find((quote) => quote.origin === \"onchain\" && quote.vaAddress)?.vaAddress ??\n    quotes.find((quote) => quote.vaAddress)?.vaAddress\n  );\n}\n\n/** Options for {@link groupQuotes}. */\nexport interface GroupQuotesOptions {\n  /**\n   * Comparator for the returned groups. Defaults to newest-group-first (by each\n   * group's newest child). Child quotes within a group are always sorted\n   * newest-first regardless.\n   */\n  sort?: (a: QuoteGroup, b: QuoteGroup) => number;\n}\n\n/**\n * Fold quotes into {@link QuoteGroup}s under a {@link QuoteGroupingStrategy}.\n *\n * Pure and deterministic: it groups exactly the array it is given (partition into\n * positions vs pending orders first with `partitionQuotes` if you only want to\n * group open positions). Each group carries its child quotes (newest first), its\n * resolved Virtual Account, an `isAggregate` flag, and pure\n * {@link QuoteGroupMetrics}. Groups are returned newest-first by default.\n *\n * @param quotes - The quotes to group.\n * @param strategy - A {@link SubAccountIsolationType} or a custom `{ keyOf }`.\n * @param options - Optional group ordering override.\n * @returns The groups.\n *\n * @example\n * ```ts\n * const { positions } = partitionQuotes(quotes);\n * const groups = groupQuotes(positions, SubAccountIsolationType.MARKET_DIRECTION);\n * // groups[0].metrics.openQuantity, groups[0].metrics.weightedOpenPrice, …\n * ```\n */\nexport function groupQuotes(\n  quotes: readonly UnifiedQuote[],\n  strategy: QuoteGroupingStrategy,\n  options?: GroupQuotesOptions,\n): QuoteGroup[] {\n  const keyOf = resolveQuoteGroupingStrategy(strategy);\n\n  /** Insertion-ordered buckets so groups are built deterministically before sorting. */\n  const buckets = new Map<string, { by: QuoteGroupBy; quotes: UnifiedQuote[] }>();\n  for (const quote of quotes) {\n    const { key, by } = keyOf(quote);\n    const bucket = buckets.get(key);\n    if (bucket) bucket.quotes.push(quote);\n    else buckets.set(key, { by, quotes: [quote] });\n  }\n\n  const groups: QuoteGroup[] = [];\n  for (const [key, bucket] of buckets) {\n    const children = bucket.quotes.sort(byNewestQuote);\n    groups.push({\n      key,\n      by: bucket.by,\n      vaAddress: resolveGroupVaAddress(children),\n      quotes: children,\n      isAggregate: children.length > 1,\n      metrics: aggregateGroupMetrics(children),\n    });\n  }\n\n  return groups.sort(options?.sort ?? byNewestGroup);\n}\n"],"mappings":";;;AAOA,SAAS,EAAkB,GAA6B;CACtD,OAAO,EAAM,yBAAyB,EAAM,mBAAmB;AACjE;AAGA,SAAS,EAAc,GAAiB,GAAyB;CAC/D,IAAM,IAAK,EAAkB,CAAC,GACxB,IAAK,EAAkB,CAAC;CAE9B,OADI,MAAO,IACJ,EAAE,MAAM,EAAE,MAAM,KAAK,IAAE,MAAM,EAAE,OADhB,IAAK,IAAK,IAAI;AAEtC;AAGA,SAAS,EAAc,GAAe,GAAuB;CAC3D,IAAM,IAAK,EAAE,OAAO,KAAK,EAAkB,EAAE,OAAO,EAAE,IAAI,IACpD,IAAK,EAAE,OAAO,KAAK,EAAkB,EAAE,OAAO,EAAE,IAAI;CAE1D,OADI,MAAO,IACJ,EAAE,MAAM,EAAE,MAAM,KAAK,IAAE,MAAM,EAAE,OADhB,IAAK,IAAK,IAAI;AAEtC;AAGA,SAAS,EAAsB,GAAsD;CACnF,OACE,EAAO,MAAM,MAAU,EAAM,WAAW,aAAa,EAAM,SAAS,GAAG,aACvE,EAAO,MAAM,MAAU,EAAM,SAAS,GAAG;AAE7C;AAiCA,SAAgB,EACd,GACA,GACA,GACc;CACd,IAAM,IAAQ,EAA6B,CAAQ,GAG7C,oBAAU,IAAI,IAA0D;CAC9E,KAAK,IAAM,KAAS,GAAQ;EAC1B,IAAM,EAAE,QAAK,UAAO,EAAM,CAAK,GACzB,IAAS,EAAQ,IAAI,CAAG;EAC9B,AAAI,IAAQ,EAAO,OAAO,KAAK,CAAK,IAC/B,EAAQ,IAAI,GAAK;GAAE;GAAI,QAAQ,CAAC,CAAK;EAAE,CAAC;CAC/C;CAEA,IAAM,IAAuB,CAAC;CAC9B,KAAK,IAAM,CAAC,GAAK,MAAW,GAAS;EACnC,IAAM,IAAW,EAAO,OAAO,KAAK,CAAa;EACjD,EAAO,KAAK;GACV;GACA,IAAI,EAAO;GACX,WAAW,EAAsB,CAAQ;GACzC,QAAQ;GACR,aAAa,EAAS,SAAS;GAC/B,SAAS,EAAsB,CAAQ;EACzC,CAAC;CACH;CAEA,OAAO,EAAO,KAAK,GAAS,QAAQ,CAAa;AACnD"}

package/dist/quotes/grouping/group-strategy.d.ts

@@ -0,0 +1,17 @@
+import { QuoteGroupingStrategy, QuoteGroupKeyFn } from './quote-group';
+/**
+ * Resolve a {@link QuoteGroupingStrategy} to the {@link QuoteGroupKeyFn} that
+ * places each quote into its group.
+ *
+ * A `{ keyOf }` object is returned as-is. A {@link SubAccountIsolationType} maps
+ * to its built-in strategy: `MARKET` groups by market, `MARKET_DIRECTION` by
+ * market + side, and `POSITION` / `CUSTOM` produce one group per quote (custom
+ * isolation places trades in manually-managed VAs, so consumers that want
+ * VA-based grouping pass their own `keyOf`).
+ *
+ * @param strategy - The grouping strategy.
+ * @returns The key function for {@link groupQuotes}.
+ * @throws {SymmError} when given an unknown isolation type.
+ */
+export declare function resolveQuoteGroupingStrategy(strategy: QuoteGroupingStrategy): QuoteGroupKeyFn;
+//# sourceMappingURL=group-strategy.d.ts.map

package/dist/quotes/grouping/group-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-strategy.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/group-strategy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAiB,eAAe,EAAE,MAAM,eAAe,CAAC;AA0B3F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,eAAe,CAiB7F"}

package/dist/quotes/grouping/group-strategy.js

@@ -0,0 +1,42 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { SubAccountIsolationType as t } from "../../symmio-contracts/account-layer/types.js";
+//#region src/quotes/grouping/group-strategy.ts
+function n(e) {
+	return {
+		key: `m:${e.symbolId}`,
+		by: { symbolId: e.symbolId }
+	};
+}
+function r(e) {
+	return {
+		key: `md:${e.symbolId}:${e.positionType}`,
+		by: {
+			symbolId: e.symbolId,
+			positionType: e.positionType
+		}
+	};
+}
+function i(e) {
+	return {
+		key: e.key,
+		by: {
+			symbolId: e.symbolId,
+			positionType: e.positionType,
+			vaAddress: e.vaAddress
+		}
+	};
+}
+function a(a) {
+	if (typeof a == "object") return a.keyOf;
+	switch (a) {
+		case t.MARKET: return n;
+		case t.MARKET_DIRECTION: return r;
+		case t.POSITION:
+		case t.CUSTOM: return i;
+		default: throw new e("validation", "UNKNOWN_GROUPING_STRATEGY", `groupQuotes: unknown grouping strategy \`${a}\`.`);
+	}
+}
+//#endregion
+export { a as resolveQuoteGroupingStrategy };
+
+//# sourceMappingURL=group-strategy.js.map

package/dist/quotes/grouping/group-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-strategy.js","names":[],"sources":["../../../src/quotes/grouping/group-strategy.ts"],"sourcesContent":["import { SymmError } from \"../../shared/errors/symm-error\";\nimport { SubAccountIsolationType } from \"../../symmio-contracts/account-layer/types\";\nimport type { UnifiedQuote } from \"../unified-quote\";\nimport type { QuoteGroupingStrategy, QuoteGroupKey, QuoteGroupKeyFn } from \"./quote-group\";\n\n/** Group by market only — both sides of a market collapse together (`MARKET` isolation). */\nfunction keyByMarket(quote: UnifiedQuote): QuoteGroupKey {\n  return { key: `m:${quote.symbolId}`, by: { symbolId: quote.symbolId } };\n}\n\n/** Group by market + side (`MARKET_DIRECTION` isolation — what the lowcap UI used). */\nfunction keyByMarketDirection(quote: UnifiedQuote): QuoteGroupKey {\n  return {\n    key: `md:${quote.symbolId}:${quote.positionType}`,\n    by: { symbolId: quote.symbolId, positionType: quote.positionType },\n  };\n}\n\n/**\n * Group per single quote — no aggregation (`POSITION` and `CUSTOM` isolation).\n * The group carries the quote's full identity so consumers can label it.\n */\nfunction keyPerQuote(quote: UnifiedQuote): QuoteGroupKey {\n  return {\n    key: quote.key,\n    by: { symbolId: quote.symbolId, positionType: quote.positionType, vaAddress: quote.vaAddress },\n  };\n}\n\n/**\n * Resolve a {@link QuoteGroupingStrategy} to the {@link QuoteGroupKeyFn} that\n * places each quote into its group.\n *\n * A `{ keyOf }` object is returned as-is. A {@link SubAccountIsolationType} maps\n * to its built-in strategy: `MARKET` groups by market, `MARKET_DIRECTION` by\n * market + side, and `POSITION` / `CUSTOM` produce one group per quote (custom\n * isolation places trades in manually-managed VAs, so consumers that want\n * VA-based grouping pass their own `keyOf`).\n *\n * @param strategy - The grouping strategy.\n * @returns The key function for {@link groupQuotes}.\n * @throws {SymmError} when given an unknown isolation type.\n */\nexport function resolveQuoteGroupingStrategy(strategy: QuoteGroupingStrategy): QuoteGroupKeyFn {\n  if (typeof strategy === \"object\") return strategy.keyOf;\n  switch (strategy) {\n    case SubAccountIsolationType.MARKET:\n      return keyByMarket;\n    case SubAccountIsolationType.MARKET_DIRECTION:\n      return keyByMarketDirection;\n    case SubAccountIsolationType.POSITION:\n    case SubAccountIsolationType.CUSTOM:\n      return keyPerQuote;\n    default:\n      throw new SymmError(\n        \"validation\",\n        \"UNKNOWN_GROUPING_STRATEGY\",\n        `groupQuotes: unknown grouping strategy \\`${strategy}\\`.`,\n      );\n  }\n}\n"],"mappings":";;;AAMA,SAAS,EAAY,GAAoC;CACvD,OAAO;EAAE,KAAK,KAAK,EAAM;EAAY,IAAI,EAAE,UAAU,EAAM,SAAS;CAAE;AACxE;AAGA,SAAS,EAAqB,GAAoC;CAChE,OAAO;EACL,KAAK,MAAM,EAAM,SAAS,GAAG,EAAM;EACnC,IAAI;GAAE,UAAU,EAAM;GAAU,cAAc,EAAM;EAAa;CACnE;AACF;AAMA,SAAS,EAAY,GAAoC;CACvD,OAAO;EACL,KAAK,EAAM;EACX,IAAI;GAAE,UAAU,EAAM;GAAU,cAAc,EAAM;GAAc,WAAW,EAAM;EAAU;CAC/F;AACF;AAgBA,SAAgB,EAA6B,GAAkD;CAC7F,IAAI,OAAO,KAAa,UAAU,OAAO,EAAS;CAClD,QAAQ,GAAR;EACE,KAAK,EAAwB,QAC3B,OAAO;EACT,KAAK,EAAwB,kBAC3B,OAAO;EACT,KAAK,EAAwB;EAC7B,KAAK,EAAwB,QAC3B,OAAO;EACT,SACE,MAAM,IAAI,EACR,cACA,6BACA,4CAA4C,EAAS,IACvD;CACJ;AACF"}

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

@@ -0,0 +1,6 @@
+export * from './aggregate-metrics';
+export * from './group-quotes';
+export * from './group-strategy';
+export * from './partition-quotes';
+export * from './quote-group';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/quotes/grouping/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,63 @@
+import { UnifiedQuote } from '../unified-quote';
+/**
+ * Whether a quote is a **resting/pending order** — submitted but not yet an open
+ * position.
+ *
+ * An anchored row is classified by its on-chain {@link QuoteStatus}
+ * (`PENDING` / `LOCKED` / `CANCEL_PENDING`). An off-chain optimistic row (no
+ * status yet) is pending only when it is a not-yet-filled `LIMIT` order; an
+ * optimistic `MARKET` open is treated as an opening position instead.
+ *
+ * Mutually exclusive with {@link isActivePosition}.
+ *
+ * @param quote - The unified quote to classify.
+ * @returns `true` for a resting/pending order.
+ */
+export declare function isPendingOrder(quote: UnifiedQuote): boolean;
+/**
+ * Whether a quote is an **active position** — opened (or opening), possibly with
+ * a close in flight.
+ *
+ * An anchored row is classified by its on-chain {@link QuoteStatus}
+ * (`OPENED` / `CLOSE_PENDING` / `CANCEL_CLOSE_PENDING` / `LIQUIDATED_PENDING`).
+ * A row with no `quoteStatus` yet is classified by lifecycle + order type: an
+ * optimistic/price-filled or just-anchored (`WRITE_ONCHAIN` / `ONCHAIN`) `MARKET`
+ * open is an active position, while the matching `LIMIT` order is still resting
+ * (pending). The `WRITE_ONCHAIN`-without-`quoteStatus` case is the brief window
+ * after a `SendQuoteTransaction` notification anchors the row but before the
+ * on-chain poll has returned its full struct — without it the row would drop out of
+ * the grouped view for a tick. Any closing-stage row (`OPTIMISTIC_CLOSE` /
+ * `CLOSE_PRICE_FILLED` / `WRITE_ONCHAIN_CLOSE` / `CLOSING`) is always active;
+ * terminal rows (`CLOSED` / `CANCELED` / `EXPIRED` / `LIQUIDATED`, or an off-chain
+ * `FAILED`) are neither.
+ *
+ * Mutually exclusive with {@link isPendingOrder}.
+ *
+ * @param quote - The unified quote to classify.
+ * @returns `true` for an active position.
+ */
+export declare function isActivePosition(quote: UnifiedQuote): boolean;
+/** Result of {@link partitionQuotes}. */
+export interface PartitionedQuotes {
+    /** Quotes that are open (or opening) positions. */
+    positions: UnifiedQuote[];
+    /** Quotes that are resting/pending orders. */
+    pending: UnifiedQuote[];
+}
+/**
+ * Split unified quotes into active positions and resting/pending orders — the
+ * grouped-view-vs-orders-tab split. Terminal rows (closed / cancelled / expired /
+ * liquidated / failed) fall into neither bucket and are dropped, so
+ * `positions ∪ pending` is the set of still-live quotes.
+ *
+ * @param quotes - The unified quotes to split.
+ * @returns The `positions` and `pending` buckets, each preserving input order.
+ *
+ * @example
+ * ```ts
+ * const { positions, pending } = partitionQuotes(quotes);
+ * const groups = groupQuotes(positions, SubAccountIsolationType.MARKET_DIRECTION);
+ * ```
+ */
+export declare function partitionQuotes(quotes: readonly UnifiedQuote[]): PartitionedQuotes;
+//# sourceMappingURL=partition-quotes.d.ts.map

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

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

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

@@ -0,0 +1,42 @@
+import { OrderType as e, QuoteStatus as t } from "../../symmio-contracts/symmio/types.js";
+import { QuoteLifecycle as n } from "../unified-quote.js";
+//#region src/quotes/grouping/partition-quotes.ts
+var r = new Set([
+	t.PENDING,
+	t.LOCKED,
+	t.CANCEL_PENDING
+]), i = new Set([
+	t.OPENED,
+	t.CLOSE_PENDING,
+	t.CANCEL_CLOSE_PENDING,
+	t.LIQUIDATED_PENDING
+]);
+function a(t) {
+	return t.quoteStatus === void 0 ? t.lifecycle === n.OPTIMISTIC || t.lifecycle === n.PRICE_FILLED || t.lifecycle === n.WRITE_ONCHAIN || t.lifecycle === n.ONCHAIN ? t.orderType === e.LIMIT : !1 : r.has(t.quoteStatus);
+}
+function o(t) {
+	if (t.quoteStatus !== void 0) return i.has(t.quoteStatus);
+	switch (t.lifecycle) {
+		case n.OPTIMISTIC:
+		case n.PRICE_FILLED:
+		case n.WRITE_ONCHAIN:
+		case n.ONCHAIN: return t.orderType !== e.LIMIT;
+		case n.OPTIMISTIC_CLOSE:
+		case n.CLOSE_PRICE_FILLED:
+		case n.WRITE_ONCHAIN_CLOSE:
+		case n.CLOSING: return !0;
+		default: return !1;
+	}
+}
+function s(e) {
+	let t = [], n = [];
+	for (let r of e) a(r) ? n.push(r) : o(r) && t.push(r);
+	return {
+		positions: t,
+		pending: n
+	};
+}
+//#endregion
+export { o as isActivePosition, a as isPendingOrder, s as partitionQuotes };
+
+//# sourceMappingURL=partition-quotes.js.map

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

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