@symmio/trading-core 0.1.0

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

@@ -0,0 +1,28 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getMuonPriceRange as t } from "./get-muon-price-range.js";
+//#region src/muon/price-range/query.ts
+function n(t) {
+	return ["getMuonPriceRange", 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,
+			t0: r.t0,
+			t1: r.t1,
+			partyA: r.partyA,
+			partyB: r.partyB,
+			symbolId: r.symbolId
+		})
+	};
+}
+//#endregion
+export { n as getMuonPriceRangeQueryKey, r as getMuonPriceRangeQueryOptions };
+
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/price-range/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  getMuonPriceRange,\n  type GetMuonPriceRangeParameters,\n  type GetMuonPriceRangeReturnType,\n} from \"./get-muon-price-range\";\n\n/** Data resolved by the {@link getMuonPriceRangeQueryOptions} query. */\nexport type GetMuonPriceRangeData = GetMuonPriceRangeReturnType;\n\n/**\n * Build the TanStack Query key for {@link getMuonPriceRangeQueryOptions}.\n *\n * @param options - Query parameters (chain id, window, parties, symbol id).\n * @returns A stable, hashable query key.\n */\nexport function getMuonPriceRangeQueryKey(options: Compute<GetMuonPriceRangeParameters & ConfigKeyParameter>) {\n  return [\"getMuonPriceRange\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getMuonPriceRangeQueryKey}. */\nexport type GetMuonPriceRangeQueryKey = ReturnType<typeof getMuonPriceRangeQueryKey>;\n\n/**\n * Options accepted by {@link getMuonPriceRangeQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetMuonPriceRangeOptions = Compute<\n  GetMuonPriceRangeParameters &\n    QueryParameter<GetMuonPriceRangeData, Error, GetMuonPriceRangeData, GetMuonPriceRangeQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getMuonPriceRangeQueryOptions}. */\nexport type GetMuonPriceRangeQueryOptions = SymmioQueryOptions<\n  GetMuonPriceRangeData,\n  Error,\n  GetMuonPriceRangeData,\n  GetMuonPriceRangeQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getMuonPriceRange}.\n *\n * @remarks\n * The attestation is short-lived. If you cache it — e.g. to display the attested\n * range — 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(\n *   getMuonPriceRangeQueryOptions(config, {\n *     t0: 1_700_000_000n,\n *     t1: 1_700_000_900n,\n *     partyA: \"0xva…\",\n *     partyB: \"0xpb…\",\n *     symbolId: 1n,\n *   }),\n * );\n * ```\n */\nexport function getMuonPriceRangeQueryOptions(\n  config: Config,\n  options: GetMuonPriceRangeOptions,\n): GetMuonPriceRangeQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getMuonPriceRangeQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getMuonPriceRange(config, {\n        chainId: options.chainId,\n        t0: options.t0,\n        t1: options.t1,\n        partyA: options.partyA,\n        partyB: options.partyB,\n        symbolId: options.symbolId,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA0B,GAAoE;CAC5G,OAAO,CAAC,qBAAqB,EAAmB,CAAO,CAAC;AAC1D;AA+CA,SAAgB,EACd,GACA,GAC+B;CAC/B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA0B;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EACxG,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAkB,GAAQ;GACxB,SAAS,EAAQ;GACjB,IAAI,EAAQ;GACZ,IAAI,EAAQ;GACZ,QAAQ,EAAQ;GAChB,QAAQ,EAAQ;GAChB,UAAU,EAAQ;EACpB,CAAC;CACL;AACF"}

package/dist/muon/settle-upnl/get-muon-settle-upnl.d.ts

@@ -0,0 +1,55 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { MuonAttestationBase } from '../types';
+/** Parameters for {@link getMuonSettleUpnl}. */
+export type GetMuonSettleUpnlParameters = Compute<ChainIdParameter & {
+    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) whose quotes to settle. */
+    partyA: Address;
+    /** Quote ids to include in the settlement attestation. */
+    quoteIds: readonly bigint[];
+}>;
+/**
+ * Normalized `settle_upnl` attestation: the shared signature envelope plus the
+ * partyA's settlement uPnL fields for the requested quotes.
+ *
+ * @remarks
+ * Verified against the live gateway: `settle_upnl` returns `uPnlA` plus a nested
+ * `quoteSettlementData` (rows of `[quoteId, price, …]`) that is intentionally not
+ * typed here yet. `notionalValueSumA` stays optional (absent when omitted).
+ */
+export interface GetMuonSettleUpnlReturnType extends MuonAttestationBase {
+    /** The attested partyA. */
+    partyA: Address;
+    /** Quote ids included in the attestation. */
+    quoteIds: bigint[];
+    /** Signed unrealized PnL for partyA (18-decimal, signed). */
+    uPnlA?: bigint;
+    /** Sum of notional values across partyA's settled positions. */
+    notionalValueSumA?: bigint;
+}
+/**
+ * Fetch a fresh Muon `settle_upnl` attestation for `partyA` over `quoteIds` 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
+ * Produces the uPnL settlement data that `settleUpnl` requires. The per-quote
+ * settlement data is omitted from the normalized result for now (see the
+ * TODO(muon-verify) note on {@link GetMuonSettleUpnlReturnType}).
+ *
+ * @param config - The SDK config.
+ * @param parameters - PartyA address, quote ids, and optional chain id.
+ * @returns The normalized `settle_upnl` 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 s = await getMuonSettleUpnl(config, { partyA: "0xva…", quoteIds: [10n, 11n] });
+ * console.log(s.uPnlA, s.quoteIds);
+ * ```
+ */
+export declare function getMuonSettleUpnl(config: Config, parameters: GetMuonSettleUpnlParameters): Promise<GetMuonSettleUpnlReturnType>;
+//# sourceMappingURL=get-muon-settle-upnl.d.ts.map

package/dist/muon/settle-upnl/get-muon-settle-upnl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-settle-upnl.d.ts","sourceRoot":"","sources":["../../../src/muon/settle-upnl/get-muon-settle-upnl.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,mGAAmG;IACnG,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,2BAA2B,GACtC,OAAO,CAAC,2BAA2B,CAAC,CAgBtC"}

package/dist/muon/settle-upnl/get-muon-settle-upnl.js

@@ -0,0 +1,22 @@
+import { MUON_METHOD_SETTLE_UPNL as e } from "../types.js";
+import { fetchMuon as t, muonBigInt as n, muonBigIntArray as r, toMuonArrayParam as i, toMuonAttestationBase as a } from "../client.js";
+//#region src/muon/settle-upnl/get-muon-settle-upnl.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,
+		quoteIds: i(s.quoteIds)
+	}), f = d.data.result;
+	return {
+		...a(d),
+		partyA: s.partyA,
+		quoteIds: r(f.quoteIds),
+		uPnlA: n(f.uPnlA),
+		notionalValueSumA: n(f.notionalValueSumA)
+	};
+}
+//#endregion
+export { o as getMuonSettleUpnl };
+
+//# sourceMappingURL=get-muon-settle-upnl.js.map

package/dist/muon/settle-upnl/get-muon-settle-upnl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-settle-upnl.js","names":[],"sources":["../../../src/muon/settle-upnl/get-muon-settle-upnl.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, toMuonArrayParam, toMuonAttestationBase } from \"../client\";\nimport { MUON_METHOD_SETTLE_UPNL, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonSettleUpnl}. */\nexport type GetMuonSettleUpnlParameters = Compute<\n  ChainIdParameter & {\n    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) whose quotes to settle. */\n    partyA: Address;\n    /** Quote ids to include in the settlement attestation. */\n    quoteIds: readonly bigint[];\n  }\n>;\n\n/**\n * Normalized `settle_upnl` attestation: the shared signature envelope plus the\n * partyA's settlement uPnL fields for the requested quotes.\n *\n * @remarks\n * Verified against the live gateway: `settle_upnl` returns `uPnlA` plus a nested\n * `quoteSettlementData` (rows of `[quoteId, price, …]`) that is intentionally not\n * typed here yet. `notionalValueSumA` stays optional (absent when omitted).\n */\nexport interface GetMuonSettleUpnlReturnType extends MuonAttestationBase {\n  /** The attested partyA. */\n  partyA: Address;\n  /** Quote ids included in the attestation. */\n  quoteIds: bigint[];\n  /** Signed unrealized PnL for partyA (18-decimal, signed). */\n  uPnlA?: bigint;\n  /** Sum of notional values across partyA's settled positions. */\n  notionalValueSumA?: bigint;\n}\n\n/**\n * Fetch a fresh Muon `settle_upnl` attestation for `partyA` over `quoteIds` and\n * normalize it to typed fields. The oracle URLs and the SYMMIO diamond address\n * (the `symmio` request param) are resolved from `config`; gateways are tried in\n * order until one succeeds.\n *\n * @remarks\n * Produces the uPnL settlement data that `settleUpnl` requires. The per-quote\n * settlement data is omitted from the normalized result for now (see the\n * TODO(muon-verify) note on {@link GetMuonSettleUpnlReturnType}).\n *\n * @param config - The SDK config.\n * @param parameters - PartyA address, quote ids, and optional chain id.\n * @returns The normalized `settle_upnl` 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 s = await getMuonSettleUpnl(config, { partyA: \"0xva…\", quoteIds: [10n, 11n] });\n * console.log(s.uPnlA, s.quoteIds);\n * ```\n */\nexport async function getMuonSettleUpnl(\n  config: Config,\n  parameters: GetMuonSettleUpnlParameters,\n): Promise<GetMuonSettleUpnlReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_SETTLE_UPNL, {\n    partyA: parameters.partyA,\n    chainId: chainId.toString(),\n    symmio: addresses.symmioAddress,\n    quoteIds: toMuonArrayParam(parameters.quoteIds),\n  });\n  const result = raw.data.result;\n  return {\n    ...toMuonAttestationBase(raw),\n    partyA: parameters.partyA,\n    quoteIds: muonBigIntArray(result.quoteIds),\n    uPnlA: muonBigInt(result.uPnlA),\n    notionalValueSumA: muonBigInt(result.notionalValueSumA),\n  };\n}\n"],"mappings":";;;AA2DA,eAAsB,EACpB,GACA,GACsC;CACtC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAyB;EAC9D,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,QAAQ,EAAU;EAClB,UAAU,EAAiB,EAAW,QAAQ;CAChD,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,QAAQ,EAAW;EACnB,UAAU,EAAgB,EAAO,QAAQ;EACzC,OAAO,EAAW,EAAO,KAAK;EAC9B,mBAAmB,EAAW,EAAO,iBAAiB;CACxD;AACF"}

package/dist/muon/settle-upnl/index.d.ts

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

package/dist/muon/settle-upnl/index.d.ts.map

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

package/dist/muon/settle-upnl/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 { GetMuonSettleUpnlParameters, GetMuonSettleUpnlReturnType } from './get-muon-settle-upnl';
+/** Data resolved by the {@link getMuonSettleUpnlQueryOptions} query. */
+export type GetMuonSettleUpnlData = GetMuonSettleUpnlReturnType;
+/**
+ * Build the TanStack Query key for {@link getMuonSettleUpnlQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, partyA, quote ids).
+ * @returns A stable, hashable query key.
+ */
+export declare function getMuonSettleUpnlQueryKey(options: Compute<GetMuonSettleUpnlParameters & ConfigKeyParameter>): readonly ["getMuonSettleUpnl", Record<string, unknown>];
+/** Query-key type produced by {@link getMuonSettleUpnlQueryKey}. */
+export type GetMuonSettleUpnlQueryKey = ReturnType<typeof getMuonSettleUpnlQueryKey>;
+/**
+ * Options accepted by {@link getMuonSettleUpnlQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetMuonSettleUpnlOptions = Compute<GetMuonSettleUpnlParameters & QueryParameter<GetMuonSettleUpnlData, Error, GetMuonSettleUpnlData, GetMuonSettleUpnlQueryKey>>;
+/** TanStack Query options returned by {@link getMuonSettleUpnlQueryOptions}. */
+export type GetMuonSettleUpnlQueryOptions = SymmioQueryOptions<GetMuonSettleUpnlData, Error, GetMuonSettleUpnlData, GetMuonSettleUpnlQueryKey>;
+/**
+ * Build TanStack Query options for {@link getMuonSettleUpnl}.
+ *
+ * @remarks
+ * The attestation is short-lived. If you cache it — e.g. to display the settled
+ * uPnL — 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(getMuonSettleUpnlQueryOptions(config, { partyA: "0xva…", quoteIds: [10n] }));
+ * ```
+ */
+export declare function getMuonSettleUpnlQueryOptions(config: Config, options: GetMuonSettleUpnlOptions): GetMuonSettleUpnlQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/muon/settle-upnl/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/settle-upnl/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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAChC,6BAA6B,CAQ/B"}

package/dist/muon/settle-upnl/query.js

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

package/dist/muon/settle-upnl/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/settle-upnl/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  getMuonSettleUpnl,\n  type GetMuonSettleUpnlParameters,\n  type GetMuonSettleUpnlReturnType,\n} from \"./get-muon-settle-upnl\";\n\n/** Data resolved by the {@link getMuonSettleUpnlQueryOptions} query. */\nexport type GetMuonSettleUpnlData = GetMuonSettleUpnlReturnType;\n\n/**\n * Build the TanStack Query key for {@link getMuonSettleUpnlQueryOptions}.\n *\n * @param options - Query parameters (chain id, partyA, quote ids).\n * @returns A stable, hashable query key.\n */\nexport function getMuonSettleUpnlQueryKey(options: Compute<GetMuonSettleUpnlParameters & ConfigKeyParameter>) {\n  return [\"getMuonSettleUpnl\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getMuonSettleUpnlQueryKey}. */\nexport type GetMuonSettleUpnlQueryKey = ReturnType<typeof getMuonSettleUpnlQueryKey>;\n\n/**\n * Options accepted by {@link getMuonSettleUpnlQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetMuonSettleUpnlOptions = Compute<\n  GetMuonSettleUpnlParameters &\n    QueryParameter<GetMuonSettleUpnlData, Error, GetMuonSettleUpnlData, GetMuonSettleUpnlQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getMuonSettleUpnlQueryOptions}. */\nexport type GetMuonSettleUpnlQueryOptions = SymmioQueryOptions<\n  GetMuonSettleUpnlData,\n  Error,\n  GetMuonSettleUpnlData,\n  GetMuonSettleUpnlQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getMuonSettleUpnl}.\n *\n * @remarks\n * The attestation is short-lived. If you cache it — e.g. to display the settled\n * uPnL — 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(getMuonSettleUpnlQueryOptions(config, { partyA: \"0xva…\", quoteIds: [10n] }));\n * ```\n */\nexport function getMuonSettleUpnlQueryOptions(\n  config: Config,\n  options: GetMuonSettleUpnlOptions,\n): GetMuonSettleUpnlQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getMuonSettleUpnlQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getMuonSettleUpnl(config, { chainId: options.chainId, partyA: options.partyA, quoteIds: options.quoteIds }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA0B,GAAoE;CAC5G,OAAO,CAAC,qBAAqB,EAAmB,CAAO,CAAC;AAC1D;AAuCA,SAAgB,EACd,GACA,GAC+B;CAC/B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA0B;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EACxG,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAkB,GAAQ;GAAE,SAAS,EAAQ;GAAS,QAAQ,EAAQ;GAAQ,UAAU,EAAQ;EAAS,CAAC;CAC9G;AACF"}

package/dist/muon/types.d.ts

@@ -0,0 +1,103 @@
+import { Address, Hex } from 'viem';
+/**
+ * App name registered for SYMMIO on the Muon network. Every Muon request carries
+ * `app=symmio`.
+ *
+ * @see {@link https://docs.symm.io/api-endpoints-and-deployments/muon-api}
+ */
+export declare const MUON_APP = "symmio";
+/**
+ * Muon app methods, one per documented `symmio` endpoint. The wire string is the
+ * `method` query param.
+ *
+ * @remarks
+ * TODO(muon-verify): only `uPnl_A`'s exact casing and response nesting are
+ * verified (against Vibe-ui's parser). The other method strings and their
+ * normalized result fields are typed best-effort from the Muon API docs and may
+ * need correction once checked against a live gateway.
+ *
+ * @see {@link https://docs.symm.io/api-endpoints-and-deployments/muon-api}
+ */
+/** `uPnl_A` — a partyA's unrealized-PnL attestation (the one `removeMargin` requires). */
+export declare const MUON_METHOD_UPNL_A = "uPnl_A";
+/** `partyA_overview` — partyA liquidation overview; produces a `LiquidationSig`. */
+export declare const MUON_METHOD_PARTY_A_OVERVIEW = "partyA_overview";
+/** `uPnl_A_withSymbolPrice` — partyA uPnL plus a single symbol price. */
+export declare const MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE = "uPnl_A_withSymbolPrice";
+/** `uPnl_B` — a partyB's unrealized-PnL attestation against a partyA. */
+export declare const MUON_METHOD_UPNL_B = "uPnl_B";
+/** `uPnl` — combined partyA + partyB unrealized PnL in one attestation. */
+export declare const MUON_METHOD_UPNL_PAIR = "uPnl";
+/** `uPnlWithSymbolPrice` — combined partyA + partyB uPnL plus a single symbol price. */
+export declare const MUON_METHOD_UPNL_WITH_SYMBOL_PRICE = "uPnlWithSymbolPrice";
+/** `price` — validated prices for a set of quote ids. */
+export declare const MUON_METHOD_PRICE = "price";
+/** `settle_upnl` — uPnL settlement data for a partyA's quotes. */
+export declare const MUON_METHOD_SETTLE_UPNL = "settle_upnl";
+/** `priceRange` — TWAP-style price range over a window for force-close validation. */
+export declare const MUON_METHOD_PRICE_RANGE = "priceRange";
+/**
+ * Generic Muon response envelope.
+ *
+ * @remarks
+ * The Muon gateway exposes no OpenAPI/Swagger spec, so these types are
+ * hand-written from the API docs + Vibe-ui's response parser. See the
+ * TODO(muon-verify) note on {@link MUON_METHOD_UPNL_A}.
+ *
+ * @see {@link https://docs.symm.io/api-endpoints-and-deployments/muon-api}
+ */
+export interface MuonResponse {
+    /** `true` when the oracle produced a valid attestation. */
+    success: boolean;
+    /** The attestation payload (present when `success`). */
+    result: MuonRawResult;
+}
+/**
+ * The raw `result` object inside a {@link MuonResponse}, before method-specific
+ * normalization. The `data.result` map's fields vary per method.
+ */
+export interface MuonRawResult {
+    /** Opaque Muon request id. */
+    reqId: Hex;
+    /** Attested data plus replay-protection metadata. */
+    data: {
+        /** Attestation timestamp in seconds. */
+        timestamp: number;
+        /** Method-specific computed fields (e.g. `uPnl`, `price`, `quoteIds`). */
+        result: Record<string, unknown>;
+        /** Initialization metadata. */
+        init: {
+            /** Replay-protection nonce address. */
+            nonceAddress: Address;
+        };
+    };
+    /** Muon gateway (node) signature. */
+    nodeSignature: Hex;
+    /**
+     * Schnorr signature shares. Index `0` carries the aggregated `signature`
+     * (a `uint256` encoded as a hex string) and the signer `owner` address.
+     */
+    signatures: Array<{
+        signature: Hex;
+        owner: Address;
+    }>;
+}
+/**
+ * The replay-protection + signature envelope shared by every normalized Muon
+ * attestation. Method results extend this with their own computed fields.
+ */
+export interface MuonAttestationBase {
+    /** Opaque Muon request id. */
+    reqId: Hex;
+    /** Attestation timestamp in seconds. */
+    timestamp: bigint;
+    /** Replay-protection nonce address (`data.init.nonceAddress`). */
+    nonce: Address;
+    /** Signer owner address (`signatures[0].owner`). */
+    owner: Address;
+    /** Aggregated Schnorr signature as `uint256` (`signatures[0].signature`). */
+    signature: bigint;
+    /** Muon gateway (node) signature (`nodeSignature`). */
+    gatewaySignature: Hex;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/muon/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,WAAW,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAC3C,oFAAoF;AACpF,eAAO,MAAM,4BAA4B,oBAAoB,CAAC;AAC9D,yEAAyE;AACzE,eAAO,MAAM,oCAAoC,2BAA2B,CAAC;AAC7E,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAC3C,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,wFAAwF;AACxF,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AACxE,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AACrD,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,KAAK,EAAE,GAAG,CAAC;IACX,qDAAqD;IACrD,IAAI,EAAE;QACJ,wCAAwC;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,0EAA0E;QAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,+BAA+B;QAC/B,IAAI,EAAE;YACJ,uCAAuC;YACvC,YAAY,EAAE,OAAO,CAAC;SACvB,CAAC;KACH,CAAC;IACF,qCAAqC;IACrC,aAAa,EAAE,GAAG,CAAC;IACnB;;;OAGG;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,KAAK,EAAE,GAAG,CAAC;IACX,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,gBAAgB,EAAE,GAAG,CAAC;CACvB"}

package/dist/muon/types.js

@@ -0,0 +1,6 @@
+//#region src/muon/types.ts
+var e = "symmio", t = "uPnl_A", n = "partyA_overview", r = "uPnl_A_withSymbolPrice", i = "uPnl_B", a = "uPnl", o = "uPnlWithSymbolPrice", s = "price", c = "settle_upnl", l = "priceRange";
+//#endregion
+export { e as MUON_APP, n as MUON_METHOD_PARTY_A_OVERVIEW, s as MUON_METHOD_PRICE, l as MUON_METHOD_PRICE_RANGE, c as MUON_METHOD_SETTLE_UPNL, t as MUON_METHOD_UPNL_A, r as MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE, i as MUON_METHOD_UPNL_B, a as MUON_METHOD_UPNL_PAIR, o as MUON_METHOD_UPNL_WITH_SYMBOL_PRICE };
+
+//# sourceMappingURL=types.js.map

package/dist/muon/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/muon/types.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\n\n/**\n * App name registered for SYMMIO on the Muon network. Every Muon request carries\n * `app=symmio`.\n *\n * @see {@link https://docs.symm.io/api-endpoints-and-deployments/muon-api}\n */\nexport const MUON_APP = \"symmio\";\n\n/**\n * Muon app methods, one per documented `symmio` endpoint. The wire string is the\n * `method` query param.\n *\n * @remarks\n * TODO(muon-verify): only `uPnl_A`'s exact casing and response nesting are\n * verified (against Vibe-ui's parser). The other method strings and their\n * normalized result fields are typed best-effort from the Muon API docs and may\n * need correction once checked against a live gateway.\n *\n * @see {@link https://docs.symm.io/api-endpoints-and-deployments/muon-api}\n */\n/** `uPnl_A` — a partyA's unrealized-PnL attestation (the one `removeMargin` requires). */\nexport const MUON_METHOD_UPNL_A = \"uPnl_A\";\n/** `partyA_overview` — partyA liquidation overview; produces a `LiquidationSig`. */\nexport const MUON_METHOD_PARTY_A_OVERVIEW = \"partyA_overview\";\n/** `uPnl_A_withSymbolPrice` — partyA uPnL plus a single symbol price. */\nexport const MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE = \"uPnl_A_withSymbolPrice\";\n/** `uPnl_B` — a partyB's unrealized-PnL attestation against a partyA. */\nexport const MUON_METHOD_UPNL_B = \"uPnl_B\";\n/** `uPnl` — combined partyA + partyB unrealized PnL in one attestation. */\nexport const MUON_METHOD_UPNL_PAIR = \"uPnl\";\n/** `uPnlWithSymbolPrice` — combined partyA + partyB uPnL plus a single symbol price. */\nexport const MUON_METHOD_UPNL_WITH_SYMBOL_PRICE = \"uPnlWithSymbolPrice\";\n/** `price` — validated prices for a set of quote ids. */\nexport const MUON_METHOD_PRICE = \"price\";\n/** `settle_upnl` — uPnL settlement data for a partyA's quotes. */\nexport const MUON_METHOD_SETTLE_UPNL = \"settle_upnl\";\n/** `priceRange` — TWAP-style price range over a window for force-close validation. */\nexport const MUON_METHOD_PRICE_RANGE = \"priceRange\";\n\n/**\n * Generic Muon response envelope.\n *\n * @remarks\n * The Muon gateway exposes no OpenAPI/Swagger spec, so these types are\n * hand-written from the API docs + Vibe-ui's response parser. See the\n * TODO(muon-verify) note on {@link MUON_METHOD_UPNL_A}.\n *\n * @see {@link https://docs.symm.io/api-endpoints-and-deployments/muon-api}\n */\nexport interface MuonResponse {\n  /** `true` when the oracle produced a valid attestation. */\n  success: boolean;\n  /** The attestation payload (present when `success`). */\n  result: MuonRawResult;\n}\n\n/**\n * The raw `result` object inside a {@link MuonResponse}, before method-specific\n * normalization. The `data.result` map's fields vary per method.\n */\nexport interface MuonRawResult {\n  /** Opaque Muon request id. */\n  reqId: Hex;\n  /** Attested data plus replay-protection metadata. */\n  data: {\n    /** Attestation timestamp in seconds. */\n    timestamp: number;\n    /** Method-specific computed fields (e.g. `uPnl`, `price`, `quoteIds`). */\n    result: Record<string, unknown>;\n    /** Initialization metadata. */\n    init: {\n      /** Replay-protection nonce address. */\n      nonceAddress: Address;\n    };\n  };\n  /** Muon gateway (node) signature. */\n  nodeSignature: Hex;\n  /**\n   * Schnorr signature shares. Index `0` carries the aggregated `signature`\n   * (a `uint256` encoded as a hex string) and the signer `owner` address.\n   */\n  signatures: Array<{ signature: Hex; owner: Address }>;\n}\n\n/**\n * The replay-protection + signature envelope shared by every normalized Muon\n * attestation. Method results extend this with their own computed fields.\n */\nexport interface MuonAttestationBase {\n  /** Opaque Muon request id. */\n  reqId: Hex;\n  /** Attestation timestamp in seconds. */\n  timestamp: bigint;\n  /** Replay-protection nonce address (`data.init.nonceAddress`). */\n  nonce: Address;\n  /** Signer owner address (`signatures[0].owner`). */\n  owner: Address;\n  /** Aggregated Schnorr signature as `uint256` (`signatures[0].signature`). */\n  signature: bigint;\n  /** Muon gateway (node) signature (`nodeSignature`). */\n  gatewaySignature: Hex;\n}\n"],"mappings":";AAQA,IAAa,IAAW,UAeX,IAAqB,UAErB,IAA+B,mBAE/B,IAAuC,0BAEvC,IAAqB,UAErB,IAAwB,QAExB,IAAqC,uBAErC,IAAoB,SAEpB,IAA0B,eAE1B,IAA0B"}

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

@@ -0,0 +1,63 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { MuonAttestationBase } from '../types';
+/** Parameters for {@link getMuonUpnl}. */
+export type GetMuonUpnlParameters = Compute<ChainIdParameter & {
+    /** The partyB (solver/hedger) side of the pair to attest. */
+    partyB: Address;
+    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) to attest. */
+    partyA: Address;
+}>;
+/**
+ * Normalized `uPnl` attestation: the shared signature envelope plus the combined
+ * partyA + partyB unrealized-PnL fields, with a per-party breakdown.
+ *
+ * @remarks
+ * TODO(muon-verify): beyond the shared signature envelope, the field set/nesting
+ * is best-effort from the Muon docs; optional fields are absent when the gateway
+ * omits them.
+ */
+export interface GetMuonUpnlReturnType extends MuonAttestationBase {
+    /** The attested partyB. */
+    partyB: Address;
+    /** The attested partyA. */
+    partyA: Address;
+    /** PartyA's signed unrealized PnL (18-decimal, signed). */
+    uPnlA?: bigint;
+    /** PartyB's signed unrealized PnL (18-decimal, signed). */
+    uPnlB?: bigint;
+    /** Sum of notional values across the partyA's positions. */
+    notionalValueSumA?: bigint;
+    /** Sum of notional values across the partyB's positions. */
+    notionalValueSumB?: bigint;
+    /** Quote ids included in the partyA side of the attestation. */
+    quoteIdsA: bigint[];
+    /** Quote ids included in the partyB side of the attestation. */
+    quoteIdsB: bigint[];
+}
+/**
+ * Fetch a fresh Muon `uPnl` attestation for a `partyB` / `partyA` pair 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
+ * Returns the combined attestation: partyA and partyB uPnL in one response, with
+ * a per-party breakdown. For a single-party uPnL use `getMuonUpnlA` /
+ * `getMuonUpnlB` instead.
+ *
+ * @param config - The SDK config.
+ * @param parameters - PartyB and partyA addresses and optional chain id.
+ * @returns The normalized `uPnl` 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 a = await getMuonUpnl(config, { partyB: "0xb…", partyA: "0xva…" });
+ * console.log(a.uPnlA, a.uPnlB);
+ * ```
+ */
+export declare function getMuonUpnl(config: Config, parameters: GetMuonUpnlParameters): Promise<GetMuonUpnlReturnType>;
+//# sourceMappingURL=get-muon-upnl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-upnl.d.ts","sourceRoot":"","sources":["../../../src/muon/upnl/get-muon-upnl.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,EAAyB,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE3E,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,gBAAgB,GAAG;IACjB,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,sFAAsF;IACtF,MAAM,EAAE,OAAO,CAAC;CACjB,CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gEAAgE;IAChE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoBnH"}

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

@@ -0,0 +1,26 @@
+import { MUON_METHOD_UPNL_PAIR as e } from "../types.js";
+import { fetchMuon as t, muonBigInt as n, muonBigIntArray as r, toMuonAttestationBase as i } from "../client.js";
+//#region src/muon/upnl/get-muon-upnl.ts
+async function a(a, o) {
+	let { chainId: s, addresses: c, muon: l } = a.getChainConfig(o.chainId), u = await t(l.urls, e, {
+		partyB: o.partyB,
+		partyA: o.partyA,
+		chainId: s.toString(),
+		symmio: c.symmioAddress
+	}), d = u.data.result;
+	return {
+		...i(u),
+		partyB: o.partyB,
+		partyA: o.partyA,
+		uPnlA: n(d.uPnlA),
+		uPnlB: n(d.uPnlB),
+		notionalValueSumA: n(d.notionalValueSumA),
+		notionalValueSumB: n(d.notionalValueSumB),
+		quoteIdsA: r(d.quoteIdsA),
+		quoteIdsB: r(d.quoteIdsB)
+	};
+}
+//#endregion
+export { a as getMuonUpnl };
+
+//# sourceMappingURL=get-muon-upnl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-upnl.js","names":[],"sources":["../../../src/muon/upnl/get-muon-upnl.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, toMuonAttestationBase } from \"../client\";\nimport { MUON_METHOD_UPNL_PAIR, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnl}. */\nexport type GetMuonUpnlParameters = Compute<\n  ChainIdParameter & {\n    /** The partyB (solver/hedger) side of the pair to attest. */\n    partyB: Address;\n    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) to attest. */\n    partyA: Address;\n  }\n>;\n\n/**\n * Normalized `uPnl` attestation: the shared signature envelope plus the combined\n * partyA + partyB unrealized-PnL fields, with a per-party breakdown.\n *\n * @remarks\n * TODO(muon-verify): beyond the shared signature envelope, 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 GetMuonUpnlReturnType extends MuonAttestationBase {\n  /** The attested partyB. */\n  partyB: Address;\n  /** The attested partyA. */\n  partyA: Address;\n  /** PartyA's signed unrealized PnL (18-decimal, signed). */\n  uPnlA?: bigint;\n  /** PartyB's signed unrealized PnL (18-decimal, signed). */\n  uPnlB?: bigint;\n  /** Sum of notional values across the partyA's positions. */\n  notionalValueSumA?: bigint;\n  /** Sum of notional values across the partyB's positions. */\n  notionalValueSumB?: bigint;\n  /** Quote ids included in the partyA side of the attestation. */\n  quoteIdsA: bigint[];\n  /** Quote ids included in the partyB side of the attestation. */\n  quoteIdsB: bigint[];\n}\n\n/**\n * Fetch a fresh Muon `uPnl` attestation for a `partyB` / `partyA` pair and\n * normalize it to typed fields. The oracle URLs and the SYMMIO diamond address\n * (the `symmio` request param) are resolved from `config`; gateways are tried in\n * order until one succeeds.\n *\n * @remarks\n * Returns the combined attestation: partyA and partyB uPnL in one response, with\n * a per-party breakdown. For a single-party uPnL use `getMuonUpnlA` /\n * `getMuonUpnlB` instead.\n *\n * @param config - The SDK config.\n * @param parameters - PartyB and partyA addresses and optional chain id.\n * @returns The normalized `uPnl` 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 a = await getMuonUpnl(config, { partyB: \"0xb…\", partyA: \"0xva…\" });\n * console.log(a.uPnlA, a.uPnlB);\n * ```\n */\nexport async function getMuonUpnl(config: Config, parameters: GetMuonUpnlParameters): Promise<GetMuonUpnlReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_PAIR, {\n    partyB: parameters.partyB,\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    partyB: parameters.partyB,\n    partyA: parameters.partyA,\n    uPnlA: muonBigInt(result.uPnlA),\n    uPnlB: muonBigInt(result.uPnlB),\n    notionalValueSumA: muonBigInt(result.notionalValueSumA),\n    notionalValueSumB: muonBigInt(result.notionalValueSumB),\n    quoteIdsA: muonBigIntArray(result.quoteIdsA),\n    quoteIdsB: muonBigIntArray(result.quoteIdsB),\n  };\n}\n"],"mappings":";;;AAmEA,eAAsB,EAAY,GAAgB,GAAmE;CACnH,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAuB;EAC5D,QAAQ,EAAW;EACnB,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,QAAQ,EAAW;EACnB,OAAO,EAAW,EAAO,KAAK;EAC9B,OAAO,EAAW,EAAO,KAAK;EAC9B,mBAAmB,EAAW,EAAO,iBAAiB;EACtD,mBAAmB,EAAW,EAAO,iBAAiB;EACtD,WAAW,EAAgB,EAAO,SAAS;EAC3C,WAAW,EAAgB,EAAO,SAAS;CAC7C;AACF"}

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

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

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

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

package/dist/muon/upnl/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 { GetMuonUpnlParameters, GetMuonUpnlReturnType } from './get-muon-upnl';
+/** Data resolved by the {@link getMuonUpnlQueryOptions} query. */
+export type GetMuonUpnlData = GetMuonUpnlReturnType;
+/**
+ * Build the TanStack Query key for {@link getMuonUpnlQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, partyB, partyA).
+ * @returns A stable, hashable query key.
+ */
+export declare function getMuonUpnlQueryKey(options: Compute<GetMuonUpnlParameters & ConfigKeyParameter>): readonly ["getMuonUpnl", Record<string, unknown>];
+/** Query-key type produced by {@link getMuonUpnlQueryKey}. */
+export type GetMuonUpnlQueryKey = ReturnType<typeof getMuonUpnlQueryKey>;
+/**
+ * Options accepted by {@link getMuonUpnlQueryOptions}: the action's parameters,
+ * an optional cache scope, and TanStack overrides.
+ */
+export type GetMuonUpnlOptions = Compute<GetMuonUpnlParameters & QueryParameter<GetMuonUpnlData, Error, GetMuonUpnlData, GetMuonUpnlQueryKey>>;
+/** TanStack Query options returned by {@link getMuonUpnlQueryOptions}. */
+export type GetMuonUpnlQueryOptions = SymmioQueryOptions<GetMuonUpnlData, Error, GetMuonUpnlData, GetMuonUpnlQueryKey>;
+/**
+ * Build TanStack Query options for {@link getMuonUpnl}.
+ *
+ * @remarks
+ * The attestation is short-lived. If you cache it — e.g. to display the attested
+ * uPnL — 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(getMuonUpnlQueryOptions(config, { partyB: "0xb…", partyA: "0xva…" }));
+ * ```
+ */
+export declare function getMuonUpnlQueryOptions(config: Config, options: GetMuonUpnlOptions): GetMuonUpnlQueryOptions;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/upnl/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,EAAe,KAAK,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEtG,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,qBAAqB,GAAG,kBAAkB,CAAC,qDAE/F;AAED,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACtC,qBAAqB,GAAG,cAAc,CAAC,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,CAAC,CACrG,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAC;AAEvH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,uBAAuB,CAO5G"}

package/dist/muon/upnl/query.js

@@ -0,0 +1,25 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getMuonUpnl as t } from "./get-muon-upnl.js";
+//#region src/muon/upnl/query.ts
+function n(t) {
+	return ["getMuonUpnl", 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,
+			partyB: r.partyB,
+			partyA: r.partyA
+		})
+	};
+}
+//#endregion
+export { n as getMuonUpnlQueryKey, r as getMuonUpnlQueryOptions };
+
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/upnl/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 { getMuonUpnl, type GetMuonUpnlParameters, type GetMuonUpnlReturnType } from \"./get-muon-upnl\";\n\n/** Data resolved by the {@link getMuonUpnlQueryOptions} query. */\nexport type GetMuonUpnlData = GetMuonUpnlReturnType;\n\n/**\n * Build the TanStack Query key for {@link getMuonUpnlQueryOptions}.\n *\n * @param options - Query parameters (chain id, partyB, partyA).\n * @returns A stable, hashable query key.\n */\nexport function getMuonUpnlQueryKey(options: Compute<GetMuonUpnlParameters & ConfigKeyParameter>) {\n  return [\"getMuonUpnl\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getMuonUpnlQueryKey}. */\nexport type GetMuonUpnlQueryKey = ReturnType<typeof getMuonUpnlQueryKey>;\n\n/**\n * Options accepted by {@link getMuonUpnlQueryOptions}: the action's parameters,\n * an optional cache scope, and TanStack overrides.\n */\nexport type GetMuonUpnlOptions = Compute<\n  GetMuonUpnlParameters & QueryParameter<GetMuonUpnlData, Error, GetMuonUpnlData, GetMuonUpnlQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getMuonUpnlQueryOptions}. */\nexport type GetMuonUpnlQueryOptions = SymmioQueryOptions<GetMuonUpnlData, Error, GetMuonUpnlData, GetMuonUpnlQueryKey>;\n\n/**\n * Build TanStack Query options for {@link getMuonUpnl}.\n *\n * @remarks\n * The attestation is short-lived. If you cache it — e.g. to display the attested\n * uPnL — 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(getMuonUpnlQueryOptions(config, { partyB: \"0xb…\", partyA: \"0xva…\" }));\n * ```\n */\nexport function getMuonUpnlQueryOptions(config: Config, options: GetMuonUpnlOptions): GetMuonUpnlQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getMuonUpnlQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getMuonUpnl(config, { chainId: options.chainId, partyB: options.partyB, partyA: options.partyA }),\n  };\n}\n"],"mappings":";;;AAeA,SAAgB,EAAoB,GAA8D;CAChG,OAAO,CAAC,eAAe,EAAmB,CAAO,CAAC;AACpD;AAiCA,SAAgB,EAAwB,GAAgB,GAAsD;CAC5G,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAoB;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EAClG,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAY,GAAQ;GAAE,SAAS,EAAQ;GAAS,QAAQ,EAAQ;GAAQ,QAAQ,EAAQ;EAAO,CAAC;CACjH;AACF"}

package/dist/muon/upnl-a/get-muon-upnl-a.d.ts

@@ -0,0 +1,54 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { MuonAttestationBase } from '../types';
+/** Parameters for {@link getMuonUpnlA}. */
+export type GetMuonUpnlAParameters = Compute<ChainIdParameter & {
+    /** The partyA (a subaccount for Majors, a virtual account for VibeCaps) to attest. */
+    partyA: Address;
+}>;
+/**
+ * Normalized `uPnl_A` attestation: the shared signature envelope plus partyA's
+ * computed uPnL 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 GetMuonUpnlAReturnType 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;
+    /** Symbol ids included in the attestation. */
+    symbolIds: bigint[];
+    /** Quote ids included in the attestation. */
+    quoteIds: bigint[];
+}
+/**
+ * Fetch a fresh Muon `uPnl_A` 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
+ * Returns the raw attestation. For the contract-ready {@link SingleUpnlSig} that
+ * `removeMargin` needs, use `getDeallocateUpnlSig` instead.
+ *
+ * @param config - The SDK config.
+ * @param parameters - PartyA address and optional chain id.
+ * @returns The normalized `uPnl_A` 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 a = await getMuonUpnlA(config, { partyA: "0xva…" });
+ * console.log(a.uPnl, a.quoteIds);
+ * ```
+ */
+export declare function getMuonUpnlA(config: Config, parameters: GetMuonUpnlAParameters): Promise<GetMuonUpnlAReturnType>;
+//# sourceMappingURL=get-muon-upnl-a.d.ts.map

package/dist/muon/upnl-a/get-muon-upnl-a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-muon-upnl-a.d.ts","sourceRoot":"","sources":["../../../src/muon/upnl-a/get-muon-upnl-a.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,EAAsB,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAExE,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,gBAAgB,GAAG;IACjB,sFAAsF;IACtF,MAAM,EAAE,OAAO,CAAC;CACjB,CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAgBjC"}