@symmio/trading-core 1.0.1 → 2.0.0

package/dist/muon/force-close-price-sig/get-force-close-price-sig.js

@@ -0,0 +1,34 @@
+import { MUON_METHOD_PRICE_RANGE as e } from "../types.js";
+import { fetchMuon as t, requireMuonBigInt as n, toContractSigEnvelope as r } from "../client.js";
+//#region src/muon/force-close-price-sig/get-force-close-price-sig.ts
+async function i(n, r) {
+	let { chainId: i, addresses: o, muon: s } = n.getChainConfig(r.chainId);
+	return a(await t(s.urls, e, {
+		t0: r.t0.toString(),
+		t1: r.t1.toString(),
+		partyA: r.partyA,
+		partyB: r.partyB,
+		chainId: i.toString(),
+		symmio: o.symmioAddress,
+		symbolId: r.symbolId.toString()
+	}));
+}
+function a(e) {
+	let t = e.data.result;
+	return {
+		...r(e),
+		symbolId: n(t.symbolId, "symbolId"),
+		highest: n(t.highest, "highest"),
+		lowest: n(t.lowest, "lowest"),
+		averagePrice: n(t.mean, "mean"),
+		startTime: n(t.startTime, "startTime"),
+		endTime: n(t.endTime, "endTime"),
+		upnlPartyB: n(t.uPnlB, "uPnlB"),
+		upnlPartyA: n(t.uPnlA, "uPnlA"),
+		currentPrice: n(t.price, "price")
+	};
+}
+//#endregion
+export { i as getForceClosePriceSig };
+
+//# sourceMappingURL=get-force-close-price-sig.js.map

package/dist/muon/force-close-price-sig/get-force-close-price-sig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-force-close-price-sig.js","names":[],"sources":["../../../src/muon/force-close-price-sig/get-force-close-price-sig.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport type { HighLowPriceSig } from \"../../symmio-contracts/symmio/types\";\nimport { fetchMuon, requireMuonBigInt, toContractSigEnvelope } from \"../client\";\nimport { MUON_METHOD_PRICE_RANGE, type MuonRawResult } from \"../types\";\n\n/**\n * Parameters for {@link getForceClosePriceSig}.\n */\nexport type GetForceClosePriceSigParameters = Compute<\n  ChainIdParameter & {\n    /** Window start timestamp (unix seconds). */\n    t0: bigint;\n    /** Window end timestamp (unix seconds). */\n    t1: bigint;\n    /** PartyA of the position being force-closed. */\n    partyA: Address;\n    /** PartyB (the solver) of the position being force-closed. */\n    partyB: Address;\n    /** Market symbol id of the position. */\n    symbolId: bigint;\n  }\n>;\n\n/** Return type of {@link getForceClosePriceSig}: a contract-ready price-range signature. */\nexport type GetForceClosePriceSigReturnType = HighLowPriceSig;\n\n/**\n * Fetch a fresh Muon `priceRange` attestation for a time window and assemble it\n * into the contract-ready {@link HighLowPriceSig} that `forceClosePosition` /\n * `settleAndForceClosePosition` verify.\n *\n * The Muon oracle URLs and the SYMMIO diamond address (the `symmio` request\n * param) are resolved from `config` per call. The configured gateways are tried\n * in order until one returns a successful attestation.\n *\n * @remarks\n * The attestation is timestamped and short-lived — fetch it immediately before\n * submitting, not ahead of time. For the raw, un-assembled attestation (all\n * returned fields), use `getMuonPriceRange` instead.\n *\n * TODO(muon-verify): `priceRange`'s exact response nesting has not been checked\n * against a live gateway (see `src/muon/MUON-VERIFY.md`). The field mapping here\n * follows the reference implementation and is best-effort until verified.\n *\n * @param config - The SDK config.\n * @param parameters - Window bounds, both parties, symbol id, optional chain id.\n * @returns The assembled `HighLowPriceSig`.\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 sig = await getForceClosePriceSig(config, {\n *   partyA: \"0x…\",\n *   partyB: solverAddress,\n *   symbolId: 1n,\n *   t0: 1735689600n,\n *   t1: 1735693200n,\n * });\n * ```\n */\nexport async function getForceClosePriceSig(\n  config: Config,\n  parameters: GetForceClosePriceSigParameters,\n): Promise<GetForceClosePriceSigReturnType> {\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  return toHighLowPriceSig(raw);\n}\n\n/**\n * Map a raw Muon `priceRange` result onto the on-chain {@link HighLowPriceSig}\n * tuple.\n *\n * Three of the wire names differ from the struct's: Muon returns `mean` for\n * `averagePrice`, `price` for `currentPrice`, and `uPnlB` / `uPnlA` for\n * `upnlPartyB` / `upnlPartyA`.\n *\n * @internal\n */\nfunction toHighLowPriceSig(raw: MuonRawResult): HighLowPriceSig {\n  const result = raw.data.result;\n  return {\n    ...toContractSigEnvelope(raw),\n    symbolId: requireMuonBigInt(result.symbolId, \"symbolId\"),\n    highest: requireMuonBigInt(result.highest, \"highest\"),\n    lowest: requireMuonBigInt(result.lowest, \"lowest\"),\n    averagePrice: requireMuonBigInt(result.mean, \"mean\"),\n    startTime: requireMuonBigInt(result.startTime, \"startTime\"),\n    endTime: requireMuonBigInt(result.endTime, \"endTime\"),\n    upnlPartyB: requireMuonBigInt(result.uPnlB, \"uPnlB\"),\n    upnlPartyA: requireMuonBigInt(result.uPnlA, \"uPnlA\"),\n    currentPrice: requireMuonBigInt(result.price, \"price\"),\n  };\n}\n"],"mappings":";;;AA+DA,eAAsB,EACpB,GACA,GAC0C;CAC1C,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO;CAU7E,OAAO,EAAkB,MATP,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,CAC2B;AAC9B;AAYA,SAAS,EAAkB,GAAqC;CAC9D,IAAM,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,UAAU,EAAkB,EAAO,UAAU,UAAU;EACvD,SAAS,EAAkB,EAAO,SAAS,SAAS;EACpD,QAAQ,EAAkB,EAAO,QAAQ,QAAQ;EACjD,cAAc,EAAkB,EAAO,MAAM,MAAM;EACnD,WAAW,EAAkB,EAAO,WAAW,WAAW;EAC1D,SAAS,EAAkB,EAAO,SAAS,SAAS;EACpD,YAAY,EAAkB,EAAO,OAAO,OAAO;EACnD,YAAY,EAAkB,EAAO,OAAO,OAAO;EACnD,cAAc,EAAkB,EAAO,OAAO,OAAO;CACvD;AACF"}

package/dist/muon/force-close-price-sig/index.d.ts

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

package/dist/muon/force-close-price-sig/index.d.ts.map

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

package/dist/muon/force-close-price-sig/query.d.ts

@@ -0,0 +1,50 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetForceClosePriceSigParameters, GetForceClosePriceSigReturnType } from './get-force-close-price-sig.js';
+/** Data resolved by the {@link getForceClosePriceSigQueryOptions} query. */
+export type GetForceClosePriceSigData = GetForceClosePriceSigReturnType;
+/**
+ * Build the TanStack Query key for {@link getForceClosePriceSigQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, window bounds, parties, symbol id).
+ * @returns A stable, hashable query key.
+ */
+export declare function getForceClosePriceSigQueryKey(options: Compute<GetForceClosePriceSigParameters & ConfigKeyParameter>): readonly ["getForceClosePriceSig", Record<string, unknown>];
+/** Query-key type produced by {@link getForceClosePriceSigQueryKey}. */
+export type GetForceClosePriceSigQueryKey = ReturnType<typeof getForceClosePriceSigQueryKey>;
+/**
+ * Options accepted by {@link getForceClosePriceSigQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetForceClosePriceSigOptions = Compute<GetForceClosePriceSigParameters & QueryParameter<GetForceClosePriceSigData, Error, GetForceClosePriceSigData, GetForceClosePriceSigQueryKey>>;
+/** TanStack Query options returned by {@link getForceClosePriceSigQueryOptions}. */
+export type GetForceClosePriceSigQueryOptions = SymmioQueryOptions<GetForceClosePriceSigData, Error, GetForceClosePriceSigData, GetForceClosePriceSigQueryKey>;
+/**
+ * Build TanStack Query options for {@link getForceClosePriceSig}.
+ *
+ * @remarks
+ * The attestation is short-lived. For an actual force-close submit, fetch a
+ * fresh signature on demand rather than serving a cached one; if you do cache it
+ * — e.g. to display the attested range — set a low `staleTime` and refetch
+ * before submitting.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(
+ *   getForceClosePriceSigQueryOptions(config, {
+ *     partyA: "0x…",
+ *     partyB: solverAddress,
+ *     symbolId: 1n,
+ *     t0: 1735689600n,
+ *     t1: 1735693200n,
+ *   }),
+ * );
+ * ```
+ */
+export declare function getForceClosePriceSigQueryOptions(config: Config, options: GetForceClosePriceSigOptions): GetForceClosePriceSigQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/muon/force-close-price-sig/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/force-close-price-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,+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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,4BAA4B,GACpC,iCAAiC,CAenC"}

package/dist/muon/force-close-price-sig/query.js

@@ -0,0 +1,28 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getForceClosePriceSig as t } from "./get-force-close-price-sig.js";
+//#region src/muon/force-close-price-sig/query.ts
+function n(t) {
+	return ["getForceClosePriceSig", 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 getForceClosePriceSigQueryKey, r as getForceClosePriceSigQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/muon/force-close-price-sig/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/force-close-price-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  getForceClosePriceSig,\n  type GetForceClosePriceSigParameters,\n  type GetForceClosePriceSigReturnType,\n} from \"./get-force-close-price-sig\";\n\n/** Data resolved by the {@link getForceClosePriceSigQueryOptions} query. */\nexport type GetForceClosePriceSigData = GetForceClosePriceSigReturnType;\n\n/**\n * Build the TanStack Query key for {@link getForceClosePriceSigQueryOptions}.\n *\n * @param options - Query parameters (chain id, window bounds, parties, symbol id).\n * @returns A stable, hashable query key.\n */\nexport function getForceClosePriceSigQueryKey(options: Compute<GetForceClosePriceSigParameters & ConfigKeyParameter>) {\n  return [\"getForceClosePriceSig\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getForceClosePriceSigQueryKey}. */\nexport type GetForceClosePriceSigQueryKey = ReturnType<typeof getForceClosePriceSigQueryKey>;\n\n/**\n * Options accepted by {@link getForceClosePriceSigQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetForceClosePriceSigOptions = Compute<\n  GetForceClosePriceSigParameters &\n    QueryParameter<GetForceClosePriceSigData, Error, GetForceClosePriceSigData, GetForceClosePriceSigQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getForceClosePriceSigQueryOptions}. */\nexport type GetForceClosePriceSigQueryOptions = SymmioQueryOptions<\n  GetForceClosePriceSigData,\n  Error,\n  GetForceClosePriceSigData,\n  GetForceClosePriceSigQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getForceClosePriceSig}.\n *\n * @remarks\n * The attestation is short-lived. For an actual force-close submit, fetch a\n * fresh signature on demand rather than serving a cached one; if you do cache it\n * — e.g. to display the attested range — set a low `staleTime` and refetch\n * 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(\n *   getForceClosePriceSigQueryOptions(config, {\n *     partyA: \"0x…\",\n *     partyB: solverAddress,\n *     symbolId: 1n,\n *     t0: 1735689600n,\n *     t1: 1735693200n,\n *   }),\n * );\n * ```\n */\nexport function getForceClosePriceSigQueryOptions(\n  config: Config,\n  options: GetForceClosePriceSigOptions,\n): GetForceClosePriceSigQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getForceClosePriceSigQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getForceClosePriceSig(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,EAA8B,GAAwE;CACpH,OAAO,CAAC,yBAAyB,EAAmB,CAAO,CAAC;AAC9D;AAgDA,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,eACE,EAAsB,GAAQ;GAC5B,SAAS,EAAQ;GACjB,IAAI,EAAQ;GACZ,IAAI,EAAQ;GACZ,QAAQ,EAAQ;GAChB,QAAQ,EAAQ;GAChB,UAAU,EAAQ;EACpB,CAAC;CACL;AACF"}

package/dist/muon/index.d.ts

@@ -1,7 +1,9 @@
 export * from './deallocate-upnl-sig/index.js';
+export * from './force-close-price-sig/index.js';
 export * from './party-a-overview/index.js';
 export * from './price/index.js';
 export * from './price-range/index.js';
+export * from './send-quote-upnl-sig/index.js';
 export * from './settle-upnl/index.js';
 export * from './types.js';
 export * from './upnl/index.js';

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/muon/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,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

@@ -12,7 +12,7 @@ export type GetMuonPartyAOverviewParameters = Compute<ChainIdParameter & {
  * partyA's liquidation-overview fields.
  *
  * @remarks
- * TODO(muon-verify): beyond `uPnl` (verified via Vibe-ui), the field set/nesting
+ * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), the field set/nesting
  * is best-effort from the Muon docs; optional fields are absent when the gateway
  * omits them.
  */

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

@@ -1 +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 (virtual account for lowcap) 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"}
+{"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 (virtual account for lowcap) 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 against the reference frontend), 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/send-quote-upnl-sig/get-send-quote-upnl-sig.d.ts

@@ -0,0 +1,53 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { SingleUpnlAndPriceSig } from '../../symmio-contracts/symmio/types.js';
+/**
+ * Parameters for {@link getSendQuoteUpnlSig}.
+ */
+export type GetSendQuoteUpnlSigParameters = Compute<ChainIdParameter & {
+    /**
+     * The Muon `partyA` to attest. For cross-margin solvers (Rasa / majors) this
+     * is the **sub-account**; for lowcap it is the virtual account.
+     */
+    partyA: Address;
+    /** Market symbol id whose price is attested alongside the uPnL. */
+    symbolId: bigint;
+}>;
+/** Return type of {@link getSendQuoteUpnlSig}: a contract-ready uPnL + price signature. */
+export type GetSendQuoteUpnlSigReturnType = SingleUpnlAndPriceSig;
+/**
+ * Fetch a fresh Muon `uPnl_A_withSymbolPrice` attestation and assemble it into
+ * the contract-ready {@link SingleUpnlAndPriceSig} that
+ * `sendQuoteWithAffiliateAndData` takes as its `upnlSig` argument.
+ *
+ * The Muon oracle URLs and the SYMMIO diamond address (the `symmio` request
+ * param) are resolved from `config` per call. The configured gateways are tried
+ * in order until one returns a successful attestation.
+ *
+ * @remarks
+ * The attestation is timestamped and short-lived, and it is signed *inside* the
+ * quote calldata — fetch it immediately before signing, never ahead of time.
+ * Solvers that enforce Muon verification (Rasa / majors) require a live
+ * attestation here; the lowcap InstantLayer flow instead signs a placeholder and
+ * delegates the byte range to the solver, so it does not call this.
+ *
+ * For the raw, un-assembled attestation (all returned fields), use
+ * `getMuonUpnlAWithSymbolPrice` instead.
+ *
+ * @param config - The SDK config.
+ * @param parameters - PartyA address, market symbol id, and optional chain id.
+ * @returns The assembled `SingleUpnlAndPriceSig`.
+ * @throws {SymmError} when the chain is unsupported, no Muon URLs are configured,
+ *   or every oracle returns an unsuccessful or malformed attestation.
+ *
+ * @example
+ * ```ts
+ * const upnlSig = await getSendQuoteUpnlSig(config, {
+ *   partyA: subAccountAddress,
+ *   symbolId: 1n,
+ * });
+ * ```
+ */
+export declare function getSendQuoteUpnlSig(config: Config, parameters: GetSendQuoteUpnlSigParameters): Promise<GetSendQuoteUpnlSigReturnType>;
+//# sourceMappingURL=get-send-quote-upnl-sig.d.ts.map

package/dist/muon/send-quote-upnl-sig/get-send-quote-upnl-sig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-send-quote-upnl-sig.d.ts","sourceRoot":"","sources":["../../../src/muon/send-quote-upnl-sig/get-send-quote-upnl-sig.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;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAIjF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,OAAO,CACjD,gBAAgB,GAAG;IACjB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,6BAA6B,CAAC,CASxC"}

package/dist/muon/send-quote-upnl-sig/get-send-quote-upnl-sig.js

@@ -0,0 +1,23 @@
+import { MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE as e } from "../types.js";
+import { fetchMuon as t, muonBigInt as n, requireMuonBigInt as r, toContractSigEnvelope as i } from "../client.js";
+//#region src/muon/send-quote-upnl-sig/get-send-quote-upnl-sig.ts
+async function a(n, r) {
+	let { chainId: i, addresses: a, muon: s } = n.getChainConfig(r.chainId);
+	return o(await t(s.urls, e, {
+		partyA: r.partyA,
+		chainId: i.toString(),
+		symmio: a.symmioAddress,
+		symbolId: r.symbolId.toString()
+	}));
+}
+function o(e) {
+	return {
+		...i(e),
+		upnl: r(e.data.result.uPnl, "uPnl"),
+		price: n(e.data.result.price) ?? 0n
+	};
+}
+//#endregion
+export { a as getSendQuoteUpnlSig };
+
+//# sourceMappingURL=get-send-quote-upnl-sig.js.map

package/dist/muon/send-quote-upnl-sig/get-send-quote-upnl-sig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-send-quote-upnl-sig.js","names":[],"sources":["../../../src/muon/send-quote-upnl-sig/get-send-quote-upnl-sig.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport type { SingleUpnlAndPriceSig } from \"../../symmio-contracts/symmio/types\";\nimport { fetchMuon, muonBigInt, requireMuonBigInt, toContractSigEnvelope } from \"../client\";\nimport { MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE, type MuonRawResult } from \"../types\";\n\n/**\n * Parameters for {@link getSendQuoteUpnlSig}.\n */\nexport type GetSendQuoteUpnlSigParameters = Compute<\n  ChainIdParameter & {\n    /**\n     * The Muon `partyA` to attest. For cross-margin solvers (Rasa / majors) this\n     * is the **sub-account**; for lowcap it is the virtual account.\n     */\n    partyA: Address;\n    /** Market symbol id whose price is attested alongside the uPnL. */\n    symbolId: bigint;\n  }\n>;\n\n/** Return type of {@link getSendQuoteUpnlSig}: a contract-ready uPnL + price signature. */\nexport type GetSendQuoteUpnlSigReturnType = SingleUpnlAndPriceSig;\n\n/**\n * Fetch a fresh Muon `uPnl_A_withSymbolPrice` attestation and assemble it into\n * the contract-ready {@link SingleUpnlAndPriceSig} that\n * `sendQuoteWithAffiliateAndData` takes as its `upnlSig` argument.\n *\n * The Muon oracle URLs and the SYMMIO diamond address (the `symmio` request\n * param) are resolved from `config` per call. The configured gateways are tried\n * in order until one returns a successful attestation.\n *\n * @remarks\n * The attestation is timestamped and short-lived, and it is signed *inside* the\n * quote calldata — fetch it immediately before signing, never ahead of time.\n * Solvers that enforce Muon verification (Rasa / majors) require a live\n * attestation here; the lowcap InstantLayer flow instead signs a placeholder and\n * delegates the byte range to the solver, so it does not call this.\n *\n * For the raw, un-assembled attestation (all returned fields), use\n * `getMuonUpnlAWithSymbolPrice` instead.\n *\n * @param config - The SDK config.\n * @param parameters - PartyA address, market symbol id, and optional chain id.\n * @returns The assembled `SingleUpnlAndPriceSig`.\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 upnlSig = await getSendQuoteUpnlSig(config, {\n *   partyA: subAccountAddress,\n *   symbolId: 1n,\n * });\n * ```\n */\nexport async function getSendQuoteUpnlSig(\n  config: Config,\n  parameters: GetSendQuoteUpnlSigParameters,\n): Promise<GetSendQuoteUpnlSigReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE, {\n    partyA: parameters.partyA,\n    chainId: chainId.toString(),\n    symmio: addresses.symmioAddress,\n    symbolId: parameters.symbolId.toString(),\n  });\n  return toSingleUpnlAndPriceSig(raw);\n}\n\n/**\n * Map a raw Muon `uPnl_A_withSymbolPrice` result onto the on-chain\n * {@link SingleUpnlAndPriceSig} tuple.\n *\n * `price` falls back to `0n` when the gateway omits it — the contract reads the\n * field unconditionally, and the reference implementation defaults it the same\n * way rather than failing the trade.\n *\n * @internal\n */\nfunction toSingleUpnlAndPriceSig(result: MuonRawResult): SingleUpnlAndPriceSig {\n  return {\n    ...toContractSigEnvelope(result),\n    upnl: requireMuonBigInt(result.data.result.uPnl, \"uPnl\"),\n    price: muonBigInt(result.data.result.price) ?? 0n,\n  };\n}\n"],"mappings":";;;AA0DA,eAAsB,EACpB,GACA,GACwC;CACxC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO;CAO7E,OAAO,EAAwB,MANb,EAAU,EAAK,MAAM,GAAsC;EAC3E,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,QAAQ,EAAU;EAClB,UAAU,EAAW,SAAS,SAAS;CACzC,CAAC,CACiC;AACpC;AAYA,SAAS,EAAwB,GAA8C;CAC7E,OAAO;EACL,GAAG,EAAsB,CAAM;EAC/B,MAAM,EAAkB,EAAO,KAAK,OAAO,MAAM,MAAM;EACvD,OAAO,EAAW,EAAO,KAAK,OAAO,KAAK,KAAK;CACjD;AACF"}

package/dist/muon/send-quote-upnl-sig/index.d.ts

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

package/dist/muon/send-quote-upnl-sig/index.d.ts.map

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

package/dist/muon/send-quote-upnl-sig/query.d.ts

@@ -0,0 +1,42 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetSendQuoteUpnlSigParameters, GetSendQuoteUpnlSigReturnType } from './get-send-quote-upnl-sig.js';
+/** Data resolved by the {@link getSendQuoteUpnlSigQueryOptions} query. */
+export type GetSendQuoteUpnlSigData = GetSendQuoteUpnlSigReturnType;
+/**
+ * Build the TanStack Query key for {@link getSendQuoteUpnlSigQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, partyA, symbol id).
+ * @returns A stable, hashable query key.
+ */
+export declare function getSendQuoteUpnlSigQueryKey(options: Compute<GetSendQuoteUpnlSigParameters & ConfigKeyParameter>): readonly ["getSendQuoteUpnlSig", Record<string, unknown>];
+/** Query-key type produced by {@link getSendQuoteUpnlSigQueryKey}. */
+export type GetSendQuoteUpnlSigQueryKey = ReturnType<typeof getSendQuoteUpnlSigQueryKey>;
+/**
+ * Options accepted by {@link getSendQuoteUpnlSigQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetSendQuoteUpnlSigOptions = Compute<GetSendQuoteUpnlSigParameters & QueryParameter<GetSendQuoteUpnlSigData, Error, GetSendQuoteUpnlSigData, GetSendQuoteUpnlSigQueryKey>>;
+/** TanStack Query options returned by {@link getSendQuoteUpnlSigQueryOptions}. */
+export type GetSendQuoteUpnlSigQueryOptions = SymmioQueryOptions<GetSendQuoteUpnlSigData, Error, GetSendQuoteUpnlSigData, GetSendQuoteUpnlSigQueryKey>;
+/**
+ * Build TanStack Query options for {@link getSendQuoteUpnlSig}.
+ *
+ * @remarks
+ * The attestation is short-lived **and is signed inside the quote calldata**, so
+ * a cached one is almost never what you want for an actual submit — fetch it on
+ * demand instead (the instant-open Rasa path does this internally). Caching is
+ * only appropriate for display.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getSendQuoteUpnlSigQueryOptions(config, { partyA: "0x…", symbolId: 1n }));
+ * ```
+ */
+export declare function getSendQuoteUpnlSigQueryOptions(config: Config, options: GetSendQuoteUpnlSigOptions): GetSendQuoteUpnlSigQueryOptions;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/muon/send-quote-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,6BAA6B,EAClC,KAAK,6BAA6B,EACnC,MAAM,2BAA2B,CAAC;AAEnC,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,CAAC,6BAA6B,GAAG,kBAAkB,CAAC,6DAE/G;AAED,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,6BAA6B,GAC3B,cAAc,CAAC,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,2BAA2B,CAAC,CACvG,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,+BAA+B,GAAG,kBAAkB,CAC9D,uBAAuB,EACvB,KAAK,EACL,uBAAuB,EACvB,2BAA2B,CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,0BAA0B,GAClC,+BAA+B,CAYjC"}

package/dist/muon/send-quote-upnl-sig/query.js

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

package/dist/muon/send-quote-upnl-sig/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/muon/send-quote-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  getSendQuoteUpnlSig,\n  type GetSendQuoteUpnlSigParameters,\n  type GetSendQuoteUpnlSigReturnType,\n} from \"./get-send-quote-upnl-sig\";\n\n/** Data resolved by the {@link getSendQuoteUpnlSigQueryOptions} query. */\nexport type GetSendQuoteUpnlSigData = GetSendQuoteUpnlSigReturnType;\n\n/**\n * Build the TanStack Query key for {@link getSendQuoteUpnlSigQueryOptions}.\n *\n * @param options - Query parameters (chain id, partyA, symbol id).\n * @returns A stable, hashable query key.\n */\nexport function getSendQuoteUpnlSigQueryKey(options: Compute<GetSendQuoteUpnlSigParameters & ConfigKeyParameter>) {\n  return [\"getSendQuoteUpnlSig\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getSendQuoteUpnlSigQueryKey}. */\nexport type GetSendQuoteUpnlSigQueryKey = ReturnType<typeof getSendQuoteUpnlSigQueryKey>;\n\n/**\n * Options accepted by {@link getSendQuoteUpnlSigQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetSendQuoteUpnlSigOptions = Compute<\n  GetSendQuoteUpnlSigParameters &\n    QueryParameter<GetSendQuoteUpnlSigData, Error, GetSendQuoteUpnlSigData, GetSendQuoteUpnlSigQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getSendQuoteUpnlSigQueryOptions}. */\nexport type GetSendQuoteUpnlSigQueryOptions = SymmioQueryOptions<\n  GetSendQuoteUpnlSigData,\n  Error,\n  GetSendQuoteUpnlSigData,\n  GetSendQuoteUpnlSigQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getSendQuoteUpnlSig}.\n *\n * @remarks\n * The attestation is short-lived **and is signed inside the quote calldata**, so\n * a cached one is almost never what you want for an actual submit — fetch it on\n * demand instead (the instant-open Rasa path does this internally). Caching is\n * only appropriate for display.\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(getSendQuoteUpnlSigQueryOptions(config, { partyA: \"0x…\", symbolId: 1n }));\n * ```\n */\nexport function getSendQuoteUpnlSigQueryOptions(\n  config: Config,\n  options: GetSendQuoteUpnlSigOptions,\n): GetSendQuoteUpnlSigQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getSendQuoteUpnlSigQueryKey({ ...options, configKey: config.getChainConfigKey(options.chainId) }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getSendQuoteUpnlSig(config, {\n        chainId: options.chainId,\n        partyA: options.partyA,\n        symbolId: options.symbolId,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA4B,GAAsE;CAChH,OAAO,CAAC,uBAAuB,EAAmB,CAAO,CAAC;AAC5D;AAwCA,SAAgB,EACd,GACA,GACiC;CACjC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA4B;GAAE,GAAG;GAAS,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EAAE,CAAC;EAC1G,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAoB,GAAQ;GAC1B,SAAS,EAAQ;GACjB,QAAQ,EAAQ;GAChB,UAAU,EAAQ;EACpB,CAAC;CACL;AACF"}

package/dist/muon/types.d.ts

@@ -12,7 +12,7 @@ export declare const MUON_APP = "symmio";
  *
  * @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
+ * verified (against the reference frontend'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.
  *
@@ -41,7 +41,7 @@ export declare const MUON_METHOD_PRICE_RANGE = "priceRange";
  *
  * @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
+ * hand-written from the API docs + the reference frontend'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}

package/dist/muon/types.js.map

@@ -1 +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"}
+{"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 the reference frontend'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 + the reference frontend'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-a/get-muon-upnl-a.d.ts

@@ -12,7 +12,7 @@ export type GetMuonUpnlAParameters = Compute<ChainIdParameter & {
  * computed uPnL fields.
  *
  * @remarks
- * TODO(muon-verify): beyond `uPnl` (verified via Vibe-ui), the field set/nesting
+ * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), the field set/nesting
  * is best-effort from the Muon docs; optional fields are absent when the gateway
  * omits them.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"get-muon-upnl-a.js","names":[],"sources":["../../../src/muon/upnl-a/get-muon-upnl-a.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_UPNL_A, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlA}. */\nexport type GetMuonUpnlAParameters = Compute<\n  ChainIdParameter & {\n    /** The partyA (virtual account for lowcap) to attest. */\n    partyA: Address;\n  }\n>;\n\n/**\n * Normalized `uPnl_A` attestation: the shared signature envelope plus partyA's\n * computed uPnL 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 GetMuonUpnlAReturnType 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  /** 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 `uPnl_A` attestation for `partyA` and normalize it to typed\n * fields. The oracle URLs and the SYMMIO diamond address (the `symmio` request\n * param) are resolved from `config`; gateways are tried in order until one\n * succeeds.\n *\n * @remarks\n * Returns the raw attestation. For the contract-ready {@link SingleUpnlSig} that\n * `removeMargin` needs, use `getDeallocateUpnlSig` instead.\n *\n * @param config - The SDK config.\n * @param parameters - PartyA address and optional chain id.\n * @returns The normalized `uPnl_A` 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 getMuonUpnlA(config, { partyA: \"0xva…\" });\n * console.log(a.uPnl, a.quoteIds);\n * ```\n */\nexport async function getMuonUpnlA(\n  config: Config,\n  parameters: GetMuonUpnlAParameters,\n): Promise<GetMuonUpnlAReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_A, {\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    symbolIds: muonBigIntArray(result.symbolIds),\n    quoteIds: muonBigIntArray(result.quoteIds),\n  };\n}\n"],"mappings":";;;AA0DA,eAAsB,EACpB,GACA,GACiC;CACjC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAoB;EACzD,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,WAAW,EAAgB,EAAO,SAAS;EAC3C,UAAU,EAAgB,EAAO,QAAQ;CAC3C;AACF"}
+{"version":3,"file":"get-muon-upnl-a.js","names":[],"sources":["../../../src/muon/upnl-a/get-muon-upnl-a.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_UPNL_A, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlA}. */\nexport type GetMuonUpnlAParameters = Compute<\n  ChainIdParameter & {\n    /** The partyA (virtual account for lowcap) to attest. */\n    partyA: Address;\n  }\n>;\n\n/**\n * Normalized `uPnl_A` attestation: the shared signature envelope plus partyA's\n * computed uPnL fields.\n *\n * @remarks\n * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), 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 GetMuonUpnlAReturnType 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  /** 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 `uPnl_A` attestation for `partyA` and normalize it to typed\n * fields. The oracle URLs and the SYMMIO diamond address (the `symmio` request\n * param) are resolved from `config`; gateways are tried in order until one\n * succeeds.\n *\n * @remarks\n * Returns the raw attestation. For the contract-ready {@link SingleUpnlSig} that\n * `removeMargin` needs, use `getDeallocateUpnlSig` instead.\n *\n * @param config - The SDK config.\n * @param parameters - PartyA address and optional chain id.\n * @returns The normalized `uPnl_A` 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 getMuonUpnlA(config, { partyA: \"0xva…\" });\n * console.log(a.uPnl, a.quoteIds);\n * ```\n */\nexport async function getMuonUpnlA(\n  config: Config,\n  parameters: GetMuonUpnlAParameters,\n): Promise<GetMuonUpnlAReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_A, {\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    symbolIds: muonBigIntArray(result.symbolIds),\n    quoteIds: muonBigIntArray(result.quoteIds),\n  };\n}\n"],"mappings":";;;AA0DA,eAAsB,EACpB,GACA,GACiC;CACjC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAoB;EACzD,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,WAAW,EAAgB,EAAO,SAAS;EAC3C,UAAU,EAAgB,EAAO,QAAQ;CAC3C;AACF"}

package/dist/muon/upnl-a-with-symbol-price/get-muon-upnl-a-with-symbol-price.d.ts

@@ -14,7 +14,7 @@ export type GetMuonUpnlAWithSymbolPriceParameters = Compute<ChainIdParameter & {
  * plus partyA's computed uPnL fields and the requested symbol's price.
  *
  * @remarks
- * TODO(muon-verify): beyond `uPnl` (verified via Vibe-ui), the field set/nesting
+ * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), the field set/nesting
  * is best-effort from the Muon docs; optional fields are absent when the gateway
  * omits them.
  */

package/dist/muon/upnl-a-with-symbol-price/get-muon-upnl-a-with-symbol-price.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-muon-upnl-a-with-symbol-price.js","names":[],"sources":["../../../src/muon/upnl-a-with-symbol-price/get-muon-upnl-a-with-symbol-price.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_UPNL_A_WITH_SYMBOL_PRICE, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlAWithSymbolPrice}. */\nexport type GetMuonUpnlAWithSymbolPriceParameters = Compute<\n  ChainIdParameter & {\n    /** The partyA (virtual account, lowcap) to attest. */\n    partyA: Address;\n    /** The symbol whose price is attested alongside the uPnL. */\n    symbolId: bigint;\n  }\n>;\n\n/**\n * Normalized `uPnl_A_withSymbolPrice` attestation: the shared signature envelope\n * plus partyA's computed uPnL fields and the requested symbol's price.\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 GetMuonUpnlAWithSymbolPriceReturnType extends MuonAttestationBase {\n  /** The attested partyA. */\n  partyA: Address;\n  /** The symbol whose price is attested. */\n  symbolId: bigint;\n  /** The attested price for `symbolId` (18-decimal). */\n  price?: bigint;\n  /** Signed unrealized PnL (18-decimal, signed). */\n  uPnl: bigint;\n  /** Sum of notional values across the partyA's positions. */\n  notionalValueSum?: bigint;\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 `uPnl_A_withSymbolPrice` attestation for `partyA` and a\n * single `symbolId`, and normalize it to typed fields. The oracle URLs and the\n * SYMMIO diamond address (the `symmio` request param) are resolved from `config`;\n * gateways are tried in order until one succeeds.\n *\n * @remarks\n * This attestation bundles partyA's uPnL with one symbol's price; it feeds the\n * `sendQuoteWithAffiliate` flow.\n *\n * @param config - The SDK config.\n * @param parameters - PartyA address, symbol id, and optional chain id.\n * @returns The normalized `uPnl_A_withSymbolPrice` 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 getMuonUpnlAWithSymbolPrice(config, { partyA: \"0xva…\", symbolId: 1n });\n * console.log(a.uPnl, a.price);\n * ```\n */\nexport async function getMuonUpnlAWithSymbolPrice(\n  config: Config,\n  parameters: GetMuonUpnlAWithSymbolPriceParameters,\n): Promise<GetMuonUpnlAWithSymbolPriceReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE, {\n    partyA: parameters.partyA,\n    chainId: chainId.toString(),\n    symbolId: parameters.symbolId.toString(),\n    symmio: addresses.symmioAddress,\n  });\n  const result = raw.data.result;\n  return {\n    ...toMuonAttestationBase(raw),\n    partyA: parameters.partyA,\n    symbolId: parameters.symbolId,\n    price: muonBigInt(result.price),\n    uPnl: requireMuonBigInt(result.uPnl, \"uPnl\"),\n    notionalValueSum: muonBigInt(result.notionalValueSum),\n    symbolIds: muonBigIntArray(result.symbolIds),\n    quoteIds: muonBigIntArray(result.quoteIds),\n  };\n}\n"],"mappings":";;;AAgEA,eAAsB,EACpB,GACA,GACgD;CAChD,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAsC;EAC3E,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,UAAU,EAAW,SAAS,SAAS;EACvC,QAAQ,EAAU;CACpB,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,QAAQ,EAAW;EACnB,UAAU,EAAW;EACrB,OAAO,EAAW,EAAO,KAAK;EAC9B,MAAM,EAAkB,EAAO,MAAM,MAAM;EAC3C,kBAAkB,EAAW,EAAO,gBAAgB;EACpD,WAAW,EAAgB,EAAO,SAAS;EAC3C,UAAU,EAAgB,EAAO,QAAQ;CAC3C;AACF"}
+{"version":3,"file":"get-muon-upnl-a-with-symbol-price.js","names":[],"sources":["../../../src/muon/upnl-a-with-symbol-price/get-muon-upnl-a-with-symbol-price.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_UPNL_A_WITH_SYMBOL_PRICE, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlAWithSymbolPrice}. */\nexport type GetMuonUpnlAWithSymbolPriceParameters = Compute<\n  ChainIdParameter & {\n    /** The partyA (virtual account, lowcap) to attest. */\n    partyA: Address;\n    /** The symbol whose price is attested alongside the uPnL. */\n    symbolId: bigint;\n  }\n>;\n\n/**\n * Normalized `uPnl_A_withSymbolPrice` attestation: the shared signature envelope\n * plus partyA's computed uPnL fields and the requested symbol's price.\n *\n * @remarks\n * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), 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 GetMuonUpnlAWithSymbolPriceReturnType extends MuonAttestationBase {\n  /** The attested partyA. */\n  partyA: Address;\n  /** The symbol whose price is attested. */\n  symbolId: bigint;\n  /** The attested price for `symbolId` (18-decimal). */\n  price?: bigint;\n  /** Signed unrealized PnL (18-decimal, signed). */\n  uPnl: bigint;\n  /** Sum of notional values across the partyA's positions. */\n  notionalValueSum?: bigint;\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 `uPnl_A_withSymbolPrice` attestation for `partyA` and a\n * single `symbolId`, and normalize it to typed fields. The oracle URLs and the\n * SYMMIO diamond address (the `symmio` request param) are resolved from `config`;\n * gateways are tried in order until one succeeds.\n *\n * @remarks\n * This attestation bundles partyA's uPnL with one symbol's price; it feeds the\n * `sendQuoteWithAffiliate` flow.\n *\n * @param config - The SDK config.\n * @param parameters - PartyA address, symbol id, and optional chain id.\n * @returns The normalized `uPnl_A_withSymbolPrice` 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 getMuonUpnlAWithSymbolPrice(config, { partyA: \"0xva…\", symbolId: 1n });\n * console.log(a.uPnl, a.price);\n * ```\n */\nexport async function getMuonUpnlAWithSymbolPrice(\n  config: Config,\n  parameters: GetMuonUpnlAWithSymbolPriceParameters,\n): Promise<GetMuonUpnlAWithSymbolPriceReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_A_WITH_SYMBOL_PRICE, {\n    partyA: parameters.partyA,\n    chainId: chainId.toString(),\n    symbolId: parameters.symbolId.toString(),\n    symmio: addresses.symmioAddress,\n  });\n  const result = raw.data.result;\n  return {\n    ...toMuonAttestationBase(raw),\n    partyA: parameters.partyA,\n    symbolId: parameters.symbolId,\n    price: muonBigInt(result.price),\n    uPnl: requireMuonBigInt(result.uPnl, \"uPnl\"),\n    notionalValueSum: muonBigInt(result.notionalValueSum),\n    symbolIds: muonBigIntArray(result.symbolIds),\n    quoteIds: muonBigIntArray(result.quoteIds),\n  };\n}\n"],"mappings":";;;AAgEA,eAAsB,EACpB,GACA,GACgD;CAChD,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAsC;EAC3E,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,UAAU,EAAW,SAAS,SAAS;EACvC,QAAQ,EAAU;CACpB,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,QAAQ,EAAW;EACnB,UAAU,EAAW;EACrB,OAAO,EAAW,EAAO,KAAK;EAC9B,MAAM,EAAkB,EAAO,MAAM,MAAM;EAC3C,kBAAkB,EAAW,EAAO,gBAAgB;EACpD,WAAW,EAAgB,EAAO,SAAS;EAC3C,UAAU,EAAgB,EAAO,QAAQ;CAC3C;AACF"}

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

@@ -14,7 +14,7 @@ export type GetMuonUpnlBParameters = Compute<ChainIdParameter & {
  * computed uPnL fields against a given partyA.
  *
  * @remarks
- * TODO(muon-verify): beyond `uPnl` (verified via Vibe-ui), the field set/nesting
+ * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), the field set/nesting
  * is best-effort from the Muon docs; optional fields are absent when the gateway
  * omits them.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"get-muon-upnl-b.js","names":[],"sources":["../../../src/muon/upnl-b/get-muon-upnl-b.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_UPNL_B, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlB}. */\nexport type GetMuonUpnlBParameters = Compute<\n  ChainIdParameter & {\n    /** The partyB (a hedger/solver) to attest. */\n    partyB: Address;\n    /** The partyA the partyB's uPnL is computed against. */\n    partyA: Address;\n  }\n>;\n\n/**\n * Normalized `uPnl_B` attestation: the shared signature envelope plus a partyB's\n * computed uPnL fields against a given partyA.\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 GetMuonUpnlBReturnType extends MuonAttestationBase {\n  /** The attested partyB. */\n  partyB: Address;\n  /** The partyA the attestation is computed against. */\n  partyA: Address;\n  /** Signed unrealized PnL (18-decimal, signed). */\n  uPnl: bigint;\n  /** Sum of notional values across the partyB's positions with the partyA. */\n  notionalValueSum?: bigint;\n  /** Quote ids included in the attestation. */\n  quoteIds: bigint[];\n}\n\n/**\n * Fetch a fresh Muon `uPnl_B` attestation for `partyB` against `partyA` 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 * A partyB's uPnL against a partyA is used in `lockQuote` solvency validation.\n *\n * @param config - The SDK config.\n * @param parameters - PartyB and partyA addresses and optional chain id.\n * @returns The normalized `uPnl_B` 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 b = await getMuonUpnlB(config, { partyB: \"0xpb…\", partyA: \"0xva…\" });\n * console.log(b.uPnl, b.quoteIds);\n * ```\n */\nexport async function getMuonUpnlB(\n  config: Config,\n  parameters: GetMuonUpnlBParameters,\n): Promise<GetMuonUpnlBReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_B, {\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    uPnl: requireMuonBigInt(result.uPnl, \"uPnl\"),\n    notionalValueSum: muonBigInt(result.notionalValueSum),\n    quoteIds: muonBigIntArray(result.quoteIds),\n  };\n}\n"],"mappings":";;;AA2DA,eAAsB,EACpB,GACA,GACiC;CACjC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAoB;EACzD,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,MAAM,EAAkB,EAAO,MAAM,MAAM;EAC3C,kBAAkB,EAAW,EAAO,gBAAgB;EACpD,UAAU,EAAgB,EAAO,QAAQ;CAC3C;AACF"}
+{"version":3,"file":"get-muon-upnl-b.js","names":[],"sources":["../../../src/muon/upnl-b/get-muon-upnl-b.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_UPNL_B, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlB}. */\nexport type GetMuonUpnlBParameters = Compute<\n  ChainIdParameter & {\n    /** The partyB (a hedger/solver) to attest. */\n    partyB: Address;\n    /** The partyA the partyB's uPnL is computed against. */\n    partyA: Address;\n  }\n>;\n\n/**\n * Normalized `uPnl_B` attestation: the shared signature envelope plus a partyB's\n * computed uPnL fields against a given partyA.\n *\n * @remarks\n * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), 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 GetMuonUpnlBReturnType extends MuonAttestationBase {\n  /** The attested partyB. */\n  partyB: Address;\n  /** The partyA the attestation is computed against. */\n  partyA: Address;\n  /** Signed unrealized PnL (18-decimal, signed). */\n  uPnl: bigint;\n  /** Sum of notional values across the partyB's positions with the partyA. */\n  notionalValueSum?: bigint;\n  /** Quote ids included in the attestation. */\n  quoteIds: bigint[];\n}\n\n/**\n * Fetch a fresh Muon `uPnl_B` attestation for `partyB` against `partyA` 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 * A partyB's uPnL against a partyA is used in `lockQuote` solvency validation.\n *\n * @param config - The SDK config.\n * @param parameters - PartyB and partyA addresses and optional chain id.\n * @returns The normalized `uPnl_B` 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 b = await getMuonUpnlB(config, { partyB: \"0xpb…\", partyA: \"0xva…\" });\n * console.log(b.uPnl, b.quoteIds);\n * ```\n */\nexport async function getMuonUpnlB(\n  config: Config,\n  parameters: GetMuonUpnlBParameters,\n): Promise<GetMuonUpnlBReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_B, {\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    uPnl: requireMuonBigInt(result.uPnl, \"uPnl\"),\n    notionalValueSum: muonBigInt(result.notionalValueSum),\n    quoteIds: muonBigIntArray(result.quoteIds),\n  };\n}\n"],"mappings":";;;AA2DA,eAAsB,EACpB,GACA,GACiC;CACjC,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAoB;EACzD,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,MAAM,EAAkB,EAAO,MAAM,MAAM;EAC3C,kBAAkB,EAAW,EAAO,gBAAgB;EACpD,UAAU,EAAgB,EAAO,QAAQ;CAC3C;AACF"}

package/dist/muon/upnl-with-symbol-price/get-muon-upnl-with-symbol-price.d.ts

@@ -16,7 +16,7 @@ export type GetMuonUpnlWithSymbolPriceParameters = Compute<ChainIdParameter & {
  * both parties' computed uPnL fields and a single symbol price.
  *
  * @remarks
- * TODO(muon-verify): beyond `uPnl` (verified via Vibe-ui), the field set/nesting
+ * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), the field set/nesting
  * is best-effort from the Muon docs; optional fields are absent when the gateway
  * omits them.
  */

package/dist/muon/upnl-with-symbol-price/get-muon-upnl-with-symbol-price.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-muon-upnl-with-symbol-price.js","names":[],"sources":["../../../src/muon/upnl-with-symbol-price/get-muon-upnl-with-symbol-price.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_WITH_SYMBOL_PRICE, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlWithSymbolPrice}. */\nexport type GetMuonUpnlWithSymbolPriceParameters = Compute<\n  ChainIdParameter & {\n    /** The partyB (solver) side of the attestation. */\n    partyB: Address;\n    /** The partyA (virtual account, lowcap) to attest. */\n    partyA: Address;\n    /** The symbol id whose price is included in the attestation. */\n    symbolId: bigint;\n  }\n>;\n\n/**\n * Normalized `uPnlWithSymbolPrice` attestation: the shared signature envelope plus\n * both parties' computed uPnL fields and a single symbol price.\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 GetMuonUpnlWithSymbolPriceReturnType extends MuonAttestationBase {\n  /** The attested partyB. */\n  partyB: Address;\n  /** The attested partyA. */\n  partyA: Address;\n  /** The symbol id the price is for. */\n  symbolId: bigint;\n  /** The attested symbol price (18-decimal). */\n  price?: bigint;\n  /** Signed unrealized PnL for partyA (18-decimal, signed). */\n  uPnlA?: bigint;\n  /** Signed unrealized PnL for partyB (18-decimal, signed). */\n  uPnlB?: bigint;\n  /** Quote ids included on partyA's side of the attestation. */\n  quoteIdsA: bigint[];\n  /** Quote ids included on partyB's side of the attestation. */\n  quoteIdsB: bigint[];\n}\n\n/**\n * Fetch a fresh Muon `uPnlWithSymbolPrice` attestation for a `partyB`/`partyA`\n * pair and a `symbolId`, normalized to typed fields. The oracle URLs and the\n * SYMMIO diamond address (the `symmio` request param) are resolved from `config`;\n * gateways are tried in order until one succeeds.\n *\n * @remarks\n * This attestation carries both parties' uPnL plus a symbol price — the shape a\n * solver's `openPosition` call needs.\n *\n * @param config - The SDK config.\n * @param parameters - PartyB, partyA, symbol id, and optional chain id.\n * @returns The normalized `uPnlWithSymbolPrice` 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 getMuonUpnlWithSymbolPrice(config, {\n *   partyB: \"0xsolver…\",\n *   partyA: \"0xva…\",\n *   symbolId: 1n,\n * });\n * console.log(a.price, a.uPnlA, a.uPnlB);\n * ```\n */\nexport async function getMuonUpnlWithSymbolPrice(\n  config: Config,\n  parameters: GetMuonUpnlWithSymbolPriceParameters,\n): Promise<GetMuonUpnlWithSymbolPriceReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_WITH_SYMBOL_PRICE, {\n    partyB: parameters.partyB,\n    partyA: parameters.partyA,\n    chainId: chainId.toString(),\n    symbolId: parameters.symbolId.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    symbolId: parameters.symbolId,\n    price: muonBigInt(result.price),\n    uPnlA: muonBigInt(result.uPnlA),\n    uPnlB: muonBigInt(result.uPnlB),\n    quoteIdsA: muonBigIntArray(result.quoteIdsA),\n    quoteIdsB: muonBigIntArray(result.quoteIdsB),\n  };\n}\n"],"mappings":";;;AAwEA,eAAsB,EACpB,GACA,GAC+C;CAC/C,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAoC;EACzE,QAAQ,EAAW;EACnB,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,UAAU,EAAW,SAAS,SAAS;EACvC,QAAQ,EAAU;CACpB,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,QAAQ,EAAW;EACnB,QAAQ,EAAW;EACnB,UAAU,EAAW;EACrB,OAAO,EAAW,EAAO,KAAK;EAC9B,OAAO,EAAW,EAAO,KAAK;EAC9B,OAAO,EAAW,EAAO,KAAK;EAC9B,WAAW,EAAgB,EAAO,SAAS;EAC3C,WAAW,EAAgB,EAAO,SAAS;CAC7C;AACF"}
+{"version":3,"file":"get-muon-upnl-with-symbol-price.js","names":[],"sources":["../../../src/muon/upnl-with-symbol-price/get-muon-upnl-with-symbol-price.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_WITH_SYMBOL_PRICE, type MuonAttestationBase } from \"../types\";\n\n/** Parameters for {@link getMuonUpnlWithSymbolPrice}. */\nexport type GetMuonUpnlWithSymbolPriceParameters = Compute<\n  ChainIdParameter & {\n    /** The partyB (solver) side of the attestation. */\n    partyB: Address;\n    /** The partyA (virtual account, lowcap) to attest. */\n    partyA: Address;\n    /** The symbol id whose price is included in the attestation. */\n    symbolId: bigint;\n  }\n>;\n\n/**\n * Normalized `uPnlWithSymbolPrice` attestation: the shared signature envelope plus\n * both parties' computed uPnL fields and a single symbol price.\n *\n * @remarks\n * TODO(muon-verify): beyond `uPnl` (verified against the reference frontend), 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 GetMuonUpnlWithSymbolPriceReturnType extends MuonAttestationBase {\n  /** The attested partyB. */\n  partyB: Address;\n  /** The attested partyA. */\n  partyA: Address;\n  /** The symbol id the price is for. */\n  symbolId: bigint;\n  /** The attested symbol price (18-decimal). */\n  price?: bigint;\n  /** Signed unrealized PnL for partyA (18-decimal, signed). */\n  uPnlA?: bigint;\n  /** Signed unrealized PnL for partyB (18-decimal, signed). */\n  uPnlB?: bigint;\n  /** Quote ids included on partyA's side of the attestation. */\n  quoteIdsA: bigint[];\n  /** Quote ids included on partyB's side of the attestation. */\n  quoteIdsB: bigint[];\n}\n\n/**\n * Fetch a fresh Muon `uPnlWithSymbolPrice` attestation for a `partyB`/`partyA`\n * pair and a `symbolId`, normalized to typed fields. The oracle URLs and the\n * SYMMIO diamond address (the `symmio` request param) are resolved from `config`;\n * gateways are tried in order until one succeeds.\n *\n * @remarks\n * This attestation carries both parties' uPnL plus a symbol price — the shape a\n * solver's `openPosition` call needs.\n *\n * @param config - The SDK config.\n * @param parameters - PartyB, partyA, symbol id, and optional chain id.\n * @returns The normalized `uPnlWithSymbolPrice` 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 getMuonUpnlWithSymbolPrice(config, {\n *   partyB: \"0xsolver…\",\n *   partyA: \"0xva…\",\n *   symbolId: 1n,\n * });\n * console.log(a.price, a.uPnlA, a.uPnlB);\n * ```\n */\nexport async function getMuonUpnlWithSymbolPrice(\n  config: Config,\n  parameters: GetMuonUpnlWithSymbolPriceParameters,\n): Promise<GetMuonUpnlWithSymbolPriceReturnType> {\n  const { chainId, addresses, muon } = config.getChainConfig(parameters.chainId);\n  const raw = await fetchMuon(muon.urls, MUON_METHOD_UPNL_WITH_SYMBOL_PRICE, {\n    partyB: parameters.partyB,\n    partyA: parameters.partyA,\n    chainId: chainId.toString(),\n    symbolId: parameters.symbolId.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    symbolId: parameters.symbolId,\n    price: muonBigInt(result.price),\n    uPnlA: muonBigInt(result.uPnlA),\n    uPnlB: muonBigInt(result.uPnlB),\n    quoteIdsA: muonBigIntArray(result.quoteIdsA),\n    quoteIdsB: muonBigIntArray(result.quoteIdsB),\n  };\n}\n"],"mappings":";;;AAwEA,eAAsB,EACpB,GACA,GAC+C;CAC/C,IAAM,EAAE,YAAS,cAAW,YAAS,EAAO,eAAe,EAAW,OAAO,GACvE,IAAM,MAAM,EAAU,EAAK,MAAM,GAAoC;EACzE,QAAQ,EAAW;EACnB,QAAQ,EAAW;EACnB,SAAS,EAAQ,SAAS;EAC1B,UAAU,EAAW,SAAS,SAAS;EACvC,QAAQ,EAAU;CACpB,CAAC,GACK,IAAS,EAAI,KAAK;CACxB,OAAO;EACL,GAAG,EAAsB,CAAG;EAC5B,QAAQ,EAAW;EACnB,QAAQ,EAAW;EACnB,UAAU,EAAW;EACrB,OAAO,EAAW,EAAO,KAAK;EAC9B,OAAO,EAAW,EAAO,KAAK;EAC9B,OAAO,EAAW,EAAO,KAAK;EAC9B,WAAW,EAAgB,EAAO,SAAS;EAC3C,WAAW,EAAgB,EAAO,SAAS;CAC7C;AACF"}

package/dist/notifications/search/adapters/enigma-search.d.ts

@@ -0,0 +1,14 @@
+import { SymmioResolvedSolver } from '../../../core/chains/index.js';
+import { EnigmaNotificationSearchResult, SearchNotificationsParameters } from '../types.js';
+/**
+ * Search an enigma solver's stored notifications via the standalone notification
+ * service's `POST /api/v1/search`. The base URL resolves from the solver's
+ * `notifications.searchUrl`, or the per-call `baseUrl` override.
+ *
+ * @throws {SymmError} `NOTIFICATION_SEARCH_URL_NOT_CONFIGURED` when neither is set.
+ * @throws {SymmApiError} when the request fails.
+ *
+ * @internal
+ */
+export declare function searchEnigmaNotifications(solver: SymmioResolvedSolver, parameters: SearchNotificationsParameters): Promise<EnigmaNotificationSearchResult>;
+//# sourceMappingURL=enigma-search.d.ts.map

package/dist/notifications/search/adapters/enigma-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enigma-search.d.ts","sourceRoot":"","sources":["../../../../src/notifications/search/adapters/enigma-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,KAAK,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAkB9F;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,8BAA8B,CAAC,CA4BzC"}