@symmio/trading-core 0.1.0

package/dist/solvers/instant-close/shared/close-math.d.ts

@@ -0,0 +1,47 @@
+import { PositionType } from './types';
+/**
+ * Parameters for {@link calculateClosePrice}.
+ */
+export interface CalculateClosePriceParameters {
+    /** Current mark price as decimal string. */
+    markPrice: string;
+    /** Slippage percent (e.g. `5` for 5%). */
+    slippage: number;
+    /** Side of the position being closed (LONG = selling, SHORT = buying). */
+    positionType: PositionType;
+    /** Price precision (decimals). */
+    pricePrecision: number;
+}
+/**
+ * Compute the slippage-adjusted close price for a MARKET close.
+ *
+ * - **LONG close** = selling. Worst fill is a *lower* price, so the user
+ *   accepts `markPrice × (1 − s)`.
+ * - **SHORT close** = buying. Worst fill is a *higher* price, so the user
+ *   accepts `markPrice × (1 + s)`.
+ *
+ * Result is rounded *down* to `pricePrecision` (matches the open-side
+ * `calculateTradeParams` rounding so the contract-side encoding never sees a
+ * value with too many fractional digits).
+ *
+ * @returns Close price as a decimal string, or `null` when `markPrice` is
+ *   zero/NaN.
+ */
+export declare function calculateClosePrice(parameters: CalculateClosePriceParameters): string | null;
+/**
+ * Parameters for {@link clampClosePrecision}.
+ */
+export interface ClampClosePrecisionParameters {
+    /** Quantity to close as decimal string. */
+    quantityToClose: string;
+    /** Quantity precision (decimals). */
+    quantityPrecision: number;
+}
+/**
+ * Trim a user-entered close quantity to the market's `quantityPrecision`,
+ * rounded down so the on-chain encoding stays within the allowed digits.
+ *
+ * @returns Quantity as a decimal string, or `null` when the input is invalid.
+ */
+export declare function clampClosePrecision(parameters: ClampClosePrecisionParameters): string | null;
+//# sourceMappingURL=close-math.d.ts.map

package/dist/solvers/instant-close/shared/close-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-math.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-close/shared/close-math.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,YAAY,EAAE,YAAY,CAAC;IAC3B,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,6BAA6B,GAAG,MAAM,GAAG,IAAI,CAQ5F;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,6BAA6B,GAAG,MAAM,GAAG,IAAI,CAI5F"}

package/dist/solvers/instant-close/shared/close-math.js

@@ -0,0 +1,17 @@
+import { PositionType as e } from "../../../symmio-contracts/symmio/types.js";
+import { RoundingMode as t, toDecimal as n } from "@symmio/utils/decimal";
+//#region src/solvers/instant-close/shared/close-math.ts
+function r(r) {
+	let i = n(r.markPrice);
+	if (i.isZero() || i.isNaN()) return null;
+	let a = n(100 + (r.positionType === e.LONG ? -r.slippage : r.slippage)).div(100);
+	return i.times(a).toFixed(r.pricePrecision, t.ROUND_DOWN);
+}
+function i(e) {
+	let r = n(e.quantityToClose);
+	return r.isNaN() || r.lte(0) ? null : r.toFixed(e.quantityPrecision, t.ROUND_DOWN);
+}
+//#endregion
+export { r as calculateClosePrice, i as clampClosePrecision };
+
+//# sourceMappingURL=close-math.js.map

package/dist/solvers/instant-close/shared/close-math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-math.js","names":[],"sources":["../../../../src/solvers/instant-close/shared/close-math.ts"],"sourcesContent":["import { RoundingMode, toDecimal } from \"@symmio/utils/decimal\";\nimport { PositionType } from \"./types\";\n\n/**\n * Parameters for {@link calculateClosePrice}.\n */\nexport interface CalculateClosePriceParameters {\n  /** Current mark price as decimal string. */\n  markPrice: string;\n  /** Slippage percent (e.g. `5` for 5%). */\n  slippage: number;\n  /** Side of the position being closed (LONG = selling, SHORT = buying). */\n  positionType: PositionType;\n  /** Price precision (decimals). */\n  pricePrecision: number;\n}\n\n/**\n * Compute the slippage-adjusted close price for a MARKET close.\n *\n * - **LONG close** = selling. Worst fill is a *lower* price, so the user\n *   accepts `markPrice × (1 − s)`.\n * - **SHORT close** = buying. Worst fill is a *higher* price, so the user\n *   accepts `markPrice × (1 + s)`.\n *\n * Result is rounded *down* to `pricePrecision` (matches the open-side\n * `calculateTradeParams` rounding so the contract-side encoding never sees a\n * value with too many fractional digits).\n *\n * @returns Close price as a decimal string, or `null` when `markPrice` is\n *   zero/NaN.\n */\nexport function calculateClosePrice(parameters: CalculateClosePriceParameters): string | null {\n  const markPriceDec = toDecimal(parameters.markPrice);\n  if (markPriceDec.isZero() || markPriceDec.isNaN()) return null;\n\n  // LONG close → sell at lower; SHORT close → buy at higher.\n  const signedSlippage = parameters.positionType === PositionType.LONG ? -parameters.slippage : parameters.slippage;\n  const slippageFactor = toDecimal(100 + signedSlippage).div(100);\n  return markPriceDec.times(slippageFactor).toFixed(parameters.pricePrecision, RoundingMode.ROUND_DOWN);\n}\n\n/**\n * Parameters for {@link clampClosePrecision}.\n */\nexport interface ClampClosePrecisionParameters {\n  /** Quantity to close as decimal string. */\n  quantityToClose: string;\n  /** Quantity precision (decimals). */\n  quantityPrecision: number;\n}\n\n/**\n * Trim a user-entered close quantity to the market's `quantityPrecision`,\n * rounded down so the on-chain encoding stays within the allowed digits.\n *\n * @returns Quantity as a decimal string, or `null` when the input is invalid.\n */\nexport function clampClosePrecision(parameters: ClampClosePrecisionParameters): string | null {\n  const quantityDec = toDecimal(parameters.quantityToClose);\n  if (quantityDec.isNaN() || quantityDec.lte(0)) return null;\n  return quantityDec.toFixed(parameters.quantityPrecision, RoundingMode.ROUND_DOWN);\n}\n"],"mappings":";;;AAgCA,SAAgB,EAAoB,GAA0D;CAC5F,IAAM,IAAe,EAAU,EAAW,SAAS;CACnD,IAAI,EAAa,OAAO,KAAK,EAAa,MAAM,GAAG,OAAO;CAI1D,IAAM,IAAiB,EAAU,OADV,EAAW,iBAAiB,EAAa,OAAO,CAAC,EAAW,WAAW,EAAW,SACpD,EAAE,IAAI,GAAG;CAC9D,OAAO,EAAa,MAAM,CAAc,EAAE,QAAQ,EAAW,gBAAgB,EAAa,UAAU;AACtG;AAkBA,SAAgB,EAAoB,GAA0D;CAC5F,IAAM,IAAc,EAAU,EAAW,eAAe;CAExD,OADI,EAAY,MAAM,KAAK,EAAY,IAAI,CAAC,IAAU,OAC/C,EAAY,QAAQ,EAAW,mBAAmB,EAAa,UAAU;AAClF"}

package/dist/solvers/instant-close/shared/hedger-api.d.ts

@@ -0,0 +1,35 @@
+import { Config } from '../../../core/config';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+import { ApiV2InstantCloseRequest } from '../../types/generated/enigma-solver';
+/**
+ * Parameters for {@link sendInstantClose}.
+ *
+ * `operations` is the raw `ApiV2InstantCloseRequest.operations` array — one
+ * entry per quote being closed. The endpoint accepts 1–100; this slice's
+ * single-close primitive always sends `[op]` but the shared API stays
+ * array-shaped so a future `bulkInstantClose` plugs in without changing the
+ * hedger layer.
+ */
+export type SendInstantCloseParameters = Compute<ChainIdParameter & {
+    /** Pre-signed `requestToClosePosition` payloads (1–100). */
+    operations: ApiV2InstantCloseRequest["operations"];
+}>;
+/**
+ * Result of {@link sendInstantClose}. The hedger endpoint returns no body
+ * on success, so this is just a success ack.
+ */
+export interface SendInstantCloseReturnType {
+    success: true;
+}
+/**
+ * Submit a v2 instant close request to the chain's hedger.
+ *
+ * Wraps the orval-generated `postInstantTradeInstantClose` with the chain's
+ * solver/hedger base URL and SDK error wrapping. The endpoint returns `void`
+ * on success — we surface `{success: true}` to mirror the open flow's shape.
+ *
+ * @throws {SymmApiError} when the hedger request fails.
+ * @throws {SymmError} when the chain is unsupported.
+ */
+export declare function sendInstantClose(config: Config, parameters: SendInstantCloseParameters): Promise<SendInstantCloseReturnType>;
+//# sourceMappingURL=hedger-api.d.ts.map

package/dist/solvers/instant-close/shared/hedger-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hedger-api.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-close/shared/hedger-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAgC,KAAK,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAElH;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,gBAAgB,GAAG;IACjB,4DAA4D;IAC5D,UAAU,EAAE,wBAAwB,CAAC,YAAY,CAAC,CAAC;CACpD,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,0BAA0B,GACrC,OAAO,CAAC,0BAA0B,CAAC,CAsBrC"}

package/dist/solvers/instant-close/shared/hedger-api.js

@@ -0,0 +1,19 @@
+import { SymmApiError as e, SymmError as t } from "../../../shared/errors/symm-error.js";
+import { postInstantTradeInstantClose as n } from "../../types/generated/enigma-solver.js";
+import { isAxiosError as r } from "axios";
+//#region src/solvers/instant-close/shared/hedger-api.ts
+async function i(i, a) {
+	let { solver: o } = i.getChainConfig(a.chainId);
+	try {
+		return await n({ operations: a.operations }, { baseURL: o.url }), { success: !0 };
+	} catch (n) {
+		throw n instanceof t ? n : r(n) ? e.fromAxios(n, {
+			code: "SEND_INSTANT_CLOSE_FAILED",
+			baseURL: o.url
+		}) : new t("api", "SEND_INSTANT_CLOSE_FAILED", `Failed to send instant close: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { i as sendInstantClose };
+
+//# sourceMappingURL=hedger-api.js.map

package/dist/solvers/instant-close/shared/hedger-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hedger-api.js","names":[],"sources":["../../../../src/solvers/instant-close/shared/hedger-api.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmApiError, SymmError } from \"../../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../../shared/types/properties\";\nimport { postInstantTradeInstantClose, type ApiV2InstantCloseRequest } from \"../../types/generated/enigma-solver\";\n\n/**\n * Parameters for {@link sendInstantClose}.\n *\n * `operations` is the raw `ApiV2InstantCloseRequest.operations` array — one\n * entry per quote being closed. The endpoint accepts 1–100; this slice's\n * single-close primitive always sends `[op]` but the shared API stays\n * array-shaped so a future `bulkInstantClose` plugs in without changing the\n * hedger layer.\n */\nexport type SendInstantCloseParameters = Compute<\n  ChainIdParameter & {\n    /** Pre-signed `requestToClosePosition` payloads (1–100). */\n    operations: ApiV2InstantCloseRequest[\"operations\"];\n  }\n>;\n\n/**\n * Result of {@link sendInstantClose}. The hedger endpoint returns no body\n * on success, so this is just a success ack.\n */\nexport interface SendInstantCloseReturnType {\n  success: true;\n}\n\n/**\n * Submit a v2 instant close request to the chain's hedger.\n *\n * Wraps the orval-generated `postInstantTradeInstantClose` with the chain's\n * solver/hedger base URL and SDK error wrapping. The endpoint returns `void`\n * on success — we surface `{success: true}` to mirror the open flow's shape.\n *\n * @throws {SymmApiError} when the hedger request fails.\n * @throws {SymmError} when the chain is unsupported.\n */\nexport async function sendInstantClose(\n  config: Config,\n  parameters: SendInstantCloseParameters,\n): Promise<SendInstantCloseReturnType> {\n  const { solver } = config.getChainConfig(parameters.chainId);\n  try {\n    await postInstantTradeInstantClose({ operations: parameters.operations }, { baseURL: solver.url });\n    return { success: true };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, {\n        code: \"SEND_INSTANT_CLOSE_FAILED\",\n        baseURL: solver.url,\n      });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"SEND_INSTANT_CLOSE_FAILED\",\n      `Failed to send instant close: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;AAwCA,eAAsB,EACpB,GACA,GACqC;CACrC,IAAM,EAAE,cAAW,EAAO,eAAe,EAAW,OAAO;CAC3D,IAAI;EAEF,OADA,MAAM,EAA6B,EAAE,YAAY,EAAW,WAAW,GAAG,EAAE,SAAS,EAAO,IAAI,CAAC,GAC1F,EAAE,SAAS,GAAK;CACzB,SAAS,GAAK;EAUZ,MATI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAChC,MAAM;GACN,SAAS,EAAO;EAClB,CAAC,IAGG,IAAI,EACR,OACA,6BACA,iCAAiC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAChF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/solvers/instant-close/shared/index.d.ts

@@ -0,0 +1,6 @@
+export * from './calldata';
+export * from './close-math';
+export * from './hedger-api';
+export * from './quote-constraints';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-close/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-close/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/solvers/instant-close/shared/quote-constraints.d.ts

@@ -0,0 +1,82 @@
+import { SymbolContractSymbol } from '../../types/generated/enigma-solver';
+/**
+ * One reason a candidate instant-close quote violates the market's published
+ * quote constraints. Returned in a list by
+ * {@link validateInstantCloseAgainstMarket}.
+ *
+ * All numeric fields are decimal strings so callers can format them however
+ * they like. The `side` discriminator on the quantity / notional checks
+ * tells the UI whether the close leg or the remaining-after-close leg
+ * tripped the constraint.
+ */
+export type CloseQuoteConstraintViolation = {
+    kind: "CLOSE_QUANTITY_BELOW_LOT_SIZE";
+    /** Market's `lot_size`. */
+    lotSize: string;
+    /** Final close quantity. */
+    actualQuantity: string;
+    /** Which leg of the close failed the floor. */
+    side: "close" | "remaining";
+} | {
+    kind: "CLOSE_QUANTITY_NOT_LOT_MULTIPLE";
+    /** Market's `lot_size`. */
+    lotSize: string;
+    /** Final close quantity. */
+    actualQuantity: string;
+    /** Which leg of the close failed the multiple-of check. */
+    side: "close" | "remaining";
+} | {
+    kind: "REMAINING_LOCKED_BELOW_MIN_QUOTE_VALUE";
+    /** Market's `min_acceptable_quote_value`. */
+    minQuoteValue: string;
+    /** Locked-margin sum (`cva + lf + partyAmm`) of the remaining position
+     *  after the close. */
+    remainingLockedSum: string;
+};
+/**
+ * Inputs to {@link validateInstantCloseAgainstMarket}.
+ *
+ * `cva` / `lf` / `partyAmm` are the **original** position's locked-margin
+ * values (from the on-chain `Quote.lockedValues`). The validator scales them
+ * down by `remainingQuantity / originalQuantity` to compute the
+ * remaining-after-close locked sum used for the `min_acceptable_quote_value`
+ * check.
+ */
+export interface ValidateInstantCloseAgainstMarketParameters {
+    /** Market metadata carrying the constraint fields. */
+    market: SymbolContractSymbol;
+    /** Original (un-closed) position quantity (decimal string). */
+    originalQuantity: string;
+    /** Quantity being closed in this request (decimal string). */
+    closeQuantity: string;
+    /** Original CVA locked margin from the position's `lockedValues` (decimal string). */
+    cva: string;
+    /** Original LF locked margin (decimal string). */
+    lf: string;
+    /** Original PartyA maintenance margin (decimal string). */
+    partyAmm: string;
+}
+/** Result of {@link validateInstantCloseAgainstMarket}. */
+export interface ValidateInstantCloseAgainstMarketReturnType {
+    /** `true` when no violations fired. */
+    ok: boolean;
+    /** Every violation the candidate close hit; empty when `ok` is `true`. */
+    violations: CloseQuoteConstraintViolation[];
+}
+/**
+ * Check a candidate instant-close quote against the market's published quote
+ * constraints. Each constraint is independent and skipped when the market
+ * doesn't publish that field, so a partial constraint set still validates
+ * the rest.
+ *
+ * Constraints checked:
+ * - **`lot_size`** — `closeQuantity` must be `≥ lot_size` and an exact
+ *   integer multiple. When the close is partial, `remainingQuantity` must
+ *   satisfy the same two rules so the leftover stays tradable.
+ * - **`min_acceptable_quote_value`** — after the close, the remaining
+ *   position's locked-margin sum (`cva + lf + partyAmm` scaled by
+ *   `remainingQuantity / originalQuantity`) must clear the floor. Skipped
+ *   on a full close (remaining = 0).
+ */
+export declare function validateInstantCloseAgainstMarket(parameters: ValidateInstantCloseAgainstMarketParameters): ValidateInstantCloseAgainstMarketReturnType;
+//# sourceMappingURL=quote-constraints.d.ts.map

package/dist/solvers/instant-close/shared/quote-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-constraints.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-close/shared/quote-constraints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF;;;;;;;;;GASG;AACH,MAAM,MAAM,6BAA6B,GACrC;IACE,IAAI,EAAE,+BAA+B,CAAC;IACtC,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,iCAAiC,CAAC;IACxC,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,wCAAwC,CAAC;IAC/C,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB;2BACuB;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEN;;;;;;;;GAQG;AACH,MAAM,WAAW,2CAA2C;IAC1D,sDAAsD;IACtD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,2CAA2C;IAC1D,uCAAuC;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,0EAA0E;IAC1E,UAAU,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,2CAA2C,GACtD,2CAA2C,CAiE7C"}

package/dist/solvers/instant-close/shared/quote-constraints.js

@@ -0,0 +1,45 @@
+import { toDecimal as e } from "@symmio/utils/decimal";
+//#region src/solvers/instant-close/shared/quote-constraints.ts
+function t(t) {
+	let { market: n, originalQuantity: r, closeQuantity: i, cva: a, lf: o, partyAmm: s } = t, c = [], l = e(r), u = e(i), d = l.minus(u), f = d.gt(0);
+	if (n.lot_size) {
+		let t = e(n.lot_size);
+		t.gt(0) && !t.isNaN() && (u.lt(t) ? c.push({
+			kind: "CLOSE_QUANTITY_BELOW_LOT_SIZE",
+			lotSize: t.toString(),
+			actualQuantity: u.toString(),
+			side: "close"
+		}) : u.mod(t).isZero() || c.push({
+			kind: "CLOSE_QUANTITY_NOT_LOT_MULTIPLE",
+			lotSize: t.toString(),
+			actualQuantity: u.toString(),
+			side: "close"
+		}), f && (d.lt(t) ? c.push({
+			kind: "CLOSE_QUANTITY_BELOW_LOT_SIZE",
+			lotSize: t.toString(),
+			actualQuantity: d.toString(),
+			side: "remaining"
+		}) : d.mod(t).isZero() || c.push({
+			kind: "CLOSE_QUANTITY_NOT_LOT_MULTIPLE",
+			lotSize: t.toString(),
+			actualQuantity: d.toString(),
+			side: "remaining"
+		})));
+	}
+	if (f && n.min_acceptable_quote_value && !l.isZero()) {
+		let t = e(n.min_acceptable_quote_value), r = e(a).plus(o).plus(s).times(d).div(l);
+		r.lt(t) && c.push({
+			kind: "REMAINING_LOCKED_BELOW_MIN_QUOTE_VALUE",
+			minQuoteValue: t.toString(),
+			remainingLockedSum: r.toString()
+		});
+	}
+	return {
+		ok: c.length === 0,
+		violations: c
+	};
+}
+//#endregion
+export { t as validateInstantCloseAgainstMarket };
+
+//# sourceMappingURL=quote-constraints.js.map

package/dist/solvers/instant-close/shared/quote-constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-constraints.js","names":[],"sources":["../../../../src/solvers/instant-close/shared/quote-constraints.ts"],"sourcesContent":["import { toDecimal } from \"@symmio/utils/decimal\";\nimport type { SymbolContractSymbol } from \"../../types/generated/enigma-solver\";\n\n/**\n * One reason a candidate instant-close quote violates the market's published\n * quote constraints. Returned in a list by\n * {@link validateInstantCloseAgainstMarket}.\n *\n * All numeric fields are decimal strings so callers can format them however\n * they like. The `side` discriminator on the quantity / notional checks\n * tells the UI whether the close leg or the remaining-after-close leg\n * tripped the constraint.\n */\nexport type CloseQuoteConstraintViolation =\n  | {\n      kind: \"CLOSE_QUANTITY_BELOW_LOT_SIZE\";\n      /** Market's `lot_size`. */\n      lotSize: string;\n      /** Final close quantity. */\n      actualQuantity: string;\n      /** Which leg of the close failed the floor. */\n      side: \"close\" | \"remaining\";\n    }\n  | {\n      kind: \"CLOSE_QUANTITY_NOT_LOT_MULTIPLE\";\n      /** Market's `lot_size`. */\n      lotSize: string;\n      /** Final close quantity. */\n      actualQuantity: string;\n      /** Which leg of the close failed the multiple-of check. */\n      side: \"close\" | \"remaining\";\n    }\n  | {\n      kind: \"REMAINING_LOCKED_BELOW_MIN_QUOTE_VALUE\";\n      /** Market's `min_acceptable_quote_value`. */\n      minQuoteValue: string;\n      /** Locked-margin sum (`cva + lf + partyAmm`) of the remaining position\n       *  after the close. */\n      remainingLockedSum: string;\n    };\n\n/**\n * Inputs to {@link validateInstantCloseAgainstMarket}.\n *\n * `cva` / `lf` / `partyAmm` are the **original** position's locked-margin\n * values (from the on-chain `Quote.lockedValues`). The validator scales them\n * down by `remainingQuantity / originalQuantity` to compute the\n * remaining-after-close locked sum used for the `min_acceptable_quote_value`\n * check.\n */\nexport interface ValidateInstantCloseAgainstMarketParameters {\n  /** Market metadata carrying the constraint fields. */\n  market: SymbolContractSymbol;\n  /** Original (un-closed) position quantity (decimal string). */\n  originalQuantity: string;\n  /** Quantity being closed in this request (decimal string). */\n  closeQuantity: string;\n  /** Original CVA locked margin from the position's `lockedValues` (decimal string). */\n  cva: string;\n  /** Original LF locked margin (decimal string). */\n  lf: string;\n  /** Original PartyA maintenance margin (decimal string). */\n  partyAmm: string;\n}\n\n/** Result of {@link validateInstantCloseAgainstMarket}. */\nexport interface ValidateInstantCloseAgainstMarketReturnType {\n  /** `true` when no violations fired. */\n  ok: boolean;\n  /** Every violation the candidate close hit; empty when `ok` is `true`. */\n  violations: CloseQuoteConstraintViolation[];\n}\n\n/**\n * Check a candidate instant-close quote against the market's published quote\n * constraints. Each constraint is independent and skipped when the market\n * doesn't publish that field, so a partial constraint set still validates\n * the rest.\n *\n * Constraints checked:\n * - **`lot_size`** — `closeQuantity` must be `≥ lot_size` and an exact\n *   integer multiple. When the close is partial, `remainingQuantity` must\n *   satisfy the same two rules so the leftover stays tradable.\n * - **`min_acceptable_quote_value`** — after the close, the remaining\n *   position's locked-margin sum (`cva + lf + partyAmm` scaled by\n *   `remainingQuantity / originalQuantity`) must clear the floor. Skipped\n *   on a full close (remaining = 0).\n */\nexport function validateInstantCloseAgainstMarket(\n  parameters: ValidateInstantCloseAgainstMarketParameters,\n): ValidateInstantCloseAgainstMarketReturnType {\n  const { market, originalQuantity, closeQuantity, cva, lf, partyAmm } = parameters;\n  const violations: CloseQuoteConstraintViolation[] = [];\n\n  const originalQty = toDecimal(originalQuantity);\n  const closeQty = toDecimal(closeQuantity);\n  const remainingQty = originalQty.minus(closeQty);\n  const isPartialClose = remainingQty.gt(0);\n\n  // 1. lot_size — close + (when partial) remaining.\n  if (market.lot_size) {\n    const lotSize = toDecimal(market.lot_size);\n    if (lotSize.gt(0) && !lotSize.isNaN()) {\n      if (closeQty.lt(lotSize)) {\n        violations.push({\n          kind: \"CLOSE_QUANTITY_BELOW_LOT_SIZE\",\n          lotSize: lotSize.toString(),\n          actualQuantity: closeQty.toString(),\n          side: \"close\",\n        });\n      } else if (!closeQty.mod(lotSize).isZero()) {\n        violations.push({\n          kind: \"CLOSE_QUANTITY_NOT_LOT_MULTIPLE\",\n          lotSize: lotSize.toString(),\n          actualQuantity: closeQty.toString(),\n          side: \"close\",\n        });\n      }\n\n      if (isPartialClose) {\n        if (remainingQty.lt(lotSize)) {\n          violations.push({\n            kind: \"CLOSE_QUANTITY_BELOW_LOT_SIZE\",\n            lotSize: lotSize.toString(),\n            actualQuantity: remainingQty.toString(),\n            side: \"remaining\",\n          });\n        } else if (!remainingQty.mod(lotSize).isZero()) {\n          violations.push({\n            kind: \"CLOSE_QUANTITY_NOT_LOT_MULTIPLE\",\n            lotSize: lotSize.toString(),\n            actualQuantity: remainingQty.toString(),\n            side: \"remaining\",\n          });\n        }\n      }\n    }\n  }\n\n  // 2. min_acceptable_quote_value — only on partial close (full close zeroes\n  // the locked sum, which is fine).\n  if (isPartialClose && market.min_acceptable_quote_value && !originalQty.isZero()) {\n    const minQuoteValue = toDecimal(market.min_acceptable_quote_value);\n    const originalLocked = toDecimal(cva).plus(lf).plus(partyAmm);\n    const remainingLocked = originalLocked.times(remainingQty).div(originalQty);\n    if (remainingLocked.lt(minQuoteValue)) {\n      violations.push({\n        kind: \"REMAINING_LOCKED_BELOW_MIN_QUOTE_VALUE\",\n        minQuoteValue: minQuoteValue.toString(),\n        remainingLockedSum: remainingLocked.toString(),\n      });\n    }\n  }\n\n  return { ok: violations.length === 0, violations };\n}\n"],"mappings":";;AAwFA,SAAgB,EACd,GAC6C;CAC7C,IAAM,EAAE,WAAQ,qBAAkB,kBAAe,QAAK,OAAI,gBAAa,GACjE,IAA8C,CAAC,GAE/C,IAAc,EAAU,CAAgB,GACxC,IAAW,EAAU,CAAa,GAClC,IAAe,EAAY,MAAM,CAAQ,GACzC,IAAiB,EAAa,GAAG,CAAC;CAGxC,IAAI,EAAO,UAAU;EACnB,IAAM,IAAU,EAAU,EAAO,QAAQ;EACzC,AAAI,EAAQ,GAAG,CAAC,KAAK,CAAC,EAAQ,MAAM,MAC9B,EAAS,GAAG,CAAO,IACrB,EAAW,KAAK;GACd,MAAM;GACN,SAAS,EAAQ,SAAS;GAC1B,gBAAgB,EAAS,SAAS;GAClC,MAAM;EACR,CAAC,IACS,EAAS,IAAI,CAAO,EAAE,OAAO,KACvC,EAAW,KAAK;GACd,MAAM;GACN,SAAS,EAAQ,SAAS;GAC1B,gBAAgB,EAAS,SAAS;GAClC,MAAM;EACR,CAAC,GAGC,MACE,EAAa,GAAG,CAAO,IACzB,EAAW,KAAK;GACd,MAAM;GACN,SAAS,EAAQ,SAAS;GAC1B,gBAAgB,EAAa,SAAS;GACtC,MAAM;EACR,CAAC,IACS,EAAa,IAAI,CAAO,EAAE,OAAO,KAC3C,EAAW,KAAK;GACd,MAAM;GACN,SAAS,EAAQ,SAAS;GAC1B,gBAAgB,EAAa,SAAS;GACtC,MAAM;EACR,CAAC;CAIT;CAIA,IAAI,KAAkB,EAAO,8BAA8B,CAAC,EAAY,OAAO,GAAG;EAChF,IAAM,IAAgB,EAAU,EAAO,0BAA0B,GAE3D,IADiB,EAAU,CAAG,EAAE,KAAK,CAAE,EAAE,KAAK,CAC5B,EAAe,MAAM,CAAY,EAAE,IAAI,CAAW;EAC1E,AAAI,EAAgB,GAAG,CAAa,KAClC,EAAW,KAAK;GACd,MAAM;GACN,eAAe,EAAc,SAAS;GACtC,oBAAoB,EAAgB,SAAS;EAC/C,CAAC;CAEL;CAEA,OAAO;EAAE,IAAI,EAAW,WAAW;EAAG;CAAW;AACnD"}

package/dist/solvers/instant-close/shared/types.d.ts

@@ -0,0 +1,59 @@
+import { Hex } from 'viem';
+/**
+ * Re-export the canonical trade-side enum so the instant-close slice has one
+ * place to import it from. Numeric values match the on-chain enum:
+ * `LONG = 0`, `SHORT = 1`.
+ */
+export { PositionType } from '../../../symmio-contracts/symmio/types';
+/**
+ * Re-export the canonical MARKET order-type constant from the open slice.
+ * Single source of truth — both instant-open and instant-close encode the
+ * same on-chain enum value.
+ */
+export { ORDER_TYPE_MARKET } from '../../instant-open/shared/types';
+/**
+ * Order-side trade values passed to `InstantCloseParameters`.
+ *
+ * All wei `bigint`s, final values. Caller (or the wizard) computes
+ * `closePrice` from the mark price and slippage.
+ */
+export interface InstantCloseOrder {
+    /** Quote id of the position being closed. */
+    quoteId: bigint;
+    /** Slippage-adjusted requested close price (wei, 1e18 fixed-point). */
+    closePrice: bigint;
+    /** Quantity to close (wei, 1e18 fixed-point). */
+    quantityToClose: bigint;
+}
+/**
+ * Market identification + precision metadata used by the close wizard.
+ *
+ * Only `id` is required. `name`, `pricePrecision`, and `quantityPrecision`
+ * are pre-fetched overrides; when omitted, the wizard resolves them from the
+ * solver `/contract-symbols` endpoint via `id`.
+ */
+export interface InstantCloseMarketData {
+    /** Market `symbol_id` from solver markets. */
+    id: number;
+    /** Pre-fetched market name. */
+    name?: string;
+    /** Pre-fetched price precision. */
+    pricePrecision?: number;
+    /** Pre-fetched quantity precision. */
+    quantityPrecision?: number;
+}
+/**
+ * Wire-format response from the hedger's `/instant_trade/instant_close`
+ * endpoint. The endpoint returns `void` on success (HTTP 2xx body is empty);
+ * we surface a simple ack here.
+ */
+export interface InstantCloseReturnType {
+    /** `true` when the hedger accepted the request. */
+    success: boolean;
+}
+/**
+ * Re-export the `Hex` type so callers don't need to import it from `viem` just
+ * to construct a salt override.
+ */
+export type { Hex };
+//# sourceMappingURL=types.d.ts.map

package/dist/solvers/instant-close/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-close/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtE;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,YAAY,EAAE,GAAG,EAAE,CAAC"}

package/dist/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.d.ts

@@ -0,0 +1,40 @@
+import { Config } from '../../../core/config';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+/**
+ * Parameters for {@link getInstantOpenQuoteId}.
+ */
+export type GetInstantOpenQuoteIdParameters = Compute<ChainIdParameter & {
+    /** Hedger-local temp id (from a {@link GetInstantOpensReturnType} record). */
+    tempQuoteId: number;
+    /**
+     * Hedger base URL to query. Defaults to the chain config's `solver.url`.
+     */
+    baseUrl?: string;
+}>;
+/** Return type of {@link getInstantOpenQuoteId}: the on-chain quote id, or `null`. */
+export type GetInstantOpenQuoteIdReturnType = number | null;
+/**
+ * Resolve the on-chain quote id for a hedger temp id via the hedger's
+ * `/instant_quote_id/{tempQuoteId}` endpoint.
+ *
+ * This is the reconciliation handoff: a pending instant-open carries a
+ * hedger-local `tempQuoteId`; once the trade is anchored on-chain the hedger can
+ * map it to the real quote id. Returns `null` while the mapping does not exist
+ * yet (the trade is still off-chain only).
+ *
+ * @param config - The SDK config.
+ * @param parameters - `tempQuoteId`, optional `chainId`, optional hedger `baseUrl`.
+ * @returns The on-chain quote id, or `null` when not yet anchored.
+ * @throws {SymmApiError} when the hedger request fails.
+ * @throws {SymmError} when the chain is unsupported.
+ *
+ * @example
+ * ```ts
+ * const quoteId = await getInstantOpenQuoteId(config, { tempQuoteId: -1001 });
+ * if (quoteId !== null) {
+ *   // reconcile the optimistic record against on-chain quote `quoteId`
+ * }
+ * ```
+ */
+export declare function getInstantOpenQuoteId(config: Config, parameters: GetInstantOpenQuoteIdParameters): Promise<GetInstantOpenQuoteIdReturnType>;
+//# sourceMappingURL=get-instant-open-quote-id.d.ts.map

package/dist/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-instant-open-quote-id.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAGlF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,OAAO,CACnD,gBAAgB,GAAG;IACjB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,+BAA+B,GAAG,MAAM,GAAG,IAAI,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,+BAA+B,GAC1C,OAAO,CAAC,+BAA+B,CAAC,CAoB1C"}

package/dist/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.js

@@ -0,0 +1,19 @@
+import { SymmApiError as e, SymmError as t } from "../../../shared/errors/symm-error.js";
+import { getInstantQuoteIdTempQuoteId as n } from "../../types/generated/enigma-solver.js";
+import { isAxiosError as r } from "axios";
+//#region src/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.ts
+async function i(i, a) {
+	let { solver: o } = i.getChainConfig(a.chainId), s = a.baseUrl ?? o.url;
+	try {
+		return (await n(a.tempQuoteId, { baseURL: s })).data?.quote_id ?? null;
+	} catch (n) {
+		throw n instanceof t ? n : r(n) ? e.fromAxios(n, {
+			code: "GET_INSTANT_OPEN_QUOTE_ID_FAILED",
+			baseURL: s
+		}) : new t("api", "GET_INSTANT_OPEN_QUOTE_ID_FAILED", `Failed to fetch instant-open quote id: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { i as getInstantOpenQuoteId };
+
+//# sourceMappingURL=get-instant-open-quote-id.js.map

package/dist/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-instant-open-quote-id.js","names":[],"sources":["../../../../src/solvers/instant-open/get-instant-open-quote-id/get-instant-open-quote-id.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmApiError, SymmError } from \"../../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../../shared/types/properties\";\nimport { getInstantQuoteIdTempQuoteId } from \"../../types/generated/enigma-solver\";\n\n/**\n * Parameters for {@link getInstantOpenQuoteId}.\n */\nexport type GetInstantOpenQuoteIdParameters = Compute<\n  ChainIdParameter & {\n    /** Hedger-local temp id (from a {@link GetInstantOpensReturnType} record). */\n    tempQuoteId: number;\n    /**\n     * Hedger base URL to query. Defaults to the chain config's `solver.url`.\n     */\n    baseUrl?: string;\n  }\n>;\n\n/** Return type of {@link getInstantOpenQuoteId}: the on-chain quote id, or `null`. */\nexport type GetInstantOpenQuoteIdReturnType = number | null;\n\n/**\n * Resolve the on-chain quote id for a hedger temp id via the hedger's\n * `/instant_quote_id/{tempQuoteId}` endpoint.\n *\n * This is the reconciliation handoff: a pending instant-open carries a\n * hedger-local `tempQuoteId`; once the trade is anchored on-chain the hedger can\n * map it to the real quote id. Returns `null` while the mapping does not exist\n * yet (the trade is still off-chain only).\n *\n * @param config - The SDK config.\n * @param parameters - `tempQuoteId`, optional `chainId`, optional hedger `baseUrl`.\n * @returns The on-chain quote id, or `null` when not yet anchored.\n * @throws {SymmApiError} when the hedger request fails.\n * @throws {SymmError} when the chain is unsupported.\n *\n * @example\n * ```ts\n * const quoteId = await getInstantOpenQuoteId(config, { tempQuoteId: -1001 });\n * if (quoteId !== null) {\n *   // reconcile the optimistic record against on-chain quote `quoteId`\n * }\n * ```\n */\nexport async function getInstantOpenQuoteId(\n  config: Config,\n  parameters: GetInstantOpenQuoteIdParameters,\n): Promise<GetInstantOpenQuoteIdReturnType> {\n  const { solver } = config.getChainConfig(parameters.chainId);\n  const baseURL = parameters.baseUrl ?? solver.url;\n  try {\n    const response = await getInstantQuoteIdTempQuoteId(parameters.tempQuoteId, { baseURL });\n    return response.data?.quote_id ?? null;\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"GET_INSTANT_OPEN_QUOTE_ID_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"GET_INSTANT_OPEN_QUOTE_ID_FAILED\",\n      `Failed to fetch instant-open quote id: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;AA8CA,eAAsB,EACpB,GACA,GAC0C;CAC1C,IAAM,EAAE,cAAW,EAAO,eAAe,EAAW,OAAO,GACrD,IAAU,EAAW,WAAW,EAAO;CAC7C,IAAI;EAEF,QAAO,MADgB,EAA6B,EAAW,aAAa,EAAE,WAAQ,CAAC,GACvE,MAAM,YAAY;CACpC,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAAoC;EAAQ,CAAC,IAGnF,IAAI,EACR,OACA,oCACA,0CAA0C,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KACzF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/solvers/instant-open/get-instant-open-quote-id/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-instant-open-quote-id';
+export * from './query';
+//# sourceMappingURL=index.d.ts.map

package/dist/solvers/instant-open/get-instant-open-quote-id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/get-instant-open-quote-id/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,SAAS,CAAC"}

package/dist/solvers/instant-open/get-instant-open-quote-id/query.d.ts

@@ -0,0 +1,42 @@
+import { Config } from '../../../core/config';
+import { Compute, ConfigKeyParameter } from '../../../shared/types/properties';
+import { QueryParameter, SymmioQueryOptions } from '../../../shared/types/query';
+import { GetInstantOpenQuoteIdParameters, GetInstantOpenQuoteIdReturnType } from './get-instant-open-quote-id';
+/** Data resolved by the {@link getInstantOpenQuoteIdQueryOptions} query. */
+export type GetInstantOpenQuoteIdData = GetInstantOpenQuoteIdReturnType;
+/**
+ * Build the TanStack Query key for {@link getInstantOpenQuoteIdQueryOptions}.
+ *
+ * @param options - Query parameters (chain id, temp quote id, base url, config key).
+ * @returns A stable, hashable query key.
+ */
+export declare function getInstantOpenQuoteIdQueryKey(options: Compute<GetInstantOpenQuoteIdParameters & ConfigKeyParameter>): readonly ["getInstantOpenQuoteId", Record<string, unknown>];
+/** Query-key type produced by {@link getInstantOpenQuoteIdQueryKey}. */
+export type GetInstantOpenQuoteIdQueryKey = ReturnType<typeof getInstantOpenQuoteIdQueryKey>;
+/**
+ * Options accepted by {@link getInstantOpenQuoteIdQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetInstantOpenQuoteIdOptions = Compute<GetInstantOpenQuoteIdParameters & QueryParameter<GetInstantOpenQuoteIdData, Error, GetInstantOpenQuoteIdData, GetInstantOpenQuoteIdQueryKey>>;
+/** TanStack Query options returned by {@link getInstantOpenQuoteIdQueryOptions}. */
+export type GetInstantOpenQuoteIdQueryOptions = SymmioQueryOptions<GetInstantOpenQuoteIdData, Error, GetInstantOpenQuoteIdData, GetInstantOpenQuoteIdQueryKey>;
+/**
+ * Build TanStack Query options for {@link getInstantOpenQuoteId}. Poll with
+ * `query.refetchInterval` until the returned id is non-null, then disable.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(
+ *   getInstantOpenQuoteIdQueryOptions(config, {
+ *     tempQuoteId: -1001,
+ *     query: { refetchInterval: 2_000 },
+ *   }),
+ * );
+ * ```
+ */
+export declare function getInstantOpenQuoteIdQueryOptions(config: Config, options: GetInstantOpenQuoteIdOptions): GetInstantOpenQuoteIdQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/solvers/instant-open/get-instant-open-quote-id/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/get-instant-open-quote-id/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACrC,MAAM,6BAA6B,CAAC;AAErC,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,CAAC,+BAA+B,GAAG,kBAAkB,CAAC,+DAEnH;AAED,wEAAwE;AACxE,MAAM,MAAM,6BAA6B,GAAG,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAE7F;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,+BAA+B,GAC7B,cAAc,CAAC,yBAAyB,EAAE,KAAK,EAAE,yBAAyB,EAAE,6BAA6B,CAAC,CAC7G,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,iCAAiC,GAAG,kBAAkB,CAChE,yBAAyB,EACzB,KAAK,EACL,yBAAyB,EACzB,6BAA6B,CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,4BAA4B,GACpC,iCAAiC,CAenC"}

package/dist/solvers/instant-open/get-instant-open-quote-id/query.js

@@ -0,0 +1,25 @@
+import { filterQueryOptions as e } from "../../../shared/utils/query.js";
+import { getInstantOpenQuoteId as t } from "./get-instant-open-quote-id.js";
+//#region src/solvers/instant-open/get-instant-open-quote-id/query.ts
+function n(t) {
+	return ["getInstantOpenQuoteId", e(t)];
+}
+function r(e, r) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: r.query?.enabled ?? !0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			tempQuoteId: r.tempQuoteId,
+			baseUrl: r.baseUrl
+		})
+	};
+}
+//#endregion
+export { n as getInstantOpenQuoteIdQueryKey, r as getInstantOpenQuoteIdQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/solvers/instant-open/get-instant-open-quote-id/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../../src/solvers/instant-open/get-instant-open-quote-id/query.ts"],"sourcesContent":["import type { Config } from \"../../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../../shared/types/query\";\nimport { filterQueryOptions } from \"../../../shared/utils/query\";\nimport {\n  getInstantOpenQuoteId,\n  type GetInstantOpenQuoteIdParameters,\n  type GetInstantOpenQuoteIdReturnType,\n} from \"./get-instant-open-quote-id\";\n\n/** Data resolved by the {@link getInstantOpenQuoteIdQueryOptions} query. */\nexport type GetInstantOpenQuoteIdData = GetInstantOpenQuoteIdReturnType;\n\n/**\n * Build the TanStack Query key for {@link getInstantOpenQuoteIdQueryOptions}.\n *\n * @param options - Query parameters (chain id, temp quote id, base url, config key).\n * @returns A stable, hashable query key.\n */\nexport function getInstantOpenQuoteIdQueryKey(options: Compute<GetInstantOpenQuoteIdParameters & ConfigKeyParameter>) {\n  return [\"getInstantOpenQuoteId\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getInstantOpenQuoteIdQueryKey}. */\nexport type GetInstantOpenQuoteIdQueryKey = ReturnType<typeof getInstantOpenQuoteIdQueryKey>;\n\n/**\n * Options accepted by {@link getInstantOpenQuoteIdQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetInstantOpenQuoteIdOptions = Compute<\n  GetInstantOpenQuoteIdParameters &\n    QueryParameter<GetInstantOpenQuoteIdData, Error, GetInstantOpenQuoteIdData, GetInstantOpenQuoteIdQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getInstantOpenQuoteIdQueryOptions}. */\nexport type GetInstantOpenQuoteIdQueryOptions = SymmioQueryOptions<\n  GetInstantOpenQuoteIdData,\n  Error,\n  GetInstantOpenQuoteIdData,\n  GetInstantOpenQuoteIdQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getInstantOpenQuoteId}. Poll with\n * `query.refetchInterval` until the returned id is non-null, then disable.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(\n *   getInstantOpenQuoteIdQueryOptions(config, {\n *     tempQuoteId: -1001,\n *     query: { refetchInterval: 2_000 },\n *   }),\n * );\n * ```\n */\nexport function getInstantOpenQuoteIdQueryOptions(\n  config: Config,\n  options: GetInstantOpenQuoteIdOptions,\n): GetInstantOpenQuoteIdQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getInstantOpenQuoteIdQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getInstantOpenQuoteId(config, {\n        chainId: options.chainId,\n        tempQuoteId: options.tempQuoteId,\n        baseUrl: options.baseUrl,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA8B,GAAwE;CACpH,OAAO,CAAC,yBAAyB,EAAmB,CAAO,CAAC;AAC9D;AAwCA,SAAgB,EACd,GACA,GACmC;CACnC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA8B;GACtC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAsB,GAAQ;GAC5B,SAAS,EAAQ;GACjB,aAAa,EAAQ;GACrB,SAAS,EAAQ;EACnB,CAAC;CACL;AACF"}

package/dist/solvers/instant-open/get-instant-opens/get-instant-opens.d.ts

@@ -0,0 +1,40 @@
+import { Address } from 'viem';
+import { Config } from '../../../core/config';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+import { PendingInstantOpen } from './to-pending-instant-open';
+/**
+ * Parameters for {@link getInstantOpens}.
+ */
+export type GetInstantOpensParameters = Compute<ChainIdParameter & {
+    /** Sub-account (partyA) to read pending instant-open records for. */
+    partyA: Address;
+    /**
+     * Hedger base URL to query. One call targets one hedger; fan out across
+     * hedgers in the consumer. Defaults to the chain config's `solver.url`.
+     */
+    baseUrl?: string;
+}>;
+/** Return type of {@link getInstantOpens}: normalized records from one hedger. */
+export type GetInstantOpensReturnType = readonly PendingInstantOpen[];
+/**
+ * Fetch a sub-account's pending instant-open records from a single hedger's
+ * `/instant_open/{account}` endpoint and normalize them to
+ * {@link PendingInstantOpen}.
+ *
+ * The hedger keeps returning a record until the corresponding quote exists
+ * on-chain, at which point it drops from the response. One call targets one
+ * hedger base URL; fan out across hedgers in the consumer.
+ *
+ * @param config - The SDK config.
+ * @param parameters - `partyA`, optional `chainId`, optional hedger `baseUrl`.
+ * @returns Normalized instant-open records for that hedger.
+ * @throws {SymmApiError} when the hedger request fails.
+ * @throws {SymmError} when the chain is unsupported.
+ *
+ * @example
+ * ```ts
+ * const orders = await getInstantOpens(config, { partyA: "0xva…" });
+ * ```
+ */
+export declare function getInstantOpens(config: Config, parameters: GetInstantOpensParameters): Promise<GetInstantOpensReturnType>;
+//# sourceMappingURL=get-instant-opens.d.ts.map

package/dist/solvers/instant-open/get-instant-opens/get-instant-opens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-instant-opens.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/get-instant-opens/get-instant-opens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAElF,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,gBAAgB,GAAG;IACjB,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,yBAAyB,GAAG,SAAS,kBAAkB,EAAE,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,yBAAyB,GACpC,OAAO,CAAC,yBAAyB,CAAC,CAoBpC"}

package/dist/solvers/instant-open/get-instant-opens/get-instant-opens.js

@@ -0,0 +1,20 @@
+import { SymmApiError as e, SymmError as t } from "../../../shared/errors/symm-error.js";
+import { getInstantOpenAccountAddress as n } from "../../types/generated/enigma-solver.js";
+import { toPendingInstantOpen as r } from "./to-pending-instant-open.js";
+import { isAxiosError as i } from "axios";
+//#region src/solvers/instant-open/get-instant-opens/get-instant-opens.ts
+async function a(a, o) {
+	let { solver: s } = a.getChainConfig(o.chainId), c = o.baseUrl ?? s.url;
+	try {
+		return ((await n(o.partyA, { baseURL: c })).data ?? []).map(r);
+	} catch (n) {
+		throw n instanceof t ? n : i(n) ? e.fromAxios(n, {
+			code: "GET_INSTANT_OPENS_FAILED",
+			baseURL: c
+		}) : new t("api", "GET_INSTANT_OPENS_FAILED", `Failed to fetch instant opens: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { a as getInstantOpens };
+
+//# sourceMappingURL=get-instant-opens.js.map

package/dist/solvers/instant-open/get-instant-opens/get-instant-opens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-instant-opens.js","names":[],"sources":["../../../../src/solvers/instant-open/get-instant-opens/get-instant-opens.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Address } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmApiError, SymmError } from \"../../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../../shared/types/properties\";\nimport { getInstantOpenAccountAddress } from \"../../types/generated/enigma-solver\";\nimport { toPendingInstantOpen, type PendingInstantOpen } from \"./to-pending-instant-open\";\n\n/**\n * Parameters for {@link getInstantOpens}.\n */\nexport type GetInstantOpensParameters = Compute<\n  ChainIdParameter & {\n    /** Sub-account (partyA) to read pending instant-open records for. */\n    partyA: Address;\n    /**\n     * Hedger base URL to query. One call targets one hedger; fan out across\n     * hedgers in the consumer. Defaults to the chain config's `solver.url`.\n     */\n    baseUrl?: string;\n  }\n>;\n\n/** Return type of {@link getInstantOpens}: normalized records from one hedger. */\nexport type GetInstantOpensReturnType = readonly PendingInstantOpen[];\n\n/**\n * Fetch a sub-account's pending instant-open records from a single hedger's\n * `/instant_open/{account}` endpoint and normalize them to\n * {@link PendingInstantOpen}.\n *\n * The hedger keeps returning a record until the corresponding quote exists\n * on-chain, at which point it drops from the response. One call targets one\n * hedger base URL; fan out across hedgers in the consumer.\n *\n * @param config - The SDK config.\n * @param parameters - `partyA`, optional `chainId`, optional hedger `baseUrl`.\n * @returns Normalized instant-open records for that hedger.\n * @throws {SymmApiError} when the hedger request fails.\n * @throws {SymmError} when the chain is unsupported.\n *\n * @example\n * ```ts\n * const orders = await getInstantOpens(config, { partyA: \"0xva…\" });\n * ```\n */\nexport async function getInstantOpens(\n  config: Config,\n  parameters: GetInstantOpensParameters,\n): Promise<GetInstantOpensReturnType> {\n  const { solver } = config.getChainConfig(parameters.chainId);\n  const baseURL = parameters.baseUrl ?? solver.url;\n  try {\n    const response = await getInstantOpenAccountAddress(parameters.partyA, { baseURL });\n    return (response.data ?? []).map(toPendingInstantOpen);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"GET_INSTANT_OPENS_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"GET_INSTANT_OPENS_FAILED\",\n      `Failed to fetch instant opens: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;AA8CA,eAAsB,EACpB,GACA,GACoC;CACpC,IAAM,EAAE,cAAW,EAAO,eAAe,EAAW,OAAO,GACrD,IAAU,EAAW,WAAW,EAAO;CAC7C,IAAI;EAEF,SAAQ,MADe,EAA6B,EAAW,QAAQ,EAAE,WAAQ,CAAC,GACjE,QAAQ,CAAC,GAAG,IAAI,CAAoB;CACvD,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA4B;EAAQ,CAAC,IAG3E,IAAI,EACR,OACA,4BACA,kCAAkC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KACjF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}