@symmio/trading-core 0.1.0

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

@@ -0,0 +1,49 @@
+import { Address, Hash } from 'viem';
+import { Config } from '../../../core/config';
+import { Compute, WriteContractParameter } from '../../../shared/types/properties';
+/**
+ * Parameters for {@link allocate}.
+ */
+export type AllocateParameters = Compute<WriteContractParameter & {
+    /**
+     * The subaccount to allocate into. The call is routed through the
+     * AccountLayer `_call` proxy; the connected wallet must be its on-chain `owner`.
+     */
+    account: Address;
+    /**
+     * Amount to move from the available balance into the allocated balance, in
+     * **18 decimals** (not the collateral token's decimals). Capped by the
+     * per-user balance limit.
+     */
+    amount: bigint;
+}>;
+/** Return type of {@link allocate}: the submitted transaction hash. */
+export type AllocateReturnType = Hash;
+/**
+ * Move collateral from a subaccount's **available balance** into its **allocated
+ * (tradeable) balance** on the SYMMIO core.
+ *
+ * Allocated balance is what Party A actually trades against. The subaccount's
+ * available balance is debited and its allocated balance credited, in 18-decimal
+ * units, capped by the per-user balance limit. The subaccount must not be
+ * suspended or currently in liquidation as Party A.
+ *
+ * Encodes the SYMMIO core `allocate(amount)` call and routes it through
+ * `AccountLayer._call(account, …)` so the core attributes it to the subaccount.
+ *
+ * Dry-runs the call with {@link simulateAllocate} first unless `simulateBeforeWrite`
+ * 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), 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 hash = await allocate(config, { account: "0xsub…", amount: 1_000000000000000000n });
+ * ```
+ */
+export declare function allocate(config: Config, parameters: AllocateParameters): Promise<AllocateReturnType>;
+//# sourceMappingURL=allocate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allocate.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/allocate.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,kBAAkB,GAAG,OAAO,CACtC,sBAAsB,GAAG;IACvB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CACF,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgB1G"}

package/dist/symmio-contracts/symmio/actions/allocate.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/allocate.ts
+async function r(r, i) {
+	let { chainId: a, account: o, amount: s } = i;
+	return t(r, {
+		account: o,
+		data: n({
+			abi: e,
+			functionName: "allocate",
+			args: [s]
+		}),
+		chainId: a,
+		from: i.from,
+		simulateBeforeWrite: i.simulateBeforeWrite
+	});
+}
+//#endregion
+export { r as allocate };
+
+//# sourceMappingURL=allocate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allocate.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/allocate.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 allocate}.\n */\nexport type AllocateParameters = Compute<\n  WriteContractParameter & {\n    /**\n     * The subaccount to allocate into. 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 available balance into the allocated balance, in\n     * **18 decimals** (not the collateral token's decimals). Capped by the\n     * per-user balance limit.\n     */\n    amount: bigint;\n  }\n>;\n\n/** Return type of {@link allocate}: the submitted transaction hash. */\nexport type AllocateReturnType = Hash;\n\n/**\n * Move collateral from a subaccount's **available balance** into its **allocated\n * (tradeable) balance** on the SYMMIO core.\n *\n * Allocated balance is what Party A actually trades against. The subaccount's\n * available balance is debited and its allocated balance credited, in 18-decimal\n * units, capped by the per-user balance limit. The subaccount must not be\n * suspended or currently in liquidation as Party A.\n *\n * Encodes the SYMMIO core `allocate(amount)` call and routes it through\n * `AccountLayer._call(account, …)` so the core attributes it to the subaccount.\n *\n * Dry-runs the call with {@link simulateAllocate} 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 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 hash = await allocate(config, { account: \"0xsub…\", amount: 1_000000000000000000n });\n * ```\n */\nexport async function allocate(config: Config, parameters: AllocateParameters): Promise<AllocateReturnType> {\n  const { chainId, account, amount } = parameters;\n\n  const data = encodeFunctionData({\n    abi: symmioAbi,\n    functionName: \"allocate\",\n    args: [amount],\n  });\n\n  return callAsSubAccount(config, {\n    account,\n    data,\n    chainId,\n    from: parameters.from,\n    simulateBeforeWrite: parameters.simulateBeforeWrite,\n  });\n}\n"],"mappings":";;;;AAsDA,eAAsB,EAAS,GAAgB,GAA6D;CAC1G,IAAM,EAAE,YAAS,YAAS,cAAW;CAQrC,OAAO,EAAiB,GAAQ;EAC9B;EACA,MARW,EAAmB;GAC9B,KAAK;GACL,cAAc;GACd,MAAM,CAAC,CAAM;EACf,CAIE;EACA;EACA,MAAM,EAAW;EACjB,qBAAqB,EAAW;CAClC,CAAC;AACH"}

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

@@ -0,0 +1,63 @@
+import { Address, Hash } from 'viem';
+import { Config } from '../../../core/config';
+import { Compute, WriteContractParameter } from '../../../shared/types/properties';
+import { SingleUpnlSig } from '../../account-layer/types';
+/**
+ * Parameters for {@link deallocate}.
+ */
+export type DeallocateParameters = Compute<WriteContractParameter & {
+    /**
+     * The subaccount to deallocate from. The call is routed through the
+     * AccountLayer `_call` proxy; 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).
+     */
+    amount: bigint;
+    /**
+     * 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}.
+     */
+    upnlSig: SingleUpnlSig;
+}>;
+/** Return type of {@link deallocate}: the submitted transaction hash. */
+export type DeallocateReturnType = Hash;
+/**
+ * Move collateral from a subaccount's **allocated (tradeable) balance** back into
+ * its **available balance** on the SYMMIO core.
+ *
+ * The reverse of {@link allocate}: the subaccount's allocated balance is debited
+ * and its available balance credited, in 18-decimal units, after the contract
+ * verifies the Muon uPnL signature keeps the subaccount solvent. The freed
+ * collateral can then be withdrawn (subject to the separate withdraw cooldown).
+ *
+ * Encodes the SYMMIO core `deallocate(amount, upnlSig)` call and routes it through
+ * `AccountLayer._call(account, …)` so the core attributes it to the subaccount.
+ *
+ * @remarks
+ * Subject to the on-chain **deallocate debounce**: calling too soon after a prior
+ * deallocate reverts ("Too many deallocate in a short window"). This is distinct
+ * from the withdraw cooldown that later gates moving the freed collateral to the
+ * wallet. The `upnlSig` must be freshly fetched — a stale attestation reverts.
+ *
+ * Dry-runs the call with {@link simulateDeallocate} first unless `simulateBeforeWrite`
+ * 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.
+ * @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 upnlSig = await getDeallocateUpnlSig(config, { virtualAccount: "0xsub…" });
+ * const hash = await deallocate(config, { account: "0xsub…", amount: 1_000000000000000000n, upnlSig });
+ * ```
+ */
+export declare function deallocate(config: Config, parameters: DeallocateParameters): Promise<DeallocateReturnType>;
+//# sourceMappingURL=deallocate.d.ts.map

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

@@ -0,0 +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"}

package/dist/symmio-contracts/symmio/actions/deallocate.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/deallocate.ts
+async function r(r, i) {
+	let { chainId: a, account: o, amount: s, upnlSig: c } = i;
+	return t(r, {
+		account: o,
+		data: n({
+			abi: e,
+			functionName: "deallocate",
+			args: [s, c]
+		}),
+		chainId: a,
+		from: i.from,
+		simulateBeforeWrite: i.simulateBeforeWrite
+	});
+}
+//#endregion
+export { r as deallocate };
+
+//# sourceMappingURL=deallocate.js.map

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

@@ -0,0 +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"}

package/dist/symmio-contracts/symmio/actions/finalize-withdraw-request.d.ts

@@ -0,0 +1,40 @@
+import { Address, Hash } from 'viem';
+import { Config } from '../../../core/config';
+import { Compute, WriteContractParameter } from '../../../shared/types/properties';
+/**
+ * Parameters for {@link finalizeWithdrawRequest}.
+ */
+export type FinalizeWithdrawRequestParameters = Compute<WriteContractParameter & {
+    /** The subaccount that owns the request (the request's on-chain `user`). */
+    user: Address;
+    /** Id of the withdraw request to finalize. */
+    requestId: bigint;
+}>;
+/** Return type of {@link finalizeWithdrawRequest}: the submitted transaction hash. */
+export type FinalizeWithdrawRequestReturnType = Hash;
+/**
+ * Finalize a matured withdraw request, paying out collateral to its receivers.
+ *
+ * Calls the SYMMIO core `finalizeWithdrawRequest(user, requestId)` **directly** —
+ * the function is permissionless (it only checks that the cooldown has elapsed and
+ * the status is valid), so it does not need the AccountLayer `_call` proxy and any
+ * wallet may submit it. Funds go to the `receiver` baked into each part, not to
+ * the caller.
+ *
+ * Dry-runs the call with {@link simulateFinalizeWithdrawRequest} first unless
+ * `simulateBeforeWrite` is `false` (per-call, falling back to the config default).
+ *
+ * @param config - The SDK config (must have a `getWalletClient` resolver).
+ * @param parameters - The request's owner subaccount, request id, 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`, ...) — including
+ *   when the cooldown has not yet elapsed.
+ *
+ * @example
+ * ```ts
+ * const hash = await finalizeWithdrawRequest(config, { user: "0xsub…", requestId: 1n });
+ * ```
+ */
+export declare function finalizeWithdrawRequest(config: Config, parameters: FinalizeWithdrawRequestParameters): Promise<FinalizeWithdrawRequestReturnType>;
+//# sourceMappingURL=finalize-withdraw-request.d.ts.map

package/dist/symmio-contracts/symmio/actions/finalize-withdraw-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-withdraw-request.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/finalize-withdraw-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAKxF;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,OAAO,CACrD,sBAAsB,GAAG;IACvB,4EAA4E;IAC5E,IAAI,EAAE,OAAO,CAAC;IACd,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB,CACF,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,iCAAiC,GAC5C,OAAO,CAAC,iCAAiC,CAAC,CAkB5C"}

package/dist/symmio-contracts/symmio/actions/finalize-withdraw-request.js

@@ -0,0 +1,27 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+import { shouldSimulateBeforeWrite as t } from "../../../shared/utils/simulate-before-write.js";
+import { simulateFinalizeWithdrawRequest as n } from "./simulate-finalize-withdraw-request.js";
+//#region src/symmio-contracts/symmio/actions/finalize-withdraw-request.ts
+async function r(r, i) {
+	let { chainId: a, user: o, requestId: s, from: c } = i, { addresses: l } = r.getChainConfig(a), u = await r.getWalletClient({
+		chainId: a,
+		from: c
+	});
+	return t(r, i) && await n(r, {
+		chainId: a,
+		user: o,
+		requestId: s,
+		from: u.account.address
+	}), u.writeContract({
+		address: l.symmioAddress,
+		abi: e,
+		functionName: "finalizeWithdrawRequest",
+		args: [o, s],
+		account: u.account,
+		chain: u.chain
+	});
+}
+//#endregion
+export { r as finalizeWithdrawRequest };
+
+//# sourceMappingURL=finalize-withdraw-request.js.map

package/dist/symmio-contracts/symmio/actions/finalize-withdraw-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-withdraw-request.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/finalize-withdraw-request.ts"],"sourcesContent":["import type { Address, Hash } from \"viem\";\nimport type { Config } from \"../../../core/config\";\nimport type { Compute, WriteContractParameter } from \"../../../shared/types/properties\";\nimport { shouldSimulateBeforeWrite } from \"../../../shared/utils/simulate-before-write\";\nimport { symmioAbi } from \"../../abi/v0.8.5/symmio\";\nimport { simulateFinalizeWithdrawRequest } from \"./simulate-finalize-withdraw-request\";\n\n/**\n * Parameters for {@link finalizeWithdrawRequest}.\n */\nexport type FinalizeWithdrawRequestParameters = Compute<\n  WriteContractParameter & {\n    /** The subaccount that owns the request (the request's on-chain `user`). */\n    user: Address;\n    /** Id of the withdraw request to finalize. */\n    requestId: bigint;\n  }\n>;\n\n/** Return type of {@link finalizeWithdrawRequest}: the submitted transaction hash. */\nexport type FinalizeWithdrawRequestReturnType = Hash;\n\n/**\n * Finalize a matured withdraw request, paying out collateral to its receivers.\n *\n * Calls the SYMMIO core `finalizeWithdrawRequest(user, requestId)` **directly** —\n * the function is permissionless (it only checks that the cooldown has elapsed and\n * the status is valid), so it does not need the AccountLayer `_call` proxy and any\n * wallet may submit it. Funds go to the `receiver` baked into each part, not to\n * the caller.\n *\n * Dry-runs the call with {@link simulateFinalizeWithdrawRequest} first unless\n * `simulateBeforeWrite` 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 - The request's owner subaccount, request id, 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`, ...) — including\n *   when the cooldown has not yet elapsed.\n *\n * @example\n * ```ts\n * const hash = await finalizeWithdrawRequest(config, { user: \"0xsub…\", requestId: 1n });\n * ```\n */\nexport async function finalizeWithdrawRequest(\n  config: Config,\n  parameters: FinalizeWithdrawRequestParameters,\n): Promise<FinalizeWithdrawRequestReturnType> {\n  const { chainId, user, requestId, from } = parameters;\n\n  const { addresses } = config.getChainConfig(chainId);\n  const walletClient = await config.getWalletClient({ chainId, from });\n\n  if (shouldSimulateBeforeWrite(config, parameters)) {\n    await simulateFinalizeWithdrawRequest(config, { chainId, user, requestId, from: walletClient.account.address });\n  }\n\n  return walletClient.writeContract({\n    address: addresses.symmioAddress,\n    abi: symmioAbi,\n    functionName: \"finalizeWithdrawRequest\",\n    args: [user, requestId],\n    account: walletClient.account,\n    chain: walletClient.chain,\n  });\n}\n"],"mappings":";;;;AA8CA,eAAsB,EACpB,GACA,GAC4C;CAC5C,IAAM,EAAE,YAAS,SAAM,cAAW,YAAS,GAErC,EAAE,iBAAc,EAAO,eAAe,CAAO,GAC7C,IAAe,MAAM,EAAO,gBAAgB;EAAE;EAAS;CAAK,CAAC;CAMnE,OAJI,EAA0B,GAAQ,CAAU,KAC9C,MAAM,EAAgC,GAAQ;EAAE;EAAS;EAAM;EAAW,MAAM,EAAa,QAAQ;CAAQ,CAAC,GAGzG,EAAa,cAAc;EAChC,SAAS,EAAU;EACnB,KAAK;EACL,cAAc;EACd,MAAM,CAAC,GAAM,CAAS;EACtB,SAAS,EAAa;EACtB,OAAO,EAAa;CACtB,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/get-fee-for-user.d.ts

@@ -0,0 +1,45 @@
+import { Address } from 'viem';
+import { Config } from '../../../core/config';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+/** Fee settings returned by SYMMIO for a user, affiliate, and symbol id. */
+export interface FeeForUser {
+    /** Opening fee rate in 18-decimal fixed point units. */
+    openFee: bigint;
+    /** Closing fee rate in 18-decimal fixed point units. */
+    closeFee: bigint;
+    /** Whether the contract has an explicit fee entry for the pair. */
+    isSet: boolean;
+}
+/**
+ * Parameters for {@link getFeeForUser}.
+ */
+export type GetFeeForUserParameters = Compute<ChainIdParameter & {
+    /** Affiliate address used by the fee lookup. Defaults to the chain config affiliate. */
+    affiliate?: Address;
+    /** User/account address passed to `getFeeForUser`. */
+    user: Address;
+    /** SYMMIO symbol id passed to `getFeeForUser`. */
+    symbolId: bigint | number;
+}>;
+/** Return type of {@link getFeeForUser}: normalized fee tuple fields. */
+export type GetFeeForUserReturnType = FeeForUser;
+/**
+ * Read the SYMMIO fee configuration for a user and symbol.
+ *
+ * If `affiliate` is omitted, the chain config's `addresses.affiliatesAddress`
+ * is used. Fee values are raw 18-decimal fixed point rates from the contract.
+ *
+ * @param config - The SDK config.
+ * @param parameters - User/account, symbol id, optional affiliate, and optional chain id.
+ * @returns The open fee, close fee, and `isSet` flag.
+ * @throws {SymmError} when the chain is not supported.
+ * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.
+ *
+ * @example
+ * ```ts
+ * const fee = await getFeeForUser(config, { user, symbolId: 1n });
+ * console.log(fee.openFee);
+ * ```
+ */
+export declare function getFeeForUser(config: Config, parameters: GetFeeForUserParameters): Promise<GetFeeForUserReturnType>;
+//# sourceMappingURL=get-fee-for-user.d.ts.map

package/dist/symmio-contracts/symmio/actions/get-fee-for-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-fee-for-user.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/get-fee-for-user.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;AAGlF,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC3C,gBAAgB,GAAG;IACjB,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B,CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,uBAAuB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAkBlC"}

package/dist/symmio-contracts/symmio/actions/get-fee-for-user.js

@@ -0,0 +1,23 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+//#region src/symmio-contracts/symmio/actions/get-fee-for-user.ts
+async function t(t, n) {
+	let { chainId: r, affiliate: i, user: a, symbolId: o } = n, { addresses: s } = t.getChainConfig(r), c = await t.getClient({ chainId: r }).readContract({
+		address: s.symmioAddress,
+		abi: e,
+		functionName: "getFeeForUser",
+		args: [
+			i ?? s.affiliatesAddress,
+			a,
+			BigInt(o)
+		]
+	});
+	return {
+		openFee: c.openFee,
+		closeFee: c.closeFee,
+		isSet: c.isSet
+	};
+}
+//#endregion
+export { t as getFeeForUser };
+
+//# sourceMappingURL=get-fee-for-user.js.map

package/dist/symmio-contracts/symmio/actions/get-fee-for-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-fee-for-user.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/get-fee-for-user.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\";\n\n/** Fee settings returned by SYMMIO for a user, affiliate, and symbol id. */\nexport interface FeeForUser {\n  /** Opening fee rate in 18-decimal fixed point units. */\n  openFee: bigint;\n  /** Closing fee rate in 18-decimal fixed point units. */\n  closeFee: bigint;\n  /** Whether the contract has an explicit fee entry for the pair. */\n  isSet: boolean;\n}\n\n/**\n * Parameters for {@link getFeeForUser}.\n */\nexport type GetFeeForUserParameters = Compute<\n  ChainIdParameter & {\n    /** Affiliate address used by the fee lookup. Defaults to the chain config affiliate. */\n    affiliate?: Address;\n    /** User/account address passed to `getFeeForUser`. */\n    user: Address;\n    /** SYMMIO symbol id passed to `getFeeForUser`. */\n    symbolId: bigint | number;\n  }\n>;\n\n/** Return type of {@link getFeeForUser}: normalized fee tuple fields. */\nexport type GetFeeForUserReturnType = FeeForUser;\n\n/**\n * Read the SYMMIO fee configuration for a user and symbol.\n *\n * If `affiliate` is omitted, the chain config's `addresses.affiliatesAddress`\n * is used. Fee values are raw 18-decimal fixed point rates from the contract.\n *\n * @param config - The SDK config.\n * @param parameters - User/account, symbol id, optional affiliate, and optional chain id.\n * @returns The open fee, close fee, and `isSet` flag.\n * @throws {SymmError} when the chain is not supported.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const fee = await getFeeForUser(config, { user, symbolId: 1n });\n * console.log(fee.openFee);\n * ```\n */\nexport async function getFeeForUser(\n  config: Config,\n  parameters: GetFeeForUserParameters,\n): Promise<GetFeeForUserReturnType> {\n  const { chainId, affiliate, user, symbolId } = parameters;\n\n  const { addresses } = config.getChainConfig(chainId);\n  const client = config.getClient({ chainId });\n\n  const fee = await client.readContract({\n    address: addresses.symmioAddress,\n    abi: symmioAbi,\n    functionName: \"getFeeForUser\",\n    args: [affiliate ?? addresses.affiliatesAddress, user, BigInt(symbolId)],\n  });\n\n  return {\n    openFee: fee.openFee,\n    closeFee: fee.closeFee,\n    isSet: fee.isSet,\n  };\n}\n"],"mappings":";;AAkDA,eAAsB,EACpB,GACA,GACkC;CAClC,IAAM,EAAE,YAAS,cAAW,SAAM,gBAAa,GAEzC,EAAE,iBAAc,EAAO,eAAe,CAAO,GAG7C,IAAM,MAFG,EAAO,UAAU,EAAE,WAAQ,CAExB,EAAO,aAAa;EACpC,SAAS,EAAU;EACnB,KAAK;EACL,cAAc;EACd,MAAM;GAAC,KAAa,EAAU;GAAmB;GAAM,OAAO,CAAQ;EAAC;CACzE,CAAC;CAED,OAAO;EACL,SAAS,EAAI;EACb,UAAU,EAAI;EACd,OAAO,EAAI;CACb;AACF"}

package/dist/symmio-contracts/symmio/actions/get-last-withdraw-request-id.d.ts

@@ -0,0 +1,36 @@
+import { Address } from 'viem';
+import { Config } from '../../../core/config';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+/**
+ * Parameters for {@link getLastWithdrawRequestId}.
+ */
+export type GetLastWithdrawRequestIdParameters = Compute<ChainIdParameter & {
+    /** The subaccount whose latest request id to read. */
+    user: Address;
+}>;
+/**
+ * Return type of {@link getLastWithdrawRequestId}: the highest request id (or `0n`
+ * when the subaccount has no requests).
+ */
+export type GetLastWithdrawRequestIdReturnType = bigint;
+/**
+ * Read the most recent withdraw request id for a subaccount.
+ *
+ * Request ids are sequential per user starting at 1; this returns the upper bound
+ * of the id range (0 when there are none). Use it to paginate
+ * {@link "getPendingWithdrawRequests"} or fetch individual requests with
+ * {@link "getWithdrawRequests"}.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Subaccount, optional chain id.
+ * @returns The last assigned request id, or `0n`.
+ * @throws {SymmError} when the chain is not supported.
+ * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.
+ *
+ * @example
+ * ```ts
+ * const lastId = await getLastWithdrawRequestId(config, { user: "0xsub…" });
+ * ```
+ */
+export declare function getLastWithdrawRequestId(config: Config, parameters: GetLastWithdrawRequestIdParameters): Promise<GetLastWithdrawRequestIdReturnType>;
+//# sourceMappingURL=get-last-withdraw-request-id.d.ts.map

package/dist/symmio-contracts/symmio/actions/get-last-withdraw-request-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-last-withdraw-request-id.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/get-last-withdraw-request-id.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;AAGlF;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,OAAO,CACtD,gBAAgB,GAAG;IACjB,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;CACf,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,MAAM,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,kCAAkC,GAC7C,OAAO,CAAC,kCAAkC,CAAC,CAY7C"}

package/dist/symmio-contracts/symmio/actions/get-last-withdraw-request-id.js

@@ -0,0 +1,15 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+//#region src/symmio-contracts/symmio/actions/get-last-withdraw-request-id.ts
+async function t(t, n) {
+	let { chainId: r, user: i } = n, { addresses: a } = t.getChainConfig(r);
+	return t.getClient({ chainId: r }).readContract({
+		address: a.symmioAddress,
+		abi: e,
+		functionName: "getLastWithdrawRequestId",
+		args: [i]
+	});
+}
+//#endregion
+export { t as getLastWithdrawRequestId };
+
+//# sourceMappingURL=get-last-withdraw-request-id.js.map

package/dist/symmio-contracts/symmio/actions/get-last-withdraw-request-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-last-withdraw-request-id.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/get-last-withdraw-request-id.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\";\n\n/**\n * Parameters for {@link getLastWithdrawRequestId}.\n */\nexport type GetLastWithdrawRequestIdParameters = Compute<\n  ChainIdParameter & {\n    /** The subaccount whose latest request id to read. */\n    user: Address;\n  }\n>;\n\n/**\n * Return type of {@link getLastWithdrawRequestId}: the highest request id (or `0n`\n * when the subaccount has no requests).\n */\nexport type GetLastWithdrawRequestIdReturnType = bigint;\n\n/**\n * Read the most recent withdraw request id for a subaccount.\n *\n * Request ids are sequential per user starting at 1; this returns the upper bound\n * of the id range (0 when there are none). Use it to paginate\n * {@link \"getPendingWithdrawRequests\"} or fetch individual requests with\n * {@link \"getWithdrawRequests\"}.\n *\n * @param config - The SDK config.\n * @param parameters - Subaccount, optional chain id.\n * @returns The last assigned request id, or `0n`.\n * @throws {SymmError} when the chain is not supported.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const lastId = await getLastWithdrawRequestId(config, { user: \"0xsub…\" });\n * ```\n */\nexport async function getLastWithdrawRequestId(\n  config: Config,\n  parameters: GetLastWithdrawRequestIdParameters,\n): Promise<GetLastWithdrawRequestIdReturnType> {\n  const { chainId, user } = 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: \"getLastWithdrawRequestId\",\n    args: [user],\n  });\n}\n"],"mappings":";;AAwCA,eAAsB,EACpB,GACA,GAC6C;CAC7C,IAAM,EAAE,YAAS,YAAS,GAEpB,EAAE,iBAAc,EAAO,eAAe,CAAO;CAGnD,OAFe,EAAO,UAAU,EAAE,WAAQ,CAEnC,EAAO,aAAa;EACzB,SAAS,EAAU;EACnB,KAAK;EACL,cAAc;EACd,MAAM,CAAC,CAAI;CACb,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/get-onchain-contract-markets.d.ts

@@ -0,0 +1,54 @@
+import { Config } from '../../../core/config';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+/** On-chain market metadata returned by SYMMIO core `getSymbols`. */
+export interface OnchainContractMarket {
+    /** SYMMIO symbol id. */
+    symbolId: bigint;
+    /** Contract-level market name, such as `BTCUSDT`. */
+    name: string;
+    /** Whether the market is currently valid for trading. */
+    isValid: boolean;
+    /** Minimum acceptable quote value in raw 18-decimal units. */
+    minAcceptableQuoteValue: bigint;
+    /** Minimum acceptable liquidation-fee portion in raw 18-decimal units. */
+    minAcceptablePortionLF: bigint;
+    /** Trading fee rate in raw 18-decimal fixed point units. */
+    tradingFee: bigint;
+    /** Maximum leverage in raw 18-decimal fixed point units. */
+    maxLeverage: bigint;
+    /** Funding-rate epoch duration in seconds. */
+    fundingRateEpochDuration: bigint;
+    /** Funding-rate window time in seconds. */
+    fundingRateWindowTime: bigint;
+}
+/**
+ * Parameters for {@link getOnchainContractMarkets}.
+ */
+export type GetOnchainContractMarketsParameters = Compute<ChainIdParameter & {
+    /** Start offset passed to SYMMIO core `getSymbols`. */
+    start: bigint | number;
+    /** Page size passed to SYMMIO core `getSymbols`. */
+    size: bigint | number;
+}>;
+/** Return type of {@link getOnchainContractMarkets}: on-chain contract markets. */
+export type GetOnchainContractMarketsReturnType = readonly OnchainContractMarket[];
+/**
+ * Read paginated on-chain contract markets from SYMMIO core.
+ *
+ * This calls the SYMMIO core `getSymbols(start, size)` view and returns its
+ * named symbol fields.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Start offset, page size, and optional chain id.
+ * @returns A page of on-chain contract markets.
+ * @throws {SymmError} when the chain is not supported.
+ * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.
+ *
+ * @example
+ * ```ts
+ * const markets = await getOnchainContractMarkets(config, { start: 0, size: 100 });
+ * console.log(markets[0]?.name);
+ * ```
+ */
+export declare function getOnchainContractMarkets(config: Config, parameters: GetOnchainContractMarketsParameters): Promise<GetOnchainContractMarketsReturnType>;
+//# sourceMappingURL=get-onchain-contract-markets.d.ts.map

package/dist/symmio-contracts/symmio/actions/get-onchain-contract-markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-onchain-contract-markets.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/get-onchain-contract-markets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAGlF,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,uBAAuB,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,wBAAwB,EAAE,MAAM,CAAC;IACjC,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,OAAO,CACvD,gBAAgB,GAAG;IACjB,uDAAuD;IACvD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,oDAAoD;IACpD,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CACF,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,mCAAmC,GAAG,SAAS,qBAAqB,EAAE,CAAC;AAEnF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,mCAAmC,GAC9C,OAAO,CAAC,mCAAmC,CAAC,CAY9C"}

package/dist/symmio-contracts/symmio/actions/get-onchain-contract-markets.js

@@ -0,0 +1,15 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+//#region src/symmio-contracts/symmio/actions/get-onchain-contract-markets.ts
+async function t(t, n) {
+	let { chainId: r, start: i, size: a } = n, { addresses: o } = t.getChainConfig(r);
+	return t.getClient({ chainId: r }).readContract({
+		address: o.symmioAddress,
+		abi: e,
+		functionName: "getSymbols",
+		args: [BigInt(i), BigInt(a)]
+	});
+}
+//#endregion
+export { t as getOnchainContractMarkets };
+
+//# sourceMappingURL=get-onchain-contract-markets.js.map

package/dist/symmio-contracts/symmio/actions/get-onchain-contract-markets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-onchain-contract-markets.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/get-onchain-contract-markets.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/** On-chain market metadata returned by SYMMIO core `getSymbols`. */\nexport interface OnchainContractMarket {\n  /** SYMMIO symbol id. */\n  symbolId: bigint;\n  /** Contract-level market name, such as `BTCUSDT`. */\n  name: string;\n  /** Whether the market is currently valid for trading. */\n  isValid: boolean;\n  /** Minimum acceptable quote value in raw 18-decimal units. */\n  minAcceptableQuoteValue: bigint;\n  /** Minimum acceptable liquidation-fee portion in raw 18-decimal units. */\n  minAcceptablePortionLF: bigint;\n  /** Trading fee rate in raw 18-decimal fixed point units. */\n  tradingFee: bigint;\n  /** Maximum leverage in raw 18-decimal fixed point units. */\n  maxLeverage: bigint;\n  /** Funding-rate epoch duration in seconds. */\n  fundingRateEpochDuration: bigint;\n  /** Funding-rate window time in seconds. */\n  fundingRateWindowTime: bigint;\n}\n\n/**\n * Parameters for {@link getOnchainContractMarkets}.\n */\nexport type GetOnchainContractMarketsParameters = Compute<\n  ChainIdParameter & {\n    /** Start offset passed to SYMMIO core `getSymbols`. */\n    start: bigint | number;\n    /** Page size passed to SYMMIO core `getSymbols`. */\n    size: bigint | number;\n  }\n>;\n\n/** Return type of {@link getOnchainContractMarkets}: on-chain contract markets. */\nexport type GetOnchainContractMarketsReturnType = readonly OnchainContractMarket[];\n\n/**\n * Read paginated on-chain contract markets from SYMMIO core.\n *\n * This calls the SYMMIO core `getSymbols(start, size)` view and returns its\n * named symbol fields.\n *\n * @param config - The SDK config.\n * @param parameters - Start offset, page size, and optional chain id.\n * @returns A page of on-chain contract markets.\n * @throws {SymmError} when the chain is not supported.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const markets = await getOnchainContractMarkets(config, { start: 0, size: 100 });\n * console.log(markets[0]?.name);\n * ```\n */\nexport async function getOnchainContractMarkets(\n  config: Config,\n  parameters: GetOnchainContractMarketsParameters,\n): Promise<GetOnchainContractMarketsReturnType> {\n  const { chainId, start, size } = 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: \"getSymbols\",\n    args: [BigInt(start), BigInt(size)],\n  });\n}\n"],"mappings":";;AA2DA,eAAsB,EACpB,GACA,GAC8C;CAC9C,IAAM,EAAE,YAAS,UAAO,YAAS,GAE3B,EAAE,iBAAc,EAAO,eAAe,CAAO;CAGnD,OAFe,EAAO,UAAU,EAAE,WAAQ,CAEnC,EAAO,aAAa;EACzB,SAAS,EAAU;EACnB,KAAK;EACL,cAAc;EACd,MAAM,CAAC,OAAO,CAAK,GAAG,OAAO,CAAI,CAAC;CACpC,CAAC;AACH"}

package/dist/symmio-contracts/symmio/actions/get-party-a-open-positions.d.ts

@@ -0,0 +1,53 @@
+import { Address } from 'viem';
+import { Config } from '../../../core/config';
+import { ChainIdParameter, Compute } from '../../../shared/types/properties';
+import { Quote } from '../types';
+/**
+ * Parameters for {@link getPartyAOpenPositions}.
+ */
+export type GetPartyAOpenPositionsParameters = Compute<ChainIdParameter & {
+    /** The partyA whose open positions to read — a SubAccount (Majors) or Virtual Account (VibeCaps). */
+    partyA: Address;
+    /**
+     * Pagination offset into partyA's open-positions list.
+     * @default 0n
+     */
+    start?: bigint;
+    /**
+     * Maximum number of positions to return from `start`. Clamped on-chain to the
+     * number remaining.
+     * @default 200n
+     */
+    size?: bigint;
+}>;
+/** Return type of {@link getPartyAOpenPositions}: the open-position quotes in range. */
+export type GetPartyAOpenPositionsReturnType = readonly Quote[];
+/**
+ * Read a partyA's open positions (full {@link Quote} structs) within a paginated
+ * range.
+ *
+ * Returns only quotes in `OPENED`, `CLOSE_PENDING`, `CANCEL_CLOSE_PENDING`, or
+ * `LIQUIDATED_PENDING` status. The underlying storage list is maintained with
+ * swap-and-pop removal, so **ordering is not stable** — closing or liquidating a
+ * position can reorder the list between calls; do not rely on index positions
+ * across paginated reads.
+ *
+ * @remarks
+ * `size` is clamped on-chain to the number of positions remaining after `start`,
+ * so `start === length` yields an empty array. A `start` **greater than** the
+ * list length reverts (Solidity arithmetic panic); read the count first if you
+ * cannot bound `start`.
+ *
+ * @param config - The SDK config.
+ * @param parameters - PartyA, optional pagination (`start`/`size`), optional chain id.
+ * @returns The open-position quotes found in the scanned range.
+ * @throws {SymmError} when the chain is not supported.
+ * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.
+ *
+ * @example
+ * ```ts
+ * const positions = await getPartyAOpenPositions(config, { partyA: "0xva…" });
+ * ```
+ */
+export declare function getPartyAOpenPositions(config: Config, parameters: GetPartyAOpenPositionsParameters): Promise<GetPartyAOpenPositionsReturnType>;
+//# sourceMappingURL=get-party-a-open-positions.d.ts.map

package/dist/symmio-contracts/symmio/actions/get-party-a-open-positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-party-a-open-positions.d.ts","sourceRoot":"","sources":["../../../../src/symmio-contracts/symmio/actions/get-party-a-open-positions.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;AAEtC;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,OAAO,CACpD,gBAAgB,GAAG;IACjB,qGAAqG;IACrG,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CACF,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,gCAAgC,GAAG,SAAS,KAAK,EAAE,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,gCAAgC,GAC3C,OAAO,CAAC,gCAAgC,CAAC,CAY3C"}

package/dist/symmio-contracts/symmio/actions/get-party-a-open-positions.js

@@ -0,0 +1,19 @@
+import { symmioAbi as e } from "../../abi/v0.8.5/symmio.js";
+//#region src/symmio-contracts/symmio/actions/get-party-a-open-positions.ts
+async function t(t, n) {
+	let { chainId: r, partyA: i, start: a = 0n, size: o = 200n } = n, { addresses: s } = t.getChainConfig(r);
+	return t.getClient({ chainId: r }).readContract({
+		address: s.symmioAddress,
+		abi: e,
+		functionName: "getPartyAOpenPositions",
+		args: [
+			i,
+			a,
+			o
+		]
+	});
+}
+//#endregion
+export { t as getPartyAOpenPositions };
+
+//# sourceMappingURL=get-party-a-open-positions.js.map

package/dist/symmio-contracts/symmio/actions/get-party-a-open-positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-party-a-open-positions.js","names":[],"sources":["../../../../src/symmio-contracts/symmio/actions/get-party-a-open-positions.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\";\n\n/**\n * Parameters for {@link getPartyAOpenPositions}.\n */\nexport type GetPartyAOpenPositionsParameters = Compute<\n  ChainIdParameter & {\n    /** The partyA whose open positions to read — a SubAccount (Majors) or Virtual Account (VibeCaps). */\n    partyA: Address;\n    /**\n     * Pagination offset into partyA's open-positions list.\n     * @default 0n\n     */\n    start?: bigint;\n    /**\n     * Maximum number of positions to return from `start`. Clamped on-chain to the\n     * number remaining.\n     * @default 200n\n     */\n    size?: bigint;\n  }\n>;\n\n/** Return type of {@link getPartyAOpenPositions}: the open-position quotes in range. */\nexport type GetPartyAOpenPositionsReturnType = readonly Quote[];\n\n/**\n * Read a partyA's open positions (full {@link Quote} structs) within a paginated\n * range.\n *\n * Returns only quotes in `OPENED`, `CLOSE_PENDING`, `CANCEL_CLOSE_PENDING`, or\n * `LIQUIDATED_PENDING` status. The underlying storage list is maintained with\n * swap-and-pop removal, so **ordering is not stable** — closing or liquidating a\n * position can reorder the list between calls; do not rely on index positions\n * across paginated reads.\n *\n * @remarks\n * `size` is clamped on-chain to the number of positions remaining after `start`,\n * so `start === length` yields an empty array. A `start` **greater than** the\n * list length reverts (Solidity arithmetic panic); read the count first if you\n * cannot bound `start`.\n *\n * @param config - The SDK config.\n * @param parameters - PartyA, optional pagination (`start`/`size`), optional chain id.\n * @returns The open-position quotes found in the scanned range.\n * @throws {SymmError} when the chain is not supported.\n * @throws Viem's `ContractFunctionExecutionError` and friends for on-chain failures.\n *\n * @example\n * ```ts\n * const positions = await getPartyAOpenPositions(config, { partyA: \"0xva…\" });\n * ```\n */\nexport async function getPartyAOpenPositions(\n  config: Config,\n  parameters: GetPartyAOpenPositionsParameters,\n): Promise<GetPartyAOpenPositionsReturnType> {\n  const { chainId, partyA, start = 0n, size = 200n } = 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: \"getPartyAOpenPositions\",\n    args: [partyA, start, size],\n  });\n}\n"],"mappings":";;AAyDA,eAAsB,EACpB,GACA,GAC2C;CAC3C,IAAM,EAAE,YAAS,WAAQ,WAAQ,IAAI,UAAO,SAAS,GAE/C,EAAE,iBAAc,EAAO,eAAe,CAAO;CAGnD,OAFe,EAAO,UAAU,EAAE,WAAQ,CAEnC,EAAO,aAAa;EACzB,SAAS,EAAU;EACnB,KAAK;EACL,cAAc;EACd,MAAM;GAAC;GAAQ;GAAO;EAAI;CAC5B,CAAC;AACH"}