@symmio/trading-core 0.1.0

package/dist/muon/deallocate-upnl-sig/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/deallocate-upnl-sig/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,8BAA8B,EACnC,KAAK,8BAA8B,EACpC,MAAM,2BAA2B,CAAC;AAEnC,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,CAAC;AAEtE;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,8BAA8B,GAAG,kBAAkB,CAAC,8DAEjH;AAED,uEAAuE;AACvE,MAAM,MAAM,4BAA4B,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAE3F;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAC/C,8BAA8B,GAC5B,cAAc,CAAC,wBAAwB,EAAE,KAAK,EAAE,wBAAwB,EAAE,4BAA4B,CAAC,CAC1G,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,gCAAgC,GAAG,kBAAkB,CAC/D,wBAAwB,EACxB,KAAK,EACL,wBAAwB,EACxB,4BAA4B,CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,2BAA2B,GACnC,gCAAgC,CAOlC"}

package/dist/muon/deallocate-upnl-sig/query.js

@@ -0,0 +1,24 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getDeallocateUpnlSig as t } from "./get-deallocate-upnl-sig.js";
+//#region src/muon/deallocate-upnl-sig/query.ts
+function n(t) {
+	return ["getDeallocateUpnlSig", 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,
+			virtualAccount: r.virtualAccount
+		})
+	};
+}
+//#endregion
+export { n as getDeallocateUpnlSigQueryKey, r as getDeallocateUpnlSigQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/muon/deallocate-upnl-sig/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/deallocate-upnl-sig/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  getDeallocateUpnlSig,\n  type GetDeallocateUpnlSigParameters,\n  type GetDeallocateUpnlSigReturnType,\n} from \"./get-deallocate-upnl-sig\";\n\n/** Data resolved by the {@link getDeallocateUpnlSigQueryOptions} query. */\nexport type GetDeallocateUpnlSigData = GetDeallocateUpnlSigReturnType;\n\n/**\n * Build the TanStack Query key for {@link getDeallocateUpnlSigQueryOptions}.\n *\n * @param options - Query parameters (chain id, virtual account).\n * @returns A stable, hashable query key.\n */\nexport function getDeallocateUpnlSigQueryKey(options: Compute<GetDeallocateUpnlSigParameters & ConfigKeyParameter>) {\n  return [\"getDeallocateUpnlSig\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getDeallocateUpnlSigQueryKey}. */\nexport type GetDeallocateUpnlSigQueryKey = ReturnType<typeof getDeallocateUpnlSigQueryKey>;\n\n/**\n * Options accepted by {@link getDeallocateUpnlSigQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetDeallocateUpnlSigOptions = Compute<\n  GetDeallocateUpnlSigParameters &\n    QueryParameter<GetDeallocateUpnlSigData, Error, GetDeallocateUpnlSigData, GetDeallocateUpnlSigQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getDeallocateUpnlSigQueryOptions}. */\nexport type GetDeallocateUpnlSigQueryOptions = SymmioQueryOptions<\n  GetDeallocateUpnlSigData,\n  Error,\n  GetDeallocateUpnlSigData,\n  GetDeallocateUpnlSigQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getDeallocateUpnlSig}.\n *\n * @remarks\n * The attestation is short-lived. For an actual `removeMargin` submit, prefer\n * fetching a fresh signature on demand (the `@symmio/trading-react`\n * `useRemoveMargin` hook does this) rather than serving a cached one. If you do\n * cache it — e.g. to display the attested uPnL — set a low `staleTime` and\n * refetch before submitting.\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(getDeallocateUpnlSigQueryOptions(config, { virtualAccount: \"0xva…\" }));\n * ```\n */\nexport function getDeallocateUpnlSigQueryOptions(\n  config: Config,\n  options: GetDeallocateUpnlSigOptions,\n): GetDeallocateUpnlSigQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getDeallocateUpnlSigQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getDeallocateUpnlSig(config, { chainId: options.chainId, virtualAccount: options.virtualAccount }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA6B,GAAuE;CAClH,OAAO,CAAC,wBAAwB,EAAmB,CAAO,CAAC;AAC7D;AAyCA,SAAgB,EACd,GACA,GACkC;CAClC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA6B;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EAC3G,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAqB,GAAQ;GAAE,SAAS,EAAQ;GAAS,gBAAgB,EAAQ;EAAe,CAAC;CAClH;AACF"}

package/dist/muon/index.d.ts

@@ -0,0 +1,12 @@
+export * from './deallocate-upnl-sig';
+export * from './party-a-overview';
+export * from './price';
+export * from './price-range';
+export * from './settle-upnl';
+export * from './types';
+export * from './upnl';
+export * from './upnl-a';
+export * from './upnl-a-with-symbol-price';
+export * from './upnl-b';
+export * from './upnl-with-symbol-price';
+//# sourceMappingURL=index.d.ts.map

package/dist/muon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/muon/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,0BAA0B,CAAC"}

package/dist/muon/party-a-overview/get-muon-party-a-overview.d.ts

@@ -0,0 +1,58 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { MuonAttestationBase } from '../types';
+/** Parameters for {@link getMuonPartyAOverview}. */
+export type GetMuonPartyAOverviewParameters = Compute<ChainIdParameter & {
+    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) to attest. */
+    partyA: Address;
+}>;
+/**
+ * Normalized `partyA_overview` attestation: the shared signature envelope plus
+ * partyA's liquidation-overview fields.
+ *
+ * @remarks
+ * TODO(muon-verify): beyond `uPnl` (verified via Vibe-ui), the field set/nesting
+ * is best-effort from the Muon docs; optional fields are absent when the gateway
+ * omits them.
+ */
+export interface GetMuonPartyAOverviewReturnType extends MuonAttestationBase {
+    /** The attested partyA. */
+    partyA: Address;
+    /** Signed unrealized PnL (18-decimal, signed). */
+    uPnl: bigint;
+    /** Sum of notional values across the partyA's positions. */
+    notionalValueSum?: bigint;
+    /** Aggregated loss used by the liquidation flow. */
+    loss?: bigint;
+    /** Raw liquidation id for this partyA, when the attestation carries one. */
+    liquidationId?: string;
+    /** Symbol ids included in the attestation. */
+    symbolIds: bigint[];
+    /** Quote ids included in the attestation. */
+    quoteIds: bigint[];
+}
+/**
+ * Fetch a fresh Muon `partyA_overview` attestation for `partyA` and normalize it
+ * to typed fields. The oracle URLs and the SYMMIO diamond address (the `symmio`
+ * request param) are resolved from `config`; gateways are tried in order until
+ * one succeeds.
+ *
+ * @remarks
+ * This is the uPnL + liquidation data behind `liquidatePartyA` / `setSymbolsPrice`
+ * (it produces a `LiquidationSig`).
+ *
+ * @param config - The SDK config.
+ * @param parameters - PartyA address and optional chain id.
+ * @returns The normalized `partyA_overview` attestation.
+ * @throws {SymmError} when the chain is unsupported, no Muon URLs are configured,
+ *   or every oracle returns an unsuccessful or malformed attestation.
+ *
+ * @example
+ * ```ts
+ * const overview = await getMuonPartyAOverview(config, { partyA: "0xva…" });
+ * console.log(overview.uPnl, overview.liquidationId);
+ * ```
+ */
+export declare function getMuonPartyAOverview(config: Config, parameters: GetMuonPartyAOverviewParameters): Promise<GetMuonPartyAOverviewReturnType>;
+//# sourceMappingURL=get-muon-party-a-overview.d.ts.map

package/dist/muon/party-a-overview/get-muon-party-a-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-party-a-overview.d.ts","sourceRoot":"","sources":["../../../src/muon/party-a-overview/get-muon-party-a-overview.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;AAE/E,OAAO,EAAgC,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAElF,oDAAoD;AACpD,MAAM,MAAM,+BAA+B,GAAG,OAAO,CACnD,gBAAgB,GAAG;IACjB,sFAAsF;IACtF,MAAM,EAAE,OAAO,CAAC;CACjB,CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,+BAAgC,SAAQ,mBAAmB;IAC1E,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,+BAA+B,GAC1C,OAAO,CAAC,+BAA+B,CAAC,CAkB1C"}

package/dist/muon/party-a-overview/get-muon-party-a-overview.js

@@ -0,0 +1,24 @@
+import { MUON_METHOD_PARTY_A_OVERVIEW as e } from "../types.js";
+import { fetchMuon as t, muonBigInt as n, muonBigIntArray as r, requireMuonBigInt as i, toMuonAttestationBase as a } from "../client.js";
+//#region src/muon/party-a-overview/get-muon-party-a-overview.ts
+async function o(o, s) {
+	let { chainId: c, addresses: l, muon: u } = o.getChainConfig(s.chainId), d = await t(u.urls, e, {
+		partyA: s.partyA,
+		chainId: c.toString(),
+		symmio: l.symmioAddress
+	}), f = d.data.result;
+	return {
+		...a(d),
+		partyA: s.partyA,
+		uPnl: i(f.uPnl, "uPnl"),
+		notionalValueSum: n(f.notionalValueSum),
+		loss: n(f.loss),
+		liquidationId: f.liquidationId,
+		symbolIds: r(f.symbolIds),
+		quoteIds: r(f.quoteIds)
+	};
+}
+//#endregion
+export { o as getMuonPartyAOverview };
+
+//# sourceMappingURL=get-muon-party-a-overview.js.map

package/dist/muon/party-a-overview/get-muon-party-a-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-party-a-overview.js","names":[],"sources":["../../../src/muon/party-a-overview/get-muon-party-a-overview.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { fetchMuon, muonBigInt, muonBigIntArray, requireMuonBigInt, toMuonAttestationBase } from \"../client\";\nimport { MUON_METHOD_PARTY_A_OVERVIEW, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonPartyAOverview}. */\nexport type GetMuonPartyAOverviewParameters = Compute<\n  ChainIdParameter & {\n    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) to attest. */\n    partyA: Address;\n  }\n>;\n\n/**\n * Normalized `partyA_overview` attestation: the shared signature envelope plus\n * partyA's liquidation-overview fields.\n *\n * @remarks\n * TODO(muon-verify): beyond `uPnl` (verified via Vibe-ui), the field set/nesting\n * is best-effort from the Muon docs; optional fields are absent when the gateway\n * omits them.\n */\nexport interface GetMuonPartyAOverviewReturnType extends MuonAttestationBase {\n  /** The attested partyA. */\n  partyA: Address;\n  /** Signed unrealized PnL (18-decimal, signed). */\n  uPnl: bigint;\n  /** Sum of notional values across the partyA's positions. */\n  notionalValueSum?: bigint;\n  /** Aggregated loss used by the liquidation flow. */\n  loss?: bigint;\n  /** Raw liquidation id for this partyA, when the attestation carries one. */\n  liquidationId?: string;\n  /** Symbol ids included in the attestation. */\n  symbolIds: bigint[];\n  /** Quote ids included in the attestation. */\n  quoteIds: bigint[];\n}\n\n/**\n * Fetch a fresh Muon `partyA_overview` attestation for `partyA` and normalize it\n * to typed fields. The oracle URLs and the SYMMIO diamond address (the `symmio`\n * request param) are resolved from `config`; gateways are tried in order until\n * one succeeds.\n *\n * @remarks\n * This is the uPnL + liquidation data behind `liquidatePartyA` / `setSymbolsPrice`\n * (it produces a `LiquidationSig`).\n *\n * @param config - The SDK config.\n * @param parameters - PartyA address and optional chain id.\n * @returns The normalized `partyA_overview` attestation.\n * @throws {SymmError} when the chain is unsupported, no Muon URLs are configured,\n *   or every oracle returns an unsuccessful or malformed attestation.\n *\n * @example\n * ```ts\n * const overview = await getMuonPartyAOverview(config, { partyA: \"0xva…\" });\n * console.log(overview.uPnl, overview.liquidationId);\n * ```\n */\nexport async function getMuonPartyAOverview(\n  config: Config,\n  parameters: GetMuonPartyAOverviewParameters,\n): Promise<GetMuonPartyAOverviewReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_PARTY_A_OVERVIEW, {\n    partyA: parameters.partyA,\n    chainId: chainId.toString(),\n    symmio: addresses.symmioAddress,\n  });\n  const result = raw.data.result;\n  return {\n    ...toMuonAttestationBase(raw),\n    partyA: parameters.partyA,\n    uPnl: requireMuonBigInt(result.uPnl, \"uPnl\"),\n    notionalValueSum: muonBigInt(result.notionalValueSum),\n    loss: muonBigInt(result.loss),\n    liquidationId: result.liquidationId as string | undefined,\n    symbolIds: muonBigIntArray(result.symbolIds),\n    quoteIds: muonBigIntArray(result.quoteIds),\n  };\n}\n"],"mappings":";;;AA8DA,eAAsB,EACpB,GACA,GAC0C;CAC1C,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAA8B;EACnE,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,QAAQ,EAAU;CACpB,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,QAAQ,EAAW;EACnB,MAAM,EAAkB,EAAO,MAAM,MAAM;EAC3C,kBAAkB,EAAW,EAAO,gBAAgB;EACpD,MAAM,EAAW,EAAO,IAAI;EAC5B,eAAe,EAAO;EACtB,WAAW,EAAgB,EAAO,SAAS;EAC3C,UAAU,EAAgB,EAAO,QAAQ;CAC3C;AACF"}

package/dist/muon/party-a-overview/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-muon-party-a-overview';
+export * from './query';
+//# sourceMappingURL=index.d.ts.map

package/dist/muon/party-a-overview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/muon/party-a-overview/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,SAAS,CAAC"}

package/dist/muon/party-a-overview/query.d.ts

@@ -0,0 +1,41 @@
+import { Config } from '../../core/config';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query';
+import { GetMuonPartyAOverviewParameters, GetMuonPartyAOverviewReturnType } from './get-muon-party-a-overview';
+/** Data resolved by the {@link getMuonPartyAOverviewQueryOptions} query. */
+export type GetMuonPartyAOverviewData = GetMuonPartyAOverviewReturnType;
+/**
+ * Build the TanStack Query key for {@link getMuonPartyAOverviewQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, partyA).
+ * @returns A stable, hashable query key.
+ */
+export declare function getMuonPartyAOverviewQueryKey(options: Compute<GetMuonPartyAOverviewParameters & ConfigKeyParameter>): readonly ["getMuonPartyAOverview", Record<string, unknown>];
+/** Query-key type produced by {@link getMuonPartyAOverviewQueryKey}. */
+export type GetMuonPartyAOverviewQueryKey = ReturnType<typeof getMuonPartyAOverviewQueryKey>;
+/**
+ * Options accepted by {@link getMuonPartyAOverviewQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetMuonPartyAOverviewOptions = Compute<GetMuonPartyAOverviewParameters & QueryParameter<GetMuonPartyAOverviewData, Error, GetMuonPartyAOverviewData, GetMuonPartyAOverviewQueryKey>>;
+/** TanStack Query options returned by {@link getMuonPartyAOverviewQueryOptions}. */
+export type GetMuonPartyAOverviewQueryOptions = SymmioQueryOptions<GetMuonPartyAOverviewData, Error, GetMuonPartyAOverviewData, GetMuonPartyAOverviewQueryKey>;
+/**
+ * Build TanStack Query options for {@link getMuonPartyAOverview}.
+ *
+ * @remarks
+ * The attestation is short-lived. If you cache it — e.g. to display the attested
+ * liquidation overview — set a low `staleTime`; for a signature you intend to
+ * submit on-chain, fetch a fresh one on demand instead of serving a cached one.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getMuonPartyAOverviewQueryOptions(config, { partyA: "0xva…" }));
+ * ```
+ */
+export declare function getMuonPartyAOverviewQueryOptions(config: Config, options: GetMuonPartyAOverviewOptions): GetMuonPartyAOverviewQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/muon/party-a-overview/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/party-a-overview/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,+BAA+B,EACpC,KAAK,+BAA+B,EACrC,MAAM,6BAA6B,CAAC;AAErC,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,CAAC,+BAA+B,GAAG,kBAAkB,CAAC,+DAEnH;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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,4BAA4B,GACpC,iCAAiC,CAOnC"}

package/dist/muon/party-a-overview/query.js

@@ -0,0 +1,24 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getMuonPartyAOverview as t } from "./get-muon-party-a-overview.js";
+//#region src/muon/party-a-overview/query.ts
+function n(t) {
+	return ["getMuonPartyAOverview", 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,
+			partyA: r.partyA
+		})
+	};
+}
+//#endregion
+export { n as getMuonPartyAOverviewQueryKey, r as getMuonPartyAOverviewQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/muon/party-a-overview/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/party-a-overview/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  getMuonPartyAOverview,\n  type GetMuonPartyAOverviewParameters,\n  type GetMuonPartyAOverviewReturnType,\n} from \"./get-muon-party-a-overview\";\n\n/** Data resolved by the {@link getMuonPartyAOverviewQueryOptions} query. */\nexport type GetMuonPartyAOverviewData = GetMuonPartyAOverviewReturnType;\n\n/**\n * Build the TanStack Query key for {@link getMuonPartyAOverviewQueryOptions}.\n *\n * @param options - Query parameters (chain id, partyA).\n * @returns A stable, hashable query key.\n */\nexport function getMuonPartyAOverviewQueryKey(options: Compute<GetMuonPartyAOverviewParameters & ConfigKeyParameter>) {\n  return [\"getMuonPartyAOverview\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getMuonPartyAOverviewQueryKey}. */\nexport type GetMuonPartyAOverviewQueryKey = ReturnType<typeof getMuonPartyAOverviewQueryKey>;\n\n/**\n * Options accepted by {@link getMuonPartyAOverviewQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetMuonPartyAOverviewOptions = Compute<\n  GetMuonPartyAOverviewParameters &\n    QueryParameter<GetMuonPartyAOverviewData, Error, GetMuonPartyAOverviewData, GetMuonPartyAOverviewQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getMuonPartyAOverviewQueryOptions}. */\nexport type GetMuonPartyAOverviewQueryOptions = SymmioQueryOptions<\n  GetMuonPartyAOverviewData,\n  Error,\n  GetMuonPartyAOverviewData,\n  GetMuonPartyAOverviewQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getMuonPartyAOverview}.\n *\n * @remarks\n * The attestation is short-lived. If you cache it — e.g. to display the attested\n * liquidation overview — set a low `staleTime`; for a signature you intend to\n * submit on-chain, fetch a fresh one on demand instead of serving a cached one.\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(getMuonPartyAOverviewQueryOptions(config, { partyA: \"0xva…\" }));\n * ```\n */\nexport function getMuonPartyAOverviewQueryOptions(\n  config: Config,\n  options: GetMuonPartyAOverviewOptions,\n): GetMuonPartyAOverviewQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getMuonPartyAOverviewQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getMuonPartyAOverview(config, { chainId: options.chainId, partyA: options.partyA }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA8B,GAAwE;CACpH,OAAO,CAAC,yBAAyB,EAAmB,CAAO,CAAC;AAC9D;AAuCA,SAAgB,EACd,GACA,GACmC;CACnC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA8B;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EAC5G,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAsB,GAAQ;GAAE,SAAS,EAAQ;GAAS,QAAQ,EAAQ;EAAO,CAAC;CACnG;AACF"}

package/dist/muon/price/get-muon-price.d.ts

@@ -0,0 +1,49 @@
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { MuonAttestationBase } from '../types';
+/** Parameters for {@link getMuonPrice}. */
+export type GetMuonPriceParameters = Compute<ChainIdParameter & {
+    /** The quote ids to price (the partyB liquidation flow validates these prices). */
+    quoteIds: readonly bigint[];
+}>;
+/**
+ * Normalized `price` attestation: the shared signature envelope plus the
+ * validated prices for the requested quote ids.
+ *
+ * @remarks
+ * Verified against the live gateway: `price` returns `quoteIds`, `symbols`, and
+ * `prices`. `markPrices` / `maxLeverages` were not observed for this method but
+ * stay optional for forward-compatibility (absent when the gateway omits them).
+ */
+export interface GetMuonPriceReturnType extends MuonAttestationBase {
+    /** The attested quote ids (echoed from the request). */
+    quoteIds: bigint[];
+    /** Validated prices per quote id (18-decimal). */
+    prices?: bigint[];
+    /** Mark prices per quote id (18-decimal). */
+    markPrices?: bigint[];
+    /** Max leverage per quote id. */
+    maxLeverages?: bigint[];
+    /** Symbol names per quote id. */
+    symbols?: string[];
+}
+/**
+ * Fetch a fresh Muon `price` attestation for a set of quote ids and normalize it
+ * to typed fields. The oracle URLs and the SYMMIO diamond address (the `symmio`
+ * request param) are resolved from `config`; gateways are tried in order until
+ * one succeeds.
+ *
+ * @param config - The SDK config.
+ * @param parameters - The quote ids to price and optional chain id.
+ * @returns The normalized `price` attestation.
+ * @throws {SymmError} when the chain is unsupported, no Muon URLs are configured,
+ *   or every oracle returns an unsuccessful or malformed attestation.
+ *
+ * @example
+ * ```ts
+ * const p = await getMuonPrice(config, { quoteIds: [10n, 11n] });
+ * console.log(p.prices, p.quoteIds);
+ * ```
+ */
+export declare function getMuonPrice(config: Config, parameters: GetMuonPriceParameters): Promise<GetMuonPriceReturnType>;
+//# sourceMappingURL=get-muon-price.d.ts.map

package/dist/muon/price/get-muon-price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-price.d.ts","sourceRoot":"","sources":["../../../src/muon/price/get-muon-price.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEvE,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,gBAAgB,GAAG;IACjB,mFAAmF;IACnF,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAgBjC"}

package/dist/muon/price/get-muon-price.js

@@ -0,0 +1,22 @@
+import { MUON_METHOD_PRICE as e } from "../types.js";
+import { fetchMuon as t, muonBigIntArray as n, toMuonArrayParam as r, toMuonAttestationBase as i } from "../client.js";
+//#region src/muon/price/get-muon-price.ts
+async function a(a, o) {
+	let { chainId: s, addresses: c, muon: l } = a.getChainConfig(o.chainId), u = await t(l.urls, e, {
+		quoteIds: r(o.quoteIds),
+		chainId: s.toString(),
+		symmio: c.symmioAddress
+	}), d = u.data.result;
+	return {
+		...i(u),
+		quoteIds: [...o.quoteIds],
+		prices: Array.isArray(d.prices) ? n(d.prices) : void 0,
+		markPrices: Array.isArray(d.markPrices) ? n(d.markPrices) : void 0,
+		maxLeverages: Array.isArray(d.maxLeverages) ? n(d.maxLeverages) : void 0,
+		symbols: Array.isArray(d.symbols) ? d.symbols.map(String) : void 0
+	};
+}
+//#endregion
+export { a as getMuonPrice };
+
+//# sourceMappingURL=get-muon-price.js.map

package/dist/muon/price/get-muon-price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-price.js","names":[],"sources":["../../../src/muon/price/get-muon-price.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { fetchMuon, muonBigIntArray, toMuonArrayParam, toMuonAttestationBase } from \"../client\";\nimport { MUON_METHOD_PRICE, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonPrice}. */\nexport type GetMuonPriceParameters = Compute<\n  ChainIdParameter & {\n    /** The quote ids to price (the partyB liquidation flow validates these prices). */\n    quoteIds: readonly bigint[];\n  }\n>;\n\n/**\n * Normalized `price` attestation: the shared signature envelope plus the\n * validated prices for the requested quote ids.\n *\n * @remarks\n * Verified against the live gateway: `price` returns `quoteIds`, `symbols`, and\n * `prices`. `markPrices` / `maxLeverages` were not observed for this method but\n * stay optional for forward-compatibility (absent when the gateway omits them).\n */\nexport interface GetMuonPriceReturnType extends MuonAttestationBase {\n  /** The attested quote ids (echoed from the request). */\n  quoteIds: bigint[];\n  /** Validated prices per quote id (18-decimal). */\n  prices?: bigint[];\n  /** Mark prices per quote id (18-decimal). */\n  markPrices?: bigint[];\n  /** Max leverage per quote id. */\n  maxLeverages?: bigint[];\n  /** Symbol names per quote id. */\n  symbols?: string[];\n}\n\n/**\n * Fetch a fresh Muon `price` attestation for a set of quote ids and normalize it\n * to typed fields. The oracle URLs and the SYMMIO diamond address (the `symmio`\n * request param) are resolved from `config`; gateways are tried in order until\n * one succeeds.\n *\n * @param config - The SDK config.\n * @param parameters - The quote ids to price and optional chain id.\n * @returns The normalized `price` attestation.\n * @throws {SymmError} when the chain is unsupported, no Muon URLs are configured,\n *   or every oracle returns an unsuccessful or malformed attestation.\n *\n * @example\n * ```ts\n * const p = await getMuonPrice(config, { quoteIds: [10n, 11n] });\n * console.log(p.prices, p.quoteIds);\n * ```\n */\nexport async function getMuonPrice(\n  config: Config,\n  parameters: GetMuonPriceParameters,\n): Promise<GetMuonPriceReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_PRICE, {\n    quoteIds: toMuonArrayParam(parameters.quoteIds),\n    chainId: chainId.toString(),\n    symmio: addresses.symmioAddress,\n  });\n  const result = raw.data.result;\n  return {\n    ...toMuonAttestationBase(raw),\n    quoteIds: [...parameters.quoteIds],\n    prices: Array.isArray(result.prices) ? muonBigIntArray(result.prices) : undefined,\n    markPrices: Array.isArray(result.markPrices) ? muonBigIntArray(result.markPrices) : undefined,\n    maxLeverages: Array.isArray(result.maxLeverages) ? muonBigIntArray(result.maxLeverages) : undefined,\n    symbols: Array.isArray(result.symbols) ? result.symbols.map(String) : undefined,\n  };\n}\n"],"mappings":";;;AAqDA,eAAsB,EACpB,GACA,GACiC;CACjC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAmB;EACxD,UAAU,EAAiB,EAAW,QAAQ;EAC9C,SAAS,EAAQ,SAAS;EAC1B,QAAQ,EAAU;CACpB,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,UAAU,CAAC,GAAG,EAAW,QAAQ;EACjC,QAAQ,MAAM,QAAQ,EAAO,MAAM,IAAI,EAAgB,EAAO,MAAM,IAAI,KAAA;EACxE,YAAY,MAAM,QAAQ,EAAO,UAAU,IAAI,EAAgB,EAAO,UAAU,IAAI,KAAA;EACpF,cAAc,MAAM,QAAQ,EAAO,YAAY,IAAI,EAAgB,EAAO,YAAY,IAAI,KAAA;EAC1F,SAAS,MAAM,QAAQ,EAAO,OAAO,IAAI,EAAO,QAAQ,IAAI,MAAM,IAAI,KAAA;CACxE;AACF"}

package/dist/muon/price/index.d.ts

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

package/dist/muon/price/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/muon/price/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/muon/price/query.d.ts

@@ -0,0 +1,41 @@
+import { Config } from '../../core/config';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query';
+import { GetMuonPriceParameters, GetMuonPriceReturnType } from './get-muon-price';
+/** Data resolved by the {@link getMuonPriceQueryOptions} query. */
+export type GetMuonPriceData = GetMuonPriceReturnType;
+/**
+ * Build the TanStack Query key for {@link getMuonPriceQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, quote ids).
+ * @returns A stable, hashable query key.
+ */
+export declare function getMuonPriceQueryKey(options: Compute<GetMuonPriceParameters & ConfigKeyParameter>): readonly ["getMuonPrice", Record<string, unknown>];
+/** Query-key type produced by {@link getMuonPriceQueryKey}. */
+export type GetMuonPriceQueryKey = ReturnType<typeof getMuonPriceQueryKey>;
+/**
+ * Options accepted by {@link getMuonPriceQueryOptions}: the action's parameters,
+ * an optional cache scope, and TanStack overrides.
+ */
+export type GetMuonPriceOptions = Compute<GetMuonPriceParameters & QueryParameter<GetMuonPriceData, Error, GetMuonPriceData, GetMuonPriceQueryKey>>;
+/** TanStack Query options returned by {@link getMuonPriceQueryOptions}. */
+export type GetMuonPriceQueryOptions = SymmioQueryOptions<GetMuonPriceData, Error, GetMuonPriceData, GetMuonPriceQueryKey>;
+/**
+ * Build TanStack Query options for {@link getMuonPrice}.
+ *
+ * @remarks
+ * The attestation is short-lived. If you cache it — e.g. to display the validated
+ * prices — set a low `staleTime`; for a signature you intend to submit on-chain,
+ * fetch a fresh one on demand instead of serving a cached one.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getMuonPriceQueryOptions(config, { quoteIds: [10n, 11n] }));
+ * ```
+ */
+export declare function getMuonPriceQueryOptions(config: Config, options: GetMuonPriceOptions): GetMuonPriceQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/muon/price/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/price/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,EAAgB,KAAK,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1G,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,sBAAsB,GAAG,kBAAkB,CAAC,sDAEjG;AAED,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,sBAAsB,GAAG,cAAc,CAAC,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CACzG,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CACvD,gBAAgB,EAChB,KAAK,EACL,gBAAgB,EAChB,oBAAoB,CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,wBAAwB,CAO/G"}

package/dist/muon/price/query.js

@@ -0,0 +1,24 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getMuonPrice as t } from "./get-muon-price.js";
+//#region src/muon/price/query.ts
+function n(t) {
+	return ["getMuonPrice", 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,
+			quoteIds: r.quoteIds
+		})
+	};
+}
+//#endregion
+export { n as getMuonPriceQueryKey, r as getMuonPriceQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/muon/price/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/price/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 { getMuonPrice, type GetMuonPriceParameters, type GetMuonPriceReturnType } from \"./get-muon-price\";\n\n/** Data resolved by the {@link getMuonPriceQueryOptions} query. */\nexport type GetMuonPriceData = GetMuonPriceReturnType;\n\n/**\n * Build the TanStack Query key for {@link getMuonPriceQueryOptions}.\n *\n * @param options - Query parameters (chain id, quote ids).\n * @returns A stable, hashable query key.\n */\nexport function getMuonPriceQueryKey(options: Compute<GetMuonPriceParameters & ConfigKeyParameter>) {\n  return [\"getMuonPrice\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getMuonPriceQueryKey}. */\nexport type GetMuonPriceQueryKey = ReturnType<typeof getMuonPriceQueryKey>;\n\n/**\n * Options accepted by {@link getMuonPriceQueryOptions}: the action's parameters,\n * an optional cache scope, and TanStack overrides.\n */\nexport type GetMuonPriceOptions = Compute<\n  GetMuonPriceParameters & QueryParameter<GetMuonPriceData, Error, GetMuonPriceData, GetMuonPriceQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getMuonPriceQueryOptions}. */\nexport type GetMuonPriceQueryOptions = SymmioQueryOptions<\n  GetMuonPriceData,\n  Error,\n  GetMuonPriceData,\n  GetMuonPriceQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getMuonPrice}.\n *\n * @remarks\n * The attestation is short-lived. If you cache it — e.g. to display the validated\n * prices — set a low `staleTime`; for a signature you intend to submit on-chain,\n * fetch a fresh one on demand instead of serving a cached one.\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(getMuonPriceQueryOptions(config, { quoteIds: [10n, 11n] }));\n * ```\n */\nexport function getMuonPriceQueryOptions(config: Config, options: GetMuonPriceOptions): GetMuonPriceQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getMuonPriceQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getMuonPrice(config, { chainId: options.chainId, quoteIds: options.quoteIds }),\n  };\n}\n"],"mappings":";;;AAeA,SAAgB,EAAqB,GAA+D;CAClG,OAAO,CAAC,gBAAgB,EAAmB,CAAO,CAAC;AACrD;AAsCA,SAAgB,EAAyB,GAAgB,GAAwD;CAC/G,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAqB;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EACnG,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAa,GAAQ;GAAE,SAAS,EAAQ;GAAS,UAAU,EAAQ;EAAS,CAAC;CAC9F;AACF"}

package/dist/muon/price-range/get-muon-price-range.d.ts

@@ -0,0 +1,82 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { MuonAttestationBase } from '../types';
+/** Parameters for {@link getMuonPriceRange}. */
+export type GetMuonPriceRangeParameters = Compute<ChainIdParameter & {
+    /** Window start in unix seconds. */
+    t0: bigint;
+    /** Window end in unix seconds. */
+    t1: bigint;
+    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) to attest. */
+    partyA: Address;
+    /** The partyB counterparty of the position. */
+    partyB: Address;
+    /** The market symbol id the range is computed for. */
+    symbolId: bigint;
+}>;
+/**
+ * Normalized `priceRange` attestation: the shared signature envelope plus the
+ * TWAP-style price-range fields used by `forceClosePosition` /
+ * `settleAndForceClosePosition` validation.
+ *
+ * @remarks
+ * TODO(muon-verify): beyond the signature envelope, the result field set/nesting
+ * is best-effort from the Muon docs and has not been checked against a live
+ * gateway; optional fields are absent when the gateway omits them.
+ */
+export interface GetMuonPriceRangeReturnType extends MuonAttestationBase {
+    /** The attested partyA. */
+    partyA: Address;
+    /** The attested partyB. */
+    partyB: Address;
+    /** The market symbol id the range was computed for. */
+    symbolId: bigint;
+    /** Window start in unix seconds (echoed by the gateway). */
+    startTime?: bigint;
+    /** Window end in unix seconds (echoed by the gateway). */
+    endTime?: bigint;
+    /** Lowest observed price across the window (18-decimal). */
+    lowest?: bigint;
+    /** Highest observed price across the window (18-decimal). */
+    highest?: bigint;
+    /** TWAP/mean price across the window (18-decimal). */
+    mean?: bigint;
+    /** Spot price at the attestation (18-decimal). */
+    price?: bigint;
+    /** PartyA's unrealized PnL at the attestation (18-decimal, signed). */
+    uPnlA?: bigint;
+    /** PartyB's unrealized PnL at the attestation (18-decimal, signed). */
+    uPnlB?: bigint;
+}
+/**
+ * Fetch a fresh Muon `priceRange` attestation for a position over the
+ * `[t0, t1]` window and normalize it to typed fields. The oracle URLs and the
+ * SYMMIO diamond address (the `symmio` request param) are resolved from
+ * `config`; gateways are tried in order until one succeeds.
+ *
+ * @remarks
+ * `priceRange` produces the TWAP-style range a partyB needs to validate a
+ * `forceClosePosition` / `settleAndForceClosePosition` against the configured
+ * gap thresholds.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Window, parties, symbol id, and optional chain id.
+ * @returns The normalized `priceRange` attestation.
+ * @throws {SymmError} when the chain is unsupported, no Muon URLs are configured,
+ *   or every oracle returns an unsuccessful or malformed attestation.
+ *
+ * @example
+ * ```ts
+ * const r = await getMuonPriceRange(config, {
+ *   t0: 1_700_000_000n,
+ *   t1: 1_700_000_900n,
+ *   partyA: "0xva…",
+ *   partyB: "0xpb…",
+ *   symbolId: 1n,
+ * });
+ * console.log(r.lowest, r.highest, r.mean);
+ * ```
+ */
+export declare function getMuonPriceRange(config: Config, parameters: GetMuonPriceRangeParameters): Promise<GetMuonPriceRangeReturnType>;
+//# sourceMappingURL=get-muon-price-range.d.ts.map

package/dist/muon/price-range/get-muon-price-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-price-range.d.ts","sourceRoot":"","sources":["../../../src/muon/price-range/get-muon-price-range.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;AAE/E,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE7E,gDAAgD;AAChD,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAC/C,gBAAgB,GAAG;IACjB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,sFAAsF;IACtF,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,2BAA2B,GACtC,OAAO,CAAC,2BAA2B,CAAC,CA0BtC"}

package/dist/muon/price-range/get-muon-price-range.js

@@ -0,0 +1,32 @@
+import { MUON_METHOD_PRICE_RANGE as e } from "../types.js";
+import { fetchMuon as t, muonBigInt as n, toMuonAttestationBase as r } from "../client.js";
+//#region src/muon/price-range/get-muon-price-range.ts
+async function i(i, a) {
+	let { chainId: o, addresses: s, muon: c } = i.getChainConfig(a.chainId), l = await t(c.urls, e, {
+		t0: a.t0.toString(),
+		t1: a.t1.toString(),
+		partyA: a.partyA,
+		partyB: a.partyB,
+		chainId: o.toString(),
+		symmio: s.symmioAddress,
+		symbolId: a.symbolId.toString()
+	}), u = l.data.result;
+	return {
+		...r(l),
+		partyA: a.partyA,
+		partyB: a.partyB,
+		symbolId: a.symbolId,
+		startTime: n(u.startTime),
+		endTime: n(u.endTime),
+		lowest: n(u.lowest),
+		highest: n(u.highest),
+		mean: n(u.mean),
+		price: n(u.price),
+		uPnlA: n(u.uPnlA),
+		uPnlB: n(u.uPnlB)
+	};
+}
+//#endregion
+export { i as getMuonPriceRange };
+
+//# sourceMappingURL=get-muon-price-range.js.map

package/dist/muon/price-range/get-muon-price-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-price-range.js","names":[],"sources":["../../../src/muon/price-range/get-muon-price-range.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { fetchMuon, muonBigInt, toMuonAttestationBase } from \"../client\";\nimport { MUON_METHOD_PRICE_RANGE, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonPriceRange}. */\nexport type GetMuonPriceRangeParameters = Compute<\n  ChainIdParameter & {\n    /** Window start in unix seconds. */\n    t0: bigint;\n    /** Window end in unix seconds. */\n    t1: bigint;\n    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) to attest. */\n    partyA: Address;\n    /** The partyB counterparty of the position. */\n    partyB: Address;\n    /** The market symbol id the range is computed for. */\n    symbolId: bigint;\n  }\n>;\n\n/**\n * Normalized `priceRange` attestation: the shared signature envelope plus the\n * TWAP-style price-range fields used by `forceClosePosition` /\n * `settleAndForceClosePosition` validation.\n *\n * @remarks\n * TODO(muon-verify): beyond the signature envelope, the result field set/nesting\n * is best-effort from the Muon docs and has not been checked against a live\n * gateway; optional fields are absent when the gateway omits them.\n */\nexport interface GetMuonPriceRangeReturnType extends MuonAttestationBase {\n  /** The attested partyA. */\n  partyA: Address;\n  /** The attested partyB. */\n  partyB: Address;\n  /** The market symbol id the range was computed for. */\n  symbolId: bigint;\n  /** Window start in unix seconds (echoed by the gateway). */\n  startTime?: bigint;\n  /** Window end in unix seconds (echoed by the gateway). */\n  endTime?: bigint;\n  /** Lowest observed price across the window (18-decimal). */\n  lowest?: bigint;\n  /** Highest observed price across the window (18-decimal). */\n  highest?: bigint;\n  /** TWAP/mean price across the window (18-decimal). */\n  mean?: bigint;\n  /** Spot price at the attestation (18-decimal). */\n  price?: bigint;\n  /** PartyA's unrealized PnL at the attestation (18-decimal, signed). */\n  uPnlA?: bigint;\n  /** PartyB's unrealized PnL at the attestation (18-decimal, signed). */\n  uPnlB?: bigint;\n}\n\n/**\n * Fetch a fresh Muon `priceRange` attestation for a position over the\n * `[t0, t1]` window and normalize it to typed fields. The oracle URLs and the\n * SYMMIO diamond address (the `symmio` request param) are resolved from\n * `config`; gateways are tried in order until one succeeds.\n *\n * @remarks\n * `priceRange` produces the TWAP-style range a partyB needs to validate a\n * `forceClosePosition` / `settleAndForceClosePosition` against the configured\n * gap thresholds.\n *\n * @param config - The SDK config.\n * @param parameters - Window, parties, symbol id, and optional chain id.\n * @returns The normalized `priceRange` attestation.\n * @throws {SymmError} when the chain is unsupported, no Muon URLs are configured,\n *   or every oracle returns an unsuccessful or malformed attestation.\n *\n * @example\n * ```ts\n * const r = await getMuonPriceRange(config, {\n *   t0: 1_700_000_000n,\n *   t1: 1_700_000_900n,\n *   partyA: \"0xva…\",\n *   partyB: \"0xpb…\",\n *   symbolId: 1n,\n * });\n * console.log(r.lowest, r.highest, r.mean);\n * ```\n */\nexport async function getMuonPriceRange(\n  config: Config,\n  parameters: GetMuonPriceRangeParameters,\n): Promise<GetMuonPriceRangeReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_PRICE_RANGE, {\n    t0: parameters.t0.toString(),\n    t1: parameters.t1.toString(),\n    partyA: parameters.partyA,\n    partyB: parameters.partyB,\n    chainId: chainId.toString(),\n    symmio: addresses.symmioAddress,\n    symbolId: parameters.symbolId.toString(),\n  });\n  const result = raw.data.result;\n  return {\n    ...toMuonAttestationBase(raw),\n    partyA: parameters.partyA,\n    partyB: parameters.partyB,\n    symbolId: parameters.symbolId,\n    startTime: muonBigInt(result.startTime),\n    endTime: muonBigInt(result.endTime),\n    lowest: muonBigInt(result.lowest),\n    highest: muonBigInt(result.highest),\n    mean: muonBigInt(result.mean),\n    price: muonBigInt(result.price),\n    uPnlA: muonBigInt(result.uPnlA),\n    uPnlB: muonBigInt(result.uPnlB),\n  };\n}\n"],"mappings":";;;AAsFA,eAAsB,EACpB,GACA,GACsC;CACtC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAyB;EAC9D,IAAI,EAAW,GAAG,SAAS;EAC3B,IAAI,EAAW,GAAG,SAAS;EAC3B,QAAQ,EAAW;EACnB,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,QAAQ,EAAU;EAClB,UAAU,EAAW,SAAS,SAAS;CACzC,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,QAAQ,EAAW;EACnB,QAAQ,EAAW;EACnB,UAAU,EAAW;EACrB,WAAW,EAAW,EAAO,SAAS;EACtC,SAAS,EAAW,EAAO,OAAO;EAClC,QAAQ,EAAW,EAAO,MAAM;EAChC,SAAS,EAAW,EAAO,OAAO;EAClC,MAAM,EAAW,EAAO,IAAI;EAC5B,OAAO,EAAW,EAAO,KAAK;EAC9B,OAAO,EAAW,EAAO,KAAK;EAC9B,OAAO,EAAW,EAAO,KAAK;CAChC;AACF"}

package/dist/muon/price-range/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-muon-price-range';
+export * from './query';
+//# sourceMappingURL=index.d.ts.map

package/dist/muon/price-range/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/muon/price-range/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC"}

package/dist/muon/price-range/query.d.ts

@@ -0,0 +1,49 @@
+import { Config } from '../../core/config';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query';
+import { GetMuonPriceRangeParameters, GetMuonPriceRangeReturnType } from './get-muon-price-range';
+/** Data resolved by the {@link getMuonPriceRangeQueryOptions} query. */
+export type GetMuonPriceRangeData = GetMuonPriceRangeReturnType;
+/**
+ * Build the TanStack Query key for {@link getMuonPriceRangeQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, window, parties, symbol id).
+ * @returns A stable, hashable query key.
+ */
+export declare function getMuonPriceRangeQueryKey(options: Compute<GetMuonPriceRangeParameters & ConfigKeyParameter>): readonly ["getMuonPriceRange", Record<string, unknown>];
+/** Query-key type produced by {@link getMuonPriceRangeQueryKey}. */
+export type GetMuonPriceRangeQueryKey = ReturnType<typeof getMuonPriceRangeQueryKey>;
+/**
+ * Options accepted by {@link getMuonPriceRangeQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetMuonPriceRangeOptions = Compute<GetMuonPriceRangeParameters & QueryParameter<GetMuonPriceRangeData, Error, GetMuonPriceRangeData, GetMuonPriceRangeQueryKey>>;
+/** TanStack Query options returned by {@link getMuonPriceRangeQueryOptions}. */
+export type GetMuonPriceRangeQueryOptions = SymmioQueryOptions<GetMuonPriceRangeData, Error, GetMuonPriceRangeData, GetMuonPriceRangeQueryKey>;
+/**
+ * Build TanStack Query options for {@link getMuonPriceRange}.
+ *
+ * @remarks
+ * The attestation is short-lived. If you cache it — e.g. to display the attested
+ * range — set a low `staleTime`; for a signature you intend to submit on-chain,
+ * fetch a fresh one on demand instead of serving a cached one.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(
+ *   getMuonPriceRangeQueryOptions(config, {
+ *     t0: 1_700_000_000n,
+ *     t1: 1_700_000_900n,
+ *     partyA: "0xva…",
+ *     partyB: "0xpb…",
+ *     symbolId: 1n,
+ *   }),
+ * );
+ * ```
+ */
+export declare function getMuonPriceRangeQueryOptions(config: Config, options: GetMuonPriceRangeOptions): GetMuonPriceRangeQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/muon/price-range/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/price-range/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,2BAA2B,EAChC,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAEhC,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,GAAG,kBAAkB,CAAC,2DAE3G;AAED,oEAAoE;AACpE,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,2BAA2B,GACzB,cAAc,CAAC,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,CAAC,CACjG,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,CAC5D,qBAAqB,EACrB,KAAK,EACL,qBAAqB,EACrB,yBAAyB,CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAChC,6BAA6B,CAe/B"}