@symmio/trading-core 1.1.0 → 3.0.0

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,12 +43,12 @@ 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**
      * (your identity in SYMMIO on that chain), attached to every quote
-     * (`sendQuoteWithAffiliateAndData`) so the protocol knows who sourced the trade
+     * (`sendQuote`) so the protocol knows who sourced the trade
      * and routes your share of the trading fee to you. Affiliate addresses are per
      * chain: a registration on one chain is not valid on another. `createConfig`
      * throws `AFFILIATE_ADDRESS_REQUIRED` only when it is **missing**, so a trade
@@ -68,9 +68,9 @@ export interface CreateConfigParameters {
      * @example
      * ```ts
      * symmioConfig: {
-     *   [SymmioSupportedChainId.HYPER_EVM]: {
-     *     addresses: { affiliatesAddress: "0xYourHyperEvmAffiliate…" },
-     *     // optional: subgraphs, solver, priceService, notifications, muon
+     *   [SymmioSupportedChainId.ARBITRUM]: {
+     *     addresses: { affiliatesAddress: "0xYourArbitrumAffiliate…" },
+     *     // 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;
@@ -185,13 +213,13 @@ export interface ConfigParameter {
  * ```ts
  * import { createConfig } from "@symmio/trading-core";
  * import { createPublicClient, createWalletClient, http } from "viem";
- * import { hyperEvm } from "viem/chains";
+ * import { arbitrum } from "viem/chains";
  *
- * const publicClient = createPublicClient({ chain: hyperEvm, transport: http() });
- * const walletClient = createWalletClient({ account, chain: hyperEvm, transport: http() });
+ * const publicClient = createPublicClient({ chain: arbitrum, transport: http() });
+ * const walletClient = createWalletClient({ account, chain: arbitrum, transport: http() });
  *
  * const config = createConfig({
- *   symmioConfig: { [SymmioSupportedChainId.HYPER_EVM]: { addresses: { affiliatesAddress: "0xYourHyperEvmAffiliate…" } } },
+ *   symmioConfig: { [SymmioSupportedChainId.ARBITRUM]: { addresses: { affiliatesAddress: "0xYourArbitrumAffiliate…" } } },
  *   getClient: () => publicClient,
  *   getWalletClient: async () => walletClient,
  * });

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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"}

package/dist/core/config/create-config.js

@@ -1,47 +1,70 @@
 import { SymmError as e } from "../../shared/errors/symm-error.js";
-import { listSupportedChains as t } from "../chains/actions/list-supported-chains.js";
-import { hashChainConfig as n } from "./config-key.js";
-import { buildChainConfigs as r } from "./merge-chain-config.js";
+import { resolveSolver as t } from "../chains/resolve-solver.js";
+import { listSupportedChains as n } from "../chains/actions/list-supported-chains.js";
+import { assertSupportedPriceServiceType as r } from "../chains/price-service-support.js";
+import { assertSupportedSolver as i } from "../chains/solver-support.js";
+import { hashChainConfig as a } from "./config-key.js";
+import { buildChainConfigs as o } from "./merge-chain-config.js";
 //#region src/core/config/create-config.ts
-function i(i) {
-	let { getClient: a, getWalletClient: o, symmioConfig: s, defaultChainId: c, simulateBeforeWrite: l = !0, webSocketConstructor: u } = i;
-	for (let n of t()) if (!s?.[n]?.addresses?.affiliatesAddress) throw new e("config", "AFFILIATE_ADDRESS_REQUIRED", `createConfig: \`symmioConfig[${n}].addresses.affiliatesAddress\` is required. No affiliate yet? Pass the zero address — trades still open, you just earn no fee share. Affiliate addresses are per chain; register at https://trading-sdk.symm.io/affiliate to earn your fee share.`);
-	let d = r(s), f = Object.keys(d).map(Number);
-	if (f.length === 0) throw new e("config", "NO_CHAINS_CONFIGURED", "createConfig: no supported chains are configured.");
-	let p = c ?? f[0], m = {};
-	for (let e of f) m[e] = n(d[e]);
-	function h(t) {
-		let n = t ?? p, r = d[n];
+function s(s) {
+	let { getClient: c, getWalletClient: l, symmioConfig: u, defaultChainId: d, simulateBeforeWrite: f = !0, webSocketConstructor: p } = s, m = o(u);
+	for (let t of Object.keys(u ?? {})) {
+		let n = Number(t);
+		if (Object.keys(m[n]?.solvers ?? {}).length > 0 && !u?.[n]?.addresses?.affiliatesAddress) throw new e("config", "AFFILIATE_ADDRESS_REQUIRED", `createConfig: \`symmioConfig[${n}].addresses.affiliatesAddress\` is required. No affiliate yet? Pass the zero address — trades still open, you just earn no fee share. Affiliate addresses are per chain; register at https://trading-sdk.symm.io/affiliate to earn your fee share.`);
+	}
+	let h = n();
+	if (h.length === 0) throw new e("config", "NO_CHAINS_CONFIGURED", "createConfig: no supported chains are configured.");
+	let g = d ?? h[0], _ = {};
+	for (let e of h) _[e] = a(m[e]);
+	for (let e of h) {
+		let t = m[e];
+		r(e, t.priceService.type);
+		for (let [n, a] of Object.entries(t.solvers)) i(e, n), a?.priceService && r(e, a.priceService.type, n);
+	}
+	function v(t) {
+		let n = t ?? g, r = m[n];
 		if (!r) throw new e("config", "UNSUPPORTED_CHAIN", `Unsupported chain id: ${n}.`);
 		return r;
 	}
-	function g(e) {
-		return m[e ?? p] ?? "unsupported";
+	function y(e) {
+		return _[e ?? g] ?? "unsupported";
+	}
+	function b(e) {
+		return t(v(e?.chainId), e?.solverId);
+	}
+	function x(e) {
+		return v(e).defaultSolverId;
+	}
+	function S(e) {
+		return Object.keys(v(e).solvers);
 	}
 	return {
-		chains: f,
-		simulateBeforeWrite: l,
-		defaultChainId: p,
-		getChainConfig: h,
-		getChainConfigKey: g,
+		chains: h,
+		simulateBeforeWrite: f,
+		defaultChainId: g,
+		getChainConfig: v,
+		getChainConfigKey: y,
+		getSolver: b,
+		getDefaultSolverId: x,
+		listSolverIds: S,
 		getClient(e) {
-			return a({ chainId: e?.chainId ?? p });
+			return c({ chainId: e?.chainId ?? g });
 		},
 		async getWalletClient(t) {
-			if (!o) throw new e("config", "NO_WALLET_CLIENT", "createConfig: no `getWalletClient` resolver was provided; write/sign actions are unavailable.");
-			return o({
-				chainId: t?.chainId ?? p,
+			if (!l) throw new e("config", "NO_WALLET_CLIENT", "createConfig: no `getWalletClient` resolver was provided; write/sign actions are unavailable.");
+			return l({
+				chainId: t?.chainId ?? g,
 				from: t?.from
 			});
 		},
 		getWebSocketConstructor() {
-			let t = u ?? globalThis.WebSocket;
+			let t = p ?? globalThis.WebSocket;
 			if (!t) throw new e("config", "NO_WEBSOCKET", "No WebSocket implementation available. Pass `webSocketConstructor` to createConfig (e.g. the `ws` package in Node).");
 			return t;
 		}
 	};
 }
 //#endregion
-export { i as createConfig };
+export { s as createConfig };
 
 //# sourceMappingURL=create-config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-config.js","names":[],"sources":["../../../src/core/config/create-config.ts"],"sourcesContent":["import { type Address, type PublicClient } from \"viem\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { DeepPartial } from \"../../shared/types/properties\";\nimport type { WebSocketConstructor } from \"../../shared/types/websocket\";\nimport { listSupportedChains, type SymmioChainConfig, type SymmioContractAddresses } from \"../chains\";\nimport { hashChainConfig } from \"./config-key\";\nimport { buildChainConfigs } from \"./merge-chain-config\";\nimport type { SymmioWalletClient } from \"./types\";\n\n/**\n * Per-chain SYMMIO configuration input for {@link createConfig}, deep-merged onto\n * that chain's built-in defaults.\n *\n * Every field is optional to override **except** `addresses.affiliatesAddress` —\n * your frontend's on-chain affiliate for that chain (your identity in SYMMIO),\n * attached to every quote so the protocol attributes the trade to you and routes\n * your fee share. It is mandatory in the type because affiliate addresses are per\n * chain (a registration on one chain is not valid on another) and a missing one\n * would silently fall back to the built-in default affiliate, losing attribution.\n */\nexport type SymmioChainConfigInput = Omit<DeepPartial<SymmioChainConfig>, \"addresses\"> & {\n  addresses: DeepPartial<SymmioContractAddresses> & Pick<SymmioContractAddresses, \"affiliatesAddress\">;\n};\n\nexport type { SymmioWalletClient } from \"./types\";\n\n/** Resolve a viem `PublicClient` for reads, optionally for a specific chain. */\nexport type GetClientFn = (parameters?: { chainId?: number }) => PublicClient;\n\n/**\n * Returns the wallet client the SDK should sign/write with.\n *\n * The SDK does not pick between multiple wallets. The consumer's resolver\n * receives the optional `from` (passed by the action) and is responsible for\n * returning the right wallet client — e.g. session-key when `from` matches the\n * session key, wagmi-connected wallet otherwise. The resolver is called fresh\n * per action so account switches in the connected wallet propagate without\n * recreating the config.\n */\nexport type GetWalletClientFn = (parameters: { chainId: number; from?: Address }) => Promise<SymmioWalletClient>;\n\n/**\n * Parameters for {@link createConfig}.\n */\nexport interface CreateConfigParameters {\n  /**\n   * Per-chain SYMMIO configuration, keyed by chain id — deep-merged onto the\n   * SDK's built-in defaults. Each entry may override that chain's `addresses`,\n   * `subgraphs`, `solver`, `priceService`, `notifications`, and `muon` endpoints.\n   *\n   * **Required.** Every supported chain must supply an\n   * `addresses.affiliatesAddress` — your frontend's on-chain **affiliate**\n   * (your identity in SYMMIO on that chain), attached to every quote\n   * (`sendQuoteWithAffiliateAndData`) so the protocol knows who sourced the trade\n   * and routes your share of the trading fee to you. Affiliate addresses are per\n   * chain: a registration on one chain is not valid on another. `createConfig`\n   * throws `AFFILIATE_ADDRESS_REQUIRED` only when it is **missing**, so a trade\n   * can never silently fall back to the built-in default affiliate and lose\n   * attribution. The **zero address is accepted** as a no-affiliate test\n   * placeholder — trades still open, you just earn no fee share; a **non-zero\n   * unregistered** affiliate is what reverts on-chain (`PartyAFacet: Invalid\n   * affiliate`). Register at https://trading-sdk.symm.io/affiliate to earn fees.\n   *\n   * The zero address is accepted here (the SDK only checks presence) — treat it\n   * as a **testing placeholder**. On-chain it is a **no-affiliate sentinel**: the\n   * trade still opens, you just receive **no share of the trading fee** (nothing\n   * is attributed to you). What reverts on-chain is a **non-zero _unregistered_**\n   * affiliate — that fails with `PartyAFacet: Invalid affiliate` at trade time. Use\n   * a **registered** affiliate to earn your fee share.\n   *\n   * @example\n   * ```ts\n   * symmioConfig: {\n   *   [SymmioSupportedChainId.HYPER_EVM]: {\n   *     addresses: { affiliatesAddress: \"0xYourHyperEvmAffiliate…\" },\n   *     // optional: subgraphs, solver, priceService, notifications, muon\n   *   },\n   * }\n   * ```\n   */\n  symmioConfig: Partial<Record<number, SymmioChainConfigInput>>;\n  /**\n   * Returns the viem `PublicClient` used for read actions. Framework layers\n   * inject this — e.g. `@symmio/trading-react` bridges it to wagmi's\n   * `getPublicClient`. In a plain Node script, return your own viem client.\n   */\n  getClient: GetClientFn;\n  /**\n   * Returns the bound viem `WalletClient` to sign/write with. Receives the\n   * optional `from` from the action — when the consumer has multiple potential\n   * signers (e.g. session-key + connected wallet), this resolver picks. The\n   * SDK does no address matching itself; passing `from` is just a hint.\n   *\n   * Optional — read-only configs may omit it; write/sign actions then throw.\n   */\n  getWalletClient?: GetWalletClientFn;\n  /**\n   * Chain used when an action or query omits `chainId`. Defaults to the first\n   * built-in supported chain.\n   */\n  defaultChainId?: number;\n  /**\n   * Dry-run every write with `simulateContract` before sending it, aborting (and\n   * throwing the decoded revert) if the transaction would fail. Defaults to\n   * `true`. Override for a single call with the write's `simulateBeforeWrite`\n   * option; set `false` here to disable the pre-flight for all writes.\n   */\n  simulateBeforeWrite?: boolean;\n  /**\n   * WebSocket implementation used by streaming actions (e.g. `watchNotifications`).\n   * Defaults to `globalThis.WebSocket` — set in browsers and Node 22+. Pass an\n   * implementation explicitly to run streams in environments without a global\n   * (e.g. the `ws` package in older Node, or a mock in tests).\n   */\n  webSocketConstructor?: WebSocketConstructor;\n}\n\n/**\n * The immutable SDK config every action and query factory receives as its first\n * argument. Holds the per-chain registry and the viem-client resolvers.\n */\nexport interface Config {\n  /** Chain ids the config knows about (built-in defaults plus overrides). */\n  readonly chains: readonly number[];\n  /** Chain used when an action or query omits `chainId`. */\n  readonly defaultChainId: number;\n  /**\n   * Default for the pre-send dry-run on writes. When `true` (the default), a\n   * write runs `simulateContract` and aborts if it would revert, unless the call\n   * passes `simulateBeforeWrite: false`.\n   */\n  readonly simulateBeforeWrite: boolean;\n  /**\n   * Resolve the fully-merged config for a chain.\n   * @throws {SymmError} when the chain is not supported.\n   */\n  getChainConfig(chainId?: number): SymmioChainConfig;\n  /**\n   * Stable fingerprint of a chain's fully-resolved config (addresses, solver,\n   * subgraphs). Identical for identical config across reloads and SSR; changes\n   * iff that chain's resolved config changes.\n   *\n   * The query option factories fold this into every query key, so a runtime\n   * override produces a fresh key — TanStack refetches with the new config\n   * instead of serving stale cache. Returns a stable sentinel for chains the\n   * config does not know about (it never throws, so it is safe to call while\n   * building query options for an unsupported chain).\n   */\n  getChainConfigKey(chainId?: number): string;\n  /** Resolve the viem `PublicClient` for reads on a chain. */\n  getClient(parameters?: { chainId?: number }): PublicClient;\n  /**\n   * Resolve the wallet client for writes / off-chain signs.\n   *\n   * Forwards `chainId` (defaulting to `defaultChainId`) and the optional\n   * `from` to the consumer's `getWalletClient` resolver. The resolver decides\n   * which wallet to return; the SDK does not perform address matching.\n   *\n   * @throws {SymmError} when the config was created without `getWalletClient`.\n   */\n  getWalletClient(parameters?: { chainId?: number; from?: Address }): Promise<SymmioWalletClient>;\n  /**\n   * Resolve the WebSocket implementation streaming actions open connections\n   * with. Returns the injected `webSocketConstructor`, falling back to\n   * `globalThis.WebSocket`.\n   *\n   * @throws {SymmError} when neither an injected constructor nor a global\n   *   `WebSocket` is available.\n   */\n  getWebSocketConstructor(): WebSocketConstructor;\n}\n\n/**\n * Optional `config` override mixin for hook/action parameters. When omitted, the\n * config is read from context (in the react layer) or must be passed explicitly.\n */\nexport interface ConfigParameter {\n  /** Use this config instead of the one from context. */\n  config?: Config;\n}\n\n/**\n * Create an SDK {@link Config}.\n *\n * @example\n * ```ts\n * import { createConfig } from \"@symmio/trading-core\";\n * import { createPublicClient, createWalletClient, http } from \"viem\";\n * import { hyperEvm } from \"viem/chains\";\n *\n * const publicClient = createPublicClient({ chain: hyperEvm, transport: http() });\n * const walletClient = createWalletClient({ account, chain: hyperEvm, transport: http() });\n *\n * const config = createConfig({\n *   symmioConfig: { [SymmioSupportedChainId.HYPER_EVM]: { addresses: { affiliatesAddress: \"0xYourHyperEvmAffiliate…\" } } },\n *   getClient: () => publicClient,\n *   getWalletClient: async () => walletClient,\n * });\n * ```\n */\nexport function createConfig(parameters: CreateConfigParameters): Config {\n  const {\n    getClient,\n    getWalletClient,\n    symmioConfig,\n    defaultChainId,\n    simulateBeforeWrite = true,\n    webSocketConstructor,\n  } = parameters;\n\n  // Affiliate is required per chain: every supported chain's `symmioConfig` entry\n  // must set `addresses.affiliatesAddress`, or a trade would silently fall back to\n  // the built-in default affiliate and lose attribution. The zero address is\n  // accepted (a no-affiliate test placeholder — trades open, no fee share); only a\n  // MISSING affiliate throws. A non-zero UNREGISTERED affiliate is not caught here;\n  // it reverts on-chain at trade time (`PartyAFacet: Invalid affiliate`). Check the\n  // raw input (not the merged config, whose default would mask a gap).\n  for (const chainId of listSupportedChains()) {\n    const affiliate = symmioConfig?.[chainId]?.addresses?.affiliatesAddress;\n    if (!affiliate)\n      throw new SymmError(\n        \"config\",\n        \"AFFILIATE_ADDRESS_REQUIRED\",\n        `createConfig: \\`symmioConfig[${chainId}].addresses.affiliatesAddress\\` is required. No affiliate yet? Pass the zero address — trades still open, you just earn no fee share. Affiliate addresses are per chain; register at https://trading-sdk.symm.io/affiliate to earn your fee share.`,\n      );\n  }\n\n  const chainConfigs = buildChainConfigs(symmioConfig);\n\n  const chainIds = Object.keys(chainConfigs).map(Number);\n  if (chainIds.length === 0)\n    throw new SymmError(\"config\", \"NO_CHAINS_CONFIGURED\", \"createConfig: no supported chains are configured.\");\n  const resolvedDefaultChainId = defaultChainId ?? chainIds[0]!;\n\n  /** Per-chain config fingerprints, precomputed once from the resolved registry. */\n  const chainConfigKeys: Record<number, string> = {};\n  for (const id of chainIds) chainConfigKeys[id] = hashChainConfig(chainConfigs[id]!);\n\n  function getChainConfig(chainId?: number): SymmioChainConfig {\n    const id = chainId ?? resolvedDefaultChainId;\n    const config = chainConfigs[id];\n\n    if (!config) throw new SymmError(\"config\", \"UNSUPPORTED_CHAIN\", `Unsupported chain id: ${id}.`);\n    return config;\n  }\n\n  function getChainConfigKey(chainId?: number): string {\n    const id = chainId ?? resolvedDefaultChainId;\n    return chainConfigKeys[id] ?? \"unsupported\";\n  }\n\n  return {\n    chains: chainIds,\n    simulateBeforeWrite,\n    defaultChainId: resolvedDefaultChainId,\n    getChainConfig,\n    getChainConfigKey,\n    getClient(clientParameters) {\n      return getClient({ chainId: clientParameters?.chainId ?? resolvedDefaultChainId });\n    },\n    async getWalletClient(clientParameters) {\n      if (!getWalletClient) {\n        throw new SymmError(\n          \"config\",\n          \"NO_WALLET_CLIENT\",\n          \"createConfig: no `getWalletClient` resolver was provided; write/sign actions are unavailable.\",\n        );\n      }\n      return getWalletClient({\n        chainId: clientParameters?.chainId ?? resolvedDefaultChainId,\n        from: clientParameters?.from,\n      });\n    },\n    getWebSocketConstructor() {\n      const ctor = webSocketConstructor ?? (globalThis as { WebSocket?: WebSocketConstructor }).WebSocket;\n      if (!ctor)\n        throw new SymmError(\n          \"config\",\n          \"NO_WEBSOCKET\",\n          \"No WebSocket implementation available. Pass `webSocketConstructor` to createConfig (e.g. the `ws` package in Node).\",\n        );\n      return ctor;\n    },\n  };\n}\n"],"mappings":";;;;;AAwMA,SAAgB,EAAa,GAA4C;CACvE,IAAM,EACJ,cACA,oBACA,iBACA,mBACA,yBAAsB,IACtB,4BACE;CASJ,KAAK,IAAM,KAAW,EAAoB,GAExC,IAAI,CADc,IAAe,IAAU,WAAW,mBAEpD,MAAM,IAAI,EACR,UACA,8BACA,gCAAgC,EAAQ,mPAC1C;CAGJ,IAAM,IAAe,EAAkB,CAAY,GAE7C,IAAW,OAAO,KAAK,CAAY,EAAE,IAAI,MAAM;CACrD,IAAI,EAAS,WAAW,GACtB,MAAM,IAAI,EAAU,UAAU,wBAAwB,mDAAmD;CAC3G,IAAM,IAAyB,KAAkB,EAAS,IAGpD,IAA0C,CAAC;CACjD,KAAK,IAAM,KAAM,GAAU,EAAgB,KAAM,EAAgB,EAAa,EAAI;CAElF,SAAS,EAAe,GAAqC;EAC3D,IAAM,IAAK,KAAW,GAChB,IAAS,EAAa;EAE5B,IAAI,CAAC,GAAQ,MAAM,IAAI,EAAU,UAAU,qBAAqB,yBAAyB,EAAG,EAAE;EAC9F,OAAO;CACT;CAEA,SAAS,EAAkB,GAA0B;EAEnD,OAAO,EADI,KAAW,MACQ;CAChC;CAEA,OAAO;EACL,QAAQ;EACR;EACA,gBAAgB;EAChB;EACA;EACA,UAAU,GAAkB;GAC1B,OAAO,EAAU,EAAE,SAAS,GAAkB,WAAW,EAAuB,CAAC;EACnF;EACA,MAAM,gBAAgB,GAAkB;GACtC,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,oBACA,+FACF;GAEF,OAAO,EAAgB;IACrB,SAAS,GAAkB,WAAW;IACtC,MAAM,GAAkB;GAC1B,CAAC;EACH;EACA,0BAA0B;GACxB,IAAM,IAAO,KAAyB,WAAoD;GAC1F,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,gBACA,qHACF;GACF,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"create-config.js","names":[],"sources":["../../../src/core/config/create-config.ts"],"sourcesContent":["import { type Address, type PublicClient } from \"viem\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { DeepPartial } from \"../../shared/types/properties\";\nimport type { WebSocketConstructor } from \"../../shared/types/websocket\";\nimport {\n  assertSupportedPriceServiceType,\n  assertSupportedSolver,\n  listSupportedChains,\n  resolveSolver,\n  type SolverId,\n  type SymmioChainConfig,\n  type SymmioContractAddresses,\n  type SymmioResolvedSolver,\n  type SymmioSupportedChainId,\n} from \"../chains\";\nimport { hashChainConfig } from \"./config-key\";\nimport { buildChainConfigs } from \"./merge-chain-config\";\nimport type { SymmioWalletClient } from \"./types\";\n\n/**\n * Per-chain SYMMIO configuration input for {@link createConfig}, deep-merged onto\n * that chain's built-in defaults.\n *\n * Every field is optional to override **except** `addresses.affiliatesAddress` —\n * your frontend's on-chain affiliate for that chain (your identity in SYMMIO),\n * attached to every quote so the protocol attributes the trade to you and routes\n * your fee share. It is mandatory in the type because affiliate addresses are per\n * chain (a registration on one chain is not valid on another) and a missing one\n * would silently fall back to the built-in default affiliate, losing attribution.\n */\nexport type SymmioChainConfigInput = Omit<DeepPartial<SymmioChainConfig>, \"addresses\"> & {\n  addresses: DeepPartial<SymmioContractAddresses> & Pick<SymmioContractAddresses, \"affiliatesAddress\">;\n};\n\nexport type { SymmioWalletClient } from \"./types\";\n\n/** Resolve a viem `PublicClient` for reads, optionally for a specific chain. */\nexport type GetClientFn = (parameters?: { chainId?: number }) => PublicClient;\n\n/**\n * Returns the wallet client the SDK should sign/write with.\n *\n * The SDK does not pick between multiple wallets. The consumer's resolver\n * receives the optional `from` (passed by the action) and is responsible for\n * returning the right wallet client — e.g. session-key when `from` matches the\n * session key, wagmi-connected wallet otherwise. The resolver is called fresh\n * per action so account switches in the connected wallet propagate without\n * recreating the config.\n */\nexport type GetWalletClientFn = (parameters: { chainId: number; from?: Address }) => Promise<SymmioWalletClient>;\n\n/**\n * Parameters for {@link createConfig}.\n */\nexport interface CreateConfigParameters {\n  /**\n   * Per-chain SYMMIO configuration, keyed by chain id — deep-merged onto the\n   * SDK's built-in defaults. Each entry may override that chain's `addresses`,\n   * `subgraphs`, `solvers`, `priceService`, `notifications`, and `muon` endpoints.\n   *\n   * **Required.** Every supported chain must supply an\n   * `addresses.affiliatesAddress` — your frontend's on-chain **affiliate**\n   * (your identity in SYMMIO on that chain), attached to every quote\n   * (`sendQuote`) so the protocol knows who sourced the trade\n   * and routes your share of the trading fee to you. Affiliate addresses are per\n   * chain: a registration on one chain is not valid on another. `createConfig`\n   * throws `AFFILIATE_ADDRESS_REQUIRED` only when it is **missing**, so a trade\n   * can never silently fall back to the built-in default affiliate and lose\n   * attribution. The **zero address is accepted** as a no-affiliate test\n   * placeholder — trades still open, you just earn no fee share; a **non-zero\n   * unregistered** affiliate is what reverts on-chain (`PartyAFacet: Invalid\n   * affiliate`). Register at https://trading-sdk.symm.io/affiliate to earn fees.\n   *\n   * The zero address is accepted here (the SDK only checks presence) — treat it\n   * as a **testing placeholder**. On-chain it is a **no-affiliate sentinel**: the\n   * trade still opens, you just receive **no share of the trading fee** (nothing\n   * is attributed to you). What reverts on-chain is a **non-zero _unregistered_**\n   * affiliate — that fails with `PartyAFacet: Invalid affiliate` at trade time. Use\n   * a **registered** affiliate to earn your fee share.\n   *\n   * @example\n   * ```ts\n   * symmioConfig: {\n   *   [SymmioSupportedChainId.ARBITRUM]: {\n   *     addresses: { affiliatesAddress: \"0xYourArbitrumAffiliate…\" },\n   *     // optional: subgraphs, solvers, priceService, notifications, muon\n   *   },\n   * }\n   * ```\n   */\n  symmioConfig: Partial<Record<number, SymmioChainConfigInput>>;\n  /**\n   * Returns the viem `PublicClient` used for read actions. Framework layers\n   * inject this — e.g. `@symmio/trading-react` bridges it to wagmi's\n   * `getPublicClient`. In a plain Node script, return your own viem client.\n   */\n  getClient: GetClientFn;\n  /**\n   * Returns the bound viem `WalletClient` to sign/write with. Receives the\n   * optional `from` from the action — when the consumer has multiple potential\n   * signers (e.g. session-key + connected wallet), this resolver picks. The\n   * SDK does no address matching itself; passing `from` is just a hint.\n   *\n   * Optional — read-only configs may omit it; write/sign actions then throw.\n   */\n  getWalletClient?: GetWalletClientFn;\n  /**\n   * Chain used when an action or query omits `chainId`. Defaults to the first\n   * built-in supported chain.\n   */\n  defaultChainId?: number;\n  /**\n   * Dry-run every write with `simulateContract` before sending it, aborting (and\n   * throwing the decoded revert) if the transaction would fail. Defaults to\n   * `true`. Override for a single call with the write's `simulateBeforeWrite`\n   * option; set `false` here to disable the pre-flight for all writes.\n   */\n  simulateBeforeWrite?: boolean;\n  /**\n   * WebSocket implementation used by streaming actions (e.g. `watchNotifications`).\n   * Defaults to `globalThis.WebSocket` — set in browsers and Node 22+. Pass an\n   * implementation explicitly to run streams in environments without a global\n   * (e.g. the `ws` package in older Node, or a mock in tests).\n   */\n  webSocketConstructor?: WebSocketConstructor;\n}\n\n/**\n * The immutable SDK config every action and query factory receives as its first\n * argument. Holds the per-chain registry and the viem-client resolvers.\n */\nexport interface Config {\n  /** Chain ids the config knows about (built-in defaults plus overrides). */\n  readonly chains: readonly number[];\n  /** Chain used when an action or query omits `chainId`. */\n  readonly defaultChainId: number;\n  /**\n   * Default for the pre-send dry-run on writes. When `true` (the default), a\n   * write runs `simulateContract` and aborts if it would revert, unless the call\n   * passes `simulateBeforeWrite: false`.\n   */\n  readonly simulateBeforeWrite: boolean;\n  /**\n   * Resolve the fully-merged config for a chain.\n   * @throws {SymmError} when the chain is not supported.\n   */\n  getChainConfig(chainId?: number): SymmioChainConfig;\n  /**\n   * Stable fingerprint of a chain's fully-resolved config (addresses, solvers,\n   * subgraphs). Identical for identical config across reloads and SSR; changes\n   * iff that chain's resolved config changes.\n   *\n   * ALL query option factories — chain-scoped and solver-facing — fold this\n   * into their query keys, so a runtime override produces a fresh key and\n   * TanStack refetches with the new config instead of serving stale cache.\n   * Solver-facing keys additionally carry the `solverId` field (spread from\n   * their options), which is what keeps two solvers on the same chain in\n   * separate cache entries. Returns a stable sentinel for chains the config\n   * does not know about (it never throws, so it is safe to call while building\n   * query options for an unsupported chain).\n   */\n  getChainConfigKey(chainId?: number): string;\n  /**\n   * Resolve a chain's solver config. When `solverId` is given, returns that\n   * solver; otherwise returns the chain's `defaultSolverId` solver.\n   *\n   * @param parameters - Optional `chainId` (defaults to `defaultChainId`) and\n   *   `solverId` (defaults to the chain's `defaultSolverId`).\n   * @throws {SymmError} `UNSUPPORTED_CHAIN` when the chain is unknown, or\n   *   `UNKNOWN_SOLVER` when the chain has no solver with that id.\n   */\n  getSolver(parameters?: { chainId?: number; solverId?: SolverId }): SymmioResolvedSolver;\n  /**\n   * Id of the chain's default solver (its `defaultSolverId`) — the solver an\n   * action targets when it omits `solverId`.\n   */\n  getDefaultSolverId(chainId?: number): SolverId;\n  /**\n   * Ids of every solver configured on a chain. Resolve each with\n   * {@link getSolver} — e.g. to build a solver picker.\n   *\n   * @throws {SymmError} `UNSUPPORTED_CHAIN` when the chain is unknown.\n   */\n  listSolverIds(chainId?: number): readonly SolverId[];\n  /** Resolve the viem `PublicClient` for reads on a chain. */\n  getClient(parameters?: { chainId?: number }): PublicClient;\n  /**\n   * Resolve the wallet client for writes / off-chain signs.\n   *\n   * Forwards `chainId` (defaulting to `defaultChainId`) and the optional\n   * `from` to the consumer's `getWalletClient` resolver. The resolver decides\n   * which wallet to return; the SDK does not perform address matching.\n   *\n   * @throws {SymmError} when the config was created without `getWalletClient`.\n   */\n  getWalletClient(parameters?: { chainId?: number; from?: Address }): Promise<SymmioWalletClient>;\n  /**\n   * Resolve the WebSocket implementation streaming actions open connections\n   * with. Returns the injected `webSocketConstructor`, falling back to\n   * `globalThis.WebSocket`.\n   *\n   * @throws {SymmError} when neither an injected constructor nor a global\n   *   `WebSocket` is available.\n   */\n  getWebSocketConstructor(): WebSocketConstructor;\n}\n\n/**\n * Optional `config` override mixin for hook/action parameters. When omitted, the\n * config is read from context (in the react layer) or must be passed explicitly.\n */\nexport interface ConfigParameter {\n  /** Use this config instead of the one from context. */\n  config?: Config;\n}\n\n/**\n * Create an SDK {@link Config}.\n *\n * @example\n * ```ts\n * import { createConfig } from \"@symmio/trading-core\";\n * import { createPublicClient, createWalletClient, http } from \"viem\";\n * import { arbitrum } from \"viem/chains\";\n *\n * const publicClient = createPublicClient({ chain: arbitrum, transport: http() });\n * const walletClient = createWalletClient({ account, chain: arbitrum, transport: http() });\n *\n * const config = createConfig({\n *   symmioConfig: { [SymmioSupportedChainId.ARBITRUM]: { addresses: { affiliatesAddress: \"0xYourArbitrumAffiliate…\" } } },\n *   getClient: () => publicClient,\n *   getWalletClient: async () => walletClient,\n * });\n * ```\n */\nexport function createConfig(parameters: CreateConfigParameters): Config {\n  const {\n    getClient,\n    getWalletClient,\n    symmioConfig,\n    defaultChainId,\n    simulateBeforeWrite = true,\n    webSocketConstructor,\n  } = parameters;\n\n  const chainConfigs = buildChainConfigs(symmioConfig);\n\n  // Affiliate is required only for a chain the consumer EXPLICITLY configured (has a\n  // `symmioConfig[chainId]` entry) that can ALSO trade — one with at least one solver.\n  // Configuring a chain is the opt-in that obliges you to name your affiliate for it;\n  // the affiliate rides every quote (`sendQuote`). A built-in chain\n  // the consumer never mentions is left alone: it may be an onboarding/placeholder chain\n  // not really tradable yet, and it falls back to its registry affiliate — so we do not\n  // force every consumer to supply an affiliate for a chain they never touch. The zero\n  // address is accepted (a no-affiliate placeholder — trades open, no fee share); only a\n  // MISSING affiliate throws. A non-zero UNREGISTERED affiliate is not caught here; it\n  // reverts on-chain at trade time (`PartyAFacet: Invalid affiliate`). Check the raw\n  // input (not the merged config, whose default would mask a gap).\n  for (const key of Object.keys(symmioConfig ?? {})) {\n    const chainId = Number(key) as SymmioSupportedChainId;\n    const hasSolvers = Object.keys(chainConfigs[chainId]?.solvers ?? {}).length > 0;\n    if (!hasSolvers) continue;\n    const affiliate = symmioConfig?.[chainId]?.addresses?.affiliatesAddress;\n    if (!affiliate)\n      throw new SymmError(\n        \"config\",\n        \"AFFILIATE_ADDRESS_REQUIRED\",\n        `createConfig: \\`symmioConfig[${chainId}].addresses.affiliatesAddress\\` is required. No affiliate yet? Pass the zero address — trades still open, you just earn no fee share. Affiliate addresses are per chain; register at https://trading-sdk.symm.io/affiliate to earn your fee share.`,\n      );\n  }\n\n  const chainIds = listSupportedChains();\n  if (chainIds.length === 0)\n    throw new SymmError(\"config\", \"NO_CHAINS_CONFIGURED\", \"createConfig: no supported chains are configured.\");\n  const resolvedDefaultChainId = defaultChainId ?? chainIds[0]!;\n\n  /** Per-chain config fingerprints, precomputed once from the resolved registry. */\n  const chainConfigKeys: Record<number, string> = {};\n  for (const id of chainIds) chainConfigKeys[id] = hashChainConfig(chainConfigs[id]!);\n\n  /**\n   * Validate every configured solver up front: `assertSupportedSolver` throws\n   * for an unknown `kind`, so a config can never point at a solver the SDK has\n   * no client for (fail-fast, like the affiliate check above).\n   *\n   * The same applies to price providers, on both levels they can appear: the\n   * chain-level block and any solver-nested override.\n   */\n  for (const id of chainIds) {\n    const chainConfig = chainConfigs[id]!;\n\n    assertSupportedPriceServiceType(id, chainConfig.priceService.type);\n\n    for (const [solverId, solver] of Object.entries(chainConfig.solvers)) {\n      assertSupportedSolver(id, solverId);\n      if (solver?.priceService) assertSupportedPriceServiceType(id, solver.priceService.type, solverId);\n    }\n  }\n\n  function getChainConfig(chainId?: number): SymmioChainConfig {\n    const id = chainId ?? resolvedDefaultChainId;\n    const config = chainConfigs[id];\n\n    if (!config) throw new SymmError(\"config\", \"UNSUPPORTED_CHAIN\", `Unsupported chain id: ${id}.`);\n    return config;\n  }\n\n  function getChainConfigKey(chainId?: number): string {\n    const id = chainId ?? resolvedDefaultChainId;\n    return chainConfigKeys[id] ?? \"unsupported\";\n  }\n\n  function getSolver(parameters?: { chainId?: number; solverId?: SolverId }): SymmioResolvedSolver {\n    return resolveSolver(getChainConfig(parameters?.chainId), parameters?.solverId);\n  }\n\n  function getDefaultSolverId(chainId?: number): SolverId {\n    return getChainConfig(chainId).defaultSolverId;\n  }\n\n  function listSolverIds(chainId?: number): readonly SolverId[] {\n    return Object.keys(getChainConfig(chainId).solvers) as SolverId[];\n  }\n\n  return {\n    chains: chainIds,\n    simulateBeforeWrite,\n    defaultChainId: resolvedDefaultChainId,\n    getChainConfig,\n    getChainConfigKey,\n    getSolver,\n    getDefaultSolverId,\n    listSolverIds,\n    getClient(clientParameters) {\n      return getClient({ chainId: clientParameters?.chainId ?? resolvedDefaultChainId });\n    },\n    async getWalletClient(clientParameters) {\n      if (!getWalletClient) {\n        throw new SymmError(\n          \"config\",\n          \"NO_WALLET_CLIENT\",\n          \"createConfig: no `getWalletClient` resolver was provided; write/sign actions are unavailable.\",\n        );\n      }\n      return getWalletClient({\n        chainId: clientParameters?.chainId ?? resolvedDefaultChainId,\n        from: clientParameters?.from,\n      });\n    },\n    getWebSocketConstructor() {\n      const ctor = webSocketConstructor ?? (globalThis as { WebSocket?: WebSocketConstructor }).WebSocket;\n      if (!ctor)\n        throw new SymmError(\n          \"config\",\n          \"NO_WEBSOCKET\",\n          \"No WebSocket implementation available. Pass `webSocketConstructor` to createConfig (e.g. the `ws` package in Node).\",\n        );\n      return ctor;\n    },\n  };\n}\n"],"mappings":";;;;;;;;AA2OA,SAAgB,EAAa,GAA4C;CACvE,IAAM,EACJ,cACA,oBACA,iBACA,mBACA,yBAAsB,IACtB,4BACE,GAEE,IAAe,EAAkB,CAAY;CAanD,KAAK,IAAM,KAAO,OAAO,KAAK,KAAgB,CAAC,CAAC,GAAG;EACjD,IAAM,IAAU,OAAO,CAAG;EACP,WAAO,KAAK,EAAa,IAAU,WAAW,CAAC,CAAC,EAAE,SAAS,KAG1E,CADc,IAAe,IAAU,WAAW,mBAEpD,MAAM,IAAI,EACR,UACA,8BACA,gCAAgC,EAAQ,mPAC1C;CACJ;CAEA,IAAM,IAAW,EAAoB;CACrC,IAAI,EAAS,WAAW,GACtB,MAAM,IAAI,EAAU,UAAU,wBAAwB,mDAAmD;CAC3G,IAAM,IAAyB,KAAkB,EAAS,IAGpD,IAA0C,CAAC;CACjD,KAAK,IAAM,KAAM,GAAU,EAAgB,KAAM,EAAgB,EAAa,EAAI;CAUlF,KAAK,IAAM,KAAM,GAAU;EACzB,IAAM,IAAc,EAAa;EAEjC,EAAgC,GAAI,EAAY,aAAa,IAAI;EAEjE,KAAK,IAAM,CAAC,GAAU,MAAW,OAAO,QAAQ,EAAY,OAAO,GAEjE,AADA,EAAsB,GAAI,CAAQ,GAC9B,GAAQ,gBAAc,EAAgC,GAAI,EAAO,aAAa,MAAM,CAAQ;CAEpG;CAEA,SAAS,EAAe,GAAqC;EAC3D,IAAM,IAAK,KAAW,GAChB,IAAS,EAAa;EAE5B,IAAI,CAAC,GAAQ,MAAM,IAAI,EAAU,UAAU,qBAAqB,yBAAyB,EAAG,EAAE;EAC9F,OAAO;CACT;CAEA,SAAS,EAAkB,GAA0B;EAEnD,OAAO,EADI,KAAW,MACQ;CAChC;CAEA,SAAS,EAAU,GAA8E;EAC/F,OAAO,EAAc,EAAe,GAAY,OAAO,GAAG,GAAY,QAAQ;CAChF;CAEA,SAAS,EAAmB,GAA4B;EACtD,OAAO,EAAe,CAAO,EAAE;CACjC;CAEA,SAAS,EAAc,GAAuC;EAC5D,OAAO,OAAO,KAAK,EAAe,CAAO,EAAE,OAAO;CACpD;CAEA,OAAO;EACL,QAAQ;EACR;EACA,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA,UAAU,GAAkB;GAC1B,OAAO,EAAU,EAAE,SAAS,GAAkB,WAAW,EAAuB,CAAC;EACnF;EACA,MAAM,gBAAgB,GAAkB;GACtC,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,oBACA,+FACF;GAEF,OAAO,EAAgB;IACrB,SAAS,GAAkB,WAAW;IACtC,MAAM,GAAkB;GAC1B,CAAC;EACH;EACA,0BAA0B;GACxB,IAAM,IAAO,KAAyB,WAAoD;GAC1F,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,gBACA,qHACF;GACF,OAAO;EACT;CACF;AACF"}

package/dist/core/config/merge-chain-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-chain-config.d.ts","sourceRoot":"","sources":["../../../src/core/config/merge-chain-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAGL,KAAK,iBAAiB,EAGvB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAClE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAUnC"}
+{"version":3,"file":"merge-chain-config.d.ts","sourceRoot":"","sources":["../../../src/core/config/merge-chain-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAKL,KAAK,iBAAiB,EAOvB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAClE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAUnC"}

package/dist/core/config/merge-chain-config.js

@@ -1,18 +1,20 @@
-import { getChainConfig as e } from "../chains/actions/get-chain-config.js";
-import { listSupportedChains as t } from "../chains/actions/list-supported-chains.js";
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { getChainConfig as t } from "../chains/actions/get-chain-config.js";
+import { listSupportedChains as n } from "../chains/actions/list-supported-chains.js";
 //#region src/core/config/merge-chain-config.ts
-function n(n) {
-	let i = {};
-	for (let a of t()) {
-		let t = e(a), o = n?.[a];
-		i[a] = o ? r(t, o) : t;
+function r(e) {
+	let r = {};
+	for (let a of n()) {
+		let n = t(a), o = e?.[a];
+		r[a] = o ? i(n, o) : n;
 	}
-	return i;
+	return r;
 }
-function r(e, t) {
+function i(e, t) {
 	return {
 		...e,
 		...t.chainId === void 0 ? {} : { chainId: t.chainId },
+		contractsVersion: t.contractsVersion ?? e.contractsVersion,
 		addresses: {
 			...e.addresses,
 			...t.addresses
@@ -21,29 +23,81 @@ function r(e, t) {
 			...e.subgraphs,
 			...t.subgraphs
 		},
-		solver: i(e.solver, t.solver),
-		priceService: {
-			...e.priceService,
-			...t.priceService
-		},
-		notifications: {
-			...e.notifications,
-			...t.notifications
-		},
-		muon: { urls: t.muon?.urls ?? e.muon.urls }
+		solvers: l(e.chainId, e.solvers, t.solvers),
+		defaultSolverId: t.defaultSolverId ?? e.defaultSolverId,
+		priceService: s(e.chainId, e.priceService, t.priceService),
+		muon: { urls: t.muon?.urls ?? e.muon.urls },
+		...o(e.listing, t.listing),
+		...a(e.inventory, t.inventory)
 	};
 }
-function i(e, t) {
-	let n = {
-		...e,
-		...t
-	}, r = t?.tpsl;
-	return r ? n.tpsl = {
-		...e.tpsl ?? {},
+function a(e, t) {
+	let n = t?.url ?? e?.url;
+	return n === void 0 ? {} : { inventory: { url: n } };
+}
+function o(e, t) {
+	let n = t?.url ?? e?.url;
+	return n === void 0 ? {} : { listing: { url: n } };
+}
+function s(t, n, r) {
+	if (!r) return n;
+	let i = {
+		...n,
 		...r
-	} : e.tpsl ? n.tpsl = e.tpsl : delete n.tpsl, n;
+	};
+	if (r.type !== void 0 && r.type !== n.type && (r.url === void 0 || r.wsUrl === void 0)) throw new e("config", "PRICE_SERVICE_OVERRIDE_INCOMPLETE", `createConfig: the priceService override for chain ${t} changes type from "${n.type}" to "${r.type}" but omits ${r.url === void 0 ? "`url`" : "`wsUrl`"}. Supply both URLs when switching provider — inheriting the previous provider's endpoints would point the "${r.type}" client at "${n.type}" hosts.`);
+	return i;
+}
+function c(t, n, r) {
+	if (!r) return n;
+	if (r.protocol !== void 0 && r.protocol !== n.protocol) {
+		let i = r.url === void 0 ? "`url`" : r.protocol === "enigma" && r.channel === void 0 ? "`channel`" : null;
+		if (i) throw new e("config", "NOTIFICATIONS_OVERRIDE_INCOMPLETE", `createConfig: the notifications override for chain ${t} changes protocol from "${n.protocol}" to "${r.protocol}" but omits ${i}. Supply the whole block when switching protocol — inheriting the previous protocol's fields would point the "${r.protocol}" subscriber at "${n.protocol}" endpoints.`);
+		return { ...r };
+	}
+	let i = {
+		...n,
+		...r
+	};
+	return i.protocol === "rasa" && delete i.channel, i;
+}
+function l(e, t, n) {
+	if (!n) return t;
+	let r = { ...t };
+	for (let [i, a] of Object.entries(n)) a && (r[i] = u(e, t[i], a));
+	return r;
+}
+function u(t, n, r) {
+	let i = {
+		...n ?? {},
+		...r
+	}, a = r.tpsl;
+	a ? i.tpsl = {
+		...n?.tpsl ?? {},
+		...a
+	} : n?.tpsl ? i.tpsl = n.tpsl : delete i.tpsl;
+	let o = r.priceService;
+	o ? i.priceService = n?.priceService ? s(t, n.priceService, o) : d(t, o) : n?.priceService ? i.priceService = n.priceService : delete i.priceService;
+	let l = r.notifications;
+	if (l) i.notifications = n?.notifications ? c(t, n.notifications, l) : f(t, l);
+	else if (n?.notifications) i.notifications = n.notifications;
+	else throw new e("config", "SOLVER_NOTIFICATIONS_REQUIRED", `createConfig: a new solver on chain ${t} added via symmioConfig must declare a \`notifications\` block — it is required per solver and there is no base to inherit it from.`);
+	let u = r.capabilities;
+	return u ? i.capabilities = {
+		...n?.capabilities ?? {},
+		...u
+	} : n?.capabilities ? i.capabilities = n.capabilities : delete i.capabilities, i;
+}
+function d(t, n) {
+	if (n.type === void 0 || n.url === void 0 || n.wsUrl === void 0) throw new e("config", "PRICE_SERVICE_OVERRIDE_INCOMPLETE", `createConfig: a solver-nested priceService on chain ${t} must declare \`type\`, \`url\` and \`wsUrl\` — there is no per-solver base to inherit the missing fields from. Omit the block entirely to fall back to the chain's price service.`);
+	return n;
+}
+function f(t, n) {
+	let r = n.url === void 0 ? "`url`" : n.protocol === void 0 ? "`protocol`" : n.protocol === "enigma" && n.channel === void 0 ? "`channel`" : null;
+	if (r) throw new e("config", "NOTIFICATIONS_OVERRIDE_INCOMPLETE", `createConfig: a solver-nested notifications block on chain ${t} must declare ${r} — there is no per-solver base to inherit the missing fields from.`);
+	return n;
 }
 //#endregion
-export { n as buildChainConfigs };
+export { r as buildChainConfigs };
 
 //# sourceMappingURL=merge-chain-config.js.map

package/dist/core/config/merge-chain-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge-chain-config.js","names":[],"sources":["../../../src/core/config/merge-chain-config.ts"],"sourcesContent":["import type { DeepPartial } from \"../../shared/types/properties\";\nimport {\n  getChainConfig,\n  listSupportedChains,\n  type SymmioChainConfig,\n  type SymmioSolverConfig,\n  type SymmioTpSlConfig,\n} from \"../chains\";\n\n/**\n * Build the per-chain config registry a {@link Config} holds: every built-in\n * supported chain, deep-merged with the caller's overrides.\n *\n * @param overrides - Optional per-chain partial overrides keyed by chain id.\n * @returns A registry mapping chain id to its fully-resolved config.\n *\n * @internal\n */\nexport function buildChainConfigs(\n  overrides?: Partial<Record<number, DeepPartial<SymmioChainConfig>>>,\n): Record<number, SymmioChainConfig> {\n  const registry: Record<number, SymmioChainConfig> = {};\n\n  for (const chainId of listSupportedChains()) {\n    const base = getChainConfig(chainId);\n    const override = overrides?.[chainId];\n    registry[chainId] = override ? mergeChainConfig(base, override) : base;\n  }\n\n  return registry;\n}\n\n/**\n * Deep-merge a single chain's overrides onto its built-in defaults. Only the\n * known nested groups (`addresses`, `subgraphs`, `solver`, `priceService`,\n * `notifications`, `muon`) are merged; unknown keys are ignored.\n *\n * @internal\n */\nfunction mergeChainConfig(base: SymmioChainConfig, override: DeepPartial<SymmioChainConfig>): SymmioChainConfig {\n  return {\n    ...base,\n    ...(override.chainId !== undefined ? { chainId: override.chainId } : {}),\n    addresses: { ...base.addresses, ...override.addresses },\n    subgraphs: { ...base.subgraphs, ...override.subgraphs },\n    solver: mergeSolver(base.solver, override.solver),\n    priceService: { ...base.priceService, ...override.priceService },\n    notifications: { ...base.notifications, ...override.notifications },\n    muon: {\n      /** `urls` is replaced wholesale when overridden, otherwise inherited from base. */\n      urls: override.muon?.urls ?? base.muon.urls,\n    },\n  };\n}\n\n/**\n * Merge solver fields. The optional nested `tpsl` block is deep-merged so a\n * partial override (e.g. only changing the `url`) keeps the base's other\n * fields. When neither base nor override declares `tpsl`, it stays absent.\n */\nfunction mergeSolver(\n  base: SymmioSolverConfig,\n  override: DeepPartial<SymmioSolverConfig> | undefined,\n): SymmioSolverConfig {\n  const merged: SymmioSolverConfig = { ...base, ...(override as Partial<SymmioSolverConfig>) };\n  const overrideTpsl = override?.tpsl;\n  if (overrideTpsl) {\n    merged.tpsl = {\n      ...(base.tpsl ?? ({} as SymmioTpSlConfig)),\n      ...(overrideTpsl as Partial<SymmioTpSlConfig>),\n    } as SymmioTpSlConfig;\n  } else if (base.tpsl) {\n    merged.tpsl = base.tpsl;\n  } else {\n    delete merged.tpsl;\n  }\n  return merged;\n}\n"],"mappings":";;;AAkBA,SAAgB,EACd,GACmC;CACnC,IAAM,IAA8C,CAAC;CAErD,KAAK,IAAM,KAAW,EAAoB,GAAG;EAC3C,IAAM,IAAO,EAAe,CAAO,GAC7B,IAAW,IAAY;EAC7B,EAAS,KAAW,IAAW,EAAiB,GAAM,CAAQ,IAAI;CACpE;CAEA,OAAO;AACT;AASA,SAAS,EAAiB,GAAyB,GAA6D;CAC9G,OAAO;EACL,GAAG;EACH,GAAI,EAAS,YAAY,KAAA,IAA4C,CAAC,IAAjC,EAAE,SAAS,EAAS,QAAQ;EACjE,WAAW;GAAE,GAAG,EAAK;GAAW,GAAG,EAAS;EAAU;EACtD,WAAW;GAAE,GAAG,EAAK;GAAW,GAAG,EAAS;EAAU;EACtD,QAAQ,EAAY,EAAK,QAAQ,EAAS,MAAM;EAChD,cAAc;GAAE,GAAG,EAAK;GAAc,GAAG,EAAS;EAAa;EAC/D,eAAe;GAAE,GAAG,EAAK;GAAe,GAAG,EAAS;EAAc;EAClE,MAAM,EAEJ,MAAM,EAAS,MAAM,QAAQ,EAAK,KAAK,KACzC;CACF;AACF;AAOA,SAAS,EACP,GACA,GACoB;CACpB,IAAM,IAA6B;EAAE,GAAG;EAAM,GAAI;CAAyC,GACrF,IAAe,GAAU;CAW/B,OAVI,IACF,EAAO,OAAO;EACZ,GAAI,EAAK,QAAS,CAAC;EACnB,GAAI;CACN,IACS,EAAK,OACd,EAAO,OAAO,EAAK,OAEnB,OAAO,EAAO,MAET;AACT"}
+{"version":3,"file":"merge-chain-config.js","names":[],"sources":["../../../src/core/config/merge-chain-config.ts"],"sourcesContent":["import { SymmError } from \"../../shared/errors/symm-error\";\nimport type { DeepPartial } from \"../../shared/types/properties\";\nimport {\n  getChainConfig,\n  listSupportedChains,\n  type SolverCapabilitiesConfig,\n  type SolverId,\n  type SymmioChainConfig,\n  type SymmioInventoryConfig,\n  type SymmioListingConfig,\n  type SymmioNotificationsConfig,\n  type SymmioPriceServiceConfig,\n  type SymmioSolverConfig,\n  type SymmioTpSlConfig,\n} from \"../chains\";\n\n/**\n * Build the per-chain config registry a {@link Config} holds: every built-in\n * supported chain, deep-merged with the caller's overrides.\n *\n * @param overrides - Optional per-chain partial overrides keyed by chain id.\n * @returns A registry mapping chain id to its fully-resolved config.\n *\n * @internal\n */\nexport function buildChainConfigs(\n  overrides?: Partial<Record<number, DeepPartial<SymmioChainConfig>>>,\n): Record<number, SymmioChainConfig> {\n  const registry: Record<number, SymmioChainConfig> = {};\n\n  for (const chainId of listSupportedChains()) {\n    const base = getChainConfig(chainId);\n    const override = overrides?.[chainId];\n    registry[chainId] = override ? mergeChainConfig(base, override) : base;\n  }\n\n  return registry;\n}\n\n/**\n * Deep-merge a single chain's overrides onto its built-in defaults. Only the\n * known nested groups (`addresses`, `subgraphs`, `solvers`, `priceService`,\n * `notifications`, `muon`, `listing`, `inventory`) are merged; unknown keys are ignored.\n *\n * @internal\n */\nfunction mergeChainConfig(base: SymmioChainConfig, override: DeepPartial<SymmioChainConfig>): SymmioChainConfig {\n  return {\n    ...base,\n    ...(override.chainId !== undefined ? { chainId: override.chainId } : {}),\n    contractsVersion: override.contractsVersion ?? base.contractsVersion,\n    addresses: { ...base.addresses, ...override.addresses },\n    subgraphs: { ...base.subgraphs, ...override.subgraphs },\n    solvers: mergeSolvers(base.chainId, base.solvers, override.solvers),\n    defaultSolverId: override.defaultSolverId ?? base.defaultSolverId,\n    priceService: mergePriceService(base.chainId, base.priceService, override.priceService),\n    muon: {\n      /** `urls` is replaced wholesale when overridden, otherwise inherited from base. */\n      urls: override.muon?.urls ?? base.muon.urls,\n    },\n    ...mergeListing(base.listing, override.listing),\n    ...mergeInventory(base.inventory, override.inventory),\n  };\n}\n\n/**\n * Merge an inventory-service override onto its base. Mirrors\n * {@link mergeListing}: returns a partial so the key stays **absent** when\n * neither side configures the service.\n */\nfunction mergeInventory(\n  base: SymmioInventoryConfig | undefined,\n  override: DeepPartial<SymmioInventoryConfig> | undefined,\n): Pick<SymmioChainConfig, \"inventory\"> | Record<string, never> {\n  const url = override?.url ?? base?.url;\n  return url === undefined ? {} : { inventory: { url } };\n}\n\n/**\n * Merge a listing-service override onto its base.\n *\n * Returns a partial so the key stays **absent** when neither side configures the\n * service — an explicit `listing: undefined` would still be an own property and\n * would read as \"configured but empty\" to anything doing a key check.\n */\nfunction mergeListing(\n  base: SymmioListingConfig | undefined,\n  override: DeepPartial<SymmioListingConfig> | undefined,\n): Pick<SymmioChainConfig, \"listing\"> | Record<string, never> {\n  const url = override?.url ?? base?.url;\n  return url === undefined ? {} : { listing: { url } };\n}\n\n/**\n * Merge a price-service override onto its base.\n *\n * A plain spread is wrong once more than one provider exists: an override that\n * switches `type` without restating both URLs would inherit the *previous*\n * provider's endpoints, pointing one provider's client at another's host. That\n * type-checks cleanly and fails at runtime as a confusing 404, so a `type` swap\n * is required to supply the whole block.\n *\n * A same-type (or type-less) override still merges field-by-field, so the common\n * `{ url, wsUrl }` staging override keeps working.\n *\n * @throws {SymmError} `PRICE_SERVICE_OVERRIDE_INCOMPLETE` when the override\n *   changes `type` but omits `url` or `wsUrl`.\n */\nfunction mergePriceService(\n  chainId: number,\n  base: SymmioPriceServiceConfig,\n  override: DeepPartial<SymmioPriceServiceConfig> | undefined,\n): SymmioPriceServiceConfig {\n  if (!override) return base;\n\n  const merged = { ...base, ...override } as SymmioPriceServiceConfig;\n  const swapsProvider = override.type !== undefined && override.type !== base.type;\n  if (swapsProvider && (override.url === undefined || override.wsUrl === undefined)) {\n    throw new SymmError(\n      \"config\",\n      \"PRICE_SERVICE_OVERRIDE_INCOMPLETE\",\n      `createConfig: the priceService override for chain ${chainId} changes type from \"${base.type}\" to \"${override.type}\" but omits ${override.url === undefined ? \"`url`\" : \"`wsUrl`\"}. Supply both URLs when switching provider — inheriting the previous provider's endpoints would point the \"${override.type}\" client at \"${base.type}\" hosts.`,\n    );\n  }\n  return merged;\n}\n\n/**\n * Merge a notifications override onto its base.\n *\n * Same trap as {@link mergePriceService}: once the config is a per-protocol\n * union, an override that switches `protocol` without restating the endpoint\n * would inherit the *previous* protocol's fields — a `rasa → enigma` swap\n * without a `channel` (or either swap without a `url`) type-checks as a\n * `DeepPartial` and fails at runtime. So a `protocol` swap must supply the\n * whole block; a same-protocol override still merges field-by-field.\n *\n * A swap takes the override block **alone** — nothing is inherited, including\n * the optional `searchUrl` (the previous protocol's REST search service does\n * not index the new protocol's stream).\n *\n * @throws {SymmError} `NOTIFICATIONS_OVERRIDE_INCOMPLETE` when the override\n *   changes `protocol` but omits `url`, or targets `enigma` without a\n *   `channel`.\n */\nfunction mergeNotifications(\n  chainId: number,\n  base: SymmioNotificationsConfig,\n  override: DeepPartial<SymmioNotificationsConfig> | undefined,\n): SymmioNotificationsConfig {\n  if (!override) return base;\n\n  const swapsProtocol = override.protocol !== undefined && override.protocol !== base.protocol;\n  if (swapsProtocol) {\n    const missing =\n      override.url === undefined\n        ? \"`url`\"\n        : override.protocol === \"enigma\" && (override as { channel?: string }).channel === undefined\n          ? \"`channel`\"\n          : null;\n    if (missing) {\n      throw new SymmError(\n        \"config\",\n        \"NOTIFICATIONS_OVERRIDE_INCOMPLETE\",\n        `createConfig: the notifications override for chain ${chainId} changes protocol from \"${base.protocol}\" to \"${override.protocol}\" but omits ${missing}. Supply the whole block when switching protocol — inheriting the previous protocol's fields would point the \"${override.protocol}\" subscriber at \"${base.protocol}\" endpoints.`,\n      );\n    }\n    return { ...override } as SymmioNotificationsConfig;\n  }\n\n  const merged = { ...base, ...override } as SymmioNotificationsConfig;\n  if (merged.protocol === \"rasa\") {\n    // A cast override could still sneak a `channel` key onto the rasa variant.\n    delete (merged as { channel?: string }).channel;\n  }\n  return merged;\n}\n\n/**\n * Merge a per-chain solver map by id: each overridden solver is deep-merged onto\n * its base (or added when the id is new). Solvers the override does not mention\n * are inherited unchanged.\n */\nfunction mergeSolvers(\n  chainId: number,\n  base: Partial<Record<SolverId, SymmioSolverConfig>>,\n  override: DeepPartial<Record<SolverId, SymmioSolverConfig>> | undefined,\n): Partial<Record<SolverId, SymmioSolverConfig>> {\n  if (!override) return base;\n  const merged: Partial<Record<SolverId, SymmioSolverConfig>> = { ...base };\n  for (const [id, solverOverride] of Object.entries(override) as [SolverId, DeepPartial<SymmioSolverConfig>][]) {\n    if (!solverOverride) continue;\n    merged[id] = mergeSolver(chainId, base[id], solverOverride);\n  }\n  return merged;\n}\n\n/**\n * Merge one solver's fields. The optional nested `tpsl` and `priceService` blocks\n * are deep-merged so a partial override (e.g. only the `url`) keeps the base's\n * other fields. When neither base nor override declares a block, it stays absent\n * — for `priceService` that absence is meaningful: it is what makes the solver\n * fall back to the chain-level price service.\n */\nfunction mergeSolver(\n  chainId: number,\n  base: SymmioSolverConfig | undefined,\n  override: DeepPartial<SymmioSolverConfig>,\n): SymmioSolverConfig {\n  const merged = { ...(base ?? {}), ...(override as Partial<SymmioSolverConfig>) } as SymmioSolverConfig;\n\n  const overrideTpsl = override.tpsl;\n  if (overrideTpsl) {\n    merged.tpsl = {\n      ...(base?.tpsl ?? ({} as SymmioTpSlConfig)),\n      ...(overrideTpsl as Partial<SymmioTpSlConfig>),\n    } as SymmioTpSlConfig;\n  } else if (base?.tpsl) {\n    merged.tpsl = base.tpsl;\n  } else {\n    delete merged.tpsl;\n  }\n\n  const overridePriceService = override.priceService;\n  if (overridePriceService) {\n    // With no base block there is nothing to inherit, so the override must be\n    // complete — route it through the same type-swap guard by treating it as a\n    // swap away from the base (or chain) provider.\n    merged.priceService = base?.priceService\n      ? mergePriceService(chainId, base.priceService, overridePriceService)\n      : assertCompletePriceService(chainId, overridePriceService);\n  } else if (base?.priceService) {\n    merged.priceService = base.priceService;\n  } else {\n    delete merged.priceService;\n  }\n\n  const overrideNotifications = override.notifications;\n  if (overrideNotifications) {\n    // With a base solver, deep-merge (same protocol-swap guard as the chain path\n    // used to apply). With no base, the override must be a complete block.\n    merged.notifications = base?.notifications\n      ? mergeNotifications(chainId, base.notifications, overrideNotifications)\n      : assertCompleteNotifications(chainId, overrideNotifications);\n  } else if (base?.notifications) {\n    merged.notifications = base.notifications;\n  } else {\n    throw new SymmError(\n      \"config\",\n      \"SOLVER_NOTIFICATIONS_REQUIRED\",\n      `createConfig: a new solver on chain ${chainId} added via symmioConfig must declare a \\`notifications\\` block — it is required per solver and there is no base to inherit it from.`,\n    );\n  }\n\n  const overrideCapabilities = override.capabilities;\n  if (overrideCapabilities) {\n    merged.capabilities = {\n      ...(base?.capabilities ?? {}),\n      ...(overrideCapabilities as SolverCapabilitiesConfig),\n    };\n  } else if (base?.capabilities) {\n    merged.capabilities = base.capabilities;\n  } else {\n    delete merged.capabilities;\n  }\n\n  return merged;\n}\n\n/**\n * Validate a solver-nested price service that has no base to inherit from: every\n * field must be present, since there is nothing to fall back to.\n *\n * @throws {SymmError} `PRICE_SERVICE_OVERRIDE_INCOMPLETE`\n */\nfunction assertCompletePriceService(\n  chainId: number,\n  override: DeepPartial<SymmioPriceServiceConfig>,\n): SymmioPriceServiceConfig {\n  if (override.type === undefined || override.url === undefined || override.wsUrl === undefined) {\n    throw new SymmError(\n      \"config\",\n      \"PRICE_SERVICE_OVERRIDE_INCOMPLETE\",\n      `createConfig: a solver-nested priceService on chain ${chainId} must declare \\`type\\`, \\`url\\` and \\`wsUrl\\` — there is no per-solver base to inherit the missing fields from. Omit the block entirely to fall back to the chain's price service.`,\n    );\n  }\n  return override as SymmioPriceServiceConfig;\n}\n\n/**\n * Validate a solver-nested notifications block that has no base to inherit from\n * (a brand-new solver added via `symmioConfig`): `url` and `protocol` are always\n * required, and `enigma` additionally requires a `channel`.\n *\n * @throws {SymmError} `NOTIFICATIONS_OVERRIDE_INCOMPLETE`\n */\nfunction assertCompleteNotifications(\n  chainId: number,\n  override: DeepPartial<SymmioNotificationsConfig>,\n): SymmioNotificationsConfig {\n  const missing =\n    override.url === undefined\n      ? \"`url`\"\n      : override.protocol === undefined\n        ? \"`protocol`\"\n        : override.protocol === \"enigma\" && (override as { channel?: string }).channel === undefined\n          ? \"`channel`\"\n          : null;\n  if (missing) {\n    throw new SymmError(\n      \"config\",\n      \"NOTIFICATIONS_OVERRIDE_INCOMPLETE\",\n      `createConfig: a solver-nested notifications block on chain ${chainId} must declare ${missing} — there is no per-solver base to inherit the missing fields from.`,\n    );\n  }\n  return override as SymmioNotificationsConfig;\n}\n"],"mappings":"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"}