@symmio/trading-react 3.0.0 → 3.1.0

package/dist/instant-layer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instant-layer/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instant-layer/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC"}

package/dist/instant-layer/index.js

@@ -1,19 +1,26 @@
-import { useDelegationExpiry as e } from "./use-delegation-expiry.js";
-import { useGrantDelegation as t } from "./use-grant-delegation.js";
-import { useInstantClose as n } from "./use-instant-close.js";
-import { useInstantCloseAuto as r } from "./use-instant-close-auto.js";
-import { useInstantCloseBulk as i } from "./use-instant-close-bulk.js";
-import { useInstantCloseBulkAuto as a } from "./use-instant-close-bulk-auto.js";
-import { useInstantCloses as o } from "./use-instant-closes.js";
-import { useInstantOpen as s } from "./use-instant-open.js";
-import { useInstantOpenAuto as c } from "./use-instant-open-auto.js";
-import { useInstantOpenFees as l } from "./use-instant-open-fees.js";
-import { useInstantOpenQuoteId as u } from "./use-instant-open-quote-id.js";
-import { useInstantOpenWithTpSl as d } from "./use-instant-open-with-tpsl.js";
-import { useInstantOpens as f } from "./use-instant-opens.js";
-import { useInstantTradeRequiredSelectors as p } from "./use-instant-trade-required-selectors.js";
-import { useIsDelegationActive as m } from "./use-is-delegation-active.js";
-import { useLimitCloseAuto as h } from "./use-limit-close-auto.js";
-import { useLimitOpenAuto as g } from "./use-limit-open-auto.js";
-import { useSimulateGrantDelegation as _ } from "./use-simulate-grant-delegation.js";
-export { e as useDelegationExpiry, t as useGrantDelegation, n as useInstantClose, r as useInstantCloseAuto, i as useInstantCloseBulk, a as useInstantCloseBulkAuto, o as useInstantCloses, s as useInstantOpen, c as useInstantOpenAuto, l as useInstantOpenFees, u as useInstantOpenQuoteId, d as useInstantOpenWithTpSl, f as useInstantOpens, p as useInstantTradeRequiredSelectors, m as useIsDelegationActive, h as useLimitCloseAuto, g as useLimitOpenAuto, _ as useSimulateGrantDelegation };
+import { useActiveDelegations as e } from "./use-active-delegations.js";
+import { useAreDelegationsActive as t } from "./use-are-delegations-active.js";
+import { useDelegationExpiry as n } from "./use-delegation-expiry.js";
+import { useFinalizeRevokeDelegation as r } from "./use-finalize-revoke-delegation.js";
+import { useGrantDelegation as i } from "./use-grant-delegation.js";
+import { useInitiateRevokeDelegation as a } from "./use-initiate-revoke-delegation.js";
+import { useInstantClose as o } from "./use-instant-close.js";
+import { useInstantCloseAuto as s } from "./use-instant-close-auto.js";
+import { useInstantCloseBulk as c } from "./use-instant-close-bulk.js";
+import { useInstantCloseBulkAuto as l } from "./use-instant-close-bulk-auto.js";
+import { useInstantCloses as u } from "./use-instant-closes.js";
+import { useInstantOpen as d } from "./use-instant-open.js";
+import { useInstantOpenAuto as f } from "./use-instant-open-auto.js";
+import { useInstantOpenFees as p } from "./use-instant-open-fees.js";
+import { useInstantOpenQuoteId as m } from "./use-instant-open-quote-id.js";
+import { useInstantOpenWithTpSl as h } from "./use-instant-open-with-tpsl.js";
+import { useInstantOpens as g } from "./use-instant-opens.js";
+import { useInstantTradeRequiredSelectors as _ } from "./use-instant-trade-required-selectors.js";
+import { useIsDelegationActive as v } from "./use-is-delegation-active.js";
+import { useLimitCloseAuto as y } from "./use-limit-close-auto.js";
+import { useLimitOpenAuto as b } from "./use-limit-open-auto.js";
+import { usePendingRevocation as x } from "./use-pending-revocation.js";
+import { useRevocationCooldown as S } from "./use-revocation-cooldown.js";
+import { useSessionKeySelectors as C } from "./use-session-key-selectors.js";
+import { useSimulateGrantDelegation as w } from "./use-simulate-grant-delegation.js";
+export { e as useActiveDelegations, t as useAreDelegationsActive, n as useDelegationExpiry, r as useFinalizeRevokeDelegation, i as useGrantDelegation, a as useInitiateRevokeDelegation, o as useInstantClose, s as useInstantCloseAuto, c as useInstantCloseBulk, l as useInstantCloseBulkAuto, u as useInstantCloses, d as useInstantOpen, f as useInstantOpenAuto, p as useInstantOpenFees, m as useInstantOpenQuoteId, h as useInstantOpenWithTpSl, g as useInstantOpens, _ as useInstantTradeRequiredSelectors, v as useIsDelegationActive, y as useLimitCloseAuto, b as useLimitOpenAuto, x as usePendingRevocation, S as useRevocationCooldown, C as useSessionKeySelectors, w as useSimulateGrantDelegation };

package/dist/instant-layer/use-active-delegations.d.ts

@@ -0,0 +1,31 @@
+import { ConfigParameter, GetActiveDelegationsOptions, GetActiveDelegationsReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Parameters for {@link useActiveDelegations}: the core query options
+ * (delegator, delegates, selectors, chain id, TanStack `query` overrides) plus
+ * an optional `config`.
+ */
+export type UseActiveDelegationsParameters = GetActiveDelegationsOptions & ConfigParameter;
+/** Return type of {@link useActiveDelegations}. */
+export type UseActiveDelegationsReturnType = UseQueryResult<GetActiveDelegationsReturnType, SymmioRequestError>;
+/**
+ * Read which of the probed `(delegate, selector)` pairs the Instant Layer
+ * currently enforces, in one call.
+ *
+ * **Prefer this over {@link useIsDelegationActive} when the delegator may be a
+ * virtual account.** The underlying getter canonicalizes a VA to its parent
+ * sub-account the way enforcement does; the single-selector read hits the raw
+ * mapping and reports `false` for a VA whose parent holds the grant.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useActiveDelegations({
+ *   delegator: { addr: subAccount, isPartyB: false },
+ *   delegates: [sessionKey],
+ *   selectors: [selectorSet],
+ * });
+ * ```
+ */
+export declare function useActiveDelegations(parameters: UseActiveDelegationsParameters): UseActiveDelegationsReturnType;
+//# sourceMappingURL=use-active-delegations.d.ts.map

package/dist/instant-layer/use-active-delegations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-active-delegations.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-active-delegations.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,2BAA2B,GAAG,eAAe,CAAC;AAE3F,mDAAmD;AACnD,MAAM,MAAM,8BAA8B,GAAG,cAAc,CAAC,8BAA8B,EAAE,kBAAkB,CAAC,CAAC;AAEhH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,8BAA8B,GAAG,8BAA8B,CAc/G"}

package/dist/instant-layer/use-active-delegations.js

@@ -0,0 +1,23 @@
+"use client";
+import { useSymmioConfig as e } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as t } from "../errors/normalize-symm-error.js";
+import { getActiveDelegationsQueryOptions as n } from "@symmio/trading-core";
+import { useQuery as r } from "@tanstack/react-query";
+//#region src/instant-layer/use-active-delegations.ts
+function i(i) {
+	let a = n(e(i), i);
+	return r({
+		...a,
+		queryFn: async () => {
+			try {
+				return await a.queryFn();
+			} catch (e) {
+				throw t(e);
+			}
+		}
+	});
+}
+//#endregion
+export { i as useActiveDelegations };
+
+//# sourceMappingURL=use-active-delegations.js.map

package/dist/instant-layer/use-active-delegations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-active-delegations.js","names":[],"sources":["../../src/instant-layer/use-active-delegations.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getActiveDelegationsQueryOptions,\n  type ConfigParameter,\n  type GetActiveDelegationsOptions,\n  type GetActiveDelegationsReturnType,\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 { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useActiveDelegations}: the core query options\n * (delegator, delegates, selectors, chain id, TanStack `query` overrides) plus\n * an optional `config`.\n */\nexport type UseActiveDelegationsParameters = GetActiveDelegationsOptions & ConfigParameter;\n\n/** Return type of {@link useActiveDelegations}. */\nexport type UseActiveDelegationsReturnType = UseQueryResult<GetActiveDelegationsReturnType, SymmioRequestError>;\n\n/**\n * Read which of the probed `(delegate, selector)` pairs the Instant Layer\n * currently enforces, in one call.\n *\n * **Prefer this over {@link useIsDelegationActive} when the delegator may be a\n * virtual account.** The underlying getter canonicalizes a VA to its parent\n * sub-account the way enforcement does; the single-selector read hits the raw\n * mapping and reports `false` for a VA whose parent holds the grant.\n *\n * @example\n * ```tsx\n * const { data } = useActiveDelegations({\n *   delegator: { addr: subAccount, isPartyB: false },\n *   delegates: [sessionKey],\n *   selectors: [selectorSet],\n * });\n * ```\n */\nexport function useActiveDelegations(parameters: UseActiveDelegationsParameters): UseActiveDelegationsReturnType {\n  const config = useSymmioConfig(parameters);\n  const options = getActiveDelegationsQueryOptions(config, parameters);\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 UseActiveDelegationsReturnType;\n}\n"],"mappings":";;;;;;AAyCA,SAAgB,EAAqB,GAA4E;CAE/G,IAAM,IAAU,EADD,EAAgB,CACkB,GAAQ,CAAU;CAEnE,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/instant-layer/use-are-delegations-active.d.ts

@@ -0,0 +1,100 @@
+import { ConfigParameter, GetActiveDelegationsOptions, GetActiveDelegationsReturnType, InstantLayerAccount } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { Address, Hex } from 'viem';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/** Parameters for {@link useAreDelegationsActive}. */
+export interface UseAreDelegationsActiveParameters extends ConfigParameter {
+    /**
+     * Account the delegation is enforced under. May be a sub-account **or** a
+     * virtual account — the underlying read canonicalizes a VA to its parent the
+     * way the contract's own enforcement does.
+     */
+    account: InstantLayerAccount;
+    /** Delegated signer being checked, typically the session key's address. */
+    delegate: Address;
+    /**
+     * Selectors the key must hold. Pass the same set that was granted — normally
+     * the output of `useSessionKeySelectors`.
+     */
+    selectors: readonly Hex[];
+    /** Optional chain override; defaults to the config's chain. */
+    chainId?: number;
+    /** TanStack Query overrides for the underlying read. */
+    query?: GetActiveDelegationsOptions["query"];
+}
+/** Return type of {@link useAreDelegationsActive}. */
+export interface UseAreDelegationsActiveReturnType {
+    /**
+     * `true` only when every requested selector is active for the delegate. It is
+     * `false` while the read is in flight and `false` for an empty `selectors`
+     * list — a key that holds no authority is never "ready", and reporting a
+     * vacuous `true` there would green-light a flow that cannot sign anything.
+     */
+    allActive: boolean;
+    /**
+     * Requested selectors the contract does **not** report as active, in the
+     * order and casing they were requested. Until the read resolves this is the
+     * full requested set, so gate on {@link UseAreDelegationsActiveReturnType.isLoading}
+     * before rendering it as a re-grant list.
+     */
+    missing: readonly Hex[];
+    /** Requested selectors the contract reports as active for the delegate. */
+    activeSelectors: readonly Hex[];
+    /**
+     * Earliest expiry across the matched delegations, as a Unix timestamp in
+     * seconds; `undefined` when nothing is active. Selectors granted in separate
+     * transactions expire at different times and the contract reports only the
+     * soonest, so render this as "usable until", never as a per-selector expiry.
+     */
+    expiryTimestamp?: bigint;
+    /** `true` while the underlying read is in flight. */
+    isLoading: boolean;
+    /** `true` when the underlying read failed. */
+    isError: boolean;
+    /** The read's error, if any. */
+    error: SymmioRequestError | null;
+    /** Refetch the underlying read — call it after a grant or a revocation settles. */
+    refetch: UseQueryResult<GetActiveDelegationsReturnType, SymmioRequestError>["refetch"];
+    /** The full underlying query result, for states this hook does not surface. */
+    query: UseQueryResult<GetActiveDelegationsReturnType, SymmioRequestError>;
+}
+/**
+ * "Is my session key ready?" — whether one delegate currently holds **all** of
+ * the requested selectors for an account, plus exactly which ones it is
+ * missing. Drive an onboarding button off it: `allActive` gates trading,
+ * `missing` tells the user what a re-grant would add.
+ *
+ * **It is one contract read, not one per selector.** The hook calls
+ * `getActiveDelegations`, which answers the whole set in a single call *and*
+ * canonicalizes the account the way enforcement does — a virtual account
+ * resolves to its parent sub-account. The per-selector `getIsDelegationActive`
+ * reads the raw `delegations` mapping verbatim and does not canonicalize, so a
+ * fan-out over it answers `false` for a VA whose key really can act. That
+ * correctness gap, not the request count, is why this hook exists.
+ *
+ * **A pending revocation still reads as active.** `initiateRevokeDelegation`
+ * only schedules the revocation; the contract keeps enforcing the delegation
+ * until the cooldown ETA passes (see `useRevocationCooldown`). A key inside
+ * that window is reported here as active, because it is.
+ *
+ * The read is skipped entirely for an empty `selectors` list — there is nothing
+ * to probe — unless `query.enabled` says otherwise.
+ *
+ * @param parameters - Account, delegate, requested selectors, optional chain and query overrides.
+ * @returns Readiness (`allActive`, `missing`, `activeSelectors`, `expiryTimestamp`) plus the read's state.
+ *
+ * @example
+ * ```tsx
+ * const selectors = useSessionKeySelectors();
+ * const { allActive, missing, isLoading } = useAreDelegationsActive({
+ *   account: { addr: subAccount, isPartyB: false },
+ *   delegate: sessionKeyAddress,
+ *   selectors,
+ * });
+ *
+ * if (isLoading) return <Spinner />;
+ * if (!allActive) return <GrantButton missingCount={missing.length} />;
+ * ```
+ */
+export declare function useAreDelegationsActive(parameters: UseAreDelegationsActiveParameters): UseAreDelegationsActiveReturnType;
+//# sourceMappingURL=use-are-delegations-active.d.ts.map

package/dist/instant-layer/use-are-delegations-active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-are-delegations-active.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-are-delegations-active.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,sDAAsD;AACtD,MAAM,WAAW,iCAAkC,SAAQ,eAAe;IACxE;;;;OAIG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,SAAS,GAAG,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED,sDAAsD;AACtD,MAAM,WAAW,iCAAiC;IAChD;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,OAAO,EAAE,SAAS,GAAG,EAAE,CAAC;IACxB,2EAA2E;IAC3E,eAAe,EAAE,SAAS,GAAG,EAAE,CAAC;IAChC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,mFAAmF;IACnF,OAAO,EAAE,cAAc,CAAC,8BAA8B,EAAE,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC;IACvF,+EAA+E;IAC/E,KAAK,EAAE,cAAc,CAAC,8BAA8B,EAAE,kBAAkB,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iCAAiC,GAC5C,iCAAiC,CA2DnC"}

package/dist/instant-layer/use-are-delegations-active.js

@@ -0,0 +1,60 @@
+"use client";
+import { useSymmioConfig as e } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as t } from "../errors/normalize-symm-error.js";
+import { getActiveDelegationsQueryOptions as n } from "@symmio/trading-core";
+import { useMemo as r } from "react";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/instant-layer/use-are-delegations-active.ts
+function a(a) {
+	let o = e(a), { account: s, delegate: c, selectors: l, chainId: u, query: d } = a, f = n(o, {
+		delegator: s,
+		delegates: [c],
+		selectors: [l],
+		chainId: u,
+		query: {
+			...d,
+			enabled: d?.enabled ?? l.length > 0
+		}
+	}), p = i({
+		...f,
+		queryFn: async () => {
+			try {
+				return await f.queryFn();
+			} catch (e) {
+				throw t(e);
+			}
+		}
+	}), { data: m, isLoading: h, isError: g, error: _, refetch: v } = p;
+	return r(() => {
+		let e = c.toLowerCase(), t = /* @__PURE__ */ new Set(), n;
+		for (let r of m ?? []) if (r.delegatedSigner.toLowerCase() === e) {
+			for (let e of r.selectors) t.add(e.toLowerCase());
+			n = n === void 0 || r.expiryTimestamp < n ? r.expiryTimestamp : n;
+		}
+		let r = l.filter((e) => t.has(e.toLowerCase())), i = l.filter((e) => !t.has(e.toLowerCase()));
+		return {
+			allActive: l.length > 0 && i.length === 0,
+			missing: i,
+			activeSelectors: r,
+			expiryTimestamp: n,
+			isLoading: h,
+			isError: g,
+			error: _ ?? null,
+			refetch: v,
+			query: p
+		};
+	}, [
+		m,
+		c,
+		l,
+		h,
+		g,
+		_,
+		v,
+		p
+	]);
+}
+//#endregion
+export { a as useAreDelegationsActive };
+
+//# sourceMappingURL=use-are-delegations-active.js.map

package/dist/instant-layer/use-are-delegations-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-are-delegations-active.js","names":[],"sources":["../../src/instant-layer/use-are-delegations-active.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getActiveDelegationsQueryOptions,\n  type ConfigParameter,\n  type GetActiveDelegationsOptions,\n  type GetActiveDelegationsReturnType,\n  type InstantLayerAccount,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport type { Address, Hex } from \"viem\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/** Parameters for {@link useAreDelegationsActive}. */\nexport interface UseAreDelegationsActiveParameters extends ConfigParameter {\n  /**\n   * Account the delegation is enforced under. May be a sub-account **or** a\n   * virtual account — the underlying read canonicalizes a VA to its parent the\n   * way the contract's own enforcement does.\n   */\n  account: InstantLayerAccount;\n  /** Delegated signer being checked, typically the session key's address. */\n  delegate: Address;\n  /**\n   * Selectors the key must hold. Pass the same set that was granted — normally\n   * the output of `useSessionKeySelectors`.\n   */\n  selectors: readonly Hex[];\n  /** Optional chain override; defaults to the config's chain. */\n  chainId?: number;\n  /** TanStack Query overrides for the underlying read. */\n  query?: GetActiveDelegationsOptions[\"query\"];\n}\n\n/** Return type of {@link useAreDelegationsActive}. */\nexport interface UseAreDelegationsActiveReturnType {\n  /**\n   * `true` only when every requested selector is active for the delegate. It is\n   * `false` while the read is in flight and `false` for an empty `selectors`\n   * list — a key that holds no authority is never \"ready\", and reporting a\n   * vacuous `true` there would green-light a flow that cannot sign anything.\n   */\n  allActive: boolean;\n  /**\n   * Requested selectors the contract does **not** report as active, in the\n   * order and casing they were requested. Until the read resolves this is the\n   * full requested set, so gate on {@link UseAreDelegationsActiveReturnType.isLoading}\n   * before rendering it as a re-grant list.\n   */\n  missing: readonly Hex[];\n  /** Requested selectors the contract reports as active for the delegate. */\n  activeSelectors: readonly Hex[];\n  /**\n   * Earliest expiry across the matched delegations, as a Unix timestamp in\n   * seconds; `undefined` when nothing is active. Selectors granted in separate\n   * transactions expire at different times and the contract reports only the\n   * soonest, so render this as \"usable until\", never as a per-selector expiry.\n   */\n  expiryTimestamp?: bigint;\n  /** `true` while the underlying read is in flight. */\n  isLoading: boolean;\n  /** `true` when the underlying read failed. */\n  isError: boolean;\n  /** The read's error, if any. */\n  error: SymmioRequestError | null;\n  /** Refetch the underlying read — call it after a grant or a revocation settles. */\n  refetch: UseQueryResult<GetActiveDelegationsReturnType, SymmioRequestError>[\"refetch\"];\n  /** The full underlying query result, for states this hook does not surface. */\n  query: UseQueryResult<GetActiveDelegationsReturnType, SymmioRequestError>;\n}\n\n/**\n * \"Is my session key ready?\" — whether one delegate currently holds **all** of\n * the requested selectors for an account, plus exactly which ones it is\n * missing. Drive an onboarding button off it: `allActive` gates trading,\n * `missing` tells the user what a re-grant would add.\n *\n * **It is one contract read, not one per selector.** The hook calls\n * `getActiveDelegations`, which answers the whole set in a single call *and*\n * canonicalizes the account the way enforcement does — a virtual account\n * resolves to its parent sub-account. The per-selector `getIsDelegationActive`\n * reads the raw `delegations` mapping verbatim and does not canonicalize, so a\n * fan-out over it answers `false` for a VA whose key really can act. That\n * correctness gap, not the request count, is why this hook exists.\n *\n * **A pending revocation still reads as active.** `initiateRevokeDelegation`\n * only schedules the revocation; the contract keeps enforcing the delegation\n * until the cooldown ETA passes (see `useRevocationCooldown`). A key inside\n * that window is reported here as active, because it is.\n *\n * The read is skipped entirely for an empty `selectors` list — there is nothing\n * to probe — unless `query.enabled` says otherwise.\n *\n * @param parameters - Account, delegate, requested selectors, optional chain and query overrides.\n * @returns Readiness (`allActive`, `missing`, `activeSelectors`, `expiryTimestamp`) plus the read's state.\n *\n * @example\n * ```tsx\n * const selectors = useSessionKeySelectors();\n * const { allActive, missing, isLoading } = useAreDelegationsActive({\n *   account: { addr: subAccount, isPartyB: false },\n *   delegate: sessionKeyAddress,\n *   selectors,\n * });\n *\n * if (isLoading) return <Spinner />;\n * if (!allActive) return <GrantButton missingCount={missing.length} />;\n * ```\n */\nexport function useAreDelegationsActive(\n  parameters: UseAreDelegationsActiveParameters,\n): UseAreDelegationsActiveReturnType {\n  const config = useSymmioConfig(parameters);\n  const { account, delegate, selectors, chainId, query } = parameters;\n\n  const options = getActiveDelegationsQueryOptions(config, {\n    delegator: account,\n    delegates: [delegate],\n    selectors: [selectors],\n    chainId,\n    query: { ...query, enabled: query?.enabled ?? selectors.length > 0 },\n  });\n\n  const result = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<GetActiveDelegationsReturnType, SymmioRequestError>;\n\n  const { data, isLoading, isError, error, refetch } = result;\n\n  return useMemo<UseAreDelegationsActiveReturnType>(() => {\n    /**\n     * The contract echoes the delegate back per entry, so match on it rather\n     * than trusting positional alignment — and compare case-insensitively,\n     * because a checksummed request and a lowercase response are the same key.\n     */\n    const wanted = delegate.toLowerCase();\n    const active = new Set<string>();\n    let expiryTimestamp: bigint | undefined;\n\n    for (const entry of data ?? []) {\n      if (entry.delegatedSigner.toLowerCase() !== wanted) continue;\n      for (const selector of entry.selectors) active.add(selector.toLowerCase());\n      expiryTimestamp =\n        expiryTimestamp === undefined || entry.expiryTimestamp < expiryTimestamp\n          ? entry.expiryTimestamp\n          : expiryTimestamp;\n    }\n\n    const activeSelectors = selectors.filter((selector) => active.has(selector.toLowerCase()));\n    const missing = selectors.filter((selector) => !active.has(selector.toLowerCase()));\n\n    return {\n      allActive: selectors.length > 0 && missing.length === 0,\n      missing,\n      activeSelectors,\n      expiryTimestamp,\n      isLoading,\n      isError,\n      error: error ?? null,\n      refetch,\n      query: result,\n    };\n  }, [data, delegate, selectors, isLoading, isError, error, refetch, result]);\n}\n"],"mappings":";;;;;;;AAgHA,SAAgB,EACd,GACmC;CACnC,IAAM,IAAS,EAAgB,CAAU,GACnC,EAAE,YAAS,aAAU,cAAW,YAAS,aAAU,GAEnD,IAAU,EAAiC,GAAQ;EACvD,WAAW;EACX,WAAW,CAAC,CAAQ;EACpB,WAAW,CAAC,CAAS;EACrB;EACA,OAAO;GAAE,GAAG;GAAO,SAAS,GAAO,WAAW,EAAU,SAAS;EAAE;CACrE,CAAC,GAEK,IAAS,EAAS;EACtB,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC,GAEK,EAAE,SAAM,cAAW,YAAS,UAAO,eAAY;CAErD,OAAO,QAAiD;EAMtD,IAAM,IAAS,EAAS,YAAY,GAC9B,oBAAS,IAAI,IAAY,GAC3B;EAEJ,KAAK,IAAM,KAAS,KAAQ,CAAC,GACvB,MAAM,gBAAgB,YAAY,MAAM,GAC5C;QAAK,IAAM,KAAY,EAAM,WAAW,EAAO,IAAI,EAAS,YAAY,CAAC;GACzE,IACE,MAAoB,KAAA,KAAa,EAAM,kBAAkB,IACrD,EAAM,kBACN;EAJmE;EAO3E,IAAM,IAAkB,EAAU,QAAQ,MAAa,EAAO,IAAI,EAAS,YAAY,CAAC,CAAC,GACnF,IAAU,EAAU,QAAQ,MAAa,CAAC,EAAO,IAAI,EAAS,YAAY,CAAC,CAAC;EAElF,OAAO;GACL,WAAW,EAAU,SAAS,KAAK,EAAQ,WAAW;GACtD;GACA;GACA;GACA;GACA;GACA,OAAO,KAAS;GAChB;GACA,OAAO;EACT;CACF,GAAG;EAAC;EAAM;EAAU;EAAW;EAAW;EAAS;EAAO;EAAS;CAAM,CAAC;AAC5E"}

package/dist/instant-layer/use-finalize-revoke-delegation.d.ts

@@ -0,0 +1,32 @@
+import { FinalizeRevokeDelegationParameters } from '@symmio/trading-core';
+import { UseMutationResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+import { WriteParameters, WriteResult } from '../transactions/index.js';
+/** Parameters for {@link useFinalizeRevokeDelegation}. */
+export type UseFinalizeRevokeDelegationParameters = WriteParameters;
+/** Result returned by the {@link useFinalizeRevokeDelegation} mutation. */
+export type FinalizeRevokeDelegationResult = WriteResult;
+/** Return type of {@link useFinalizeRevokeDelegation}. */
+export type UseFinalizeRevokeDelegationReturnType = UseMutationResult<FinalizeRevokeDelegationResult, SymmioRequestError, FinalizeRevokeDelegationParameters>;
+/**
+ * Complete a scheduled Instant Layer revocation, clearing the stored grant.
+ *
+ * **Always a gas-paid wallet transaction — there is no gasless option.** The
+ * relay signs InstantLayer *operations*, and the contract accepts a
+ * self-targeted operation only as a delegation grant, so a relayed revocation
+ * would revert.
+ *
+ * **Permissionless once the cooldown has passed**, so a keeper or backend can
+ * finish a revocation the owner started. It reverts `RevocationCooldownNotOver`
+ * while the ETA is still in the future. Note that enforcement already stops
+ * honoring the delegation at the ETA, so this is the bookkeeping leg rather
+ * than the moment authority ends — see {@link useInitiateRevokeDelegation}.
+ *
+ * @example
+ * ```tsx
+ * const { mutate } = useFinalizeRevokeDelegation();
+ * mutate({ account: { addr: subAccount, isPartyB: false }, delegate: sessionKey, selectors });
+ * ```
+ */
+export declare function useFinalizeRevokeDelegation(parameters?: UseFinalizeRevokeDelegationParameters): UseFinalizeRevokeDelegationReturnType;
+//# sourceMappingURL=use-finalize-revoke-delegation.d.ts.map

package/dist/instant-layer/use-finalize-revoke-delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-finalize-revoke-delegation.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-finalize-revoke-delegation.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,kCAAkC,EACxC,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,0DAA0D;AAC1D,MAAM,MAAM,qCAAqC,GAAG,eAAe,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,MAAM,8BAA8B,GAAG,WAAW,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,MAAM,qCAAqC,GAAG,iBAAiB,CACnE,8BAA8B,EAC9B,kBAAkB,EAClB,kCAAkC,CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,GAAE,qCAA0C,GACrD,qCAAqC,CA4CvC"}

package/dist/instant-layer/use-finalize-revoke-delegation.js

@@ -0,0 +1,45 @@
+"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 { finalizeRevokeDelegationMutationOptions as a, getActiveDelegationsQueryKey as o, getDelegationExpiryQueryKey as s, getIsDelegationActiveQueryKey as c, getPendingRevocationEtasQueryKey as l } from "@symmio/trading-core";
+import { useMutation as u, useQueryClient as d } from "@tanstack/react-query";
+//#region src/instant-layer/use-finalize-revoke-delegation.ts
+function f(f = {}) {
+	let p = t(f), m = e(), h = d(), g = a(p);
+	return u({
+		mutationKey: g.mutationKey,
+		mutationFn: async (e) => {
+			try {
+				return r(p, await g.mutationFn(e), {
+					chainId: e.chainId,
+					waitForReceipt: f.waitForReceipt,
+					confirmations: f.confirmations
+				});
+			} catch (e) {
+				throw n(e);
+			}
+		},
+		onSuccess: (e, t) => {
+			let n = p.getChainConfigKey(t.chainId ?? m), r = {
+				configKey: n,
+				account: t.account.addr,
+				delegate: t.delegate
+			};
+			h.invalidateQueries({ predicate: i(s, r) }), h.invalidateQueries({ predicate: i(c, r) }), h.invalidateQueries({ predicate: i(o, {
+				configKey: n,
+				delegator: t.account
+			}) }), h.invalidateQueries({ predicate: i(l, {
+				configKey: n,
+				delegator: t.account,
+				delegate: t.delegate
+			}) });
+		}
+	});
+}
+//#endregion
+export { f as useFinalizeRevokeDelegation };
+
+//# sourceMappingURL=use-finalize-revoke-delegation.js.map

package/dist/instant-layer/use-finalize-revoke-delegation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-finalize-revoke-delegation.js","names":[],"sources":["../../src/instant-layer/use-finalize-revoke-delegation.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  finalizeRevokeDelegationMutationOptions,\n  getActiveDelegationsQueryKey,\n  getDelegationExpiryQueryKey,\n  getIsDelegationActiveQueryKey,\n  getPendingRevocationEtasQueryKey,\n  type FinalizeRevokeDelegationParameters,\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/** Parameters for {@link useFinalizeRevokeDelegation}. */\nexport type UseFinalizeRevokeDelegationParameters = WriteParameters;\n\n/** Result returned by the {@link useFinalizeRevokeDelegation} mutation. */\nexport type FinalizeRevokeDelegationResult = WriteResult;\n\n/** Return type of {@link useFinalizeRevokeDelegation}. */\nexport type UseFinalizeRevokeDelegationReturnType = UseMutationResult<\n  FinalizeRevokeDelegationResult,\n  SymmioRequestError,\n  FinalizeRevokeDelegationParameters\n>;\n\n/**\n * Complete a scheduled Instant Layer revocation, clearing the stored grant.\n *\n * **Always a gas-paid wallet transaction — there is no gasless option.** The\n * relay signs InstantLayer *operations*, and the contract accepts a\n * self-targeted operation only as a delegation grant, so a relayed revocation\n * would revert.\n *\n * **Permissionless once the cooldown has passed**, so a keeper or backend can\n * finish a revocation the owner started. It reverts `RevocationCooldownNotOver`\n * while the ETA is still in the future. Note that enforcement already stops\n * honoring the delegation at the ETA, so this is the bookkeeping leg rather\n * than the moment authority ends — see {@link useInitiateRevokeDelegation}.\n *\n * @example\n * ```tsx\n * const { mutate } = useFinalizeRevokeDelegation();\n * mutate({ account: { addr: subAccount, isPartyB: false }, delegate: sessionKey, selectors });\n * ```\n */\nexport function useFinalizeRevokeDelegation(\n  parameters: UseFinalizeRevokeDelegationParameters = {},\n): UseFinalizeRevokeDelegationReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = finalizeRevokeDelegationMutationOptions(config);\n\n  return useMutation<FinalizeRevokeDelegationResult, SymmioRequestError, FinalizeRevokeDelegationParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const hash = await base.mutationFn(variables);\n        return resolveWriteResult(config, hash, {\n          chainId: variables.chainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_data, variables) => {\n      const configKey = config.getChainConfigKey(variables.chainId ?? chainId);\n      const delegation = { configKey, account: variables.account.addr, delegate: variables.delegate };\n\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getDelegationExpiryQueryKey, delegation) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getIsDelegationActiveQueryKey, delegation) });\n      /**\n       * The canonicalizing read keys by `delegator`, not `account`, so it needs\n       * its own predicate rather than reusing the pair above.\n       */\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getActiveDelegationsQueryKey, { configKey, delegator: variables.account }),\n      });\n      /** Finalizing clears the schedule too, so the pending read must not go stale. */\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getPendingRevocationEtasQueryKey, {\n          configKey,\n          delegator: variables.account,\n          delegate: variables.delegate,\n        }),\n      });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AAmDA,SAAgB,EACd,IAAoD,CAAC,GACd;CACvC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAwC,CAAM;CAE3D,OAAO,EAAoG;EACzG,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IAEF,OAAO,EAAmB,GAAQ,MADf,EAAK,WAAW,CAAS,GACJ;KACtC,SAAS,EAAU;KACnB,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAO,MAAc;GAC/B,IAAM,IAAY,EAAO,kBAAkB,EAAU,WAAW,CAAO,GACjE,IAAa;IAAE;IAAW,SAAS,EAAU,QAAQ;IAAM,UAAU,EAAU;GAAS;GAY9F,AAVA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAU,EAAE,CAAC,GACzG,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA+B,CAAU,EAAE,CAAC,GAK3G,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAA8B;IAAE;IAAW,WAAW,EAAU;GAAQ,CAAC,EACrG,CAAC,GAED,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAAkC;IAC1D;IACA,WAAW,EAAU;IACrB,UAAU,EAAU;GACtB,CAAC,EACH,CAAC;EACH;CACF,CAAC;AACH"}

package/dist/instant-layer/use-grant-delegation.d.ts

@@ -13,8 +13,18 @@ export type GrantDelegationResult = WriteResult;
 /** Return type of {@link useGrantDelegation}. */
 export type UseGrantDelegationReturnType = UseMutationResult<GrantDelegationResult, SymmioRequestError, GrantDelegationParameters>;
 /**
- * Submit an Instant Layer `grantDelegation` transaction. On success, delegation
- * access queries for the account/delegated signer are invalidated.
+ * Grant Instant Layer delegation access for one delegated signer.
+ *
+ * **The transport comes from config, not from the hook.** Where the chain runs
+ * in gasless execution mode (or the call passes `gasless: true`), the grant is
+ * signed as an InstantLayer operation and relayed — the owner pays no native
+ * gas — and the relayer's broadcast hash comes back exactly where a
+ * wallet-submitted hash would, so the receipt wait and the invalidation below
+ * are identical either way. A `isPartyB: true` account always takes the wallet
+ * path; the signed-operation encoder has no PartyB form.
+ *
+ * On success the delegation reads for the account/delegated signer are
+ * invalidated, along with the reads a *relayed* grant additionally moves.
  *
  * @example
  * ```tsx

package/dist/instant-layer/use-grant-delegation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-grant-delegation.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-grant-delegation.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,eAAe,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEhD,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAC1D,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,CAC1B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,4BAAiC,GAAG,4BAA4B,CAmC9G"}
+{"version":3,"file":"use-grant-delegation.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-grant-delegation.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,yBAAyB,EAC/B,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,4BAA4B,GAAG,eAAe,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEhD,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAC1D,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,4BAAiC,GAAG,4BAA4B,CA4C9G"}

package/dist/instant-layer/use-grant-delegation.js

@@ -1,38 +1,45 @@
 "use client";
-import { useSymmioConfig as e } from "../provider/use-symmio-config.js";
-import { normalizeSymmError as t } from "../errors/normalize-symm-error.js";
-import { resolveWriteResult as n } from "../transactions/resolve-write-result.js";
-import { predicateMatch as r } from "../utils/predicate-match.js";
-import { getDelegationExpiryQueryKey as i, getIsDelegationActiveQueryKey as a, grantDelegationMutationOptions as o } from "@symmio/trading-core";
-import { useMutation as s, useQueryClient as c } from "@tanstack/react-query";
+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 { invalidateAccountBalances as a } from "../utils/invalidate-account-balances.js";
+import { getDelegationExpiryQueryKey as o, getInstantLayerNonceQueryKey as s, getIsDelegationActiveQueryKey as c, getOperationalFeeAllowanceQueryKey as l, grantDelegationMutationOptions as u } from "@symmio/trading-core";
+import { useMutation as d, useQueryClient as f } from "@tanstack/react-query";
 //#region src/instant-layer/use-grant-delegation.ts
-function l(l = {}) {
-	let u = e(l), d = c(), f = o(u);
-	return s({
-		mutationKey: f.mutationKey,
+function p(p = {}) {
+	let m = t(p), h = e(), g = f(), _ = u(m);
+	return d({
+		mutationKey: _.mutationKey,
 		mutationFn: async (e) => {
 			try {
-				return n(u, await f.mutationFn(e), {
+				return r(m, await _.mutationFn(e), {
 					chainId: e.chainId,
-					waitForReceipt: l.waitForReceipt,
-					confirmations: l.confirmations
+					waitForReceipt: p.waitForReceipt,
+					confirmations: p.confirmations
 				});
 			} catch (e) {
-				throw t(e);
+				throw n(e);
 			}
 		},
 		onSuccess: (e, t) => {
-			d.invalidateQueries({ predicate: r(i, {
+			let n = m.getChainConfigKey(t.chainId ?? h), r = {
+				configKey: n,
 				account: t.account.addr,
 				delegate: t.delegatedSigner
-			}) }), d.invalidateQueries({ predicate: r(a, {
-				account: t.account.addr,
-				delegate: t.delegatedSigner
-			}) });
+			};
+			g.invalidateQueries({ predicate: i(o, r) }), g.invalidateQueries({ predicate: i(c, r) }), g.invalidateQueries({ predicate: i(s, {
+				configKey: n,
+				account: t.account.addr
+			}) }), g.invalidateQueries({ predicate: i(l, {
+				configKey: n,
+				payer: t.account.addr
+			}) }), a(g, { configKey: n });
 		}
 	});
 }
 //#endregion
-export { l as useGrantDelegation };
+export { p as useGrantDelegation };
 
 //# sourceMappingURL=use-grant-delegation.js.map

package/dist/instant-layer/use-grant-delegation.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-grant-delegation.js","names":[],"sources":["../../src/instant-layer/use-grant-delegation.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getDelegationExpiryQueryKey,\n  getIsDelegationActiveQueryKey,\n  grantDelegationMutationOptions,\n  type GrantDelegationParameters,\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 { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { resolveWriteResult, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useGrantDelegation}.\n */\nexport type UseGrantDelegationParameters = WriteParameters;\n\n/**\n * Result returned by the {@link useGrantDelegation} mutation.\n */\nexport type GrantDelegationResult = WriteResult;\n\n/** Return type of {@link useGrantDelegation}. */\nexport type UseGrantDelegationReturnType = UseMutationResult<\n  GrantDelegationResult,\n  SymmioRequestError,\n  GrantDelegationParameters\n>;\n\n/**\n * Submit an Instant Layer `grantDelegation` transaction. On success, delegation\n * access queries for the account/delegated signer are invalidated.\n *\n * @example\n * ```tsx\n * const { mutate } = useGrantDelegation();\n * mutate({ account: { addr: account, isPartyB: false }, delegatedSigner, selectors, expiryTimestamp });\n * ```\n */\nexport function useGrantDelegation(parameters: UseGrantDelegationParameters = {}): UseGrantDelegationReturnType {\n  const config = useSymmioConfig(parameters);\n  const queryClient = useQueryClient();\n\n  const base = grantDelegationMutationOptions(config);\n\n  return useMutation<GrantDelegationResult, SymmioRequestError, GrantDelegationParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const hash = await base.mutationFn(variables);\n        return resolveWriteResult(config, hash, {\n          chainId: variables.chainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_data, variables) => {\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getDelegationExpiryQueryKey, {\n          account: variables.account.addr,\n          delegate: variables.delegatedSigner,\n        }),\n      });\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getIsDelegationActiveQueryKey, {\n          account: variables.account.addr,\n          delegate: variables.delegatedSigner,\n        }),\n      });\n    },\n  });\n}\n"],"mappings":";;;;;;;;AA0CA,SAAgB,EAAmB,IAA2C,CAAC,GAAiC;CAC9G,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAc,EAAe,GAE7B,IAAO,EAA+B,CAAM;CAElD,OAAO,EAAkF;EACvF,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IAEF,OAAO,EAAmB,GAAQ,MADf,EAAK,WAAW,CAAS,GACJ;KACtC,SAAS,EAAU;KACnB,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAO,MAAc;GAO/B,AANA,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAA6B;IACrD,SAAS,EAAU,QAAQ;IAC3B,UAAU,EAAU;GACtB,CAAC,EACH,CAAC,GACD,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAA+B;IACvD,SAAS,EAAU,QAAQ;IAC3B,UAAU,EAAU;GACtB,CAAC,EACH,CAAC;EACH;CACF,CAAC;AACH"}
+{"version":3,"file":"use-grant-delegation.js","names":[],"sources":["../../src/instant-layer/use-grant-delegation.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getDelegationExpiryQueryKey,\n  getInstantLayerNonceQueryKey,\n  getIsDelegationActiveQueryKey,\n  getOperationalFeeAllowanceQueryKey,\n  grantDelegationMutationOptions,\n  type GrantDelegationParameters,\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 { invalidateAccountBalances, predicateMatch } from \"../utils\";\n\n/**\n * Parameters for {@link useGrantDelegation}.\n */\nexport type UseGrantDelegationParameters = WriteParameters;\n\n/**\n * Result returned by the {@link useGrantDelegation} mutation.\n */\nexport type GrantDelegationResult = WriteResult;\n\n/** Return type of {@link useGrantDelegation}. */\nexport type UseGrantDelegationReturnType = UseMutationResult<\n  GrantDelegationResult,\n  SymmioRequestError,\n  GrantDelegationParameters\n>;\n\n/**\n * Grant Instant Layer delegation access for one delegated signer.\n *\n * **The transport comes from config, not from the hook.** Where the chain runs\n * in gasless execution mode (or the call passes `gasless: true`), the grant is\n * signed as an InstantLayer operation and relayed — the owner pays no native\n * gas — and the relayer's broadcast hash comes back exactly where a\n * wallet-submitted hash would, so the receipt wait and the invalidation below\n * are identical either way. A `isPartyB: true` account always takes the wallet\n * path; the signed-operation encoder has no PartyB form.\n *\n * On success the delegation reads for the account/delegated signer are\n * invalidated, along with the reads a *relayed* grant additionally moves.\n *\n * @example\n * ```tsx\n * const { mutate } = useGrantDelegation();\n * mutate({ account: { addr: account, isPartyB: false }, delegatedSigner, selectors, expiryTimestamp });\n * ```\n */\nexport function useGrantDelegation(parameters: UseGrantDelegationParameters = {}): UseGrantDelegationReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = grantDelegationMutationOptions(config);\n\n  return useMutation<GrantDelegationResult, SymmioRequestError, GrantDelegationParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const hash = await base.mutationFn(variables);\n        return resolveWriteResult(config, hash, {\n          chainId: variables.chainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_data, variables) => {\n      const configKey = config.getChainConfigKey(variables.chainId ?? chainId);\n      const delegation = { configKey, account: variables.account.addr, delegate: variables.delegatedSigner };\n\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getDelegationExpiryQueryKey, delegation) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getIsDelegationActiveQueryKey, delegation) });\n\n      /**\n       * A relayed grant also consumes an InstantLayer nonce and charges the\n       * operational fee from collateral. The hook cannot see which transport\n       * ran, so it invalidates the superset: a wallet grant moves none of\n       * these, and an extra refetch costs far less than a stale allowance\n       * silently blocking the next relay.\n       */\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getInstantLayerNonceQueryKey, { configKey, account: variables.account.addr }),\n      });\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getOperationalFeeAllowanceQueryKey, { configKey, payer: variables.account.addr }),\n      });\n      invalidateAccountBalances(queryClient, { configKey });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AAuDA,SAAgB,EAAmB,IAA2C,CAAC,GAAiC;CAC9G,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAA+B,CAAM;CAElD,OAAO,EAAkF;EACvF,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IAEF,OAAO,EAAmB,GAAQ,MADf,EAAK,WAAW,CAAS,GACJ;KACtC,SAAS,EAAU;KACnB,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAO,MAAc;GAC/B,IAAM,IAAY,EAAO,kBAAkB,EAAU,WAAW,CAAO,GACjE,IAAa;IAAE;IAAW,SAAS,EAAU,QAAQ;IAAM,UAAU,EAAU;GAAgB;GAkBrG,AAhBA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA6B,CAAU,EAAE,CAAC,GACzG,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA+B,CAAU,EAAE,CAAC,GAS3G,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAA8B;IAAE;IAAW,SAAS,EAAU,QAAQ;GAAK,CAAC,EACxG,CAAC,GACD,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAAoC;IAAE;IAAW,OAAO,EAAU,QAAQ;GAAK,CAAC,EAC5G,CAAC,GACD,EAA0B,GAAa,EAAE,aAAU,CAAC;EACtD;CACF,CAAC;AACH"}

package/dist/instant-layer/use-initiate-revoke-delegation.d.ts

@@ -0,0 +1,32 @@
+import { InitiateRevokeDelegationParameters } from '@symmio/trading-core';
+import { UseMutationResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+import { WriteParameters, WriteResult } from '../transactions/index.js';
+/** Parameters for {@link useInitiateRevokeDelegation}. */
+export type UseInitiateRevokeDelegationParameters = WriteParameters;
+/** Result returned by the {@link useInitiateRevokeDelegation} mutation. */
+export type InitiateRevokeDelegationResult = WriteResult;
+/** Return type of {@link useInitiateRevokeDelegation}. */
+export type UseInitiateRevokeDelegationReturnType = UseMutationResult<InitiateRevokeDelegationResult, SymmioRequestError, InitiateRevokeDelegationParameters>;
+/**
+ * Start revoking a session key's Instant Layer delegation.
+ *
+ * **Always a gas-paid wallet transaction — there is no gasless option.** The
+ * relay signs InstantLayer *operations*, and the contract accepts a
+ * self-targeted operation only as a delegation grant, so a relayed revocation
+ * would revert. Budget native gas for this call.
+ *
+ * The contract accepts it from the account owner, from the delegate itself, or
+ * from a `REVOKER_ROLE` holder, and it only *schedules* the revocation: the key
+ * keeps its authority until the cooldown ETA passes (see
+ * {@link useRevocationCooldown}), after which {@link useFinalizeRevokeDelegation}
+ * clears the stored grant.
+ *
+ * @example
+ * ```tsx
+ * const { mutate } = useInitiateRevokeDelegation();
+ * mutate({ account: { addr: subAccount, isPartyB: false }, delegate: sessionKey, selectors });
+ * ```
+ */
+export declare function useInitiateRevokeDelegation(parameters?: UseInitiateRevokeDelegationParameters): UseInitiateRevokeDelegationReturnType;
+//# sourceMappingURL=use-initiate-revoke-delegation.d.ts.map

package/dist/instant-layer/use-initiate-revoke-delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-initiate-revoke-delegation.d.ts","sourceRoot":"","sources":["../../src/instant-layer/use-initiate-revoke-delegation.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,kCAAkC,EACxC,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,0DAA0D;AAC1D,MAAM,MAAM,qCAAqC,GAAG,eAAe,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,MAAM,8BAA8B,GAAG,WAAW,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,MAAM,qCAAqC,GAAG,iBAAiB,CACnE,8BAA8B,EAC9B,kBAAkB,EAClB,kCAAkC,CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,GAAE,qCAA0C,GACrD,qCAAqC,CA+CvC"}

package/dist/instant-layer/use-initiate-revoke-delegation.js

@@ -0,0 +1,45 @@
+"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 { getActiveDelegationsQueryKey as a, getDelegationExpiryQueryKey as o, getIsDelegationActiveQueryKey as s, getPendingRevocationEtasQueryKey as c, initiateRevokeDelegationMutationOptions as l } from "@symmio/trading-core";
+import { useMutation as u, useQueryClient as d } from "@tanstack/react-query";
+//#region src/instant-layer/use-initiate-revoke-delegation.ts
+function f(f = {}) {
+	let p = t(f), m = e(), h = d(), g = l(p);
+	return u({
+		mutationKey: g.mutationKey,
+		mutationFn: async (e) => {
+			try {
+				return r(p, await g.mutationFn(e), {
+					chainId: e.chainId,
+					waitForReceipt: f.waitForReceipt,
+					confirmations: f.confirmations
+				});
+			} catch (e) {
+				throw n(e);
+			}
+		},
+		onSuccess: (e, t) => {
+			let n = p.getChainConfigKey(t.chainId ?? m), r = {
+				configKey: n,
+				account: t.account.addr,
+				delegate: t.delegate
+			};
+			h.invalidateQueries({ predicate: i(o, r) }), h.invalidateQueries({ predicate: i(s, r) }), h.invalidateQueries({ predicate: i(a, {
+				configKey: n,
+				delegator: t.account
+			}) }), h.invalidateQueries({ predicate: i(c, {
+				configKey: n,
+				delegator: t.account,
+				delegate: t.delegate
+			}) });
+		}
+	});
+}
+//#endregion
+export { f as useInitiateRevokeDelegation };
+
+//# sourceMappingURL=use-initiate-revoke-delegation.js.map