@symmio/trading-core 1.1.0 → 2.0.0

package/dist/core/chains/resolve-solver.js

@@ -0,0 +1,14 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+//#region src/core/chains/resolve-solver.ts
+function t(t, n) {
+	let r = n ?? t.defaultSolverId, i = t.solvers[r];
+	if (!i) throw new e("config", "UNKNOWN_SOLVER", `Unknown solver id "${r}" for chain ${t.chainId}.`);
+	return {
+		...i,
+		id: r
+	};
+}
+//#endregion
+export { t as resolveSolver };
+
+//# sourceMappingURL=resolve-solver.js.map

package/dist/core/chains/resolve-solver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-solver.js","names":[],"sources":["../../../src/core/chains/resolve-solver.ts"],"sourcesContent":["import { SymmError } from \"../../shared/errors/symm-error\";\nimport type { SolverId, SymmioChainConfig, SymmioResolvedSolver } from \"./types\";\n\n/**\n * Resolve a chain's solver by id. When `solverId` is omitted, the chain's\n * `defaultSolverId` is used. Returns the stored config with its resolved `id`\n * (which is the solver's kind) attached, so callers can dispatch by kind without\n * re-deriving it.\n *\n * @throws {SymmError} `UNKNOWN_SOLVER` when no solver with that id is configured\n *   for the chain.\n *\n * @internal\n */\nexport function resolveSolver(chainConfig: SymmioChainConfig, solverId?: SolverId): SymmioResolvedSolver {\n  const id = solverId ?? chainConfig.defaultSolverId;\n  const solver = chainConfig.solvers[id];\n  if (!solver) {\n    throw new SymmError(\"config\", \"UNKNOWN_SOLVER\", `Unknown solver id \"${id}\" for chain ${chainConfig.chainId}.`);\n  }\n\n  return { ...solver, id };\n}\n"],"mappings":";;AAcA,SAAgB,EAAc,GAAgC,GAA2C;CACvG,IAAM,IAAK,KAAY,EAAY,iBAC7B,IAAS,EAAY,QAAQ;CACnC,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,UAAU,kBAAkB,sBAAsB,EAAG,cAAc,EAAY,QAAQ,EAAE;CAG/G,OAAO;EAAE,GAAG;EAAQ;CAAG;AACzB"}

package/dist/core/chains/solver-support.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Throw when a configured solver's id (its registry key, which is its kind) is
+ * not one the SDK can serve — not in {@link SUPPORTED_SOLVER_KINDS}, the single
+ * source the `SymmioSolverKind` union is derived from. Called by `createConfig`
+ * for every solver on every chain, so an unsupported solver fails fast at
+ * config-build time rather than at the first read that would misinterpret its
+ * payload.
+ *
+ * @throws {SymmError} `UNSUPPORTED_SOLVER_KIND` when the id is unknown.
+ *
+ * @internal
+ */
+export declare function assertSupportedSolver(chainId: number, solverId: string): void;
+//# sourceMappingURL=solver-support.d.ts.map

package/dist/core/chains/solver-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver-support.d.ts","sourceRoot":"","sources":["../../../src/core/chains/solver-support.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU7E"}

package/dist/core/chains/solver-support.js

@@ -0,0 +1,10 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { SUPPORTED_SOLVER_KINDS as t } from "./types.js";
+//#region src/core/chains/solver-support.ts
+function n(n, r) {
+	if (!t.includes(r)) throw new e("config", "UNSUPPORTED_SOLVER_KIND", `createConfig: solver "${r}" on chain ${n} is not a supported kind. Supported kinds: ${t.join(", ")}. Add its strategy before registering it.`);
+}
+//#endregion
+export { n as assertSupportedSolver };
+
+//# sourceMappingURL=solver-support.js.map

package/dist/core/chains/solver-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver-support.js","names":[],"sources":["../../../src/core/chains/solver-support.ts"],"sourcesContent":["import { SymmError } from \"../../shared/errors/symm-error\";\nimport { SUPPORTED_SOLVER_KINDS } from \"./types\";\n\n/**\n * Throw when a configured solver's id (its registry key, which is its kind) is\n * not one the SDK can serve — not in {@link SUPPORTED_SOLVER_KINDS}, the single\n * source the `SymmioSolverKind` union is derived from. Called by `createConfig`\n * for every solver on every chain, so an unsupported solver fails fast at\n * config-build time rather than at the first read that would misinterpret its\n * payload.\n *\n * @throws {SymmError} `UNSUPPORTED_SOLVER_KIND` when the id is unknown.\n *\n * @internal\n */\nexport function assertSupportedSolver(chainId: number, solverId: string): void {\n  // The union types the key, but the runtime config may come from untyped JSON,\n  // so treat a miss as possible.\n  if (!(SUPPORTED_SOLVER_KINDS as readonly string[]).includes(solverId)) {\n    throw new SymmError(\n      \"config\",\n      \"UNSUPPORTED_SOLVER_KIND\",\n      `createConfig: solver \"${solverId}\" on chain ${chainId} is not a supported kind. Supported kinds: ${SUPPORTED_SOLVER_KINDS.join(\", \")}. Add its strategy before registering it.`,\n    );\n  }\n}\n"],"mappings":";;;AAeA,SAAgB,EAAsB,GAAiB,GAAwB;CAG7E,IAAI,CAAE,EAA6C,SAAS,CAAQ,GAClE,MAAM,IAAI,EACR,UACA,2BACA,yBAAyB,EAAS,aAAa,EAAQ,6CAA6C,EAAuB,KAAK,IAAI,EAAE,0CACxI;AAEJ"}

package/dist/core/chains/supported-chains.d.ts

@@ -6,6 +6,8 @@
  */
 export declare enum SymmioSupportedChainId {
     /** HyperEVM mainnet (chain ID 999) */
-    HYPER_EVM = 999
+    HYPER_EVM = 999,
+    /** Base mainnet (chain ID 8453) */
+    BASE = 8453
 }
 //# sourceMappingURL=supported-chains.d.ts.map

package/dist/core/chains/supported-chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supported-chains.d.ts","sourceRoot":"","sources":["../../../src/core/chains/supported-chains.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,sBAAsB;IAChC,sCAAsC;IACtC,SAAS,MAAM;CAChB"}
+{"version":3,"file":"supported-chains.d.ts","sourceRoot":"","sources":["../../../src/core/chains/supported-chains.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,sBAAsB;IAChC,sCAAsC;IACtC,SAAS,MAAM;IACf,mCAAmC;IACnC,IAAI,OAAO;CACZ"}

package/dist/core/chains/supported-chains.js

@@ -1,6 +1,6 @@
 //#region src/core/chains/supported-chains.ts
 var e = /* @__PURE__ */ function(e) {
-	return e[e.HYPER_EVM = 999] = "HYPER_EVM", e;
+	return e[e.HYPER_EVM = 999] = "HYPER_EVM", e[e.BASE = 8453] = "BASE", e;
 }({});
 //#endregion
 export { e as SymmioSupportedChainId };

package/dist/core/chains/supported-chains.js.map

@@ -1 +1 @@
-{"version":3,"file":"supported-chains.js","names":[],"sources":["../../../src/core/chains/supported-chains.ts"],"sourcesContent":["/**\n * Chain IDs with built-in SYMMIO deployment configs.\n *\n * Use these values when calling SDK functions that require a chain ID.\n * The SDK ships production and staging configs for each supported chain.\n */\nexport enum SymmioSupportedChainId {\n  /** HyperEVM mainnet (chain ID 999) */\n  HYPER_EVM = 999,\n}\n"],"mappings":";AAMA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,EAAA,YAAA,OAAA;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"supported-chains.js","names":[],"sources":["../../../src/core/chains/supported-chains.ts"],"sourcesContent":["/**\n * Chain IDs with built-in SYMMIO deployment configs.\n *\n * Use these values when calling SDK functions that require a chain ID.\n * The SDK ships production and staging configs for each supported chain.\n */\nexport enum SymmioSupportedChainId {\n  /** HyperEVM mainnet (chain ID 999) */\n  HYPER_EVM = 999,\n  /** Base mainnet (chain ID 8453) */\n  BASE = 8453,\n}\n"],"mappings":";AAMA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,EAAA,YAAA,OAAA,aAEA,EAAA,EAAA,OAAA,QAAA;AACF,EAAA,CAAA,CAAA"}

package/dist/core/chains/types.d.ts

@@ -32,13 +32,73 @@ export interface SymmioSubgraphUrls {
  * union grows automatically as endpoints are added.
  */
 export type SymmioSubgraphName = keyof SymmioSubgraphUrls;
+/**
+ * A solver's id within a chain config — its registry key. Equal to its
+ * {@link SymmioSolverKind}: each chain registers at most one solver per kind, so
+ * the id *is* the kind (`"enigma" | "rasa"`). Closed for that reason.
+ */
+export type SolverId = SymmioSolverKind;
+/**
+ * The solver kinds the SDK can actually serve — one generated client and
+ * behavior set per entry. Single source of truth: {@link SymmioSolverKind} is
+ * derived from this list, and `createConfig` validates every configured solver
+ * against it (`assertSupportedSolver` in `solver-support.ts`). To add a kind,
+ * append it here and ship its generated client + dispatch in the same change.
+ *
+ * @internal
+ */
+export declare const SUPPORTED_SOLVER_KINDS: readonly ["enigma", "rasa"];
+/**
+ * Schema family a solver's REST API speaks — the discriminant used to select a
+ * generated client. Closed (derived from {@link SUPPORTED_SOLVER_KINDS}): the
+ * SDK ships one client per kind, so dispatch must be exhaustive.
+ *
+ * There is deliberately no version axis: each SDK release supports exactly one
+ * API generation per kind. When a solver ships a new API generation, the SDK
+ * regenerates that kind's client in a new release — consumers pick the
+ * generation by pinning the SDK version, not through config.
+ */
+export type SymmioSolverKind = (typeof SUPPORTED_SOLVER_KINDS)[number];
 /**
  * Solver / hedger configuration for a SYMMIO chain deployment.
  *
  * In this SDK a "solver" is the same actor that fronts the lowcap hedger REST
  * API (`/instant_trade/instant_open`, `/contract-symbols`, …) and acts as
  * `partyB` on-chain. Its `url` is the API base URL, its `address` is partyB.
+ *
+ * Solvers live under {@link SymmioChainConfig.solvers}, keyed by
+ * {@link SolverId} — the key is the solver's id, which is also its kind, so the
+ * kind is not repeated here. `config.getSolver({ chainId, solverId })` returns a
+ * {@link SymmioResolvedSolver} (this config plus its resolved `id`).
+ */
+/**
+ * Per-solver capability flags. Gate SDK flows and UI on these so a solver that
+ * lacks a feature degrades gracefully instead of erroring. Unset flags default
+ * to `false` — a solver must **declare** a capability to enable it.
  */
+export interface SolverCapabilitiesConfig {
+    /**
+     * Whether the solver supports closing a whole market + side group of quotes in
+     * one flow. Enigma (Virtual-Account isolation, one VA per market + side)
+     * supports it; rasa (cross-margin) does not. Default `false`.
+     */
+    groupClose?: boolean;
+    /**
+     * Whether the solver supports LIMIT orders — placing a pending open at a
+     * user-set price. Majors (rasa) support it; enigma (lowcap) does not. Default
+     * `false`.
+     */
+    limitOrder?: boolean;
+    /**
+     * Whether this solver's markets are the lowcap **Pools** (listing service).
+     * Purely declarative: the SDK's listing functions resolve the listing backend
+     * **at chain level** ({@link SymmioChainConfig.listing}) and do **not** gate on
+     * this flag. It exists so config can express which solvers do listing, readable
+     * via `getSolverCapabilities`. Enigma (lowcap) declares it; rasa does not.
+     * Default `false`.
+     */
+    listingService?: boolean;
+}
 export interface SymmioSolverConfig {
     /** Human-readable solver name */
     name: string;
@@ -48,6 +108,37 @@ export interface SymmioSolverConfig {
     url: string;
     /** Optional TP/SL handler — solver supports conditional orders only when set. */
     tpsl?: SymmioTpSlConfig;
+    /**
+     * Price source for **this solver's** markets. Falls back to the chain's
+     * {@link SymmioChainConfig.priceService} when omitted, so set it only where a
+     * solver diverges from the chain default — do not duplicate the default.
+     *
+     * Needed because a chain may register several solvers that price differently:
+     * a lowcap solver reads its own price service while a majors solver reads
+     * Binance. A single chain-level value cannot be right for both.
+     */
+    priceService?: SymmioPriceServiceConfig;
+    /**
+     * Notifications endpoint for **this solver's** position/quote state stream and
+     * history search. Required per solver: notifications are inherently
+     * solver-specific — the enigma `channel` and the rasa position-state URL are
+     * the solver's own — so there is no chain-level default to inherit.
+     */
+    notifications: SymmioNotificationsConfig;
+    /**
+     * Optional per-solver capability flags. Gate SDK flows and UI on these
+     * ({@link SolverCapabilitiesConfig}); unset flags default to `false`.
+     */
+    capabilities?: SolverCapabilitiesConfig;
+}
+/**
+ * A {@link SymmioSolverConfig} resolved from the registry, with its `id`
+ * attached. The `id` is the solver's kind (`"enigma" | "rasa"`) and drives
+ * per-kind dispatch inside solver actions. Returned by `config.getSolver`.
+ */
+export interface SymmioResolvedSolver extends SymmioSolverConfig {
+    /** The resolved solver id — equal to its kind. */
+    id: SolverId;
 }
 /**
  * TP/SL (Conditional Order Handler) configuration for a solver.
@@ -60,49 +151,76 @@ export interface SymmioSolverConfig {
 export interface SymmioTpSlConfig {
     /** Handler REST root URL (no `/api/v5/` suffix — orval-generated paths add it). */
     url: string;
-    /** Handler WebSocket URL — defilytics-protocol notifications scoped by `appName`. */
+    /** Handler WebSocket URL — enigma-protocol notifications scoped by `appName`. */
     wsUrl: string;
     /** `App-Name` header value, e.g. `Hyper-EVM_COH-Low-Cap_Production`. */
     appName: string;
     /** COH wallet address that must be granted delegation to execute TP/SL orders. */
     cohWalletAddress: Address;
 }
+/**
+ * The price providers the SDK ships a client for. Closed: it drives exhaustive
+ * dispatch in `getMarkPrices` / `watchPrices`, and `createConfig` validates every
+ * configured price service against it (`assertSupportedPriceServiceType` in
+ * `price-service-support.ts`). To add a provider, append it here and ship its
+ * adapter + dispatch in the same change.
+ *
+ * @internal
+ */
+export declare const SUPPORTED_PRICE_SERVICE_TYPES: readonly ["enigma", "binance"];
 /**
  * Supported price-service providers.
+ *
+ * A **second, independent axis** from {@link SymmioSolverKind}: a Rasa solver is
+ * priced off Binance today, and nothing in the type system ties the two
+ * together. The provider is *derived* from `{ chainId, solverId }` via
+ * `solver.priceService ?? chain.priceService` — never selected per call.
  */
-export type SymmioPriceServiceType = "enigma";
+export type SymmioPriceServiceType = (typeof SUPPORTED_PRICE_SERVICE_TYPES)[number];
 /**
  * Price-service configuration for a SYMMIO chain deployment.
+ *
+ * Both URLs stay **required, including for Binance**. Binance's endpoints are
+ * public constants, but keeping them in config is the geo-restriction escape
+ * hatch: an integrator whose users are in a blocked region repoints both at
+ * their own proxy with no SDK change.
  */
 export interface SymmioPriceServiceConfig {
-    /** Price-service provider type */
+    /** Price-service provider type. Selects which client the SDK uses. */
     type: SymmioPriceServiceType;
-    /** Price-service API base URL */
+    /**
+     * REST host root, no trailing slash — the client appends the provider's path.
+     * `enigma`: `https://lowcap-price.enigma.bz` (+ `/api/v1/prices/names`).
+     * `binance`: `https://fapi.binance.com` (+ `/fapi/v1/premiumIndex`).
+     */
     url: string;
-    /** WebSocket URL for live mark-price broadcasts. */
+    /**
+     * **Full** WebSocket endpoint — the exact URL the SDK dials, identically for
+     * every provider, so nothing downstream needs to know which provider it holds.
+     * `enigma`: `wss://lowcap-price.enigma.bz/ws`.
+     * `binance`: `wss://fstream.binance.com/market/ws/!markPrice@arr@1s`.
+     */
     wsUrl: string;
 }
 /**
- * Wire protocol a notifications endpoint speaks.
+ * Wire protocol a notifications endpoint speaks. Closed: it drives exhaustive
+ * dispatch in `watchNotifications` / `parseNotificationFrame`; to add a
+ * protocol, append it here and ship its subscribe + parse path in the same
+ * change.
  *
- * - `defilytics` — the lowcap solver endpoint (`…/ws/v1/subscribe`). Subscribes
+ * - `enigma` — the lowcap solver endpoint (`…/ws/v1/subscribe`). Subscribes
  *   with a `channel_patterns` frame and wraps each push as `{ data, address }`.
+ * - `rasa` — the Rasa position-state endpoint (`…/ws/position-state-ws3`).
+ *   Subscribes with an `{ address: [...] }` frame (one socket can carry many
+ *   SubAccounts) and pushes bare notification frames, no envelope.
  */
-export type SymmioNotificationsProtocol = "defilytics";
+export type SymmioNotificationsProtocol = "enigma" | "rasa";
 /**
- * Notifications WebSocket configuration for a SYMMIO chain deployment.
- *
- * The notifications endpoint streams position/quote state transitions (instant
- * open/close confirmations, fills, cancels, liquidations) for a SubAccount. It
- * is a push channel, not a REST endpoint — `url` is a `ws://`/`wss://` URL.
+ * Fields every notifications endpoint shares, regardless of wire protocol.
  */
-export interface SymmioNotificationsConfig {
+interface SymmioNotificationsConfigBase {
     /** Notifications WebSocket URL (`wss://…`). */
     url: string;
-    /** Channel / `app_name` the subscribe frame targets on this endpoint. */
-    channel: string;
-    /** Wire protocol the endpoint speaks. */
-    protocol: SymmioNotificationsProtocol;
     /**
      * Base URL of the notification REST service that backs `searchNotifications`
      * (`POST /api/v1/search`), e.g. `https://notification.rasa.capital/notification`.
@@ -110,6 +228,34 @@ export interface SymmioNotificationsConfig {
      */
     searchUrl?: string;
 }
+/**
+ * Notifications endpoint speaking the `enigma` protocol (the lowcap
+ * solver's channel-scoped stream).
+ */
+export interface SymmioEnigmaNotificationsConfig extends SymmioNotificationsConfigBase {
+    /** Wire protocol the endpoint speaks. */
+    protocol: "enigma";
+    /** Channel / `app_name` the subscribe frame targets on this endpoint. */
+    channel: string;
+}
+/**
+ * Notifications endpoint speaking the `rasa` position-state protocol. No
+ * channel — the subscribe frame is just the watched SubAccount addresses.
+ */
+export interface SymmioRasaNotificationsConfig extends SymmioNotificationsConfigBase {
+    /** Wire protocol the endpoint speaks. */
+    protocol: "rasa";
+}
+/**
+ * Notifications WebSocket configuration for a SYMMIO chain deployment.
+ *
+ * The notifications endpoint streams position/quote state transitions (instant
+ * open/close confirmations, fills, cancels, liquidations) for a SubAccount. It
+ * is a push channel, not a REST endpoint — `url` is a `ws://`/`wss://` URL.
+ * Discriminated on `protocol`; narrow to reach protocol-specific fields
+ * (e.g. the enigma `channel`).
+ */
+export type SymmioNotificationsConfig = SymmioEnigmaNotificationsConfig | SymmioRasaNotificationsConfig;
 /**
  * Muon oracle configuration for a SYMMIO chain deployment.
  *
@@ -124,6 +270,56 @@ export interface SymmioMuonConfig {
     /** Muon oracle gateway base URLs, tried in order (fallback on failure). */
     urls: readonly string[];
 }
+/**
+ * Pools **listing backend** configuration for a SYMMIO chain deployment.
+ *
+ * The listing backend is an auth'd REST service that owns the lowcap Pools flow
+ * — the pool catalogue, per-pool stats, a user's stake/rewards, and the
+ * create/deposit/withdraw/claim actions. It is chain-level: one listing backend
+ * is served per chain (a chain has at most one), with no solver or capability
+ * involved. Present only where Pools is available (Enigma on HyperEVM); omitted
+ * elsewhere.
+ *
+ * One deployment serves listings whose collateral was deposited on **several**
+ * chains — a catalogue row's `chainId` is the token's deposit chain, which is
+ * not the chain the resulting market trades on.
+ */
+export interface SymmioListingConfig {
+    /**
+     * Listing backend **host root** — no version segment and no trailing slash
+     * (e.g. `https://listing85.enigma.bz`, staging
+     * `https://listing-staging.enigma.bz`).
+     *
+     * The generated client's own paths already begin with `/v2`, so a versioned
+     * base URL here would request `/v2/v2/market/search` and 404. Point this at
+     * staging with a `createConfig` override — there is no separate environment
+     * axis.
+     */
+    url: string;
+}
+/**
+ * Inventory-service configuration for a SYMMIO chain deployment.
+ *
+ * The inventory service is the custody backend behind the lowcap Pools: it holds
+ * the per-market token and collateral inventory that backs trading, and reports
+ * the system-wide TVL those balances add up to. It is a **separate vendor** from
+ * both the solver and the {@link SymmioListingConfig} listing backend, with its
+ * own deployment and its own OpenAPI spec.
+ *
+ * Chain-level and optional, like `listing`: present where lowcap Pools are
+ * available, omitted elsewhere.
+ */
+export interface SymmioInventoryConfig {
+    /**
+     * Inventory service **host root** — no path segment and no trailing slash
+     * (e.g. `https://inventory85.enigma.bz`, staging
+     * `https://inventory-staging.enigma.bz`).
+     *
+     * The generated client's own paths already begin with `/api/v1`, so appending
+     * `/api` here would request `/api/api/v1/...` and 404.
+     */
+    url: string;
+}
 /**
  * Complete resolved configuration for a SYMMIO chain deployment.
  */
@@ -134,13 +330,31 @@ export interface SymmioChainConfig {
     addresses: SymmioContractAddresses;
     /** Subgraph endpoints */
     subgraphs: SymmioSubgraphUrls;
-    /** Solver / hedger configuration */
-    solver: SymmioSolverConfig;
+    /**
+     * Solvers available on this chain, keyed by {@link SolverId} (which is the
+     * solver's kind). A chain registers a subset of the kinds, so this is partial.
+     * Resolve one with `config.getSolver({ chainId, solverId })`, which defaults to
+     * {@link defaultSolverId} when `solverId` is omitted.
+     */
+    solvers: Partial<Record<SolverId, SymmioSolverConfig>>;
+    /** Id of the solver an action targets on this chain when `solverId` is omitted. */
+    defaultSolverId: SolverId;
     /** Price-service configuration */
     priceService: SymmioPriceServiceConfig;
-    /** Notifications WebSocket configuration */
-    notifications: SymmioNotificationsConfig;
     /** Muon oracle configuration */
     muon: SymmioMuonConfig;
+    /**
+     * Optional Pools listing backend, served per chain. Set on chains where the
+     * lowcap Pools flow is available (Enigma on HyperEVM); omitted elsewhere.
+     * Resolve it with `resolveListingService` / gate on `supportsListingService`.
+     */
+    listing?: SymmioListingConfig;
+    /**
+     * Optional inventory service — the custody backend behind lowcap Pools, and
+     * the source of system-wide TVL. Set alongside {@link SymmioChainConfig.listing};
+     * resolve it with `resolveInventoryService`.
+     */
+    inventory?: SymmioInventoryConfig;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/core/chains/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/chains/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sDAAsD;IACtD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uCAAuC;IACvC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,kBAAkB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAC;IACZ,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG,YAAY,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,QAAQ,EAAE,2BAA2B,CAAC;IACtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,uBAAuB,CAAC;IACnC,yBAAyB;IACzB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,oCAAoC;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kCAAkC;IAClC,YAAY,EAAE,wBAAwB,CAAC;IACvC,4CAA4C;IAC5C,aAAa,EAAE,yBAAyB,CAAC;IACzC,gCAAgC;IAChC,IAAI,EAAE,gBAAgB,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/chains/types.ts"],"names":[],"mappings":"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"}

package/dist/core/chains/types.js

@@ -0,0 +1,6 @@
+//#region src/core/chains/types.ts
+var e = ["enigma", "rasa"], t = ["enigma", "binance"];
+//#endregion
+export { t as SUPPORTED_PRICE_SERVICE_TYPES, e as SUPPORTED_SOLVER_KINDS };
+
+//# sourceMappingURL=types.js.map

package/dist/core/chains/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/core/chains/types.ts"],"sourcesContent":["import type { Address } from \"viem\";\n\n/**\n * Contract addresses for a SYMMIO chain deployment.\n */\nexport interface SymmioContractAddresses {\n  /** Main SYMMIO diamond contract */\n  symmioAddress: Address;\n  /** InstantLayer contract for instant actions */\n  instantLayerAddress: Address;\n  /** AccountLayer contract for subaccount management */\n  accountLayerAddress: Address;\n  /** Affiliates registry contract */\n  affiliatesAddress: Address;\n  /** Collateral token address (e.g. USDC) */\n  collateralAddress: Address;\n  /** Decimals of the collateral token */\n  collateralDecimals: number;\n}\n\n/**\n * Subgraph endpoints for a SYMMIO chain deployment.\n */\nexport interface SymmioSubgraphUrls {\n  /** Analytics subgraph for aggregated data (balance changes, quotes, history). */\n  analytics: string;\n  /** Events subgraph for raw on-chain events (e.g. `internalTransfers`). */\n  events: string;\n}\n\n/**\n * Name of a configured subgraph endpoint (a key of {@link SymmioSubgraphUrls}).\n *\n * Used to pick which subgraph an action queries (`\"analytics\"` | `\"events\"`); the\n * union grows automatically as endpoints are added.\n */\nexport type SymmioSubgraphName = keyof SymmioSubgraphUrls;\n\n/**\n * A solver's id within a chain config — its registry key. Equal to its\n * {@link SymmioSolverKind}: each chain registers at most one solver per kind, so\n * the id *is* the kind (`\"enigma\" | \"rasa\"`). Closed for that reason.\n */\nexport type SolverId = SymmioSolverKind;\n\n/**\n * The solver kinds the SDK can actually serve — one generated client and\n * behavior set per entry. Single source of truth: {@link SymmioSolverKind} is\n * derived from this list, and `createConfig` validates every configured solver\n * against it (`assertSupportedSolver` in `solver-support.ts`). To add a kind,\n * append it here and ship its generated client + dispatch in the same change.\n *\n * @internal\n */\nexport const SUPPORTED_SOLVER_KINDS = [\"enigma\", \"rasa\"] as const;\n\n/**\n * Schema family a solver's REST API speaks — the discriminant used to select a\n * generated client. Closed (derived from {@link SUPPORTED_SOLVER_KINDS}): the\n * SDK ships one client per kind, so dispatch must be exhaustive.\n *\n * There is deliberately no version axis: each SDK release supports exactly one\n * API generation per kind. When a solver ships a new API generation, the SDK\n * regenerates that kind's client in a new release — consumers pick the\n * generation by pinning the SDK version, not through config.\n */\nexport type SymmioSolverKind = (typeof SUPPORTED_SOLVER_KINDS)[number];\n\n/**\n * Solver / hedger configuration for a SYMMIO chain deployment.\n *\n * In this SDK a \"solver\" is the same actor that fronts the lowcap hedger REST\n * API (`/instant_trade/instant_open`, `/contract-symbols`, …) and acts as\n * `partyB` on-chain. Its `url` is the API base URL, its `address` is partyB.\n *\n * Solvers live under {@link SymmioChainConfig.solvers}, keyed by\n * {@link SolverId} — the key is the solver's id, which is also its kind, so the\n * kind is not repeated here. `config.getSolver({ chainId, solverId })` returns a\n * {@link SymmioResolvedSolver} (this config plus its resolved `id`).\n */\n/**\n * Per-solver capability flags. Gate SDK flows and UI on these so a solver that\n * lacks a feature degrades gracefully instead of erroring. Unset flags default\n * to `false` — a solver must **declare** a capability to enable it.\n */\nexport interface SolverCapabilitiesConfig {\n  /**\n   * Whether the solver supports closing a whole market + side group of quotes in\n   * one flow. Enigma (Virtual-Account isolation, one VA per market + side)\n   * supports it; rasa (cross-margin) does not. Default `false`.\n   */\n  groupClose?: boolean;\n  /**\n   * Whether the solver supports LIMIT orders — placing a pending open at a\n   * user-set price. Majors (rasa) support it; enigma (lowcap) does not. Default\n   * `false`.\n   */\n  limitOrder?: boolean;\n  /**\n   * Whether this solver's markets are the lowcap **Pools** (listing service).\n   * Purely declarative: the SDK's listing functions resolve the listing backend\n   * **at chain level** ({@link SymmioChainConfig.listing}) and do **not** gate on\n   * this flag. It exists so config can express which solvers do listing, readable\n   * via `getSolverCapabilities`. Enigma (lowcap) declares it; rasa does not.\n   * Default `false`.\n   */\n  listingService?: boolean;\n}\n\nexport interface SymmioSolverConfig {\n  /** Human-readable solver name */\n  name: string;\n  /** Solver's on-chain address (used as `partyB` in `sendQuoteWithAffiliateAndData`) */\n  address: Address;\n  /** Solver / hedger API base URL */\n  url: string;\n  /** Optional TP/SL handler — solver supports conditional orders only when set. */\n  tpsl?: SymmioTpSlConfig;\n  /**\n   * Price source for **this solver's** markets. Falls back to the chain's\n   * {@link SymmioChainConfig.priceService} when omitted, so set it only where a\n   * solver diverges from the chain default — do not duplicate the default.\n   *\n   * Needed because a chain may register several solvers that price differently:\n   * a lowcap solver reads its own price service while a majors solver reads\n   * Binance. A single chain-level value cannot be right for both.\n   */\n  priceService?: SymmioPriceServiceConfig;\n  /**\n   * Notifications endpoint for **this solver's** position/quote state stream and\n   * history search. Required per solver: notifications are inherently\n   * solver-specific — the enigma `channel` and the rasa position-state URL are\n   * the solver's own — so there is no chain-level default to inherit.\n   */\n  notifications: SymmioNotificationsConfig;\n  /**\n   * Optional per-solver capability flags. Gate SDK flows and UI on these\n   * ({@link SolverCapabilitiesConfig}); unset flags default to `false`.\n   */\n  capabilities?: SolverCapabilitiesConfig;\n}\n\n/**\n * A {@link SymmioSolverConfig} resolved from the registry, with its `id`\n * attached. The `id` is the solver's kind (`\"enigma\" | \"rasa\"`) and drives\n * per-kind dispatch inside solver actions. Returned by `config.getSolver`.\n */\nexport interface SymmioResolvedSolver extends SymmioSolverConfig {\n  /** The resolved solver id — equal to its kind. */\n  id: SolverId;\n}\n\n/**\n * TP/SL (Conditional Order Handler) configuration for a solver.\n *\n * The handler is an off-chain service that signs and executes\n * `requestToClosePosition` calls when the user's TP/SL trigger fires. To\n * authorize it, every user must grant a delegation to {@link cohWalletAddress}\n * for the standard instant-trade selectors.\n */\nexport interface SymmioTpSlConfig {\n  /** Handler REST root URL (no `/api/v5/` suffix — orval-generated paths add it). */\n  url: string;\n  /** Handler WebSocket URL — enigma-protocol notifications scoped by `appName`. */\n  wsUrl: string;\n  /** `App-Name` header value, e.g. `Hyper-EVM_COH-Low-Cap_Production`. */\n  appName: string;\n  /** COH wallet address that must be granted delegation to execute TP/SL orders. */\n  cohWalletAddress: Address;\n}\n\n/**\n * The price providers the SDK ships a client for. Closed: it drives exhaustive\n * dispatch in `getMarkPrices` / `watchPrices`, and `createConfig` validates every\n * configured price service against it (`assertSupportedPriceServiceType` in\n * `price-service-support.ts`). To add a provider, append it here and ship its\n * adapter + dispatch in the same change.\n *\n * @internal\n */\nexport const SUPPORTED_PRICE_SERVICE_TYPES = [\"enigma\", \"binance\"] as const;\n\n/**\n * Supported price-service providers.\n *\n * A **second, independent axis** from {@link SymmioSolverKind}: a Rasa solver is\n * priced off Binance today, and nothing in the type system ties the two\n * together. The provider is *derived* from `{ chainId, solverId }` via\n * `solver.priceService ?? chain.priceService` — never selected per call.\n */\nexport type SymmioPriceServiceType = (typeof SUPPORTED_PRICE_SERVICE_TYPES)[number];\n\n/**\n * Price-service configuration for a SYMMIO chain deployment.\n *\n * Both URLs stay **required, including for Binance**. Binance's endpoints are\n * public constants, but keeping them in config is the geo-restriction escape\n * hatch: an integrator whose users are in a blocked region repoints both at\n * their own proxy with no SDK change.\n */\nexport interface SymmioPriceServiceConfig {\n  /** Price-service provider type. Selects which client the SDK uses. */\n  type: SymmioPriceServiceType;\n  /**\n   * REST host root, no trailing slash — the client appends the provider's path.\n   * `enigma`: `https://lowcap-price.enigma.bz` (+ `/api/v1/prices/names`).\n   * `binance`: `https://fapi.binance.com` (+ `/fapi/v1/premiumIndex`).\n   */\n  url: string;\n  /**\n   * **Full** WebSocket endpoint — the exact URL the SDK dials, identically for\n   * every provider, so nothing downstream needs to know which provider it holds.\n   * `enigma`: `wss://lowcap-price.enigma.bz/ws`.\n   * `binance`: `wss://fstream.binance.com/market/ws/!markPrice@arr@1s`.\n   */\n  wsUrl: string;\n}\n\n/**\n * Wire protocol a notifications endpoint speaks. Closed: it drives exhaustive\n * dispatch in `watchNotifications` / `parseNotificationFrame`; to add a\n * protocol, append it here and ship its subscribe + parse path in the same\n * change.\n *\n * - `enigma` — the lowcap solver endpoint (`…/ws/v1/subscribe`). Subscribes\n *   with a `channel_patterns` frame and wraps each push as `{ data, address }`.\n * - `rasa` — the Rasa position-state endpoint (`…/ws/position-state-ws3`).\n *   Subscribes with an `{ address: [...] }` frame (one socket can carry many\n *   SubAccounts) and pushes bare notification frames, no envelope.\n */\nexport type SymmioNotificationsProtocol = \"enigma\" | \"rasa\";\n\n/**\n * Fields every notifications endpoint shares, regardless of wire protocol.\n */\ninterface SymmioNotificationsConfigBase {\n  /** Notifications WebSocket URL (`wss://…`). */\n  url: string;\n  /**\n   * Base URL of the notification REST service that backs `searchNotifications`\n   * (`POST /api/v1/search`), e.g. `https://notification.rasa.capital/notification`.\n   * Optional — when unset, `searchNotifications` requires a per-call `baseUrl`.\n   */\n  searchUrl?: string;\n}\n\n/**\n * Notifications endpoint speaking the `enigma` protocol (the lowcap\n * solver's channel-scoped stream).\n */\nexport interface SymmioEnigmaNotificationsConfig extends SymmioNotificationsConfigBase {\n  /** Wire protocol the endpoint speaks. */\n  protocol: \"enigma\";\n  /** Channel / `app_name` the subscribe frame targets on this endpoint. */\n  channel: string;\n}\n\n/**\n * Notifications endpoint speaking the `rasa` position-state protocol. No\n * channel — the subscribe frame is just the watched SubAccount addresses.\n */\nexport interface SymmioRasaNotificationsConfig extends SymmioNotificationsConfigBase {\n  /** Wire protocol the endpoint speaks. */\n  protocol: \"rasa\";\n}\n\n/**\n * Notifications WebSocket configuration for a SYMMIO chain deployment.\n *\n * The notifications endpoint streams position/quote state transitions (instant\n * open/close confirmations, fills, cancels, liquidations) for a SubAccount. It\n * is a push channel, not a REST endpoint — `url` is a `ws://`/`wss://` URL.\n * Discriminated on `protocol`; narrow to reach protocol-specific fields\n * (e.g. the enigma `channel`).\n */\nexport type SymmioNotificationsConfig = SymmioEnigmaNotificationsConfig | SymmioRasaNotificationsConfig;\n\n/**\n * Muon oracle configuration for a SYMMIO chain deployment.\n *\n * The Muon network signs off-chain values (e.g. a party's unrealized PnL) that\n * the contracts verify on-chain — `removeMargin` requires such a signature. The\n * gateway is a query-param REST endpoint with no OpenAPI spec; `urls` are tried\n * in order until one returns a successful attestation.\n *\n * @see {@link https://docs.symm.io/api-endpoints-and-deployments/muon-api}\n */\nexport interface SymmioMuonConfig {\n  /** Muon oracle gateway base URLs, tried in order (fallback on failure). */\n  urls: readonly string[];\n}\n\n/**\n * Pools **listing backend** configuration for a SYMMIO chain deployment.\n *\n * The listing backend is an auth'd REST service that owns the lowcap Pools flow\n * — the pool catalogue, per-pool stats, a user's stake/rewards, and the\n * create/deposit/withdraw/claim actions. It is chain-level: one listing backend\n * is served per chain (a chain has at most one), with no solver or capability\n * involved. Present only where Pools is available (Enigma on HyperEVM); omitted\n * elsewhere.\n *\n * One deployment serves listings whose collateral was deposited on **several**\n * chains — a catalogue row's `chainId` is the token's deposit chain, which is\n * not the chain the resulting market trades on.\n */\nexport interface SymmioListingConfig {\n  /**\n   * Listing backend **host root** — no version segment and no trailing slash\n   * (e.g. `https://listing85.enigma.bz`, staging\n   * `https://listing-staging.enigma.bz`).\n   *\n   * The generated client's own paths already begin with `/v2`, so a versioned\n   * base URL here would request `/v2/v2/market/search` and 404. Point this at\n   * staging with a `createConfig` override — there is no separate environment\n   * axis.\n   */\n  url: string;\n}\n\n/**\n * Inventory-service configuration for a SYMMIO chain deployment.\n *\n * The inventory service is the custody backend behind the lowcap Pools: it holds\n * the per-market token and collateral inventory that backs trading, and reports\n * the system-wide TVL those balances add up to. It is a **separate vendor** from\n * both the solver and the {@link SymmioListingConfig} listing backend, with its\n * own deployment and its own OpenAPI spec.\n *\n * Chain-level and optional, like `listing`: present where lowcap Pools are\n * available, omitted elsewhere.\n */\nexport interface SymmioInventoryConfig {\n  /**\n   * Inventory service **host root** — no path segment and no trailing slash\n   * (e.g. `https://inventory85.enigma.bz`, staging\n   * `https://inventory-staging.enigma.bz`).\n   *\n   * The generated client's own paths already begin with `/api/v1`, so appending\n   * `/api` here would request `/api/api/v1/...` and 404.\n   */\n  url: string;\n}\n\n/**\n * Complete resolved configuration for a SYMMIO chain deployment.\n */\nexport interface SymmioChainConfig {\n  /** Chain ID */\n  chainId: number;\n  /** Contract addresses */\n  addresses: SymmioContractAddresses;\n  /** Subgraph endpoints */\n  subgraphs: SymmioSubgraphUrls;\n  /**\n   * Solvers available on this chain, keyed by {@link SolverId} (which is the\n   * solver's kind). A chain registers a subset of the kinds, so this is partial.\n   * Resolve one with `config.getSolver({ chainId, solverId })`, which defaults to\n   * {@link defaultSolverId} when `solverId` is omitted.\n   */\n  solvers: Partial<Record<SolverId, SymmioSolverConfig>>;\n  /** Id of the solver an action targets on this chain when `solverId` is omitted. */\n  defaultSolverId: SolverId;\n  /** Price-service configuration */\n  priceService: SymmioPriceServiceConfig;\n  /** Muon oracle configuration */\n  muon: SymmioMuonConfig;\n  /**\n   * Optional Pools listing backend, served per chain. Set on chains where the\n   * lowcap Pools flow is available (Enigma on HyperEVM); omitted elsewhere.\n   * Resolve it with `resolveListingService` / gate on `supportsListingService`.\n   */\n  listing?: SymmioListingConfig;\n  /**\n   * Optional inventory service — the custody backend behind lowcap Pools, and\n   * the source of system-wide TVL. Set alongside {@link SymmioChainConfig.listing};\n   * resolve it with `resolveInventoryService`.\n   */\n  inventory?: SymmioInventoryConfig;\n}\n"],"mappings":";AAsDA,IAAa,IAAyB,CAAC,UAAU,MAAM,GA8H1C,IAAgC,CAAC,UAAU,SAAS"}

package/dist/core/config/config-key.d.ts

@@ -6,6 +6,12 @@ import { SymmioChainConfig } from '../chains/index.js';
  * reloads, and separate `Config` instances, which is what makes it safe to embed
  * in a TanStack query key.
  *
+ * ALL query factories fold this into their keys — chain-scoped and
+ * solver-facing alike. Solver-facing keys additionally carry the `solverId`
+ * field (spread from their options), which is what keeps two solvers on the
+ * same chain in separate cache entries; the hash handles freshness (any config
+ * change, including a solver override, rotates it).
+ *
  * @internal
  */
 export declare function hashChainConfig(config: SymmioChainConfig): string;

package/dist/core/config/config-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-key.d.ts","sourceRoot":"","sources":["../../../src/core/config/config-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"config-key.d.ts","sourceRoot":"","sources":["../../../src/core/config/config-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEjE"}

package/dist/core/config/config-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-key.js","names":[],"sources":["../../../src/core/config/config-key.ts"],"sourcesContent":["import { hash } from \"ohash\";\nimport type { SymmioChainConfig } from \"../chains\";\n\n/**\n * A short, stable fingerprint of a fully-resolved chain config. Derived purely\n * from the config's content — `ohash` serializes deterministically regardless of\n * key order — so the same config yields the same fingerprint across SSR,\n * reloads, and separate `Config` instances, which is what makes it safe to embed\n * in a TanStack query key.\n *\n * @internal\n */\nexport function hashChainConfig(config: SymmioChainConfig): string {\n  return hash(config);\n}\n"],"mappings":";;AAYA,SAAgB,EAAgB,GAAmC;CACjE,OAAO,EAAK,CAAM;AACpB"}
+{"version":3,"file":"config-key.js","names":[],"sources":["../../../src/core/config/config-key.ts"],"sourcesContent":["import { hash } from \"ohash\";\nimport type { SymmioChainConfig } from \"../chains\";\n\n/**\n * A short, stable fingerprint of a fully-resolved chain config. Derived purely\n * from the config's content — `ohash` serializes deterministically regardless of\n * key order — so the same config yields the same fingerprint across SSR,\n * reloads, and separate `Config` instances, which is what makes it safe to embed\n * in a TanStack query key.\n *\n * ALL query factories fold this into their keys — chain-scoped and\n * solver-facing alike. Solver-facing keys additionally carry the `solverId`\n * field (spread from their options), which is what keeps two solvers on the\n * same chain in separate cache entries; the hash handles freshness (any config\n * change, including a solver override, rotates it).\n *\n * @internal\n */\nexport function hashChainConfig(config: SymmioChainConfig): string {\n  return hash(config);\n}\n"],"mappings":";;AAkBA,SAAgB,EAAgB,GAAmC;CACjE,OAAO,EAAK,CAAM;AACpB"}

package/dist/core/config/create-config.d.ts

@@ -1,7 +1,7 @@
 import { Address, PublicClient } from 'viem';
 import { DeepPartial } from '../../shared/types/properties.js';
 import { WebSocketConstructor } from '../../shared/types/websocket.js';
-import { SymmioChainConfig, SymmioContractAddresses } from '../chains/index.js';
+import { SolverId, SymmioChainConfig, SymmioContractAddresses, SymmioResolvedSolver } from '../chains/index.js';
 import { SymmioWalletClient } from './types.js';
 /**
  * Per-chain SYMMIO configuration input for {@link createConfig}, deep-merged onto
@@ -43,7 +43,7 @@ export interface CreateConfigParameters {
     /**
      * Per-chain SYMMIO configuration, keyed by chain id — deep-merged onto the
      * SDK's built-in defaults. Each entry may override that chain's `addresses`,
-     * `subgraphs`, `solver`, `priceService`, `notifications`, and `muon` endpoints.
+     * `subgraphs`, `solvers`, `priceService`, `notifications`, and `muon` endpoints.
      *
      * **Required.** Every supported chain must supply an
      * `addresses.affiliatesAddress` — your frontend's on-chain **affiliate**
@@ -70,7 +70,7 @@ export interface CreateConfigParameters {
      * symmioConfig: {
      *   [SymmioSupportedChainId.HYPER_EVM]: {
      *     addresses: { affiliatesAddress: "0xYourHyperEvmAffiliate…" },
-     *     // optional: subgraphs, solver, priceService, notifications, muon
+     *     // optional: subgraphs, solvers, priceService, notifications, muon
      *   },
      * }
      * ```
@@ -132,17 +132,45 @@ export interface Config {
      */
     getChainConfig(chainId?: number): SymmioChainConfig;
     /**
-     * Stable fingerprint of a chain's fully-resolved config (addresses, solver,
+     * Stable fingerprint of a chain's fully-resolved config (addresses, solvers,
      * subgraphs). Identical for identical config across reloads and SSR; changes
      * iff that chain's resolved config changes.
      *
-     * The query option factories fold this into every query key, so a runtime
-     * override produces a fresh key — TanStack refetches with the new config
-     * instead of serving stale cache. Returns a stable sentinel for chains the
-     * config does not know about (it never throws, so it is safe to call while
-     * building query options for an unsupported chain).
+     * ALL query option factories — chain-scoped and solver-facing — fold this
+     * into their query keys, so a runtime override produces a fresh key and
+     * TanStack refetches with the new config instead of serving stale cache.
+     * Solver-facing keys additionally carry the `solverId` field (spread from
+     * their options), which is what keeps two solvers on the same chain in
+     * separate cache entries. Returns a stable sentinel for chains the config
+     * does not know about (it never throws, so it is safe to call while building
+     * query options for an unsupported chain).
      */
     getChainConfigKey(chainId?: number): string;
+    /**
+     * Resolve a chain's solver config. When `solverId` is given, returns that
+     * solver; otherwise returns the chain's `defaultSolverId` solver.
+     *
+     * @param parameters - Optional `chainId` (defaults to `defaultChainId`) and
+     *   `solverId` (defaults to the chain's `defaultSolverId`).
+     * @throws {SymmError} `UNSUPPORTED_CHAIN` when the chain is unknown, or
+     *   `UNKNOWN_SOLVER` when the chain has no solver with that id.
+     */
+    getSolver(parameters?: {
+        chainId?: number;
+        solverId?: SolverId;
+    }): SymmioResolvedSolver;
+    /**
+     * Id of the chain's default solver (its `defaultSolverId`) — the solver an
+     * action targets when it omits `solverId`.
+     */
+    getDefaultSolverId(chainId?: number): SolverId;
+    /**
+     * Ids of every solver configured on a chain. Resolve each with
+     * {@link getSolver} — e.g. to build a solver picker.
+     *
+     * @throws {SymmError} `UNSUPPORTED_CHAIN` when the chain is unknown.
+     */
+    listSolverIds(chainId?: number): readonly SolverId[];
     /** Resolve the viem `PublicClient` for reads on a chain. */
     getClient(parameters?: {
         chainId?: number;

package/dist/core/config/create-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-config.d.ts","sourceRoot":"","sources":["../../../src/core/config/create-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAuB,KAAK,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAGtG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC,GAAG;IACvF,SAAS,EAAE,WAAW,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,CAAC;CACtG,CAAC;AAEF,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,UAAU,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,YAAY,CAAC;AAE9E;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEjH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAC9D;;;;OAIG;IACH,SAAS,EAAE,WAAW,CAAC;IACvB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC;;;OAGG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpD;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,4DAA4D;IAC5D,SAAS,CAAC,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAC;IAC3D;;;;;;;;OAQG;IACH,eAAe,CAAC,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChG;;;;;;;OAOG;IACH,uBAAuB,IAAI,oBAAoB,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,sBAAsB,GAAG,MAAM,CAoFvE"}
+{"version":3,"file":"create-config.d.ts","sourceRoot":"","sources":["../../../src/core/config/create-config.ts"],"names":[],"mappings":"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"}