@symmio/trading-core 3.0.0 → 3.1.0

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

@@ -1,4 +1,5 @@
 import { Address } from 'viem';
+import { GaslessRelayEvent } from '../../gasless/types.js';
 /**
  * Contract addresses for a SYMMIO chain deployment.
  */
@@ -320,6 +321,196 @@ export interface SymmioInventoryConfig {
      */
     url: string;
 }
+/**
+ * Failure policy for the transparent gasless execution mode, applied when the
+ * relay definitively rejects a request **before** it is accepted (a 4xx, or a
+ * pre-broadcast `rejected`).
+ *
+ * - `"error"` (default): surface a typed error; the consumer decides what to do.
+ * - `"wallet"`: silently fall back to the normal gas-paid wallet path.
+ *
+ * After the service accepts a request (HTTP 202) no fallback ever happens — the
+ * relayed transaction may still execute, and a wallet retry would duplicate it.
+ */
+export type GaslessFallback = "error" | "wallet";
+/**
+ * Defaults governing how existing contract writes dispatch when the transparent
+ * gasless execution mode is active. Every field can be overridden per call via
+ * the `gasless` write parameter.
+ */
+export interface GaslessExecutionConfig {
+    /**
+     * `"wallet"` (default): writes go through the connected wallet as always.
+     * `"gasless"`: relayable writes are signed as InstantLayer operations and
+     * relayed through GaslessQ; non-relayable writes keep the wallet path.
+     */
+    mode?: "wallet" | "gasless";
+    /** Pre-acceptance failure policy. Default `"error"`. */
+    fallback?: GaslessFallback;
+    /**
+     * Quote the batch on-chain (the GaslessLayer's `previewFeeQuote`) before
+     * prompting the user for a signature, and fail fast when the quote refuses
+     * it: `GASLESS_FREE_QUOTA_EXHAUSTED` when the daily free quota is spent (the
+     * one case `fallback: "wallet"` recovers from), `GASLESS_FEE_QUOTE_REVERTED`
+     * when the contract rejects the batch, and `GASLESS_LAYER_INTERFACE_UNSUPPORTED`
+     * when the GaslessLayer predates the multi-wallet interface. A quote that
+     * fails for transport reasons does not block, and the quote never checks
+     * affordability — the relayer's simulation is authoritative. Default `true`.
+     */
+    preflightFee?: boolean;
+    /**
+     * Verify on-chain (`isDelegationActive`) that the signing key is authorized
+     * for every selector a relayed write carries before prompting the user for a
+     * signature, and fail fast when a session key is missing a delegation.
+     * Skipped for the sub-account's own owner, who needs no delegation.
+     * Default `true`.
+     */
+    preflightDelegation?: boolean;
+    /** Max wait for the relayer to broadcast before timing out. Default `120_000` ms. */
+    broadcastTimeoutMs?: number;
+    /** Status poll cadence while the request is `queued`. Default `1_500` ms. */
+    queuedPollMs?: number;
+    /** Status poll cadence after the request is `submitted`. Default `3_000` ms. */
+    submittedPollMs?: number;
+    /**
+     * How long a status wait lets the gateway's stream settle before falling back
+     * to its first HTTP read. It ends early the moment the stream delivers, or
+     * reports that it will not (unreachable, not-found, at its subscription cap,
+     * disabled). Ignored where the stream is off. Default `1_000` ms.
+     */
+    streamSettleMs?: number;
+    /**
+     * How long a delivering stream may report nothing about a workflow before the
+     * wait takes one HTTP read anyway and re-arms. Heartbeats do not count — only
+     * records for the request do. Default `15_000` ms.
+     */
+    streamStaleMs?: number;
+    /**
+     * HTTP timeout for each gasless submit, in ms: every relay and
+     * deposit-settlement POST, from the explicit actions as well as the
+     * transparent mode. A submit that times out is ambiguous (the gateway may
+     * already have accepted it) and fails like a network error, with status `0`.
+     * Status reads are not bounded by it. Default `30_000`.
+     */
+    submitTimeoutMs?: number;
+    /**
+     * Lifecycle observer for relayed writes — fires at `accepted`, `broadcast`,
+     * and `terminal`. Persist request ids in the `accepted` event so in-flight
+     * workflows survive reloads.
+     */
+    onEvent?: (event: GaslessRelayEvent) => void;
+}
+/**
+ * Status-stream availability for one GaslessQ deployment. It is a deployment
+ * fact, like the URL. Status WebSockets are optional and disabled by default at
+ * the gateway, and each environment enables them separately, so a stream is
+ * declared per chain rather than assumed.
+ *
+ * Where it is enabled, the stream is the primary transport for status waits and
+ * HTTP reads become the fallback: a wait subscribes, gives the stream
+ * `execution.streamSettleMs` to deliver, and polls only while the stream is not
+ * delivering. HTTP status reads stay available whether or not a stream is
+ * declared.
+ */
+export interface SymmioGaslessStatusStreamConfig {
+    /**
+     * Whether this deployment serves the status WebSocket. Set it to `true` only
+     * once the operators confirm streams for this environment and protocol
+     * instance. A staging confirmation does not cover production.
+     */
+    enabled: boolean;
+    /**
+     * The gateway's `https://` origin, used to locate the stream when `url` is a
+     * proxy root, because a proxy that forwards HTTP cannot be assumed to forward
+     * WebSockets. Omit it for the gateway `url` forms, whose stream endpoint
+     * derives from `url` itself.
+     */
+    origin?: string;
+}
+/**
+ * Chain-level configuration for the GaslessQ relayer service.
+ *
+ * GaslessQ relays user-signed InstantLayer operations so account actions need
+ * no native gas: the relayer broadcasts and pays, and the **GaslessLayer**
+ * contract charges an operational fee from the user's SYMMIO collateral in the
+ * same atomic transaction. Optional and chain-level, like `listing`: present
+ * only on perps-core (`"0.8.6"`) chains with a GaslessLayer deployment.
+ * Resolve it with `resolveGaslessService` / gate on `supportsGaslessService`.
+ *
+ * The gateway serves anonymous clients by default, so a browser app can call it
+ * directly with no `apiKey`, as long as the deployment allows the app's Origin
+ * and has not disabled anonymous access.
+ */
+export interface SymmioGaslessConfig {
+    /**
+     * Where the SDK reaches the GaslessQ gateway. One of:
+     *
+     * - the gateway **origin** (`https://host`, no path) with `protocolInstance`,
+     *   the recommended form. The SDK derives
+     *   `/v1/instances/{protocolInstance}/{operations|deposits}`.
+     * - an **instance root** (`…/v1/instances/<protocol-instance>`). The SDK
+     *   appends `/{service}`.
+     * - an **instance-pinned service base**
+     *   (`…/v1/instances/<protocol-instance>/operations` or `…/deposits`), used
+     *   as-is and for that one service only.
+     * - any other path, absolute or relative, is a **proxy root** (for example a
+     *   server-side proxy at `/api/gasless`). The SDK appends `/{service}`.
+     *
+     * The instance-less `/v1/operations` and `/v1/deposits` compatibility routes
+     * are rejected with `GASLESS_URL_LEGACY_ROUTE`: the gateway is retiring them,
+     * and they pin no instance to verify responses against. A query string, a
+     * fragment, credentials (`user:password@`) or a non-HTTP(S) scheme is
+     * rejected with `GASLESS_URL_INVALID`.
+     */
+    url: string;
+    /**
+     * Protocol-instance key selecting the deployment at the gateway
+     * (`"<protocol-instance>"`, from the deployment handoff). Staging and
+     * production can share a chain id, so the key, not the chain, picks the
+     * contracts.
+     *
+     * Required with an origin `url` (`GASLESS_PROTOCOL_INSTANCE_REQUIRED`). With
+     * an instance root or service base it may be omitted, but when given it must
+     * equal the instance the path pins (`GASLESS_PROTOCOL_INSTANCE_CONFLICT`).
+     * With a proxy root it is the instance successful responses are checked
+     * against, whenever the proxy forwards the `X-GasLessQ-Protocol-Instance`
+     * header.
+     */
+    protocolInstance?: string;
+    /**
+     * The GaslessLayer proxy address — the operational-fee charger and the
+     * source of every gasless read (wallet addresses, deposit policy, fee
+     * quotes, nonces). A deployment fact with **no runtime discovery**: update it
+     * on every gateway redeploy. It must run the multi-wallet GaslessLayer
+     * interface (`walletId`-scoped reads, `previewFeeQuote`); a proxy that has not
+     * been upgraded to it is unsupported, and its fee quote throws
+     * `GASLESS_LAYER_INTERFACE_UNSUPPORTED`.
+     */
+    gaslessLayerAddress: Address;
+    /**
+     * Optional partner key, sent as `Authorization: Bearer <key>`. Omit it to use
+     * the gateway's anonymous profile, which is on by default: 10 requests per
+     * second per caller IP and protocol instance, shared across operations and
+     * deposits, with no `Authorization` header sent at all. Where anonymous access
+     * is on, a key only raises the gateway limits. A deployment can turn it off,
+     * and then answers keyless requests with `401`, so a key is required there. A
+     * key must be authorized for the protocol instance and service it calls, and
+     * it changes neither fees, wallet selection nor signatures.
+     *
+     * Meant for servers and backend-for-frontend proxies. **Never ship a key in a
+     * browser bundle**, where anyone can read it. An invalid, disabled or
+     * unauthorized key is rejected (`401` / `403`) and never falls back to
+     * anonymous access. Errors the SDK throws never carry the key.
+     */
+    apiKey?: string;
+    /**
+     * Status-stream availability for this deployment. Omitted, the deployment is
+     * treated as serving no stream.
+     */
+    statusStream?: SymmioGaslessStatusStreamConfig;
+    /** Transparent execution-mode defaults for existing contract writes. */
+    execution?: GaslessExecutionConfig;
+}
 /**
  * The perps-core contracts generation a chain's deployment runs.
  *
@@ -369,6 +560,12 @@ export interface SymmioChainConfig {
      * resolve it with `resolveInventoryService`.
      */
     inventory?: SymmioInventoryConfig;
+    /**
+     * Optional GaslessQ relayer service. Set on perps-core (`"0.8.6"`) chains
+     * with a GaslessLayer deployment; omitted elsewhere. Resolve it with
+     * `resolveGaslessService` / gate on `supportsGaslessService`.
+     */
+    gasless?: SymmioGaslessConfig;
 }
 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;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,6BAA8B,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC;;;;;OAKG;IACH,aAAa,EAAE,yBAAyB,CAAC;IACzC;;;OAGG;IACH,YAAY,CAAC,EAAE,wBAAwB,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,kDAAkD;IAClD,EAAE,EAAE,QAAQ,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,gCAAiC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,IAAI,EAAE,sBAAsB,CAAC;IAC7B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D;;GAEG;AACH,UAAU,6BAA6B;IACrC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,+BAAgC,SAAQ,6BAA6B;IACpF,yCAAyC;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA8B,SAAQ,6BAA6B;IAClF,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,yBAAyB,GAAG,+BAA+B,GAAG,6BAA6B,CAAC;AAExG;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,yBAAyB;IACzB,SAAS,EAAE,uBAAuB,CAAC;IACnC,yBAAyB;IACzB,SAAS,EAAE,kBAAkB,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACvD,mFAAmF;IACnF,eAAe,EAAE,QAAQ,CAAC;IAC1B,kCAAkC;IAClC,YAAY,EAAE,wBAAwB,CAAC;IACvC,gCAAgC;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC"}
+{"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.map

@@ -1 +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 `sendQuote`) */\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. `Arbitrum_COH_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 Arbitrum); 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 * The perps-core contracts generation a chain's deployment runs.\n *\n * A **deployment fact, declared per chain** — it is not probed at runtime (the\n * diamond exposes no version view). It drives the version-sensitive seams the\n * SDK carries for serving mixed-generation chains from one release: which\n * quote-send call the instant-open flow signs (`sendQuote` with solver-fee caps\n * on `\"0.8.6\"`, the legacy `sendQuoteWithAffiliateAndData` on `\"0.8.5\"`), which\n * selector the session-key delegation set includes, and which output shape the\n * withdraw-request reads decode.\n */\nexport type SymmioContractsVersion = \"0.8.5\" | \"0.8.6\";\n\n/**\n * Complete resolved configuration for a SYMMIO chain deployment.\n */\nexport interface SymmioChainConfig {\n  /** Chain ID */\n  chainId: number;\n  /** Contracts generation deployed on this chain. See {@link SymmioContractsVersion}. */\n  contractsVersion: SymmioContractsVersion;\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 Arbitrum); 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"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/core/chains/types.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { GaslessRelayEvent } from \"../../gasless/types\";\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 `sendQuote`) */\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. `Arbitrum_COH_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 Arbitrum); 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 * Failure policy for the transparent gasless execution mode, applied when the\n * relay definitively rejects a request **before** it is accepted (a 4xx, or a\n * pre-broadcast `rejected`).\n *\n * - `\"error\"` (default): surface a typed error; the consumer decides what to do.\n * - `\"wallet\"`: silently fall back to the normal gas-paid wallet path.\n *\n * After the service accepts a request (HTTP 202) no fallback ever happens — the\n * relayed transaction may still execute, and a wallet retry would duplicate it.\n */\nexport type GaslessFallback = \"error\" | \"wallet\";\n\n/**\n * Defaults governing how existing contract writes dispatch when the transparent\n * gasless execution mode is active. Every field can be overridden per call via\n * the `gasless` write parameter.\n */\nexport interface GaslessExecutionConfig {\n  /**\n   * `\"wallet\"` (default): writes go through the connected wallet as always.\n   * `\"gasless\"`: relayable writes are signed as InstantLayer operations and\n   * relayed through GaslessQ; non-relayable writes keep the wallet path.\n   */\n  mode?: \"wallet\" | \"gasless\";\n  /** Pre-acceptance failure policy. Default `\"error\"`. */\n  fallback?: GaslessFallback;\n  /**\n   * Quote the batch on-chain (the GaslessLayer's `previewFeeQuote`) before\n   * prompting the user for a signature, and fail fast when the quote refuses\n   * it: `GASLESS_FREE_QUOTA_EXHAUSTED` when the daily free quota is spent (the\n   * one case `fallback: \"wallet\"` recovers from), `GASLESS_FEE_QUOTE_REVERTED`\n   * when the contract rejects the batch, and `GASLESS_LAYER_INTERFACE_UNSUPPORTED`\n   * when the GaslessLayer predates the multi-wallet interface. A quote that\n   * fails for transport reasons does not block, and the quote never checks\n   * affordability — the relayer's simulation is authoritative. Default `true`.\n   */\n  preflightFee?: boolean;\n  /**\n   * Verify on-chain (`isDelegationActive`) that the signing key is authorized\n   * for every selector a relayed write carries before prompting the user for a\n   * signature, and fail fast when a session key is missing a delegation.\n   * Skipped for the sub-account's own owner, who needs no delegation.\n   * Default `true`.\n   */\n  preflightDelegation?: boolean;\n  /** Max wait for the relayer to broadcast before timing out. Default `120_000` ms. */\n  broadcastTimeoutMs?: number;\n  /** Status poll cadence while the request is `queued`. Default `1_500` ms. */\n  queuedPollMs?: number;\n  /** Status poll cadence after the request is `submitted`. Default `3_000` ms. */\n  submittedPollMs?: number;\n  /**\n   * How long a status wait lets the gateway's stream settle before falling back\n   * to its first HTTP read. It ends early the moment the stream delivers, or\n   * reports that it will not (unreachable, not-found, at its subscription cap,\n   * disabled). Ignored where the stream is off. Default `1_000` ms.\n   */\n  streamSettleMs?: number;\n  /**\n   * How long a delivering stream may report nothing about a workflow before the\n   * wait takes one HTTP read anyway and re-arms. Heartbeats do not count — only\n   * records for the request do. Default `15_000` ms.\n   */\n  streamStaleMs?: number;\n  /**\n   * HTTP timeout for each gasless submit, in ms: every relay and\n   * deposit-settlement POST, from the explicit actions as well as the\n   * transparent mode. A submit that times out is ambiguous (the gateway may\n   * already have accepted it) and fails like a network error, with status `0`.\n   * Status reads are not bounded by it. Default `30_000`.\n   */\n  submitTimeoutMs?: number;\n  /**\n   * Lifecycle observer for relayed writes — fires at `accepted`, `broadcast`,\n   * and `terminal`. Persist request ids in the `accepted` event so in-flight\n   * workflows survive reloads.\n   */\n  onEvent?: (event: GaslessRelayEvent) => void;\n}\n\n/**\n * Status-stream availability for one GaslessQ deployment. It is a deployment\n * fact, like the URL. Status WebSockets are optional and disabled by default at\n * the gateway, and each environment enables them separately, so a stream is\n * declared per chain rather than assumed.\n *\n * Where it is enabled, the stream is the primary transport for status waits and\n * HTTP reads become the fallback: a wait subscribes, gives the stream\n * `execution.streamSettleMs` to deliver, and polls only while the stream is not\n * delivering. HTTP status reads stay available whether or not a stream is\n * declared.\n */\nexport interface SymmioGaslessStatusStreamConfig {\n  /**\n   * Whether this deployment serves the status WebSocket. Set it to `true` only\n   * once the operators confirm streams for this environment and protocol\n   * instance. A staging confirmation does not cover production.\n   */\n  enabled: boolean;\n  /**\n   * The gateway's `https://` origin, used to locate the stream when `url` is a\n   * proxy root, because a proxy that forwards HTTP cannot be assumed to forward\n   * WebSockets. Omit it for the gateway `url` forms, whose stream endpoint\n   * derives from `url` itself.\n   */\n  origin?: string;\n}\n\n/**\n * Chain-level configuration for the GaslessQ relayer service.\n *\n * GaslessQ relays user-signed InstantLayer operations so account actions need\n * no native gas: the relayer broadcasts and pays, and the **GaslessLayer**\n * contract charges an operational fee from the user's SYMMIO collateral in the\n * same atomic transaction. Optional and chain-level, like `listing`: present\n * only on perps-core (`\"0.8.6\"`) chains with a GaslessLayer deployment.\n * Resolve it with `resolveGaslessService` / gate on `supportsGaslessService`.\n *\n * The gateway serves anonymous clients by default, so a browser app can call it\n * directly with no `apiKey`, as long as the deployment allows the app's Origin\n * and has not disabled anonymous access.\n */\nexport interface SymmioGaslessConfig {\n  /**\n   * Where the SDK reaches the GaslessQ gateway. One of:\n   *\n   * - the gateway **origin** (`https://host`, no path) with `protocolInstance`,\n   *   the recommended form. The SDK derives\n   *   `/v1/instances/{protocolInstance}/{operations|deposits}`.\n   * - an **instance root** (`…/v1/instances/<protocol-instance>`). The SDK\n   *   appends `/{service}`.\n   * - an **instance-pinned service base**\n   *   (`…/v1/instances/<protocol-instance>/operations` or `…/deposits`), used\n   *   as-is and for that one service only.\n   * - any other path, absolute or relative, is a **proxy root** (for example a\n   *   server-side proxy at `/api/gasless`). The SDK appends `/{service}`.\n   *\n   * The instance-less `/v1/operations` and `/v1/deposits` compatibility routes\n   * are rejected with `GASLESS_URL_LEGACY_ROUTE`: the gateway is retiring them,\n   * and they pin no instance to verify responses against. A query string, a\n   * fragment, credentials (`user:password@`) or a non-HTTP(S) scheme is\n   * rejected with `GASLESS_URL_INVALID`.\n   */\n  url: string;\n  /**\n   * Protocol-instance key selecting the deployment at the gateway\n   * (`\"<protocol-instance>\"`, from the deployment handoff). Staging and\n   * production can share a chain id, so the key, not the chain, picks the\n   * contracts.\n   *\n   * Required with an origin `url` (`GASLESS_PROTOCOL_INSTANCE_REQUIRED`). With\n   * an instance root or service base it may be omitted, but when given it must\n   * equal the instance the path pins (`GASLESS_PROTOCOL_INSTANCE_CONFLICT`).\n   * With a proxy root it is the instance successful responses are checked\n   * against, whenever the proxy forwards the `X-GasLessQ-Protocol-Instance`\n   * header.\n   */\n  protocolInstance?: string;\n  /**\n   * The GaslessLayer proxy address — the operational-fee charger and the\n   * source of every gasless read (wallet addresses, deposit policy, fee\n   * quotes, nonces). A deployment fact with **no runtime discovery**: update it\n   * on every gateway redeploy. It must run the multi-wallet GaslessLayer\n   * interface (`walletId`-scoped reads, `previewFeeQuote`); a proxy that has not\n   * been upgraded to it is unsupported, and its fee quote throws\n   * `GASLESS_LAYER_INTERFACE_UNSUPPORTED`.\n   */\n  gaslessLayerAddress: Address;\n  /**\n   * Optional partner key, sent as `Authorization: Bearer <key>`. Omit it to use\n   * the gateway's anonymous profile, which is on by default: 10 requests per\n   * second per caller IP and protocol instance, shared across operations and\n   * deposits, with no `Authorization` header sent at all. Where anonymous access\n   * is on, a key only raises the gateway limits. A deployment can turn it off,\n   * and then answers keyless requests with `401`, so a key is required there. A\n   * key must be authorized for the protocol instance and service it calls, and\n   * it changes neither fees, wallet selection nor signatures.\n   *\n   * Meant for servers and backend-for-frontend proxies. **Never ship a key in a\n   * browser bundle**, where anyone can read it. An invalid, disabled or\n   * unauthorized key is rejected (`401` / `403`) and never falls back to\n   * anonymous access. Errors the SDK throws never carry the key.\n   */\n  apiKey?: string;\n  /**\n   * Status-stream availability for this deployment. Omitted, the deployment is\n   * treated as serving no stream.\n   */\n  statusStream?: SymmioGaslessStatusStreamConfig;\n  /** Transparent execution-mode defaults for existing contract writes. */\n  execution?: GaslessExecutionConfig;\n}\n\n/**\n * The perps-core contracts generation a chain's deployment runs.\n *\n * A **deployment fact, declared per chain** — it is not probed at runtime (the\n * diamond exposes no version view). It drives the version-sensitive seams the\n * SDK carries for serving mixed-generation chains from one release: which\n * quote-send call the instant-open flow signs (`sendQuote` with solver-fee caps\n * on `\"0.8.6\"`, the legacy `sendQuoteWithAffiliateAndData` on `\"0.8.5\"`), which\n * selector the session-key delegation set includes, and which output shape the\n * withdraw-request reads decode.\n */\nexport type SymmioContractsVersion = \"0.8.5\" | \"0.8.6\";\n\n/**\n * Complete resolved configuration for a SYMMIO chain deployment.\n */\nexport interface SymmioChainConfig {\n  /** Chain ID */\n  chainId: number;\n  /** Contracts generation deployed on this chain. See {@link SymmioContractsVersion}. */\n  contractsVersion: SymmioContractsVersion;\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 Arbitrum); 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   * Optional GaslessQ relayer service. Set on perps-core (`\"0.8.6\"`) chains\n   * with a GaslessLayer deployment; omitted elsewhere. Resolve it with\n   * `resolveGaslessService` / gate on `supportsGaslessService`.\n   */\n  gasless?: SymmioGaslessConfig;\n}\n"],"mappings":";AAuDA,IAAa,IAAyB,CAAC,UAAU,MAAM,GA8H1C,IAAgC,CAAC,UAAU,SAAS"}

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":"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"}
+{"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,EAML,KAAK,iBAAiB,EASvB,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

@@ -23,23 +23,53 @@ function i(e, t) {
 			...e.subgraphs,
 			...t.subgraphs
 		},
-		solvers: l(e.chainId, e.solvers, t.solvers),
+		solvers: d(e.chainId, e.solvers, t.solvers),
 		defaultSolverId: t.defaultSolverId ?? e.defaultSolverId,
-		priceService: s(e.chainId, e.priceService, t.priceService),
+		priceService: l(e.chainId, e.priceService, t.priceService),
 		muon: { urls: t.muon?.urls ?? e.muon.urls },
-		...o(e.listing, t.listing),
-		...a(e.inventory, t.inventory)
+		...c(e.listing, t.listing),
+		...s(e.inventory, t.inventory),
+		...a(e.chainId, e.gasless, t.gasless)
 	};
 }
-function a(e, t) {
+function a(t, n, r) {
+	if (!n && !r) return {};
+	if (!r) return { gasless: n };
+	let i = r.url ?? n?.url, a = r.gaslessLayerAddress ?? n?.gaslessLayerAddress;
+	if (i === void 0 || a === void 0) throw new e("config", "GASLESS_OVERRIDE_INCOMPLETE", `createConfig: the gasless override for chain ${t} must declare ${i === void 0 ? "`url`" : "`gaslessLayerAddress`"} — there is no built-in gasless config to inherit it from.`);
+	let s = r.execution || n?.execution ? {
+		...n?.execution ?? {},
+		...r.execution ?? {}
+	} : void 0, c = r.protocolInstance ?? n?.protocolInstance, l = r.apiKey ?? n?.apiKey, u = o(t, n?.statusStream, r.statusStream);
+	return { gasless: {
+		url: i,
+		gaslessLayerAddress: a,
+		...c === void 0 ? {} : { protocolInstance: c },
+		...l === void 0 ? {} : { apiKey: l },
+		...u ? { statusStream: u } : {},
+		...s ? { execution: s } : {}
+	} };
+}
+function o(t, n, r) {
+	let i = r?.enabled ?? n?.enabled, a = r?.origin ?? n?.origin;
+	if (i === void 0) {
+		if (a === void 0) return;
+		throw new e("config", "GASLESS_OVERRIDE_INCOMPLETE", `createConfig: the gasless statusStream override for chain ${t} sets \`origin\` but not \`enabled\` — there is no statusStream block to inherit it from.`);
+	}
+	return {
+		enabled: i,
+		...a === void 0 ? {} : { origin: a }
+	};
+}
+function s(e, t) {
 	let n = t?.url ?? e?.url;
 	return n === void 0 ? {} : { inventory: { url: n } };
 }
-function o(e, t) {
+function c(e, t) {
 	let n = t?.url ?? e?.url;
 	return n === void 0 ? {} : { listing: { url: n } };
 }
-function s(t, n, r) {
+function l(t, n, r) {
 	if (!r) return n;
 	let i = {
 		...n,
@@ -48,7 +78,7 @@ function s(t, n, r) {
 	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) {
+function u(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;
@@ -61,13 +91,13 @@ function c(t, n, r) {
 	};
 	return i.protocol === "rasa" && delete i.channel, i;
 }
-function l(e, t, n) {
+function d(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));
+	for (let [i, a] of Object.entries(n)) a && (r[i] = f(e, t[i], a));
 	return r;
 }
-function u(t, n, r) {
+function f(t, n, r) {
 	let i = {
 		...n ?? {},
 		...r
@@ -77,22 +107,22 @@ function u(t, n, r) {
 		...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);
+	o ? i.priceService = n?.priceService ? l(t, n.priceService, o) : p(t, o) : n?.priceService ? i.priceService = n.priceService : delete i.priceService;
+	let s = r.notifications;
+	if (s) i.notifications = n?.notifications ? u(t, n.notifications, s) : m(t, s);
 	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 = {
+	let c = r.capabilities;
+	return c ? i.capabilities = {
 		...n?.capabilities ?? {},
-		...u
+		...c
 	} : n?.capabilities ? i.capabilities = n.capabilities : delete i.capabilities, i;
 }
-function d(t, n) {
+function p(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) {
+function m(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;

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 { 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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"}
+{"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 GaslessExecutionConfig,\n  type SolverCapabilitiesConfig,\n  type SolverId,\n  type SymmioChainConfig,\n  type SymmioGaslessConfig,\n  type SymmioGaslessStatusStreamConfig,\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`, `gasless`) 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    ...mergeGasless(base.chainId, base.gasless, override.gasless),\n  };\n}\n\n/**\n * Merge a GaslessQ service override onto its base.\n *\n * Returns a partial so the key stays **absent** when neither side configures\n * the service (same invariant as {@link mergeListing}). With a base, fields\n * merge one by one and the nested `execution` and `statusStream` blocks\n * deep-merge. With no base, the override must be a complete block — `url` and\n * `gaslessLayerAddress` are both required, since there is nothing to inherit\n * them from and a half-built block would only fail later, at request time, with\n * a confusing error.\n *\n * @throws {SymmError} `GASLESS_OVERRIDE_INCOMPLETE` when a base-less override\n *   omits `url` or `gaslessLayerAddress`, or when a `statusStream` sets\n *   `origin` with no `enabled` to inherit.\n */\nfunction mergeGasless(\n  chainId: number,\n  base: SymmioGaslessConfig | undefined,\n  override: DeepPartial<SymmioGaslessConfig> | undefined,\n): Pick<SymmioChainConfig, \"gasless\"> | Record<string, never> {\n  if (!base && !override) return {};\n  if (!override) return { gasless: base };\n\n  const url = override.url ?? base?.url;\n  const gaslessLayerAddress = override.gaslessLayerAddress ?? base?.gaslessLayerAddress;\n  if (url === undefined || gaslessLayerAddress === undefined) {\n    throw new SymmError(\n      \"config\",\n      \"GASLESS_OVERRIDE_INCOMPLETE\",\n      `createConfig: the gasless override for chain ${chainId} must declare ${url === undefined ? \"`url`\" : \"`gaslessLayerAddress`\"} — there is no built-in gasless config to inherit it from.`,\n    );\n  }\n\n  const execution =\n    override.execution || base?.execution\n      ? { ...(base?.execution ?? {}), ...((override.execution ?? {}) as GaslessExecutionConfig) }\n      : undefined;\n\n  const protocolInstance = override.protocolInstance ?? base?.protocolInstance;\n  const apiKey = override.apiKey ?? base?.apiKey;\n  const statusStream = mergeGaslessStatusStream(chainId, base?.statusStream, override.statusStream);\n\n  return {\n    gasless: {\n      url,\n      gaslessLayerAddress,\n      ...(protocolInstance !== undefined ? { protocolInstance } : {}),\n      ...(apiKey !== undefined ? { apiKey } : {}),\n      ...(statusStream ? { statusStream } : {}),\n      ...(execution ? { execution } : {}),\n    },\n  };\n}\n\n/**\n * Merge a gasless `statusStream` override onto its base, field by field, so an\n * override that restates only `origin` keeps the base's `enabled` (and an\n * explicit `undefined` never erases a base value).\n *\n * The block stays absent when neither side declares a field. `enabled` has no\n * default: an `origin` with nothing to inherit `enabled` from is a half-built\n * block, and silently reading it as \"disabled\" would hide the mistake.\n *\n * @throws {SymmError} `GASLESS_OVERRIDE_INCOMPLETE` when the merged block has\n *   an `origin` but no `enabled`.\n */\nfunction mergeGaslessStatusStream(\n  chainId: number,\n  base?: SymmioGaslessStatusStreamConfig,\n  override?: DeepPartial<SymmioGaslessStatusStreamConfig>,\n): SymmioGaslessStatusStreamConfig | undefined {\n  const enabled = override?.enabled ?? base?.enabled;\n  const origin = override?.origin ?? base?.origin;\n  if (enabled === undefined) {\n    if (origin === undefined) return undefined;\n    throw new SymmError(\n      \"config\",\n      \"GASLESS_OVERRIDE_INCOMPLETE\",\n      `createConfig: the gasless statusStream override for chain ${chainId} sets \\`origin\\` but not \\`enabled\\` — there is no statusStream block to inherit it from.`,\n    );\n  }\n  return { enabled, ...(origin !== undefined ? { origin } : {}) };\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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"}

package/dist/gasless/abortable-sleep.d.ts

@@ -0,0 +1,17 @@
+import { SymmError } from '../shared/errors/symm-error.js';
+/** The error an aborted gasless wait, poll delay or rate-limit wait rejects with. @internal */
+export declare function gaslessAbortedError(what: string): SymmError;
+/**
+ * Sleep that rejects as soon as `signal` aborts, instead of holding the caller
+ * until the timer it is waiting on happens to fire.
+ *
+ * @param ms - How long to wait.
+ * @param signal - Abort signal; an already-aborted one rejects synchronously.
+ * @param what - What is being waited on, for the error message.
+ * @returns A promise that resolves after `ms`.
+ * @throws {SymmError} `GASLESS_WAIT_ABORTED` when `signal` aborts first.
+ *
+ * @internal
+ */
+export declare function gaslessSleep(ms: number, signal?: AbortSignal, what?: string): Promise<void>;
+//# sourceMappingURL=abortable-sleep.d.ts.map

package/dist/gasless/abortable-sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable-sleep.d.ts","sourceRoot":"","sources":["../../src/gasless/abortable-sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAatG"}

package/dist/gasless/abortable-sleep.js

@@ -0,0 +1,21 @@
+import { SymmError as e } from "../shared/errors/symm-error.js";
+//#region src/gasless/abortable-sleep.ts
+function t(t) {
+	return new e("api", "GASLESS_WAIT_ABORTED", `Gasless: ${t} was aborted.`);
+}
+function n(e, n, r = "the status wait") {
+	return new Promise((i, a) => {
+		let o = setTimeout(() => {
+			n?.removeEventListener("abort", s), i();
+		}, e);
+		function s() {
+			clearTimeout(o), a(t(r));
+		}
+		if (n?.aborted) return s();
+		n?.addEventListener("abort", s, { once: !0 });
+	});
+}
+//#endregion
+export { t as gaslessAbortedError, n as gaslessSleep };
+
+//# sourceMappingURL=abortable-sleep.js.map

package/dist/gasless/abortable-sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable-sleep.js","names":[],"sources":["../../src/gasless/abortable-sleep.ts"],"sourcesContent":["import { SymmError } from \"../shared/errors/symm-error\";\n\n/** The error an aborted gasless wait, poll delay or rate-limit wait rejects with. @internal */\nexport function gaslessAbortedError(what: string): SymmError {\n  return new SymmError(\"api\", \"GASLESS_WAIT_ABORTED\", `Gasless: ${what} was aborted.`);\n}\n\n/**\n * Sleep that rejects as soon as `signal` aborts, instead of holding the caller\n * until the timer it is waiting on happens to fire.\n *\n * @param ms - How long to wait.\n * @param signal - Abort signal; an already-aborted one rejects synchronously.\n * @param what - What is being waited on, for the error message.\n * @returns A promise that resolves after `ms`.\n * @throws {SymmError} `GASLESS_WAIT_ABORTED` when `signal` aborts first.\n *\n * @internal\n */\nexport function gaslessSleep(ms: number, signal?: AbortSignal, what = \"the status wait\"): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    function onAbort() {\n      clearTimeout(timer);\n      reject(gaslessAbortedError(what));\n    }\n    if (signal?.aborted) return onAbort();\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"],"mappings":";;AAGA,SAAgB,EAAoB,GAAyB;CAC3D,OAAO,IAAI,EAAU,OAAO,wBAAwB,YAAY,EAAK,cAAc;AACrF;AAcA,SAAgB,EAAa,GAAY,GAAsB,IAAO,mBAAkC;CACtG,OAAO,IAAI,SAAS,GAAS,MAAW;EACtC,IAAM,IAAQ,iBAAiB;GAE7B,AADA,GAAQ,oBAAoB,SAAS,CAAO,GAC5C,EAAQ;EACV,GAAG,CAAE;EACL,SAAS,IAAU;GAEjB,AADA,aAAa,CAAK,GAClB,EAAO,EAAoB,CAAI,CAAC;EAClC;EACA,IAAI,GAAQ,SAAS,OAAO,EAAQ;EACpC,GAAQ,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC;CAC3D,CAAC;AACH"}