@symmio/trading-core 3.0.0 → 3.1.0

package/dist/shared/types/properties.d.ts

@@ -31,13 +31,21 @@ export interface ConfigKeyParameter {
     configKey?: string;
 }
 /**
- * Optional sender mixin for simulations. `from` is the address a dry-run
- * (`simulateContract`) executes as — it becomes `msg.sender` for the call. When
- * omitted, viem simulates from the zero address. Named `from` (not `account`) so
- * it never collides with an action's own `account` / `user` parameter.
+ * Optional sender mixin. Named `from` (not `account`) so it never collides with
+ * an action's own `account` / `user` parameter. It plays three roles:
+ *
+ * - **Simulations** — the address a dry-run (`simulateContract`) executes as, so
+ *   it becomes `msg.sender`. Omitted, viem simulates from the zero address; the
+ *   React `useSimulate*` hooks default it to the connected address.
+ * - **Writes** — a hint handed to `config.getWalletClient({ chainId, from })`.
+ *   The write hooks forward it but never default it, so a consumer's own
+ *   multi-signer resolver keeps whatever default it chose.
+ * - **Relayed writes** — the wallet that resolver returns signs the InstantLayer
+ *   operation, so `from` selects the EIP-712 `signer`. That is separate from the
+ *   billing sub-account, which comes from the action (or `gasless.account`).
  */
 export interface FromParameter {
-    /** Address the simulation runs as (becomes `msg.sender`). Defaults to the connected wallet in the React layer. */
+    /** Address the call runs as: simulation `msg.sender`, wallet-client hint on a write, EIP-712 signer on a relay. */
     from?: Address;
 }
 /**
@@ -83,6 +91,46 @@ export type ReadSolverParameter = ChainIdParameter & SolverIdParameter;
  * ```
  */
 export type WriteContractParameter = ChainIdParameter & FromParameter & SimulateBeforeWriteParameter;
+/**
+ * Per-call overrides for the transparent gasless execution mode.
+ *
+ * @remarks
+ * There is deliberately no `idempotencyKey`: a relayed write signs a fresh
+ * operation on every call, so one key can only ever describe one signature.
+ * The dispatcher mints it, puts it on the acceptance event and the receipt, and
+ * `resubmitGaslessRequest` is what replays a submit whose response was lost.
+ */
+export interface GaslessWriteOptions {
+    /** Force this call onto (`true`) or off (`false`) the gasless relay, overriding the config default. */
+    enabled?: boolean;
+    /**
+     * Pre-acceptance failure policy for this call: `"error"` throws a typed
+     * error, `"wallet"` falls back to the gas-paid wallet path. After the relay
+     * accepts (HTTP 202) no fallback ever happens.
+     */
+    fallback?: "error" | "wallet";
+    /**
+     * Billing/authority sub-account for the relayed operation, for actions whose
+     * parameters do not carry it (`addMargin` / `removeMargin` receive only the
+     * virtual account — the SDK otherwise resolves the parent on-chain).
+     */
+    account?: Address;
+    /** Max wait for the relayer to broadcast before timing out this call. */
+    broadcastTimeoutMs?: number;
+    /** Abort the relay wait (the accepted request keeps running server-side). */
+    signal?: AbortSignal;
+}
+/**
+ * Opt-in mixin for contract writes the gasless relay can carry. `gasless` is a
+ * boolean for the common case or a {@link GaslessWriteOptions} bag for per-call
+ * overrides; omitted, the chain config's `gasless.execution.mode` decides.
+ * Only relayable writes accept this parameter — its absence from an action's
+ * type means the action always uses the wallet path.
+ */
+export interface GaslessWriteParameter {
+    /** Relay this write through the gasless service instead of the wallet. */
+    gasless?: boolean | GaslessWriteOptions;
+}
 /**
  * Standard mixin set every off-chain solver/hedger write action accepts.
  *

package/dist/shared/types/properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/shared/types/properties.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;CAAE,GAAG,OAAO,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,kHAAkH;IAClH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mJAAmJ;IACnJ,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,aAAa,GAAG,4BAA4B,CAAC;AAErG;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,IAAI;KAC9B,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;CAC5C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI,IAAI,SAAS,SAAS,OAAO,EAAE,GAC3D,IAAI,GACJ,IAAI,SAAS,MAAM,GACjB;KAAG,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CAAE,GAChD,IAAI,CAAC"}
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/shared/types/properties.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;CAAE,GAAG,OAAO,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,mHAAmH;IACnH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mJAAmJ;IACnJ,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,aAAa,GAAG,4BAA4B,CAAC;AAErG;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,uGAAuG;IACvG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,IAAI;KAC9B,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;CAC5C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI,IAAI,SAAS,SAAS,OAAO,EAAE,GAC3D,IAAI,GACJ,IAAI,SAAS,MAAM,GACjB;KAAG,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CAAE,GAChD,IAAI,CAAC"}

package/dist/shared/utils/core-units.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Options for {@link core18ToCollateral}.
+ */
+export interface Core18ToCollateralOptions {
+    /**
+     * Which way to round an amount that does not fit the collateral token's
+     * decimals.
+     *
+     * - `"up"` rounds toward positive infinity. Use it for anything that has to
+     *   be funded — a fee, a shortfall, a required balance — so the token amount
+     *   is never short. It matches the `(fee18 + scale - 1n) / scale` funding rule.
+     * - `"down"` rounds toward negative infinity. Use it for an amount that must
+     *   not be overstated, such as a balance you display or pay out.
+     *
+     * Both agree whenever the amount converts exactly.
+     *
+     * @default "up"
+     */
+    rounding?: "up" | "down";
+}
+/**
+ * Scale a collateral-token amount up to SYMMIO Core's 18-decimal units.
+ *
+ * Two scales meet at every funding boundary. Token transfers, deposit and
+ * withdrawal amounts, and a GaslessLayer's `depositFee`, `minimumDeposit` and
+ * wallet creation fee use the **collateral token's decimals**. Core balances,
+ * operational-fee allowances and every `GaslessFeeQuote` amount use **18
+ * decimals**. Convert before comparing or adding values across the two: mixing
+ * them is off by a factor of `10^(18 − collateralDecimals)`.
+ *
+ * The conversion is exact, because Core only accepts collateral tokens with at
+ * most 18 decimals.
+ *
+ * @param amount - Amount in the collateral token's base units, e.g. `1_000000n`
+ *   for 1 USDC.
+ * @param collateralDecimals - The collateral token's decimals, an integer from 0
+ *   to 18 — `config.getChainConfig(chainId).addresses.collateralDecimals`, or
+ *   `GaslessFeeQuote.collateralDecimals`.
+ * @returns The same amount in 18-decimal Core units.
+ * @throws {SymmError} `COLLATERAL_DECIMALS_UNSUPPORTED` (`kind: "validation"`)
+ *   when `collateralDecimals` is not an integer from 0 to 18.
+ *
+ * @example
+ * ```ts
+ * collateralToCore18(1_000000n, 6); // 1_000000000000000000n — 1 USDC in Core units
+ *
+ * // A relayed withdrawal needs the amount and its fee from the same Core balance.
+ * const required18 = collateralToCore18(amount, collateralDecimals) + fee18;
+ * ```
+ */
+export declare function collateralToCore18(amount: bigint, collateralDecimals: number): bigint;
+/**
+ * Scale an 18-decimal SYMMIO Core amount down to the collateral token's base
+ * units.
+ *
+ * Core balances, operational-fee allowances and `GaslessFeeQuote` amounts are
+ * 18-decimal. A token transfer or a raw token balance is not. When the amount
+ * has more precision than the token can hold, the remainder is rounded **up** by
+ * default, so a fee converted into the tokens that must be sent to cover it is
+ * never short. Pass `rounding: "down"` for an amount that must not be
+ * overstated.
+ *
+ * @param amount18 - Amount in 18-decimal Core units.
+ * @param collateralDecimals - The collateral token's decimals, an integer from 0
+ *   to 18 — `config.getChainConfig(chainId).addresses.collateralDecimals`, or
+ *   `GaslessFeeQuote.collateralDecimals`.
+ * @param options - Rounding direction; see {@link Core18ToCollateralOptions}.
+ * @returns The amount in the collateral token's base units.
+ * @throws {SymmError} `COLLATERAL_DECIMALS_UNSUPPORTED` (`kind: "validation"`)
+ *   when `collateralDecimals` is not an integer from 0 to 18.
+ *
+ * @example
+ * ```ts
+ * core18ToCollateral(50_000_000_000_000_000n, 6); // 50_000n — 0.05 USDC, exact
+ * core18ToCollateral(1_000000000000000001n, 6); // 1_000001n — rounded up
+ * core18ToCollateral(1_000000000000000001n, 6, { rounding: "down" }); // 1_000000n
+ *
+ * const feeInTokenUnits = core18ToCollateral(quote.totalFee18, quote.collateralDecimals);
+ * ```
+ */
+export declare function core18ToCollateral(amount18: bigint, collateralDecimals: number, options?: Core18ToCollateralOptions): bigint;
+//# sourceMappingURL=core-units.d.ts.map

package/dist/shared/utils/core-units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-units.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/core-units.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAErF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,yBAAyB,GAClC,MAAM,CAOR"}

package/dist/shared/utils/core-units.js

@@ -0,0 +1,21 @@
+import { SymmError as e } from "../errors/symm-error.js";
+//#region src/shared/utils/core-units.ts
+var t = 18;
+function n(e, t) {
+	return e * i(t, "collateralToCore18");
+}
+function r(e, t, n) {
+	let r = i(t, "core18ToCollateral"), a = e / r;
+	return a * r === e ? a : n?.rounding === "down" ? e < 0n ? a - 1n : a : e > 0n ? a + 1n : a;
+}
+function i(n, r) {
+	if (!Number.isInteger(n) || n < 0 || n > t) throw new e("validation", "COLLATERAL_DECIMALS_UNSUPPORTED", `${r}: collateralDecimals must be an integer from 0 to ${t}; got ${a(n)}. SYMMIO Core accepts no collateral token with more than 18 decimals.`);
+	return 10n ** BigInt(t - n);
+}
+function a(e) {
+	return typeof e == "string" ? JSON.stringify(e) : typeof e == "bigint" ? `${e}n` : String(e);
+}
+//#endregion
+export { n as collateralToCore18, r as core18ToCollateral };
+
+//# sourceMappingURL=core-units.js.map

package/dist/shared/utils/core-units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-units.js","names":[],"sources":["../../../src/shared/utils/core-units.ts"],"sourcesContent":["import { SymmError } from \"../errors/symm-error\";\n\n/** Decimal places of every SYMMIO Core amount: balances, operational-fee allowances and fee quotes. */\nconst CORE_DECIMALS = 18;\n\n/**\n * Options for {@link core18ToCollateral}.\n */\nexport interface Core18ToCollateralOptions {\n  /**\n   * Which way to round an amount that does not fit the collateral token's\n   * decimals.\n   *\n   * - `\"up\"` rounds toward positive infinity. Use it for anything that has to\n   *   be funded — a fee, a shortfall, a required balance — so the token amount\n   *   is never short. It matches the `(fee18 + scale - 1n) / scale` funding rule.\n   * - `\"down\"` rounds toward negative infinity. Use it for an amount that must\n   *   not be overstated, such as a balance you display or pay out.\n   *\n   * Both agree whenever the amount converts exactly.\n   *\n   * @default \"up\"\n   */\n  rounding?: \"up\" | \"down\";\n}\n\n/**\n * Scale a collateral-token amount up to SYMMIO Core's 18-decimal units.\n *\n * Two scales meet at every funding boundary. Token transfers, deposit and\n * withdrawal amounts, and a GaslessLayer's `depositFee`, `minimumDeposit` and\n * wallet creation fee use the **collateral token's decimals**. Core balances,\n * operational-fee allowances and every `GaslessFeeQuote` amount use **18\n * decimals**. Convert before comparing or adding values across the two: mixing\n * them is off by a factor of `10^(18 − collateralDecimals)`.\n *\n * The conversion is exact, because Core only accepts collateral tokens with at\n * most 18 decimals.\n *\n * @param amount - Amount in the collateral token's base units, e.g. `1_000000n`\n *   for 1 USDC.\n * @param collateralDecimals - The collateral token's decimals, an integer from 0\n *   to 18 — `config.getChainConfig(chainId).addresses.collateralDecimals`, or\n *   `GaslessFeeQuote.collateralDecimals`.\n * @returns The same amount in 18-decimal Core units.\n * @throws {SymmError} `COLLATERAL_DECIMALS_UNSUPPORTED` (`kind: \"validation\"`)\n *   when `collateralDecimals` is not an integer from 0 to 18.\n *\n * @example\n * ```ts\n * collateralToCore18(1_000000n, 6); // 1_000000000000000000n — 1 USDC in Core units\n *\n * // A relayed withdrawal needs the amount and its fee from the same Core balance.\n * const required18 = collateralToCore18(amount, collateralDecimals) + fee18;\n * ```\n */\nexport function collateralToCore18(amount: bigint, collateralDecimals: number): bigint {\n  return amount * coreUnitScale(collateralDecimals, \"collateralToCore18\");\n}\n\n/**\n * Scale an 18-decimal SYMMIO Core amount down to the collateral token's base\n * units.\n *\n * Core balances, operational-fee allowances and `GaslessFeeQuote` amounts are\n * 18-decimal. A token transfer or a raw token balance is not. When the amount\n * has more precision than the token can hold, the remainder is rounded **up** by\n * default, so a fee converted into the tokens that must be sent to cover it is\n * never short. Pass `rounding: \"down\"` for an amount that must not be\n * overstated.\n *\n * @param amount18 - Amount in 18-decimal Core units.\n * @param collateralDecimals - The collateral token's decimals, an integer from 0\n *   to 18 — `config.getChainConfig(chainId).addresses.collateralDecimals`, or\n *   `GaslessFeeQuote.collateralDecimals`.\n * @param options - Rounding direction; see {@link Core18ToCollateralOptions}.\n * @returns The amount in the collateral token's base units.\n * @throws {SymmError} `COLLATERAL_DECIMALS_UNSUPPORTED` (`kind: \"validation\"`)\n *   when `collateralDecimals` is not an integer from 0 to 18.\n *\n * @example\n * ```ts\n * core18ToCollateral(50_000_000_000_000_000n, 6); // 50_000n — 0.05 USDC, exact\n * core18ToCollateral(1_000000000000000001n, 6); // 1_000001n — rounded up\n * core18ToCollateral(1_000000000000000001n, 6, { rounding: \"down\" }); // 1_000000n\n *\n * const feeInTokenUnits = core18ToCollateral(quote.totalFee18, quote.collateralDecimals);\n * ```\n */\nexport function core18ToCollateral(\n  amount18: bigint,\n  collateralDecimals: number,\n  options?: Core18ToCollateralOptions,\n): bigint {\n  const scale = coreUnitScale(collateralDecimals, \"core18ToCollateral\");\n  /** bigint division truncates toward zero: the ceiling of a negative amount, the floor of a positive one. */\n  const truncated = amount18 / scale;\n  if (truncated * scale === amount18) return truncated;\n  if (options?.rounding === \"down\") return amount18 < 0n ? truncated - 1n : truncated;\n  return amount18 > 0n ? truncated + 1n : truncated;\n}\n\n/**\n * The factor between a collateral token's base units and Core's 18-decimal\n * units, `10^(18 − collateralDecimals)`.\n *\n * @param collateralDecimals - The collateral token's decimals.\n * @param caller - The public helper's name, for the error message.\n * @returns The scale factor.\n * @throws {SymmError} `COLLATERAL_DECIMALS_UNSUPPORTED` when the decimals are\n *   not an integer from 0 to 18.\n */\nfunction coreUnitScale(collateralDecimals: number, caller: string): bigint {\n  if (!Number.isInteger(collateralDecimals) || collateralDecimals < 0 || collateralDecimals > CORE_DECIMALS) {\n    throw new SymmError(\n      \"validation\",\n      \"COLLATERAL_DECIMALS_UNSUPPORTED\",\n      `${caller}: collateralDecimals must be an integer from 0 to ${CORE_DECIMALS}; got ${describeDecimals(collateralDecimals)}. SYMMIO Core accepts no collateral token with more than 18 decimals.`,\n    );\n  }\n  return 10n ** BigInt(CORE_DECIMALS - collateralDecimals);\n}\n\n/**\n * Render a rejected `collateralDecimals` so a string or bigint passed from\n * untyped code is distinguishable from the number it resembles.\n *\n * @param value - The rejected value.\n * @returns A short description, e.g. `6.5`, `\"6\"` or `6n`.\n */\nfunction describeDecimals(value: unknown): string {\n  if (typeof value === \"string\") return JSON.stringify(value);\n  if (typeof value === \"bigint\") return `${value}n`;\n  return String(value);\n}\n"],"mappings":";;AAGA,IAAM,IAAgB;AAqDtB,SAAgB,EAAmB,GAAgB,GAAoC;CACrF,OAAO,IAAS,EAAc,GAAoB,oBAAoB;AACxE;AA+BA,SAAgB,EACd,GACA,GACA,GACQ;CACR,IAAM,IAAQ,EAAc,GAAoB,oBAAoB,GAE9D,IAAY,IAAW;CAG7B,OAFI,IAAY,MAAU,IAAiB,IACvC,GAAS,aAAa,SAAe,IAAW,KAAK,IAAY,KAAK,IACnE,IAAW,KAAK,IAAY,KAAK;AAC1C;AAYA,SAAS,EAAc,GAA4B,GAAwB;CACzE,IAAI,CAAC,OAAO,UAAU,CAAkB,KAAK,IAAqB,KAAK,IAAqB,GAC1F,MAAM,IAAI,EACR,cACA,mCACA,GAAG,EAAO,oDAAoD,EAAc,QAAQ,EAAiB,CAAkB,EAAE,sEAC3H;CAEF,OAAO,OAAO,OAAO,IAAgB,CAAkB;AACzD;AASA,SAAS,EAAiB,GAAwB;CAGhD,OAFI,OAAO,KAAU,WAAiB,KAAK,UAAU,CAAK,IACtD,OAAO,KAAU,WAAiB,GAAG,EAAM,KACxC,OAAO,CAAK;AACrB"}

package/dist/shared/utils/http-header.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Read one HTTP header from a response-headers bag, ignoring case.
+ *
+ * Axios hands back an `AxiosHeaders` instance, while adapters and test doubles
+ * may pass a plain object in any casing. Both expose each header as an own
+ * enumerable property, so one scan covers them without importing axios at
+ * runtime. A repeated header yields its first value.
+ *
+ * @param headers - The response headers as the HTTP client exposes them (any shape).
+ * @param name - The header name, in any casing.
+ * @returns The header's value, or `undefined` when it is absent or not a string or finite number.
+ *
+ * @internal
+ */
+export declare function readHttpHeader(headers: unknown, name: string): string | undefined;
+//# sourceMappingURL=http-header.d.ts.map

package/dist/shared/utils/http-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-header.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/http-header.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWjF"}

package/dist/shared/utils/http-header.js

@@ -0,0 +1,14 @@
+//#region src/shared/utils/http-header.ts
+function e(e, t) {
+	if (typeof e != "object" || !e) return;
+	let n = t.toLowerCase();
+	for (let [t, r] of Object.entries(e)) {
+		if (t.toLowerCase() !== n) continue;
+		let e = Array.isArray(r) ? r[0] : r;
+		return typeof e == "string" ? e : typeof e == "number" && Number.isFinite(e) ? String(e) : void 0;
+	}
+}
+//#endregion
+export { e as readHttpHeader };
+
+//# sourceMappingURL=http-header.js.map

package/dist/shared/utils/http-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-header.js","names":[],"sources":["../../../src/shared/utils/http-header.ts"],"sourcesContent":["/**\n * Read one HTTP header from a response-headers bag, ignoring case.\n *\n * Axios hands back an `AxiosHeaders` instance, while adapters and test doubles\n * may pass a plain object in any casing. Both expose each header as an own\n * enumerable property, so one scan covers them without importing axios at\n * runtime. A repeated header yields its first value.\n *\n * @param headers - The response headers as the HTTP client exposes them (any shape).\n * @param name - The header name, in any casing.\n * @returns The header's value, or `undefined` when it is absent or not a string or finite number.\n *\n * @internal\n */\nexport function readHttpHeader(headers: unknown, name: string): string | undefined {\n  if (headers === null || typeof headers !== \"object\") return undefined;\n  const wanted = name.toLowerCase();\n  for (const [key, value] of Object.entries(headers)) {\n    if (key.toLowerCase() !== wanted) continue;\n    const first: unknown = Array.isArray(value) ? value[0] : value;\n    if (typeof first === \"string\") return first;\n    if (typeof first === \"number\" && Number.isFinite(first)) return String(first);\n    return undefined;\n  }\n  return undefined;\n}\n"],"mappings":";AAcA,SAAgB,EAAe,GAAkB,GAAkC;CACjF,IAAwB,OAAO,KAAY,aAAvC,GAAiD;CACrD,IAAM,IAAS,EAAK,YAAY;CAChC,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAO,GAAG;EAClD,IAAI,EAAI,YAAY,MAAM,GAAQ;EAClC,IAAM,IAAiB,MAAM,QAAQ,CAAK,IAAI,EAAM,KAAK;EAGzD,OAFI,OAAO,KAAU,WAAiB,IAClC,OAAO,KAAU,YAAY,OAAO,SAAS,CAAK,IAAU,OAAO,CAAK,IAC5E;CACF;AAEF"}

package/dist/shared/utils/query.js

@@ -3,7 +3,8 @@ var e = new Set([
 	"query",
 	"enabled",
 	"config",
-	"accessToken"
+	"accessToken",
+	"signal"
 ]);
 function t(t) {
 	let r = {};

package/dist/shared/utils/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","names":[],"sources":["../../../src/shared/utils/query.ts"],"sourcesContent":["/**\n * Keys that configure TanStack Query behavior rather than identify the data.\n * They are stripped before an options object is turned into a query key so two\n * calls that differ only in, say, `staleTime` still share a cache entry.\n *\n * `accessToken` is stripped too: a bearer credential is never a cache dimension\n * (two calls that differ only by a refreshed token still hit the same entry) and\n * must never leak into a devtools-visible key.\n */\nconst NON_KEY_FIELDS = new Set([\"query\", \"enabled\", \"config\", \"accessToken\"]);\n\n/**\n * Turn an options object into the plain, hashable payload that trails a query\n * key. Strips TanStack control fields and functions, drops `undefined`, and\n * recursively serializes `bigint` to its decimal string (TanStack's default key\n * hash throws on `bigint`).\n *\n * @param options - The query-options object passed to a factory.\n * @returns A plain object safe to embed in a query key.\n *\n * @example\n * ```ts\n * filterQueryOptions({ chainId: 42161, user: \"0x…\", offset: 0n, query: { staleTime: 1 } });\n * // → { chainId: 42161, user: \"0x…\", offset: \"0\" }\n * ```\n */\nexport function filterQueryOptions<type extends Record<string, unknown>>(options: type): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options)) {\n    if (NON_KEY_FIELDS.has(key)) continue;\n    if (value === undefined) continue;\n    if (typeof value === \"function\") continue;\n    result[key] = serializeBigInts(value);\n  }\n  return result;\n}\n\n/**\n * Recursively replace every `bigint` in a value with its decimal string form so\n * the result survives `JSON.stringify`-based query-key hashing.\n */\nfunction serializeBigInts(value: unknown): unknown {\n  if (typeof value === \"bigint\") return value.toString();\n  if (Array.isArray(value)) return value.map(serializeBigInts);\n  if (value !== null && typeof value === \"object\") {\n    const result: Record<string, unknown> = {};\n    for (const [key, nested] of Object.entries(value)) {\n      result[key] = serializeBigInts(nested);\n    }\n    return result;\n  }\n  return value;\n}\n"],"mappings":";AASA,IAAM,IAAiB,IAAI,IAAI;CAAC;CAAS;CAAW;CAAU;AAAa,CAAC;AAiB5E,SAAgB,EAAyD,GAAwC;CAC/G,IAAM,IAAkC,CAAC;CACzC,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAO,GAC3C,EAAe,IAAI,CAAG,KACtB,MAAU,KAAA,KACV,OAAO,KAAU,eACrB,EAAO,KAAO,EAAiB,CAAK;CAEtC,OAAO;AACT;AAMA,SAAS,EAAiB,GAAyB;CACjD,IAAI,OAAO,KAAU,UAAU,OAAO,EAAM,SAAS;CACrD,IAAI,MAAM,QAAQ,CAAK,GAAG,OAAO,EAAM,IAAI,CAAgB;CAC3D,IAAsB,OAAO,KAAU,YAAnC,GAA6C;EAC/C,IAAM,IAAkC,CAAC;EACzC,KAAK,IAAM,CAAC,GAAK,MAAW,OAAO,QAAQ,CAAK,GAC9C,EAAO,KAAO,EAAiB,CAAM;EAEvC,OAAO;CACT;CACA,OAAO;AACT"}
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/shared/utils/query.ts"],"sourcesContent":["/**\n * Keys that configure TanStack Query behavior rather than identify the data.\n * They are stripped before an options object is turned into a query key so two\n * calls that differ only in, say, `staleTime` still share a cache entry.\n *\n * `accessToken` is stripped too: a bearer credential is never a cache dimension\n * (two calls that differ only by a refreshed token still hit the same entry) and\n * must never leak into a devtools-visible key.\n */\nconst NON_KEY_FIELDS = new Set([\"query\", \"enabled\", \"config\", \"accessToken\", \"signal\"]);\n\n/**\n * Turn an options object into the plain, hashable payload that trails a query\n * key. Strips TanStack control fields and functions, drops `undefined`, and\n * recursively serializes `bigint` to its decimal string (TanStack's default key\n * hash throws on `bigint`).\n *\n * @param options - The query-options object passed to a factory.\n * @returns A plain object safe to embed in a query key.\n *\n * @example\n * ```ts\n * filterQueryOptions({ chainId: 42161, user: \"0x…\", offset: 0n, query: { staleTime: 1 } });\n * // → { chainId: 42161, user: \"0x…\", offset: \"0\" }\n * ```\n */\nexport function filterQueryOptions<type extends Record<string, unknown>>(options: type): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options)) {\n    if (NON_KEY_FIELDS.has(key)) continue;\n    if (value === undefined) continue;\n    if (typeof value === \"function\") continue;\n    result[key] = serializeBigInts(value);\n  }\n  return result;\n}\n\n/**\n * Recursively replace every `bigint` in a value with its decimal string form so\n * the result survives `JSON.stringify`-based query-key hashing.\n */\nfunction serializeBigInts(value: unknown): unknown {\n  if (typeof value === \"bigint\") return value.toString();\n  if (Array.isArray(value)) return value.map(serializeBigInts);\n  if (value !== null && typeof value === \"object\") {\n    const result: Record<string, unknown> = {};\n    for (const [key, nested] of Object.entries(value)) {\n      result[key] = serializeBigInts(nested);\n    }\n    return result;\n  }\n  return value;\n}\n"],"mappings":";AASA,IAAM,IAAiB,IAAI,IAAI;CAAC;CAAS;CAAW;CAAU;CAAe;AAAQ,CAAC;AAiBtF,SAAgB,EAAyD,GAAwC;CAC/G,IAAM,IAAkC,CAAC;CACzC,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAO,GAC3C,EAAe,IAAI,CAAG,KACtB,MAAU,KAAA,KACV,OAAO,KAAU,eACrB,EAAO,KAAO,EAAiB,CAAK;CAEtC,OAAO;AACT;AAMA,SAAS,EAAiB,GAAyB;CACjD,IAAI,OAAO,KAAU,UAAU,OAAO,EAAM,SAAS;CACrD,IAAI,MAAM,QAAQ,CAAK,GAAG,OAAO,EAAM,IAAI,CAAgB;CAC3D,IAAsB,OAAO,KAAU,YAAnC,GAA6C;EAC/C,IAAM,IAAkC,CAAC;EACzC,KAAK,IAAM,CAAC,GAAK,MAAW,OAAO,QAAQ,CAAK,GAC9C,EAAO,KAAO,EAAiB,CAAM;EAEvC,OAAO;CACT;CACA,OAAO;AACT"}

package/dist/solvers/force-close/force-close-auto.d.ts

@@ -1,11 +1,11 @@
 import { Address } from 'viem';
 import { Config } from '../../core/config/index.js';
-import { Compute, WriteContractParameter } from '../../shared/types/properties.js';
+import { Compute, GaslessWriteParameter, WriteContractParameter } from '../../shared/types/properties.js';
 import { ForceClosePositionReturnType } from './force-close-position.js';
 /**
  * Parameters for {@link forceCloseAuto}.
  */
-export type ForceCloseAutoParameters = Compute<WriteContractParameter & {
+export type ForceCloseAutoParameters = Compute<WriteContractParameter & GaslessWriteParameter & {
     /**
      * The subaccount (partyA) that owns the position. Routed through the
      * AccountLayer `_call` proxy; the connected wallet must be its `owner`.
@@ -38,6 +38,10 @@ export type ForceCloseAutoReturnType = ForceClosePositionReturnType;
  * 5. preflight the on-chain gap check against the sig;
  * 6. send `forceClosePosition(quoteId, sig)` through the AccountLayer proxy.
  *
+ * Relayable: pass `gasless` (or run the chain in `gasless.execution.mode`) to
+ * relay that final write instead of sending a transaction. Only step 6 touches
+ * the chain — the reads, the candles and the Muon attestation never cost gas.
+ *
  * @param config - The SDK config (must have a `getWalletClient` resolver).
  * @param parameters - The owning subaccount, the quote id, optional `now` / `from` / pre-flight / chain id.
  * @returns The submitted transaction hash.

package/dist/solvers/force-close/force-close-auto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"force-close-auto.d.ts","sourceRoot":"","sources":["../../../src/solvers/force-close/force-close-auto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAIrF,OAAO,EAAsB,KAAK,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAQ/F;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,sBAAsB,GAAG;IACvB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,4BAA4B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,wBAAwB,GACnC,OAAO,CAAC,wBAAwB,CAAC,CA6GnC"}
+{"version":3,"file":"force-close-auto.d.ts","sourceRoot":"","sources":["../../../src/solvers/force-close/force-close-auto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAI5G,OAAO,EAAsB,KAAK,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAQ/F;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,sBAAsB,GACpB,qBAAqB,GAAG;IACtB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CACJ,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,4BAA4B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,wBAAwB,GACnC,OAAO,CAAC,wBAAwB,CAAC,CA8GnC"}

package/dist/solvers/force-close/force-close-auto.js

@@ -71,7 +71,8 @@ async function h(h, g) {
 		sig: k,
 		chainId: _,
 		from: g.from,
-		simulateBeforeWrite: g.simulateBeforeWrite
+		simulateBeforeWrite: g.simulateBeforeWrite,
+		gasless: g.gasless
 	});
 }
 //#endregion

package/dist/solvers/force-close/force-close-auto.js.map

@@ -1 +1 @@
-{"version":3,"file":"force-close-auto.js","names":[],"sources":["../../../src/solvers/force-close/force-close-auto.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport { BINANCE_MAX_LIMIT, BINANCE_REST_URL } from \"../../candles/sources/binance/constants\";\nimport { fetchBinanceKlines } from \"../../candles/sources/binance/fetch-binance-klines\";\nimport type { Config } from \"../../core/config\";\nimport { getForceClosePriceSig } from \"../../muon/force-close-price-sig/get-force-close-price-sig\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { Compute, WriteContractParameter } from \"../../shared/types/properties\";\nimport { getQuote } from \"../../symmio-contracts/symmio/actions/get-quote\";\nimport { getMarkets } from \"../markets/get-markets\";\nimport { checkForceCloseEligibility, checkForceClosePriceReached, findForceCloseWindow } from \"./force-close-math\";\nimport { forceClosePosition, type ForceClosePositionReturnType } from \"./force-close-position\";\nimport { getForceCloseParams } from \"./get-force-close-params\";\n\n/** Candle interval used to scan for a valid force-close price window. */\nconst KLINE_INTERVAL = \"1m\";\nconst KLINE_INTERVAL_MS = 60_000;\nconst BINANCE_MARKET = \"usd-m-futures\" as const;\n\n/**\n * Parameters for {@link forceCloseAuto}.\n */\nexport type ForceCloseAutoParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount (partyA) that owns the position. Routed through the\n     * AccountLayer `_call` proxy; the connected wallet must be its `owner`.\n     */\n    account: Address;\n    /** The `CLOSE_PENDING` limit quote id to force-close. */\n    quoteId: bigint;\n    /** Override the current unix-second clock (testing). Defaults to `Date.now()`. */\n    now?: bigint;\n    /**\n     * **Debug/temporary**: skip the client-side price checks — build and send the\n     * tx even when the market has not reached the price. When no candle in the\n     * window qualifies, the full valid window is used for the Muon sig instead of\n     * bailing. Pair with `simulateBeforeWrite: false` to actually broadcast a tx\n     * that will revert on-chain (so you can inspect it in an explorer).\n     */\n    skipPriceCheck?: boolean;\n  }\n>;\n\n/** Return type of {@link forceCloseAuto}: the submitted transaction hash. */\nexport type ForceCloseAutoReturnType = ForceClosePositionReturnType;\n\n/**\n * Force-close a stalled `CLOSE_PENDING` **limit** position end-to-end, from just\n * the `quoteId`:\n *\n * 1. read the quote + the protocol force-close params (one multicall);\n * 2. gate on eligibility (status / order type / cooldown / not expired);\n * 3. fetch reference-exchange (Binance) candles over the valid window and find a\n *    bar where the price reached the force-close level → the Muon time window;\n * 4. fetch the Muon `HighLowPriceSig` for that window;\n * 5. preflight the on-chain gap check against the sig;\n * 6. send `forceClosePosition(quoteId, sig)` through the AccountLayer proxy.\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - The owning subaccount, the quote id, optional `now` / `from` / pre-flight / chain id.\n * @returns The submitted transaction hash.\n * @throws {SymmError} `FORCE_CLOSE_NOT_ELIGIBLE` (with the blocking reason),\n *   `FORCE_CLOSE_MARKET_NOT_FOUND`, or `FORCE_CLOSE_PRICE_NOT_REACHED`.\n *\n * @example\n * ```ts\n * const hash = await forceCloseAuto(config, { account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport async function forceCloseAuto(\n  config: Config,\n  parameters: ForceCloseAutoParameters,\n): Promise<ForceCloseAutoReturnType> {\n  const { chainId, account, quoteId } = parameters;\n  const now = parameters.now ?? BigInt(Math.floor(Date.now() / 1000));\n\n  const quote = await getQuote(config, { quoteId, chainId });\n  if (!quote) {\n    throw new SymmError(\"validation\", \"FORCE_CLOSE_QUOTE_NOT_FOUND\", `No quote found for id ${quoteId}.`);\n  }\n  const params = await getForceCloseParams(config, { symbolId: quote.symbolId, chainId });\n\n  const eligibility = checkForceCloseEligibility({\n    quote,\n    firstCooldown: params.firstCooldown,\n    secondCooldown: params.secondCooldown,\n    minSigPeriod: params.minSigPeriod,\n    now,\n  });\n  if (!eligibility.eligible) {\n    throw new SymmError(\n      \"validation\",\n      \"FORCE_CLOSE_NOT_ELIGIBLE\",\n      `Quote ${quoteId} is not force-closeable: ${eligibility.reason}.`,\n    );\n  }\n\n  // Resolve the Binance symbol for this market (reference-exchange klines).\n  const markets = await getMarkets(config, { chainId });\n  const market = markets.find((entry) => BigInt(entry.symbolId) === quote.symbolId);\n  if (!market) {\n    throw new SymmError(\n      \"validation\",\n      \"FORCE_CLOSE_MARKET_NOT_FOUND\",\n      `No market found for symbolId ${quote.symbolId}.`,\n    );\n  }\n\n  const windowStart = quote.statusModifyTimestamp + params.firstCooldown;\n  const windowEnd = now - params.secondCooldown;\n  // Defensive: eligibility already guarantees a non-empty window, but never fetch\n  // klines with `start > end` (Binance rejects it with \"Start time is greater than\n  // end time\"). If we reach here with an empty window, the cooldown has not passed.\n  if (windowEnd <= windowStart) {\n    throw new SymmError(\"validation\", \"FORCE_CLOSE_NOT_ELIGIBLE\", `Quote ${quoteId} is not force-closeable: cooldown.`);\n  }\n  const candles = await fetchBinanceKlines({\n    restUrl: BINANCE_REST_URL[BINANCE_MARKET],\n    market: BINANCE_MARKET,\n    symbol: market.name.toUpperCase(),\n    interval: KLINE_INTERVAL,\n    startTime: Number(windowStart) * 1000,\n    endTime: Number(windowEnd) * 1000,\n    limit: BINANCE_MAX_LIMIT[BINANCE_MARKET],\n  });\n\n  const matchedWindow = findForceCloseWindow({\n    quote,\n    candles,\n    gapRatio: params.gapRatio,\n    firstCooldown: params.firstCooldown,\n    secondCooldown: params.secondCooldown,\n    now,\n    intervalMs: KLINE_INTERVAL_MS,\n  });\n  if (!matchedWindow && !parameters.skipPriceCheck) {\n    throw new SymmError(\n      \"validation\",\n      \"FORCE_CLOSE_PRICE_NOT_REACHED\",\n      `The market has not reached the requested close price for quote ${quoteId}.`,\n    );\n  }\n  // No qualifying candle but `skipPriceCheck` — sign over the full valid window so\n  // the tx can still be built (it will revert on-chain if the price isn't met).\n  const window = matchedWindow ?? { t0: windowStart, t1: windowEnd };\n\n  const sig = await getForceClosePriceSig(config, {\n    t0: window.t0,\n    t1: window.t1,\n    partyA: account,\n    partyB: quote.partyB,\n    symbolId: quote.symbolId,\n    chainId,\n  });\n\n  // Exact on-chain preflight against the fetched sig — avoids a wasted revert\n  // (skipped when `skipPriceCheck`, so the tx is sent regardless).\n  if (!parameters.skipPriceCheck) {\n    const reached = checkForceClosePriceReached({\n      sig,\n      positionType: quote.positionType,\n      requestedClosePrice: quote.requestedClosePrice,\n      gapRatio: params.gapRatio,\n    });\n    if (!reached) {\n      throw new SymmError(\n        \"validation\",\n        \"FORCE_CLOSE_PRICE_NOT_REACHED\",\n        `The attested price range does not clear the gap for quote ${quoteId}.`,\n      );\n    }\n  }\n\n  return forceClosePosition(config, {\n    account,\n    quoteId,\n    sig,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;;;;;;;AAcA,IAAM,IAAiB,MACjB,IAAoB,KACpB,IAAiB;AAqDvB,eAAsB,EACpB,GACA,GACmC;CACnC,IAAM,EAAE,YAAS,YAAS,eAAY,GAChC,IAAM,EAAW,OAAO,OAAO,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,CAAC,GAE5D,IAAQ,MAAM,EAAS,GAAQ;EAAE;EAAS;CAAQ,CAAC;CACzD,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,cAAc,+BAA+B,yBAAyB,EAAQ,EAAE;CAEtG,IAAM,IAAS,MAAM,EAAoB,GAAQ;EAAE,UAAU,EAAM;EAAU;CAAQ,CAAC,GAEhF,IAAc,EAA2B;EAC7C;EACA,eAAe,EAAO;EACtB,gBAAgB,EAAO;EACvB,cAAc,EAAO;EACrB;CACF,CAAC;CACD,IAAI,CAAC,EAAY,UACf,MAAM,IAAI,EACR,cACA,4BACA,SAAS,EAAQ,2BAA2B,EAAY,OAAO,EACjE;CAKF,IAAM,KAAS,MADO,EAAW,GAAQ,EAAE,WAAQ,CAAC,GAC7B,MAAM,MAAU,OAAO,EAAM,QAAQ,MAAM,EAAM,QAAQ;CAChF,IAAI,CAAC,GACH,MAAM,IAAI,EACR,cACA,gCACA,gCAAgC,EAAM,SAAS,EACjD;CAGF,IAAM,IAAc,EAAM,wBAAwB,EAAO,eACnD,IAAY,IAAM,EAAO;CAI/B,IAAI,KAAa,GACf,MAAM,IAAI,EAAU,cAAc,4BAA4B,SAAS,EAAQ,mCAAmC;CAYpH,IAAM,IAAgB,EAAqB;EACzC;EACA,SAAA,MAZoB,EAAmB;GACvC,SAAS,EAAiB;GAC1B,QAAQ;GACR,QAAQ,EAAO,KAAK,YAAY;GAChC,UAAU;GACV,WAAW,OAAO,CAAW,IAAI;GACjC,SAAS,OAAO,CAAS,IAAI;GAC7B,OAAO,EAAkB;EAC3B,CAAC;EAKC,UAAU,EAAO;EACjB,eAAe,EAAO;EACtB,gBAAgB,EAAO;EACvB;EACA,YAAY;CACd,CAAC;CACD,IAAI,CAAC,KAAiB,CAAC,EAAW,gBAChC,MAAM,IAAI,EACR,cACA,iCACA,kEAAkE,EAAQ,EAC5E;CAIF,IAAM,IAAS,KAAiB;EAAE,IAAI;EAAa,IAAI;CAAU,GAE3D,IAAM,MAAM,EAAsB,GAAQ;EAC9C,IAAI,EAAO;EACX,IAAI,EAAO;EACX,QAAQ;EACR,QAAQ,EAAM;EACd,UAAU,EAAM;EAChB;CACF,CAAC;CAID,IAAI,CAAC,EAAW,kBAOV,CANY,EAA4B;EAC1C;EACA,cAAc,EAAM;EACpB,qBAAqB,EAAM;EAC3B,UAAU,EAAO;CACnB,CACK,GACH,MAAM,IAAI,EACR,cACA,iCACA,6DAA6D,EAAQ,EACvE;CAIJ,OAAO,EAAmB,GAAQ;EAChC;EACA;EACA;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;CAClC,CAAC;AACH"}
+{"version":3,"file":"force-close-auto.js","names":[],"sources":["../../../src/solvers/force-close/force-close-auto.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport { BINANCE_MAX_LIMIT, BINANCE_REST_URL } from \"../../candles/sources/binance/constants\";\nimport { fetchBinanceKlines } from \"../../candles/sources/binance/fetch-binance-klines\";\nimport type { Config } from \"../../core/config\";\nimport { getForceClosePriceSig } from \"../../muon/force-close-price-sig/get-force-close-price-sig\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { Compute, GaslessWriteParameter, WriteContractParameter } from \"../../shared/types/properties\";\nimport { getQuote } from \"../../symmio-contracts/symmio/actions/get-quote\";\nimport { getMarkets } from \"../markets/get-markets\";\nimport { checkForceCloseEligibility, checkForceClosePriceReached, findForceCloseWindow } from \"./force-close-math\";\nimport { forceClosePosition, type ForceClosePositionReturnType } from \"./force-close-position\";\nimport { getForceCloseParams } from \"./get-force-close-params\";\n\n/** Candle interval used to scan for a valid force-close price window. */\nconst KLINE_INTERVAL = \"1m\";\nconst KLINE_INTERVAL_MS = 60_000;\nconst BINANCE_MARKET = \"usd-m-futures\" as const;\n\n/**\n * Parameters for {@link forceCloseAuto}.\n */\nexport type ForceCloseAutoParameters = Compute<\n  WriteContractParameter &\n    GaslessWriteParameter & {\n      /**\n       * The subaccount (partyA) that owns the position. Routed through the\n       * AccountLayer `_call` proxy; the connected wallet must be its `owner`.\n       */\n      account: Address;\n      /** The `CLOSE_PENDING` limit quote id to force-close. */\n      quoteId: bigint;\n      /** Override the current unix-second clock (testing). Defaults to `Date.now()`. */\n      now?: bigint;\n      /**\n       * **Debug/temporary**: skip the client-side price checks — build and send the\n       * tx even when the market has not reached the price. When no candle in the\n       * window qualifies, the full valid window is used for the Muon sig instead of\n       * bailing. Pair with `simulateBeforeWrite: false` to actually broadcast a tx\n       * that will revert on-chain (so you can inspect it in an explorer).\n       */\n      skipPriceCheck?: boolean;\n    }\n>;\n\n/** Return type of {@link forceCloseAuto}: the submitted transaction hash. */\nexport type ForceCloseAutoReturnType = ForceClosePositionReturnType;\n\n/**\n * Force-close a stalled `CLOSE_PENDING` **limit** position end-to-end, from just\n * the `quoteId`:\n *\n * 1. read the quote + the protocol force-close params (one multicall);\n * 2. gate on eligibility (status / order type / cooldown / not expired);\n * 3. fetch reference-exchange (Binance) candles over the valid window and find a\n *    bar where the price reached the force-close level → the Muon time window;\n * 4. fetch the Muon `HighLowPriceSig` for that window;\n * 5. preflight the on-chain gap check against the sig;\n * 6. send `forceClosePosition(quoteId, sig)` through the AccountLayer proxy.\n *\n * Relayable: pass `gasless` (or run the chain in `gasless.execution.mode`) to\n * relay that final write instead of sending a transaction. Only step 6 touches\n * the chain — the reads, the candles and the Muon attestation never cost gas.\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - The owning subaccount, the quote id, optional `now` / `from` / pre-flight / chain id.\n * @returns The submitted transaction hash.\n * @throws {SymmError} `FORCE_CLOSE_NOT_ELIGIBLE` (with the blocking reason),\n *   `FORCE_CLOSE_MARKET_NOT_FOUND`, or `FORCE_CLOSE_PRICE_NOT_REACHED`.\n *\n * @example\n * ```ts\n * const hash = await forceCloseAuto(config, { account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport async function forceCloseAuto(\n  config: Config,\n  parameters: ForceCloseAutoParameters,\n): Promise<ForceCloseAutoReturnType> {\n  const { chainId, account, quoteId } = parameters;\n  const now = parameters.now ?? BigInt(Math.floor(Date.now() / 1000));\n\n  const quote = await getQuote(config, { quoteId, chainId });\n  if (!quote) {\n    throw new SymmError(\"validation\", \"FORCE_CLOSE_QUOTE_NOT_FOUND\", `No quote found for id ${quoteId}.`);\n  }\n  const params = await getForceCloseParams(config, { symbolId: quote.symbolId, chainId });\n\n  const eligibility = checkForceCloseEligibility({\n    quote,\n    firstCooldown: params.firstCooldown,\n    secondCooldown: params.secondCooldown,\n    minSigPeriod: params.minSigPeriod,\n    now,\n  });\n  if (!eligibility.eligible) {\n    throw new SymmError(\n      \"validation\",\n      \"FORCE_CLOSE_NOT_ELIGIBLE\",\n      `Quote ${quoteId} is not force-closeable: ${eligibility.reason}.`,\n    );\n  }\n\n  // Resolve the Binance symbol for this market (reference-exchange klines).\n  const markets = await getMarkets(config, { chainId });\n  const market = markets.find((entry) => BigInt(entry.symbolId) === quote.symbolId);\n  if (!market) {\n    throw new SymmError(\n      \"validation\",\n      \"FORCE_CLOSE_MARKET_NOT_FOUND\",\n      `No market found for symbolId ${quote.symbolId}.`,\n    );\n  }\n\n  const windowStart = quote.statusModifyTimestamp + params.firstCooldown;\n  const windowEnd = now - params.secondCooldown;\n  // Defensive: eligibility already guarantees a non-empty window, but never fetch\n  // klines with `start > end` (Binance rejects it with \"Start time is greater than\n  // end time\"). If we reach here with an empty window, the cooldown has not passed.\n  if (windowEnd <= windowStart) {\n    throw new SymmError(\"validation\", \"FORCE_CLOSE_NOT_ELIGIBLE\", `Quote ${quoteId} is not force-closeable: cooldown.`);\n  }\n  const candles = await fetchBinanceKlines({\n    restUrl: BINANCE_REST_URL[BINANCE_MARKET],\n    market: BINANCE_MARKET,\n    symbol: market.name.toUpperCase(),\n    interval: KLINE_INTERVAL,\n    startTime: Number(windowStart) * 1000,\n    endTime: Number(windowEnd) * 1000,\n    limit: BINANCE_MAX_LIMIT[BINANCE_MARKET],\n  });\n\n  const matchedWindow = findForceCloseWindow({\n    quote,\n    candles,\n    gapRatio: params.gapRatio,\n    firstCooldown: params.firstCooldown,\n    secondCooldown: params.secondCooldown,\n    now,\n    intervalMs: KLINE_INTERVAL_MS,\n  });\n  if (!matchedWindow && !parameters.skipPriceCheck) {\n    throw new SymmError(\n      \"validation\",\n      \"FORCE_CLOSE_PRICE_NOT_REACHED\",\n      `The market has not reached the requested close price for quote ${quoteId}.`,\n    );\n  }\n  // No qualifying candle but `skipPriceCheck` — sign over the full valid window so\n  // the tx can still be built (it will revert on-chain if the price isn't met).\n  const window = matchedWindow ?? { t0: windowStart, t1: windowEnd };\n\n  const sig = await getForceClosePriceSig(config, {\n    t0: window.t0,\n    t1: window.t1,\n    partyA: account,\n    partyB: quote.partyB,\n    symbolId: quote.symbolId,\n    chainId,\n  });\n\n  // Exact on-chain preflight against the fetched sig — avoids a wasted revert\n  // (skipped when `skipPriceCheck`, so the tx is sent regardless).\n  if (!parameters.skipPriceCheck) {\n    const reached = checkForceClosePriceReached({\n      sig,\n      positionType: quote.positionType,\n      requestedClosePrice: quote.requestedClosePrice,\n      gapRatio: params.gapRatio,\n    });\n    if (!reached) {\n      throw new SymmError(\n        \"validation\",\n        \"FORCE_CLOSE_PRICE_NOT_REACHED\",\n        `The attested price range does not clear the gap for quote ${quoteId}.`,\n      );\n    }\n  }\n\n  return forceClosePosition(config, {\n    account,\n    quoteId,\n    sig,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n    gasless: parameters.gasless,\n  });\n}\n"],"mappings":";;;;;;;;;;AAcA,IAAM,IAAiB,MACjB,IAAoB,KACpB,IAAiB;AA0DvB,eAAsB,EACpB,GACA,GACmC;CACnC,IAAM,EAAE,YAAS,YAAS,eAAY,GAChC,IAAM,EAAW,OAAO,OAAO,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,CAAC,GAE5D,IAAQ,MAAM,EAAS,GAAQ;EAAE;EAAS;CAAQ,CAAC;CACzD,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,cAAc,+BAA+B,yBAAyB,EAAQ,EAAE;CAEtG,IAAM,IAAS,MAAM,EAAoB,GAAQ;EAAE,UAAU,EAAM;EAAU;CAAQ,CAAC,GAEhF,IAAc,EAA2B;EAC7C;EACA,eAAe,EAAO;EACtB,gBAAgB,EAAO;EACvB,cAAc,EAAO;EACrB;CACF,CAAC;CACD,IAAI,CAAC,EAAY,UACf,MAAM,IAAI,EACR,cACA,4BACA,SAAS,EAAQ,2BAA2B,EAAY,OAAO,EACjE;CAKF,IAAM,KAAS,MADO,EAAW,GAAQ,EAAE,WAAQ,CAAC,GAC7B,MAAM,MAAU,OAAO,EAAM,QAAQ,MAAM,EAAM,QAAQ;CAChF,IAAI,CAAC,GACH,MAAM,IAAI,EACR,cACA,gCACA,gCAAgC,EAAM,SAAS,EACjD;CAGF,IAAM,IAAc,EAAM,wBAAwB,EAAO,eACnD,IAAY,IAAM,EAAO;CAI/B,IAAI,KAAa,GACf,MAAM,IAAI,EAAU,cAAc,4BAA4B,SAAS,EAAQ,mCAAmC;CAYpH,IAAM,IAAgB,EAAqB;EACzC;EACA,SAAA,MAZoB,EAAmB;GACvC,SAAS,EAAiB;GAC1B,QAAQ;GACR,QAAQ,EAAO,KAAK,YAAY;GAChC,UAAU;GACV,WAAW,OAAO,CAAW,IAAI;GACjC,SAAS,OAAO,CAAS,IAAI;GAC7B,OAAO,EAAkB;EAC3B,CAAC;EAKC,UAAU,EAAO;EACjB,eAAe,EAAO;EACtB,gBAAgB,EAAO;EACvB;EACA,YAAY;CACd,CAAC;CACD,IAAI,CAAC,KAAiB,CAAC,EAAW,gBAChC,MAAM,IAAI,EACR,cACA,iCACA,kEAAkE,EAAQ,EAC5E;CAIF,IAAM,IAAS,KAAiB;EAAE,IAAI;EAAa,IAAI;CAAU,GAE3D,IAAM,MAAM,EAAsB,GAAQ;EAC9C,IAAI,EAAO;EACX,IAAI,EAAO;EACX,QAAQ;EACR,QAAQ,EAAM;EACd,UAAU,EAAM;EAChB;CACF,CAAC;CAID,IAAI,CAAC,EAAW,kBAOV,CANY,EAA4B;EAC1C;EACA,cAAc,EAAM;EACpB,qBAAqB,EAAM;EAC3B,UAAU,EAAO;CACnB,CACK,GACH,MAAM,IAAI,EACR,cACA,iCACA,6DAA6D,EAAQ,EACvE;CAIJ,OAAO,EAAmB,GAAQ;EAChC;EACA;EACA;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;EAChC,SAAS,EAAW;CACtB,CAAC;AACH"}

package/dist/solvers/force-close/force-close-position.d.ts

@@ -1,11 +1,11 @@
 import { Address, Hash } from 'viem';
 import { Config } from '../../core/config/index.js';
-import { Compute, WriteContractParameter } from '../../shared/types/properties.js';
+import { Compute, GaslessWriteParameter, WriteContractParameter } from '../../shared/types/properties.js';
 import { HighLowPriceSig } from '../../symmio-contracts/symmio/types.js';
 /**
  * Parameters for {@link forceClosePosition}.
  */
-export type ForceClosePositionParameters = Compute<WriteContractParameter & {
+export type ForceClosePositionParameters = Compute<WriteContractParameter & GaslessWriteParameter & {
     /**
      * The subaccount (partyA) that owns the position. The call is routed through
      * the AccountLayer `_call` proxy so the core sees this subaccount as the
@@ -26,6 +26,12 @@ export type ForceClosePositionReturnType = Hash;
  * `AccountLayer._call(account, …)`, so the connected wallet must be the
  * subaccount's `owner`.
  *
+ * Relayable: pass `gasless` (or run the chain in `gasless.execution.mode`) to
+ * sign the same calldata as an InstantLayer operation instead of sending a
+ * transaction. The operation is signed under `account` — the position's own
+ * subaccount, which is therefore the account charged the operational fee —
+ * unless `gasless.account` names another.
+ *
  * @remarks
  * Reverts `ForceActionsFacet: Cross partyB mode enabled` when the position's
  * partyB runs cross-margin settlement — that solver needs the (not-yet-supported)
@@ -33,7 +39,7 @@ export type ForceClosePositionReturnType = Hash;
  *
  * @param config - The SDK config (must have a `getWalletClient` resolver).
  * @param parameters - The owning subaccount, the quote id, the Muon sig, optional `from` / pre-flight / chain id.
- * @returns The submitted transaction hash.
+ * @returns The submitted transaction hash — the relayer's broadcast hash when relayed.
  * @throws {SymmError} when the chain is unsupported or no wallet client is available.
  *
  * @example

package/dist/solvers/force-close/force-close-position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"force-close-position.d.ts","sourceRoot":"","sources":["../../../src/solvers/force-close/force-close-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,sBAAsB,GAAG;IACvB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,GAAG,EAAE,eAAe,CAAC;CACtB,CACF,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,4BAA4B,GACvC,OAAO,CAAC,4BAA4B,CAAC,CAgBvC"}
+{"version":3,"file":"force-close-position.d.ts","sourceRoot":"","sources":["../../../src/solvers/force-close/force-close-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAG5G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,sBAAsB,GACpB,qBAAqB,GAAG;IACtB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,GAAG,EAAE,eAAe,CAAC;CACtB,CACJ,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,4BAA4B,GACvC,OAAO,CAAC,4BAA4B,CAAC,CAiBvC"}

package/dist/solvers/force-close/force-close-position.js

@@ -13,7 +13,8 @@ async function r(r, i) {
 		}),
 		chainId: a,
 		from: i.from,
-		simulateBeforeWrite: i.simulateBeforeWrite
+		simulateBeforeWrite: i.simulateBeforeWrite,
+		gasless: i.gasless
 	});
 }
 //#endregion

package/dist/solvers/force-close/force-close-position.js.map

@@ -1 +1 @@
-{"version":3,"file":"force-close-position.js","names":[],"sources":["../../../src/solvers/force-close/force-close-position.ts"],"sourcesContent":["import { encodeFunctionData, type Address, type Hash } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { Compute, WriteContractParameter } from \"../../shared/types/properties\";\nimport { symmioAbi } from \"../../symmio-contracts/abi/v0.8.6/symmio\";\nimport { callAsSubAccount } from \"../../symmio-contracts/symmio/internal/call-as-sub-account\";\nimport type { HighLowPriceSig } from \"../../symmio-contracts/symmio/types\";\n\n/**\n * Parameters for {@link forceClosePosition}.\n */\nexport type ForceClosePositionParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount (partyA) that owns the position. The call is routed through\n     * the AccountLayer `_call` proxy so the core sees this subaccount as the\n     * caller; the connected wallet must be its on-chain `owner`.\n     */\n    account: Address;\n    /** The `CLOSE_PENDING` limit quote id to force-close. */\n    quoteId: bigint;\n    /** The Muon `priceRange` attestation — see `getForceClosePriceSig`. */\n    sig: HighLowPriceSig;\n  }\n>;\n\n/** Return type of {@link forceClosePosition}: the submitted transaction hash. */\nexport type ForceClosePositionReturnType = Hash;\n\n/**\n * Send the single-call force close (`forceClosePosition(quoteId, sig)`) — the\n * low-level write. The eligibility gate and Muon signature must already be\n * resolved (use {@link forceCloseAuto} for the end-to-end flow). Routed through\n * `AccountLayer._call(account, …)`, so the connected wallet must be the\n * subaccount's `owner`.\n *\n * @remarks\n * Reverts `ForceActionsFacet: Cross partyB mode enabled` when the position's\n * partyB runs cross-margin settlement — that solver needs the (not-yet-supported)\n * 3-step `initializeForceClose` / `finalizeForceClose` flow.\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - The owning subaccount, the quote id, the Muon sig, optional `from` / pre-flight / chain id.\n * @returns The submitted transaction hash.\n * @throws {SymmError} when the chain is unsupported or no wallet client is available.\n *\n * @example\n * ```ts\n * const hash = await forceClosePosition(config, { account: \"0xsub…\", quoteId: 42n, sig });\n * ```\n */\nexport async function forceClosePosition(\n  config: Config,\n  parameters: ForceClosePositionParameters,\n): Promise<ForceClosePositionReturnType> {\n  const { chainId, account, quoteId, sig } = parameters;\n\n  const data = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"forceClosePosition\",\n    args: [quoteId, sig],\n  });\n\n  return callAsSubAccount(config, {\n    account,\n    data,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;AAkDA,eAAsB,EACpB,GACA,GACuC;CACvC,IAAM,EAAE,YAAS,YAAS,YAAS,WAAQ;CAQ3C,OAAO,EAAiB,GAAQ;EAC9B;EACA,MARW,EAAmB;GAC9B,KAAK;GACL,cAAc;GACd,MAAM,CAAC,GAAS,CAAG;EACrB,CAIE;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;CAClC,CAAC;AACH"}
+{"version":3,"file":"force-close-position.js","names":[],"sources":["../../../src/solvers/force-close/force-close-position.ts"],"sourcesContent":["import { encodeFunctionData, type Address, type Hash } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { Compute, GaslessWriteParameter, WriteContractParameter } from \"../../shared/types/properties\";\nimport { symmioAbi } from \"../../symmio-contracts/abi/v0.8.6/symmio\";\nimport { callAsSubAccount } from \"../../symmio-contracts/symmio/internal/call-as-sub-account\";\nimport type { HighLowPriceSig } from \"../../symmio-contracts/symmio/types\";\n\n/**\n * Parameters for {@link forceClosePosition}.\n */\nexport type ForceClosePositionParameters = Compute<\n  WriteContractParameter &\n    GaslessWriteParameter & {\n      /**\n       * The subaccount (partyA) that owns the position. The call is routed through\n       * the AccountLayer `_call` proxy so the core sees this subaccount as the\n       * caller; the connected wallet must be its on-chain `owner`.\n       */\n      account: Address;\n      /** The `CLOSE_PENDING` limit quote id to force-close. */\n      quoteId: bigint;\n      /** The Muon `priceRange` attestation — see `getForceClosePriceSig`. */\n      sig: HighLowPriceSig;\n    }\n>;\n\n/** Return type of {@link forceClosePosition}: the submitted transaction hash. */\nexport type ForceClosePositionReturnType = Hash;\n\n/**\n * Send the single-call force close (`forceClosePosition(quoteId, sig)`) — the\n * low-level write. The eligibility gate and Muon signature must already be\n * resolved (use {@link forceCloseAuto} for the end-to-end flow). Routed through\n * `AccountLayer._call(account, …)`, so the connected wallet must be the\n * subaccount's `owner`.\n *\n * Relayable: pass `gasless` (or run the chain in `gasless.execution.mode`) to\n * sign the same calldata as an InstantLayer operation instead of sending a\n * transaction. The operation is signed under `account` — the position's own\n * subaccount, which is therefore the account charged the operational fee —\n * unless `gasless.account` names another.\n *\n * @remarks\n * Reverts `ForceActionsFacet: Cross partyB mode enabled` when the position's\n * partyB runs cross-margin settlement — that solver needs the (not-yet-supported)\n * 3-step `initializeForceClose` / `finalizeForceClose` flow.\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - The owning subaccount, the quote id, the Muon sig, optional `from` / pre-flight / chain id.\n * @returns The submitted transaction hash — the relayer's broadcast hash when relayed.\n * @throws {SymmError} when the chain is unsupported or no wallet client is available.\n *\n * @example\n * ```ts\n * const hash = await forceClosePosition(config, { account: \"0xsub…\", quoteId: 42n, sig });\n * ```\n */\nexport async function forceClosePosition(\n  config: Config,\n  parameters: ForceClosePositionParameters,\n): Promise<ForceClosePositionReturnType> {\n  const { chainId, account, quoteId, sig } = parameters;\n\n  const data = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"forceClosePosition\",\n    args: [quoteId, sig],\n  });\n\n  return callAsSubAccount(config, {\n    account,\n    data,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n    gasless: parameters.gasless,\n  });\n}\n"],"mappings":";;;;AAyDA,eAAsB,EACpB,GACA,GACuC;CACvC,IAAM,EAAE,YAAS,YAAS,YAAS,WAAQ;CAQ3C,OAAO,EAAiB,GAAQ;EAC9B;EACA,MARW,EAAmB;GAC9B,KAAK;GACL,cAAc;GACd,MAAM,CAAC,GAAS,CAAG;EACrB,CAIE;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;EAChC,SAAS,EAAW;CACtB,CAAC;AACH"}

package/dist/solvers/instant-open/instant-open/adapters/enigma-instant-open.js

@@ -1,12 +1,12 @@
 import { SymmError as e } from "../../../../shared/errors/symm-error.js";
-import { encodeAddMarginToNextVA as t, encodeSendQuote as n, encodeSendQuoteWithAffiliateAndData as r, getFakeSendQuoteMuonSignature as i, sendQuoteUpnlSigFlexRange as a } from "../../shared/calldata.js";
-import { sendInstantOpen as o } from "../../shared/hedger-api.js";
-import { buildSignedOperation as s, signAndFormatInstantOperation as c } from "../../shared/operations.js";
+import { buildSignedOperation as t, signAndFormatInstantOperation as n } from "../../shared/operations.js";
+import { encodeAddMarginToNextVA as r, encodeSendQuote as i, encodeSendQuoteWithAffiliateAndData as a, getFakeSendQuoteMuonSignature as o, sendQuoteUpnlSigFlexRange as s } from "../../shared/calldata.js";
+import { sendInstantOpen as c } from "../../shared/hedger-api.js";
 import { isolationTypeForSide as l } from "../../shared/types.js";
 //#region src/solvers/instant-open/instant-open/adapters/enigma-instant-open.ts
 async function u(u, d) {
 	if (!d.margin) throw new e("validation", "INSTANT_OPEN_MARGIN_REQUIRED", "instantOpen: the Enigma (lowcap) flow funds a new virtual account, so `margin.amount` is required.");
-	let { config: f, solver: p, chainConfig: m, walletClient: h, signerAddress: g, deadline: _, symbolId: v, metadata: y } = u, { accountLayerAddress: b, symmioAddress: x, affiliatesAddress: S } = m.addresses, C = t({
+	let { config: f, solver: p, chainConfig: m, walletClient: h, signerAddress: g, deadline: _, symbolId: v, metadata: y } = u, { accountLayerAddress: b, symmioAddress: x, affiliatesAddress: S } = m.addresses, C = r({
 		subAccount: d.subAccountAddress,
 		isolationType: l(d.positionType),
 		symbolId: v,
@@ -25,18 +25,18 @@ async function u(u, d) {
 		deadline: _,
 		affiliate: S,
 		data: y,
-		upnlSig: i(d.order.price)
-	}, T = m.contractsVersion === "0.8.5" ? r(w) : n({
+		upnlSig: o(d.order.price)
+	}, T = m.contractsVersion === "0.8.5" ? a(w) : i({
 		...w,
 		solverFeeCaps: d.solverFeeCaps
-	}), E = s({
+	}), E = t({
 		signer: g,
 		target: b,
 		callData: C,
 		signerAccount: d.subAccountAddress,
 		deadline: _,
 		salt: d.addMarginSalt
-	}), D = s({
+	}), D = t({
 		signer: g,
 		target: x,
 		callData: T,
@@ -44,18 +44,18 @@ async function u(u, d) {
 		deadline: _,
 		salt: d.sendQuoteSalt,
 		flexFields: [{
-			...a(T),
+			...s(T),
 			authorizedFlexFiller: p.address
 		}]
-	}), [O, k] = await Promise.all([c(f, {
+	}), [O, k] = await Promise.all([n(f, {
 		operation: E,
 		chainId: u.chainId,
 		walletClient: h
-	}), c(f, {
+	}), n(f, {
 		operation: D,
 		chainId: u.chainId,
 		walletClient: h
-	})]), A = await o(f, {
+	})]), A = await c(f, {
 		chainId: u.chainId,
 		solverId: p.id,
 		request: {

package/dist/solvers/instant-open/instant-open/adapters/rasa-instant-open.js

@@ -1,6 +1,6 @@
-import { encodeSendQuoteWithAffiliateAndData as e } from "../../shared/calldata.js";
-import { sendRasaInstantOpen as t } from "../../shared/hedger-api.js";
-import { buildSignedOperation as n, signAndFormatInstantOperation as r } from "../../shared/operations.js";
+import { buildSignedOperation as e, signAndFormatInstantOperation as t } from "../../shared/operations.js";
+import { encodeSendQuoteWithAffiliateAndData as n } from "../../shared/calldata.js";
+import { sendRasaInstantOpen as r } from "../../shared/hedger-api.js";
 import "../../shared/types.js";
 import { getSendQuoteUpnlSig as i } from "../../../../muon/send-quote-upnl-sig/get-send-quote-upnl-sig.js";
 import { toRasaInstantOpen as a } from "../../get-instant-opens/adapters/rasa-instant-opens.js";
@@ -10,11 +10,11 @@ async function o(o, s) {
 		chainId: o.chainId,
 		partyA: s.subAccountAddress,
 		symbolId: m
-	}), y = await r(c, {
-		operation: n({
+	}), y = await t(c, {
+		operation: e({
 			signer: f,
 			target: g,
-			callData: e({
+			callData: n({
 				partyBsWhiteList: [l.address],
 				symbolId: m,
 				positionType: s.positionType,
@@ -36,7 +36,7 @@ async function o(o, s) {
 		}),
 		chainId: o.chainId,
 		walletClient: d
-	}), b = await t(c, {
+	}), b = await r(c, {
 		chainId: o.chainId,
 		solverId: l.id,
 		sendQuote: y

package/dist/symmio-contracts/abi/index.d.ts

@@ -11,6 +11,8 @@
  * `ARCHITECTURE.md` at the package root.
  */
 export { accountLayerAbi } from './v0.8.6/account-layer.js';
+export { gaslessLayerAbi } from './v0.8.6/gasless-layer.js';
+export { gaslessWalletAbi } from './v0.8.6/gasless-wallet.js';
 export { instantLayerAbi } from './v0.8.6/instant-layer.js';
 export { symmioAbi } from './v0.8.6/symmio.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/symmio-contracts/abi/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/symmio-contracts/abi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/symmio-contracts/abi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}