@symmio/trading-react 0.1.0

package/dist/tpsl/use-tpsl-config.js

@@ -0,0 +1,31 @@
+"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 { getTpSlConfigQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/tpsl/use-tpsl-config.ts
+function a(a = {}) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s,
+		query: {
+			staleTime: 6e4,
+			...a.query
+		}
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useTpSlConfig };
+
+//# sourceMappingURL=use-tpsl-config.js.map

package/dist/tpsl/use-tpsl-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tpsl-config.js","names":[],"sources":["../../src/tpsl/use-tpsl-config.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getTpSlConfigQueryOptions,\n  type ConfigParameter,\n  type GetTpSlConfigOptions,\n  type GetTpSlConfigReturnType,\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/** Parameters for {@link useTpSlConfig}. */\nexport type UseTpSlConfigParameters = GetTpSlConfigOptions & ConfigParameter;\n\n/** Return type of {@link useTpSlConfig}. */\nexport type UseTpSlConfigReturnType = UseQueryResult<GetTpSlConfigReturnType, SymmioRequestError>;\n\n/**\n * Read the TP/SL handler's `/configs/` rules — `minPriceDistancePercent` and\n * `minProfitStopLossSpreadPercent`. Pair with `validateTpSl()` to live-check\n * user input.\n */\nexport function useTpSlConfig(parameters: UseTpSlConfigParameters = {}): UseTpSlConfigReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getTpSlConfigQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n    query: { staleTime: 60_000, ...parameters.query },\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 UseTpSlConfigReturnType;\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,EAAc,IAAsC,CAAC,GAA4B;CAC/F,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAA0B,GAAQ;EAChD,GAAG;EACH,SAAS,EAAW,WAAW;EAC/B,OAAO;GAAE,WAAW;GAAQ,GAAG,EAAW;EAAM;CAClD,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/tpsl/use-tpsl-signing-spec.d.ts

@@ -0,0 +1,13 @@
+import { ConfigParameter, GetTpSlSigningSpecOptions, GetTpSlSigningSpecReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/** Parameters for {@link useTpSlSigningSpec}. */
+export type UseTpSlSigningSpecParameters = GetTpSlSigningSpecOptions & ConfigParameter;
+/** Return type of {@link useTpSlSigningSpec}. */
+export type UseTpSlSigningSpecReturnType = UseQueryResult<GetTpSlSigningSpecReturnType, SymmioRequestError>;
+/**
+ * Read the handler's EIP-712 signing spec (`<base>/signing-spec`). Cached
+ * indefinitely — the spec is stable per deployment.
+ */
+export declare function useTpSlSigningSpec(parameters?: UseTpSlSigningSpecParameters): UseTpSlSigningSpecReturnType;
+//# sourceMappingURL=use-tpsl-signing-spec.d.ts.map

package/dist/tpsl/use-tpsl-signing-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tpsl-signing-spec.d.ts","sourceRoot":"","sources":["../../src/tpsl/use-tpsl-signing-spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,yBAAyB,GAAG,eAAe,CAAC;AAEvF,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,4BAA4B,EAAE,kBAAkB,CAAC,CAAC;AAE5G;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,4BAAiC,GAAG,4BAA4B,CAmB9G"}

package/dist/tpsl/use-tpsl-signing-spec.js

@@ -0,0 +1,31 @@
+"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 { getTpSlSigningSpecQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/tpsl/use-tpsl-signing-spec.ts
+function a(a = {}) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s,
+		query: {
+			staleTime: Infinity,
+			...a.query
+		}
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useTpSlSigningSpec };
+
+//# sourceMappingURL=use-tpsl-signing-spec.js.map

package/dist/tpsl/use-tpsl-signing-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tpsl-signing-spec.js","names":[],"sources":["../../src/tpsl/use-tpsl-signing-spec.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getTpSlSigningSpecQueryOptions,\n  type ConfigParameter,\n  type GetTpSlSigningSpecOptions,\n  type GetTpSlSigningSpecReturnType,\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/** Parameters for {@link useTpSlSigningSpec}. */\nexport type UseTpSlSigningSpecParameters = GetTpSlSigningSpecOptions & ConfigParameter;\n\n/** Return type of {@link useTpSlSigningSpec}. */\nexport type UseTpSlSigningSpecReturnType = UseQueryResult<GetTpSlSigningSpecReturnType, SymmioRequestError>;\n\n/**\n * Read the handler's EIP-712 signing spec (`<base>/signing-spec`). Cached\n * indefinitely — the spec is stable per deployment.\n */\nexport function useTpSlSigningSpec(parameters: UseTpSlSigningSpecParameters = {}): UseTpSlSigningSpecReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getTpSlSigningSpecQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n    query: { staleTime: Infinity, ...parameters.query },\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 UseTpSlSigningSpecReturnType;\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,EAAmB,IAA2C,CAAC,GAAiC;CAC9G,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAA+B,GAAQ;EACrD,GAAG;EACH,SAAS,EAAW,WAAW;EAC/B,OAAO;GAAE,WAAW;GAAU,GAAG,EAAW;EAAM;CACpD,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/tpsl/use-watch-tpsl-notifications.d.ts

@@ -0,0 +1,30 @@
+import { ConfigParameter, SocketStatus, TpSlNotification } from '@symmio/trading-core';
+import { Address } from 'viem';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/**
+ * Parameters for {@link useWatchTpSlNotifications}.
+ */
+export interface UseWatchTpSlNotificationsParameters extends ConfigParameter {
+    /** SubAccount address — required to subscribe. */
+    account?: Address;
+    /** Target chain id. Defaults to the connected chain. */
+    chainId?: number;
+    /** Subscribe only when `true` (and `account` is set). Default `true`. */
+    enabled?: boolean;
+    /** Called for every normalized TP/SL report. */
+    onNotification?: (notification: TpSlNotification) => void;
+}
+/** Return type of {@link useWatchTpSlNotifications}. */
+export interface UseWatchTpSlNotificationsReturnType {
+    /** Live socket status. */
+    status: SocketStatus;
+    /** Last transport / parse error, normalized, or `null`. */
+    error: SymmioRequestError | null;
+}
+/**
+ * Subscribe to the TP/SL notifications WebSocket for a subaccount. Reuses the
+ * SDK's shared socket pool so multiple components on the same account share
+ * one connection.
+ */
+export declare function useWatchTpSlNotifications(parameters: UseWatchTpSlNotificationsParameters): UseWatchTpSlNotificationsReturnType;
+//# sourceMappingURL=use-watch-tpsl-notifications.d.ts.map

package/dist/tpsl/use-watch-tpsl-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-watch-tpsl-notifications.d.ts","sourceRoot":"","sources":["../../src/tpsl/use-watch-tpsl-notifications.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;GAEG;AACH,MAAM,WAAW,mCAAoC,SAAQ,eAAe;IAC1E,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC3D;AAED,wDAAwD;AACxD,MAAM,WAAW,mCAAmC;IAClD,0BAA0B;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,2DAA2D;IAC3D,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,mCAAmC,GAC9C,mCAAmC,CAqCrC"}

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

@@ -0,0 +1,44 @@
+"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 { watchTpSlNotifications as r } from "@symmio/trading-core";
+import { useEffect as i, useRef as a, useState as o } from "react";
+//#region src/tpsl/use-watch-tpsl-notifications.ts
+function s(s) {
+	let { account: c, chainId: l, enabled: u = !0, onNotification: d } = s, f = t(s), p = e(), m = l ?? p, [h, g] = o("closed"), [_, v] = o(null), y = a(d);
+	y.current = d;
+	let b = u && !!c;
+	return i(() => {
+		if (!b || !c) {
+			g("closed");
+			return;
+		}
+		v(null);
+		let e;
+		try {
+			e = r(f, {
+				account: c,
+				chainId: m,
+				onNotification: (e) => y.current?.(e),
+				onStatusChange: g,
+				onError: (e) => v(n(e))
+			});
+		} catch (e) {
+			v(n(e)), g("closed");
+		}
+		return () => e?.();
+	}, [
+		b,
+		c,
+		f,
+		m
+	]), {
+		status: h,
+		error: _
+	};
+}
+//#endregion
+export { s as useWatchTpSlNotifications };
+
+//# sourceMappingURL=use-watch-tpsl-notifications.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-watch-tpsl-notifications.js","names":[],"sources":["../../src/tpsl/use-watch-tpsl-notifications.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  watchTpSlNotifications,\n  type ConfigParameter,\n  type SocketStatus,\n  type TpSlNotification,\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/**\n * Parameters for {@link useWatchTpSlNotifications}.\n */\nexport interface UseWatchTpSlNotificationsParameters extends ConfigParameter {\n  /** SubAccount address — required to subscribe. */\n  account?: Address;\n  /** Target chain id. Defaults to the connected chain. */\n  chainId?: number;\n  /** Subscribe only when `true` (and `account` is set). Default `true`. */\n  enabled?: boolean;\n  /** Called for every normalized TP/SL report. */\n  onNotification?: (notification: TpSlNotification) => void;\n}\n\n/** Return type of {@link useWatchTpSlNotifications}. */\nexport interface UseWatchTpSlNotificationsReturnType {\n  /** Live socket status. */\n  status: SocketStatus;\n  /** Last transport / parse error, normalized, or `null`. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Subscribe to the TP/SL notifications WebSocket for a subaccount. Reuses the\n * SDK's shared socket pool so multiple components on the same account share\n * one connection.\n */\nexport function useWatchTpSlNotifications(\n  parameters: UseWatchTpSlNotificationsParameters,\n): UseWatchTpSlNotificationsReturnType {\n  const { account, chainId, enabled = true, onNotification } = parameters;\n  const config = useSymmioConfig(parameters);\n  const defaultChainId = useSymmioChainId();\n  const resolvedChainId = chainId ?? defaultChainId;\n\n  const [status, setStatus] = useState<SocketStatus>(\"closed\");\n  const [error, setError] = useState<SymmioRequestError | null>(null);\n\n  const onNotificationRef = useRef(onNotification);\n  onNotificationRef.current = onNotification;\n\n  const active = enabled && Boolean(account);\n\n  useEffect(() => {\n    if (!active || !account) {\n      setStatus(\"closed\");\n      return;\n    }\n    setError(null);\n    let unwatch: (() => void) | undefined;\n    try {\n      unwatch = watchTpSlNotifications(config, {\n        account,\n        chainId: resolvedChainId,\n        onNotification: (notification) => onNotificationRef.current?.(notification),\n        onStatusChange: setStatus,\n        onError: (err) => setError(normalizeSymmError(err)),\n      });\n    } catch (err) {\n      setError(normalizeSymmError(err));\n      setStatus(\"closed\");\n    }\n    return () => unwatch?.();\n  }, [active, account, config, resolvedChainId]);\n\n  return { status, error };\n}\n"],"mappings":";;;;;;;AA0CA,SAAgB,EACd,GACqC;CACrC,IAAM,EAAE,YAAS,YAAS,aAAU,IAAM,sBAAmB,GACvD,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAkB,KAAW,GAE7B,CAAC,GAAQ,KAAa,EAAuB,QAAQ,GACrD,CAAC,GAAO,KAAY,EAAoC,IAAI,GAE5D,IAAoB,EAAO,CAAc;CAC/C,EAAkB,UAAU;CAE5B,IAAM,IAAS,KAAW,EAAQ;CAwBlC,OAtBA,QAAgB;EACd,IAAI,CAAC,KAAU,CAAC,GAAS;GACvB,EAAU,QAAQ;GAClB;EACF;EACA,EAAS,IAAI;EACb,IAAI;EACJ,IAAI;GACF,IAAU,EAAuB,GAAQ;IACvC;IACA,SAAS;IACT,iBAAiB,MAAiB,EAAkB,UAAU,CAAY;IAC1E,gBAAgB;IAChB,UAAU,MAAQ,EAAS,EAAmB,CAAG,CAAC;GACpD,CAAC;EACH,SAAS,GAAK;GAEZ,AADA,EAAS,EAAmB,CAAG,CAAC,GAChC,EAAU,QAAQ;EACpB;EACA,aAAa,IAAU;CACzB,GAAG;EAAC;EAAQ;EAAS;EAAQ;CAAe,CAAC,GAEtC;EAAE;EAAQ;CAAM;AACzB"}

package/dist/transactions/index.d.ts

@@ -0,0 +1,4 @@
+export * from './resolve-write-result';
+export * from './use-transactions-store';
+export * from './write-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC"}

package/dist/transactions/resolve-write-result.d.ts

@@ -0,0 +1,40 @@
+import { Config } from '@symmio/trading-core';
+import { Hash } from 'viem';
+import { WriteResult } from './write-types';
+/**
+ * Options for {@link resolveWriteResult}.
+ */
+interface ResolveWriteResultOptions {
+    /**
+     * Chain the transaction was submitted on. Resolves the public client that
+     * polls for the receipt; omit to use the config's default chain.
+     */
+    chainId?: number;
+    /**
+     * Resolve only after the receipt is mined (default `true`). When `false`,
+     * resolve immediately with just the hash.
+     */
+    waitForReceipt?: boolean;
+    /** Confirmations to wait for when `waitForReceipt` is true. Defaults to `1`. */
+    confirmations?: number;
+}
+/**
+ * Shared tail of every write hook's `mutationFn`. Given a submitted transaction
+ * `hash`, either return it immediately (`waitForReceipt: false`) or poll for the
+ * mined receipt and return both. Applies the package-wide write defaults
+ * (`waitForReceipt: true`, `confirmations: 1`).
+ *
+ * @param config - The SDK config (its `getClient` resolves the polling client).
+ * @param hash - The submitted transaction hash.
+ * @param options - Chain id and receipt-wait behavior.
+ * @returns The hash, plus the receipt when `waitForReceipt` is enabled.
+ *
+ * @example
+ * ```ts
+ * const hash = await base.mutationFn({ ...variables, chainId });
+ * return resolveWriteResult(config, hash, { chainId, waitForReceipt, confirmations });
+ * ```
+ */
+export declare function resolveWriteResult(config: Config, hash: Hash, options?: ResolveWriteResultOptions): Promise<WriteResult>;
+export {};
+//# sourceMappingURL=resolve-write-result.d.ts.map

package/dist/transactions/resolve-write-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-write-result.d.ts","sourceRoot":"","sources":["../../src/transactions/resolve-write-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,UAAU,yBAAyB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,WAAW,CAAC,CAKtB"}

package/dist/transactions/resolve-write-result.js

@@ -0,0 +1,15 @@
+//#region src/transactions/resolve-write-result.ts
+async function e(e, t, n = {}) {
+	let { chainId: r, waitForReceipt: i = !0, confirmations: a = 1 } = n;
+	return i ? {
+		hash: t,
+		receipt: await e.getClient({ chainId: r }).waitForTransactionReceipt({
+			hash: t,
+			confirmations: a
+		})
+	} : { hash: t };
+}
+//#endregion
+export { e as resolveWriteResult };
+
+//# sourceMappingURL=resolve-write-result.js.map

package/dist/transactions/resolve-write-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-write-result.js","names":[],"sources":["../../src/transactions/resolve-write-result.ts"],"sourcesContent":["import type { Config } from \"@symmio/trading-core\";\nimport type { Hash } from \"viem\";\nimport type { WriteResult } from \"./write-types\";\n\n/**\n * Options for {@link resolveWriteResult}.\n */\ninterface ResolveWriteResultOptions {\n  /**\n   * Chain the transaction was submitted on. Resolves the public client that\n   * polls for the receipt; omit to use the config's default chain.\n   */\n  chainId?: number;\n  /**\n   * Resolve only after the receipt is mined (default `true`). When `false`,\n   * resolve immediately with just the hash.\n   */\n  waitForReceipt?: boolean;\n  /** Confirmations to wait for when `waitForReceipt` is true. Defaults to `1`. */\n  confirmations?: number;\n}\n\n/**\n * Shared tail of every write hook's `mutationFn`. Given a submitted transaction\n * `hash`, either return it immediately (`waitForReceipt: false`) or poll for the\n * mined receipt and return both. Applies the package-wide write defaults\n * (`waitForReceipt: true`, `confirmations: 1`).\n *\n * @param config - The SDK config (its `getClient` resolves the polling client).\n * @param hash - The submitted transaction hash.\n * @param options - Chain id and receipt-wait behavior.\n * @returns The hash, plus the receipt when `waitForReceipt` is enabled.\n *\n * @example\n * ```ts\n * const hash = await base.mutationFn({ ...variables, chainId });\n * return resolveWriteResult(config, hash, { chainId, waitForReceipt, confirmations });\n * ```\n */\nexport async function resolveWriteResult(\n  config: Config,\n  hash: Hash,\n  options: ResolveWriteResultOptions = {},\n): Promise<WriteResult> {\n  const { chainId, waitForReceipt = true, confirmations = 1 } = options;\n  if (!waitForReceipt) return { hash };\n  const receipt = await config.getClient({ chainId }).waitForTransactionReceipt({ hash, confirmations });\n  return { hash, receipt };\n}\n"],"mappings":";AAuCA,eAAsB,EACpB,GACA,GACA,IAAqC,CAAC,GAChB;CACtB,IAAM,EAAE,YAAS,oBAAiB,IAAM,mBAAgB,MAAM;CAG9D,OAFK,IAEE;EAAE;EAAM,SAAA,MADO,EAAO,UAAU,EAAE,WAAQ,CAAC,EAAE,0BAA0B;GAAE;GAAM;EAAc,CAAC;CAC9E,IAFK,EAAE,QAAK;AAGrC"}

package/dist/transactions/use-transactions-store.d.ts

@@ -0,0 +1,52 @@
+import { Hash } from 'viem';
+/**
+ * State of a single tracked transaction.
+ */
+export interface TrackedTx {
+    /** Transaction hash. Unique within a chain. */
+    hash: Hash;
+    /** Chain id the transaction was broadcast on. */
+    chainId: number;
+    /** Short human-readable label, e.g. `"Rename account"`. Shown in toasts. */
+    label: string;
+    /** Status the tx is in. Updated when the host calls `markConfirmed` / `markFailed`. */
+    status: "pending" | "confirmed" | "failed";
+    /** `Date.now()` at insertion time. Used for ordering. */
+    createdAt: number;
+}
+/**
+ * Store state plus the mutators used to update it.
+ */
+export interface TransactionsStoreState {
+    txs: readonly TrackedTx[];
+    /** Insert a pending transaction. Duplicate hashes are ignored. */
+    add: (tx: Omit<TrackedTx, "status" | "createdAt">) => void;
+    /** Promote a pending tx to `confirmed`. No-op if the hash is not tracked. */
+    markConfirmed: (hash: Hash) => void;
+    /** Promote a pending tx to `failed`. No-op if the hash is not tracked. */
+    markFailed: (hash: Hash) => void;
+    /** Wipe every tracked transaction. */
+    clear: () => void;
+}
+/**
+ * Lightweight zustand store for tracking in-flight transactions in the UI —
+ * the data backing pending-tx badges, post-confirmation toasts, and "view in
+ * explorer" links. Opt-in: hooks like `useEditAccountName` do **not** populate
+ * this store automatically; the host wires it up.
+ *
+ * Usage is identical to any zustand store — call `useTransactionsStore()` from
+ * a component to subscribe to the full state, or pass a selector for fine-
+ * grained subscriptions:
+ *
+ * @example
+ * const pending = useTransactionsStore((s) => s.txs.filter((t) => t.status === "pending"));
+ *
+ * @example
+ * const { add, markConfirmed } = useTransactionsStore();
+ * const hash = await sendTx();
+ * add({ hash, chainId, label: "Rename account" });
+ * await waitFor(hash);
+ * markConfirmed(hash);
+ */
+export declare const useTransactionsStore: import('zustand').UseBoundStore<import('zustand').StoreApi<TransactionsStoreState>>;
+//# sourceMappingURL=use-transactions-store.d.ts.map

package/dist/transactions/use-transactions-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transactions-store.d.ts","sourceRoot":"","sources":["../../src/transactions/use-transactions-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,IAAI,EAAE,IAAI,CAAC;IACX,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1B,kEAAkE;IAClE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAI,CAAC;IAC3D,6EAA6E;IAC7E,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACpC,0EAA0E;IAC1E,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACjC,sCAAsC;IACtC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,qFAkB9B,CAAC"}

package/dist/transactions/use-transactions-store.js

@@ -0,0 +1,24 @@
+"use client";
+import { create as e } from "zustand";
+//#region src/transactions/use-transactions-store.ts
+var t = e((e) => ({
+	txs: [],
+	add: (t) => e((e) => e.txs.some((e) => e.hash === t.hash) ? e : { txs: [...e.txs, {
+		...t,
+		status: "pending",
+		createdAt: Date.now()
+	}] }),
+	markConfirmed: (t) => e((e) => ({ txs: e.txs.map((e) => e.hash === t ? {
+		...e,
+		status: "confirmed"
+	} : e) })),
+	markFailed: (t) => e((e) => ({ txs: e.txs.map((e) => e.hash === t ? {
+		...e,
+		status: "failed"
+	} : e) })),
+	clear: () => e({ txs: [] })
+}));
+//#endregion
+export { t as useTransactionsStore };
+
+//# sourceMappingURL=use-transactions-store.js.map

package/dist/transactions/use-transactions-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transactions-store.js","names":[],"sources":["../../src/transactions/use-transactions-store.ts"],"sourcesContent":["\"use client\";\n\nimport type { Hash } from \"viem\";\nimport { create } from \"zustand\";\n\n/**\n * State of a single tracked transaction.\n */\nexport interface TrackedTx {\n  /** Transaction hash. Unique within a chain. */\n  hash: Hash;\n  /** Chain id the transaction was broadcast on. */\n  chainId: number;\n  /** Short human-readable label, e.g. `\"Rename account\"`. Shown in toasts. */\n  label: string;\n  /** Status the tx is in. Updated when the host calls `markConfirmed` / `markFailed`. */\n  status: \"pending\" | \"confirmed\" | \"failed\";\n  /** `Date.now()` at insertion time. Used for ordering. */\n  createdAt: number;\n}\n\n/**\n * Store state plus the mutators used to update it.\n */\nexport interface TransactionsStoreState {\n  txs: readonly TrackedTx[];\n  /** Insert a pending transaction. Duplicate hashes are ignored. */\n  add: (tx: Omit<TrackedTx, \"status\" | \"createdAt\">) => void;\n  /** Promote a pending tx to `confirmed`. No-op if the hash is not tracked. */\n  markConfirmed: (hash: Hash) => void;\n  /** Promote a pending tx to `failed`. No-op if the hash is not tracked. */\n  markFailed: (hash: Hash) => void;\n  /** Wipe every tracked transaction. */\n  clear: () => void;\n}\n\n/**\n * Lightweight zustand store for tracking in-flight transactions in the UI —\n * the data backing pending-tx badges, post-confirmation toasts, and \"view in\n * explorer\" links. Opt-in: hooks like `useEditAccountName` do **not** populate\n * this store automatically; the host wires it up.\n *\n * Usage is identical to any zustand store — call `useTransactionsStore()` from\n * a component to subscribe to the full state, or pass a selector for fine-\n * grained subscriptions:\n *\n * @example\n * const pending = useTransactionsStore((s) => s.txs.filter((t) => t.status === \"pending\"));\n *\n * @example\n * const { add, markConfirmed } = useTransactionsStore();\n * const hash = await sendTx();\n * add({ hash, chainId, label: \"Rename account\" });\n * await waitFor(hash);\n * markConfirmed(hash);\n */\nexport const useTransactionsStore = create<TransactionsStoreState>((set) => ({\n  txs: [],\n  add: (tx) =>\n    set((state) => {\n      if (state.txs.some((existing) => existing.hash === tx.hash)) return state;\n      return {\n        txs: [...state.txs, { ...tx, status: \"pending\", createdAt: Date.now() }],\n      };\n    }),\n  markConfirmed: (hash) =>\n    set((state) => ({\n      txs: state.txs.map((tx) => (tx.hash === hash ? { ...tx, status: \"confirmed\" } : tx)),\n    })),\n  markFailed: (hash) =>\n    set((state) => ({\n      txs: state.txs.map((tx) => (tx.hash === hash ? { ...tx, status: \"failed\" } : tx)),\n    })),\n  clear: () => set({ txs: [] }),\n}));\n"],"mappings":";;;AAwDA,IAAa,IAAuB,GAAgC,OAAS;CAC3E,KAAK,CAAC;CACN,MAAM,MACJ,GAAK,MACC,EAAM,IAAI,MAAM,MAAa,EAAS,SAAS,EAAG,IAAI,IAAU,IAC7D,EACL,KAAK,CAAC,GAAG,EAAM,KAAK;EAAE,GAAG;EAAI,QAAQ;EAAW,WAAW,KAAK,IAAI;CAAE,CAAC,EACzE,CACD;CACH,gBAAgB,MACd,GAAK,OAAW,EACd,KAAK,EAAM,IAAI,KAAK,MAAQ,EAAG,SAAS,IAAO;EAAE,GAAG;EAAI,QAAQ;CAAY,IAAI,CAAG,EACrF,EAAE;CACJ,aAAa,MACX,GAAK,OAAW,EACd,KAAK,EAAM,IAAI,KAAK,MAAQ,EAAG,SAAS,IAAO;EAAE,GAAG;EAAI,QAAQ;CAAS,IAAI,CAAG,EAClF,EAAE;CACJ,aAAa,EAAI,EAAE,KAAK,CAAC,EAAE,CAAC;AAC9B,EAAE"}

package/dist/transactions/write-types.d.ts

@@ -0,0 +1,28 @@
+import { ConfigParameter } from '@symmio/trading-core';
+import { Hash, TransactionReceipt } from 'viem';
+/**
+ * Parameters shared by every write hook — those that submit a transaction and
+ * optionally wait for its receipt. A slice-specific hook's parameter type
+ * extends (or aliases) this; the transaction's own call inputs (addresses,
+ * amounts, …) are passed as the mutation `variables`, not here.
+ */
+export interface WriteParameters extends ConfigParameter {
+    /**
+     * Resolve only after the receipt is mined (default `true`). Set `false` to
+     * resolve as soon as the tx hash is broadcast — useful for optimistic UIs.
+     */
+    waitForReceipt?: boolean;
+    /** Confirmations to wait for when `waitForReceipt` is true. Defaults to `1`. */
+    confirmations?: number;
+}
+/**
+ * Result shared by every write hook: the submitted transaction hash, plus the
+ * mined receipt when `waitForReceipt` is enabled.
+ */
+export interface WriteResult {
+    /** The submitted transaction hash. */
+    hash: Hash;
+    /** The mined receipt, present when `waitForReceipt` is enabled. */
+    receipt?: TransactionReceipt;
+}
+//# sourceMappingURL=write-types.d.ts.map

package/dist/transactions/write-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-types.d.ts","sourceRoot":"","sources":["../../src/transactions/write-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,IAAI,EAAE,IAAI,CAAC;IACX,mEAAmE;IACnE,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B"}

package/dist/transfers/index.d.ts

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

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

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

package/dist/transfers/use-transfer-history.d.ts

@@ -0,0 +1,26 @@
+import { ConfigParameter, GetTransferHistoryOptions, GetTransferHistoryReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/**
+ * Parameters for {@link useTransferHistory}: the core query options (accounts,
+ * direction, paging, time range, chain id, TanStack `query` overrides) plus an
+ * optional `config`.
+ */
+export type UseTransferHistoryParameters = GetTransferHistoryOptions & ConfigParameter;
+/** Return type of {@link useTransferHistory}. */
+export type UseTransferHistoryReturnType = UseQueryResult<GetTransferHistoryReturnType, SymmioRequestError>;
+/**
+ * Read internal transfers (margin moves between SYMMIO accounts) from the events
+ * subgraph. Each row carries raw `from` / `to` endpoints, an 18-decimal `amount`,
+ * and a `direction` relative to the queried accounts. The query is disabled until
+ * at least one `account` is supplied; `chainId` defaults to the connected chain.
+ * Errors are normalized to {@link SymmioRequestError}.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useTransferHistory({ accounts: [subAccount], direction: "outgoing" });
+ * data?.rows.map((row) => `${row.from} → ${row.to}`);
+ * ```
+ */
+export declare function useTransferHistory(parameters: UseTransferHistoryParameters): UseTransferHistoryReturnType;
+//# sourceMappingURL=use-transfer-history.d.ts.map

package/dist/transfers/use-transfer-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transfer-history.d.ts","sourceRoot":"","sources":["../../src/transfers/use-transfer-history.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,yBAAyB,GAAG,eAAe,CAAC;AAEvF,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,4BAA4B,EAAE,kBAAkB,CAAC,CAAC;AAE5G;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,4BAA4B,GAAG,4BAA4B,CAkBzG"}

package/dist/transfers/use-transfer-history.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 { getTransferHistoryQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/transfers/use-transfer-history.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 useTransferHistory };
+
+//# sourceMappingURL=use-transfer-history.js.map

package/dist/transfers/use-transfer-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transfer-history.js","names":[],"sources":["../../src/transfers/use-transfer-history.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getTransferHistoryQueryOptions,\n  type ConfigParameter,\n  type GetTransferHistoryOptions,\n  type GetTransferHistoryReturnType,\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 useTransferHistory}: the core query options (accounts,\n * direction, paging, time range, chain id, TanStack `query` overrides) plus an\n * optional `config`.\n */\nexport type UseTransferHistoryParameters = GetTransferHistoryOptions & ConfigParameter;\n\n/** Return type of {@link useTransferHistory}. */\nexport type UseTransferHistoryReturnType = UseQueryResult<GetTransferHistoryReturnType, SymmioRequestError>;\n\n/**\n * Read internal transfers (margin moves between SYMMIO accounts) from the events\n * subgraph. Each row carries raw `from` / `to` endpoints, an 18-decimal `amount`,\n * and a `direction` relative to the queried accounts. The query is disabled until\n * at least one `account` is supplied; `chainId` defaults to the connected chain.\n * Errors are normalized to {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const { data } = useTransferHistory({ accounts: [subAccount], direction: \"outgoing\" });\n * data?.rows.map((row) => `${row.from} → ${row.to}`);\n * ```\n */\nexport function useTransferHistory(parameters: UseTransferHistoryParameters): UseTransferHistoryReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getTransferHistoryQueryOptions(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 UseTransferHistoryReturnType;\n}\n"],"mappings":";;;;;;;AAqCA,SAAgB,EAAmB,GAAwE;CACzG,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAA+B,GAAQ;EACrD,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

@@ -0,0 +1,2 @@
+export { predicateMatch } from './predicate-match';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/predicate-match.d.ts

@@ -0,0 +1,27 @@
+import { Query, QueryKey } from '@tanstack/react-query';
+/**
+ * Build a `predicate` for `queryClient.invalidateQueries({ predicate })` from a
+ * core query-key factory and an optional partial of its options.
+ *
+ * A cache entry matches when:
+ * 1. its key's leading tag equals the factory's tag (the key's first segment), and
+ * 2. for every field in the partial, the key's trailing options object has an
+ *    equal value. Omitted fields match anything.
+ *
+ * Both the partial and the stored keys are run through the same factory, so
+ * `bigint` values are compared in the decimal-string form the factory emits.
+ * This enables "invalidate every subaccount query for `user`, regardless of
+ * pagination or chain" — which TanStack's leading-prefix matching can't express.
+ *
+ * @param keyFn - A core query-key factory, e.g. `getUserSubAccountsQueryKey`.
+ * @param partial - Fields to match on. Omit to match every entry from `keyFn`.
+ *
+ * @example
+ * ```ts
+ * queryClient.invalidateQueries({
+ *   predicate: predicateMatch(getUserSubAccountsQueryKey, { user }),
+ * });
+ * ```
+ */
+export declare function predicateMatch<options extends object>(keyFn: (options?: options) => readonly unknown[], partial?: options): (query: Query<unknown, Error, unknown, QueryKey>) => boolean;
+//# sourceMappingURL=predicate-match.d.ts.map

package/dist/utils/predicate-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-match.d.ts","sourceRoot":"","sources":["../../src/utils/predicate-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,EACnD,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,SAAS,OAAO,EAAE,EAChD,OAAO,CAAC,EAAE,OAAO,GAChB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,OAAO,CAoB9D"}

package/dist/utils/predicate-match.js

@@ -0,0 +1,18 @@
+//#region src/utils/predicate-match.ts
+function e(e, t) {
+	let n = e(t), r = n[0], i = n[1] ?? {};
+	return (e) => {
+		let n = e.queryKey;
+		if (n[0] !== r) return !1;
+		if (!t) return !0;
+		let a = n[1];
+		if (typeof a != "object" || !a) return !1;
+		let o = a;
+		for (let [e, t] of Object.entries(i)) if (t !== void 0 && o[e] !== t) return !1;
+		return !0;
+	};
+}
+//#endregion
+export { e as predicateMatch };
+
+//# sourceMappingURL=predicate-match.js.map

package/dist/utils/predicate-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-match.js","names":[],"sources":["../../src/utils/predicate-match.ts"],"sourcesContent":["import type { Query, QueryKey } from \"@tanstack/react-query\";\n\n/**\n * Build a `predicate` for `queryClient.invalidateQueries({ predicate })` from a\n * core query-key factory and an optional partial of its options.\n *\n * A cache entry matches when:\n * 1. its key's leading tag equals the factory's tag (the key's first segment), and\n * 2. for every field in the partial, the key's trailing options object has an\n *    equal value. Omitted fields match anything.\n *\n * Both the partial and the stored keys are run through the same factory, so\n * `bigint` values are compared in the decimal-string form the factory emits.\n * This enables \"invalidate every subaccount query for `user`, regardless of\n * pagination or chain\" — which TanStack's leading-prefix matching can't express.\n *\n * @param keyFn - A core query-key factory, e.g. `getUserSubAccountsQueryKey`.\n * @param partial - Fields to match on. Omit to match every entry from `keyFn`.\n *\n * @example\n * ```ts\n * queryClient.invalidateQueries({\n *   predicate: predicateMatch(getUserSubAccountsQueryKey, { user }),\n * });\n * ```\n */\nexport function predicateMatch<options extends object>(\n  keyFn: (options?: options) => readonly unknown[],\n  partial?: options,\n): (query: Query<unknown, Error, unknown, QueryKey>) => boolean {\n  const reference = keyFn(partial);\n  const tag = reference[0];\n  const referenceFilter = (reference[1] ?? {}) as Record<string, unknown>;\n\n  return (query) => {\n    const key = query.queryKey;\n    if (key[0] !== tag) return false;\n    if (!partial) return true;\n\n    const segment = key[1];\n    if (typeof segment !== \"object\" || segment === null) return false;\n\n    const record = segment as Record<string, unknown>;\n    for (const [field, value] of Object.entries(referenceFilter)) {\n      if (value === undefined) continue;\n      if (record[field] !== value) return false;\n    }\n    return true;\n  };\n}\n"],"mappings":";AA0BA,SAAgB,EACd,GACA,GAC8D;CAC9D,IAAM,IAAY,EAAM,CAAO,GACzB,IAAM,EAAU,IAChB,IAAmB,EAAU,MAAM,CAAC;CAE1C,QAAQ,MAAU;EAChB,IAAM,IAAM,EAAM;EAClB,IAAI,EAAI,OAAO,GAAK,OAAO;EAC3B,IAAI,CAAC,GAAS,OAAO;EAErB,IAAM,IAAU,EAAI;EACpB,IAAI,OAAO,KAAY,aAAY,GAAkB,OAAO;EAE5D,IAAM,IAAS;EACf,KAAK,IAAM,CAAC,GAAO,MAAU,OAAO,QAAQ,CAAe,GACrD,UAAU,KAAA,KACV,EAAO,OAAW,GAAO,OAAO;EAEtC,OAAO;CACT;AACF"}

package/dist/wallet/index.d.ts

@@ -0,0 +1,5 @@
+export * from './use-connect-wallet';
+export * from './use-disconnect-wallet';
+export * from './use-switch-to-symmio-chain';
+export * from './use-wallet-account';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wallet/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC"}

package/dist/wallet/use-connect-wallet.d.ts

@@ -0,0 +1,34 @@
+import { Connector } from 'wagmi';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/**
+ * Result shape returned by {@link useConnectWallet}.
+ */
+export interface UseConnectWalletResult {
+    /** Connectors registered in the host's wagmi config. */
+    connectors: readonly Connector[];
+    /**
+     * Initiate a wallet connection. Resolves once the user has accepted the
+     * popup; rejects with a {@link SymmioRequestError} (kind `"user-rejected"`
+     * when the popup was dismissed).
+     */
+    connect: (connector: Connector) => Promise<void>;
+    /** wagmi's mutation status, passed through for UI binding. */
+    status: "idle" | "pending" | "success" | "error";
+    /** Normalized error if the most recent connect attempt failed. */
+    error?: SymmioRequestError;
+}
+/**
+ * Wraps wagmi's `useConnect` with the SDK's error normalization. The host app
+ * decides which connectors are available (injected, walletConnect, mock, etc.)
+ * via its wagmi config; this hook just surfaces them.
+ *
+ * @example
+ * const { connectors, connect, status, error } = useConnectWallet();
+ * return connectors.map((c) => (
+ *   <button key={c.id} onClick={() => connect(c)} disabled={status === "pending"}>
+ *     {c.name}
+ *   </button>
+ * ));
+ */
+export declare function useConnectWallet(): UseConnectWalletResult;
+//# sourceMappingURL=use-connect-wallet.d.ts.map

package/dist/wallet/use-connect-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connect-wallet.d.ts","sourceRoot":"","sources":["../../src/wallet/use-connect-wallet.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IACjC;;;;OAIG;IACH,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,kEAAkE;IAClE,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAkBzD"}

package/dist/wallet/use-connect-wallet.js

@@ -0,0 +1,24 @@
+"use client";
+import { normalizeSymmError as e } from "../errors/normalize-symm-error.js";
+import { useMemo as t } from "react";
+import { useConnect as n, useConnectors as r } from "wagmi";
+//#region src/wallet/use-connect-wallet.ts
+function i() {
+	let { mutateAsync: i, status: a, error: o } = n();
+	return {
+		status: a,
+		connectors: r(),
+		error: t(() => o ? e(o) : void 0, [o]),
+		connect: async (t) => {
+			try {
+				await i({ connector: t });
+			} catch (t) {
+				throw e(t);
+			}
+		}
+	};
+}
+//#endregion
+export { i as useConnectWallet };
+
+//# sourceMappingURL=use-connect-wallet.js.map

package/dist/wallet/use-connect-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connect-wallet.js","names":[],"sources":["../../src/wallet/use-connect-wallet.ts"],"sourcesContent":["\"use client\";\n\nimport { useMemo } from \"react\";\nimport { useConnect, useConnectors, type Connector } from \"wagmi\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\n\n/**\n * Result shape returned by {@link useConnectWallet}.\n */\nexport interface UseConnectWalletResult {\n  /** Connectors registered in the host's wagmi config. */\n  connectors: readonly Connector[];\n  /**\n   * Initiate a wallet connection. Resolves once the user has accepted the\n   * popup; rejects with a {@link SymmioRequestError} (kind `\"user-rejected\"`\n   * when the popup was dismissed).\n   */\n  connect: (connector: Connector) => Promise<void>;\n  /** wagmi's mutation status, passed through for UI binding. */\n  status: \"idle\" | \"pending\" | \"success\" | \"error\";\n  /** Normalized error if the most recent connect attempt failed. */\n  error?: SymmioRequestError;\n}\n\n/**\n * Wraps wagmi's `useConnect` with the SDK's error normalization. The host app\n * decides which connectors are available (injected, walletConnect, mock, etc.)\n * via its wagmi config; this hook just surfaces them.\n *\n * @example\n * const { connectors, connect, status, error } = useConnectWallet();\n * return connectors.map((c) => (\n *   <button key={c.id} onClick={() => connect(c)} disabled={status === \"pending\"}>\n *     {c.name}\n *   </button>\n * ));\n */\nexport function useConnectWallet(): UseConnectWalletResult {\n  const { mutateAsync, status, error } = useConnect();\n  const connectors = useConnectors();\n\n  const normalized = useMemo(() => (error ? normalizeSymmError(error) : undefined), [error]);\n\n  return {\n    status,\n    connectors,\n    error: normalized,\n    connect: async (connector) => {\n      try {\n        await mutateAsync({ connector });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  };\n}\n"],"mappings":";;;;;AAsCA,SAAgB,IAA2C;CACzD,IAAM,EAAE,gBAAa,WAAQ,aAAU,EAAW;CAKlD,OAAO;EACL;EACA,YANiB,EAMjB;EACA,OALiB,QAAe,IAAQ,EAAmB,CAAK,IAAI,KAAA,GAAY,CAAC,CAAK,CAK/E;EACP,SAAS,OAAO,MAAc;GAC5B,IAAI;IACF,MAAM,EAAY,EAAE,aAAU,CAAC;GACjC,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF;AACF"}