@symmio/trading-core 1.1.0 → 3.0.0

package/dist/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.d.ts

@@ -3,7 +3,7 @@ import { Config } from '../../../core/config/index.js';
 import { Compute, WriteSolverParameter } from '../../../shared/types/properties.js';
 import { FeeForUser } from '../../../symmio-contracts/symmio/actions/get-fee-for-user.js';
 import { ApiLockedParamsBySymbolIdResponse } from '../../types/generated/enigma-solver.js';
-import { InstantOpenParameters } from '../instant-open/instant-open.js';
+import { InstantOpenParameters } from '../instant-open/types.js';
 import { InstantOpenMarketData, PositionType } from '../shared/types.js';
 /**
  * Parameters for {@link prepareInstantOpenParams} and `instantOpenAuto`.
@@ -23,10 +23,24 @@ export type PrepareInstantOpenParameters = Compute<WriteSolverParameter & {
     initialMargin: string;
     /** Position leverage (integer ≥ 1). */
     leverage: number;
-    /** Slippage tolerance percent (e.g. `5` for 5%). */
-    slippage: number;
+    /**
+     * Slippage tolerance percent (e.g. `5` for 5%). **Required on majors
+     * (non-lowcap) solvers.** On a lowcap solver it may be omitted to
+     * auto-derive: the SDK dry-runs the sized order and sets the price bound
+     * to the estimated fill price plus 4% headroom (falling back to a flat 4%
+     * off mark when the estimate is unavailable).
+     */
+    slippage?: number;
     /** Pre-fetched mark price as decimal string. When omitted, fetched via Enigma price service. */
     markPrice?: string;
+    /**
+     * Pre-fetched solver estimated open (fill) price as decimal string —
+     * **lowcap/Enigma only**; ignored on any other solver kind. When omitted
+     * on a lowcap solver, fetched via `GET /estimated-price`. Feeds the
+     * settlement-loss provision, the slippage gate, and (when `slippage` is
+     * omitted) the auto-slippage derivation.
+     */
+    estimatedOpenPrice?: string;
     /**
      * Pre-fetched solver locked params (matches `getLockedParams` return —
      * `ApiLockedParamsBySymbolIdResponse`). When supplied with all four
@@ -51,19 +65,40 @@ export type PrepareInstantOpenParameters = Compute<WriteSolverParameter & {
  * Resolve every input the {@link InstantOpenParameters} primitive needs from a
  * minimal parameter set.
  *
+ * The estimate-driven steps (auto slippage, dry-run gate, solver fees,
+ * settlement provision) are **lowcap-only** — a majors (non-lowcap) prepare is
+ * unchanged: `slippage` required, no estimate fetch, margin = locks +
+ * platform fee.
+ *
  * Steps:
- * 1. Resolve market metadata, mark price, locked params, and fee rates —
+ * 1. Validate the user's `slippage` ({@link assertValidSlippage}). On a
+ *    lowcap solver it may be omitted and is auto-derived: dry-run the
+ *    mark-sized order and set the price bound to the estimated fill plus 4%
+ *    headroom ({@link deriveAutoSlippage}). On majors an omitted slippage
+ *    throws `SLIPPAGE_REQUIRED`.
+ * 2. Resolve market metadata, mark price, locked params, and fee rates —
  *    concurrent fetches with caller-supplied fields short-circuiting.
- * 2. Run {@link calculateTradeParams} to derive `requestedOpenPrice`,
+ * 3. Run {@link calculateTradeParams} to derive `requestedOpenPrice`,
  *    `quantity`, `cva`, `lf`, `partyAmm`, `partyBmm`, `notional`.
- * 3. Run {@link computePlatformFee} + {@link calculateMargin} to derive the
- *    `addMargin` amount.
- * 4. Convert all final values to 18-decimal-wei `bigint`.
+ * 4. Dry-run the sized order and reject when the expected fill deviates from
+ *    mark beyond the slippage tolerance
+ *    ({@link assertOpenEstimateWithinSlippage}; skipped when the estimate is
+ *    unavailable, reusing the caller-supplied `estimatedOpenPrice` or the
+ *    auto-slippage estimate when one exists).
+ * 5. Run {@link computePlatformFee}, {@link calculateSolverFees}, and
+ *    {@link calculateExpectedSettlementLoss}, then {@link calculateMargin} to
+ *    derive the `addMargin` amount — the solver charges its fees and the
+ *    open-price settlement from the VA, so the transfer funds
+ *    `locks + platformFee + openSolverFee + closeSolverFee +
+ *    expectedSettlementLoss`.
+ * 6. Convert all final values to 18-decimal-wei `bigint`.
  *
- * @throws {SymmError} `RESOLVE_MARKET_NOT_FOUND` /
+ * @throws {SymmError} `INVALID_SLIPPAGE` / `SLIPPAGE_REQUIRED` /
+ *   `SLIPPAGE_EXCEEDED` /
+ *   `RESOLVE_MARKET_NOT_FOUND` /
  *   `RESOLVE_MARKET_METADATA_INCOMPLETE` /
- *   `RESOLVE_MARK_PRICE_NOT_FOUND` / `INVALID_TRADE_PARAMETERS` for
- *   missing / invalid resolved inputs.
+ *   `RESOLVE_MARK_PRICE_NOT_FOUND` / `INVALID_TRADE_PARAMETERS` /
+ *   `INVALID_SOLVER_FEE_CAP` for invalid inputs or an out-of-tolerance fill.
  */
 export declare function prepareInstantOpenParams(config: Config, parameters: PrepareInstantOpenParameters): Promise<InstantOpenParameters>;
 //# sourceMappingURL=prepare-instant-open-params.d.ts.map

package/dist/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-instant-open-params.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2DAA2D,CAAC;AAC5F,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGhF;;;;;;GAMG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,oBAAoB,GAAG;IACrB,oCAAoC;IACpC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,MAAM,EAAE,qBAAqB,CAAC;IAC9B,kBAAkB;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,kDAAkD;IAClD,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,4BAA4B,GACvC,OAAO,CAAC,qBAAqB,CAAC,CAwFhC"}
+{"version":3,"file":"prepare-instant-open-params.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2DAA2D,CAAC;AAC5F,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAgBnE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+BhF;;;;;;GAMG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,oBAAoB,GAAG;IACrB,oCAAoC;IACpC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,MAAM,EAAE,qBAAqB,CAAC;IAC9B,kBAAkB;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,kDAAkD;IAClD,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,4BAA4B,GACvC,OAAO,CAAC,qBAAqB,CAAC,CAiOhC"}

package/dist/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.js

@@ -1,86 +1,175 @@
 import { SymmError as e } from "../../../shared/errors/symm-error.js";
-import { calculateMargin as t, calculateTradeParams as n, computePlatformFee as r, toWeiBigInt as i } from "../shared/trade-math.js";
-import { resolveMarkPrice as a } from "../../shared/resolvers/resolve-mark-price.js";
-import { resolveMarket as o } from "../../shared/resolvers/resolve-market.js";
-import { resolveFeeRates as s } from "./resolvers/resolve-fee-rates.js";
-import { resolveLockedParams as c } from "./resolvers/resolve-locked-params.js";
+import { calculateExpectedSettlementLoss as t, calculateMargin as n, calculateSolverFees as r, calculateTradeParams as i, computePlatformFee as a, toWeiBigInt as o } from "../shared/trade-math.js";
+import { decimalPriceToWei as s } from "../../../shared/utils/price.js";
+import { assertOpenEstimateWithinSlippage as c, assertValidSlippage as l, deriveAutoSlippage as u, fetchOpenEstimatePrice as d } from "../shared/open-estimate-guard.js";
+import { resolveMarkPrice as f } from "../../shared/resolvers/resolve-mark-price.js";
+import { resolveMarket as p } from "../../shared/resolvers/resolve-market.js";
+import { resolveFeeRates as m } from "./resolvers/resolve-fee-rates.js";
+import { resolveLockedParams as h } from "./resolvers/resolve-locked-params.js";
 //#region src/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.ts
-async function l(l, u) {
-	let d = await o(l, {
-		chainId: u.chainId,
-		marketId: u.market.id,
-		marketName: u.market.name,
-		pricePrecision: u.market.pricePrecision,
-		quantityPrecision: u.market.quantityPrecision
-	}), [f, p, m] = await Promise.all([
-		a(l, {
-			chainId: u.chainId,
-			marketName: d.name,
-			markPrice: u.markPrice
+var g = "0.01";
+function _(t, n) {
+	let r = s(n ?? g);
+	if (r === void 0) throw new e("validation", "INVALID_SOLVER_FEE_CAP", `prepareInstantOpenParams: market ${t} "${n}" is not a valid decimal ratio.`);
+	return r;
+}
+async function v(s, g) {
+	g.slippage !== void 0 && l(g.slippage);
+	let v = s.getSolver({
+		chainId: g.chainId,
+		solverId: g.solverId
+	}).id === "enigma";
+	if (g.slippage === void 0 && !v) throw new e("validation", "SLIPPAGE_REQUIRED", "prepareInstantOpenParams: slippage is required on this solver — auto-derived slippage is lowcap-only.");
+	let y = s.getChainConfig(g.chainId).contractsVersion === "0.8.6", b = await p(s, {
+		chainId: g.chainId,
+		solverId: g.solverId,
+		marketId: g.market.id,
+		marketName: g.market.name,
+		pricePrecision: g.market.pricePrecision,
+		quantityPrecision: g.market.quantityPrecision,
+		minOpenSolverFeeCap: g.market.minOpenSolverFeeCap,
+		minCloseSolverFeeCap: g.market.minCloseSolverFeeCap,
+		includeSolverFeeCaps: y,
+		hedgerFeeOpen: g.market.hedgerFeeOpen,
+		hedgerFeeClose: g.market.hedgerFeeClose,
+		hedgerFeeCloseEarlyRate: g.market.hedgerFeeCloseEarlyRate,
+		hedgerFeeCloseEarlyThreshold: g.market.hedgerFeeCloseEarlyThreshold,
+		hedgerFeeCloseStandardThreshold: g.market.hedgerFeeCloseStandardThreshold,
+		includeHedgerFees: v
+	}), [x, S, C] = await Promise.all([
+		f(s, {
+			chainId: g.chainId,
+			solverId: g.solverId,
+			marketName: b.name,
+			markPrice: g.markPrice
 		}),
-		c(l, {
-			chainId: u.chainId,
-			marketName: d.name,
-			leverage: u.leverage,
-			lockedParamPercent: u.lockedParamPercent
+		h(s, {
+			chainId: g.chainId,
+			solverId: g.solverId,
+			marketName: b.name,
+			leverage: g.leverage,
+			lockedParamPercent: g.lockedParamPercent
 		}),
-		s(l, {
-			chainId: u.chainId,
-			subAccountAddress: u.subAccountAddress,
-			marketId: u.market.id,
-			feeRates: u.feeRates
+		m(s, {
+			chainId: g.chainId,
+			subAccountAddress: g.subAccountAddress,
+			marketId: g.market.id,
+			feeRates: g.feeRates
 		})
-	]), h = n({
-		markPrice: f,
-		slippage: u.slippage,
-		positionType: u.positionType,
-		userInput: u.initialMargin,
+	]), w = {
+		markPrice: x,
+		positionType: g.positionType,
+		userInput: g.initialMargin,
 		inputField: "PRICE",
-		leverage: u.leverage,
-		pricePrecision: d.pricePrecision,
-		quantityPrecision: d.quantityPrecision,
-		cvaPercent: p.cva,
-		lfPercent: p.lf,
-		partyAmmPercent: p.partyAmm,
-		partyBmmPercent: p.partyBmm
+		leverage: g.leverage,
+		pricePrecision: b.pricePrecision,
+		quantityPrecision: b.quantityPrecision,
+		cvaPercent: S.cva,
+		lfPercent: S.lf,
+		partyAmmPercent: S.partyAmm,
+		partyBmmPercent: S.partyBmm
+	}, T = g.slippage, E = v ? g.estimatedOpenPrice : void 0;
+	if (T === void 0) {
+		let t = i({
+			...w,
+			slippage: 0
+		});
+		if (!t) throw new e("validation", "INVALID_TRADE_PARAMETERS", "Invalid trade parameters: markPrice or initialMargin is zero/NaN.");
+		v && E === void 0 && (E = await d(s, {
+			chainId: g.chainId,
+			solverId: g.solverId,
+			symbolId: g.market.id,
+			positionType: g.positionType,
+			quantity: t.quantity,
+			markPrice: x
+		})), T = u({
+			markPrice: x,
+			expectedFillPrice: E,
+			positionType: g.positionType
+		});
+	}
+	let D = i({
+		...w,
+		slippage: T
+	});
+	if (!D) throw new e("validation", "INVALID_TRADE_PARAMETERS", "Invalid trade parameters: markPrice or initialMargin is zero/NaN.");
+	v && E === void 0 && (E = await d(s, {
+		chainId: g.chainId,
+		solverId: g.solverId,
+		symbolId: g.market.id,
+		positionType: g.positionType,
+		quantity: D.quantity,
+		markPrice: x
+	})), E !== void 0 && await c(s, {
+		chainId: g.chainId,
+		solverId: g.solverId,
+		symbolId: g.market.id,
+		positionType: g.positionType,
+		quantity: D.quantity,
+		markPrice: x,
+		slippage: T,
+		expectedFillPrice: E
 	});
-	if (!h) throw new e("validation", "INVALID_TRADE_PARAMETERS", "Invalid trade parameters: markPrice or initialMargin is zero/NaN.");
-	let g = r(m, h.notional, h.notional), _ = t({
-		positionType: u.positionType,
-		markPrice: f,
-		quantityBasic: h.quantityBasic,
-		cva: h.cva,
-		lf: h.lf,
-		partyAmm: h.partyAmm,
-		cvaPercent: p.cva,
-		lfPercent: p.lf,
-		partyAmmPercent: p.partyAmm,
-		platformFee: g
+	let O = a(C, D.notional, D.notional), { openSolverFee: k, closeSolverFee: A } = v ? r({
+		notional: D.notional,
+		hedgerFeeOpen: b.hedgerFeeOpen,
+		hedgerFeeClose: b.hedgerFeeClose,
+		hedgerFeeCloseEarlyRate: b.hedgerFeeCloseEarlyRate,
+		hedgerFeeCloseEarlyThreshold: b.hedgerFeeCloseEarlyThreshold,
+		hedgerFeeCloseStandardThreshold: b.hedgerFeeCloseStandardThreshold
+	}) : {
+		openSolverFee: "0",
+		closeSolverFee: "0"
+	}, j = t({
+		positionType: g.positionType,
+		markPrice: x,
+		expectedFillPrice: E,
+		quantity: D.quantity
+	}), M = n({
+		positionType: g.positionType,
+		markPrice: x,
+		quantityBasic: D.quantityBasic,
+		cva: D.cva,
+		lf: D.lf,
+		partyAmm: D.partyAmm,
+		openSolverFee: k,
+		closeSolverFee: A,
+		expectedSettlementLoss: j,
+		shortFundingBufferPercent: +!!v,
+		cvaPercent: S.cva,
+		lfPercent: S.lf,
+		partyAmmPercent: S.partyAmm,
+		platformFee: O
 	});
 	return {
-		chainId: u.chainId,
-		from: u.from,
-		subAccountAddress: u.subAccountAddress,
-		marketId: u.market.id,
-		positionType: u.positionType,
+		chainId: g.chainId,
+		solverId: g.solverId,
+		from: g.from,
+		subAccountAddress: g.subAccountAddress,
+		marketId: g.market.id,
+		positionType: g.positionType,
 		order: {
-			price: i(h.requestedOpenPrice),
-			quantity: i(h.quantity)
+			price: o(D.requestedOpenPrice),
+			quantity: o(D.quantity)
 		},
 		lockedParam: {
-			cva: i(h.cva),
-			lf: i(h.lf),
-			partyAmm: i(h.partyAmm),
-			partyBmm: i(h.partyBmm)
+			cva: o(D.cva),
+			lf: o(D.lf),
+			partyAmm: o(D.partyAmm),
+			partyBmm: o(D.partyBmm)
 		},
-		margin: { amount: i(_) },
-		uuid: u.uuid,
-		addMarginSalt: u.addMarginSalt,
-		sendQuoteSalt: u.sendQuoteSalt,
-		deadline: u.deadline
+		margin: { amount: o(M) },
+		...y ? { solverFeeCaps: {
+			openRateCap: _("minOpenSolverFeeCap", b.minOpenSolverFeeCap),
+			closeRateCap: _("minCloseSolverFeeCap", b.minCloseSolverFeeCap)
+		} } : {},
+		uuid: g.uuid,
+		addMarginSalt: g.addMarginSalt,
+		sendQuoteSalt: g.sendQuoteSalt,
+		deadline: g.deadline
 	};
 }
 //#endregion
-export { l as prepareInstantOpenParams };
+export { v as prepareInstantOpenParams };
 
 //# sourceMappingURL=prepare-instant-open-params.js.map

package/dist/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-instant-open-params.js","names":[],"sources":["../../../../src/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmError } from \"../../../shared/errors/symm-error\";\nimport type { Compute, WriteSolverParameter } from \"../../../shared/types/properties\";\nimport type { FeeForUser } from \"../../../symmio-contracts/symmio/actions/get-fee-for-user\";\nimport type { ApiLockedParamsBySymbolIdResponse } from \"../../types/generated/enigma-solver\";\nimport type { InstantOpenParameters } from \"../instant-open/instant-open\";\nimport { calculateMargin, calculateTradeParams, computePlatformFee, toWeiBigInt } from \"../shared/trade-math\";\nimport { type InstantOpenMarketData, type PositionType } from \"../shared/types\";\nimport { resolveFeeRates, resolveLockedParams, resolveMarket, resolveMarkPrice } from \"./resolvers\";\n\n/**\n * Parameters for {@link prepareInstantOpenParams} and `instantOpenAuto`.\n *\n * Required = inputs only the caller can know (wallet, session key, trade\n * intent). Optional = anything derivable from solver / price-service / on-chain\n * reads. Pre-fill an optional field to skip its fetch.\n */\nexport type PrepareInstantOpenParameters = Compute<\n  WriteSolverParameter & {\n    /** Sub-account / partyA address. */\n    subAccountAddress: Address;\n    /** Market identification + optional pre-fetched precision metadata. */\n    market: InstantOpenMarketData;\n    /** Trade side. */\n    positionType: PositionType;\n    /** Collateral (USD) the user enters as initial margin. Decimal string. */\n    initialMargin: string;\n    /** Position leverage (integer ≥ 1). */\n    leverage: number;\n    /** Slippage tolerance percent (e.g. `5` for 5%). */\n    slippage: number;\n    /** Pre-fetched mark price as decimal string. When omitted, fetched via Enigma price service. */\n    markPrice?: string;\n    /**\n     * Pre-fetched solver locked params (matches `getLockedParams` return —\n     * `ApiLockedParamsBySymbolIdResponse`). When supplied with all four\n     * percent fields, the fetch is skipped.\n     */\n    lockedParamPercent?: ApiLockedParamsBySymbolIdResponse;\n    /**\n     * Pre-fetched on-chain fee rates (matches `getFeeForUser` return —\n     * `FeeForUser`). When omitted, fetched via `getFeeForUser`.\n     */\n    feeRates?: FeeForUser;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    uuid?: string;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    addMarginSalt?: Hex;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    sendQuoteSalt?: Hex;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    deadline?: bigint;\n  }\n>;\n\n/**\n * Resolve every input the {@link InstantOpenParameters} primitive needs from a\n * minimal parameter set.\n *\n * Steps:\n * 1. Resolve market metadata, mark price, locked params, and fee rates —\n *    concurrent fetches with caller-supplied fields short-circuiting.\n * 2. Run {@link calculateTradeParams} to derive `requestedOpenPrice`,\n *    `quantity`, `cva`, `lf`, `partyAmm`, `partyBmm`, `notional`.\n * 3. Run {@link computePlatformFee} + {@link calculateMargin} to derive the\n *    `addMargin` amount.\n * 4. Convert all final values to 18-decimal-wei `bigint`.\n *\n * @throws {SymmError} `RESOLVE_MARKET_NOT_FOUND` /\n *   `RESOLVE_MARKET_METADATA_INCOMPLETE` /\n *   `RESOLVE_MARK_PRICE_NOT_FOUND` / `INVALID_TRADE_PARAMETERS` for\n *   missing / invalid resolved inputs.\n */\nexport async function prepareInstantOpenParams(\n  config: Config,\n  parameters: PrepareInstantOpenParameters,\n): Promise<InstantOpenParameters> {\n  const market = await resolveMarket(config, {\n    chainId: parameters.chainId,\n    marketId: parameters.market.id,\n    marketName: parameters.market.name,\n    pricePrecision: parameters.market.pricePrecision,\n    quantityPrecision: parameters.market.quantityPrecision,\n  });\n  const [markPrice, lockedParams, feeRates] = await Promise.all([\n    resolveMarkPrice(config, {\n      chainId: parameters.chainId,\n      marketName: market.name,\n      markPrice: parameters.markPrice,\n    }),\n    resolveLockedParams(config, {\n      chainId: parameters.chainId,\n      marketName: market.name,\n      leverage: parameters.leverage,\n      lockedParamPercent: parameters.lockedParamPercent,\n    }),\n    resolveFeeRates(config, {\n      chainId: parameters.chainId,\n      subAccountAddress: parameters.subAccountAddress,\n      marketId: parameters.market.id,\n      feeRates: parameters.feeRates,\n    }),\n  ]);\n\n  const tradeCalc = calculateTradeParams({\n    markPrice,\n    slippage: parameters.slippage,\n    positionType: parameters.positionType,\n    userInput: parameters.initialMargin,\n    inputField: \"PRICE\",\n    leverage: parameters.leverage,\n    pricePrecision: market.pricePrecision,\n    quantityPrecision: market.quantityPrecision,\n    cvaPercent: lockedParams.cva,\n    lfPercent: lockedParams.lf,\n    partyAmmPercent: lockedParams.partyAmm,\n    partyBmmPercent: lockedParams.partyBmm,\n  });\n  if (!tradeCalc) {\n    throw new SymmError(\n      \"validation\",\n      \"INVALID_TRADE_PARAMETERS\",\n      \"Invalid trade parameters: markPrice or initialMargin is zero/NaN.\",\n    );\n  }\n\n  const platformFee = computePlatformFee(feeRates, tradeCalc.notional, tradeCalc.notional);\n  const marginAmount = calculateMargin({\n    positionType: parameters.positionType,\n    markPrice,\n    quantityBasic: tradeCalc.quantityBasic,\n    cva: tradeCalc.cva,\n    lf: tradeCalc.lf,\n    partyAmm: tradeCalc.partyAmm,\n    cvaPercent: lockedParams.cva,\n    lfPercent: lockedParams.lf,\n    partyAmmPercent: lockedParams.partyAmm,\n    platformFee,\n  });\n\n  return {\n    chainId: parameters.chainId,\n    from: parameters.from,\n    subAccountAddress: parameters.subAccountAddress,\n    marketId: parameters.market.id,\n    positionType: parameters.positionType,\n    order: {\n      price: toWeiBigInt(tradeCalc.requestedOpenPrice),\n      quantity: toWeiBigInt(tradeCalc.quantity),\n    },\n    lockedParam: {\n      cva: toWeiBigInt(tradeCalc.cva),\n      lf: toWeiBigInt(tradeCalc.lf),\n      partyAmm: toWeiBigInt(tradeCalc.partyAmm),\n      partyBmm: toWeiBigInt(tradeCalc.partyBmm),\n    },\n    margin: {\n      amount: toWeiBigInt(marginAmount),\n    },\n    uuid: parameters.uuid,\n    addMarginSalt: parameters.addMarginSalt,\n    sendQuoteSalt: parameters.sendQuoteSalt,\n    deadline: parameters.deadline,\n  };\n}\n"],"mappings":";;;;;;;AA0EA,eAAsB,EACpB,GACA,GACgC;CAChC,IAAM,IAAS,MAAM,EAAc,GAAQ;EACzC,SAAS,EAAW;EACpB,UAAU,EAAW,OAAO;EAC5B,YAAY,EAAW,OAAO;EAC9B,gBAAgB,EAAW,OAAO;EAClC,mBAAmB,EAAW,OAAO;CACvC,CAAC,GACK,CAAC,GAAW,GAAc,KAAY,MAAM,QAAQ,IAAI;EAC5D,EAAiB,GAAQ;GACvB,SAAS,EAAW;GACpB,YAAY,EAAO;GACnB,WAAW,EAAW;EACxB,CAAC;EACD,EAAoB,GAAQ;GAC1B,SAAS,EAAW;GACpB,YAAY,EAAO;GACnB,UAAU,EAAW;GACrB,oBAAoB,EAAW;EACjC,CAAC;EACD,EAAgB,GAAQ;GACtB,SAAS,EAAW;GACpB,mBAAmB,EAAW;GAC9B,UAAU,EAAW,OAAO;GAC5B,UAAU,EAAW;EACvB,CAAC;CACH,CAAC,GAEK,IAAY,EAAqB;EACrC;EACA,UAAU,EAAW;EACrB,cAAc,EAAW;EACzB,WAAW,EAAW;EACtB,YAAY;EACZ,UAAU,EAAW;EACrB,gBAAgB,EAAO;EACvB,mBAAmB,EAAO;EAC1B,YAAY,EAAa;EACzB,WAAW,EAAa;EACxB,iBAAiB,EAAa;EAC9B,iBAAiB,EAAa;CAChC,CAAC;CACD,IAAI,CAAC,GACH,MAAM,IAAI,EACR,cACA,4BACA,mEACF;CAGF,IAAM,IAAc,EAAmB,GAAU,EAAU,UAAU,EAAU,QAAQ,GACjF,IAAe,EAAgB;EACnC,cAAc,EAAW;EACzB;EACA,eAAe,EAAU;EACzB,KAAK,EAAU;EACf,IAAI,EAAU;EACd,UAAU,EAAU;EACpB,YAAY,EAAa;EACzB,WAAW,EAAa;EACxB,iBAAiB,EAAa;EAC9B;CACF,CAAC;CAED,OAAO;EACL,SAAS,EAAW;EACpB,MAAM,EAAW;EACjB,mBAAmB,EAAW;EAC9B,UAAU,EAAW,OAAO;EAC5B,cAAc,EAAW;EACzB,OAAO;GACL,OAAO,EAAY,EAAU,kBAAkB;GAC/C,UAAU,EAAY,EAAU,QAAQ;EAC1C;EACA,aAAa;GACX,KAAK,EAAY,EAAU,GAAG;GAC9B,IAAI,EAAY,EAAU,EAAE;GAC5B,UAAU,EAAY,EAAU,QAAQ;GACxC,UAAU,EAAY,EAAU,QAAQ;EAC1C;EACA,QAAQ,EACN,QAAQ,EAAY,CAAY,EAClC;EACA,MAAM,EAAW;EACjB,eAAe,EAAW;EAC1B,eAAe,EAAW;EAC1B,UAAU,EAAW;CACvB;AACF"}
+{"version":3,"file":"prepare-instant-open-params.js","names":[],"sources":["../../../../src/solvers/instant-open/prepare-instant-open-params/prepare-instant-open-params.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport { SymmError } from \"../../../shared/errors/symm-error\";\nimport type { Compute, WriteSolverParameter } from \"../../../shared/types/properties\";\nimport { decimalPriceToWei } from \"../../../shared/utils/price\";\nimport type { FeeForUser } from \"../../../symmio-contracts/symmio/actions/get-fee-for-user\";\nimport type { ApiLockedParamsBySymbolIdResponse } from \"../../types/generated/enigma-solver\";\nimport type { InstantOpenParameters } from \"../instant-open/types\";\nimport {\n  assertOpenEstimateWithinSlippage,\n  assertValidSlippage,\n  deriveAutoSlippage,\n  fetchOpenEstimatePrice,\n} from \"../shared/open-estimate-guard\";\nimport {\n  calculateExpectedSettlementLoss,\n  calculateMargin,\n  calculateSolverFees,\n  calculateTradeParams,\n  computePlatformFee,\n  SHORT_FUNDING_BUFFER_PERCENT,\n  toWeiBigInt,\n} from \"../shared/trade-math\";\nimport { type InstantOpenMarketData, type PositionType } from \"../shared/types\";\nimport { resolveFeeRates, resolveLockedParams, resolveMarket, resolveMarkPrice } from \"./resolvers\";\n\n/**\n * Default solver-fee rate cap when the market publishes none: `\"0.01\"` — 1% of\n * notional, as a decimal ratio. Applied per side before wei conversion.\n */\nconst DEFAULT_SOLVER_FEE_CAP = \"0.01\";\n\n/**\n * Convert a market's solver-fee cap ratio string to its 18-decimal wei value.\n *\n * An absent cap falls back to {@link DEFAULT_SOLVER_FEE_CAP}; a present but\n * malformed string **throws** rather than silently signing zero caps — the caps\n * are immutable once `sendQuote` lands, so a bad vendor string must surface\n * before the signature, not after.\n *\n * @throws {SymmError} `INVALID_SOLVER_FEE_CAP` when the string does not parse.\n */\nfunction solverFeeCapToWei(field: \"minOpenSolverFeeCap\" | \"minCloseSolverFeeCap\", value: string | undefined): bigint {\n  const cap = decimalPriceToWei(value ?? DEFAULT_SOLVER_FEE_CAP);\n  if (cap === undefined) {\n    throw new SymmError(\n      \"validation\",\n      \"INVALID_SOLVER_FEE_CAP\",\n      `prepareInstantOpenParams: market ${field} \"${value}\" is not a valid decimal ratio.`,\n    );\n  }\n  return cap;\n}\n\n/**\n * Parameters for {@link prepareInstantOpenParams} and `instantOpenAuto`.\n *\n * Required = inputs only the caller can know (wallet, session key, trade\n * intent). Optional = anything derivable from solver / price-service / on-chain\n * reads. Pre-fill an optional field to skip its fetch.\n */\nexport type PrepareInstantOpenParameters = Compute<\n  WriteSolverParameter & {\n    /** Sub-account / partyA address. */\n    subAccountAddress: Address;\n    /** Market identification + optional pre-fetched precision metadata. */\n    market: InstantOpenMarketData;\n    /** Trade side. */\n    positionType: PositionType;\n    /** Collateral (USD) the user enters as initial margin. Decimal string. */\n    initialMargin: string;\n    /** Position leverage (integer ≥ 1). */\n    leverage: number;\n    /**\n     * Slippage tolerance percent (e.g. `5` for 5%). **Required on majors\n     * (non-lowcap) solvers.** On a lowcap solver it may be omitted to\n     * auto-derive: the SDK dry-runs the sized order and sets the price bound\n     * to the estimated fill price plus 4% headroom (falling back to a flat 4%\n     * off mark when the estimate is unavailable).\n     */\n    slippage?: number;\n    /** Pre-fetched mark price as decimal string. When omitted, fetched via Enigma price service. */\n    markPrice?: string;\n    /**\n     * Pre-fetched solver estimated open (fill) price as decimal string —\n     * **lowcap/Enigma only**; ignored on any other solver kind. When omitted\n     * on a lowcap solver, fetched via `GET /estimated-price`. Feeds the\n     * settlement-loss provision, the slippage gate, and (when `slippage` is\n     * omitted) the auto-slippage derivation.\n     */\n    estimatedOpenPrice?: string;\n    /**\n     * Pre-fetched solver locked params (matches `getLockedParams` return —\n     * `ApiLockedParamsBySymbolIdResponse`). When supplied with all four\n     * percent fields, the fetch is skipped.\n     */\n    lockedParamPercent?: ApiLockedParamsBySymbolIdResponse;\n    /**\n     * Pre-fetched on-chain fee rates (matches `getFeeForUser` return —\n     * `FeeForUser`). When omitted, fetched via `getFeeForUser`.\n     */\n    feeRates?: FeeForUser;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    uuid?: string;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    addMarginSalt?: Hex;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    sendQuoteSalt?: Hex;\n    /** Forwarded to {@link InstantOpenParameters}. */\n    deadline?: bigint;\n  }\n>;\n\n/**\n * Resolve every input the {@link InstantOpenParameters} primitive needs from a\n * minimal parameter set.\n *\n * The estimate-driven steps (auto slippage, dry-run gate, solver fees,\n * settlement provision) are **lowcap-only** — a majors (non-lowcap) prepare is\n * unchanged: `slippage` required, no estimate fetch, margin = locks +\n * platform fee.\n *\n * Steps:\n * 1. Validate the user's `slippage` ({@link assertValidSlippage}). On a\n *    lowcap solver it may be omitted and is auto-derived: dry-run the\n *    mark-sized order and set the price bound to the estimated fill plus 4%\n *    headroom ({@link deriveAutoSlippage}). On majors an omitted slippage\n *    throws `SLIPPAGE_REQUIRED`.\n * 2. Resolve market metadata, mark price, locked params, and fee rates —\n *    concurrent fetches with caller-supplied fields short-circuiting.\n * 3. Run {@link calculateTradeParams} to derive `requestedOpenPrice`,\n *    `quantity`, `cva`, `lf`, `partyAmm`, `partyBmm`, `notional`.\n * 4. Dry-run the sized order and reject when the expected fill deviates from\n *    mark beyond the slippage tolerance\n *    ({@link assertOpenEstimateWithinSlippage}; skipped when the estimate is\n *    unavailable, reusing the caller-supplied `estimatedOpenPrice` or the\n *    auto-slippage estimate when one exists).\n * 5. Run {@link computePlatformFee}, {@link calculateSolverFees}, and\n *    {@link calculateExpectedSettlementLoss}, then {@link calculateMargin} to\n *    derive the `addMargin` amount — the solver charges its fees and the\n *    open-price settlement from the VA, so the transfer funds\n *    `locks + platformFee + openSolverFee + closeSolverFee +\n *    expectedSettlementLoss`.\n * 6. Convert all final values to 18-decimal-wei `bigint`.\n *\n * @throws {SymmError} `INVALID_SLIPPAGE` / `SLIPPAGE_REQUIRED` /\n *   `SLIPPAGE_EXCEEDED` /\n *   `RESOLVE_MARKET_NOT_FOUND` /\n *   `RESOLVE_MARKET_METADATA_INCOMPLETE` /\n *   `RESOLVE_MARK_PRICE_NOT_FOUND` / `INVALID_TRADE_PARAMETERS` /\n *   `INVALID_SOLVER_FEE_CAP` for invalid inputs or an out-of-tolerance fill.\n */\nexport async function prepareInstantOpenParams(\n  config: Config,\n  parameters: PrepareInstantOpenParameters,\n): Promise<InstantOpenParameters> {\n  // Reject a malformed user slippage before any network work. An omitted\n  // slippage is auto-derived from the dry-run estimate after sizing.\n  if (parameters.slippage !== undefined) assertValidSlippage(parameters.slippage);\n\n  /**\n   * The estimate-driven behaviors — auto slippage, the dry-run gate, solver\n   * fees, and the settlement provision — exist only on lowcap (Enigma)\n   * solvers. On majors the flow is unchanged: slippage is required, no\n   * estimate is fetched, and the margin carries locks + platform fee only.\n   */\n  const isLowcap = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId }).id === \"enigma\";\n  if (parameters.slippage === undefined && !isLowcap) {\n    throw new SymmError(\n      \"validation\",\n      \"SLIPPAGE_REQUIRED\",\n      \"prepareInstantOpenParams: slippage is required on this solver — auto-derived slippage is lowcap-only.\",\n    );\n  }\n\n  /** Fee caps only exist on the v0.8.6 quote API — don't force a market fetch for them on a legacy chain. */\n  const needsSolverFeeCaps = config.getChainConfig(parameters.chainId).contractsVersion === \"0.8.6\";\n\n  const market = await resolveMarket(config, {\n    chainId: parameters.chainId,\n    solverId: parameters.solverId,\n    marketId: parameters.market.id,\n    marketName: parameters.market.name,\n    pricePrecision: parameters.market.pricePrecision,\n    quantityPrecision: parameters.market.quantityPrecision,\n    minOpenSolverFeeCap: parameters.market.minOpenSolverFeeCap,\n    minCloseSolverFeeCap: parameters.market.minCloseSolverFeeCap,\n    includeSolverFeeCaps: needsSolverFeeCaps,\n    hedgerFeeOpen: parameters.market.hedgerFeeOpen,\n    hedgerFeeClose: parameters.market.hedgerFeeClose,\n    hedgerFeeCloseEarlyRate: parameters.market.hedgerFeeCloseEarlyRate,\n    hedgerFeeCloseEarlyThreshold: parameters.market.hedgerFeeCloseEarlyThreshold,\n    hedgerFeeCloseStandardThreshold: parameters.market.hedgerFeeCloseStandardThreshold,\n    /** Lowcap only: the solver charges its fees from the VA, so `addMargin` must fund them. */\n    includeHedgerFees: isLowcap,\n  });\n  const [markPrice, lockedParams, feeRates] = await Promise.all([\n    resolveMarkPrice(config, {\n      chainId: parameters.chainId,\n      solverId: parameters.solverId,\n      marketName: market.name,\n      markPrice: parameters.markPrice,\n    }),\n    resolveLockedParams(config, {\n      chainId: parameters.chainId,\n      solverId: parameters.solverId,\n      marketName: market.name,\n      leverage: parameters.leverage,\n      lockedParamPercent: parameters.lockedParamPercent,\n    }),\n    resolveFeeRates(config, {\n      chainId: parameters.chainId,\n      subAccountAddress: parameters.subAccountAddress,\n      marketId: parameters.market.id,\n      feeRates: parameters.feeRates,\n    }),\n  ]);\n\n  const calculationInput = {\n    markPrice,\n    positionType: parameters.positionType,\n    userInput: parameters.initialMargin,\n    inputField: \"PRICE\" as const,\n    leverage: parameters.leverage,\n    pricePrecision: market.pricePrecision,\n    quantityPrecision: market.quantityPrecision,\n    cvaPercent: lockedParams.cva,\n    lfPercent: lockedParams.lf,\n    partyAmmPercent: lockedParams.partyAmm,\n    partyBmmPercent: lockedParams.partyBmm,\n  };\n\n  // Auto slippage: dry-run the mark-sized order (quantity is slippage-\n  // independent) and set the price bound to the estimated fill plus 4%\n  // headroom, re-expressed as a percent off mark. A caller-supplied\n  // `estimatedOpenPrice` short-circuits the fetch; either way the estimate is\n  // reused by the gate and the settlement provision so the solver is asked at\n  // most once.\n  let slippage = parameters.slippage;\n  let expectedFillPrice = isLowcap ? parameters.estimatedOpenPrice : undefined;\n  if (slippage === undefined) {\n    const sized = calculateTradeParams({ ...calculationInput, slippage: 0 });\n    if (!sized) {\n      throw new SymmError(\n        \"validation\",\n        \"INVALID_TRADE_PARAMETERS\",\n        \"Invalid trade parameters: markPrice or initialMargin is zero/NaN.\",\n      );\n    }\n    if (isLowcap && expectedFillPrice === undefined) {\n      expectedFillPrice = await fetchOpenEstimatePrice(config, {\n        chainId: parameters.chainId,\n        solverId: parameters.solverId,\n        symbolId: parameters.market.id,\n        positionType: parameters.positionType,\n        quantity: sized.quantity,\n        markPrice,\n      });\n    }\n    slippage = deriveAutoSlippage({ markPrice, expectedFillPrice, positionType: parameters.positionType });\n  }\n\n  const tradeCalc = calculateTradeParams({ ...calculationInput, slippage });\n  if (!tradeCalc) {\n    throw new SymmError(\n      \"validation\",\n      \"INVALID_TRADE_PARAMETERS\",\n      \"Invalid trade parameters: markPrice or initialMargin is zero/NaN.\",\n    );\n  }\n\n  // The expected fill price funds the settlement-loss provision and feeds the\n  // slippage gate. Fetch it once here when neither the caller nor the\n  // auto-slippage path supplied it — pass `estimatedOpenPrice` to skip the\n  // round-trip on latency-sensitive submits.\n  if (isLowcap && expectedFillPrice === undefined) {\n    expectedFillPrice = await fetchOpenEstimatePrice(config, {\n      chainId: parameters.chainId,\n      solverId: parameters.solverId,\n      symbolId: parameters.market.id,\n      positionType: parameters.positionType,\n      quantity: tradeCalc.quantity,\n      markPrice,\n    });\n  }\n\n  // Dry-run gate: reject early when the expected fill deviates from mark\n  // beyond the user's slippage — the solver would reject the quote anyway.\n  // Best-effort: an unavailable estimate skips the gate, never blocks the open.\n  if (expectedFillPrice !== undefined) {\n    await assertOpenEstimateWithinSlippage(config, {\n      chainId: parameters.chainId,\n      solverId: parameters.solverId,\n      symbolId: parameters.market.id,\n      positionType: parameters.positionType,\n      quantity: tradeCalc.quantity,\n      markPrice,\n      slippage,\n      expectedFillPrice,\n    });\n  }\n\n  const platformFee = computePlatformFee(feeRates, tradeCalc.notional, tradeCalc.notional);\n  // Lowcap: the solver charges its fees and the open-price settlement from the\n  // VA balance — the addMargin transfer moves those funds from the SubAccount.\n  // Majors carry neither leg; their margin stays locks + platform fee.\n  const { openSolverFee, closeSolverFee } = isLowcap\n    ? calculateSolverFees({\n        notional: tradeCalc.notional,\n        hedgerFeeOpen: market.hedgerFeeOpen,\n        hedgerFeeClose: market.hedgerFeeClose,\n        hedgerFeeCloseEarlyRate: market.hedgerFeeCloseEarlyRate,\n        hedgerFeeCloseEarlyThreshold: market.hedgerFeeCloseEarlyThreshold,\n        hedgerFeeCloseStandardThreshold: market.hedgerFeeCloseStandardThreshold,\n      })\n    : { openSolverFee: \"0\", closeSolverFee: \"0\" };\n  const expectedSettlementLoss = calculateExpectedSettlementLoss({\n    positionType: parameters.positionType,\n    markPrice,\n    expectedFillPrice,\n    quantity: tradeCalc.quantity,\n  });\n  const marginAmount = calculateMargin({\n    positionType: parameters.positionType,\n    markPrice,\n    quantityBasic: tradeCalc.quantityBasic,\n    cva: tradeCalc.cva,\n    lf: tradeCalc.lf,\n    partyAmm: tradeCalc.partyAmm,\n    openSolverFee,\n    closeSolverFee,\n    expectedSettlementLoss,\n    /** Lowcap SHORT: fund lock growth above the floor. Majors keep the classic basis. */\n    shortFundingBufferPercent: isLowcap ? SHORT_FUNDING_BUFFER_PERCENT : 0,\n    cvaPercent: lockedParams.cva,\n    lfPercent: lockedParams.lf,\n    partyAmmPercent: lockedParams.partyAmm,\n    platformFee,\n  });\n\n  return {\n    chainId: parameters.chainId,\n    /**\n     * Carried through deliberately: `instantOpen` resolves the solver from it to\n     * fill `partyBsWhiteList` — which is signed into the EIP-712 payload — and to\n     * pick the submit URL. Dropping it here would sign against the default\n     * solver's address while the quote was priced and sized for another.\n     */\n    solverId: parameters.solverId,\n    from: parameters.from,\n    subAccountAddress: parameters.subAccountAddress,\n    marketId: parameters.market.id,\n    positionType: parameters.positionType,\n    order: {\n      price: toWeiBigInt(tradeCalc.requestedOpenPrice),\n      quantity: toWeiBigInt(tradeCalc.quantity),\n    },\n    lockedParam: {\n      cva: toWeiBigInt(tradeCalc.cva),\n      lf: toWeiBigInt(tradeCalc.lf),\n      partyAmm: toWeiBigInt(tradeCalc.partyAmm),\n      partyBmm: toWeiBigInt(tradeCalc.partyBmm),\n    },\n    margin: {\n      amount: toWeiBigInt(marginAmount),\n    },\n    /** Only meaningful on a v0.8.6 chain — absent on v0.8.5, whose flow signs the legacy call. */\n    ...(needsSolverFeeCaps\n      ? {\n          solverFeeCaps: {\n            openRateCap: solverFeeCapToWei(\"minOpenSolverFeeCap\", market.minOpenSolverFeeCap),\n            closeRateCap: solverFeeCapToWei(\"minCloseSolverFeeCap\", market.minCloseSolverFeeCap),\n          },\n        }\n      : {}),\n    uuid: parameters.uuid,\n    addMarginSalt: parameters.addMarginSalt,\n    sendQuoteSalt: parameters.sendQuoteSalt,\n    deadline: parameters.deadline,\n  };\n}\n"],"mappings":"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"}

package/dist/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.d.ts

@@ -1,3 +1,4 @@
+import { SolverId } from '../../../../core/chains/types.js';
 import { Config } from '../../../../core/config/index.js';
 import { ApiLockedParamsBySymbolIdResponse } from '../../../types/generated/enigma-solver.js';
 import { ResolvedLockedParams } from './types.js';
@@ -6,6 +7,12 @@ import { ResolvedLockedParams } from './types.js';
  */
 export interface ResolveLockedParamsParameters {
     chainId?: number;
+    /**
+     * Solver whose locked params to read. **Must match the solver the trade is
+     * sent to** — `cva` / `lf` / `partyAmm` / `partyBmm` are encoded into the
+     * signed quote. Defaults to the chain's `defaultSolverId`.
+     */
+    solverId?: SolverId;
     marketName: string;
     leverage: number;
     /**

package/dist/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-locked-params.d.ts","sourceRoot":"","sources":["../../../../../src/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAsB/B"}
+{"version":3,"file":"resolve-locked-params.d.ts","sourceRoot":"","sources":["../../../../../src/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAuB/B"}

package/dist/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.js

@@ -10,6 +10,7 @@ async function t(t, n) {
 	};
 	let i = await e(t, {
 		chainId: n.chainId,
+		solverId: n.solverId,
 		symbol: n.marketName,
 		leverage: n.leverage
 	});

package/dist/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-locked-params.js","names":[],"sources":["../../../../../src/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.ts"],"sourcesContent":["import type { Config } from \"../../../../core/config\";\nimport { getLockedParams } from \"../../../locked-params/get-locked-params\";\nimport type { ApiLockedParamsBySymbolIdResponse } from \"../../../types/generated/enigma-solver\";\nimport type { ResolvedLockedParams } from \"./types\";\n\n/**\n * Parameters for {@link resolveLockedParams}.\n */\nexport interface ResolveLockedParamsParameters {\n  chainId?: number;\n  marketName: string;\n  leverage: number;\n  /**\n   * Pre-fetched solver locked params (matches `getLockedParams` return shape).\n   * When supplied with all four percent fields, the fetch is skipped.\n   */\n  lockedParamPercent?: ApiLockedParamsBySymbolIdResponse;\n}\n\n/**\n * Resolve solver locked-param percentages. When the caller supplies\n * `lockedParamPercent` with all four percent fields the fetch is skipped;\n * otherwise `getLockedParams` is called and missing fields default to `\"0\"`.\n */\nexport async function resolveLockedParams(\n  config: Config,\n  parameters: ResolveLockedParamsParameters,\n): Promise<ResolvedLockedParams> {\n  const supplied = parameters.lockedParamPercent;\n  if (\n    supplied?.cva !== undefined &&\n    supplied.lf !== undefined &&\n    supplied.partyAmm !== undefined &&\n    supplied.partyBmm !== undefined\n  ) {\n    return { cva: supplied.cva, lf: supplied.lf, partyAmm: supplied.partyAmm, partyBmm: supplied.partyBmm };\n  }\n\n  const locked = await getLockedParams(config, {\n    chainId: parameters.chainId,\n    symbol: parameters.marketName,\n    leverage: parameters.leverage,\n  });\n  return {\n    cva: locked.cva ?? \"0\",\n    lf: locked.lf ?? \"0\",\n    partyAmm: locked.partyAmm ?? \"0\",\n    partyBmm: locked.partyBmm ?? \"0\",\n  };\n}\n"],"mappings":";;AAwBA,eAAsB,EACpB,GACA,GAC+B;CAC/B,IAAM,IAAW,EAAW;CAC5B,IACE,GAAU,QAAQ,KAAA,KAClB,EAAS,OAAO,KAAA,KAChB,EAAS,aAAa,KAAA,KACtB,EAAS,aAAa,KAAA,GAEtB,OAAO;EAAE,KAAK,EAAS;EAAK,IAAI,EAAS;EAAI,UAAU,EAAS;EAAU,UAAU,EAAS;CAAS;CAGxG,IAAM,IAAS,MAAM,EAAgB,GAAQ;EAC3C,SAAS,EAAW;EACpB,QAAQ,EAAW;EACnB,UAAU,EAAW;CACvB,CAAC;CACD,OAAO;EACL,KAAK,EAAO,OAAO;EACnB,IAAI,EAAO,MAAM;EACjB,UAAU,EAAO,YAAY;EAC7B,UAAU,EAAO,YAAY;CAC/B;AACF"}
+{"version":3,"file":"resolve-locked-params.js","names":[],"sources":["../../../../../src/solvers/instant-open/prepare-instant-open-params/resolvers/resolve-locked-params.ts"],"sourcesContent":["import type { SolverId } from \"../../../../core/chains/types\";\nimport type { Config } from \"../../../../core/config\";\nimport { getLockedParams } from \"../../../locked-params/get-locked-params\";\nimport type { ApiLockedParamsBySymbolIdResponse } from \"../../../types/generated/enigma-solver\";\nimport type { ResolvedLockedParams } from \"./types\";\n\n/**\n * Parameters for {@link resolveLockedParams}.\n */\nexport interface ResolveLockedParamsParameters {\n  chainId?: number;\n  /**\n   * Solver whose locked params to read. **Must match the solver the trade is\n   * sent to** — `cva` / `lf` / `partyAmm` / `partyBmm` are encoded into the\n   * signed quote. Defaults to the chain's `defaultSolverId`.\n   */\n  solverId?: SolverId;\n  marketName: string;\n  leverage: number;\n  /**\n   * Pre-fetched solver locked params (matches `getLockedParams` return shape).\n   * When supplied with all four percent fields, the fetch is skipped.\n   */\n  lockedParamPercent?: ApiLockedParamsBySymbolIdResponse;\n}\n\n/**\n * Resolve solver locked-param percentages. When the caller supplies\n * `lockedParamPercent` with all four percent fields the fetch is skipped;\n * otherwise `getLockedParams` is called and missing fields default to `\"0\"`.\n */\nexport async function resolveLockedParams(\n  config: Config,\n  parameters: ResolveLockedParamsParameters,\n): Promise<ResolvedLockedParams> {\n  const supplied = parameters.lockedParamPercent;\n  if (\n    supplied?.cva !== undefined &&\n    supplied.lf !== undefined &&\n    supplied.partyAmm !== undefined &&\n    supplied.partyBmm !== undefined\n  ) {\n    return { cva: supplied.cva, lf: supplied.lf, partyAmm: supplied.partyAmm, partyBmm: supplied.partyBmm };\n  }\n\n  const locked = await getLockedParams(config, {\n    chainId: parameters.chainId,\n    solverId: parameters.solverId,\n    symbol: parameters.marketName,\n    leverage: parameters.leverage,\n  });\n  return {\n    cva: locked.cva ?? \"0\",\n    lf: locked.lf ?? \"0\",\n    partyAmm: locked.partyAmm ?? \"0\",\n    partyBmm: locked.partyBmm ?? \"0\",\n  };\n}\n"],"mappings":";;AA+BA,eAAsB,EACpB,GACA,GAC+B;CAC/B,IAAM,IAAW,EAAW;CAC5B,IACE,GAAU,QAAQ,KAAA,KAClB,EAAS,OAAO,KAAA,KAChB,EAAS,aAAa,KAAA,KACtB,EAAS,aAAa,KAAA,GAEtB,OAAO;EAAE,KAAK,EAAS;EAAK,IAAI,EAAS;EAAI,UAAU,EAAS;EAAU,UAAU,EAAS;CAAS;CAGxG,IAAM,IAAS,MAAM,EAAgB,GAAQ;EAC3C,SAAS,EAAW;EACpB,UAAU,EAAW;EACrB,QAAQ,EAAW;EACnB,UAAU,EAAW;CACvB,CAAC;CACD,OAAO;EACL,KAAK,EAAO,OAAO;EACnB,IAAI,EAAO,MAAM;EACjB,UAAU,EAAO,YAAY;EAC7B,UAAU,EAAO,YAAY;CAC/B;AACF"}

package/dist/solvers/instant-open/shared/calldata.d.ts

@@ -1,5 +1,5 @@
 import { Address, Hex } from 'viem';
-import { UpnlSig, VirtualAccountIsolationType } from './types.js';
+import { SolverFeeCaps, UpnlSig, VirtualAccountIsolationType } from './types.js';
 /**
  * Zeroed Muon oracle signature used by lowcap flows that bypass Muon verification.
  */
@@ -12,6 +12,11 @@ export declare const ZERO_UPNL_SIG: UpnlSig;
  * canonical price for the trade (the slippage-adjusted open price in wei)
  * is what callers pass here.
  *
+ * @remarks
+ * `reqId` is 32 zero bytes rather than `0x` so the encoded `upnlSig` region is
+ * the same size the solver expects when it fills a live signature into the
+ * delegated flex range.
+ *
  * @param priceWei - Trade price as 18-decimal fixed point (`bigint`).
  */
 export declare function getFakeSendQuoteMuonSignature(priceWei: bigint): UpnlSig;
@@ -68,14 +73,42 @@ export interface EncodeSendQuoteWithAffiliateAndDataParameters {
     upnlSig?: UpnlSig;
 }
 /**
- * Encode calldata for `Symmio.sendQuoteWithAffiliateAndData(...)`.
+ * Encode calldata for the legacy `Symmio.sendQuoteWithAffiliateAndData(...)`.
+ *
+ * Kept for the **Rasa** flow. On perps-core v0.8.6 this method remains
+ * available with its original selector but stores **zero solver-fee caps** —
+ * a solver that requires fee caps will not accept quotes sent through it; use
+ * {@link encodeSendQuote} for those (the Enigma flow does).
  *
  * Pass a real `upnlSig` for solvers requiring Muon verification, or omit to
  * default to {@link ZERO_UPNL_SIG} (lowcap).
  */
 export declare function encodeSendQuoteWithAffiliateAndData(parameters: EncodeSendQuoteWithAffiliateAndDataParameters): Hex;
 /**
- * Build the metadata blob attached to a `sendQuoteWithAffiliateAndData` call.
+ * Parameters for {@link encodeSendQuote}: the legacy parameter set plus the
+ * v0.8.6 solver-fee caps.
+ */
+export interface EncodeSendQuoteParameters extends EncodeSendQuoteWithAffiliateAndDataParameters {
+    /**
+     * Solver-fee rate caps authorized on the quote (18-decimal ratios). Defaults
+     * to zero caps — semantically identical to the legacy method, which a
+     * fee-charging solver may reject; fill from the market's
+     * `minOpenSolverFeeCap` / `minCloseSolverFeeCap`.
+     */
+    solverFeeCaps?: SolverFeeCaps;
+}
+/**
+ * Encode calldata for `Symmio.sendQuote(...)` — the perps-core v0.8.6 overload
+ * that carries `SolverFeeCaps` as its trailing argument. Identical to
+ * {@link encodeSendQuoteWithAffiliateAndData} otherwise.
+ *
+ * Pass a real `upnlSig` for solvers requiring Muon verification, or omit to
+ * default to {@link ZERO_UPNL_SIG} (lowcap).
+ */
+export declare function encodeSendQuote(parameters: EncodeSendQuoteParameters): Hex;
+/**
+ * Build the metadata blob attached to a quote-send call (`sendQuote`, or the
+ * legacy `sendQuoteWithAffiliateAndData`).
  *
  * Encodes a single-field tuple `{ uuid: string }` to ABI bytes — used by the
  * solver to track quote provenance.
@@ -83,4 +116,44 @@ export declare function encodeSendQuoteWithAffiliateAndData(parameters: EncodeSe
  * @param uuid - Opaque identifier (caller-controlled; usually `crypto.randomUUID()`).
  */
 export declare function buildQuoteMetadata(uuid: string): Hex;
+/**
+ * A contiguous calldata region, described the way the InstantLayer's `FlexField`
+ * expects it.
+ */
+export interface SendQuoteUpnlSigFlexRange {
+    /**
+     * Args-relative byte offset where the region starts — measured **after** the
+     * 4-byte function selector, matching the on-chain `FlexField.offset` contract.
+     */
+    offset: bigint;
+    /** Region size in bytes. */
+    length: bigint;
+}
+/**
+ * Locate the encoded `upnlSig` region inside `sendQuote` calldata, so it can be
+ * delegated to a solver via a `FlexField`.
+ *
+ * Lowcap solvers sign the quote with a placeholder signature
+ * ({@link getFakeSendQuoteMuonSignature}) and authorize the solver to overwrite
+ * this exact range with a live Muon attestation at execution time. Solvers that
+ * require the caller to supply a real signature (majors) do not need this.
+ *
+ * The region is `[head[upnlSig], head[data])` — `upnlSig` and `data` are both
+ * dynamic and adjacent in argument order, so `data`'s tail pointer marks the end
+ * of the signature's tail. The offset therefore varies with earlier dynamic
+ * arguments (notably `partyBsWhiteList` length) and must never be hardcoded.
+ *
+ * @param callData - Encoded `sendQuote` calldata.
+ * @returns The `upnlSig` region as an args-relative offset and byte length.
+ * @throws {SymmError} when `callData` is too short to contain both head words,
+ *   or the pointers are not ordered as the encoding guarantees.
+ *
+ * @example
+ * ```ts
+ * const callData = encodeSendQuote({ …, upnlSig: fakeSig });
+ * const range = sendQuoteUpnlSigFlexRange(callData);
+ * buildSignedOperation({ …, callData, flexFields: [{ ...range, authorizedFlexFiller: solver.address }] });
+ * ```
+ */
+export declare function sendQuoteUpnlSigFlexRange(callData: Hex): SendQuoteUpnlSigFlexRange;
 //# sourceMappingURL=calldata.d.ts.map

package/dist/solvers/instant-open/shared/calldata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calldata.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/shared/calldata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwD,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAGpG,OAAO,KAAK,EAAE,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAO3B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASvE;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,aAAa,EAAE,2BAA2B,CAAC;IAC3C,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,iCAAiC,GAAG,GAAG,CAM1F;AAED;;GAEG;AACH,MAAM,WAAW,6CAA6C;IAC5D,gCAAgC;IAChC,gBAAgB,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,IAAI,EAAE,GAAG,CAAC;IACV,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,6CAA6C,GAAG,GAAG,CAiClH;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAEpD"}
+{"version":3,"file":"calldata.d.ts","sourceRoot":"","sources":["../../../../src/solvers/instant-open/shared/calldata.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAId,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAO3B,CAAC;AAYF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASvE;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,aAAa,EAAE,2BAA2B,CAAC;IAC3C,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,iCAAiC,GAAG,GAAG,CAM1F;AAED;;GAEG;AACH,MAAM,WAAW,6CAA6C;IAC5D,gCAAgC;IAChC,gBAAgB,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,IAAI,EAAE,GAAG,CAAC;IACV,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,6CAA6C,GAAG,GAAG,CAiClH;AAKD;;;GAGG;AACH,MAAM,WAAW,yBAA0B,SAAQ,6CAA6C;IAC9F;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,yBAAyB,GAAG,GAAG,CAmC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAEpD;AAyCD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,GAAG,GAAG,yBAAyB,CA6BlF"}