@symmio/trading-core 1.1.0 → 2.0.0

package/dist/symmio-contracts/account-layer/calculate-available-for-order.d.ts

@@ -0,0 +1,39 @@
+import { AccountBalanceInfo } from './types.js';
+/**
+ * Inputs for {@link calculateAvailableForOrder}. All amounts are the raw
+ * 18-decimal wei `bigint`s the balance-info read returns.
+ */
+export interface CalculateAvailableForOrderParameters {
+    /** The account's `balanceInfoOfPartyA` snapshot. */
+    balanceInfo: AccountBalanceInfo;
+    /** Account-level unrealized PnL, signed wei. */
+    upnl: bigint;
+}
+/**
+ * Collateral a cross-margin (majors) account can still commit to a **new
+ * order**, mirroring the reference trade panel's formula.
+ *
+ * With `totalPending = Σ pending locked legs (cva + lf + partyAmm + partyBmm)`:
+ *
+ * - `upnl ≥ 0`:
+ *   `allocatedBalance + upnl − (lockedCVA + lockedLF + lockedPartyAMM) − totalPending`
+ * - `upnl < 0`:
+ *   `allocatedBalance − lockedCVA − lockedLF − totalPending − max(−upnl, lockedPartyAMM)`
+ *
+ * The negative branch charges the **larger** of the loss and the maintenance
+ * margin: the MM absorbs drawdown first, so the loss only starts reducing the
+ * spendable balance beyond what the MM already reserves — never both in full.
+ *
+ * Can return a negative value when the account is under water; clamp at the
+ * call site if a floor of zero is wanted for display.
+ *
+ * @param parameters - Balance snapshot and signed account uPnL.
+ * @returns The spendable collateral for a new order, signed wei.
+ *
+ * @example
+ * ```ts
+ * const available = calculateAvailableForOrder({ balanceInfo, upnl: attestation.uPnl });
+ * ```
+ */
+export declare function calculateAvailableForOrder(parameters: CalculateAvailableForOrderParameters): bigint;
+//# sourceMappingURL=calculate-available-for-order.d.ts.map

package/dist/symmio-contracts/account-layer/calculate-available-for-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-available-for-order.d.ts","sourceRoot":"","sources":["../../../src/symmio-contracts/account-layer/calculate-available-for-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,oCAAoC;IACnD,oDAAoD;IACpD,WAAW,EAAE,kBAAkB,CAAC;IAChC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,oCAAoC,GAAG,MAAM,CAuBnG"}

package/dist/symmio-contracts/account-layer/calculate-available-for-order.js

@@ -0,0 +1,14 @@
+//#region src/symmio-contracts/account-layer/calculate-available-for-order.ts
+function e(e) {
+	let { balanceInfo: t, upnl: n } = e, { allocatedBalance: r, lockedCVA: i, lockedLF: a, lockedPartyAMM: o, pendingLockedCVA: s, pendingLockedLF: c, pendingLockedPartyAMM: l, pendingLockedPartyBMM: u } = t, d = s + c + l + u;
+	if (n >= 0n) {
+		let e = i + a + o;
+		return r + n - e - d;
+	}
+	let f = -n, p = f > o ? f : o;
+	return r - i - a - d - p;
+}
+//#endregion
+export { e as calculateAvailableForOrder };
+
+//# sourceMappingURL=calculate-available-for-order.js.map

package/dist/symmio-contracts/account-layer/calculate-available-for-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-available-for-order.js","names":[],"sources":["../../../src/symmio-contracts/account-layer/calculate-available-for-order.ts"],"sourcesContent":["import type { AccountBalanceInfo } from \"./types\";\n\n/**\n * Inputs for {@link calculateAvailableForOrder}. All amounts are the raw\n * 18-decimal wei `bigint`s the balance-info read returns.\n */\nexport interface CalculateAvailableForOrderParameters {\n  /** The account's `balanceInfoOfPartyA` snapshot. */\n  balanceInfo: AccountBalanceInfo;\n  /** Account-level unrealized PnL, signed wei. */\n  upnl: bigint;\n}\n\n/**\n * Collateral a cross-margin (majors) account can still commit to a **new\n * order**, mirroring the reference trade panel's formula.\n *\n * With `totalPending = Σ pending locked legs (cva + lf + partyAmm + partyBmm)`:\n *\n * - `upnl ≥ 0`:\n *   `allocatedBalance + upnl − (lockedCVA + lockedLF + lockedPartyAMM) − totalPending`\n * - `upnl < 0`:\n *   `allocatedBalance − lockedCVA − lockedLF − totalPending − max(−upnl, lockedPartyAMM)`\n *\n * The negative branch charges the **larger** of the loss and the maintenance\n * margin: the MM absorbs drawdown first, so the loss only starts reducing the\n * spendable balance beyond what the MM already reserves — never both in full.\n *\n * Can return a negative value when the account is under water; clamp at the\n * call site if a floor of zero is wanted for display.\n *\n * @param parameters - Balance snapshot and signed account uPnL.\n * @returns The spendable collateral for a new order, signed wei.\n *\n * @example\n * ```ts\n * const available = calculateAvailableForOrder({ balanceInfo, upnl: attestation.uPnl });\n * ```\n */\nexport function calculateAvailableForOrder(parameters: CalculateAvailableForOrderParameters): bigint {\n  const { balanceInfo, upnl } = parameters;\n  const {\n    allocatedBalance,\n    lockedCVA,\n    lockedLF,\n    lockedPartyAMM,\n    pendingLockedCVA,\n    pendingLockedLF,\n    pendingLockedPartyAMM,\n    pendingLockedPartyBMM,\n  } = balanceInfo;\n\n  const totalPendingLocked = pendingLockedCVA + pendingLockedLF + pendingLockedPartyAMM + pendingLockedPartyBMM;\n\n  if (upnl >= 0n) {\n    const totalLocked = lockedCVA + lockedLF + lockedPartyAMM;\n    return allocatedBalance + upnl - totalLocked - totalPendingLocked;\n  }\n\n  const loss = -upnl;\n  const consideringMM = loss > lockedPartyAMM ? loss : lockedPartyAMM;\n  return allocatedBalance - lockedCVA - lockedLF - totalPendingLocked - consideringMM;\n}\n"],"mappings":";AAuCA,SAAgB,EAA2B,GAA0D;CACnG,IAAM,EAAE,gBAAa,YAAS,GACxB,EACJ,qBACA,cACA,aACA,mBACA,qBACA,oBACA,0BACA,6BACE,GAEE,IAAqB,IAAmB,IAAkB,IAAwB;CAExF,IAAI,KAAQ,IAAI;EACd,IAAM,IAAc,IAAY,IAAW;EAC3C,OAAO,IAAmB,IAAO,IAAc;CACjD;CAEA,IAAM,IAAO,CAAC,GACR,IAAgB,IAAO,IAAiB,IAAO;CACrD,OAAO,IAAmB,IAAY,IAAW,IAAqB;AACxE"}

package/dist/symmio-contracts/account-layer/index.d.ts

@@ -28,6 +28,7 @@ export * from './actions/simulate-deposit-for-account.js';
 export * from './actions/simulate-edit-account-name.js';
 export * from './actions/simulate-remove-margin.js';
 export * from './actions/simulate-request-to-register-affiliate.js';
+export * from './calculate-available-for-order.js';
 export * from './query/add-margin.js';
 export * from './query/cancel-registration.js';
 export * from './query/create-sub-accounts.js';

package/dist/symmio-contracts/account-layer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/symmio-contracts/account-layer/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yDAAyD,CAAC;AACxE,cAAc,wCAAwC,CAAC;AACvD,cAAc,yBAAyB,CAAC;AACxC,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qDAAqD,CAAC;AACpE,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kDAAkD,CAAC;AACjE,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uDAAuD,CAAC;AACtE,cAAc,sCAAsC,CAAC;AACrD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mDAAmD,CAAC;AAClE,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gDAAgD,CAAC;AAC/D,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/symmio-contracts/account-layer/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yDAAyD,CAAC;AACxE,cAAc,wCAAwC,CAAC;AACvD,cAAc,yBAAyB,CAAC;AACxC,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qDAAqD,CAAC;AACpE,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kDAAkD,CAAC;AACjE,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uDAAuD,CAAC;AACtE,cAAc,sCAAsC,CAAC;AACrD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mDAAmD,CAAC;AAClE,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gDAAgD,CAAC;AAC/D,cAAc,SAAS,CAAC"}

package/dist/symmio-contracts/symmio/actions/deallocate-and-initiate-withdraw.d.ts

@@ -0,0 +1,95 @@
+import { Address, Hash, Hex } from 'viem';
+import { Config } from '../../../core/config/index.js';
+import { Compute, WriteContractParameter } from '../../../shared/types/properties.js';
+import { SingleUpnlSig } from '../../account-layer/types.js';
+import { WithdrawReceiverPart } from '../types.js';
+/**
+ * Parameters for {@link deallocateAndInitiateWithdraw}.
+ */
+export type DeallocateAndInitiateWithdrawParameters = Compute<WriteContractParameter & {
+    /**
+     * The subaccount to deallocate from and initiate the withdrawal for. Both
+     * inner calls are routed through the AccountLayer `_call` proxy so the core
+     * attributes them to this subaccount; the connected wallet must be its
+     * on-chain `owner`.
+     */
+    account: Address;
+    /**
+     * Amount to move from the allocated balance back into the available balance,
+     * in **18 decimals** (not the collateral token's decimals). This is the
+     * `deallocate` leg; the freed collateral is what the withdrawal then requests.
+     */
+    amount: bigint;
+    /**
+     * The receiver parts the withdrawal is split into. A plain same-chain
+     * withdrawal is a single part with both provider fields set to the zero
+     * address — see `createClassicWithdrawPart`.
+     */
+    parts: readonly WithdrawReceiverPart[];
+    /**
+     * Opt into the cooldown speed-up flow. Only effective for speed-up-eligible
+     * users; ignored otherwise.
+     * @default false
+     */
+    speedUp?: boolean;
+    /**
+     * Opaque provider data forwarded to express/virtual providers (e.g. a signed
+     * option). Pass `0x` for a classic withdrawal.
+     * @default "0x"
+     */
+    providerData?: Hex;
+    /**
+     * A fresh Muon uPnL (`uPnl_A`) attestation for `account`, required by the
+     * `deallocate` leg to prove the subaccount stays solvent. It is timestamped
+     * and short-lived, so **omit it** to have the action fetch a fresh one (via
+     * {@link getDeallocateUpnlSig}) immediately before submitting; pass one only
+     * to reuse a signature you already fetched.
+     */
+    upnlSig?: SingleUpnlSig;
+}>;
+/** Return type of {@link deallocateAndInitiateWithdraw}: the submitted transaction hash. */
+export type DeallocateAndInitiateWithdrawReturnType = Hash;
+/**
+ * Batch a subaccount's **deallocate** and **initiate-withdraw** into a single
+ * atomic transaction — the cross-margin / Base withdraw path.
+ *
+ * Encodes the SYMMIO core `deallocate(amount, upnlSig)` and
+ * `initiateWithdraw(parts, speedUp, data)` calls and routes **both** through one
+ * `AccountLayer._call(account, [deallocateData, withdrawData])`. `_call` runs the
+ * calldatas in order in a single transaction and reverts the whole transaction if
+ * any inner call reverts, so the two legs are all-or-nothing: the caller never
+ * ends up with a deallocation that failed to produce its withdraw request.
+ *
+ * **Order matters.** `deallocate` (allocated → available) is encoded first so the
+ * freed collateral exists in the available balance before `initiateWithdraw`
+ * requests it.
+ *
+ * @remarks
+ * The `deallocate` leg is subject to the on-chain **deallocate debounce** and
+ * requires a fresh Muon `upnlSig`; a stale attestation or too-soon a call reverts
+ * the whole batch. Dry-runs the batched `_call` with the pre-flight simulation
+ * first unless `simulateBeforeWrite` is `false` (per-call, falling back to the
+ * config default). For separate control over the two legs, call {@link deallocate}
+ * and {@link initiateWithdraw} individually.
+ *
+ * @param config - The SDK config (must have a `getWalletClient` resolver).
+ * @param parameters - Subaccount, amount (18 decimals), receiver parts, optional
+ *   speed-up / provider data, optional Muon `upnlSig` (fetched automatically via
+ *   {@link getDeallocateUpnlSig} when omitted), optional chain id.
+ * @returns The submitted transaction hash. The caller waits on the receipt.
+ * @throws {SymmError} when the chain is unsupported or no wallet is available.
+ * @throws Viem's write errors (`ContractFunctionExecutionError`, ...).
+ *
+ * @example
+ * ```ts
+ * const part = createClassicWithdrawPart({ id: 0n, amount: 1_000000n, receiver: "0xabc…", chainId: 999n });
+ * // upnlSig fetched automatically:
+ * const hash = await deallocateAndInitiateWithdraw(config, {
+ *   account: "0xsub…",
+ *   amount: 1_000000000000000000n,
+ *   parts: [part],
+ * });
+ * ```
+ */
+export declare function deallocateAndInitiateWithdraw(config: Config, parameters: DeallocateAndInitiateWithdrawParameters): Promise<DeallocateAndInitiateWithdrawReturnType>;
+//# sourceMappingURL=deallocate-and-initiate-withdraw.d.ts.map

package/dist/symmio-contracts/symmio/actions/deallocate-and-initiate-withdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deallocate-and-initiate-withdraw.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/deallocate-and-initiate-withdraw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAExF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,uCAAuC,GAAG,OAAO,CAC3D,sBAAsB,GAAG;IACvB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CACF,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,uCAAuC,GAAG,IAAI,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,uCAAuC,GAClD,OAAO,CAAC,uCAAuC,CAAC,CAyBlD"}

package/dist/symmio-contracts/symmio/actions/deallocate-and-initiate-withdraw.js

@@ -0,0 +1,34 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+import { callAsSubAccount as t } from "../internal/call-as-sub-account.js";
+import { getDeallocateUpnlSig as n } from "../../../muon/deallocate-upnl-sig/get-deallocate-upnl-sig.js";
+import { encodeFunctionData as r } from "viem";
+//#region src/symmio-contracts/symmio/actions/deallocate-and-initiate-withdraw.ts
+async function i(i, a) {
+	let { chainId: o, account: s, amount: c, parts: l, speedUp: u = !1, providerData: d = "0x", from: f } = a;
+	return t(i, {
+		account: s,
+		data: [r({
+			abi: e,
+			functionName: "deallocate",
+			args: [c, a.upnlSig ?? await n(i, {
+				virtualAccount: s,
+				chainId: o
+			})]
+		}), r({
+			abi: e,
+			functionName: "initiateWithdraw",
+			args: [
+				l,
+				u,
+				d
+			]
+		})],
+		chainId: o,
+		from: f,
+		simulateBeforeWrite: a.simulateBeforeWrite
+	});
+}
+//#endregion
+export { i as deallocateAndInitiateWithdraw };
+
+//# sourceMappingURL=deallocate-and-initiate-withdraw.js.map

package/dist/symmio-contracts/symmio/actions/deallocate-and-initiate-withdraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deallocate-and-initiate-withdraw.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/deallocate-and-initiate-withdraw.ts"],"sourcesContent":["import { encodeFunctionData, type Address, type Hash, type Hex } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport { getDeallocateUpnlSig } from \"../../../muon/deallocate-upnl-sig/get-deallocate-upnl-sig\";\nimport type { Compute, WriteContractParameter } from \"../../../shared/types/properties\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\nimport type { SingleUpnlSig } from \"../../account-layer/types\";\nimport { callAsSubAccount } from \"../internal/call-as-sub-account\";\nimport type { WithdrawReceiverPart } from \"../types\";\n\n/**\n * Parameters for {@link deallocateAndInitiateWithdraw}.\n */\nexport type DeallocateAndInitiateWithdrawParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount to deallocate from and initiate the withdrawal for. Both\n     * inner calls are routed through the AccountLayer `_call` proxy so the core\n     * attributes them to this subaccount; the connected wallet must be its\n     * on-chain `owner`.\n     */\n    account: Address;\n    /**\n     * Amount to move from the allocated balance back into the available balance,\n     * in **18 decimals** (not the collateral token's decimals). This is the\n     * `deallocate` leg; the freed collateral is what the withdrawal then requests.\n     */\n    amount: bigint;\n    /**\n     * The receiver parts the withdrawal is split into. A plain same-chain\n     * withdrawal is a single part with both provider fields set to the zero\n     * address — see `createClassicWithdrawPart`.\n     */\n    parts: readonly WithdrawReceiverPart[];\n    /**\n     * Opt into the cooldown speed-up flow. Only effective for speed-up-eligible\n     * users; ignored otherwise.\n     * @default false\n     */\n    speedUp?: boolean;\n    /**\n     * Opaque provider data forwarded to express/virtual providers (e.g. a signed\n     * option). Pass `0x` for a classic withdrawal.\n     * @default \"0x\"\n     */\n    providerData?: Hex;\n    /**\n     * A fresh Muon uPnL (`uPnl_A`) attestation for `account`, required by the\n     * `deallocate` leg to prove the subaccount stays solvent. It is timestamped\n     * and short-lived, so **omit it** to have the action fetch a fresh one (via\n     * {@link getDeallocateUpnlSig}) immediately before submitting; pass one only\n     * to reuse a signature you already fetched.\n     */\n    upnlSig?: SingleUpnlSig;\n  }\n>;\n\n/** Return type of {@link deallocateAndInitiateWithdraw}: the submitted transaction hash. */\nexport type DeallocateAndInitiateWithdrawReturnType = Hash;\n\n/**\n * Batch a subaccount's **deallocate** and **initiate-withdraw** into a single\n * atomic transaction — the cross-margin / Base withdraw path.\n *\n * Encodes the SYMMIO core `deallocate(amount, upnlSig)` and\n * `initiateWithdraw(parts, speedUp, data)` calls and routes **both** through one\n * `AccountLayer._call(account, [deallocateData, withdrawData])`. `_call` runs the\n * calldatas in order in a single transaction and reverts the whole transaction if\n * any inner call reverts, so the two legs are all-or-nothing: the caller never\n * ends up with a deallocation that failed to produce its withdraw request.\n *\n * **Order matters.** `deallocate` (allocated → available) is encoded first so the\n * freed collateral exists in the available balance before `initiateWithdraw`\n * requests it.\n *\n * @remarks\n * The `deallocate` leg is subject to the on-chain **deallocate debounce** and\n * requires a fresh Muon `upnlSig`; a stale attestation or too-soon a call reverts\n * the whole batch. Dry-runs the batched `_call` with the pre-flight simulation\n * first unless `simulateBeforeWrite` is `false` (per-call, falling back to the\n * config default). For separate control over the two legs, call {@link deallocate}\n * and {@link initiateWithdraw} individually.\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - Subaccount, amount (18 decimals), receiver parts, optional\n *   speed-up / provider data, optional Muon `upnlSig` (fetched automatically via\n *   {@link getDeallocateUpnlSig} when omitted), optional chain id.\n * @returns The submitted transaction hash. The caller waits on the receipt.\n * @throws {SymmError} when the chain is unsupported or no wallet is available.\n * @throws Viem's write errors (`ContractFunctionExecutionError`, ...).\n *\n * @example\n * ```ts\n * const part = createClassicWithdrawPart({ id: 0n, amount: 1_000000n, receiver: \"0xabc…\", chainId: 999n });\n * // upnlSig fetched automatically:\n * const hash = await deallocateAndInitiateWithdraw(config, {\n *   account: \"0xsub…\",\n *   amount: 1_000000000000000000n,\n *   parts: [part],\n * });\n * ```\n */\nexport async function deallocateAndInitiateWithdraw(\n  config: Config,\n  parameters: DeallocateAndInitiateWithdrawParameters,\n): Promise<DeallocateAndInitiateWithdrawReturnType> {\n  const { chainId, account, amount, parts, speedUp = false, providerData = \"0x\", from } = parameters;\n\n  const upnlSig = parameters.upnlSig ?? (await getDeallocateUpnlSig(config, { virtualAccount: account, chainId }));\n\n  const deallocateData = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"deallocate\",\n    args: [amount, upnlSig],\n  });\n\n  const withdrawData = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"initiateWithdraw\",\n    args: [parts, speedUp, providerData],\n  });\n\n  // Order matters: deallocate (allocated → available) MUST precede initiateWithdraw.\n  return callAsSubAccount(config, {\n    account,\n    data: [deallocateData, withdrawData],\n    chainId,\n    from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;;AAqGA,eAAsB,EACpB,GACA,GACkD;CAClD,IAAM,EAAE,YAAS,YAAS,WAAQ,UAAO,aAAU,IAAO,kBAAe,MAAM,YAAS;CAiBxF,OAAO,EAAiB,GAAQ;EAC9B;EACA,MAAM,CAfe,EAAmB;GACxC,KAAK;GACL,cAAc;GACd,MAAM,CAAC,GALO,EAAW,WAAY,MAAM,EAAqB,GAAQ;IAAE,gBAAgB;IAAS;GAAQ,CAAC,CAKtF;EACxB,CAWS,GATY,EAAmB;GACtC,KAAK;GACL,cAAc;GACd,MAAM;IAAC;IAAO;IAAS;GAAY;EACrC,CAKyB,CAAY;EACnC;EACA;EACA,qBAAqB,EAAW;CAClC,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/deallocate.d.ts

@@ -19,10 +19,11 @@ export type DeallocateParameters = Compute<WriteContractParameter & {
     /**
      * A fresh Muon uPnL (`uPnl_A`) attestation for `account`. The contract
      * verifies it to prove the subaccount stays solvent after the deallocation.
-     * Fetch one right before submitting (it is timestamped and short-lived) — see
-     * {@link getDeallocateUpnlSig}.
+     * It is timestamped and short-lived, so **omit it** to have the action fetch a
+     * fresh one (via {@link getDeallocateUpnlSig}) immediately before submitting;
+     * pass one only to reuse a signature you already fetched.
      */
-    upnlSig: SingleUpnlSig;
+    upnlSig?: SingleUpnlSig;
 }>;
 /** Return type of {@link deallocate}: the submitted transaction hash. */
 export type DeallocateReturnType = Hash;
@@ -48,15 +49,19 @@ export type DeallocateReturnType = Hash;
  * is `false` (per-call, falling back to the config default).
  *
  * @param config - The SDK config (must have a `getWalletClient` resolver).
- * @param parameters - Subaccount, amount (18 decimals), Muon `upnlSig`, optional chain id.
+ * @param parameters - Subaccount, amount (18 decimals), optional Muon `upnlSig`
+ *   (fetched automatically via {@link getDeallocateUpnlSig} when omitted), optional chain id.
  * @returns The submitted transaction hash. The caller waits on the receipt.
  * @throws {SymmError} when the chain is unsupported or no wallet is available.
  * @throws Viem's write errors (`ContractFunctionExecutionError`, ...).
  *
  * @example
  * ```ts
+ * // upnlSig fetched automatically:
+ * const hash = await deallocate(config, { account: "0xsub…", amount: 1_000000000000000000n });
+ * // or reuse a pre-fetched signature:
  * const upnlSig = await getDeallocateUpnlSig(config, { virtualAccount: "0xsub…" });
- * const hash = await deallocate(config, { account: "0xsub…", amount: 1_000000000000000000n, upnlSig });
+ * await deallocate(config, { account: "0xsub…", amount: 1_000000000000000000n, upnlSig });
  * ```
  */
 export declare function deallocate(config: Config, parameters: DeallocateParameters): Promise<DeallocateReturnType>;

package/dist/symmio-contracts/symmio/actions/deallocate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deallocate.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/deallocate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAExF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,sBAAsB,GAAG;IACvB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,EAAE,aAAa,CAAC;CACxB,CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgBhH"}
+{"version":3,"file":"deallocate.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/deallocate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAExF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,sBAAsB,GAAG;IACvB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmBhH"}

package/dist/symmio-contracts/symmio/actions/deallocate.js

@@ -1,22 +1,26 @@
 import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
 import { callAsSubAccount as t } from "../internal/call-as-sub-account.js";
-import { encodeFunctionData as n } from "viem";
+import { getDeallocateUpnlSig as n } from "../../../muon/deallocate-upnl-sig/get-deallocate-upnl-sig.js";
+import { encodeFunctionData as r } from "viem";
 //#region src/symmio-contracts/symmio/actions/deallocate.ts
-async function r(r, i) {
-	let { chainId: a, account: o, amount: s, upnlSig: c } = i;
-	return t(r, {
-		account: o,
-		data: n({
+async function i(i, a) {
+	let { chainId: o, account: s, amount: c } = a;
+	return t(i, {
+		account: s,
+		data: r({
 			abi: e,
 			functionName: "deallocate",
-			args: [s, c]
+			args: [c, a.upnlSig ?? await n(i, {
+				virtualAccount: a.account,
+				chainId: o
+			})]
 		}),
-		chainId: a,
-		from: i.from,
-		simulateBeforeWrite: i.simulateBeforeWrite
+		chainId: o,
+		from: a.from,
+		simulateBeforeWrite: a.simulateBeforeWrite
 	});
 }
 //#endregion
-export { r as deallocate };
+export { i as deallocate };
 
 //# sourceMappingURL=deallocate.js.map

package/dist/symmio-contracts/symmio/actions/deallocate.js.map

@@ -1 +1 @@
-{"version":3,"file":"deallocate.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/deallocate.ts"],"sourcesContent":["import { encodeFunctionData, type Address, type Hash } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport type { Compute, WriteContractParameter } from \"../../../shared/types/properties\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\nimport type { SingleUpnlSig } from \"../../account-layer/types\";\nimport { callAsSubAccount } from \"../internal/call-as-sub-account\";\n\n/**\n * Parameters for {@link deallocate}.\n */\nexport type DeallocateParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount to deallocate from. The call is routed through the\n     * AccountLayer `_call` proxy; the connected wallet must be its on-chain `owner`.\n     */\n    account: Address;\n    /**\n     * Amount to move from the allocated balance back into the available balance,\n     * in **18 decimals** (not the collateral token's decimals).\n     */\n    amount: bigint;\n    /**\n     * A fresh Muon uPnL (`uPnl_A`) attestation for `account`. The contract\n     * verifies it to prove the subaccount stays solvent after the deallocation.\n     * Fetch one right before submitting (it is timestamped and short-lived) — see\n     * {@link getDeallocateUpnlSig}.\n     */\n    upnlSig: SingleUpnlSig;\n  }\n>;\n\n/** Return type of {@link deallocate}: the submitted transaction hash. */\nexport type DeallocateReturnType = Hash;\n\n/**\n * Move collateral from a subaccount's **allocated (tradeable) balance** back into\n * its **available balance** on the SYMMIO core.\n *\n * The reverse of {@link allocate}: the subaccount's allocated balance is debited\n * and its available balance credited, in 18-decimal units, after the contract\n * verifies the Muon uPnL signature keeps the subaccount solvent. The freed\n * collateral can then be withdrawn (subject to the separate withdraw cooldown).\n *\n * Encodes the SYMMIO core `deallocate(amount, upnlSig)` call and routes it through\n * `AccountLayer._call(account, …)` so the core attributes it to the subaccount.\n *\n * @remarks\n * Subject to the on-chain **deallocate debounce**: calling too soon after a prior\n * deallocate reverts (\"Too many deallocate in a short window\"). This is distinct\n * from the withdraw cooldown that later gates moving the freed collateral to the\n * wallet. The `upnlSig` must be freshly fetched — a stale attestation reverts.\n *\n * Dry-runs the call with {@link simulateDeallocate} first unless `simulateBeforeWrite`\n * is `false` (per-call, falling back to the config default).\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - Subaccount, amount (18 decimals), Muon `upnlSig`, optional chain id.\n * @returns The submitted transaction hash. The caller waits on the receipt.\n * @throws {SymmError} when the chain is unsupported or no wallet is available.\n * @throws Viem's write errors (`ContractFunctionExecutionError`, ...).\n *\n * @example\n * ```ts\n * const upnlSig = await getDeallocateUpnlSig(config, { virtualAccount: \"0xsub…\" });\n * const hash = await deallocate(config, { account: \"0xsub…\", amount: 1_000000000000000000n, upnlSig });\n * ```\n */\nexport async function deallocate(config: Config, parameters: DeallocateParameters): Promise<DeallocateReturnType> {\n  const { chainId, account, amount, upnlSig } = parameters;\n\n  const data = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"deallocate\",\n    args: [amount, upnlSig],\n  });\n\n  return callAsSubAccount(config, {\n    account,\n    data,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;AAoEA,eAAsB,EAAW,GAAgB,GAAiE;CAChH,IAAM,EAAE,YAAS,YAAS,WAAQ,eAAY;CAQ9C,OAAO,EAAiB,GAAQ;EAC9B;EACA,MARW,EAAmB;GAC9B,KAAK;GACL,cAAc;GACd,MAAM,CAAC,GAAQ,CAAO;EACxB,CAIE;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;CAClC,CAAC;AACH"}
+{"version":3,"file":"deallocate.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/deallocate.ts"],"sourcesContent":["import { encodeFunctionData, type Address, type Hash } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport { getDeallocateUpnlSig } from \"../../../muon/deallocate-upnl-sig/get-deallocate-upnl-sig\";\nimport type { Compute, WriteContractParameter } from \"../../../shared/types/properties\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\nimport type { SingleUpnlSig } from \"../../account-layer/types\";\nimport { callAsSubAccount } from \"../internal/call-as-sub-account\";\n\n/**\n * Parameters for {@link deallocate}.\n */\nexport type DeallocateParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount to deallocate from. The call is routed through the\n     * AccountLayer `_call` proxy; the connected wallet must be its on-chain `owner`.\n     */\n    account: Address;\n    /**\n     * Amount to move from the allocated balance back into the available balance,\n     * in **18 decimals** (not the collateral token's decimals).\n     */\n    amount: bigint;\n    /**\n     * A fresh Muon uPnL (`uPnl_A`) attestation for `account`. The contract\n     * verifies it to prove the subaccount stays solvent after the deallocation.\n     * It is timestamped and short-lived, so **omit it** to have the action fetch a\n     * fresh one (via {@link getDeallocateUpnlSig}) immediately before submitting;\n     * pass one only to reuse a signature you already fetched.\n     */\n    upnlSig?: SingleUpnlSig;\n  }\n>;\n\n/** Return type of {@link deallocate}: the submitted transaction hash. */\nexport type DeallocateReturnType = Hash;\n\n/**\n * Move collateral from a subaccount's **allocated (tradeable) balance** back into\n * its **available balance** on the SYMMIO core.\n *\n * The reverse of {@link allocate}: the subaccount's allocated balance is debited\n * and its available balance credited, in 18-decimal units, after the contract\n * verifies the Muon uPnL signature keeps the subaccount solvent. The freed\n * collateral can then be withdrawn (subject to the separate withdraw cooldown).\n *\n * Encodes the SYMMIO core `deallocate(amount, upnlSig)` call and routes it through\n * `AccountLayer._call(account, …)` so the core attributes it to the subaccount.\n *\n * @remarks\n * Subject to the on-chain **deallocate debounce**: calling too soon after a prior\n * deallocate reverts (\"Too many deallocate in a short window\"). This is distinct\n * from the withdraw cooldown that later gates moving the freed collateral to the\n * wallet. The `upnlSig` must be freshly fetched — a stale attestation reverts.\n *\n * Dry-runs the call with {@link simulateDeallocate} first unless `simulateBeforeWrite`\n * is `false` (per-call, falling back to the config default).\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - Subaccount, amount (18 decimals), optional Muon `upnlSig`\n *   (fetched automatically via {@link getDeallocateUpnlSig} when omitted), optional chain id.\n * @returns The submitted transaction hash. The caller waits on the receipt.\n * @throws {SymmError} when the chain is unsupported or no wallet is available.\n * @throws Viem's write errors (`ContractFunctionExecutionError`, ...).\n *\n * @example\n * ```ts\n * // upnlSig fetched automatically:\n * const hash = await deallocate(config, { account: \"0xsub…\", amount: 1_000000000000000000n });\n * // or reuse a pre-fetched signature:\n * const upnlSig = await getDeallocateUpnlSig(config, { virtualAccount: \"0xsub…\" });\n * await deallocate(config, { account: \"0xsub…\", amount: 1_000000000000000000n, upnlSig });\n * ```\n */\nexport async function deallocate(config: Config, parameters: DeallocateParameters): Promise<DeallocateReturnType> {\n  const { chainId, account, amount } = parameters;\n\n  const upnlSig =\n    parameters.upnlSig ?? (await getDeallocateUpnlSig(config, { virtualAccount: parameters.account, chainId }));\n\n  const data = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"deallocate\",\n    args: [amount, upnlSig],\n  });\n\n  return callAsSubAccount(config, {\n    account,\n    data,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;;AA0EA,eAAsB,EAAW,GAAgB,GAAiE;CAChH,IAAM,EAAE,YAAS,YAAS,cAAW;CAWrC,OAAO,EAAiB,GAAQ;EAC9B;EACA,MARW,EAAmB;GAC9B,KAAK;GACL,cAAc;GACd,MAAM,CAAC,GALP,EAAW,WAAY,MAAM,EAAqB,GAAQ;IAAE,gBAAgB,EAAW;IAAS;GAAQ,CAAC,CAKnF;EACxB,CAIE;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;CAClC,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/force-cancel-close-request.d.ts

@@ -0,0 +1,41 @@
+import { Address, Hash } from 'viem';
+import { Config } from '../../../core/config/index.js';
+import { Compute, WriteContractParameter } from '../../../shared/types/properties.js';
+/**
+ * Parameters for {@link forceCancelCloseRequest}.
+ */
+export type ForceCancelCloseRequestParameters = Compute<WriteContractParameter & {
+    /**
+     * The subaccount (partyA) that owns the quote. Routed through the AccountLayer
+     * `_call` proxy so the core sees this subaccount as the caller; the connected
+     * wallet must be its on-chain `owner`.
+     */
+    account: Address;
+    /** The `CANCEL_CLOSE_PENDING` quote id to force-cancel the close on. */
+    quoteId: bigint;
+}>;
+/** Return type of {@link forceCancelCloseRequest}: the submitted transaction hash. */
+export type ForceCancelCloseRequestReturnType = Hash;
+/**
+ * Force-cancel a stuck close request (`forceCancelCloseRequest`) — the escalation
+ * when partyB stalls on a close-cancel request.
+ *
+ * A quote reaches `CANCEL_CLOSE_PENDING` only when it was `CLOSE_PENDING` and
+ * partyA called `requestToCancelCloseRequest`. If partyB does not acknowledge
+ * within `coolDownsOfMA()[2]` (`forceCancelCloseCooldown`) after the request,
+ * partyA may force it — the quote returns to `OPENED`. The core
+ * `forceCancelCloseRequest(quoteId)` is routed through `AccountLayer._call(account, …)`;
+ * the connected wallet must be the sub-account's `owner`.
+ *
+ * @param config - The SDK config (must have a `getWalletClient` resolver).
+ * @param parameters - The owning subaccount, the quote id, optional `from` / pre-flight / chain id.
+ * @returns The submitted transaction hash.
+ * @throws {SymmError} when the chain is unsupported or no wallet client is available.
+ *
+ * @example
+ * ```ts
+ * const hash = await forceCancelCloseRequest(config, { account: "0xsub…", quoteId: 42n });
+ * ```
+ */
+export declare function forceCancelCloseRequest(config: Config, parameters: ForceCancelCloseRequestParameters): Promise<ForceCancelCloseRequestReturnType>;
+//# sourceMappingURL=force-cancel-close-request.d.ts.map

package/dist/symmio-contracts/symmio/actions/force-cancel-close-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-cancel-close-request.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/force-cancel-close-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAIxF;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,OAAO,CACrD,sBAAsB,GAAG;IACvB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB,CACF,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,iCAAiC,GAC5C,OAAO,CAAC,iCAAiC,CAAC,CAgB5C"}

package/dist/symmio-contracts/symmio/actions/force-cancel-close-request.js

@@ -0,0 +1,22 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+import { callAsSubAccount as t } from "../internal/call-as-sub-account.js";
+import { encodeFunctionData as n } from "viem";
+//#region src/symmio-contracts/symmio/actions/force-cancel-close-request.ts
+async function r(r, i) {
+	let { chainId: a, account: o, quoteId: s } = i;
+	return t(r, {
+		account: o,
+		data: n({
+			abi: e,
+			functionName: "forceCancelCloseRequest",
+			args: [s]
+		}),
+		chainId: a,
+		from: i.from,
+		simulateBeforeWrite: i.simulateBeforeWrite
+	});
+}
+//#endregion
+export { r as forceCancelCloseRequest };
+
+//# sourceMappingURL=force-cancel-close-request.js.map

package/dist/symmio-contracts/symmio/actions/force-cancel-close-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-cancel-close-request.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/force-cancel-close-request.ts"],"sourcesContent":["import { encodeFunctionData, type Address, type Hash } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport type { Compute, WriteContractParameter } from \"../../../shared/types/properties\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\nimport { callAsSubAccount } from \"../internal/call-as-sub-account\";\n\n/**\n * Parameters for {@link forceCancelCloseRequest}.\n */\nexport type ForceCancelCloseRequestParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount (partyA) that owns the quote. Routed through the AccountLayer\n     * `_call` proxy so the core sees this subaccount as the caller; the connected\n     * wallet must be its on-chain `owner`.\n     */\n    account: Address;\n    /** The `CANCEL_CLOSE_PENDING` quote id to force-cancel the close on. */\n    quoteId: bigint;\n  }\n>;\n\n/** Return type of {@link forceCancelCloseRequest}: the submitted transaction hash. */\nexport type ForceCancelCloseRequestReturnType = Hash;\n\n/**\n * Force-cancel a stuck close request (`forceCancelCloseRequest`) — the escalation\n * when partyB stalls on a close-cancel request.\n *\n * A quote reaches `CANCEL_CLOSE_PENDING` only when it was `CLOSE_PENDING` and\n * partyA called `requestToCancelCloseRequest`. If partyB does not acknowledge\n * within `coolDownsOfMA()[2]` (`forceCancelCloseCooldown`) after the request,\n * partyA may force it — the quote returns to `OPENED`. The core\n * `forceCancelCloseRequest(quoteId)` is routed through `AccountLayer._call(account, …)`;\n * the connected wallet must be the sub-account's `owner`.\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - The owning subaccount, the quote id, optional `from` / pre-flight / chain id.\n * @returns The submitted transaction hash.\n * @throws {SymmError} when the chain is unsupported or no wallet client is available.\n *\n * @example\n * ```ts\n * const hash = await forceCancelCloseRequest(config, { account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport async function forceCancelCloseRequest(\n  config: Config,\n  parameters: ForceCancelCloseRequestParameters,\n): Promise<ForceCancelCloseRequestReturnType> {\n  const { chainId, account, quoteId } = parameters;\n\n  const data = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"forceCancelCloseRequest\",\n    args: [quoteId],\n  });\n\n  return callAsSubAccount(config, {\n    account,\n    data,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;AA8CA,eAAsB,EACpB,GACA,GAC4C;CAC5C,IAAM,EAAE,YAAS,YAAS,eAAY;CAQtC,OAAO,EAAiB,GAAQ;EAC9B;EACA,MARW,EAAmB;GAC9B,KAAK;GACL,cAAc;GACd,MAAM,CAAC,CAAO;EAChB,CAIE;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;CAClC,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/force-cancel-quote.d.ts

@@ -0,0 +1,41 @@
+import { Address, Hash } from 'viem';
+import { Config } from '../../../core/config/index.js';
+import { Compute, WriteContractParameter } from '../../../shared/types/properties.js';
+/**
+ * Parameters for {@link forceCancelQuote}.
+ */
+export type ForceCancelQuoteParameters = Compute<WriteContractParameter & {
+    /**
+     * The subaccount (partyA) that owns the quote. Routed through the AccountLayer
+     * `_call` proxy so the core sees this subaccount as the caller; the connected
+     * wallet must be its on-chain `owner`.
+     */
+    account: Address;
+    /** The `CANCEL_PENDING` quote id to force-cancel. */
+    quoteId: bigint;
+}>;
+/** Return type of {@link forceCancelQuote}: the submitted transaction hash. */
+export type ForceCancelQuoteReturnType = Hash;
+/**
+ * Force-cancel a stuck quote (`forceCancelQuote`) — the escalation when partyB
+ * stalls on a cancel request.
+ *
+ * A quote reaches `CANCEL_PENDING` only when it was `LOCKED` and partyA called
+ * `requestToCancelQuote` (a `PENDING` quote cancels instantly and never needs
+ * this). If partyB does not acknowledge within `coolDownsOfMA()[1]`
+ * (`forceCancelCooldown`) after the request, partyA may force it. The core
+ * `forceCancelQuote(quoteId)` is routed through `AccountLayer._call(account, …)`;
+ * the connected wallet must be the sub-account's `owner`.
+ *
+ * @param config - The SDK config (must have a `getWalletClient` resolver).
+ * @param parameters - The owning subaccount, the quote id, optional `from` / pre-flight / chain id.
+ * @returns The submitted transaction hash.
+ * @throws {SymmError} when the chain is unsupported or no wallet client is available.
+ *
+ * @example
+ * ```ts
+ * const hash = await forceCancelQuote(config, { account: "0xsub…", quoteId: 42n });
+ * ```
+ */
+export declare function forceCancelQuote(config: Config, parameters: ForceCancelQuoteParameters): Promise<ForceCancelQuoteReturnType>;
+//# sourceMappingURL=force-cancel-quote.d.ts.map

package/dist/symmio-contracts/symmio/actions/force-cancel-quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-cancel-quote.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/force-cancel-quote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAIxF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,sBAAsB,GAAG;IACvB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB,CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,0BAA0B,GACrC,OAAO,CAAC,0BAA0B,CAAC,CAgBrC"}

package/dist/symmio-contracts/symmio/actions/force-cancel-quote.js

@@ -0,0 +1,22 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+import { callAsSubAccount as t } from "../internal/call-as-sub-account.js";
+import { encodeFunctionData as n } from "viem";
+//#region src/symmio-contracts/symmio/actions/force-cancel-quote.ts
+async function r(r, i) {
+	let { chainId: a, account: o, quoteId: s } = i;
+	return t(r, {
+		account: o,
+		data: n({
+			abi: e,
+			functionName: "forceCancelQuote",
+			args: [s]
+		}),
+		chainId: a,
+		from: i.from,
+		simulateBeforeWrite: i.simulateBeforeWrite
+	});
+}
+//#endregion
+export { r as forceCancelQuote };
+
+//# sourceMappingURL=force-cancel-quote.js.map

package/dist/symmio-contracts/symmio/actions/force-cancel-quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-cancel-quote.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/force-cancel-quote.ts"],"sourcesContent":["import { encodeFunctionData, type Address, type Hash } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport type { Compute, WriteContractParameter } from \"../../../shared/types/properties\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\nimport { callAsSubAccount } from \"../internal/call-as-sub-account\";\n\n/**\n * Parameters for {@link forceCancelQuote}.\n */\nexport type ForceCancelQuoteParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount (partyA) that owns the quote. Routed through the AccountLayer\n     * `_call` proxy so the core sees this subaccount as the caller; the connected\n     * wallet must be its on-chain `owner`.\n     */\n    account: Address;\n    /** The `CANCEL_PENDING` quote id to force-cancel. */\n    quoteId: bigint;\n  }\n>;\n\n/** Return type of {@link forceCancelQuote}: the submitted transaction hash. */\nexport type ForceCancelQuoteReturnType = Hash;\n\n/**\n * Force-cancel a stuck quote (`forceCancelQuote`) — the escalation when partyB\n * stalls on a cancel request.\n *\n * A quote reaches `CANCEL_PENDING` only when it was `LOCKED` and partyA called\n * `requestToCancelQuote` (a `PENDING` quote cancels instantly and never needs\n * this). If partyB does not acknowledge within `coolDownsOfMA()[1]`\n * (`forceCancelCooldown`) after the request, partyA may force it. The core\n * `forceCancelQuote(quoteId)` is routed through `AccountLayer._call(account, …)`;\n * the connected wallet must be the sub-account's `owner`.\n *\n * @param config - The SDK config (must have a `getWalletClient` resolver).\n * @param parameters - The owning subaccount, the quote id, optional `from` / pre-flight / chain id.\n * @returns The submitted transaction hash.\n * @throws {SymmError} when the chain is unsupported or no wallet client is available.\n *\n * @example\n * ```ts\n * const hash = await forceCancelQuote(config, { account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport async function forceCancelQuote(\n  config: Config,\n  parameters: ForceCancelQuoteParameters,\n): Promise<ForceCancelQuoteReturnType> {\n  const { chainId, account, quoteId } = parameters;\n\n  const data = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"forceCancelQuote\",\n    args: [quoteId],\n  });\n\n  return callAsSubAccount(config, {\n    account,\n    data,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;AA8CA,eAAsB,EACpB,GACA,GACqC;CACrC,IAAM,EAAE,YAAS,YAAS,eAAY;CAQtC,OAAO,EAAiB,GAAQ;EAC9B;EACA,MARW,EAAmB;GAC9B,KAAK;GACL,cAAc;GACd,MAAM,CAAC,CAAO;EAChB,CAIE;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;CAClC,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/get-cool-downs-of-ma.d.ts

@@ -0,0 +1,34 @@
+import { Config } from '../../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties.js';
+/**
+ * Parameters for {@link getCoolDownsOfMA}.
+ */
+export type GetCoolDownsOfMAParameters = Compute<ChainIdParameter>;
+/**
+ * Return type of {@link getCoolDownsOfMA}: the four cooldown periods from
+ * `coolDownsOfMA()`, in contract order (unix seconds) —
+ * `(withdrawCooldownPeriod, forceCancelCooldown, forceCancelCloseCooldown, forceCloseFirstCooldown)`.
+ *
+ * Index **1** is the **force-cancel cooldown** — the wait after a quote enters
+ * `CANCEL_PENDING` before `forceCancelQuote` is allowed.
+ */
+export type GetCoolDownsOfMAReturnType = readonly [bigint, bigint, bigint, bigint];
+/**
+ * Read the protocol cooldown periods (`coolDownsOfMA()`), in unix seconds.
+ *
+ * The value at index **1** is the `forceCancelCooldown`: once a `CANCEL_PENDING`
+ * quote's `statusModifyTimestamp + coolDownsOfMA()[1]` has passed, partyA may
+ * call {@link "forceCancelQuote"}.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Optional chain id.
+ * @returns The four cooldown values `[_, forceCancelCooldown, _, _]`.
+ * @throws {SymmError} when the chain is not supported.
+ *
+ * @example
+ * ```ts
+ * const [, forceCancelCooldown] = await getCoolDownsOfMA(config);
+ * ```
+ */
+export declare function getCoolDownsOfMA(config: Config, parameters?: GetCoolDownsOfMAParameters): Promise<GetCoolDownsOfMAReturnType>;
+//# sourceMappingURL=get-cool-downs-of-ma.d.ts.map

package/dist/symmio-contracts/symmio/actions/get-cool-downs-of-ma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-cool-downs-of-ma.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/get-cool-downs-of-ma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAGlF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,MAAM,0BAA0B,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,0BAA+B,GAC1C,OAAO,CAAC,0BAA0B,CAAC,CAWrC"}

package/dist/symmio-contracts/symmio/actions/get-cool-downs-of-ma.js

@@ -0,0 +1,14 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+//#region src/symmio-contracts/symmio/actions/get-cool-downs-of-ma.ts
+async function t(t, n = {}) {
+	let { chainId: r } = n, { addresses: i } = t.getChainConfig(r);
+	return t.getClient({ chainId: r }).readContract({
+		address: i.symmioAddress,
+		abi: e,
+		functionName: "coolDownsOfMA"
+	});
+}
+//#endregion
+export { t as getCoolDownsOfMA };
+
+//# sourceMappingURL=get-cool-downs-of-ma.js.map

package/dist/symmio-contracts/symmio/actions/get-cool-downs-of-ma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-cool-downs-of-ma.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/get-cool-downs-of-ma.ts"],"sourcesContent":["import type { Config } from \"../../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../../shared/types/properties\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\n\n/**\n * Parameters for {@link getCoolDownsOfMA}.\n */\nexport type GetCoolDownsOfMAParameters = Compute<ChainIdParameter>;\n\n/**\n * Return type of {@link getCoolDownsOfMA}: the four cooldown periods from\n * `coolDownsOfMA()`, in contract order (unix seconds) —\n * `(withdrawCooldownPeriod, forceCancelCooldown, forceCancelCloseCooldown, forceCloseFirstCooldown)`.\n *\n * Index **1** is the **force-cancel cooldown** — the wait after a quote enters\n * `CANCEL_PENDING` before `forceCancelQuote` is allowed.\n */\nexport type GetCoolDownsOfMAReturnType = readonly [bigint, bigint, bigint, bigint];\n\n/**\n * Read the protocol cooldown periods (`coolDownsOfMA()`), in unix seconds.\n *\n * The value at index **1** is the `forceCancelCooldown`: once a `CANCEL_PENDING`\n * quote's `statusModifyTimestamp + coolDownsOfMA()[1]` has passed, partyA may\n * call {@link \"forceCancelQuote\"}.\n *\n * @param config - The SDK config.\n * @param parameters - Optional chain id.\n * @returns The four cooldown values `[_, forceCancelCooldown, _, _]`.\n * @throws {SymmError} when the chain is not supported.\n *\n * @example\n * ```ts\n * const [, forceCancelCooldown] = await getCoolDownsOfMA(config);\n * ```\n */\nexport async function getCoolDownsOfMA(\n  config: Config,\n  parameters: GetCoolDownsOfMAParameters = {},\n): Promise<GetCoolDownsOfMAReturnType> {\n  const { chainId } = parameters;\n\n  const { addresses } = config.getChainConfig(chainId);\n  const client = config.getClient({ chainId });\n\n  return client.readContract({\n    address: addresses.symmioAddress,\n    abi: symmioAbi,\n    functionName: \"coolDownsOfMA\",\n  });\n}\n"],"mappings":";;AAoCA,eAAsB,EACpB,GACA,IAAyC,CAAC,GACL;CACrC,IAAM,EAAE,eAAY,GAEd,EAAE,iBAAc,EAAO,eAAe,CAAO;CAGnD,OAFe,EAAO,UAAU,EAAE,WAAQ,CAEnC,EAAO,aAAa;EACzB,SAAS,EAAU;EACnB,KAAK;EACL,cAAc;CAChB,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/get-pending-quotes.d.ts

@@ -0,0 +1,39 @@
+import { Address } from 'viem';
+import { Config } from '../../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties.js';
+import { Quote } from '../types.js';
+/**
+ * Parameters for {@link getPendingQuotes}.
+ */
+export type GetPendingQuotesParameters = Compute<ChainIdParameter & {
+    /** PartyA (virtual account, or the sub-account for cross-margin) whose resting limit orders to read. */
+    partyA: Address;
+    /** How many `getQuote` reads to bundle per multicall. @default 10 */
+    batchSize?: number;
+}>;
+/** Return type of {@link getPendingQuotes}: the hydrated resting limit-order {@link Quote} structs. */
+export type GetPendingQuotesReturnType = Quote[];
+/**
+ * Read a partyA's resting **LIMIT orders** as **full {@link Quote} structs**. A
+ * pending quote is one that has not opened yet — in practice a limit order
+ * waiting to fill (`PENDING` / `LOCKED` / `CANCEL_PENDING`), since a market order
+ * never rests here.
+ *
+ * The contract exposes only the pending quote ids ({@link getPartyAPendingQuotes})
+ * and a per-id `getQuote`, so this hydrates them: fetch the ids, then read the
+ * quotes with `getQuote` bundled into **multicalls of `batchSize`** (default 10)
+ * to keep each RPC round-trip small. Zeroed (`id === 0n`) entries are dropped.
+ *
+ * @param config - The SDK config.
+ * @param parameters - PartyA, optional chain id and batch size.
+ * @returns The hydrated limit orders (empty when partyA has none).
+ * @throws {SymmError} when the chain is not supported.
+ * @throws Viem's `ContractFunctionExecutionError` / multicall errors for on-chain failures.
+ *
+ * @example
+ * ```ts
+ * const limitOrders = await getPendingQuotes(config, { partyA: "0xsub…" });
+ * ```
+ */
+export declare function getPendingQuotes(config: Config, parameters: GetPendingQuotesParameters): Promise<GetPendingQuotesReturnType>;
+//# sourceMappingURL=get-pending-quotes.d.ts.map

package/dist/symmio-contracts/symmio/actions/get-pending-quotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pending-quotes.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/get-pending-quotes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAElF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAMtC;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,gBAAgB,GAAG;IACjB,wGAAwG;IACxG,MAAM,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CACF,CAAC;AAEF,uGAAuG;AACvG,MAAM,MAAM,0BAA0B,GAAG,KAAK,EAAE,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,0BAA0B,GACrC,OAAO,CAAC,0BAA0B,CAAC,CA+BrC"}