@symmio/trading-react 1.1.0 → 3.0.0

package/dist/tpsl/use-watch-tpsl-accounts.js

@@ -0,0 +1,44 @@
+"use client";
+import { useSymmioConfig as e } from "../provider/use-symmio-config.js";
+import { useTpSlStore as t } from "./tpsl-store.js";
+import { linkTpSlNotificationIds as n, matchTpSlNotification as r } from "./match-tpsl-notification.js";
+import { supportsTpSl as i, watchTpSlNotifications as a } from "@symmio/trading-core";
+import { useEffect as o, useRef as s } from "react";
+//#region src/tpsl/use-watch-tpsl-accounts.ts
+function c(c) {
+	let { accounts: l, ids: u, chainId: d, enabled: f = !0 } = c, p = e(c), m = i(p, { chainId: d }), h = s(u);
+	h.current = u, o(() => {
+		if (!f || !m || l.length === 0) return;
+		let e = (e) => {
+			n(e);
+			let i = r(e, h.current);
+			i !== void 0 && t.getState().applyNotification(i, e);
+		}, i = l.map((t) => a(p, {
+			account: t,
+			chainId: d,
+			onNotification: e
+		}));
+		return () => {
+			for (let e of i) e();
+		};
+	}, [
+		l.map((e) => e.toLowerCase()).join(","),
+		d,
+		p,
+		f,
+		m
+	]);
+}
+function l(e) {
+	let t = /* @__PURE__ */ new Set(), n = [];
+	for (let r of e) {
+		if (!r) continue;
+		let e = r.toLowerCase();
+		t.has(e) || (t.add(e), n.push(r));
+	}
+	return n;
+}
+//#endregion
+export { l as dedupeAddresses, c as useWatchTpSlAccounts };
+
+//# sourceMappingURL=use-watch-tpsl-accounts.js.map

package/dist/tpsl/use-watch-tpsl-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-watch-tpsl-accounts.js","names":[],"sources":["../../src/tpsl/use-watch-tpsl-accounts.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  supportsTpSl,\n  watchTpSlNotifications,\n  type ConfigParameter,\n  type TpSlNotification,\n} from \"@symmio/trading-core\";\nimport { useEffect, useRef } from \"react\";\nimport type { Address } from \"viem\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { linkTpSlNotificationIds, matchTpSlNotification } from \"./match-tpsl-notification\";\nimport { useTpSlStore } from \"./tpsl-store\";\n\n/** Parameters for {@link useWatchTpSlAccounts}. */\nexport interface UseWatchTpSlAccountsParameters extends ConfigParameter {\n  /** Accounts to subscribe to. A grouped position can span Virtual Accounts. */\n  accounts: readonly Address[];\n  /** Quote ids an incoming frame may belong to; read live inside the handler. */\n  ids: readonly (bigint | undefined)[];\n  /** Target chain id. Defaults to the config's default chain. */\n  chainId?: number;\n  /** Subscribe only when `true`. Default `true`. */\n  enabled?: boolean;\n}\n\n/**\n * Subscribe to the TP/SL stream of several accounts at once and fold every\n * matching frame into the shared TP/SL store.\n *\n * `useWatchTpSlNotifications` cannot cover this: the account count changes as a\n * group grows, and a hook cannot be called in a loop. So this drives the core\n * watcher directly from one effect. The SDK's socket pool keys on\n * `(wsUrl, appName, account)`, so subscribing here adds handlers to sockets\n * other hooks already opened rather than new connections.\n *\n * Frames land in the store rather than in a caller-supplied callback, because\n * the store is what every consumer — read hooks, run hooks, cells — reconciles\n * against. That way a step confirms no matter which subscription received it.\n *\n * @param parameters - The accounts to watch, the candidate quote ids, and the enable switch.\n */\nexport function useWatchTpSlAccounts(parameters: UseWatchTpSlAccountsParameters): void {\n  const { accounts, ids, chainId, enabled = true } = parameters;\n  const config = useSymmioConfig(parameters);\n  // The resolved solver may have no TP/SL handler (e.g. a rasa solver on Base);\n  // subscribing would throw `TPSL_NOT_CONFIGURED`. Skip when unsupported.\n  const supported = supportsTpSl(config, { chainId });\n\n  /** Read the live id list from inside the long-lived socket handler. */\n  const idsRef = useRef(ids);\n  idsRef.current = ids;\n\n  /** Re-subscribe only when the account set genuinely changes. */\n  const accountsKey = accounts.map((account) => account.toLowerCase()).join(\",\");\n\n  useEffect(() => {\n    if (!enabled || !supported || accounts.length === 0) return;\n\n    const onNotification = (notification: TpSlNotification) => {\n      linkTpSlNotificationIds(notification);\n      const target = matchTpSlNotification(notification, idsRef.current);\n      if (target === undefined) return;\n      useTpSlStore.getState().applyNotification(target, notification);\n    };\n\n    const unwatchers = accounts.map((account) => watchTpSlNotifications(config, { account, chainId, onNotification }));\n    return () => {\n      for (const unwatch of unwatchers) unwatch();\n    };\n    // `accountsKey` stands in for `accounts` — a fresh array with the same\n    // members must not tear down and rebuild the subscriptions.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [accountsKey, chainId, config, enabled, supported]);\n}\n\n/** Case-insensitive address dedupe that preserves first-seen order. */\nexport function dedupeAddresses(addresses: readonly (Address | undefined)[]): Address[] {\n  const seen = new Set<string>();\n  const unique: Address[] = [];\n  for (const address of addresses) {\n    if (!address) continue;\n    const normalized = address.toLowerCase();\n    if (seen.has(normalized)) continue;\n    seen.add(normalized);\n    unique.push(address);\n  }\n  return unique;\n}\n"],"mappings":";;;;;;;AA0CA,SAAgB,EAAqB,GAAkD;CACrF,IAAM,EAAE,aAAU,QAAK,YAAS,aAAU,OAAS,GAC7C,IAAS,EAAgB,CAAU,GAGnC,IAAY,EAAa,GAAQ,EAAE,WAAQ,CAAC,GAG5C,IAAS,EAAO,CAAG;CAMzB,AALA,EAAO,UAAU,GAKjB,QAAgB;EACd,IAAI,CAAC,KAAW,CAAC,KAAa,EAAS,WAAW,GAAG;EAErD,IAAM,KAAkB,MAAmC;GACzD,EAAwB,CAAY;GACpC,IAAM,IAAS,EAAsB,GAAc,EAAO,OAAO;GAC7D,MAAW,KAAA,KACf,EAAa,SAAS,EAAE,kBAAkB,GAAQ,CAAY;EAChE,GAEM,IAAa,EAAS,KAAK,MAAY,EAAuB,GAAQ;GAAE;GAAS;GAAS;EAAe,CAAC,CAAC;EACjH,aAAa;GACX,KAAK,IAAM,KAAW,GAAY,EAAQ;EAC5C;CAIF,GAAG;EAnBiB,EAAS,KAAK,MAAY,EAAQ,YAAY,CAAC,EAAE,KAAK,GAmBtE;EAAa;EAAS;EAAQ;EAAS;CAAS,CAAC;AACvD;AAGA,SAAgB,EAAgB,GAAwD;CACtF,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAoB,CAAC;CAC3B,KAAK,IAAM,KAAW,GAAW;EAC/B,IAAI,CAAC,GAAS;EACd,IAAM,IAAa,EAAQ,YAAY;EACnC,EAAK,IAAI,CAAU,MACvB,EAAK,IAAI,CAAU,GACnB,EAAO,KAAK,CAAO;CACrB;CACA,OAAO;AACT"}

package/dist/trade-volume/index.d.ts

@@ -0,0 +1,2 @@
+export * from './use-trade-volume.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/trade-volume/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trade-volume/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/trade-volume/use-trade-volume.d.ts

@@ -0,0 +1,26 @@
+import { ConfigParameter, GetTradeVolumeOptions, GetTradeVolumeReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Parameters for {@link useTradeVolume}: the core query options (required
+ * `symbolId`, chain id, TanStack `query` overrides) plus an optional `config`.
+ */
+export type UseTradeVolumeParameters = GetTradeVolumeOptions & ConfigParameter;
+/** Return type of {@link useTradeVolume}. */
+export type UseTradeVolumeReturnType = UseQueryResult<GetTradeVolumeReturnType, SymmioRequestError>;
+/**
+ * Read the last N daily trade-volume rows for one market from the active chain's
+ * enigma solver. Rows are ascending by day. The query is disabled until a
+ * positive `symbolId` is supplied.
+ *
+ * Does not poll by default; pass `query.refetchInterval` to opt into polling.
+ * Errors are normalized to {@link SymmioRequestError}.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useTradeVolume({ symbolId: 1 });
+ * const latest = data?.at(-1);
+ * ```
+ */
+export declare function useTradeVolume(parameters: UseTradeVolumeParameters): UseTradeVolumeReturnType;
+//# sourceMappingURL=use-trade-volume.d.ts.map

package/dist/trade-volume/use-trade-volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trade-volume.d.ts","sourceRoot":"","sources":["../../src/trade-volume/use-trade-volume.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAE/E,6CAA6C;AAC7C,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;AAEpG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,wBAAwB,GAAG,wBAAwB,CAkB7F"}

package/dist/trade-volume/use-trade-volume.js

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getTradeVolumeQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/trade-volume/use-trade-volume.ts
+function a(a) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useTradeVolume };
+
+//# sourceMappingURL=use-trade-volume.js.map

package/dist/trade-volume/use-trade-volume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trade-volume.js","names":[],"sources":["../../src/trade-volume/use-trade-volume.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getTradeVolumeQueryOptions,\n  type ConfigParameter,\n  type GetTradeVolumeOptions,\n  type GetTradeVolumeReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useTradeVolume}: the core query options (required\n * `symbolId`, chain id, TanStack `query` overrides) plus an optional `config`.\n */\nexport type UseTradeVolumeParameters = GetTradeVolumeOptions & ConfigParameter;\n\n/** Return type of {@link useTradeVolume}. */\nexport type UseTradeVolumeReturnType = UseQueryResult<GetTradeVolumeReturnType, SymmioRequestError>;\n\n/**\n * Read the last N daily trade-volume rows for one market from the active chain's\n * enigma solver. Rows are ascending by day. The query is disabled until a\n * positive `symbolId` is supplied.\n *\n * Does not poll by default; pass `query.refetchInterval` to opt into polling.\n * Errors are normalized to {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const { data } = useTradeVolume({ symbolId: 1 });\n * const latest = data?.at(-1);\n * ```\n */\nexport function useTradeVolume(parameters: UseTradeVolumeParameters): UseTradeVolumeReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getTradeVolumeQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseTradeVolumeReturnType;\n}\n"],"mappings":";;;;;;;AAqCA,SAAgB,EAAe,GAAgE;CAC7F,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAA2B,GAAQ;EACjD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
+export { invalidateAccountBalances } from './invalidate-account-balances.js';
 export { predicateMatch } from './predicate-match.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/invalidate-account-balances.d.ts

@@ -0,0 +1,36 @@
+import { QueryClient } from '@tanstack/react-query';
+/**
+ * Invalidate every cached sub-account balance read — `balanceOf` and
+ * `balanceInfoOfPartyA` — on one chain config.
+ *
+ * Call this from any mutation that moves collateral: an open locks margin and
+ * charges a fee, a close releases margin and realizes PnL, a cancel unlocks a
+ * pending quote's reserved margin. Without it those reads keep serving the
+ * pre-trade value for as long as the consumer's `staleTime` allows, because a
+ * mount only refetches when the entry is already stale.
+ *
+ * Invalidating also covers consumers that are not mounted at the time of the
+ * write. An unmounted query cannot refetch, but it is flagged
+ * `isInvalidated`, and TanStack checks that flag ahead of `staleTime` — so the
+ * next mount refetches no matter how fresh the cached value looks.
+ *
+ * Scoped by `configKey`, not by account, on purpose: a position write can move
+ * both a Virtual Account's balance and its parent sub-account's, while the
+ * mutation variables carry only `partyA` — the VA for isolated positions, the
+ * sub-account for cross-margin, never both.
+ *
+ * @param queryClient - The active TanStack query client.
+ * @param scope - The chain-config fingerprint from `config.getChainConfigKey()`.
+ *
+ * @example
+ * ```ts
+ * onSuccess: (_result, variables) => {
+ *   const configKey = config.getChainConfigKey(variables.chainId ?? chainId);
+ *   invalidateAccountBalances(queryClient, { configKey });
+ * };
+ * ```
+ */
+export declare function invalidateAccountBalances(queryClient: QueryClient, scope: {
+    configKey?: string;
+}): void;
+//# sourceMappingURL=invalidate-account-balances.d.ts.map

package/dist/utils/invalidate-account-balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidate-account-balances.d.ts","sourceRoot":"","sources":["../../src/utils/invalidate-account-balances.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGvG"}

package/dist/utils/invalidate-account-balances.js

@@ -0,0 +1,10 @@
+import { predicateMatch as e } from "./predicate-match.js";
+import { getAccountBalanceInfoQueryKey as t, getAccountBalanceOfQueryKey as n } from "@symmio/trading-core";
+//#region src/utils/invalidate-account-balances.ts
+function r(r, i) {
+	r.invalidateQueries({ predicate: e(n, i) }), r.invalidateQueries({ predicate: e(t, i) });
+}
+//#endregion
+export { r as invalidateAccountBalances };
+
+//# sourceMappingURL=invalidate-account-balances.js.map

package/dist/utils/invalidate-account-balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidate-account-balances.js","names":[],"sources":["../../src/utils/invalidate-account-balances.ts"],"sourcesContent":["import { getAccountBalanceInfoQueryKey, getAccountBalanceOfQueryKey } from \"@symmio/trading-core\";\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport { predicateMatch } from \"./predicate-match\";\n\n/**\n * Invalidate every cached sub-account balance read — `balanceOf` and\n * `balanceInfoOfPartyA` — on one chain config.\n *\n * Call this from any mutation that moves collateral: an open locks margin and\n * charges a fee, a close releases margin and realizes PnL, a cancel unlocks a\n * pending quote's reserved margin. Without it those reads keep serving the\n * pre-trade value for as long as the consumer's `staleTime` allows, because a\n * mount only refetches when the entry is already stale.\n *\n * Invalidating also covers consumers that are not mounted at the time of the\n * write. An unmounted query cannot refetch, but it is flagged\n * `isInvalidated`, and TanStack checks that flag ahead of `staleTime` — so the\n * next mount refetches no matter how fresh the cached value looks.\n *\n * Scoped by `configKey`, not by account, on purpose: a position write can move\n * both a Virtual Account's balance and its parent sub-account's, while the\n * mutation variables carry only `partyA` — the VA for isolated positions, the\n * sub-account for cross-margin, never both.\n *\n * @param queryClient - The active TanStack query client.\n * @param scope - The chain-config fingerprint from `config.getChainConfigKey()`.\n *\n * @example\n * ```ts\n * onSuccess: (_result, variables) => {\n *   const configKey = config.getChainConfigKey(variables.chainId ?? chainId);\n *   invalidateAccountBalances(queryClient, { configKey });\n * };\n * ```\n */\nexport function invalidateAccountBalances(queryClient: QueryClient, scope: { configKey?: string }): void {\n  void queryClient.invalidateQueries({ predicate: predicateMatch(getAccountBalanceOfQueryKey, scope) });\n  void queryClient.invalidateQueries({ predicate: predicateMatch(getAccountBalanceInfoQueryKey, scope) });\n}\n"],"mappings":";;;AAmCA,SAAgB,EAA0B,GAA0B,GAAqC;CAEvG,AADA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAK,EAAE,CAAC,GACpG,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA+B,CAAK,EAAE,CAAC;AACxG"}

package/dist/websocket/use-notifications.d.ts

@@ -1,4 +1,4 @@
-import { ConfigParameter, Notification, SocketStatus } from '@symmio/trading-core';
+import { ConfigParameter, Notification, SocketStatus, SolverId } from '@symmio/trading-core';
 import { Address } from 'viem';
 import { SymmioRequestError } from '../errors/symmio-request-error.js';
 /**
@@ -9,6 +9,8 @@ export interface UseNotificationsParameters extends ConfigParameter {
     account?: Address;
     /** Target chain id. Defaults to the SDK's active chain. */
     chainId?: number;
+    /** Target solver. Defaults to the chain's default solver; selects the notifications endpoint + protocol. */
+    solverId?: SolverId;
     /** Optional per-message callback, invoked in addition to buffering. */
     onNotification?: (notification: Notification) => void;
     /** Max notifications retained in `notifications` (newest-first). Default 50. */

package/dist/websocket/use-notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-notifications.d.ts","sourceRoot":"","sources":["../../src/websocket/use-notifications.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEtH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAOzE;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,+DAA+D;IAC/D,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,MAAM,EAAE,YAAY,CAAC;IACrB,6DAA6D;IAC7D,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,0BAA+B,GAAG,0BAA0B,CAqDxG"}
+{"version":3,"file":"use-notifications.d.ts","sourceRoot":"","sources":["../../src/websocket/use-notifications.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAOzE;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uEAAuE;IACvE,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,+DAA+D;IAC/D,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,MAAM,EAAE,YAAY,CAAC;IACrB,6DAA6D;IAC7D,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,0BAA+B,GAAG,0BAA0B,CAsDxG"}

package/dist/websocket/use-notifications.js

@@ -7,42 +7,44 @@ import { useEffect as i, useRef as a, useState as o } from "react";
 //#region src/websocket/use-notifications.ts
 var s = 50;
 function c(c = {}) {
-	let { account: l, chainId: u, onNotification: d, limit: f = s, enabled: p = !0 } = c, m = t(c), h = e(), g = u ?? h, [_, v] = o([]), [y, b] = o("closed"), [x, S] = o(null), C = a(d);
-	C.current = d;
-	let w = a(f);
+	let { account: l, chainId: u, solverId: d, onNotification: f, limit: p = s, enabled: m = !0 } = c, h = t(c), g = e(), _ = u ?? g, [v, y] = o([]), [b, x] = o("closed"), [S, C] = o(null), w = a(f);
 	w.current = f;
-	let T = p && !!l;
+	let T = a(p);
+	T.current = p;
+	let E = m && !!l;
 	return i(() => {
-		if (!T || !l) {
-			b("closed");
+		if (!E || !l) {
+			x("closed");
 			return;
 		}
-		v([]), S(null);
+		y([]), C(null);
 		let e;
 		try {
-			e = r(m, {
+			e = r(h, {
 				account: l,
-				chainId: g,
+				chainId: _,
+				solverId: d,
 				onNotification: (e) => {
-					v((t) => [e, ...t].slice(0, w.current)), C.current?.(e);
+					y((t) => [e, ...t].slice(0, T.current)), w.current?.(e);
 				},
-				onStatusChange: b,
-				onError: (e) => S(n(e))
+				onStatusChange: x,
+				onError: (e) => C(n(e))
 			});
 		} catch (e) {
-			S(n(e)), b("closed");
+			C(n(e)), x("closed");
 		}
 		return () => e?.();
 	}, [
-		T,
+		E,
 		l,
-		m,
-		g
+		h,
+		_,
+		d
 	]), {
-		notifications: _,
-		latest: _[0] ?? null,
-		status: y,
-		error: x
+		notifications: v,
+		latest: v[0] ?? null,
+		status: b,
+		error: S
 	};
 }
 //#endregion

package/dist/websocket/use-notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-notifications.js","names":[],"sources":["../../src/websocket/use-notifications.ts"],"sourcesContent":["\"use client\";\n\nimport { watchNotifications, type ConfigParameter, type Notification, type SocketStatus } from \"@symmio/trading-core\";\nimport { useEffect, useRef, useState } from \"react\";\nimport type { Address } from \"viem\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/** Default number of notifications retained in the buffer. */\nconst DEFAULT_LIMIT = 50;\n\n/**\n * Parameters for {@link useNotifications}.\n */\nexport interface UseNotificationsParameters extends ConfigParameter {\n  /** SubAccount address to subscribe for. The hook is idle until this is set. */\n  account?: Address;\n  /** Target chain id. Defaults to the SDK's active chain. */\n  chainId?: number;\n  /** Optional per-message callback, invoked in addition to buffering. */\n  onNotification?: (notification: Notification) => void;\n  /** Max notifications retained in `notifications` (newest-first). Default 50. */\n  limit?: number;\n  /** Subscribe only when `true` (and an account is set). Default `true`. */\n  enabled?: boolean;\n}\n\n/**\n * Value returned by {@link useNotifications}.\n */\nexport interface UseNotificationsReturnType {\n  /** Buffered notifications, newest first, capped at `limit`. */\n  notifications: Notification[];\n  /** The most recent notification, or `null`. */\n  latest: Notification | null;\n  /** Live connection status of the underlying socket. */\n  status: SocketStatus;\n  /** The last transport/parse error, normalized, or `null`. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Subscribe to live SYMMIO position/quote notifications for an account.\n *\n * Opens a reconnecting subscription via the SDK's `watchNotifications`, buffers\n * incoming messages newest-first (capped at `limit`), and surfaces the live\n * connection `status`. Pass `onNotification` to also react to each message\n * imperatively. The subscription is torn down on unmount or when `account` /\n * `chainId` / `enabled` change.\n *\n * @example\n * ```tsx\n * const { notifications, status } = useNotifications({ account });\n * return <Badge status={status} count={notifications.length} />;\n * ```\n */\nexport function useNotifications(parameters: UseNotificationsParameters = {}): UseNotificationsReturnType {\n  const { account, chainId, onNotification, limit = DEFAULT_LIMIT, enabled = true } = parameters;\n  const config = useSymmioConfig(parameters);\n  const defaultChainId = useSymmioChainId();\n  const resolvedChainId = chainId ?? defaultChainId;\n\n  const [notifications, setNotifications] = useState<Notification[]>([]);\n  const [status, setStatus] = useState<SocketStatus>(\"closed\");\n  const [error, setError] = useState<SymmioRequestError | null>(null);\n\n  // Keep the latest callback/limit without forcing the subscription to re-open.\n  const onNotificationRef = useRef(onNotification);\n  onNotificationRef.current = onNotification;\n  const limitRef = useRef(limit);\n  limitRef.current = limit;\n\n  const active = enabled && Boolean(account);\n\n  useEffect(() => {\n    if (!active || !account) {\n      setStatus(\"closed\");\n      return;\n    }\n\n    setNotifications([]);\n    setError(null);\n\n    let unwatch: (() => void) | undefined;\n    try {\n      unwatch = watchNotifications(config, {\n        account,\n        chainId: resolvedChainId,\n        onNotification: (notification) => {\n          setNotifications((prev) => [notification, ...prev].slice(0, limitRef.current));\n          onNotificationRef.current?.(notification);\n        },\n        onStatusChange: setStatus,\n        onError: (err) => setError(normalizeSymmError(err)),\n      });\n    } catch (err) {\n      setError(normalizeSymmError(err));\n      setStatus(\"closed\");\n    }\n\n    return () => unwatch?.();\n  }, [active, account, config, resolvedChainId]);\n\n  return {\n    notifications,\n    latest: notifications[0] ?? null,\n    status,\n    error,\n  };\n}\n"],"mappings":";;;;;;;AAWA,IAAM,IAAgB;AA+CtB,SAAgB,EAAiB,IAAyC,CAAC,GAA+B;CACxG,IAAM,EAAE,YAAS,YAAS,mBAAgB,WAAQ,GAAe,aAAU,OAAS,GAC9E,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAkB,KAAW,GAE7B,CAAC,GAAe,KAAoB,EAAyB,CAAC,CAAC,GAC/D,CAAC,GAAQ,KAAa,EAAuB,QAAQ,GACrD,CAAC,GAAO,KAAY,EAAoC,IAAI,GAG5D,IAAoB,EAAO,CAAc;CAC/C,EAAkB,UAAU;CAC5B,IAAM,IAAW,EAAO,CAAK;CAC7B,EAAS,UAAU;CAEnB,IAAM,IAAS,KAAW,EAAQ;CA+BlC,OA7BA,QAAgB;EACd,IAAI,CAAC,KAAU,CAAC,GAAS;GACvB,EAAU,QAAQ;GAClB;EACF;EAGA,AADA,EAAiB,CAAC,CAAC,GACnB,EAAS,IAAI;EAEb,IAAI;EACJ,IAAI;GACF,IAAU,EAAmB,GAAQ;IACnC;IACA,SAAS;IACT,iBAAiB,MAAiB;KAEhC,AADA,GAAkB,MAAS,CAAC,GAAc,GAAG,CAAI,EAAE,MAAM,GAAG,EAAS,OAAO,CAAC,GAC7E,EAAkB,UAAU,CAAY;IAC1C;IACA,gBAAgB;IAChB,UAAU,MAAQ,EAAS,EAAmB,CAAG,CAAC;GACpD,CAAC;EACH,SAAS,GAAK;GAEZ,AADA,EAAS,EAAmB,CAAG,CAAC,GAChC,EAAU,QAAQ;EACpB;EAEA,aAAa,IAAU;CACzB,GAAG;EAAC;EAAQ;EAAS;EAAQ;CAAe,CAAC,GAEtC;EACL;EACA,QAAQ,EAAc,MAAM;EAC5B;EACA;CACF;AACF"}
+{"version":3,"file":"use-notifications.js","names":[],"sources":["../../src/websocket/use-notifications.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  watchNotifications,\n  type ConfigParameter,\n  type Notification,\n  type SocketStatus,\n  type SolverId,\n} from \"@symmio/trading-core\";\nimport { useEffect, useRef, useState } from \"react\";\nimport type { Address } from \"viem\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/** Default number of notifications retained in the buffer. */\nconst DEFAULT_LIMIT = 50;\n\n/**\n * Parameters for {@link useNotifications}.\n */\nexport interface UseNotificationsParameters extends ConfigParameter {\n  /** SubAccount address to subscribe for. The hook is idle until this is set. */\n  account?: Address;\n  /** Target chain id. Defaults to the SDK's active chain. */\n  chainId?: number;\n  /** Target solver. Defaults to the chain's default solver; selects the notifications endpoint + protocol. */\n  solverId?: SolverId;\n  /** Optional per-message callback, invoked in addition to buffering. */\n  onNotification?: (notification: Notification) => void;\n  /** Max notifications retained in `notifications` (newest-first). Default 50. */\n  limit?: number;\n  /** Subscribe only when `true` (and an account is set). Default `true`. */\n  enabled?: boolean;\n}\n\n/**\n * Value returned by {@link useNotifications}.\n */\nexport interface UseNotificationsReturnType {\n  /** Buffered notifications, newest first, capped at `limit`. */\n  notifications: Notification[];\n  /** The most recent notification, or `null`. */\n  latest: Notification | null;\n  /** Live connection status of the underlying socket. */\n  status: SocketStatus;\n  /** The last transport/parse error, normalized, or `null`. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Subscribe to live SYMMIO position/quote notifications for an account.\n *\n * Opens a reconnecting subscription via the SDK's `watchNotifications`, buffers\n * incoming messages newest-first (capped at `limit`), and surfaces the live\n * connection `status`. Pass `onNotification` to also react to each message\n * imperatively. The subscription is torn down on unmount or when `account` /\n * `chainId` / `enabled` change.\n *\n * @example\n * ```tsx\n * const { notifications, status } = useNotifications({ account });\n * return <Badge status={status} count={notifications.length} />;\n * ```\n */\nexport function useNotifications(parameters: UseNotificationsParameters = {}): UseNotificationsReturnType {\n  const { account, chainId, solverId, onNotification, limit = DEFAULT_LIMIT, enabled = true } = parameters;\n  const config = useSymmioConfig(parameters);\n  const defaultChainId = useSymmioChainId();\n  const resolvedChainId = chainId ?? defaultChainId;\n\n  const [notifications, setNotifications] = useState<Notification[]>([]);\n  const [status, setStatus] = useState<SocketStatus>(\"closed\");\n  const [error, setError] = useState<SymmioRequestError | null>(null);\n\n  // Keep the latest callback/limit without forcing the subscription to re-open.\n  const onNotificationRef = useRef(onNotification);\n  onNotificationRef.current = onNotification;\n  const limitRef = useRef(limit);\n  limitRef.current = limit;\n\n  const active = enabled && Boolean(account);\n\n  useEffect(() => {\n    if (!active || !account) {\n      setStatus(\"closed\");\n      return;\n    }\n\n    setNotifications([]);\n    setError(null);\n\n    let unwatch: (() => void) | undefined;\n    try {\n      unwatch = watchNotifications(config, {\n        account,\n        chainId: resolvedChainId,\n        solverId,\n        onNotification: (notification) => {\n          setNotifications((prev) => [notification, ...prev].slice(0, limitRef.current));\n          onNotificationRef.current?.(notification);\n        },\n        onStatusChange: setStatus,\n        onError: (err) => setError(normalizeSymmError(err)),\n      });\n    } catch (err) {\n      setError(normalizeSymmError(err));\n      setStatus(\"closed\");\n    }\n\n    return () => unwatch?.();\n  }, [active, account, config, resolvedChainId, solverId]);\n\n  return {\n    notifications,\n    latest: notifications[0] ?? null,\n    status,\n    error,\n  };\n}\n"],"mappings":";;;;;;;AAiBA,IAAM,IAAgB;AAiDtB,SAAgB,EAAiB,IAAyC,CAAC,GAA+B;CACxG,IAAM,EAAE,YAAS,YAAS,aAAU,mBAAgB,WAAQ,GAAe,aAAU,OAAS,GACxF,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAkB,KAAW,GAE7B,CAAC,GAAe,KAAoB,EAAyB,CAAC,CAAC,GAC/D,CAAC,GAAQ,KAAa,EAAuB,QAAQ,GACrD,CAAC,GAAO,KAAY,EAAoC,IAAI,GAG5D,IAAoB,EAAO,CAAc;CAC/C,EAAkB,UAAU;CAC5B,IAAM,IAAW,EAAO,CAAK;CAC7B,EAAS,UAAU;CAEnB,IAAM,IAAS,KAAW,EAAQ;CAgClC,OA9BA,QAAgB;EACd,IAAI,CAAC,KAAU,CAAC,GAAS;GACvB,EAAU,QAAQ;GAClB;EACF;EAGA,AADA,EAAiB,CAAC,CAAC,GACnB,EAAS,IAAI;EAEb,IAAI;EACJ,IAAI;GACF,IAAU,EAAmB,GAAQ;IACnC;IACA,SAAS;IACT;IACA,iBAAiB,MAAiB;KAEhC,AADA,GAAkB,MAAS,CAAC,GAAc,GAAG,CAAI,EAAE,MAAM,GAAG,EAAS,OAAO,CAAC,GAC7E,EAAkB,UAAU,CAAY;IAC1C;IACA,gBAAgB;IAChB,UAAU,MAAQ,EAAS,EAAmB,CAAG,CAAC;GACpD,CAAC;EACH,SAAS,GAAK;GAEZ,AADA,EAAS,EAAmB,CAAG,CAAC,GAChC,EAAU,QAAQ;EACpB;EAEA,aAAa,IAAU;CACzB,GAAG;EAAC;EAAQ;EAAS;EAAQ;EAAiB;CAAQ,CAAC,GAEhD;EACL;EACA,QAAQ,EAAc,MAAM;EAC5B;EACA;CACF;AACF"}

package/dist/withdraw/index.d.ts

@@ -6,6 +6,7 @@ export * from './use-request-cancel-withdraw.js';
 export * from './use-simulate-finalize-withdraw-request.js';
 export * from './use-simulate-initiate-withdraw.js';
 export * from './use-simulate-request-cancel-withdraw.js';
+export * from './use-withdraw.js';
 export * from './use-withdraw-requests.js';
 export * from './use-withdrawable-time.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/withdraw/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/withdraw/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/withdraw/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/withdraw/use-initiate-withdraw.d.ts

@@ -21,7 +21,7 @@ export type UseInitiateWithdrawReturnType = UseMutationResult<InitiateWithdrawRe
  * ```tsx
  * import { createClassicWithdrawPart } from "@symmio/trading-core";
  * const { mutate } = useInitiateWithdraw();
- * mutate({ account: "0xsub…", parts: [createClassicWithdrawPart({ id: 0n, amount, receiver, chainId: 999n })] });
+ * mutate({ account: "0xsub…", parts: [createClassicWithdrawPart({ id: 0n, amount, receiver, chainId: 42161n })] });
  * ```
  */
 export declare function useInitiateWithdraw(parameters?: UseInitiateWithdrawParameters): UseInitiateWithdrawReturnType;

package/dist/withdraw/use-initiate-withdraw.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-initiate-withdraw.js","names":[],"sources":["../../src/withdraw/use-initiate-withdraw.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getLastWithdrawRequestIdQueryKey,\n  getPendingWithdrawRequestsQueryKey,\n  getWithdrawableTimeQueryKey,\n  initiateWithdrawMutationOptions,\n  type InitiateWithdrawParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { resolveWriteResult, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useInitiateWithdraw}.\n */\nexport type UseInitiateWithdrawParameters = WriteParameters;\n\n/** Result returned by the {@link useInitiateWithdraw} mutation. */\nexport type InitiateWithdrawResult = WriteResult;\n\n/** Return type of {@link useInitiateWithdraw}. */\nexport type UseInitiateWithdrawReturnType = UseMutationResult<\n  InitiateWithdrawResult,\n  SymmioRequestError,\n  InitiateWithdrawParameters\n>;\n\n/**\n * Open a withdraw request for a subaccount (the SDK routes it through the\n * AccountLayer `_call` proxy). The full input surface is exposed via the mutation\n * variables — `parts`, `speedUp`, `providerData`. On success, the subaccount's\n * pending-requests, last-request-id, and withdrawable-time queries are\n * invalidated.\n *\n * @example\n * ```tsx\n * import { createClassicWithdrawPart } from \"@symmio/trading-core\";\n * const { mutate } = useInitiateWithdraw();\n * mutate({ account: \"0xsub…\", parts: [createClassicWithdrawPart({ id: 0n, amount, receiver, chainId: 999n })] });\n * ```\n */\nexport function useInitiateWithdraw(parameters: UseInitiateWithdrawParameters = {}): UseInitiateWithdrawReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = initiateWithdrawMutationOptions(config);\n\n  return useMutation<InitiateWithdrawResult, SymmioRequestError, InitiateWithdrawParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          account: variables.account,\n          parts: variables.parts,\n          speedUp: variables.speedUp,\n          providerData: variables.providerData,\n          simulateBeforeWrite: variables.simulateBeforeWrite,\n          chainId: resolvedChainId,\n        });\n        return resolveWriteResult(config, hash, {\n          chainId: resolvedChainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_result, variables) => {\n      const partial = { user: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPendingWithdrawRequestsQueryKey, partial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getLastWithdrawRequestIdQueryKey, partial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getWithdrawableTimeQueryKey, partial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA8CA,SAAgB,EAAoB,IAA4C,CAAC,GAAkC;CACjH,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAgC,CAAM;CAEnD,OAAO,EAAoF;EACzF,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAS7C,OAAO,EAAmB,GAAQ,MARf,EAAK,WAAW;KACjC,SAAS,EAAU;KACnB,OAAO,EAAU;KACjB,SAAS,EAAU;KACnB,cAAc,EAAU;KACxB,qBAAqB,EAAU;KAC/B,SAAS;IACX,CAAC,GACuC;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GACjC,IAAM,IAAU,EAAE,MAAM,EAAU,QAAQ;GAG1C,AAFA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAoC,CAAO,EAAE,CAAC,GAC7G,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAkC,CAAO,EAAE,CAAC,GAC3G,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAO,EAAE,CAAC;EACxG;CACF,CAAC;AACH"}
+{"version":3,"file":"use-initiate-withdraw.js","names":[],"sources":["../../src/withdraw/use-initiate-withdraw.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getLastWithdrawRequestIdQueryKey,\n  getPendingWithdrawRequestsQueryKey,\n  getWithdrawableTimeQueryKey,\n  initiateWithdrawMutationOptions,\n  type InitiateWithdrawParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { resolveWriteResult, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useInitiateWithdraw}.\n */\nexport type UseInitiateWithdrawParameters = WriteParameters;\n\n/** Result returned by the {@link useInitiateWithdraw} mutation. */\nexport type InitiateWithdrawResult = WriteResult;\n\n/** Return type of {@link useInitiateWithdraw}. */\nexport type UseInitiateWithdrawReturnType = UseMutationResult<\n  InitiateWithdrawResult,\n  SymmioRequestError,\n  InitiateWithdrawParameters\n>;\n\n/**\n * Open a withdraw request for a subaccount (the SDK routes it through the\n * AccountLayer `_call` proxy). The full input surface is exposed via the mutation\n * variables — `parts`, `speedUp`, `providerData`. On success, the subaccount's\n * pending-requests, last-request-id, and withdrawable-time queries are\n * invalidated.\n *\n * @example\n * ```tsx\n * import { createClassicWithdrawPart } from \"@symmio/trading-core\";\n * const { mutate } = useInitiateWithdraw();\n * mutate({ account: \"0xsub…\", parts: [createClassicWithdrawPart({ id: 0n, amount, receiver, chainId: 42161n })] });\n * ```\n */\nexport function useInitiateWithdraw(parameters: UseInitiateWithdrawParameters = {}): UseInitiateWithdrawReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = initiateWithdrawMutationOptions(config);\n\n  return useMutation<InitiateWithdrawResult, SymmioRequestError, InitiateWithdrawParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          account: variables.account,\n          parts: variables.parts,\n          speedUp: variables.speedUp,\n          providerData: variables.providerData,\n          simulateBeforeWrite: variables.simulateBeforeWrite,\n          chainId: resolvedChainId,\n        });\n        return resolveWriteResult(config, hash, {\n          chainId: resolvedChainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_result, variables) => {\n      const partial = { user: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPendingWithdrawRequestsQueryKey, partial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getLastWithdrawRequestIdQueryKey, partial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getWithdrawableTimeQueryKey, partial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA8CA,SAAgB,EAAoB,IAA4C,CAAC,GAAkC;CACjH,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAgC,CAAM;CAEnD,OAAO,EAAoF;EACzF,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAS7C,OAAO,EAAmB,GAAQ,MARf,EAAK,WAAW;KACjC,SAAS,EAAU;KACnB,OAAO,EAAU;KACjB,SAAS,EAAU;KACnB,cAAc,EAAU;KACxB,qBAAqB,EAAU;KAC/B,SAAS;IACX,CAAC,GACuC;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GACjC,IAAM,IAAU,EAAE,MAAM,EAAU,QAAQ;GAG1C,AAFA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAoC,CAAO,EAAE,CAAC,GAC7G,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAkC,CAAO,EAAE,CAAC,GAC3G,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAO,EAAE,CAAC;EACxG;CACF,CAAC;AACH"}

package/dist/withdraw/use-request-cancel-withdraw.d.ts

@@ -12,8 +12,10 @@ export type RequestCancelWithdrawResult = WriteResult;
 export type UseRequestCancelWithdrawReturnType = UseMutationResult<RequestCancelWithdrawResult, SymmioRequestError, RequestCancelWithdrawParameters>;
 /**
  * Request cancellation of a pending withdraw request (routed through the
- * AccountLayer `_call` proxy). On success, the subaccount's pending-requests and
- * single-request queries are invalidated.
+ * AccountLayer `_call` proxy). On success (after the receipt), the subaccount's
+ * balance reads (`balanceInfo`, `balanceOf`) and its pending-requests / requests
+ * queries are invalidated — cancel returns the reserved funds to the available
+ * balance.
  *
  * @example
  * ```tsx

package/dist/withdraw/use-request-cancel-withdraw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-request-cancel-withdraw.d.ts","sourceRoot":"","sources":["../../src/withdraw/use-request-cancel-withdraw.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,+BAA+B,EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,eAAe,CAAC;AAEjE,wEAAwE;AACxE,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC;AAEtD,uDAAuD;AACvD,MAAM,MAAM,kCAAkC,GAAG,iBAAiB,CAChE,2BAA2B,EAC3B,kBAAkB,EAClB,+BAA+B,CAChC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,GAAE,kCAAuC,GAClD,kCAAkC,CAiCpC"}
+{"version":3,"file":"use-request-cancel-withdraw.d.ts","sourceRoot":"","sources":["../../src/withdraw/use-request-cancel-withdraw.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,+BAA+B,EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,eAAe,CAAC;AAEjE,wEAAwE;AACxE,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC;AAEtD,uDAAuD;AACvD,MAAM,MAAM,kCAAkC,GAAG,iBAAiB,CAChE,2BAA2B,EAC3B,kBAAkB,EAClB,+BAA+B,CAChC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,GAAE,kCAAuC,GAClD,kCAAkC,CAyCpC"}

package/dist/withdraw/use-request-cancel-withdraw.js

@@ -4,37 +4,39 @@ import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
 import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
 import { resolveWriteResult as r } from "../transactions/resolve-write-result.js";
 import { predicateMatch as i } from "../utils/predicate-match.js";
-import { getPendingWithdrawRequestsQueryKey as a, getWithdrawRequestsQueryKey as o, requestCancelWithdrawMutationOptions as s } from "@symmio/trading-core";
-import { useMutation as c, useQueryClient as l } from "@tanstack/react-query";
+import { getAccountBalanceInfoQueryKey as a, getAccountBalanceOfQueryKey as o, getPendingWithdrawRequestsQueryKey as s, getWithdrawRequestsQueryKey as c, requestCancelWithdrawMutationOptions as l } from "@symmio/trading-core";
+import { useMutation as u, useQueryClient as d } from "@tanstack/react-query";
 //#region src/withdraw/use-request-cancel-withdraw.ts
-function u(u = {}) {
-	let d = t(u), f = e(), p = l(), m = s(d);
-	return c({
-		mutationKey: m.mutationKey,
+function f(f = {}) {
+	let p = t(f), m = e(), h = d(), g = l(p);
+	return u({
+		mutationKey: g.mutationKey,
 		mutationFn: async (e) => {
 			try {
-				let t = e.chainId ?? f;
-				return r(d, await m.mutationFn({
+				let t = e.chainId ?? m;
+				return r(p, await g.mutationFn({
 					account: e.account,
 					requestId: e.requestId,
 					simulateBeforeWrite: e.simulateBeforeWrite,
 					chainId: t
 				}), {
 					chainId: t,
-					waitForReceipt: u.waitForReceipt,
-					confirmations: u.confirmations
+					waitForReceipt: f.waitForReceipt,
+					confirmations: f.confirmations
 				});
 			} catch (e) {
 				throw n(e);
 			}
 		},
 		onSuccess: (e, t) => {
-			let n = { user: t.account };
-			p.invalidateQueries({ predicate: i(a, n) }), p.invalidateQueries({ predicate: i(o, n) });
+			let n = { account: t.account };
+			h.invalidateQueries({ predicate: i(a, n) }), h.invalidateQueries({ predicate: i(o, n) });
+			let r = { user: t.account };
+			h.invalidateQueries({ predicate: i(s, r) }), h.invalidateQueries({ predicate: i(c, r) });
 		}
 	});
 }
 //#endregion
-export { u as useRequestCancelWithdraw };
+export { f as useRequestCancelWithdraw };
 
 //# sourceMappingURL=use-request-cancel-withdraw.js.map

package/dist/withdraw/use-request-cancel-withdraw.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-request-cancel-withdraw.js","names":[],"sources":["../../src/withdraw/use-request-cancel-withdraw.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getPendingWithdrawRequestsQueryKey,\n  getWithdrawRequestsQueryKey,\n  requestCancelWithdrawMutationOptions,\n  type RequestCancelWithdrawParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { resolveWriteResult, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useRequestCancelWithdraw}.\n */\nexport type UseRequestCancelWithdrawParameters = WriteParameters;\n\n/** Result returned by the {@link useRequestCancelWithdraw} mutation. */\nexport type RequestCancelWithdrawResult = WriteResult;\n\n/** Return type of {@link useRequestCancelWithdraw}. */\nexport type UseRequestCancelWithdrawReturnType = UseMutationResult<\n  RequestCancelWithdrawResult,\n  SymmioRequestError,\n  RequestCancelWithdrawParameters\n>;\n\n/**\n * Request cancellation of a pending withdraw request (routed through the\n * AccountLayer `_call` proxy). On success, the subaccount's pending-requests and\n * single-request queries are invalidated.\n *\n * @example\n * ```tsx\n * const { mutate } = useRequestCancelWithdraw();\n * mutate({ account: \"0xsub…\", requestId: 1n });\n * ```\n */\nexport function useRequestCancelWithdraw(\n  parameters: UseRequestCancelWithdrawParameters = {},\n): UseRequestCancelWithdrawReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestCancelWithdrawMutationOptions(config);\n\n  return useMutation<RequestCancelWithdrawResult, SymmioRequestError, RequestCancelWithdrawParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          account: variables.account,\n          requestId: variables.requestId,\n          simulateBeforeWrite: variables.simulateBeforeWrite,\n          chainId: resolvedChainId,\n        });\n        return resolveWriteResult(config, hash, {\n          chainId: resolvedChainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_result, variables) => {\n      const partial = { user: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPendingWithdrawRequestsQueryKey, partial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getWithdrawRequestsQueryKey, partial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA0CA,SAAgB,EACd,IAAiD,CAAC,GACd;CACpC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAqC,CAAM;CAExD,OAAO,EAA8F;EACnG,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAO7C,OAAO,EAAmB,GAAQ,MANf,EAAK,WAAW;KACjC,SAAS,EAAU;KACnB,WAAW,EAAU;KACrB,qBAAqB,EAAU;KAC/B,SAAS;IACX,CAAC,GACuC;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GACjC,IAAM,IAAU,EAAE,MAAM,EAAU,QAAQ;GAE1C,AADA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAoC,CAAO,EAAE,CAAC,GAC7G,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAO,EAAE,CAAC;EACxG;CACF,CAAC;AACH"}
+{"version":3,"file":"use-request-cancel-withdraw.js","names":[],"sources":["../../src/withdraw/use-request-cancel-withdraw.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getAccountBalanceInfoQueryKey,\n  getAccountBalanceOfQueryKey,\n  getPendingWithdrawRequestsQueryKey,\n  getWithdrawRequestsQueryKey,\n  requestCancelWithdrawMutationOptions,\n  type RequestCancelWithdrawParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { resolveWriteResult, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useRequestCancelWithdraw}.\n */\nexport type UseRequestCancelWithdrawParameters = WriteParameters;\n\n/** Result returned by the {@link useRequestCancelWithdraw} mutation. */\nexport type RequestCancelWithdrawResult = WriteResult;\n\n/** Return type of {@link useRequestCancelWithdraw}. */\nexport type UseRequestCancelWithdrawReturnType = UseMutationResult<\n  RequestCancelWithdrawResult,\n  SymmioRequestError,\n  RequestCancelWithdrawParameters\n>;\n\n/**\n * Request cancellation of a pending withdraw request (routed through the\n * AccountLayer `_call` proxy). On success (after the receipt), the subaccount's\n * balance reads (`balanceInfo`, `balanceOf`) and its pending-requests / requests\n * queries are invalidated — cancel returns the reserved funds to the available\n * balance.\n *\n * @example\n * ```tsx\n * const { mutate } = useRequestCancelWithdraw();\n * mutate({ account: \"0xsub…\", requestId: 1n });\n * ```\n */\nexport function useRequestCancelWithdraw(\n  parameters: UseRequestCancelWithdrawParameters = {},\n): UseRequestCancelWithdrawReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestCancelWithdrawMutationOptions(config);\n\n  return useMutation<RequestCancelWithdrawResult, SymmioRequestError, RequestCancelWithdrawParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          account: variables.account,\n          requestId: variables.requestId,\n          simulateBeforeWrite: variables.simulateBeforeWrite,\n          chainId: resolvedChainId,\n        });\n        return resolveWriteResult(config, hash, {\n          chainId: resolvedChainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_result, variables) => {\n      // Cancel returns the reserved funds to the subaccount's available balance and\n      // removes the request — refetch balances + the withdraw lists (after the receipt).\n      const balancePartial = { account: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getAccountBalanceInfoQueryKey, balancePartial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getAccountBalanceOfQueryKey, balancePartial) });\n\n      const withdrawPartial = { user: variables.account };\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getPendingWithdrawRequestsQueryKey, withdrawPartial),\n      });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getWithdrawRequestsQueryKey, withdrawPartial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA8CA,SAAgB,EACd,IAAiD,CAAC,GACd;CACpC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAqC,CAAM;CAExD,OAAO,EAA8F;EACnG,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAO7C,OAAO,EAAmB,GAAQ,MANf,EAAK,WAAW;KACjC,SAAS,EAAU;KACnB,WAAW,EAAU;KACrB,qBAAqB,EAAU;KAC/B,SAAS;IACX,CAAC,GACuC;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GAGjC,IAAM,IAAiB,EAAE,SAAS,EAAU,QAAQ;GAEpD,AADA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA+B,CAAc,EAAE,CAAC,GAC/G,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAc,EAAE,CAAC;GAE7G,IAAM,IAAkB,EAAE,MAAM,EAAU,QAAQ;GAIlD,AAHA,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAAoC,CAAe,EAC/E,CAAC,GACD,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAe,EAAE,CAAC;EAChH;CACF,CAAC;AACH"}

package/dist/withdraw/use-withdraw.d.ts

@@ -0,0 +1,67 @@
+import { WithdrawAutoParameters } from '@symmio/trading-core';
+import { UseMutationResult } from '@tanstack/react-query';
+import { Address } from 'viem';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+import { WriteParameters, WriteResult } from '../transactions/index.js';
+/**
+ * Parameters for {@link useWithdraw}. `account` (the subaccount) and `chainId` are
+ * read at hook time so the hook can resolve the subaccount's isolation type via
+ * {@link useSubAccount}; the per-withdraw inputs (`amount`, `receiver`, …) are the
+ * mutation variables.
+ */
+export type UseWithdrawParameters = WriteParameters & {
+    /** The subaccount to withdraw from. The connected wallet must be its on-chain owner. */
+    account?: Address;
+    /** Target chain id. Defaults to the connected chain. */
+    chainId?: number;
+};
+/**
+ * Variables for the {@link useWithdraw} mutation — the per-withdraw inputs, with
+ * `amount` in the **collateral token's decimals**. `account`, `chainId`, and
+ * `isolationType` are supplied by the hook, so the caller never passes them (nor
+ * `parts`). `upnlSig` is optional; on the `CUSTOM` path a fresh Muon uPnL signature
+ * is fetched for the deallocate leg when omitted.
+ */
+export type UseWithdrawVariables = Omit<WithdrawAutoParameters, "account" | "isolationType" | "chainId">;
+/** Result returned by the {@link useWithdraw} mutation. */
+export type WithdrawResult = WriteResult;
+/** Return type of {@link useWithdraw}. */
+export type UseWithdrawReturnType = UseMutationResult<WithdrawResult, SymmioRequestError, UseWithdrawVariables>;
+/**
+ * Withdraw from a subaccount from a **minimal, collateral-decimals input** — the
+ * high-level entry point that hides isolation, parts, and amount scaling.
+ *
+ * Pass the `account` (and optional `chainId`) to the hook; call `mutate` with just
+ * `{ amount, receiver }`. The hook reads the subaccount's `isolationType` with
+ * {@link useSubAccount} (deduped with any other `useSubAccount` on the same key —
+ * e.g. one already driving a balance display) and hands it to the SDK, so the core
+ * action skips a redundant on-chain read and picks the path: a `CUSTOM`
+ * (cross-margin) subaccount deallocates then initiates in one atomic transaction; a
+ * `MARKET` / `MARKET_DIRECTION` (VA / lowcap) subaccount only initiates the withdraw
+ * request. On a cache miss the core action resolves `isolationType` itself.
+ *
+ * `amount` is in the **collateral token's decimals** (e.g. 6 for USDC). The hook
+ * builds the classic same-chain withdraw part from it and, on the `CUSTOM` path,
+ * scales it to the 18-decimal amount the deallocate leg needs — the caller does not
+ * scale anything.
+ *
+ * On success, the subaccount's balance reads (`balanceInfo`, `balanceOf`) and its
+ * pending-requests / withdrawable-time reads are invalidated.
+ *
+ * @remarks
+ * On the `CUSTOM` path the SDK fetches a fresh Muon uPnL signature for the
+ * deallocate leg unless you pass one as `upnlSig`; that leg is subject to the
+ * on-chain deallocate debounce. Failures surface as a normalized
+ * {@link SymmioRequestError}. Reach for `useDeallocateAndInitiateWithdraw` /
+ * `useInitiateWithdraw` when you already know the isolation and want to drive one
+ * specific path, or need custom (multi-part / cross-chain) withdraw parts.
+ *
+ * @example
+ * ```tsx
+ * const { mutate } = useWithdraw({ account: "0xsub…" });
+ * // amount in the collateral token's decimals (6-dec USDC → 1 USDC):
+ * mutate({ amount: 1_000000n, receiver: "0xabc…" });
+ * ```
+ */
+export declare function useWithdraw(parameters?: UseWithdrawParameters): UseWithdrawReturnType;
+//# sourceMappingURL=use-withdraw.d.ts.map

package/dist/withdraw/use-withdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-withdraw.d.ts","sourceRoot":"","sources":["../../src/withdraw/use-withdraw.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG;IACpD,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC,CAAC;AAEzG,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AAEzC,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;AAEhH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,WAAW,CAAC,UAAU,GAAE,qBAA0B,GAAG,qBAAqB,CAiDzF"}

package/dist/withdraw/use-withdraw.js

@@ -0,0 +1,49 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { resolveWriteResult as r } from "../transactions/resolve-write-result.js";
+import { predicateMatch as i } from "../utils/predicate-match.js";
+import { useSubAccount as a } from "../account-layer/use-sub-account.js";
+import { SymmError as o, getAccountBalanceInfoQueryKey as s, getAccountBalanceOfQueryKey as c, getPendingWithdrawRequestsQueryKey as l, getWithdrawableTimeQueryKey as u, withdrawAutoMutationOptions as d } from "@symmio/trading-core";
+import { useMutation as f, useQueryClient as p } from "@tanstack/react-query";
+//#region src/withdraw/use-withdraw.ts
+function m(m = {}) {
+	let h = t(m), g = e(), _ = p(), v = m.chainId ?? g, { data: y } = a({
+		account: m.account,
+		chainId: m.chainId
+	}), b = y?.isolationType, x = d(h);
+	return f({
+		mutationKey: x.mutationKey,
+		mutationFn: async (e) => {
+			try {
+				let t = m.account;
+				if (!t) throw new o("validation", "MISSING_ACCOUNT", "useWithdraw: `account` must be set on the hook.");
+				return r(h, await x.mutationFn({
+					...e,
+					account: t,
+					chainId: v,
+					isolationType: b
+				}), {
+					chainId: v,
+					waitForReceipt: m.waitForReceipt,
+					confirmations: m.confirmations
+				});
+			} catch (e) {
+				throw n(e);
+			}
+		},
+		onSuccess: () => {
+			let e = m.account;
+			if (!e) return;
+			let t = { account: e };
+			_.invalidateQueries({ predicate: i(s, t) }), _.invalidateQueries({ predicate: i(c, t) });
+			let n = { user: e };
+			_.invalidateQueries({ predicate: i(l, n) }), _.invalidateQueries({ predicate: i(u, n) });
+		}
+	});
+}
+//#endregion
+export { m as useWithdraw };
+
+//# sourceMappingURL=use-withdraw.js.map

package/dist/withdraw/use-withdraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-withdraw.js","names":[],"sources":["../../src/withdraw/use-withdraw.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getAccountBalanceInfoQueryKey,\n  getAccountBalanceOfQueryKey,\n  getPendingWithdrawRequestsQueryKey,\n  getWithdrawableTimeQueryKey,\n  SymmError,\n  withdrawAutoMutationOptions,\n  type WithdrawAutoParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport type { Address } from \"viem\";\nimport { useSubAccount } from \"../account-layer/use-sub-account\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { resolveWriteResult, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useWithdraw}. `account` (the subaccount) and `chainId` are\n * read at hook time so the hook can resolve the subaccount's isolation type via\n * {@link useSubAccount}; the per-withdraw inputs (`amount`, `receiver`, …) are the\n * mutation variables.\n */\nexport type UseWithdrawParameters = WriteParameters & {\n  /** The subaccount to withdraw from. The connected wallet must be its on-chain owner. */\n  account?: Address;\n  /** Target chain id. Defaults to the connected chain. */\n  chainId?: number;\n};\n\n/**\n * Variables for the {@link useWithdraw} mutation — the per-withdraw inputs, with\n * `amount` in the **collateral token's decimals**. `account`, `chainId`, and\n * `isolationType` are supplied by the hook, so the caller never passes them (nor\n * `parts`). `upnlSig` is optional; on the `CUSTOM` path a fresh Muon uPnL signature\n * is fetched for the deallocate leg when omitted.\n */\nexport type UseWithdrawVariables = Omit<WithdrawAutoParameters, \"account\" | \"isolationType\" | \"chainId\">;\n\n/** Result returned by the {@link useWithdraw} mutation. */\nexport type WithdrawResult = WriteResult;\n\n/** Return type of {@link useWithdraw}. */\nexport type UseWithdrawReturnType = UseMutationResult<WithdrawResult, SymmioRequestError, UseWithdrawVariables>;\n\n/**\n * Withdraw from a subaccount from a **minimal, collateral-decimals input** — the\n * high-level entry point that hides isolation, parts, and amount scaling.\n *\n * Pass the `account` (and optional `chainId`) to the hook; call `mutate` with just\n * `{ amount, receiver }`. The hook reads the subaccount's `isolationType` with\n * {@link useSubAccount} (deduped with any other `useSubAccount` on the same key —\n * e.g. one already driving a balance display) and hands it to the SDK, so the core\n * action skips a redundant on-chain read and picks the path: a `CUSTOM`\n * (cross-margin) subaccount deallocates then initiates in one atomic transaction; a\n * `MARKET` / `MARKET_DIRECTION` (VA / lowcap) subaccount only initiates the withdraw\n * request. On a cache miss the core action resolves `isolationType` itself.\n *\n * `amount` is in the **collateral token's decimals** (e.g. 6 for USDC). The hook\n * builds the classic same-chain withdraw part from it and, on the `CUSTOM` path,\n * scales it to the 18-decimal amount the deallocate leg needs — the caller does not\n * scale anything.\n *\n * On success, the subaccount's balance reads (`balanceInfo`, `balanceOf`) and its\n * pending-requests / withdrawable-time reads are invalidated.\n *\n * @remarks\n * On the `CUSTOM` path the SDK fetches a fresh Muon uPnL signature for the\n * deallocate leg unless you pass one as `upnlSig`; that leg is subject to the\n * on-chain deallocate debounce. Failures surface as a normalized\n * {@link SymmioRequestError}. Reach for `useDeallocateAndInitiateWithdraw` /\n * `useInitiateWithdraw` when you already know the isolation and want to drive one\n * specific path, or need custom (multi-part / cross-chain) withdraw parts.\n *\n * @example\n * ```tsx\n * const { mutate } = useWithdraw({ account: \"0xsub…\" });\n * // amount in the collateral token's decimals (6-dec USDC → 1 USDC):\n * mutate({ amount: 1_000000n, receiver: \"0xabc…\" });\n * ```\n */\nexport function useWithdraw(parameters: UseWithdrawParameters = {}): UseWithdrawReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n  const resolvedChainId = parameters.chainId ?? chainId;\n\n  // Resolve the subaccount's isolation type via the standard hook (deduped by\n  // react-query with any other useSubAccount on the same key), so the core action\n  // skips a redundant getSubAccount RPC.\n  const { data: subAccount } = useSubAccount({ account: parameters.account, chainId: parameters.chainId });\n  const isolationType = subAccount?.isolationType;\n\n  const base = withdrawAutoMutationOptions(config);\n\n  return useMutation<WithdrawResult, SymmioRequestError, UseWithdrawVariables>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const account = parameters.account;\n        if (!account) {\n          throw new SymmError(\"validation\", \"MISSING_ACCOUNT\", \"useWithdraw: `account` must be set on the hook.\");\n        }\n        const hash = await base.mutationFn({ ...variables, account, chainId: resolvedChainId, isolationType });\n        return resolveWriteResult(config, hash, {\n          chainId: resolvedChainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: () => {\n      const account = parameters.account;\n      if (!account) return;\n\n      const balancePartial = { account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getAccountBalanceInfoQueryKey, balancePartial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getAccountBalanceOfQueryKey, balancePartial) });\n\n      const withdrawPartial = { user: account };\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getPendingWithdrawRequestsQueryKey, withdrawPartial),\n      });\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getWithdrawableTimeQueryKey, withdrawPartial),\n      });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AAqFA,SAAgB,EAAY,IAAoC,CAAC,GAA0B;CACzF,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAC7B,IAAkB,EAAW,WAAW,GAKxC,EAAE,MAAM,MAAe,EAAc;EAAE,SAAS,EAAW;EAAS,SAAS,EAAW;CAAQ,CAAC,GACjG,IAAgB,GAAY,eAE5B,IAAO,EAA4B,CAAM;CAE/C,OAAO,EAAsE;EAC3E,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAU,EAAW;IAC3B,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,cAAc,mBAAmB,iDAAiD;IAGxG,OAAO,EAAmB,GAAQ,MADf,EAAK,WAAW;KAAE,GAAG;KAAW;KAAS,SAAS;KAAiB;IAAc,CAAC,GAC7D;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,iBAAiB;GACf,IAAM,IAAU,EAAW;GAC3B,IAAI,CAAC,GAAS;GAEd,IAAM,IAAiB,EAAE,WAAQ;GAEjC,AADA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA+B,CAAc,EAAE,CAAC,GAC/G,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAc,EAAE,CAAC;GAE7G,IAAM,IAAkB,EAAE,MAAM,EAAQ;GAIxC,AAHA,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAAoC,CAAe,EAC/E,CAAC,GACD,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAA6B,CAAe,EACxE,CAAC;EACH;CACF,CAAC;AACH"}