@symmio/trading-core 1.0.1 → 2.0.0

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"}

package/dist/symmio-contracts/symmio/actions/get-pending-quotes.js

@@ -0,0 +1,29 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+import { getPartyAPendingQuotes as t } from "./get-party-a-pending-quotes.js";
+//#region src/symmio-contracts/symmio/actions/get-pending-quotes.ts
+var n = 10;
+async function r(r, i) {
+	let { chainId: a, partyA: o, batchSize: s = n } = i, c = await t(r, {
+		chainId: a,
+		partyA: o
+	});
+	if (c.length === 0) return [];
+	let { addresses: l } = r.getChainConfig(a), u = r.getClient({ chainId: a }), d = [];
+	for (let t = 0; t < c.length; t += s) {
+		let n = c.slice(t, t + s), r = await u.multicall({
+			allowFailure: !1,
+			contracts: n.map((t) => ({
+				address: l.symmioAddress,
+				abi: e,
+				functionName: "getQuote",
+				args: [t]
+			}))
+		});
+		for (let e of r) e.id !== 0n && d.push(e);
+	}
+	return d;
+}
+//#endregion
+export { r as getPendingQuotes };
+
+//# sourceMappingURL=get-pending-quotes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-pending-quotes.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/get-pending-quotes.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../../shared/types/properties\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\nimport type { Quote } from \"../types\";\nimport { getPartyAPendingQuotes } from \"./get-party-a-pending-quotes\";\n\n/** Default number of `getQuote` reads per multicall batch. */\nconst DEFAULT_BATCH_SIZE = 10;\n\n/**\n * Parameters for {@link getPendingQuotes}.\n */\nexport type GetPendingQuotesParameters = Compute<\n  ChainIdParameter & {\n    /** PartyA (virtual account, or the sub-account for cross-margin) whose resting limit orders to read. */\n    partyA: Address;\n    /** How many `getQuote` reads to bundle per multicall. @default 10 */\n    batchSize?: number;\n  }\n>;\n\n/** Return type of {@link getPendingQuotes}: the hydrated resting limit-order {@link Quote} structs. */\nexport type GetPendingQuotesReturnType = Quote[];\n\n/**\n * Read a partyA's resting **LIMIT orders** as **full {@link Quote} structs**. A\n * pending quote is one that has not opened yet — in practice a limit order\n * waiting to fill (`PENDING` / `LOCKED` / `CANCEL_PENDING`), since a market order\n * never rests here.\n *\n * The contract exposes only the pending quote ids ({@link getPartyAPendingQuotes})\n * and a per-id `getQuote`, so this hydrates them: fetch the ids, then read the\n * quotes with `getQuote` bundled into **multicalls of `batchSize`** (default 10)\n * to keep each RPC round-trip small. Zeroed (`id === 0n`) entries are dropped.\n *\n * @param config - The SDK config.\n * @param parameters - PartyA, optional chain id and batch size.\n * @returns The hydrated limit orders (empty when partyA has none).\n * @throws {SymmError} when the chain is not supported.\n * @throws Viem's `ContractFunctionExecutionError` / multicall errors for on-chain failures.\n *\n * @example\n * ```ts\n * const limitOrders = await getPendingQuotes(config, { partyA: \"0xsub…\" });\n * ```\n */\nexport async function getPendingQuotes(\n  config: Config,\n  parameters: GetPendingQuotesParameters,\n): Promise<GetPendingQuotesReturnType> {\n  const { chainId, partyA, batchSize = DEFAULT_BATCH_SIZE } = parameters;\n\n  const ids = await getPartyAPendingQuotes(config, { chainId, partyA });\n  if (ids.length === 0) return [];\n\n  const { addresses } = config.getChainConfig(chainId);\n  const client = config.getClient({ chainId });\n\n  const quotes: Quote[] = [];\n  for (let start = 0; start < ids.length; start += batchSize) {\n    const batch = ids.slice(start, start + batchSize);\n    const results = await client.multicall({\n      allowFailure: false,\n      contracts: batch.map(\n        (quoteId) =>\n          ({\n            address: addresses.symmioAddress,\n            abi: symmioAbi,\n            functionName: \"getQuote\",\n            args: [quoteId],\n          }) as const,\n      ),\n    });\n    for (const quote of results) {\n      // `getQuote` returns a zeroed struct for an unknown id (ids are 1-based).\n      if (quote.id !== 0n) quotes.push(quote);\n    }\n  }\n\n  return quotes;\n}\n"],"mappings":";;;AAQA,IAAM,IAAqB;AAuC3B,eAAsB,EACpB,GACA,GACqC;CACrC,IAAM,EAAE,YAAS,WAAQ,eAAY,MAAuB,GAEtD,IAAM,MAAM,EAAuB,GAAQ;EAAE;EAAS;CAAO,CAAC;CACpE,IAAI,EAAI,WAAW,GAAG,OAAO,CAAC;CAE9B,IAAM,EAAE,iBAAc,EAAO,eAAe,CAAO,GAC7C,IAAS,EAAO,UAAU,EAAE,WAAQ,CAAC,GAErC,IAAkB,CAAC;CACzB,KAAK,IAAI,IAAQ,GAAG,IAAQ,EAAI,QAAQ,KAAS,GAAW;EAC1D,IAAM,IAAQ,EAAI,MAAM,GAAO,IAAQ,CAAS,GAC1C,IAAU,MAAM,EAAO,UAAU;GACrC,cAAc;GACd,WAAW,EAAM,KACd,OACE;IACC,SAAS,EAAU;IACnB,KAAK;IACL,cAAc;IACd,MAAM,CAAC,CAAO;GAChB,EACJ;EACF,CAAC;EACD,KAAK,IAAM,KAAS,GAElB,AAAI,EAAM,OAAO,MAAI,EAAO,KAAK,CAAK;CAE1C;CAEA,OAAO;AACT"}

package/dist/symmio-contracts/symmio/actions/request-to-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 requestToCancelCloseRequest}.
+ */
+export type RequestToCancelCloseRequestParameters = Compute<WriteContractParameter & {
+    /**
+     * The subaccount (partyA) that owns the quote. The call is 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 `CLOSE_PENDING` quote id whose close request to cancel. */
+    quoteId: bigint;
+}>;
+/** Return type of {@link requestToCancelCloseRequest}: the submitted transaction hash. */
+export type RequestToCancelCloseRequestReturnType = Hash;
+/**
+ * Request cancellation of a pending **close** (`requestToCancelCloseRequest`) —
+ * the way a partyA backs out of a resting close (e.g. a limit close) while the
+ * quote is `CLOSE_PENDING`.
+ *
+ * The core `requestToCancelCloseRequest(quoteId)` must be attributed to the
+ * sub-account, so it is encoded and routed through `AccountLayer._call(account, …)`;
+ * the connected wallet must be the sub-account's `owner`. If partyB accepts, the
+ * quote returns to `OPENED`; if partyB stalls, it enters `CANCEL_CLOSE_PENDING`
+ * until the force-cancel-close cooldown elapses (see `forceCancelCloseRequest`).
+ *
+ * @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 requestToCancelCloseRequest(config, { account: "0xsub…", quoteId: 42n });
+ * ```
+ */
+export declare function requestToCancelCloseRequest(config: Config, parameters: RequestToCancelCloseRequestParameters): Promise<RequestToCancelCloseRequestReturnType>;
+//# sourceMappingURL=request-to-cancel-close-request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-to-cancel-close-request.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/request-to-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,qCAAqC,GAAG,OAAO,CACzD,sBAAsB,GAAG;IACvB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB,CACF,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,qCAAqC,GAAG,IAAI,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,qCAAqC,GAChD,OAAO,CAAC,qCAAqC,CAAC,CAgBhD"}