@zama-fhe/react-sdk 1.2.0-alpha.3 → 1.2.0-alpha.5

package/dist/index.d.ts

@@ -421,7 +421,7 @@ interface UseConfidentialBalanceConfig {
   handleRefetchInterval?: number;
 }
 /** Query options for the decrypt phase of {@link useConfidentialBalance}. */
-type UseConfidentialBalanceOptions = Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">;
+type UseConfidentialBalanceOptions = Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">;
 /**
  * Declarative hook to read the connected wallet's confidential token balance.
  * Uses two-phase polling: cheaply polls the encrypted handle, then only
@@ -619,7 +619,7 @@ interface UseConfidentialBalancesConfig {
   maxConcurrency?: number;
 }
 /** Query options for the decrypt phase of {@link useConfidentialBalances}. */
-type UseConfidentialBalancesOptions = Omit<UseQueryOptions<ConfidentialBalancesData$1, Error>, "queryKey" | "queryFn">;
+type UseConfidentialBalancesOptions = Omit<UseQueryOptions<ConfidentialBalancesData$1>, "queryKey" | "queryFn">;
 /**
  * Declarative hook to read multiple confidential token balances in batch.
  * Uses two-phase polling: cheaply polls encrypted handles, then only
@@ -867,7 +867,7 @@ declare function useRevokeTokens(options?: UseMutationOptions<void, Error, Addre
  * revokeSession();
  * ```
  */
-declare function useRevokeSession(options?: UseMutationOptions<void, Error, void>): _tanstack_react_query0.UseMutationResult<void, Error, void, unknown>;
+declare function useRevokeSession(options?: UseMutationOptions<void>): _tanstack_react_query0.UseMutationResult<void, Error, void, unknown>;
 //#endregion
 //#region src/token/use-confidential-transfer.d.ts
 /** Configuration for {@link useConfidentialTransfer}. */
@@ -982,7 +982,7 @@ interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {
  * });
  * ```
  */
-declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConfig, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<unknown, Error>;
+declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConfig, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<unknown, Error>;
 /**
  * Suspense variant of {@link useConfidentialIsApproved}.
  * Suspends rendering until the approval check resolves.
@@ -1214,7 +1214,7 @@ interface UseUnderlyingAllowanceConfig {
  * });
  * ```
  */
-declare function useUnderlyingAllowance(config: UseUnderlyingAllowanceConfig, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
+declare function useUnderlyingAllowance(config: UseUnderlyingAllowanceConfig, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
 /**
  * Suspense variant of {@link useUnderlyingAllowance}.
  * Suspends rendering until the allowance is loaded.
@@ -1264,7 +1264,7 @@ interface UseWrapperDiscoverySuspenseConfig {
  * });
  * ```
  */
-declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address$1 | null, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<`0x${string}` | null, Error>;
+declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address$1 | null>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<`0x${string}` | null, Error>;
 /**
  * Suspense variant of {@link useWrapperDiscovery}.
  * Suspends rendering until the wrapper address is resolved.
@@ -1297,7 +1297,7 @@ declare function useWrapperDiscoverySuspense(config: UseWrapperDiscoverySuspense
  * // metadata?.name, metadata?.symbol, metadata?.decimals
  * ```
  */
-declare function useMetadata(tokenAddress: Address$1, options?: Omit<UseQueryOptions<TokenMetadata, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<TokenMetadata, Error>;
+declare function useMetadata(tokenAddress: Address$1, options?: Omit<UseQueryOptions<TokenMetadata>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<TokenMetadata, Error>;
 /**
  * Suspense variant of {@link useMetadata}.
  * Suspends rendering until metadata is loaded.
@@ -1474,7 +1474,7 @@ declare function useApproveUnderlying(config: UseZamaConfig, options?: UseMutati
  * const { data: isConfidential } = useIsConfidential("0xToken");
  * ```
  */
-declare function useIsConfidential(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<boolean, Error>;
+declare function useIsConfidential(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<boolean, Error>;
 /**
  * Suspense variant of {@link useIsConfidential}.
  * Suspends rendering until the ERC-165 check resolves.
@@ -1501,7 +1501,7 @@ declare function useIsConfidentialSuspense(tokenAddress: Address$1): _tanstack_r
  * const { data: isWrapper } = useIsWrapper("0xToken");
  * ```
  */
-declare function useIsWrapper(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<boolean, Error>;
+declare function useIsWrapper(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<boolean, Error>;
 /**
  * Suspense variant of {@link useIsWrapper}.
  * Suspends rendering until the ERC-165 check resolves.
@@ -1530,7 +1530,7 @@ declare function useIsWrapperSuspense(tokenAddress: Address$1): _tanstack_react_
  * const { data: totalSupply } = useTotalSupply("0xToken");
  * ```
  */
-declare function useTotalSupply(tokenAddress: Address$1, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
+declare function useTotalSupply(tokenAddress: Address$1, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
 /**
  * Suspense variant of {@link useTotalSupply}.
  * Suspends rendering until the total supply is loaded.
@@ -1574,7 +1574,7 @@ interface UseFeeConfig {
  * });
  * ```
  */
-declare function useShieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
+declare function useShieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
 /**
  * Read the unshield fee for a given amount and address pair.
  *
@@ -1592,7 +1592,7 @@ declare function useShieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptio
  * });
  * ```
  */
-declare function useUnshieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
+declare function useUnshieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
 /**
  * Read the batch transfer fee from the fee manager.
  *
@@ -1605,7 +1605,7 @@ declare function useUnshieldFee(config: UseFeeConfig, options?: Omit<UseQueryOpt
  * const { data: fee } = useBatchTransferFee("0xFeeManager");
  * ```
  */
-declare function useBatchTransferFee(feeManagerAddress: Address$1, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
+declare function useBatchTransferFee(feeManagerAddress: Address$1, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<bigint, Error>;
 /**
  * Read the fee recipient address from the fee manager.
  *
@@ -1618,10 +1618,10 @@ declare function useBatchTransferFee(feeManagerAddress: Address$1, options?: Omi
  * const { data: recipient } = useFeeRecipient("0xFeeManager");
  * ```
  */
-declare function useFeeRecipient(feeManagerAddress: Address$1, options?: Omit<UseQueryOptions<Address$1, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<`0x${string}`, Error>;
+declare function useFeeRecipient(feeManagerAddress: Address$1, options?: Omit<UseQueryOptions<Address$1>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<`0x${string}`, Error>;
 //#endregion
 //#region src/token/optimistic-balance-update.d.ts
-type OptimisticBalanceSnapshot = Array<[QueryKey, bigint | undefined]>;
+type OptimisticBalanceSnapshot = [QueryKey, bigint | undefined][];
 /** Combined context returned by optimistic `onMutate`. */
 interface OptimisticMutateContext {
   snapshot: OptimisticBalanceSnapshot;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["ZamaSDK","encryptMutationOptions","zamaQueryKeys","useQuery","tanstack_useQuery","hashFn","useSuspenseQuery","tanstack_useSuspenseQuery","useQuery","publicKeyQueryOptions","useQuery","publicParamsQueryOptions","useQuery","hashFn","useQuery","signerAddressQueryOptions","confidentialHandleQueryOptions","confidentialBalanceQueryOptions","useQuery","signerAddressQueryOptions","confidentialHandlesQueryOptions","confidentialBalancesQueryOptions","allowMutationOptions","zamaQueryKeys","useQuery","signerAddressQueryOptions","isAllowedQueryOptions","zamaQueryKeys","revokeMutationOptions","zamaQueryKeys","revokeSessionMutationOptions","zamaQueryKeys","zamaQueryKeys","confidentialTransferMutationOptions","confidentialTransferFromMutationOptions","confidentialApproveMutationOptions","useQuery","signerAddressQueryOptions","confidentialIsApprovedQueryOptions","zamaQueryKeys","useSuspenseQuery","shieldMutationOptions","shieldETHMutationOptions","unwrapMutationOptions","unwrapAllMutationOptions","finalizeUnwrapMutationOptions","unshieldMutationOptions","unshieldAllMutationOptions","resumeUnshieldMutationOptions","useQuery","signerAddressQueryOptions","underlyingAllowanceQueryOptions","useSuspenseQuery","useQuery","wrapperDiscoveryQueryOptions","zamaQueryKeys","useSuspenseQuery","useQuery","tokenMetadataQueryOptions","useSuspenseQuery","useQuery","activityFeedQueryOptions","delegateDecryptionMutationOptions","zamaQueryKeys","revokeDelegationMutationOptions","zamaQueryKeys","useQuery","delegationStatusQueryOptions","zamaQueryKeys","decryptBalanceAsMutationOptions","ReadonlyToken","approveUnderlyingMutationOptions","useQuery","isConfidentialQueryOptions","useSuspenseQuery","isWrapperQueryOptions","useQuery","totalSupplyQueryOptions","useSuspenseQuery","shieldFeeQueryOptions","useQuery","unshieldFeeQueryOptions","batchTransferFeeQueryOptions","feeRecipientQueryOptions"],"sources":["../src/provider.tsx","../src/relayer/use-encrypt.ts","../src/relayer/decryption-cache.ts","../src/relayer/use-user-decrypt.ts","../src/relayer/use-public-decrypt.ts","../src/relayer/use-generate-keypair.ts","../src/relayer/use-create-eip712.ts","../src/relayer/use-create-delegated-user-decrypt-eip712.ts","../src/relayer/use-delegated-user-decrypt.ts","../src/relayer/use-request-zk-proof-verification.ts","../src/utils/query.ts","../src/relayer/use-public-key.ts","../src/relayer/use-public-params.ts","../src/relayer/use-user-decrypt-flow.ts","../src/relayer/use-user-decrypted-value.ts","../src/relayer/use-user-decrypted-values.ts","../src/token/use-token.ts","../src/token/use-readonly-token.ts","../src/token/use-confidential-balance.ts","../src/token/use-confidential-balances.ts","../src/token/use-allow-tokens.ts","../src/token/use-is-allowed.ts","../src/token/use-revoke-tokens.ts","../src/token/use-revoke-session.ts","../src/token/optimistic-balance-update.ts","../src/token/use-confidential-transfer.ts","../src/token/use-confidential-transfer-from.ts","../src/token/use-confidential-approve.ts","../src/token/use-confidential-is-approved.ts","../src/token/use-shield.ts","../src/token/use-shield-eth.ts","../src/token/use-unwrap.ts","../src/token/use-unwrap-all.ts","../src/token/use-finalize-unwrap.ts","../src/token/use-unshield.ts","../src/token/use-unshield-all.ts","../src/token/use-resume-unshield.ts","../src/token/use-underlying-allowance.ts","../src/token/use-wrapper-discovery.ts","../src/token/use-metadata.ts","../src/token/use-activity-feed.ts","../src/token/use-delegate-decryption.ts","../src/token/use-revoke-delegation.ts","../src/token/use-delegation-status.ts","../src/token/use-decrypt-balance-as.ts","../src/token/use-batch-decrypt-balances-as.ts","../src/token/use-approve-underlying.ts","../src/token/use-is-confidential.ts","../src/token/use-total-supply.ts","../src/token/use-fees.ts"],"sourcesContent":["\"use client\";\n\nimport type {\n  Address,\n  GenericSigner,\n  GenericStorage,\n  RelayerSDK,\n  ZamaSDKEventListener,\n} from \"@zama-fhe/sdk\";\nimport { ZamaSDK } from \"@zama-fhe/sdk\";\nimport { invalidateWalletLifecycleQueries } from \"@zama-fhe/sdk/query\";\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport {\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n} from \"react\";\n\n/** Props for {@link ZamaProvider}. */\nexport interface ZamaProviderProps extends PropsWithChildren {\n  /** FHE relayer backend (RelayerWeb for browser, RelayerNode for server). */\n  relayer: RelayerSDK;\n  /** Wallet signer (`ViemSigner`, `EthersSigner`, or custom {@link GenericSigner}). */\n  signer: GenericSigner;\n  /** Credential storage backend (IndexedDBStorage for browser, MemoryStorage for tests). */\n  storage: GenericStorage;\n  /**\n   * Session storage for wallet signatures. Defaults to in-memory (lost on reload).\n   * Pass a `chrome.storage.session`-backed store for web extensions.\n   */\n  sessionStorage?: GenericStorage;\n  /**\n   * How long the ML-KEM re-encryption keypair remains valid, in seconds.\n   * Default: `86400` (1 day). Must be positive — `0` is rejected.\n   */\n  keypairTTL?: number;\n  /**\n   * Controls how long session signatures (EIP-712 wallet signatures) remain valid, in seconds.\n   * Default: `2592000` (30 days).\n   * - `0`: never persist — every operation triggers a signing prompt (high-security mode).\n   * - Positive number: seconds until the session signature expires and requires re-authentication.\n   */\n  sessionTTL?: number;\n  /** Callback invoked on SDK lifecycle events. */\n  onEvent?: ZamaSDKEventListener;\n}\n\nconst ZamaSDKContext = createContext<ZamaSDK | null>(null);\n\n/**\n * Provides a {@link ZamaSDK} instance to all descendant hooks.\n *\n * @example\n * ```tsx\n * <ZamaProvider relayer={relayer} signer={signer} storage={storage}>\n *   <App />\n * </ZamaProvider>\n * ```\n */\nexport function ZamaProvider({\n  children,\n  relayer,\n  signer,\n  storage,\n  sessionStorage,\n  keypairTTL,\n  sessionTTL,\n  onEvent,\n}: ZamaProviderProps) {\n  const queryClient = useQueryClient();\n\n  // Stabilize onEvent so an inline arrow doesn't recreate the SDK every render.\n  const onEventRef = useRef(onEvent);\n  useEffect(() => {\n    onEventRef.current = onEvent;\n  });\n\n  const signerLifecycleCallbacks = useMemo(\n    () =>\n      signer?.subscribe\n        ? {\n            onDisconnect: () => invalidateWalletLifecycleQueries(queryClient),\n            onAccountChange: () => invalidateWalletLifecycleQueries(queryClient),\n            onChainChange: () => invalidateWalletLifecycleQueries(queryClient),\n          }\n        : undefined,\n    [queryClient, signer],\n  );\n\n  const sdk = useMemo(\n    () =>\n      new ZamaSDK({\n        relayer,\n        signer,\n        storage,\n        sessionStorage,\n        keypairTTL,\n        sessionTTL,\n        onEvent: onEventRef.current,\n        signerLifecycleCallbacks,\n      }),\n    [relayer, signer, storage, sessionStorage, keypairTTL, sessionTTL, signerLifecycleCallbacks],\n  );\n\n  // Clean up signer subscriptions on unmount without terminating the\n  // caller-owned relayer. dispose() only unsubscribes from wallet events\n  // and is idempotent.\n  useEffect(() => () => sdk.dispose(), [sdk]);\n\n  return <ZamaSDKContext.Provider value={sdk}>{children}</ZamaSDKContext.Provider>;\n}\n\n/**\n * Access the {@link ZamaSDK} instance from context.\n * Throws if called outside a {@link ZamaProvider} or when no signer is provided.\n *\n * @example\n * ```tsx\n * const sdk = useZamaSDK();\n * const token = sdk.createReadonlyToken(\"0x...\");\n * ```\n */\nexport function useZamaSDK(): ZamaSDK {\n  const context = useContext(ZamaSDKContext);\n\n  if (!context) {\n    throw new Error(\n      \"useZamaSDK must be used within a <ZamaProvider>. \" +\n        \"Wrap your component tree in <ZamaProvider relayer={…} signer={…} storage={…}>.\",\n    );\n  }\n\n  return context;\n}\n","\"use client\";\n\nimport type { EncryptParams, EncryptResult } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { encryptMutationOptions } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Encrypt a plaintext value using FHE.\n * Calls the relayer's `encrypt` method via a mutation.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link EncryptionFailedError} — FHE encryption failed\n *\n * @returns A mutation whose `mutate` accepts {@link EncryptParams}.\n *\n * @example\n * ```tsx\n * const encrypt = useEncrypt();\n * encrypt.mutate({ values: [1000n], bits: [64] });\n * ```\n */\nexport function useEncrypt() {\n  const sdk = useZamaSDK();\n  return useMutation<EncryptResult, Error, EncryptParams>(encryptMutationOptions(sdk));\n}\n","import { zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { type Address } from \"@zama-fhe/sdk\";\nimport { type Handle } from \"@zama-fhe/sdk\";\n\n/**\n * Query key helpers for the shared decryption cache.\n * Used by useUserDecrypt/usePublicDecrypt to populate,\n * and by useUserDecryptedValue to read.\n */\nexport const decryptionKeys = {\n  value: (handle: Handle, contractAddress?: Address) =>\n    zamaQueryKeys.decryption.handle(handle, contractAddress),\n};\n","\"use client\";\n\nimport { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { ClearValueType, Handle, UserDecryptParams } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Thin wrapper around sdk.userDecrypt().\n * Caller is responsible for providing all params (keypair, signature, etc.).\n * For the full orchestration (signature management, EIP712 signing),\n * see the app-level useUserDecryptFlow hook.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link DecryptionFailedError} — relayer decryption request failed\n * - {@link InvalidKeypairError} — the provided keypair is invalid\n * - {@link KeypairExpiredError} — the re-encryption keypair has expired\n *\n * On success, populates the decryption cache so useUserDecryptedValue/useUserDecryptedValues\n * can read the results.\n */\nexport function useUserDecrypt() {\n  const sdk = useZamaSDK();\n  const queryClient = useQueryClient();\n\n  return useMutation<Record<Handle, ClearValueType>, Error, UserDecryptParams>({\n    mutationFn: (params) => sdk.relayer.userDecrypt(params),\n    onSuccess: (data) => {\n      for (const [handle, value] of Object.entries(data) as [Handle, ClearValueType][]) {\n        queryClient.setQueryData(decryptionKeys.value(handle), value);\n      }\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { ClearValueType, Handle, PublicDecryptResult } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Decrypt FHE ciphertext handles using the network public key (no credential needed).\n * On success, populates the decryption cache so {@link useUserDecryptedValue} / {@link useUserDecryptedValues}\n * can read the results.\n *\n * @returns A mutation whose `mutate` accepts an array of handle strings.\n *\n * @example\n * ```tsx\n * const publicDecrypt = usePublicDecrypt();\n * publicDecrypt.mutate([\"0xHandle1\", \"0xHandle2\"]);\n * // publicDecrypt.data?.clearValues => { \"0xHandle1\": 500n, ... }\n * ```\n */\nexport function usePublicDecrypt() {\n  const sdk = useZamaSDK();\n  const queryClient = useQueryClient();\n  return useMutation<PublicDecryptResult, Error, Handle[]>({\n    mutationFn: (handles) => sdk.relayer.publicDecrypt(handles),\n    onSuccess: (data) => {\n      for (const [handle, value] of Object.entries(data.clearValues) as [\n        Handle,\n        ClearValueType,\n      ][]) {\n        queryClient.setQueryData(decryptionKeys.value(handle), value);\n      }\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Generate an FHE keypair via the relayer.\n * Returns a public/private key pair for use in decrypt authorization.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link RelayerRequestFailedError} — relayer keypair generation request failed\n *\n * @returns A mutation whose `mutate` takes no parameters.\n *\n * @example\n * ```tsx\n * const generateKeypair = useGenerateKeypair();\n * generateKeypair.mutate();\n * // generateKeypair.data?.publicKey, generateKeypair.data?.privateKey\n * ```\n */\nexport function useGenerateKeypair() {\n  const sdk = useZamaSDK();\n  return useMutation({\n    mutationFn: () => sdk.relayer.generateKeypair(),\n  });\n}\n","\"use client\";\n\nimport type { EIP712TypedData } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\nimport { type Address } from \"@zama-fhe/sdk\";\n\n/** Parameters for {@link useCreateEIP712}. */\nexport interface CreateEIP712Params {\n  /** The FHE public key (hex-encoded). */\n  publicKey: `0x${string}`;\n  /** Contract addresses the credential authorizes decryption for. */\n  contractAddresses: Address[];\n  /** Unix timestamp (seconds) when the credential becomes valid. */\n  startTimestamp: number;\n  /** Number of days the credential remains valid. Default: 1. */\n  durationDays?: number;\n}\n\n/**\n * Create EIP-712 typed data for signing an FHE decrypt credential.\n * The returned typed data is signed by the wallet to authorize decryption.\n *\n * @returns A mutation whose `mutate` accepts {@link CreateEIP712Params}.\n *\n * @example\n * ```tsx\n * const createEIP712 = useCreateEIP712();\n * createEIP712.mutate({\n *   publicKey: keypair.publicKey,\n *   contractAddresses: [\"0xToken\"],\n *   startTimestamp: Math.floor(Date.now() / 1000),\n * });\n * ```\n */\nexport function useCreateEIP712() {\n  const sdk = useZamaSDK();\n  return useMutation<EIP712TypedData, Error, CreateEIP712Params>({\n    mutationFn: ({ publicKey, contractAddresses, startTimestamp, durationDays }) =>\n      sdk.relayer.createEIP712(publicKey, contractAddresses, startTimestamp, durationDays),\n  });\n}\n","\"use client\";\n\nimport type { Address, KmsDelegatedUserDecryptEIP712Type } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/** Parameters for {@link useCreateDelegatedUserDecryptEIP712}. */\nexport interface CreateDelegatedUserDecryptEIP712Params {\n  /** The FHE public key (hex-encoded). */\n  publicKey: `0x${string}`;\n  /** Contract addresses the credential authorizes decryption for. */\n  contractAddresses: Address[];\n  /** Address of the wallet that delegated decrypt authority. */\n  delegatorAddress: Address;\n  /** Unix timestamp (seconds) when the credential becomes valid. */\n  startTimestamp: number;\n  /** Number of days the credential remains valid. Default: 1. */\n  durationDays?: number;\n}\n\n/**\n * Create EIP-712 typed data for a delegated user decrypt credential.\n * Used when one wallet authorizes another to decrypt on its behalf.\n *\n * @returns A mutation whose `mutate` accepts {@link CreateDelegatedUserDecryptEIP712Params}.\n *\n * @example\n * ```tsx\n * const createEIP712 = useCreateDelegatedUserDecryptEIP712();\n * createEIP712.mutate({\n *   publicKey: keypair.publicKey,\n *   contractAddresses: [\"0xToken\"],\n *   delegatorAddress: \"0xDelegator\",\n *   startTimestamp: Math.floor(Date.now() / 1000),\n * });\n * ```\n */\nexport function useCreateDelegatedUserDecryptEIP712() {\n  const sdk = useZamaSDK();\n  return useMutation<\n    KmsDelegatedUserDecryptEIP712Type,\n    Error,\n    CreateDelegatedUserDecryptEIP712Params\n  >({\n    mutationFn: ({\n      publicKey,\n      contractAddresses,\n      delegatorAddress,\n      startTimestamp,\n      durationDays,\n    }) =>\n      sdk.relayer.createDelegatedUserDecryptEIP712(\n        publicKey,\n        contractAddresses,\n        delegatorAddress,\n        startTimestamp,\n        durationDays,\n      ),\n  });\n}\n","\"use client\";\n\nimport type { DelegatedUserDecryptParams, ClearValueType, Handle } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Decrypt FHE ciphertext handles using delegated user credentials.\n * Returns a map of handle → plaintext bigint.\n *\n * @returns A mutation whose `mutate` accepts {@link DelegatedUserDecryptParams}.\n *\n * @example\n * ```tsx\n * const decrypt = useDelegatedUserDecrypt();\n * decrypt.mutate({ handles: [\"0xHandle1\"], ...credentials });\n * // decrypt.data => { \"0xHandle1\": 1000n }\n * ```\n */\nexport function useDelegatedUserDecrypt() {\n  const sdk = useZamaSDK();\n  return useMutation<Record<Handle, ClearValueType>, Error, DelegatedUserDecryptParams>({\n    mutationFn: (params) => sdk.relayer.delegatedUserDecrypt(params),\n  });\n}\n","\"use client\";\n\nimport type { InputProofBytesType, ZKProofLike } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Submit a ZK proof for on-chain verification.\n * Returns the input proof bytes for use in contract calls.\n *\n * @returns A mutation whose `mutate` accepts a {@link ZKProofLike}.\n *\n * @example\n * ```tsx\n * const verify = useRequestZKProofVerification();\n * verify.mutate(zkProof);\n * // verify.data => Uint8Array (input proof bytes)\n * ```\n */\nexport function useRequestZKProofVerification() {\n  const sdk = useZamaSDK();\n  return useMutation<InputProofBytesType, Error, ZKProofLike>({\n    mutationFn: (zkProof) => sdk.relayer.requestZKProofVerification(zkProof),\n  });\n}\n","import {\n  type DefaultError,\n  useQuery as tanstack_useQuery,\n  useSuspenseQuery as tanstack_useSuspenseQuery,\n  type UseQueryResult,\n  type UseSuspenseQueryResult,\n} from \"@tanstack/react-query\";\nimport { hashFn } from \"@zama-fhe/sdk/query\";\n\n/**\n * Thin wrapper around TanStack's useQuery that injects our custom queryKeyHashFn.\n * Mirrors the wagmi pattern — the type safety boundary is at the factory and hook levels.\n *\n * The `options` parameter is typed as `any` because TanStack Query v5 has:\n * 1. Discriminated overloads around `initialData` (Defined vs Undefined)\n * 2. Function-typed fields (`staleTime`, `enabled`, `gcTime`) that are generic over `TQueryKey`\n *\n * Our factories produce options with specific tuple keys (e.g. `readonly [\"zama.totalSupply\", {...}]`)\n * whose function-typed fields are contravariant with `QueryKey` (`readonly unknown[]`).\n * Typing the parameter as `UseQueryOptions<TData, TError, TData, any>` still fails because\n * the query-key variance leaks through `staleTime`, `enabled`, etc.\n *\n * Hooks must pass explicit generics: `useQuery<DataType>({...})`.\n */\nexport function useQuery<TData = unknown, TError = DefaultError>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options: any,\n): UseQueryResult<TData, TError> {\n  return tanstack_useQuery({\n    ...options,\n    queryKeyHashFn: hashFn,\n  }) as UseQueryResult<TData, TError>;\n}\n\nexport function useSuspenseQuery<TData = unknown, TError = DefaultError>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options: any,\n): UseSuspenseQueryResult<TData, TError> {\n  return tanstack_useSuspenseQuery({\n    ...options,\n    queryKeyHashFn: hashFn,\n  }) as UseSuspenseQueryResult<TData, TError>;\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { publicKeyQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\nexport { publicKeyQueryOptions };\n\n/** Shape of the FHE public key data returned by the relayer. */\nexport interface PublicKeyData {\n  /** Unique identifier for this public key version. */\n  publicKeyId: string;\n  /** The raw FHE public key bytes. */\n  publicKey: Uint8Array;\n}\n\n/**\n * Fetch the FHE network public key from the relayer.\n * Cached indefinitely since the key does not change during a session.\n *\n * @returns Query result with `data: PublicKeyData | null`.\n *\n * @example\n * ```tsx\n * const { data: publicKey } = usePublicKey();\n * // publicKey?.publicKeyId, publicKey?.publicKey\n * ```\n */\nexport function usePublicKey() {\n  const sdk = useZamaSDK();\n  return useQuery<PublicKeyData | null>({\n    ...publicKeyQueryOptions(sdk),\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { publicParamsQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\nexport { publicParamsQueryOptions };\n\n/** Shape of the FHE public parameters returned by the relayer. */\nexport interface PublicParamsData {\n  /** The raw public parameters bytes (WASM-ready). */\n  publicParams: Uint8Array;\n  /** Unique identifier for this public params version. */\n  publicParamsId: string;\n}\n\n/**\n * Fetch FHE public parameters for a given bit size from the relayer.\n * Cached indefinitely since parameters do not change during a session.\n *\n * @param bits - The FHE bit size to fetch parameters for (e.g. 2048).\n * @returns Query result with `data: PublicParamsData | null`.\n *\n * @example\n * ```tsx\n * const { data: params } = usePublicParams(2048);\n * // params?.publicParams, params?.publicParamsId\n * ```\n */\nexport function usePublicParams(bits: number) {\n  const sdk = useZamaSDK();\n  return useQuery<PublicParamsData | null>({\n    ...publicParamsQueryOptions(sdk, bits),\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { Address, ClearValueType, Handle, Hex } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\nimport { useZamaSDK } from \"../provider\";\n\n/** A handle to decrypt, paired with its originating contract address. */\nexport interface DecryptHandle {\n  handle: Handle;\n  contractAddress: Address;\n}\n\n/** Parameters for {@link useUserDecryptFlow}. */\nexport interface UserDecryptFlowParams {\n  /** Encrypted handles to decrypt. */\n  handles: DecryptHandle[];\n  /** Number of days the credential remains valid. Default: 1. */\n  durationDays?: number;\n}\n\n/** Progress callbacks for each step of the decrypt flow. */\nexport interface UserDecryptFlowCallbacks {\n  /** Fired after the keypair is generated. */\n  onKeypairGenerated?: () => void;\n  /** Fired after the EIP-712 typed data is created, before wallet signing. */\n  onEIP712Created?: () => void;\n  /** Fired after the wallet signature is obtained. */\n  onSigned?: (signature: Hex) => void;\n  /** Fired after decryption completes. */\n  onDecrypted?: (values: Record<Handle, ClearValueType>) => void;\n}\n\n/** Configuration for {@link useUserDecryptFlow}. */\nexport interface UseUserDecryptFlowConfig {\n  /** Optional progress callbacks. */\n  callbacks?: UserDecryptFlowCallbacks;\n}\n\n/**\n * High-level orchestration hook for user decryption.\n * Handles the full flow: keypair generation → EIP-712 creation → wallet signature → decryption.\n *\n * On success, populates the decryption cache so `useUserDecryptedValue` / `useUserDecryptedValues`\n * can read the results.\n *\n * @param config - Optional callbacks for step-by-step UX feedback.\n * @returns A mutation whose `mutate` accepts {@link UserDecryptFlowParams}.\n *\n * @example\n * ```tsx\n * const decryptFlow = useUserDecryptFlow({\n *   callbacks: { onSigned: () => setStep(\"decrypting\") },\n * });\n * decryptFlow.mutate({\n *   handles: [{ handle: \"0xHandle\", contractAddress: \"0xContract\" }],\n *   durationDays: 7,\n * });\n * ```\n */\nexport function useUserDecryptFlow(config?: UseUserDecryptFlowConfig) {\n  const sdk = useZamaSDK();\n  const queryClient = useQueryClient();\n  const callbacks = config?.callbacks;\n\n  return useMutation<Record<Handle, ClearValueType>, Error, UserDecryptFlowParams>({\n    mutationKey: [\"userDecryptFlow\"],\n    mutationFn: async ({ handles, durationDays = 1 }) => {\n      // Step 1: Generate keypair\n      const keypair = await sdk.relayer.generateKeypair();\n      callbacks?.onKeypairGenerated?.();\n\n      // Step 2: Create EIP-712 typed data\n      const contractAddresses = [...new Set(handles.map((h) => h.contractAddress))];\n      const startTimestamp = Math.floor(Date.now() / 1000);\n      const eip712 = await sdk.relayer.createEIP712(\n        keypair.publicKey,\n        contractAddresses,\n        startTimestamp,\n        durationDays,\n      );\n      callbacks?.onEIP712Created?.();\n\n      // Step 3: Sign with wallet\n      const signature = await sdk.signer.signTypedData(eip712);\n      callbacks?.onSigned?.(signature);\n\n      // Step 4: Decrypt — group handles by contract address\n      const signerAddress = await sdk.signer.getAddress();\n      const allResults: Partial<Record<Handle, ClearValueType>> = {};\n\n      // Decrypt per contract address (the relayer requires handles from the same contract)\n      const handlesByContract = new Map<Address, Handle[]>();\n      for (const h of handles) {\n        const list = handlesByContract.get(h.contractAddress) ?? [];\n        list.push(h.handle);\n        handlesByContract.set(h.contractAddress, list);\n      }\n\n      for (const [contractAddress, contractHandles] of handlesByContract) {\n        const result = await sdk.relayer.userDecrypt({\n          handles: contractHandles,\n          contractAddress,\n          signedContractAddresses: contractAddresses,\n          privateKey: keypair.privateKey,\n          publicKey: keypair.publicKey,\n          signature,\n          signerAddress,\n          startTimestamp,\n          durationDays,\n        });\n        Object.assign(allResults, result);\n      }\n\n      const results = allResults as Record<Handle, ClearValueType>;\n      callbacks?.onDecrypted?.(results);\n      return results;\n    },\n    onSuccess: (data) => {\n      // Populate the shared decryption cache\n      for (const [handle, value] of Object.entries(data) as [Handle, ClearValueType][]) {\n        queryClient.setQueryData(decryptionKeys.value(handle), value);\n      }\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport type { ClearValueType, Handle } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\n\n/**\n * Look up a single cached decrypted value by its handle.\n * Values are populated automatically when useUserDecrypt or usePublicDecrypt succeed.\n * You can also populate manually via queryClient.setQueryData(decryptionKeys.value(handle), value).\n */\nexport function useUserDecryptedValue(handle: Handle | undefined) {\n  return useQuery<ClearValueType>({\n    queryKey: decryptionKeys.value(handle ?? \"0x\"),\n    queryFn: () => undefined as never,\n    enabled: false,\n  });\n}\n","\"use client\";\n\nimport { useQueries } from \"@tanstack/react-query\";\nimport type { ClearValueType, Handle } from \"@zama-fhe/sdk\";\nimport { hashFn } from \"@zama-fhe/sdk/query\";\nimport { decryptionKeys } from \"./decryption-cache\";\n\n/**\n * Look up multiple cached decrypted values by their handles.\n * Values are populated automatically when useUserDecrypt or usePublicDecrypt succeed.\n */\nexport function useUserDecryptedValues(handles: Handle[]) {\n  const results = useQueries({\n    queries: handles.map((handle) => ({\n      queryKey: decryptionKeys.value(handle),\n      queryKeyHashFn: hashFn,\n      queryFn: () => undefined as never,\n      enabled: false,\n    })),\n  });\n\n  const data: Partial<Record<Handle, ClearValueType | undefined>> = {};\n  for (let i = 0; i < handles.length; i++) {\n    data[handles[i]!] = results[i]!.data as ClearValueType | undefined;\n  }\n\n  return {\n    data,\n    results,\n  };\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { useZamaSDK } from \"../provider\";\n\n/** Base configuration shared by all mutation hooks that need a Token instance. */\nexport interface UseZamaConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** Address of the wrapper contract (required for shield/unshield operations). */\n  wrapperAddress?: Address;\n}\n\n/**\n * Get a {@link Token} instance, memoized by address pair.\n * Reads signer and storage from the nearest {@link ZamaProvider}.\n *\n * @param config - Token and optional wrapper addresses.\n * @returns A memoized `Token` instance.\n *\n * @example\n * ```tsx\n * const token = useToken({ tokenAddress: \"0xToken\", wrapperAddress: \"0xWrapper\" });\n * ```\n */\nexport function useToken(config: UseZamaConfig) {\n  const sdk = useZamaSDK();\n\n  return useMemo(\n    () => sdk.createToken(config.tokenAddress, config.wrapperAddress),\n    [sdk, config.tokenAddress, config.wrapperAddress],\n  );\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Get a {@link ReadonlyToken} instance, memoized by address.\n * Supports balance queries, ERC-165 checks, and authorization — no wrapper needed.\n * Reads signer and storage from the nearest {@link ZamaProvider}.\n *\n * @param address - Address of the confidential token contract.\n * @returns A memoized `ReadonlyToken` instance.\n *\n * @example\n * ```tsx\n * const token = useReadonlyToken(\"0xToken\");\n * // token.balanceOf(), token.isConfidential(), etc.\n * ```\n */\nexport function useReadonlyToken(address: Address) {\n  const sdk = useZamaSDK();\n\n  return useMemo(() => sdk.createReadonlyToken(address), [sdk, address]);\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address, Handle } from \"@zama-fhe/sdk\";\nimport {\n  confidentialBalanceQueryOptions,\n  confidentialHandleQueryOptions,\n  signerAddressQueryOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\n/** Configuration for {@link useConfidentialBalance}. */\nexport interface UseConfidentialBalanceConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** Polling interval (ms) for the encrypted handle. Default: 10 000. */\n  handleRefetchInterval?: number;\n}\n\n/** Query options for the decrypt phase of {@link useConfidentialBalance}. */\nexport type UseConfidentialBalanceOptions = Omit<\n  UseQueryOptions<bigint, Error>,\n  \"queryKey\" | \"queryFn\"\n>;\n\n/**\n * Declarative hook to read the connected wallet's confidential token balance.\n * Uses two-phase polling: cheaply polls the encrypted handle, then only\n * decrypts when the handle changes (new balance).\n *\n * @param config - Token address and optional polling interval.\n * @param options - React Query options forwarded to the decrypt query.\n * @returns The decrypt query result plus `handleQuery` for Phase 1 state.\n *\n * @example\n * ```tsx\n * const { data: balance, isLoading, handleQuery } = useConfidentialBalance({\n *   tokenAddress: \"0x...\",\n * });\n * ```\n */\nexport function useConfidentialBalance(\n  config: UseConfidentialBalanceConfig,\n  options?: UseConfidentialBalanceOptions,\n) {\n  const { tokenAddress, handleRefetchInterval } = config;\n  const userEnabled = options?.enabled;\n  const token = useReadonlyToken(tokenAddress);\n\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n\n  const owner = addressQuery.data;\n\n  // Phase 1: Poll the encrypted handle (cheap RPC read, no signing)\n  const baseHandleQueryOptions = confidentialHandleQueryOptions(token.signer, tokenAddress, {\n    owner,\n    pollingInterval: handleRefetchInterval,\n  });\n  const handleQuery = useQuery<Handle>({\n    ...baseHandleQueryOptions,\n    enabled: (baseHandleQueryOptions.enabled ?? true) && (userEnabled ?? true),\n  });\n\n  // Phase 2: Decrypt only when handle changes (expensive relayer roundtrip)\n  const handle = handleQuery.data;\n  const baseBalanceQueryOptions = confidentialBalanceQueryOptions(token, {\n    handle,\n    owner,\n  });\n  const balanceQuery = useQuery<bigint>({\n    ...baseBalanceQueryOptions,\n    ...options,\n    enabled: (baseBalanceQueryOptions.enabled ?? true) && (userEnabled ?? true),\n  });\n\n  return { ...balanceQuery, handleQuery };\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport { useQuery } from \"../utils/query\";\nimport { type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address, Handle } from \"@zama-fhe/sdk\";\nimport {\n  confidentialBalancesQueryOptions,\n  confidentialHandlesQueryOptions,\n  signerAddressQueryOptions,\n  type ConfidentialBalancesData,\n} from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/** Configuration for {@link useConfidentialBalances}. */\nexport interface UseConfidentialBalancesConfig {\n  /** Addresses of the confidential token contracts to batch-query. */\n  tokenAddresses: Address[];\n  /** Polling interval (ms) for the encrypted handles. Default: 10 000. */\n  handleRefetchInterval?: number;\n  /** Maximum number of concurrent decrypt calls. Default: `Infinity` (no limit). */\n  maxConcurrency?: number;\n}\n\nexport type { ConfidentialBalancesData };\n\n/** Query options for the decrypt phase of {@link useConfidentialBalances}. */\nexport type UseConfidentialBalancesOptions = Omit<\n  UseQueryOptions<ConfidentialBalancesData, Error>,\n  \"queryKey\" | \"queryFn\"\n>;\n\n/**\n * Declarative hook to read multiple confidential token balances in batch.\n * Uses two-phase polling: cheaply polls encrypted handles, then only\n * decrypts when any handle changes.\n *\n * Returns partial results when some tokens fail — successful balances are\n * always returned alongside per-token error information.\n *\n * @param config - Token addresses and optional polling interval.\n * @param options - React Query options forwarded to the decrypt query.\n * @returns The decrypt query result plus `handlesQuery` for Phase 1 state.\n *\n * @example\n * ```tsx\n * const { data } = useConfidentialBalances({\n *   tokenAddresses: [\"0xTokenA\", \"0xTokenB\"],\n * });\n * const balance = data?.balances.get(\"0xTokenA\");\n * if (data?.isPartialError) {\n *   // some tokens failed — check data.errors\n * }\n * ```\n */\nexport function useConfidentialBalances(\n  config: UseConfidentialBalancesConfig,\n  options?: UseConfidentialBalancesOptions,\n) {\n  const { tokenAddresses, handleRefetchInterval, maxConcurrency } = config;\n  const userEnabled = options?.enabled;\n  const sdk = useZamaSDK();\n\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(sdk.signer),\n  });\n\n  const owner = addressQuery.data;\n\n  const tokens = useMemo(\n    () => tokenAddresses.map((addr) => sdk.createReadonlyToken(addr)),\n    [sdk, tokenAddresses],\n  );\n\n  // Phase 1: Poll all encrypted handles (cheap RPC reads)\n  const baseHandlesQueryOptions = confidentialHandlesQueryOptions(sdk.signer, tokenAddresses, {\n    owner,\n    pollingInterval: handleRefetchInterval,\n  });\n  const handlesQuery = useQuery<Handle[]>({\n    ...baseHandlesQueryOptions,\n    enabled: (baseHandlesQueryOptions.enabled ?? true) && (userEnabled ?? true),\n  });\n\n  // Phase 2: Batch decrypt only when any handle changes\n  const handles = handlesQuery.data;\n  const handlesReady = Array.isArray(handles) && handles.length === tokenAddresses.length;\n  const baseBalancesQueryOptions = confidentialBalancesQueryOptions(tokens, {\n    owner,\n    handles,\n    maxConcurrency,\n    resultAddresses: tokenAddresses,\n  });\n  const factoryEnabled = baseBalancesQueryOptions.enabled ?? true;\n\n  const balancesQuery = useQuery<ConfidentialBalancesData>({\n    ...baseBalancesQueryOptions,\n    ...options,\n    enabled: factoryEnabled && handlesReady && (userEnabled ?? true),\n  });\n\n  return { ...balancesQuery, handlesQuery };\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { allowMutationOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Pre-authorize FHE decrypt credentials for a list of token addresses.\n * A single wallet signature covers all addresses, so subsequent decrypt\n * operations on any of these tokens reuse cached credentials.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link KeypairExpiredError} — the re-encryption keypair has expired\n *\n * @example\n * ```tsx\n * const { mutateAsync: allowTokens, isPending } = useAllowTokens();\n * // Call allowTokens(allTokenAddresses) before any individual reveal\n * ```\n */\nexport function useAllowTokens(options?: UseMutationOptions<void, Error, Address[]>) {\n  const sdk = useZamaSDK();\n\n  return useMutation<void, Error, Address[]>({\n    ...allowMutationOptions(sdk),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      context.client.invalidateQueries({ queryKey: zamaQueryKeys.isAllowed.all });\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { skipToken } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  isAllowedQueryOptions,\n  signerAddressQueryOptions,\n  zamaQueryKeys,\n} from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Check whether a session signature is cached for the connected wallet.\n * Returns `true` if decrypt operations can proceed without a wallet prompt.\n *\n * @example\n * ```tsx\n * const { data: allowed } = useIsAllowed();\n * ```\n */\nexport function useIsAllowed() {\n  const sdk = useZamaSDK();\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(sdk.signer),\n  });\n  const account = addressQuery.data;\n  const baseOpts = account\n    ? isAllowedQueryOptions(sdk, { account })\n    : {\n        queryKey: zamaQueryKeys.isAllowed.all,\n        queryFn: skipToken,\n      };\n  const factoryEnabled = \"enabled\" in baseOpts ? (baseOpts.enabled ?? true) : true;\n\n  return useQuery({\n    ...baseOpts,\n    enabled: factoryEnabled,\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { revokeMutationOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Revoke stored FHE credentials for a list of token addresses.\n * The next decrypt operation will require a fresh wallet signature.\n *\n * @example\n * ```tsx\n * const { mutate: revokeTokens } = useRevokeTokens();\n * revokeTokens([\"0xTokenA\", \"0xTokenB\"]);\n * ```\n */\nexport function useRevokeTokens(options?: UseMutationOptions<void, Error, Address[]>) {\n  const sdk = useZamaSDK();\n\n  return useMutation<void, Error, Address[]>({\n    ...revokeMutationOptions(sdk),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      context.client.invalidateQueries({ queryKey: zamaQueryKeys.isAllowed.all });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport { revokeSessionMutationOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Revoke the session signature for the connected wallet without\n * specifying contract addresses. Useful for wallet disconnect handlers.\n *\n * @example\n * ```tsx\n * const { mutate: revokeSession } = useRevokeSession();\n * revokeSession();\n * ```\n */\nexport function useRevokeSession(options?: UseMutationOptions<void, Error, void>) {\n  const sdk = useZamaSDK();\n\n  return useMutation<void, Error, void>({\n    ...revokeSessionMutationOptions(sdk),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      context.client.invalidateQueries({ queryKey: zamaQueryKeys.isAllowed.all });\n    },\n  });\n}\n","import type { QueryClient, QueryKey, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport { invalidateAfterShield, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\n\ntype BalanceDeltaMode = \"add\" | \"subtract\";\nexport type OptimisticBalanceSnapshot = Array<[QueryKey, bigint | undefined]>;\n\n/** Combined context returned by optimistic `onMutate`. */\nexport interface OptimisticMutateContext {\n  snapshot: OptimisticBalanceSnapshot;\n  callerContext?: unknown;\n}\n\nexport function unwrapOptimisticCallerContext(\n  optimistic: boolean | undefined,\n  rawContext: unknown,\n): {\n  wrappedContext: OptimisticMutateContext | undefined;\n  callerContext: OptimisticMutateContext | undefined;\n} {\n  const typed = rawContext as OptimisticMutateContext | undefined;\n  const wrappedContext = optimistic ? typed : undefined;\n  const callerContext = (optimistic ? wrappedContext?.callerContext : rawContext) as\n    | OptimisticMutateContext\n    | undefined;\n  return { wrappedContext, callerContext };\n}\n\nexport async function applyOptimisticBalanceDelta({\n  queryClient,\n  tokenAddress,\n  amount,\n  mode,\n}: {\n  queryClient: QueryClient;\n  tokenAddress: Address;\n  amount: bigint;\n  mode: BalanceDeltaMode;\n}): Promise<OptimisticBalanceSnapshot> {\n  const balanceKey = zamaQueryKeys.confidentialBalance.token(tokenAddress);\n  await queryClient.cancelQueries({ queryKey: balanceKey });\n  const previous = queryClient.getQueriesData<bigint>({ queryKey: balanceKey });\n  for (const [key, value] of previous) {\n    if (value === undefined) continue;\n    // Temporary optimistic underflow (`amount > value`) is acceptable because\n    // settlement invalidates and rewrites this cache entry.\n    queryClient.setQueryData(key, mode === \"add\" ? value + amount : value - amount);\n  }\n  return previous;\n}\n\nexport function rollbackOptimisticBalanceDelta(\n  queryClient: QueryClient,\n  snapshot: OptimisticBalanceSnapshot,\n) {\n  for (const [key, value] of snapshot) {\n    queryClient.setQueryData(key, value);\n  }\n}\n\n/**\n * Build optimistic mutation callbacks for shield operations.\n * Wraps the caller's `onMutate`/`onError`/`onSuccess`/`onSettled` with snapshot/rollback logic\n * and returns overrides ready to spread into `useMutation`.\n */\nexport function optimisticBalanceCallbacks<TParams extends { amount: bigint }>({\n  optimistic,\n  tokenAddress,\n  queryClient,\n  options,\n}: {\n  optimistic: boolean | undefined;\n  tokenAddress: Address;\n  queryClient: QueryClient;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options: UseMutationOptions<TransactionResult, Error, TParams, any> | undefined;\n}): Pick<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  UseMutationOptions<TransactionResult, Error, TParams, any>,\n  \"onMutate\" | \"onError\" | \"onSuccess\" | \"onSettled\"\n> {\n  return {\n    onMutate: optimistic\n      ? async (variables, mutationContext) => {\n          const snapshot = await applyOptimisticBalanceDelta({\n            queryClient,\n            tokenAddress,\n            amount: variables.amount,\n            mode: \"add\",\n          });\n          const callerContext = await options?.onMutate?.(variables, mutationContext);\n          return { snapshot, callerContext };\n        }\n      : options?.onMutate,\n    onError: (error, variables, rawContext, context) => {\n      const { wrappedContext, callerContext } = unwrapOptimisticCallerContext(\n        optimistic,\n        rawContext,\n      );\n      try {\n        if (wrappedContext) {\n          rollbackOptimisticBalanceDelta(queryClient, wrappedContext.snapshot);\n        }\n      } finally {\n        options?.onError?.(error, variables, callerContext, context);\n      }\n    },\n    onSuccess: (data, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(optimistic, rawContext);\n      options?.onSuccess?.(data, variables, callerContext, context);\n      invalidateAfterShield(context.client, tokenAddress);\n    },\n    onSettled: (data, error, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(optimistic, rawContext);\n      options?.onSettled?.(data, error, variables, callerContext, context);\n    },\n  };\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQueryClient,\n  UseMutationOptions,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  confidentialTransferMutationOptions,\n  invalidateAfterTransfer,\n  type ConfidentialTransferParams,\n} from \"@zama-fhe/sdk/query\";\nimport {\n  applyOptimisticBalanceDelta,\n  rollbackOptimisticBalanceDelta,\n  unwrapOptimisticCallerContext,\n} from \"./optimistic-balance-update\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/** Configuration for {@link useConfidentialTransfer}. */\nexport interface UseConfidentialTransferConfig extends UseZamaConfig {\n  /**\n   * When `true`, optimistically subtracts the transfer amount from cached balance\n   * before the transaction confirms. Rolls back on error.\n   * @defaultValue false\n   */\n  optimistic?: boolean;\n}\n\n/**\n * Encrypt and send a confidential transfer. Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption failed\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n *   Set `optimistic: true` to subtract the amount from the cached balance immediately.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const transfer = useConfidentialTransfer({\n *   tokenAddress: \"0x...\",\n *   optimistic: true,\n * });\n * transfer.mutate(\n *   { to: \"0xRecipient\", amount: 1000n },\n *   {\n *     onError: (error) => {\n *       if (error instanceof SigningRejectedError) {\n *         // user cancelled — no action needed\n *       }\n *     },\n *   },\n * );\n * ```\n */\nexport function useConfidentialTransfer<TContext = unknown>(\n  config: UseConfidentialTransferConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferParams, TContext>,\n): UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, TContext> {\n  const token = useToken(config);\n  const queryClient = useQueryClient();\n\n  // Internal mutation uses `any` for TContext because optimistic mode wraps\n  // the caller's context in OptimisticMutateContext; the public return type\n  // is cast back to the caller's TContext.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return useMutation<TransactionResult, Error, ConfidentialTransferParams, any>({\n    ...confidentialTransferMutationOptions(token),\n    ...options,\n    onMutate: config.optimistic\n      ? async (variables, mutationContext) => {\n          const snapshot = await applyOptimisticBalanceDelta({\n            queryClient,\n            tokenAddress: config.tokenAddress,\n            amount: variables.amount,\n            mode: \"subtract\",\n          });\n          const callerContext = await options?.onMutate?.(variables, mutationContext);\n          return { snapshot, callerContext };\n        }\n      : options?.onMutate,\n    onError: (error, variables, rawContext, context) => {\n      const { wrappedContext, callerContext } = unwrapOptimisticCallerContext(\n        config.optimistic,\n        rawContext,\n      );\n      try {\n        if (wrappedContext) {\n          rollbackOptimisticBalanceDelta(queryClient, wrappedContext.snapshot);\n        }\n      } finally {\n        options?.onError?.(error, variables, callerContext as TContext, context);\n      }\n    },\n    onSuccess: (data, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(config.optimistic, rawContext);\n      options?.onSuccess?.(data, variables, callerContext as TContext, context);\n      invalidateAfterTransfer(context.client, config.tokenAddress);\n    },\n    onSettled: (data, error, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(config.optimistic, rawContext);\n      options?.onSettled?.(data, error, variables, callerContext as TContext, context);\n    },\n  }) as UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, TContext>;\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  confidentialTransferFromMutationOptions,\n  invalidateAfterTransfer,\n  type ConfidentialTransferFromParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Operator transfer on behalf of another address. Caller must be an approved operator.\n * Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption of the transfer amount failed\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const transferFrom = useConfidentialTransferFrom({ tokenAddress: \"0x...\" });\n * transferFrom.mutate({ from: \"0xOwner\", to: \"0xRecipient\", amount: 500n });\n * ```\n */\nexport function useConfidentialTransferFrom(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferFromParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ConfidentialTransferFromParams, Address>({\n    ...confidentialTransferFromMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterTransfer(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  confidentialApproveMutationOptions,\n  invalidateAfterApprove,\n  type ConfidentialApproveParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Set operator approval for a confidential token. Defaults to 1 hour.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const approve = useConfidentialApprove({ tokenAddress: \"0x...\" });\n * approve.mutate({ spender: \"0xOperator\" });\n * ```\n */\nexport function useConfidentialApprove(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ConfidentialApproveParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ConfidentialApproveParams, Address>({\n    ...confidentialApproveMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterApprove(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { skipToken, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  confidentialIsApprovedQueryOptions,\n  signerAddressQueryOptions,\n  zamaQueryKeys,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\nexport { confidentialIsApprovedQueryOptions };\n\n/** Configuration for {@link useConfidentialIsApproved}. */\nexport interface UseConfidentialIsApprovedConfig extends UseZamaConfig {\n  /** Address to check approval for. Pass `undefined` to disable the query. */\n  spender: Address | undefined;\n  /** Token holder address. Defaults to the connected wallet. */\n  holder?: Address;\n}\n\n/** Configuration for {@link useConfidentialIsApprovedSuspense}. */\nexport interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {\n  /** Address to check approval for. */\n  spender: Address;\n  /** Token holder address. Defaults to the connected wallet. */\n  holder?: Address;\n}\n\n/**\n * Check if a spender is an approved operator for a given holder (defaults to connected wallet).\n *\n * @param config - Token address, spender, and optional holder to check.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isApproved } = useConfidentialIsApproved({\n *   tokenAddress: \"0xToken\",\n *   spender: \"0xSpender\",\n *   holder: \"0xHolder\", // optional\n * });\n * ```\n */\nexport function useConfidentialIsApproved(\n  config: UseConfidentialIsApprovedConfig,\n  options?: Omit<UseQueryOptions<boolean, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const { spender, holder, ...tokenConfig } = config;\n  const userEnabled = options?.enabled;\n  const token = useToken(tokenConfig);\n  const holderQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n    enabled: holder === undefined,\n  });\n  const resolvedHolder = holder ?? holderQuery.data;\n\n  const baseOpts =\n    spender && resolvedHolder\n      ? confidentialIsApprovedQueryOptions(token.signer, token.address, {\n          holder: resolvedHolder,\n          spender,\n        })\n      : {\n          queryKey: zamaQueryKeys.confidentialIsApproved.token(config.tokenAddress),\n          queryFn: skipToken,\n        };\n  return useQuery({\n    ...baseOpts,\n    ...options,\n    enabled: (\"enabled\" in baseOpts ? (baseOpts.enabled ?? true) : true) && (userEnabled ?? true),\n  });\n}\n\n/**\n * Suspense variant of {@link useConfidentialIsApproved}.\n * Suspends rendering until the approval check resolves.\n *\n * @param config - Token address, spender, and optional holder to check.\n * @returns Suspense query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isApproved } = useConfidentialIsApprovedSuspense({\n *   tokenAddress: \"0xToken\",\n *   spender: \"0xSpender\",\n *   holder: \"0xHolder\", // optional\n * });\n * ```\n */\nexport function useConfidentialIsApprovedSuspense(config: UseConfidentialIsApprovedSuspenseConfig) {\n  const { spender, holder, ...tokenConfig } = config;\n  const token = useToken(tokenConfig);\n  const addressQuery = useSuspenseQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n  const resolvedHolder = holder ?? addressQuery.data;\n\n  return useSuspenseQuery<boolean>({\n    ...confidentialIsApprovedQueryOptions(token.signer, token.address, {\n      holder: resolvedHolder,\n      spender,\n    }),\n  });\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQueryClient,\n  UseMutationOptions,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport { shieldMutationOptions, type ShieldParams } from \"@zama-fhe/sdk/query\";\nimport { optimisticBalanceCallbacks } from \"./optimistic-balance-update\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/** Configuration for {@link useShield}. */\nexport interface UseShieldConfig extends UseZamaConfig {\n  /**\n   * When `true`, optimistically adds the wrap amount to the cached confidential balance\n   * before the transaction confirms. Rolls back on error.\n   * @defaultValue false\n   */\n  optimistic?: boolean;\n}\n\n/**\n * Shield public ERC-20 tokens into confidential tokens.\n * Handles ERC-20 approval automatically. Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link ApprovalFailedError} — ERC-20 approval transaction failed\n * - {@link TransactionRevertedError} — shield transaction reverted\n *\n * @param config - Token and wrapper addresses.\n *   Set `optimistic: true` to add the amount to the cached balance immediately.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const shield = useShield({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\", optimistic: true });\n * shield.mutate({ amount: 1000n });\n * ```\n */\nexport function useShield<TContext = unknown>(\n  config: UseShieldConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ShieldParams, TContext>,\n): UseMutationResult<TransactionResult, Error, ShieldParams, TContext> {\n  const token = useToken(config);\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    ...shieldMutationOptions(token),\n    ...options,\n    ...optimisticBalanceCallbacks({\n      optimistic: config.optimistic,\n      tokenAddress: config.tokenAddress,\n      queryClient,\n      options,\n    }),\n  }) as UseMutationResult<TransactionResult, Error, ShieldParams, TContext>;\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQueryClient,\n  UseMutationOptions,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport { shieldETHMutationOptions, type ShieldETHParams } from \"@zama-fhe/sdk/query\";\nimport { optimisticBalanceCallbacks } from \"./optimistic-balance-update\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/** Configuration for {@link useShieldETH}. */\nexport interface UseShieldETHConfig extends UseZamaConfig {\n  /**\n   * When `true`, optimistically adds the wrap amount to the cached confidential balance\n   * before the transaction confirms. Rolls back on error.\n   * @defaultValue false\n   */\n  optimistic?: boolean;\n}\n\n/**\n * Shield native ETH into confidential tokens.\n * Handles wrapping automatically. Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — shield transaction reverted\n *\n * @param config - Token and wrapper addresses.\n *   Set `optimistic: true` to add the amount to the cached balance immediately.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const shieldETH = useShieldETH({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\", optimistic: true });\n * shieldETH.mutate({ amount: 1000000000000000000n }); // 1 ETH\n * ```\n */\nexport function useShieldETH<TContext = unknown>(\n  config: UseShieldETHConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ShieldETHParams, TContext>,\n): UseMutationResult<TransactionResult, Error, ShieldETHParams, TContext> {\n  const token = useToken(config);\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    ...shieldETHMutationOptions(token),\n    ...options,\n    ...optimisticBalanceCallbacks({\n      optimistic: config.optimistic,\n      tokenAddress: config.tokenAddress,\n      queryClient,\n      options,\n    }),\n  }) as UseMutationResult<TransactionResult, Error, ShieldETHParams, TContext>;\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnwrap,\n  type UnwrapParams,\n  unwrapMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Request an unwrap for a specific amount. Encrypts the amount first.\n * Call {@link useFinalizeUnwrap} after the request is processed on-chain,\n * or use {@link useUnshield} for a single-call orchestration.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption of the unwrap amount failed\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unwrap = useUnwrap({ tokenAddress: \"0x...\" });\n * unwrap.mutate({ amount: 500n });\n * ```\n */\nexport function useUnwrap(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, UnwrapParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, UnwrapParams, Address>({\n    ...unwrapMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnwrap(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport { invalidateAfterUnwrap, unwrapAllMutationOptions } from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Request an unwrap for the entire confidential balance.\n * Uses the on-chain balance handle directly (no encryption needed).\n * Call {@link useFinalizeUnwrap} after processing, or use {@link useUnshieldAll} for single-call orchestration.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unwrapAll = useUnwrapAll({ tokenAddress: \"0x...\" });\n * unwrapAll.mutate();\n * ```\n */\nexport function useUnwrapAll(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, void, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, void, Address>({\n    ...unwrapAllMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnwrap(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  finalizeUnwrapMutationOptions,\n  invalidateAfterUnshield,\n  type FinalizeUnwrapParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Complete an unwrap by providing the public decryption proof.\n * Call this after an unwrap request has been processed on-chain.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link DecryptionFailedError} — public decryption of the burn amount failed\n * - {@link TransactionRevertedError} — on-chain finalize transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const finalize = useFinalizeUnwrap({ tokenAddress: \"0x...\" });\n * finalize.mutate({ burnAmountHandle: event.encryptedAmount });\n * ```\n */\nexport function useFinalizeUnwrap(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, FinalizeUnwrapParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, FinalizeUnwrapParams, Address>({\n    ...finalizeUnwrapMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnshield,\n  type UnshieldParams,\n  unshieldMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Unshield a specific amount and finalize in one call.\n * Orchestrates: unwrap → wait for receipt → parse event → finalize.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption failed during unwrap\n * - {@link DecryptionFailedError} — public decryption failed during finalize\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unshield = useUnshield({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * unshield.mutate({ amount: 500n });\n * ```\n */\nexport function useUnshield(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, UnshieldParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, UnshieldParams, Address>({\n    ...unshieldMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnshield,\n  type UnshieldAllParams,\n  unshieldAllMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Unshield the entire balance and finalize in one call.\n * Orchestrates: unwrapAll → wait for receipt → parse event → finalize.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link DecryptionFailedError} — public decryption failed during finalize\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unshieldAll = useUnshieldAll({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * unshieldAll.mutate();\n * ```\n */\nexport function useUnshieldAll(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, UnshieldAllParams | void, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, UnshieldAllParams | void, Address>({\n    ...unshieldAllMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnshield,\n  type ResumeUnshieldParams,\n  resumeUnshieldMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Resume an interrupted unshield from an existing unwrap tx hash.\n * Useful when the user submitted the unwrap but the finalize step was\n * interrupted (e.g. page reload, network error).\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link DecryptionFailedError} — public decryption failed during finalize\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const resumeUnshield = useResumeUnshield({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * resumeUnshield.mutate({ unwrapTxHash: \"0xabc...\" });\n * ```\n */\nexport function useResumeUnshield(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ResumeUnshieldParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ResumeUnshieldParams, Address>({\n    ...resumeUnshieldMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { signerAddressQueryOptions, underlyingAllowanceQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { underlyingAllowanceQueryOptions };\n\n/** Configuration for {@link useUnderlyingAllowance}. */\nexport interface UseUnderlyingAllowanceConfig {\n  /** Address of the confidential token contract used to scope the query cache. */\n  tokenAddress: Address;\n  /** Address of the wrapper contract whose underlying ERC-20 allowance is checked. */\n  wrapperAddress: Address;\n}\n\n/**\n * Read the underlying ERC-20 allowance granted to the wrapper contract.\n * Useful to check if an approval is needed before shielding.\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (current allowance).\n *\n * @example\n * ```tsx\n * const { data: allowance } = useUnderlyingAllowance({\n *   tokenAddress: \"0xConfidentialToken\",\n *   wrapperAddress: \"0xWrapper\",\n * });\n * ```\n */\nexport function useUnderlyingAllowance(\n  config: UseUnderlyingAllowanceConfig,\n  options?: Omit<UseQueryOptions<bigint, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const { tokenAddress, wrapperAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n  const owner = addressQuery.data;\n\n  const baseOpts = underlyingAllowanceQueryOptions(token.signer, tokenAddress, {\n    owner,\n    wrapperAddress,\n  });\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Suspense variant of {@link useUnderlyingAllowance}.\n * Suspends rendering until the allowance is loaded.\n *\n * @param config - Token and wrapper addresses.\n * @returns Suspense query result with `data: bigint`.\n *\n * @example\n * ```tsx\n * const { data: allowance } = useUnderlyingAllowanceSuspense({\n *   tokenAddress: \"0xConfidentialToken\",\n *   wrapperAddress: \"0xWrapper\",\n * });\n * ```\n */\nexport function useUnderlyingAllowanceSuspense(config: UseUnderlyingAllowanceConfig) {\n  const { tokenAddress, wrapperAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n  const addressQuery = useSuspenseQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n  const owner = addressQuery.data;\n\n  return useSuspenseQuery<bigint>({\n    ...underlyingAllowanceQueryOptions(token.signer, tokenAddress, {\n      owner,\n      wrapperAddress,\n    }),\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { skipToken, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { wrapperDiscoveryQueryOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { wrapperDiscoveryQueryOptions };\n\n/** Configuration for {@link useWrapperDiscovery}. */\nexport interface UseWrapperDiscoveryConfig {\n  /** Address of the underlying ERC-20 token. */\n  tokenAddress: Address;\n  /** Address of the wrapper coordinator. Pass `undefined` to disable the query. */\n  coordinatorAddress: Address | undefined;\n}\n\n/** Configuration for {@link useWrapperDiscoverySuspense}. */\nexport interface UseWrapperDiscoverySuspenseConfig {\n  /** Address of the underlying ERC-20 token. */\n  tokenAddress: Address;\n  /** Address of the wrapper coordinator. */\n  coordinatorAddress: Address;\n}\n\n/**\n * Discover the wrapper contract for an ERC-20 token.\n * Returns the wrapper address if one exists, or `null` if not.\n * Cached indefinitely since wrapper mappings are immutable.\n *\n * @param config - Token and coordinator addresses.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: Address | null`.\n *\n * @example\n * ```tsx\n * const { data: wrapperAddress } = useWrapperDiscovery({\n *   tokenAddress: \"0xUnderlying\",\n *   coordinatorAddress: \"0xCoordinator\",\n * });\n * ```\n */\nexport function useWrapperDiscovery(\n  config: UseWrapperDiscoveryConfig,\n  options?: Omit<UseQueryOptions<Address | null, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const { tokenAddress, coordinatorAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<Address | null>({\n    ...(coordinatorAddress\n      ? wrapperDiscoveryQueryOptions(token.signer, tokenAddress, { coordinatorAddress })\n      : {\n          queryKey: zamaQueryKeys.wrapperDiscovery.all,\n          queryFn: skipToken,\n        }),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useWrapperDiscovery}.\n * Suspends rendering until the wrapper address is resolved.\n *\n * @param config - Token and coordinator addresses.\n * @returns Suspense query result with `data: Address | null`.\n *\n * @example\n * ```tsx\n * const { data: wrapperAddress } = useWrapperDiscoverySuspense({\n *   tokenAddress: \"0xUnderlying\",\n *   coordinatorAddress: \"0xCoordinator\",\n * });\n * ```\n */\nexport function useWrapperDiscoverySuspense(config: UseWrapperDiscoverySuspenseConfig) {\n  const { tokenAddress, coordinatorAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<Address | null>({\n    ...wrapperDiscoveryQueryOptions(token.signer, tokenAddress, { coordinatorAddress }),\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { tokenMetadataQueryOptions, type TokenMetadata } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { type TokenMetadata };\n\n/**\n * Read ERC-20 token metadata (name, symbol, decimals).\n * Fetches all three in parallel. Cached indefinitely since metadata is immutable.\n *\n * @param tokenAddress - Address of the token contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: TokenMetadata`.\n *\n * @example\n * ```tsx\n * const { data: metadata } = useMetadata(\"0xToken\");\n * // metadata?.name, metadata?.symbol, metadata?.decimals\n * ```\n */\nexport function useMetadata(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<TokenMetadata, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<TokenMetadata>({\n    ...tokenMetadataQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useMetadata}.\n * Suspends rendering until metadata is loaded.\n *\n * @param tokenAddress - Address of the token contract.\n * @returns Suspense query result with `data: TokenMetadata`.\n *\n * @example\n * ```tsx\n * const { data: metadata } = useMetadataSuspense(\"0xToken\");\n * ```\n */\nexport function useMetadataSuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<TokenMetadata>({\n    ...tokenMetadataQueryOptions(token.signer, tokenAddress),\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport type { Address, RawLog, ActivityLogMetadata, ActivityItem } from \"@zama-fhe/sdk\";\nimport { activityFeedQueryOptions, deriveActivityFeedLogsKey } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\n/** Configuration for {@link useActivityFeed}. */\nexport interface UseActivityFeedConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** Connected wallet address. Pass `undefined` to disable the query. */\n  userAddress: Address | undefined;\n  /** Raw event logs from the provider (viem, ethers, etc.). Pass `undefined` to disable. */\n  logs: readonly (RawLog & Partial<ActivityLogMetadata>)[] | undefined;\n  /** Whether to batch-decrypt encrypted transfer amounts. Default: `true`. */\n  decrypt?: boolean;\n}\n\n/**\n * Two-phase activity feed hook.\n * Phase 1: Instantly parses raw logs into classified {@link ActivityItem}s (sync, cheap).\n * Phase 2: Batch-decrypts encrypted transfer amounts via the relayer (async).\n *\n * The wallet provides logs (from its own provider — viem, ethers, etc.)\n * and this hook normalizes + decrypts them.\n *\n * @param config - Token address, user address, raw logs, and decrypt option.\n * @returns Query result with `data: ActivityItem[]`.\n *\n * @example\n * ```tsx\n * const { data: activity } = useActivityFeed({\n *   tokenAddress: \"0xToken\",\n *   userAddress: \"0xUser\",\n *   logs: rawLogs,\n * });\n * ```\n */\nexport function useActivityFeed(config: UseActivityFeedConfig) {\n  const { tokenAddress, userAddress, logs, decrypt: decryptOpt } = config;\n  const token = useReadonlyToken(tokenAddress);\n  const decrypt = decryptOpt ?? true;\n  const logsKey = deriveActivityFeedLogsKey(logs);\n\n  return useQuery<ActivityItem[]>({\n    ...activityFeedQueryOptions(token, {\n      userAddress,\n      logs,\n      decrypt,\n      logsKey,\n    }),\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  delegateDecryptionMutationOptions,\n  zamaQueryKeys,\n  type DelegateDecryptionParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Delegate FHE decryption rights for a token to another address via the on-chain ACL.\n *\n * @param config - Token address identifying the confidential token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const delegate = useDelegateDecryption({ tokenAddress: \"0x...\" });\n * delegate.mutate({ delegateAddress: \"0xDelegate\" });\n * ```\n */\nexport function useDelegateDecryption(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, DelegateDecryptionParams>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, DelegateDecryptionParams>({\n    ...delegateDecryptionMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      context.client.invalidateQueries({ queryKey: zamaQueryKeys.delegationStatus.all });\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  revokeDelegationMutationOptions,\n  zamaQueryKeys,\n  type RevokeDelegationParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Revoke FHE decryption delegation for a token from a delegate address.\n *\n * @param config - Token address identifying the confidential token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const revoke = useRevokeDelegation({ tokenAddress: \"0x...\" });\n * revoke.mutate({ delegateAddress: \"0xDelegate\" });\n * ```\n */\nexport function useRevokeDelegation(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, RevokeDelegationParams>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, RevokeDelegationParams>({\n    ...revokeDelegationMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      context.client.invalidateQueries({ queryKey: zamaQueryKeys.delegationStatus.all });\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n    },\n  });\n}\n","\"use client\";\n\nimport { skipToken, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  delegationStatusQueryOptions,\n  zamaQueryKeys,\n  type DelegationStatusData,\n} from \"@zama-fhe/sdk/query\";\nimport { useQuery } from \"../utils/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport interface UseDelegationStatusConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** The address that granted the delegation. */\n  delegatorAddress?: Address;\n  /** The address that received delegation rights. */\n  delegateAddress?: Address;\n}\n\n/**\n * Query delegation status between a delegator and delegate for a token.\n *\n * @param config - Token address, delegator, and delegate addresses.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns `{ isDelegated, expiryTimestamp, isLoading, error }`.\n *\n * @example\n * ```tsx\n * const { data } = useDelegationStatus({\n *   tokenAddress: \"0xToken\",\n *   delegatorAddress: \"0xDelegator\",\n *   delegateAddress: \"0xDelegate\",\n * });\n * // data?.isDelegated, data?.expiryTimestamp\n * ```\n */\nexport function useDelegationStatus(\n  config: UseDelegationStatusConfig,\n  options?: Omit<UseQueryOptions<DelegationStatusData, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const readonlyToken = useReadonlyToken(config.tokenAddress);\n\n  const enabled = Boolean(config.delegatorAddress && config.delegateAddress);\n  const baseOpts =\n    config.delegatorAddress && config.delegateAddress\n      ? delegationStatusQueryOptions(readonlyToken, {\n          delegatorAddress: config.delegatorAddress,\n          delegateAddress: config.delegateAddress,\n        })\n      : {\n          queryKey: zamaQueryKeys.delegationStatus.all,\n          queryFn: skipToken as unknown as () => Promise<DelegationStatusData>,\n        };\n\n  return useQuery<DelegationStatusData>({\n    ...baseOpts,\n    enabled,\n    ...options,\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { decryptBalanceAsMutationOptions, type DecryptBalanceAsParams } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\n/**\n * Decrypt another user's confidential balance as a delegate.\n *\n * @param tokenAddress - Address of the confidential token contract.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const decryptAs = useDecryptBalanceAs(\"0xToken\");\n * decryptAs.mutate({ delegatorAddress: \"0xDelegator\" });\n * // decryptAs.data => 1000n\n * ```\n */\nexport function useDecryptBalanceAs(\n  tokenAddress: Address,\n  options?: UseMutationOptions<bigint, Error, DecryptBalanceAsParams>,\n) {\n  const readonlyToken = useReadonlyToken(tokenAddress);\n\n  return useMutation<bigint, Error, DecryptBalanceAsParams>({\n    ...decryptBalanceAsMutationOptions(readonlyToken),\n    ...options,\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport { ReadonlyToken, type Address, type BatchDecryptAsOptions } from \"@zama-fhe/sdk\";\n\n/**\n * Batch decrypt confidential balances as a delegate across multiple tokens.\n *\n * @param tokens - ReadonlyToken instances to decrypt balances for.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const batchDecryptAs = useBatchDecryptBalancesAs(tokens);\n * batchDecryptAs.mutate({\n *   delegatorAddress: \"0xDelegator\",\n * });\n * // batchDecryptAs.data => Map { \"0xTokenA\" => 100n, \"0xTokenB\" => 200n }\n * ```\n */\nexport function useBatchDecryptBalancesAs(\n  tokens: ReadonlyToken[],\n  options?: UseMutationOptions<Map<Address, bigint>, Error, BatchDecryptAsOptions>,\n) {\n  return useMutation<Map<Address, bigint>, Error, BatchDecryptAsOptions>({\n    mutationKey: [\"zama.batchDecryptBalancesAs\", ...tokens.map((t) => t.address)] as const,\n    mutationFn: async (params) => ReadonlyToken.batchDecryptBalancesAs(tokens, params),\n    ...options,\n  });\n}\n","\"use client\";\n\nimport { useMutation, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  approveUnderlyingMutationOptions,\n  invalidateAfterApproveUnderlying,\n  type ApproveUnderlyingParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Approve the wrapper contract to spend the underlying ERC-20.\n * Defaults to max uint256. Resets to zero first if there's an existing\n * non-zero allowance (required by tokens like USDT).\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — approval transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const approve = useApproveUnderlying({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * approve.mutate({}); // max approval\n * approve.mutate({ amount: 1000n }); // exact amount\n * ```\n */\nexport function useApproveUnderlying(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ApproveUnderlyingParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ApproveUnderlyingParams, Address>({\n    ...approveUnderlyingMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterApproveUnderlying(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { isConfidentialQueryOptions, isWrapperQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { isConfidentialQueryOptions, isWrapperQueryOptions };\n\n/**\n * Check if a token supports the ERC-7984 confidential interface via ERC-165.\n * Result is cached indefinitely since interface support does not change.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isConfidential } = useIsConfidential(\"0xToken\");\n * ```\n */\nexport function useIsConfidential(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<boolean, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<boolean>({\n    ...isConfidentialQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useIsConfidential}.\n * Suspends rendering until the ERC-165 check resolves.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @returns Suspense query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isConfidential } = useIsConfidentialSuspense(\"0xToken\");\n * ```\n */\nexport function useIsConfidentialSuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<boolean>({\n    ...isConfidentialQueryOptions(token.signer, tokenAddress),\n  });\n}\n\n/**\n * Check if a token supports the ERC-7984 wrapper interface via ERC-165.\n * Result is cached indefinitely since interface support does not change.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isWrapper } = useIsWrapper(\"0xToken\");\n * ```\n */\nexport function useIsWrapper(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<boolean, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<boolean>({\n    ...isWrapperQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useIsWrapper}.\n * Suspends rendering until the ERC-165 check resolves.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @returns Suspense query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isWrapper } = useIsWrapperSuspense(\"0xToken\");\n * ```\n */\nexport function useIsWrapperSuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<boolean>({\n    ...isWrapperQueryOptions(token.signer, tokenAddress),\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { totalSupplyQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { totalSupplyQueryOptions };\n\n/**\n * Read the total supply of a token.\n * Stale after 30 seconds to balance freshness and RPC cost.\n *\n * @param tokenAddress - Address of the token contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint`.\n *\n * @example\n * ```tsx\n * const { data: totalSupply } = useTotalSupply(\"0xToken\");\n * ```\n */\nexport function useTotalSupply(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<bigint, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<bigint>({\n    ...totalSupplyQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useTotalSupply}.\n * Suspends rendering until the total supply is loaded.\n *\n * @param tokenAddress - Address of the token contract.\n * @returns Suspense query result with `data: bigint`.\n *\n * @example\n * ```tsx\n * const { data: totalSupply } = useTotalSupplySuspense(\"0xToken\");\n * ```\n */\nexport function useTotalSupplySuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<bigint>({\n    ...totalSupplyQueryOptions(token.signer, tokenAddress),\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  batchTransferFeeQueryOptions,\n  feeRecipientQueryOptions,\n  shieldFeeQueryOptions,\n  unshieldFeeQueryOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\nexport {\n  batchTransferFeeQueryOptions,\n  feeRecipientQueryOptions,\n  shieldFeeQueryOptions,\n  unshieldFeeQueryOptions,\n};\n\n/** Configuration for {@link useShieldFee} and {@link useUnshieldFee}. */\nexport interface UseFeeConfig {\n  /** Address of the fee manager contract. */\n  feeManagerAddress: Address;\n  /** Amount to calculate the fee for. */\n  amount: bigint;\n  /** Sender address. */\n  from: Address;\n  /** Receiver address. */\n  to: Address;\n}\n\n/**\n * Read the shield fee for a given amount and address pair.\n *\n * @param config - Fee manager address, amount, from, and to.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (the fee amount).\n *\n * @example\n * ```tsx\n * const { data: fee } = useShieldFee({\n *   feeManagerAddress: \"0xFeeManager\",\n *   amount: 1000n,\n *   from: \"0xSender\",\n *   to: \"0xReceiver\",\n * });\n * ```\n */\nexport function useShieldFee(\n  config: UseFeeConfig,\n  options?: Omit<UseQueryOptions<bigint, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = shieldFeeQueryOptions(sdk.signer, config);\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Read the unshield fee for a given amount and address pair.\n *\n * @param config - Fee manager address, amount, from, and to.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (the fee amount).\n *\n * @example\n * ```tsx\n * const { data: fee } = useUnshieldFee({\n *   feeManagerAddress: \"0xFeeManager\",\n *   amount: 1000n,\n *   from: \"0xSender\",\n *   to: \"0xReceiver\",\n * });\n * ```\n */\nexport function useUnshieldFee(\n  config: UseFeeConfig,\n  options?: Omit<UseQueryOptions<bigint, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = unshieldFeeQueryOptions(sdk.signer, config);\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Read the batch transfer fee from the fee manager.\n *\n * @param feeManagerAddress - Address of the fee manager contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (the fee amount).\n *\n * @example\n * ```tsx\n * const { data: fee } = useBatchTransferFee(\"0xFeeManager\");\n * ```\n */\nexport function useBatchTransferFee(\n  feeManagerAddress: Address,\n  options?: Omit<UseQueryOptions<bigint, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = batchTransferFeeQueryOptions(sdk.signer, feeManagerAddress);\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Read the fee recipient address from the fee manager.\n *\n * @param feeManagerAddress - Address of the fee manager contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: Address` (the fee recipient).\n *\n * @example\n * ```tsx\n * const { data: recipient } = useFeeRecipient(\"0xFeeManager\");\n * ```\n */\nexport function useFeeRecipient(\n  feeManagerAddress: Address,\n  options?: Omit<UseQueryOptions<Address, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = feeRecipientQueryOptions(sdk.signer, feeManagerAddress);\n\n  return useQuery<Address>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["ZamaSDK","encryptMutationOptions","zamaQueryKeys","useQuery","tanstack_useQuery","hashFn","useSuspenseQuery","tanstack_useSuspenseQuery","useQuery","publicKeyQueryOptions","useQuery","publicParamsQueryOptions","useQuery","hashFn","useQuery","signerAddressQueryOptions","confidentialHandleQueryOptions","confidentialBalanceQueryOptions","useQuery","signerAddressQueryOptions","confidentialHandlesQueryOptions","confidentialBalancesQueryOptions","allowMutationOptions","zamaQueryKeys","useQuery","signerAddressQueryOptions","isAllowedQueryOptions","zamaQueryKeys","revokeMutationOptions","zamaQueryKeys","revokeSessionMutationOptions","zamaQueryKeys","zamaQueryKeys","confidentialTransferMutationOptions","confidentialTransferFromMutationOptions","confidentialApproveMutationOptions","useQuery","signerAddressQueryOptions","confidentialIsApprovedQueryOptions","zamaQueryKeys","useSuspenseQuery","shieldMutationOptions","shieldETHMutationOptions","unwrapMutationOptions","unwrapAllMutationOptions","finalizeUnwrapMutationOptions","unshieldMutationOptions","unshieldAllMutationOptions","resumeUnshieldMutationOptions","useQuery","signerAddressQueryOptions","underlyingAllowanceQueryOptions","useSuspenseQuery","useQuery","wrapperDiscoveryQueryOptions","zamaQueryKeys","useSuspenseQuery","useQuery","tokenMetadataQueryOptions","useSuspenseQuery","useQuery","activityFeedQueryOptions","delegateDecryptionMutationOptions","zamaQueryKeys","revokeDelegationMutationOptions","zamaQueryKeys","useQuery","delegationStatusQueryOptions","zamaQueryKeys","decryptBalanceAsMutationOptions","ReadonlyToken","approveUnderlyingMutationOptions","useQuery","isConfidentialQueryOptions","useSuspenseQuery","isWrapperQueryOptions","useQuery","totalSupplyQueryOptions","useSuspenseQuery","shieldFeeQueryOptions","useQuery","unshieldFeeQueryOptions","batchTransferFeeQueryOptions","feeRecipientQueryOptions"],"sources":["../src/provider.tsx","../src/relayer/use-encrypt.ts","../src/relayer/decryption-cache.ts","../src/relayer/use-user-decrypt.ts","../src/relayer/use-public-decrypt.ts","../src/relayer/use-generate-keypair.ts","../src/relayer/use-create-eip712.ts","../src/relayer/use-create-delegated-user-decrypt-eip712.ts","../src/relayer/use-delegated-user-decrypt.ts","../src/relayer/use-request-zk-proof-verification.ts","../src/utils/query.ts","../src/relayer/use-public-key.ts","../src/relayer/use-public-params.ts","../src/relayer/use-user-decrypt-flow.ts","../src/relayer/use-user-decrypted-value.ts","../src/relayer/use-user-decrypted-values.ts","../src/token/use-token.ts","../src/token/use-readonly-token.ts","../src/token/use-confidential-balance.ts","../src/token/use-confidential-balances.ts","../src/token/use-allow-tokens.ts","../src/token/use-is-allowed.ts","../src/token/use-revoke-tokens.ts","../src/token/use-revoke-session.ts","../src/token/optimistic-balance-update.ts","../src/token/use-confidential-transfer.ts","../src/token/use-confidential-transfer-from.ts","../src/token/use-confidential-approve.ts","../src/token/use-confidential-is-approved.ts","../src/token/use-shield.ts","../src/token/use-shield-eth.ts","../src/token/use-unwrap.ts","../src/token/use-unwrap-all.ts","../src/token/use-finalize-unwrap.ts","../src/token/use-unshield.ts","../src/token/use-unshield-all.ts","../src/token/use-resume-unshield.ts","../src/token/use-underlying-allowance.ts","../src/token/use-wrapper-discovery.ts","../src/token/use-metadata.ts","../src/token/use-activity-feed.ts","../src/token/use-delegate-decryption.ts","../src/token/use-revoke-delegation.ts","../src/token/use-delegation-status.ts","../src/token/use-decrypt-balance-as.ts","../src/token/use-batch-decrypt-balances-as.ts","../src/token/use-approve-underlying.ts","../src/token/use-is-confidential.ts","../src/token/use-total-supply.ts","../src/token/use-fees.ts"],"sourcesContent":["\"use client\";\n\nimport type {\n  GenericSigner,\n  GenericStorage,\n  RelayerSDK,\n  ZamaSDKEventListener,\n} from \"@zama-fhe/sdk\";\nimport { ZamaSDK } from \"@zama-fhe/sdk\";\nimport { invalidateWalletLifecycleQueries } from \"@zama-fhe/sdk/query\";\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport {\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n} from \"react\";\n\n/** Props for {@link ZamaProvider}. */\nexport interface ZamaProviderProps extends PropsWithChildren {\n  /** FHE relayer backend (RelayerWeb for browser, RelayerNode for server). */\n  relayer: RelayerSDK;\n  /** Wallet signer (`ViemSigner`, `EthersSigner`, or custom {@link GenericSigner}). */\n  signer: GenericSigner;\n  /** Credential storage backend (IndexedDBStorage for browser, MemoryStorage for tests). */\n  storage: GenericStorage;\n  /**\n   * Session storage for wallet signatures. Defaults to in-memory (lost on reload).\n   * Pass a `chrome.storage.session`-backed store for web extensions.\n   */\n  sessionStorage?: GenericStorage;\n  /**\n   * How long the ML-KEM re-encryption keypair remains valid, in seconds.\n   * Default: `86400` (1 day). Must be positive — `0` is rejected.\n   */\n  keypairTTL?: number;\n  /**\n   * Controls how long session signatures (EIP-712 wallet signatures) remain valid, in seconds.\n   * Default: `2592000` (30 days).\n   * - `0`: never persist — every operation triggers a signing prompt (high-security mode).\n   * - Positive number: seconds until the session signature expires and requires re-authentication.\n   */\n  sessionTTL?: number;\n  /** Callback invoked on SDK lifecycle events. */\n  onEvent?: ZamaSDKEventListener;\n}\n\nconst ZamaSDKContext = createContext<ZamaSDK | null>(null);\n\n/**\n * Provides a {@link ZamaSDK} instance to all descendant hooks.\n *\n * @example\n * ```tsx\n * <ZamaProvider relayer={relayer} signer={signer} storage={storage}>\n *   <App />\n * </ZamaProvider>\n * ```\n */\nexport function ZamaProvider({\n  children,\n  relayer,\n  signer,\n  storage,\n  sessionStorage,\n  keypairTTL,\n  sessionTTL,\n  onEvent,\n}: ZamaProviderProps) {\n  const queryClient = useQueryClient();\n\n  // Stabilize onEvent so an inline arrow doesn't recreate the SDK every render.\n  const onEventRef = useRef(onEvent);\n  useEffect(() => {\n    onEventRef.current = onEvent;\n  });\n\n  const signerLifecycleCallbacks = useMemo(\n    () =>\n      signer?.subscribe\n        ? {\n            onDisconnect: () => invalidateWalletLifecycleQueries(queryClient),\n            onAccountChange: () => invalidateWalletLifecycleQueries(queryClient),\n            onChainChange: () => invalidateWalletLifecycleQueries(queryClient),\n          }\n        : undefined,\n    [queryClient, signer],\n  );\n\n  const sdk = useMemo(\n    () =>\n      new ZamaSDK({\n        relayer,\n        signer,\n        storage,\n        sessionStorage,\n        keypairTTL,\n        sessionTTL,\n        onEvent: onEventRef.current,\n        signerLifecycleCallbacks,\n      }),\n    [relayer, signer, storage, sessionStorage, keypairTTL, sessionTTL, signerLifecycleCallbacks],\n  );\n\n  // Clean up signer subscriptions on unmount without terminating the\n  // caller-owned relayer. dispose() only unsubscribes from wallet events\n  // and is idempotent.\n  useEffect(() => () => sdk.dispose(), [sdk]);\n\n  return <ZamaSDKContext.Provider value={sdk}>{children}</ZamaSDKContext.Provider>;\n}\n\n/**\n * Access the {@link ZamaSDK} instance from context.\n * Throws if called outside a {@link ZamaProvider} or when no signer is provided.\n *\n * @example\n * ```tsx\n * const sdk = useZamaSDK();\n * const token = sdk.createReadonlyToken(\"0x...\");\n * ```\n */\nexport function useZamaSDK(): ZamaSDK {\n  const context = useContext(ZamaSDKContext);\n\n  if (!context) {\n    throw new Error(\n      \"useZamaSDK must be used within a <ZamaProvider>. \" +\n        \"Wrap your component tree in <ZamaProvider relayer={…} signer={…} storage={…}>.\",\n    );\n  }\n\n  return context;\n}\n","\"use client\";\n\nimport type { EncryptParams, EncryptResult } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { encryptMutationOptions } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Encrypt a plaintext value using FHE.\n * Calls the relayer's `encrypt` method via a mutation.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link EncryptionFailedError} — FHE encryption failed\n *\n * @returns A mutation whose `mutate` accepts {@link EncryptParams}.\n *\n * @example\n * ```tsx\n * const encrypt = useEncrypt();\n * encrypt.mutate({ values: [1000n], bits: [64] });\n * ```\n */\nexport function useEncrypt() {\n  const sdk = useZamaSDK();\n  return useMutation<EncryptResult, Error, EncryptParams>(encryptMutationOptions(sdk));\n}\n","import { zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport type { Address, Handle } from \"@zama-fhe/sdk\";\n\n/**\n * Query key helpers for the shared decryption cache.\n * Used by useUserDecrypt/usePublicDecrypt to populate,\n * and by useUserDecryptedValue to read.\n */\nexport const decryptionKeys = {\n  value: (handle: Handle, contractAddress?: Address) =>\n    zamaQueryKeys.decryption.handle(handle, contractAddress),\n};\n","\"use client\";\n\nimport { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { ClearValueType, Handle, UserDecryptParams } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Thin wrapper around sdk.userDecrypt().\n * Caller is responsible for providing all params (keypair, signature, etc.).\n * For the full orchestration (signature management, EIP712 signing),\n * see the app-level useUserDecryptFlow hook.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link DecryptionFailedError} — relayer decryption request failed\n * - {@link InvalidKeypairError} — the provided keypair is invalid\n * - {@link KeypairExpiredError} — the re-encryption keypair has expired\n *\n * On success, populates the decryption cache so useUserDecryptedValue/useUserDecryptedValues\n * can read the results.\n */\nexport function useUserDecrypt() {\n  const sdk = useZamaSDK();\n  const queryClient = useQueryClient();\n\n  return useMutation<Record<Handle, ClearValueType>, Error, UserDecryptParams>({\n    mutationFn: (params) => sdk.relayer.userDecrypt(params),\n    onSuccess: (data) => {\n      for (const [handle, value] of Object.entries(data) as [Handle, ClearValueType][]) {\n        queryClient.setQueryData(decryptionKeys.value(handle), value);\n      }\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { ClearValueType, Handle, PublicDecryptResult } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Decrypt FHE ciphertext handles using the network public key (no credential needed).\n * On success, populates the decryption cache so {@link useUserDecryptedValue} / {@link useUserDecryptedValues}\n * can read the results.\n *\n * @returns A mutation whose `mutate` accepts an array of handle strings.\n *\n * @example\n * ```tsx\n * const publicDecrypt = usePublicDecrypt();\n * publicDecrypt.mutate([\"0xHandle1\", \"0xHandle2\"]);\n * // publicDecrypt.data?.clearValues => { \"0xHandle1\": 500n, ... }\n * ```\n */\nexport function usePublicDecrypt() {\n  const sdk = useZamaSDK();\n  const queryClient = useQueryClient();\n  return useMutation<PublicDecryptResult, Error, Handle[]>({\n    mutationFn: (handles) => sdk.relayer.publicDecrypt(handles),\n    onSuccess: (data) => {\n      for (const [handle, value] of Object.entries(data.clearValues) as [\n        Handle,\n        ClearValueType,\n      ][]) {\n        queryClient.setQueryData(decryptionKeys.value(handle), value);\n      }\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Generate an FHE keypair via the relayer.\n * Returns a public/private key pair for use in decrypt authorization.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link RelayerRequestFailedError} — relayer keypair generation request failed\n *\n * @returns A mutation whose `mutate` takes no parameters.\n *\n * @example\n * ```tsx\n * const generateKeypair = useGenerateKeypair();\n * generateKeypair.mutate();\n * // generateKeypair.data?.publicKey, generateKeypair.data?.privateKey\n * ```\n */\nexport function useGenerateKeypair() {\n  const sdk = useZamaSDK();\n  return useMutation({\n    mutationFn: () => sdk.relayer.generateKeypair(),\n  });\n}\n","\"use client\";\n\nimport type { EIP712TypedData, Address } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/** Parameters for {@link useCreateEIP712}. */\nexport interface CreateEIP712Params {\n  /** The FHE public key (hex-encoded). */\n  publicKey: `0x${string}`;\n  /** Contract addresses the credential authorizes decryption for. */\n  contractAddresses: Address[];\n  /** Unix timestamp (seconds) when the credential becomes valid. */\n  startTimestamp: number;\n  /** Number of days the credential remains valid. Default: 1. */\n  durationDays?: number;\n}\n\n/**\n * Create EIP-712 typed data for signing an FHE decrypt credential.\n * The returned typed data is signed by the wallet to authorize decryption.\n *\n * @returns A mutation whose `mutate` accepts {@link CreateEIP712Params}.\n *\n * @example\n * ```tsx\n * const createEIP712 = useCreateEIP712();\n * createEIP712.mutate({\n *   publicKey: keypair.publicKey,\n *   contractAddresses: [\"0xToken\"],\n *   startTimestamp: Math.floor(Date.now() / 1000),\n * });\n * ```\n */\nexport function useCreateEIP712() {\n  const sdk = useZamaSDK();\n  return useMutation<EIP712TypedData, Error, CreateEIP712Params>({\n    mutationFn: ({ publicKey, contractAddresses, startTimestamp, durationDays }) =>\n      sdk.relayer.createEIP712(publicKey, contractAddresses, startTimestamp, durationDays),\n  });\n}\n","\"use client\";\n\nimport type { Address, KmsDelegatedUserDecryptEIP712Type } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/** Parameters for {@link useCreateDelegatedUserDecryptEIP712}. */\nexport interface CreateDelegatedUserDecryptEIP712Params {\n  /** The FHE public key (hex-encoded). */\n  publicKey: `0x${string}`;\n  /** Contract addresses the credential authorizes decryption for. */\n  contractAddresses: Address[];\n  /** Address of the wallet that delegated decrypt authority. */\n  delegatorAddress: Address;\n  /** Unix timestamp (seconds) when the credential becomes valid. */\n  startTimestamp: number;\n  /** Number of days the credential remains valid. Default: 1. */\n  durationDays?: number;\n}\n\n/**\n * Create EIP-712 typed data for a delegated user decrypt credential.\n * Used when one wallet authorizes another to decrypt on its behalf.\n *\n * @returns A mutation whose `mutate` accepts {@link CreateDelegatedUserDecryptEIP712Params}.\n *\n * @example\n * ```tsx\n * const createEIP712 = useCreateDelegatedUserDecryptEIP712();\n * createEIP712.mutate({\n *   publicKey: keypair.publicKey,\n *   contractAddresses: [\"0xToken\"],\n *   delegatorAddress: \"0xDelegator\",\n *   startTimestamp: Math.floor(Date.now() / 1000),\n * });\n * ```\n */\nexport function useCreateDelegatedUserDecryptEIP712() {\n  const sdk = useZamaSDK();\n  return useMutation<\n    KmsDelegatedUserDecryptEIP712Type,\n    Error,\n    CreateDelegatedUserDecryptEIP712Params\n  >({\n    mutationFn: ({\n      publicKey,\n      contractAddresses,\n      delegatorAddress,\n      startTimestamp,\n      durationDays,\n    }) =>\n      sdk.relayer.createDelegatedUserDecryptEIP712(\n        publicKey,\n        contractAddresses,\n        delegatorAddress,\n        startTimestamp,\n        durationDays,\n      ),\n  });\n}\n","\"use client\";\n\nimport type { DelegatedUserDecryptParams, ClearValueType, Handle } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Decrypt FHE ciphertext handles using delegated user credentials.\n * Returns a map of handle → plaintext bigint.\n *\n * @returns A mutation whose `mutate` accepts {@link DelegatedUserDecryptParams}.\n *\n * @example\n * ```tsx\n * const decrypt = useDelegatedUserDecrypt();\n * decrypt.mutate({ handles: [\"0xHandle1\"], ...credentials });\n * // decrypt.data => { \"0xHandle1\": 1000n }\n * ```\n */\nexport function useDelegatedUserDecrypt() {\n  const sdk = useZamaSDK();\n  return useMutation<Record<Handle, ClearValueType>, Error, DelegatedUserDecryptParams>({\n    mutationFn: (params) => sdk.relayer.delegatedUserDecrypt(params),\n  });\n}\n","\"use client\";\n\nimport type { InputProofBytesType, ZKProofLike } from \"@zama-fhe/sdk\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Submit a ZK proof for on-chain verification.\n * Returns the input proof bytes for use in contract calls.\n *\n * @returns A mutation whose `mutate` accepts a {@link ZKProofLike}.\n *\n * @example\n * ```tsx\n * const verify = useRequestZKProofVerification();\n * verify.mutate(zkProof);\n * // verify.data => Uint8Array (input proof bytes)\n * ```\n */\nexport function useRequestZKProofVerification() {\n  const sdk = useZamaSDK();\n  return useMutation<InputProofBytesType, Error, ZKProofLike>({\n    mutationFn: (zkProof) => sdk.relayer.requestZKProofVerification(zkProof),\n  });\n}\n","import {\n  type DefaultError,\n  useQuery as tanstack_useQuery,\n  useSuspenseQuery as tanstack_useSuspenseQuery,\n  type UseQueryResult,\n  type UseSuspenseQueryResult,\n} from \"@tanstack/react-query\";\nimport { hashFn } from \"@zama-fhe/sdk/query\";\n\n/**\n * Thin wrapper around TanStack's useQuery that injects our custom queryKeyHashFn.\n * Mirrors the wagmi pattern — the type safety boundary is at the factory and hook levels.\n *\n * The `options` parameter is typed as `any` because TanStack Query v5 has:\n * 1. Discriminated overloads around `initialData` (Defined vs Undefined)\n * 2. Function-typed fields (`staleTime`, `enabled`, `gcTime`) that are generic over `TQueryKey`\n *\n * Our factories produce options with specific tuple keys (e.g. `readonly [\"zama.totalSupply\", {...}]`)\n * whose function-typed fields are contravariant with `QueryKey` (`readonly unknown[]`).\n * Typing the parameter as `UseQueryOptions<TData, TError, TData, any>` still fails because\n * the query-key variance leaks through `staleTime`, `enabled`, etc.\n *\n * Hooks must pass explicit generics: `useQuery<DataType>({...})`.\n */\nexport function useQuery<TData = unknown, TError = DefaultError>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options: any,\n): UseQueryResult<TData, TError> {\n  return tanstack_useQuery({\n    ...options,\n    queryKeyHashFn: hashFn,\n  }) as UseQueryResult<TData, TError>;\n}\n\nexport function useSuspenseQuery<TData = unknown, TError = DefaultError>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options: any,\n): UseSuspenseQueryResult<TData, TError> {\n  return tanstack_useSuspenseQuery({\n    ...options,\n    queryKeyHashFn: hashFn,\n  }) as UseSuspenseQueryResult<TData, TError>;\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { publicKeyQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\nexport { publicKeyQueryOptions };\n\n/** Shape of the FHE public key data returned by the relayer. */\nexport interface PublicKeyData {\n  /** Unique identifier for this public key version. */\n  publicKeyId: string;\n  /** The raw FHE public key bytes. */\n  publicKey: Uint8Array;\n}\n\n/**\n * Fetch the FHE network public key from the relayer.\n * Cached indefinitely since the key does not change during a session.\n *\n * @returns Query result with `data: PublicKeyData | null`.\n *\n * @example\n * ```tsx\n * const { data: publicKey } = usePublicKey();\n * // publicKey?.publicKeyId, publicKey?.publicKey\n * ```\n */\nexport function usePublicKey() {\n  const sdk = useZamaSDK();\n  return useQuery<PublicKeyData | null>({\n    ...publicKeyQueryOptions(sdk),\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { publicParamsQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\nexport { publicParamsQueryOptions };\n\n/** Shape of the FHE public parameters returned by the relayer. */\nexport interface PublicParamsData {\n  /** The raw public parameters bytes (WASM-ready). */\n  publicParams: Uint8Array;\n  /** Unique identifier for this public params version. */\n  publicParamsId: string;\n}\n\n/**\n * Fetch FHE public parameters for a given bit size from the relayer.\n * Cached indefinitely since parameters do not change during a session.\n *\n * @param bits - The FHE bit size to fetch parameters for (e.g. 2048).\n * @returns Query result with `data: PublicParamsData | null`.\n *\n * @example\n * ```tsx\n * const { data: params } = usePublicParams(2048);\n * // params?.publicParams, params?.publicParamsId\n * ```\n */\nexport function usePublicParams(bits: number) {\n  const sdk = useZamaSDK();\n  return useQuery<PublicParamsData | null>({\n    ...publicParamsQueryOptions(sdk, bits),\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { Address, ClearValueType, Handle, Hex } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\nimport { useZamaSDK } from \"../provider\";\n\n/** A handle to decrypt, paired with its originating contract address. */\nexport interface DecryptHandle {\n  handle: Handle;\n  contractAddress: Address;\n}\n\n/** Parameters for {@link useUserDecryptFlow}. */\nexport interface UserDecryptFlowParams {\n  /** Encrypted handles to decrypt. */\n  handles: DecryptHandle[];\n  /** Number of days the credential remains valid. Default: 1. */\n  durationDays?: number;\n}\n\n/** Progress callbacks for each step of the decrypt flow. */\nexport interface UserDecryptFlowCallbacks {\n  /** Fired after the keypair is generated. */\n  onKeypairGenerated?: () => void;\n  /** Fired after the EIP-712 typed data is created, before wallet signing. */\n  onEIP712Created?: () => void;\n  /** Fired after the wallet signature is obtained. */\n  onSigned?: (signature: Hex) => void;\n  /** Fired after decryption completes. */\n  onDecrypted?: (values: Record<Handle, ClearValueType>) => void;\n}\n\n/** Configuration for {@link useUserDecryptFlow}. */\nexport interface UseUserDecryptFlowConfig {\n  /** Optional progress callbacks. */\n  callbacks?: UserDecryptFlowCallbacks;\n}\n\n/**\n * High-level orchestration hook for user decryption.\n * Handles the full flow: keypair generation → EIP-712 creation → wallet signature → decryption.\n *\n * On success, populates the decryption cache so `useUserDecryptedValue` / `useUserDecryptedValues`\n * can read the results.\n *\n * @param config - Optional callbacks for step-by-step UX feedback.\n * @returns A mutation whose `mutate` accepts {@link UserDecryptFlowParams}.\n *\n * @example\n * ```tsx\n * const decryptFlow = useUserDecryptFlow({\n *   callbacks: { onSigned: () => setStep(\"decrypting\") },\n * });\n * decryptFlow.mutate({\n *   handles: [{ handle: \"0xHandle\", contractAddress: \"0xContract\" }],\n *   durationDays: 7,\n * });\n * ```\n */\nexport function useUserDecryptFlow(config?: UseUserDecryptFlowConfig) {\n  const sdk = useZamaSDK();\n  const queryClient = useQueryClient();\n  const callbacks = config?.callbacks;\n\n  return useMutation<Record<Handle, ClearValueType>, Error, UserDecryptFlowParams>({\n    mutationKey: [\"userDecryptFlow\"],\n    mutationFn: async ({ handles, durationDays = 1 }) => {\n      // Step 1: Generate keypair\n      const keypair = await sdk.relayer.generateKeypair();\n      callbacks?.onKeypairGenerated?.();\n\n      // Step 2: Create EIP-712 typed data\n      const contractAddresses = [...new Set(handles.map((h) => h.contractAddress))];\n      const startTimestamp = Math.floor(Date.now() / 1000);\n      const eip712 = await sdk.relayer.createEIP712(\n        keypair.publicKey,\n        contractAddresses,\n        startTimestamp,\n        durationDays,\n      );\n      callbacks?.onEIP712Created?.();\n\n      // Step 3: Sign with wallet\n      const signature = await sdk.signer.signTypedData(eip712);\n      callbacks?.onSigned?.(signature);\n\n      // Step 4: Decrypt — group handles by contract address\n      const signerAddress = await sdk.signer.getAddress();\n      const allResults: Partial<Record<Handle, ClearValueType>> = {};\n\n      // Decrypt per contract address (the relayer requires handles from the same contract)\n      const handlesByContract = new Map<Address, Handle[]>();\n      for (const h of handles) {\n        const list = handlesByContract.get(h.contractAddress) ?? [];\n        list.push(h.handle);\n        handlesByContract.set(h.contractAddress, list);\n      }\n\n      for (const [contractAddress, contractHandles] of handlesByContract) {\n        const result = await sdk.relayer.userDecrypt({\n          handles: contractHandles,\n          contractAddress,\n          signedContractAddresses: contractAddresses,\n          privateKey: keypair.privateKey,\n          publicKey: keypair.publicKey,\n          signature,\n          signerAddress,\n          startTimestamp,\n          durationDays,\n        });\n        Object.assign(allResults, result);\n      }\n\n      const results = allResults as Record<Handle, ClearValueType>;\n      callbacks?.onDecrypted?.(results);\n      return results;\n    },\n    onSuccess: (data) => {\n      // Populate the shared decryption cache\n      for (const [handle, value] of Object.entries(data) as [Handle, ClearValueType][]) {\n        queryClient.setQueryData(decryptionKeys.value(handle), value);\n      }\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport type { ClearValueType, Handle } from \"@zama-fhe/sdk\";\nimport { decryptionKeys } from \"./decryption-cache\";\n\n/**\n * Look up a single cached decrypted value by its handle.\n * Values are populated automatically when useUserDecrypt or usePublicDecrypt succeed.\n * You can also populate manually via queryClient.setQueryData(decryptionKeys.value(handle), value).\n */\nexport function useUserDecryptedValue(handle: Handle | undefined) {\n  return useQuery<ClearValueType>({\n    queryKey: decryptionKeys.value(handle ?? \"0x\"),\n    queryFn: () => undefined as never,\n    enabled: false,\n  });\n}\n","\"use client\";\n\nimport { useQueries } from \"@tanstack/react-query\";\nimport type { ClearValueType, Handle } from \"@zama-fhe/sdk\";\nimport { hashFn } from \"@zama-fhe/sdk/query\";\nimport { decryptionKeys } from \"./decryption-cache\";\n\n/**\n * Look up multiple cached decrypted values by their handles.\n * Values are populated automatically when useUserDecrypt or usePublicDecrypt succeed.\n */\nexport function useUserDecryptedValues(handles: Handle[]) {\n  const results = useQueries({\n    queries: handles.map((handle) => ({\n      queryKey: decryptionKeys.value(handle),\n      queryKeyHashFn: hashFn,\n      queryFn: () => undefined as never,\n      enabled: false,\n    })),\n  });\n\n  const data: Partial<Record<Handle, ClearValueType | undefined>> = {};\n  for (let i = 0; i < handles.length; i++) {\n    data[handles[i]!] = results[i]!.data as ClearValueType | undefined;\n  }\n\n  return {\n    data,\n    results,\n  };\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { useZamaSDK } from \"../provider\";\n\n/** Base configuration shared by all mutation hooks that need a Token instance. */\nexport interface UseZamaConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** Address of the wrapper contract (required for shield/unshield operations). */\n  wrapperAddress?: Address;\n}\n\n/**\n * Get a {@link Token} instance, memoized by address pair.\n * Reads signer and storage from the nearest {@link ZamaProvider}.\n *\n * @param config - Token and optional wrapper addresses.\n * @returns A memoized `Token` instance.\n *\n * @example\n * ```tsx\n * const token = useToken({ tokenAddress: \"0xToken\", wrapperAddress: \"0xWrapper\" });\n * ```\n */\nexport function useToken(config: UseZamaConfig) {\n  const sdk = useZamaSDK();\n\n  return useMemo(\n    () => sdk.createToken(config.tokenAddress, config.wrapperAddress),\n    [sdk, config.tokenAddress, config.wrapperAddress],\n  );\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Get a {@link ReadonlyToken} instance, memoized by address.\n * Supports balance queries, ERC-165 checks, and authorization — no wrapper needed.\n * Reads signer and storage from the nearest {@link ZamaProvider}.\n *\n * @param address - Address of the confidential token contract.\n * @returns A memoized `ReadonlyToken` instance.\n *\n * @example\n * ```tsx\n * const token = useReadonlyToken(\"0xToken\");\n * // token.balanceOf(), token.isConfidential(), etc.\n * ```\n */\nexport function useReadonlyToken(address: Address) {\n  const sdk = useZamaSDK();\n\n  return useMemo(() => sdk.createReadonlyToken(address), [sdk, address]);\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address, Handle } from \"@zama-fhe/sdk\";\nimport {\n  confidentialBalanceQueryOptions,\n  confidentialHandleQueryOptions,\n  signerAddressQueryOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\n/** Configuration for {@link useConfidentialBalance}. */\nexport interface UseConfidentialBalanceConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** Polling interval (ms) for the encrypted handle. Default: 10 000. */\n  handleRefetchInterval?: number;\n}\n\n/** Query options for the decrypt phase of {@link useConfidentialBalance}. */\nexport type UseConfidentialBalanceOptions = Omit<UseQueryOptions<bigint>, \"queryKey\" | \"queryFn\">;\n\n/**\n * Declarative hook to read the connected wallet's confidential token balance.\n * Uses two-phase polling: cheaply polls the encrypted handle, then only\n * decrypts when the handle changes (new balance).\n *\n * @param config - Token address and optional polling interval.\n * @param options - React Query options forwarded to the decrypt query.\n * @returns The decrypt query result plus `handleQuery` for Phase 1 state.\n *\n * @example\n * ```tsx\n * const { data: balance, isLoading, handleQuery } = useConfidentialBalance({\n *   tokenAddress: \"0x...\",\n * });\n * ```\n */\nexport function useConfidentialBalance(\n  config: UseConfidentialBalanceConfig,\n  options?: UseConfidentialBalanceOptions,\n) {\n  const { tokenAddress, handleRefetchInterval } = config;\n  const userEnabled = options?.enabled;\n  const token = useReadonlyToken(tokenAddress);\n\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n\n  const owner = addressQuery.data;\n\n  // Phase 1: Poll the encrypted handle (cheap RPC read, no signing)\n  const baseHandleQueryOptions = confidentialHandleQueryOptions(token.signer, tokenAddress, {\n    owner,\n    pollingInterval: handleRefetchInterval,\n  });\n  const handleQuery = useQuery<Handle>({\n    ...baseHandleQueryOptions,\n    enabled: (baseHandleQueryOptions.enabled ?? true) && (userEnabled ?? true),\n  });\n\n  // Phase 2: Decrypt only when handle changes (expensive relayer roundtrip)\n  const handle = handleQuery.data;\n  const baseBalanceQueryOptions = confidentialBalanceQueryOptions(token, {\n    handle,\n    owner,\n  });\n  const balanceQuery = useQuery<bigint>({\n    ...baseBalanceQueryOptions,\n    ...options,\n    enabled: (baseBalanceQueryOptions.enabled ?? true) && (userEnabled ?? true),\n  });\n\n  return { ...balanceQuery, handleQuery };\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport { useQuery } from \"../utils/query\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address, Handle } from \"@zama-fhe/sdk\";\nimport {\n  confidentialBalancesQueryOptions,\n  confidentialHandlesQueryOptions,\n  signerAddressQueryOptions,\n  type ConfidentialBalancesData,\n} from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/** Configuration for {@link useConfidentialBalances}. */\nexport interface UseConfidentialBalancesConfig {\n  /** Addresses of the confidential token contracts to batch-query. */\n  tokenAddresses: Address[];\n  /** Polling interval (ms) for the encrypted handles. Default: 10 000. */\n  handleRefetchInterval?: number;\n  /** Maximum number of concurrent decrypt calls. Default: `Infinity` (no limit). */\n  maxConcurrency?: number;\n}\n\nexport type { ConfidentialBalancesData };\n\n/** Query options for the decrypt phase of {@link useConfidentialBalances}. */\nexport type UseConfidentialBalancesOptions = Omit<\n  UseQueryOptions<ConfidentialBalancesData>,\n  \"queryKey\" | \"queryFn\"\n>;\n\n/**\n * Declarative hook to read multiple confidential token balances in batch.\n * Uses two-phase polling: cheaply polls encrypted handles, then only\n * decrypts when any handle changes.\n *\n * Returns partial results when some tokens fail — successful balances are\n * always returned alongside per-token error information.\n *\n * @param config - Token addresses and optional polling interval.\n * @param options - React Query options forwarded to the decrypt query.\n * @returns The decrypt query result plus `handlesQuery` for Phase 1 state.\n *\n * @example\n * ```tsx\n * const { data } = useConfidentialBalances({\n *   tokenAddresses: [\"0xTokenA\", \"0xTokenB\"],\n * });\n * const balance = data?.balances.get(\"0xTokenA\");\n * if (data?.isPartialError) {\n *   // some tokens failed — check data.errors\n * }\n * ```\n */\nexport function useConfidentialBalances(\n  config: UseConfidentialBalancesConfig,\n  options?: UseConfidentialBalancesOptions,\n) {\n  const { tokenAddresses, handleRefetchInterval, maxConcurrency } = config;\n  const userEnabled = options?.enabled;\n  const sdk = useZamaSDK();\n\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(sdk.signer),\n  });\n\n  const owner = addressQuery.data;\n\n  const tokens = useMemo(\n    () => tokenAddresses.map((addr) => sdk.createReadonlyToken(addr)),\n    [sdk, tokenAddresses],\n  );\n\n  // Phase 1: Poll all encrypted handles (cheap RPC reads)\n  const baseHandlesQueryOptions = confidentialHandlesQueryOptions(sdk.signer, tokenAddresses, {\n    owner,\n    pollingInterval: handleRefetchInterval,\n  });\n  const handlesQuery = useQuery<Handle[]>({\n    ...baseHandlesQueryOptions,\n    enabled: (baseHandlesQueryOptions.enabled ?? true) && (userEnabled ?? true),\n  });\n\n  // Phase 2: Batch decrypt only when any handle changes\n  const handles = handlesQuery.data;\n  const handlesReady = Array.isArray(handles) && handles.length === tokenAddresses.length;\n  const baseBalancesQueryOptions = confidentialBalancesQueryOptions(tokens, {\n    owner,\n    handles,\n    maxConcurrency,\n    resultAddresses: tokenAddresses,\n  });\n  const factoryEnabled = baseBalancesQueryOptions.enabled ?? true;\n\n  const balancesQuery = useQuery<ConfidentialBalancesData>({\n    ...baseBalancesQueryOptions,\n    ...options,\n    enabled: factoryEnabled && handlesReady && (userEnabled ?? true),\n  });\n\n  return { ...balancesQuery, handlesQuery };\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { allowMutationOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Pre-authorize FHE decrypt credentials for a list of token addresses.\n * A single wallet signature covers all addresses, so subsequent decrypt\n * operations on any of these tokens reuse cached credentials.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link KeypairExpiredError} — the re-encryption keypair has expired\n *\n * @example\n * ```tsx\n * const { mutateAsync: allowTokens, isPending } = useAllowTokens();\n * // Call allowTokens(allTokenAddresses) before any individual reveal\n * ```\n */\nexport function useAllowTokens(options?: UseMutationOptions<void, Error, Address[]>) {\n  const sdk = useZamaSDK();\n\n  return useMutation<void, Error, Address[]>({\n    ...allowMutationOptions(sdk),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      void context.client.invalidateQueries({ queryKey: zamaQueryKeys.isAllowed.all });\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport { skipToken } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  isAllowedQueryOptions,\n  signerAddressQueryOptions,\n  zamaQueryKeys,\n} from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Check whether a session signature is cached for the connected wallet.\n * Returns `true` if decrypt operations can proceed without a wallet prompt.\n *\n * @example\n * ```tsx\n * const { data: allowed } = useIsAllowed();\n * ```\n */\nexport function useIsAllowed() {\n  const sdk = useZamaSDK();\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(sdk.signer),\n  });\n  const account = addressQuery.data;\n  const baseOpts = account\n    ? isAllowedQueryOptions(sdk, { account })\n    : {\n        queryKey: zamaQueryKeys.isAllowed.all,\n        queryFn: skipToken,\n      };\n  const factoryEnabled = \"enabled\" in baseOpts ? (baseOpts.enabled ?? true) : true;\n\n  return useQuery({\n    ...baseOpts,\n    enabled: factoryEnabled,\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { revokeMutationOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Revoke stored FHE credentials for a list of token addresses.\n * The next decrypt operation will require a fresh wallet signature.\n *\n * @example\n * ```tsx\n * const { mutate: revokeTokens } = useRevokeTokens();\n * revokeTokens([\"0xTokenA\", \"0xTokenB\"]);\n * ```\n */\nexport function useRevokeTokens(options?: UseMutationOptions<void, Error, Address[]>) {\n  const sdk = useZamaSDK();\n\n  return useMutation<void, Error, Address[]>({\n    ...revokeMutationOptions(sdk),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      void context.client.invalidateQueries({ queryKey: zamaQueryKeys.isAllowed.all });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport { revokeSessionMutationOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\n/**\n * Revoke the session signature for the connected wallet without\n * specifying contract addresses. Useful for wallet disconnect handlers.\n *\n * @example\n * ```tsx\n * const { mutate: revokeSession } = useRevokeSession();\n * revokeSession();\n * ```\n */\nexport function useRevokeSession(options?: UseMutationOptions<void>) {\n  const sdk = useZamaSDK();\n\n  return useMutation<void>({\n    ...revokeSessionMutationOptions(sdk),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      void context.client.invalidateQueries({ queryKey: zamaQueryKeys.isAllowed.all });\n    },\n  });\n}\n","import type { QueryClient, QueryKey, UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport { invalidateAfterShield, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\n\ntype BalanceDeltaMode = \"add\" | \"subtract\";\nexport type OptimisticBalanceSnapshot = [QueryKey, bigint | undefined][];\n\n/** Combined context returned by optimistic `onMutate`. */\nexport interface OptimisticMutateContext {\n  snapshot: OptimisticBalanceSnapshot;\n  callerContext?: unknown;\n}\n\nexport function unwrapOptimisticCallerContext(\n  optimistic: boolean | undefined,\n  rawContext: unknown,\n): {\n  wrappedContext: OptimisticMutateContext | undefined;\n  callerContext: OptimisticMutateContext | undefined;\n} {\n  const typed = rawContext as OptimisticMutateContext | undefined;\n  const wrappedContext = optimistic ? typed : undefined;\n  const callerContext = (optimistic ? wrappedContext?.callerContext : rawContext) as\n    | OptimisticMutateContext\n    | undefined;\n  return { wrappedContext, callerContext };\n}\n\nexport async function applyOptimisticBalanceDelta({\n  queryClient,\n  tokenAddress,\n  amount,\n  mode,\n}: {\n  queryClient: QueryClient;\n  tokenAddress: Address;\n  amount: bigint;\n  mode: BalanceDeltaMode;\n}): Promise<OptimisticBalanceSnapshot> {\n  const balanceKey = zamaQueryKeys.confidentialBalance.token(tokenAddress);\n  await queryClient.cancelQueries({ queryKey: balanceKey });\n  const previous = queryClient.getQueriesData<bigint>({ queryKey: balanceKey });\n  for (const [key, value] of previous) {\n    if (value === undefined) {\n      continue;\n    }\n    // Temporary optimistic underflow (`amount > value`) is acceptable because\n    // settlement invalidates and rewrites this cache entry.\n    queryClient.setQueryData(key, mode === \"add\" ? value + amount : value - amount);\n  }\n  return previous;\n}\n\nexport function rollbackOptimisticBalanceDelta(\n  queryClient: QueryClient,\n  snapshot: OptimisticBalanceSnapshot,\n) {\n  for (const [key, value] of snapshot) {\n    queryClient.setQueryData(key, value);\n  }\n}\n\n/**\n * Build optimistic mutation callbacks for shield operations.\n * Wraps the caller's `onMutate`/`onError`/`onSuccess`/`onSettled` with snapshot/rollback logic\n * and returns overrides ready to spread into `useMutation`.\n */\nexport function optimisticBalanceCallbacks<TParams extends { amount: bigint }>({\n  optimistic,\n  tokenAddress,\n  queryClient,\n  options,\n}: {\n  optimistic: boolean | undefined;\n  tokenAddress: Address;\n  queryClient: QueryClient;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  options: UseMutationOptions<TransactionResult, Error, TParams, any> | undefined;\n}): Pick<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  UseMutationOptions<TransactionResult, Error, TParams, any>,\n  \"onMutate\" | \"onError\" | \"onSuccess\" | \"onSettled\"\n> {\n  return {\n    onMutate: optimistic\n      ? async (variables, mutationContext) => {\n          const snapshot = await applyOptimisticBalanceDelta({\n            queryClient,\n            tokenAddress,\n            amount: variables.amount,\n            mode: \"add\",\n          });\n          const callerContext = await options?.onMutate?.(variables, mutationContext);\n          return { snapshot, callerContext };\n        }\n      : options?.onMutate,\n    onError: (error, variables, rawContext, context) => {\n      const { wrappedContext, callerContext } = unwrapOptimisticCallerContext(\n        optimistic,\n        rawContext,\n      );\n      try {\n        if (wrappedContext) {\n          rollbackOptimisticBalanceDelta(queryClient, wrappedContext.snapshot);\n        }\n      } finally {\n        options?.onError?.(error, variables, callerContext, context);\n      }\n    },\n    onSuccess: (data, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(optimistic, rawContext);\n      options?.onSuccess?.(data, variables, callerContext, context);\n      invalidateAfterShield(context.client, tokenAddress);\n    },\n    onSettled: (data, error, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(optimistic, rawContext);\n      options?.onSettled?.(data, error, variables, callerContext, context);\n    },\n  };\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  confidentialTransferMutationOptions,\n  invalidateAfterTransfer,\n  type ConfidentialTransferParams,\n} from \"@zama-fhe/sdk/query\";\nimport {\n  applyOptimisticBalanceDelta,\n  rollbackOptimisticBalanceDelta,\n  unwrapOptimisticCallerContext,\n} from \"./optimistic-balance-update\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/** Configuration for {@link useConfidentialTransfer}. */\nexport interface UseConfidentialTransferConfig extends UseZamaConfig {\n  /**\n   * When `true`, optimistically subtracts the transfer amount from cached balance\n   * before the transaction confirms. Rolls back on error.\n   * @defaultValue false\n   */\n  optimistic?: boolean;\n}\n\n/**\n * Encrypt and send a confidential transfer. Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption failed\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n *   Set `optimistic: true` to subtract the amount from the cached balance immediately.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const transfer = useConfidentialTransfer({\n *   tokenAddress: \"0x...\",\n *   optimistic: true,\n * });\n * transfer.mutate(\n *   { to: \"0xRecipient\", amount: 1000n },\n *   {\n *     onError: (error) => {\n *       if (error instanceof SigningRejectedError) {\n *         // user cancelled — no action needed\n *       }\n *     },\n *   },\n * );\n * ```\n */\nexport function useConfidentialTransfer<TContext = unknown>(\n  config: UseConfidentialTransferConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferParams, TContext>,\n): UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, TContext> {\n  const token = useToken(config);\n  const queryClient = useQueryClient();\n\n  // Internal mutation uses `any` for TContext because optimistic mode wraps\n  // the caller's context in OptimisticMutateContext; the public return type\n  // is cast back to the caller's TContext.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return useMutation<TransactionResult, Error, ConfidentialTransferParams, any>({\n    ...confidentialTransferMutationOptions(token),\n    ...options,\n    onMutate: config.optimistic\n      ? async (variables, mutationContext) => {\n          const snapshot = await applyOptimisticBalanceDelta({\n            queryClient,\n            tokenAddress: config.tokenAddress,\n            amount: variables.amount,\n            mode: \"subtract\",\n          });\n          const callerContext = await options?.onMutate?.(variables, mutationContext);\n          return { snapshot, callerContext };\n        }\n      : options?.onMutate,\n    onError: (error, variables, rawContext, context) => {\n      const { wrappedContext, callerContext } = unwrapOptimisticCallerContext(\n        config.optimistic,\n        rawContext,\n      );\n      try {\n        if (wrappedContext) {\n          rollbackOptimisticBalanceDelta(queryClient, wrappedContext.snapshot);\n        }\n      } finally {\n        options?.onError?.(error, variables, callerContext as TContext, context);\n      }\n    },\n    onSuccess: (data, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(config.optimistic, rawContext);\n      options?.onSuccess?.(data, variables, callerContext as TContext, context);\n      invalidateAfterTransfer(context.client, config.tokenAddress);\n    },\n    onSettled: (data, error, variables, rawContext, context) => {\n      const { callerContext } = unwrapOptimisticCallerContext(config.optimistic, rawContext);\n      options?.onSettled?.(data, error, variables, callerContext as TContext, context);\n    },\n  }) as UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, TContext>;\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  confidentialTransferFromMutationOptions,\n  invalidateAfterTransfer,\n  type ConfidentialTransferFromParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Operator transfer on behalf of another address. Caller must be an approved operator.\n * Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption of the transfer amount failed\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const transferFrom = useConfidentialTransferFrom({ tokenAddress: \"0x...\" });\n * transferFrom.mutate({ from: \"0xOwner\", to: \"0xRecipient\", amount: 500n });\n * ```\n */\nexport function useConfidentialTransferFrom(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferFromParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ConfidentialTransferFromParams, Address>({\n    ...confidentialTransferFromMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterTransfer(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  confidentialApproveMutationOptions,\n  invalidateAfterApprove,\n  type ConfidentialApproveParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Set operator approval for a confidential token. Defaults to 1 hour.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const approve = useConfidentialApprove({ tokenAddress: \"0x...\" });\n * approve.mutate({ spender: \"0xOperator\" });\n * ```\n */\nexport function useConfidentialApprove(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ConfidentialApproveParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ConfidentialApproveParams, Address>({\n    ...confidentialApproveMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterApprove(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { skipToken, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  confidentialIsApprovedQueryOptions,\n  signerAddressQueryOptions,\n  zamaQueryKeys,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\nexport { confidentialIsApprovedQueryOptions };\n\n/** Configuration for {@link useConfidentialIsApproved}. */\nexport interface UseConfidentialIsApprovedConfig extends UseZamaConfig {\n  /** Address to check approval for. Pass `undefined` to disable the query. */\n  spender: Address | undefined;\n  /** Token holder address. Defaults to the connected wallet. */\n  holder?: Address;\n}\n\n/** Configuration for {@link useConfidentialIsApprovedSuspense}. */\nexport interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {\n  /** Address to check approval for. */\n  spender: Address;\n  /** Token holder address. Defaults to the connected wallet. */\n  holder?: Address;\n}\n\n/**\n * Check if a spender is an approved operator for a given holder (defaults to connected wallet).\n *\n * @param config - Token address, spender, and optional holder to check.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isApproved } = useConfidentialIsApproved({\n *   tokenAddress: \"0xToken\",\n *   spender: \"0xSpender\",\n *   holder: \"0xHolder\", // optional\n * });\n * ```\n */\nexport function useConfidentialIsApproved(\n  config: UseConfidentialIsApprovedConfig,\n  options?: Omit<UseQueryOptions<boolean>, \"queryKey\" | \"queryFn\">,\n) {\n  const { spender, holder, ...tokenConfig } = config;\n  const userEnabled = options?.enabled;\n  const token = useToken(tokenConfig);\n  const holderQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n    enabled: holder === undefined,\n  });\n  const resolvedHolder = holder ?? holderQuery.data;\n\n  const baseOpts =\n    spender && resolvedHolder\n      ? confidentialIsApprovedQueryOptions(token.signer, token.address, {\n          holder: resolvedHolder,\n          spender,\n        })\n      : {\n          queryKey: zamaQueryKeys.confidentialIsApproved.token(config.tokenAddress),\n          queryFn: skipToken,\n        };\n  return useQuery({\n    ...baseOpts,\n    ...options,\n    enabled: (\"enabled\" in baseOpts ? (baseOpts.enabled ?? true) : true) && (userEnabled ?? true),\n  });\n}\n\n/**\n * Suspense variant of {@link useConfidentialIsApproved}.\n * Suspends rendering until the approval check resolves.\n *\n * @param config - Token address, spender, and optional holder to check.\n * @returns Suspense query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isApproved } = useConfidentialIsApprovedSuspense({\n *   tokenAddress: \"0xToken\",\n *   spender: \"0xSpender\",\n *   holder: \"0xHolder\", // optional\n * });\n * ```\n */\nexport function useConfidentialIsApprovedSuspense(config: UseConfidentialIsApprovedSuspenseConfig) {\n  const { spender, holder, ...tokenConfig } = config;\n  const token = useToken(tokenConfig);\n  const addressQuery = useSuspenseQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n  const resolvedHolder = holder ?? addressQuery.data;\n\n  return useSuspenseQuery<boolean>({\n    ...confidentialIsApprovedQueryOptions(token.signer, token.address, {\n      holder: resolvedHolder,\n      spender,\n    }),\n  });\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport { shieldMutationOptions, type ShieldParams } from \"@zama-fhe/sdk/query\";\nimport { optimisticBalanceCallbacks } from \"./optimistic-balance-update\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/** Configuration for {@link useShield}. */\nexport interface UseShieldConfig extends UseZamaConfig {\n  /**\n   * When `true`, optimistically adds the wrap amount to the cached confidential balance\n   * before the transaction confirms. Rolls back on error.\n   * @defaultValue false\n   */\n  optimistic?: boolean;\n}\n\n/**\n * Shield public ERC-20 tokens into confidential tokens.\n * Handles ERC-20 approval automatically. Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link ApprovalFailedError} — ERC-20 approval transaction failed\n * - {@link TransactionRevertedError} — shield transaction reverted\n *\n * @param config - Token and wrapper addresses.\n *   Set `optimistic: true` to add the amount to the cached balance immediately.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const shield = useShield({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\", optimistic: true });\n * shield.mutate({ amount: 1000n });\n * ```\n */\nexport function useShield<TContext = unknown>(\n  config: UseShieldConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ShieldParams, TContext>,\n): UseMutationResult<TransactionResult, Error, ShieldParams, TContext> {\n  const token = useToken(config);\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    ...shieldMutationOptions(token),\n    ...options,\n    ...optimisticBalanceCallbacks({\n      optimistic: config.optimistic,\n      tokenAddress: config.tokenAddress,\n      queryClient,\n      options,\n    }),\n  }) as UseMutationResult<TransactionResult, Error, ShieldParams, TContext>;\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport { shieldETHMutationOptions, type ShieldETHParams } from \"@zama-fhe/sdk/query\";\nimport { optimisticBalanceCallbacks } from \"./optimistic-balance-update\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/** Configuration for {@link useShieldETH}. */\nexport interface UseShieldETHConfig extends UseZamaConfig {\n  /**\n   * When `true`, optimistically adds the wrap amount to the cached confidential balance\n   * before the transaction confirms. Rolls back on error.\n   * @defaultValue false\n   */\n  optimistic?: boolean;\n}\n\n/**\n * Shield native ETH into confidential tokens.\n * Handles wrapping automatically. Invalidates balance caches on success.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — shield transaction reverted\n *\n * @param config - Token and wrapper addresses.\n *   Set `optimistic: true` to add the amount to the cached balance immediately.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const shieldETH = useShieldETH({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\", optimistic: true });\n * shieldETH.mutate({ amount: 1000000000000000000n }); // 1 ETH\n * ```\n */\nexport function useShieldETH<TContext = unknown>(\n  config: UseShieldETHConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ShieldETHParams, TContext>,\n): UseMutationResult<TransactionResult, Error, ShieldETHParams, TContext> {\n  const token = useToken(config);\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    ...shieldETHMutationOptions(token),\n    ...options,\n    ...optimisticBalanceCallbacks({\n      optimistic: config.optimistic,\n      tokenAddress: config.tokenAddress,\n      queryClient,\n      options,\n    }),\n  }) as UseMutationResult<TransactionResult, Error, ShieldETHParams, TContext>;\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnwrap,\n  type UnwrapParams,\n  unwrapMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Request an unwrap for a specific amount. Encrypts the amount first.\n * Call {@link useFinalizeUnwrap} after the request is processed on-chain,\n * or use {@link useUnshield} for a single-call orchestration.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption of the unwrap amount failed\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unwrap = useUnwrap({ tokenAddress: \"0x...\" });\n * unwrap.mutate({ amount: 500n });\n * ```\n */\nexport function useUnwrap(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, UnwrapParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, UnwrapParams, Address>({\n    ...unwrapMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnwrap(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport { invalidateAfterUnwrap, unwrapAllMutationOptions } from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Request an unwrap for the entire confidential balance.\n * Uses the on-chain balance handle directly (no encryption needed).\n * Call {@link useFinalizeUnwrap} after processing, or use {@link useUnshieldAll} for single-call orchestration.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unwrapAll = useUnwrapAll({ tokenAddress: \"0x...\" });\n * unwrapAll.mutate();\n * ```\n */\nexport function useUnwrapAll(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, void, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, void, Address>({\n    ...unwrapAllMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnwrap(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  finalizeUnwrapMutationOptions,\n  invalidateAfterUnshield,\n  type FinalizeUnwrapParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Complete an unwrap by providing the public decryption proof.\n * Call this after an unwrap request has been processed on-chain.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link DecryptionFailedError} — public decryption of the burn amount failed\n * - {@link TransactionRevertedError} — on-chain finalize transaction reverted\n *\n * @param config - Token address (and optional wrapper) identifying the token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const finalize = useFinalizeUnwrap({ tokenAddress: \"0x...\" });\n * finalize.mutate({ burnAmountHandle: event.encryptedAmount });\n * ```\n */\nexport function useFinalizeUnwrap(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, FinalizeUnwrapParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, FinalizeUnwrapParams, Address>({\n    ...finalizeUnwrapMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnshield,\n  type UnshieldParams,\n  unshieldMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Unshield a specific amount and finalize in one call.\n * Orchestrates: unwrap → wait for receipt → parse event → finalize.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link EncryptionFailedError} — FHE encryption failed during unwrap\n * - {@link DecryptionFailedError} — public decryption failed during finalize\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unshield = useUnshield({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * unshield.mutate({ amount: 500n });\n * ```\n */\nexport function useUnshield(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, UnshieldParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, UnshieldParams, Address>({\n    ...unshieldMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnshield,\n  type UnshieldAllParams,\n  unshieldAllMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Unshield the entire balance and finalize in one call.\n * Orchestrates: unwrapAll → wait for receipt → parse event → finalize.\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link DecryptionFailedError} — public decryption failed during finalize\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const unshieldAll = useUnshieldAll({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * unshieldAll.mutate();\n * ```\n */\nexport function useUnshieldAll(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, UnshieldAllParams | void, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, UnshieldAllParams | void, Address>({\n    ...unshieldAllMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  invalidateAfterUnshield,\n  type ResumeUnshieldParams,\n  resumeUnshieldMutationOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Resume an interrupted unshield from an existing unwrap tx hash.\n * Useful when the user submitted the unwrap but the finalize step was\n * interrupted (e.g. page reload, network error).\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link DecryptionFailedError} — public decryption failed during finalize\n * - {@link TransactionRevertedError} — on-chain transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const resumeUnshield = useResumeUnshield({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * resumeUnshield.mutate({ unwrapTxHash: \"0xabc...\" });\n * ```\n */\nexport function useResumeUnshield(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ResumeUnshieldParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ResumeUnshieldParams, Address>({\n    ...resumeUnshieldMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterUnshield(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { signerAddressQueryOptions, underlyingAllowanceQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { underlyingAllowanceQueryOptions };\n\n/** Configuration for {@link useUnderlyingAllowance}. */\nexport interface UseUnderlyingAllowanceConfig {\n  /** Address of the confidential token contract used to scope the query cache. */\n  tokenAddress: Address;\n  /** Address of the wrapper contract whose underlying ERC-20 allowance is checked. */\n  wrapperAddress: Address;\n}\n\n/**\n * Read the underlying ERC-20 allowance granted to the wrapper contract.\n * Useful to check if an approval is needed before shielding.\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (current allowance).\n *\n * @example\n * ```tsx\n * const { data: allowance } = useUnderlyingAllowance({\n *   tokenAddress: \"0xConfidentialToken\",\n *   wrapperAddress: \"0xWrapper\",\n * });\n * ```\n */\nexport function useUnderlyingAllowance(\n  config: UseUnderlyingAllowanceConfig,\n  options?: Omit<UseQueryOptions<bigint>, \"queryKey\" | \"queryFn\">,\n) {\n  const { tokenAddress, wrapperAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n  const addressQuery = useQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n  const owner = addressQuery.data;\n\n  const baseOpts = underlyingAllowanceQueryOptions(token.signer, tokenAddress, {\n    owner,\n    wrapperAddress,\n  });\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Suspense variant of {@link useUnderlyingAllowance}.\n * Suspends rendering until the allowance is loaded.\n *\n * @param config - Token and wrapper addresses.\n * @returns Suspense query result with `data: bigint`.\n *\n * @example\n * ```tsx\n * const { data: allowance } = useUnderlyingAllowanceSuspense({\n *   tokenAddress: \"0xConfidentialToken\",\n *   wrapperAddress: \"0xWrapper\",\n * });\n * ```\n */\nexport function useUnderlyingAllowanceSuspense(config: UseUnderlyingAllowanceConfig) {\n  const { tokenAddress, wrapperAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n  const addressQuery = useSuspenseQuery<Address>({\n    ...signerAddressQueryOptions(token.signer),\n  });\n  const owner = addressQuery.data;\n\n  return useSuspenseQuery<bigint>({\n    ...underlyingAllowanceQueryOptions(token.signer, tokenAddress, {\n      owner,\n      wrapperAddress,\n    }),\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport { skipToken, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { wrapperDiscoveryQueryOptions, zamaQueryKeys } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { wrapperDiscoveryQueryOptions };\n\n/** Configuration for {@link useWrapperDiscovery}. */\nexport interface UseWrapperDiscoveryConfig {\n  /** Address of the underlying ERC-20 token. */\n  tokenAddress: Address;\n  /** Address of the wrapper coordinator. Pass `undefined` to disable the query. */\n  coordinatorAddress: Address | undefined;\n}\n\n/** Configuration for {@link useWrapperDiscoverySuspense}. */\nexport interface UseWrapperDiscoverySuspenseConfig {\n  /** Address of the underlying ERC-20 token. */\n  tokenAddress: Address;\n  /** Address of the wrapper coordinator. */\n  coordinatorAddress: Address;\n}\n\n/**\n * Discover the wrapper contract for an ERC-20 token.\n * Returns the wrapper address if one exists, or `null` if not.\n * Cached indefinitely since wrapper mappings are immutable.\n *\n * @param config - Token and coordinator addresses.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: Address | null`.\n *\n * @example\n * ```tsx\n * const { data: wrapperAddress } = useWrapperDiscovery({\n *   tokenAddress: \"0xUnderlying\",\n *   coordinatorAddress: \"0xCoordinator\",\n * });\n * ```\n */\nexport function useWrapperDiscovery(\n  config: UseWrapperDiscoveryConfig,\n  options?: Omit<UseQueryOptions<Address | null>, \"queryKey\" | \"queryFn\">,\n) {\n  const { tokenAddress, coordinatorAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<Address | null>({\n    ...(coordinatorAddress\n      ? wrapperDiscoveryQueryOptions(token.signer, tokenAddress, { coordinatorAddress })\n      : {\n          queryKey: zamaQueryKeys.wrapperDiscovery.all,\n          queryFn: skipToken,\n        }),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useWrapperDiscovery}.\n * Suspends rendering until the wrapper address is resolved.\n *\n * @param config - Token and coordinator addresses.\n * @returns Suspense query result with `data: Address | null`.\n *\n * @example\n * ```tsx\n * const { data: wrapperAddress } = useWrapperDiscoverySuspense({\n *   tokenAddress: \"0xUnderlying\",\n *   coordinatorAddress: \"0xCoordinator\",\n * });\n * ```\n */\nexport function useWrapperDiscoverySuspense(config: UseWrapperDiscoverySuspenseConfig) {\n  const { tokenAddress, coordinatorAddress } = config;\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<Address | null>({\n    ...wrapperDiscoveryQueryOptions(token.signer, tokenAddress, { coordinatorAddress }),\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { tokenMetadataQueryOptions, type TokenMetadata } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { type TokenMetadata };\n\n/**\n * Read ERC-20 token metadata (name, symbol, decimals).\n * Fetches all three in parallel. Cached indefinitely since metadata is immutable.\n *\n * @param tokenAddress - Address of the token contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: TokenMetadata`.\n *\n * @example\n * ```tsx\n * const { data: metadata } = useMetadata(\"0xToken\");\n * // metadata?.name, metadata?.symbol, metadata?.decimals\n * ```\n */\nexport function useMetadata(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<TokenMetadata>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<TokenMetadata>({\n    ...tokenMetadataQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useMetadata}.\n * Suspends rendering until metadata is loaded.\n *\n * @param tokenAddress - Address of the token contract.\n * @returns Suspense query result with `data: TokenMetadata`.\n *\n * @example\n * ```tsx\n * const { data: metadata } = useMetadataSuspense(\"0xToken\");\n * ```\n */\nexport function useMetadataSuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<TokenMetadata>({\n    ...tokenMetadataQueryOptions(token.signer, tokenAddress),\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport type { Address, RawLog, ActivityLogMetadata, ActivityItem } from \"@zama-fhe/sdk\";\nimport { activityFeedQueryOptions, deriveActivityFeedLogsKey } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\n/** Configuration for {@link useActivityFeed}. */\nexport interface UseActivityFeedConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** Connected wallet address. Pass `undefined` to disable the query. */\n  userAddress: Address | undefined;\n  /** Raw event logs from the provider (viem, ethers, etc.). Pass `undefined` to disable. */\n  logs: readonly (RawLog & Partial<ActivityLogMetadata>)[] | undefined;\n  /** Whether to batch-decrypt encrypted transfer amounts. Default: `true`. */\n  decrypt?: boolean;\n}\n\n/**\n * Two-phase activity feed hook.\n * Phase 1: Instantly parses raw logs into classified {@link ActivityItem}s (sync, cheap).\n * Phase 2: Batch-decrypts encrypted transfer amounts via the relayer (async).\n *\n * The wallet provides logs (from its own provider — viem, ethers, etc.)\n * and this hook normalizes + decrypts them.\n *\n * @param config - Token address, user address, raw logs, and decrypt option.\n * @returns Query result with `data: ActivityItem[]`.\n *\n * @example\n * ```tsx\n * const { data: activity } = useActivityFeed({\n *   tokenAddress: \"0xToken\",\n *   userAddress: \"0xUser\",\n *   logs: rawLogs,\n * });\n * ```\n */\nexport function useActivityFeed(config: UseActivityFeedConfig) {\n  const { tokenAddress, userAddress, logs, decrypt: decryptOpt } = config;\n  const token = useReadonlyToken(tokenAddress);\n  const decrypt = decryptOpt ?? true;\n  const logsKey = deriveActivityFeedLogsKey(logs);\n\n  return useQuery<ActivityItem[]>({\n    ...activityFeedQueryOptions(token, {\n      userAddress,\n      logs,\n      decrypt,\n      logsKey,\n    }),\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  delegateDecryptionMutationOptions,\n  zamaQueryKeys,\n  type DelegateDecryptionParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Delegate FHE decryption rights for a token to another address via the on-chain ACL.\n *\n * @param config - Token address identifying the confidential token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const delegate = useDelegateDecryption({ tokenAddress: \"0x...\" });\n * delegate.mutate({ delegateAddress: \"0xDelegate\" });\n * ```\n */\nexport function useDelegateDecryption(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, DelegateDecryptionParams>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, DelegateDecryptionParams>({\n    ...delegateDecryptionMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      context.client.invalidateQueries({ queryKey: zamaQueryKeys.delegationStatus.all });\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  revokeDelegationMutationOptions,\n  zamaQueryKeys,\n  type RevokeDelegationParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Revoke FHE decryption delegation for a token from a delegate address.\n *\n * @param config - Token address identifying the confidential token.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const revoke = useRevokeDelegation({ tokenAddress: \"0x...\" });\n * revoke.mutate({ delegateAddress: \"0xDelegate\" });\n * ```\n */\nexport function useRevokeDelegation(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, RevokeDelegationParams>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, RevokeDelegationParams>({\n    ...revokeDelegationMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      context.client.invalidateQueries({ queryKey: zamaQueryKeys.delegationStatus.all });\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n    },\n  });\n}\n","\"use client\";\n\nimport { skipToken, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  delegationStatusQueryOptions,\n  zamaQueryKeys,\n  type DelegationStatusData,\n} from \"@zama-fhe/sdk/query\";\nimport { useQuery } from \"../utils/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport interface UseDelegationStatusConfig {\n  /** Address of the confidential token contract. */\n  tokenAddress: Address;\n  /** The address that granted the delegation. */\n  delegatorAddress?: Address;\n  /** The address that received delegation rights. */\n  delegateAddress?: Address;\n}\n\n/**\n * Query delegation status between a delegator and delegate for a token.\n *\n * @param config - Token address, delegator, and delegate addresses.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns `{ isDelegated, expiryTimestamp, isLoading, error }`.\n *\n * @example\n * ```tsx\n * const { data } = useDelegationStatus({\n *   tokenAddress: \"0xToken\",\n *   delegatorAddress: \"0xDelegator\",\n *   delegateAddress: \"0xDelegate\",\n * });\n * // data?.isDelegated, data?.expiryTimestamp\n * ```\n */\nexport function useDelegationStatus(\n  config: UseDelegationStatusConfig,\n  options?: Omit<UseQueryOptions<DelegationStatusData, Error>, \"queryKey\" | \"queryFn\">,\n) {\n  const readonlyToken = useReadonlyToken(config.tokenAddress);\n\n  const enabled = Boolean(config.delegatorAddress && config.delegateAddress);\n  const baseOpts =\n    config.delegatorAddress && config.delegateAddress\n      ? delegationStatusQueryOptions(readonlyToken, {\n          delegatorAddress: config.delegatorAddress,\n          delegateAddress: config.delegateAddress,\n        })\n      : {\n          queryKey: zamaQueryKeys.delegationStatus.all,\n          queryFn: skipToken as unknown as () => Promise<DelegationStatusData>,\n        };\n\n  return useQuery<DelegationStatusData>({\n    ...baseOpts,\n    enabled,\n    ...options,\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { decryptBalanceAsMutationOptions, type DecryptBalanceAsParams } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\n/**\n * Decrypt another user's confidential balance as a delegate.\n *\n * @param tokenAddress - Address of the confidential token contract.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const decryptAs = useDecryptBalanceAs(\"0xToken\");\n * decryptAs.mutate({ delegatorAddress: \"0xDelegator\" });\n * // decryptAs.data => 1000n\n * ```\n */\nexport function useDecryptBalanceAs(\n  tokenAddress: Address,\n  options?: UseMutationOptions<bigint, Error, DecryptBalanceAsParams>,\n) {\n  const readonlyToken = useReadonlyToken(tokenAddress);\n\n  return useMutation<bigint, Error, DecryptBalanceAsParams>({\n    ...decryptBalanceAsMutationOptions(readonlyToken),\n    ...options,\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationOptions } from \"@tanstack/react-query\";\nimport { ReadonlyToken, type Address, type BatchDecryptAsOptions } from \"@zama-fhe/sdk\";\n\n/**\n * Batch decrypt confidential balances as a delegate across multiple tokens.\n *\n * @param tokens - ReadonlyToken instances to decrypt balances for.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const batchDecryptAs = useBatchDecryptBalancesAs(tokens);\n * batchDecryptAs.mutate({\n *   delegatorAddress: \"0xDelegator\",\n * });\n * // batchDecryptAs.data => Map { \"0xTokenA\" => 100n, \"0xTokenB\" => 200n }\n * ```\n */\nexport function useBatchDecryptBalancesAs(\n  tokens: ReadonlyToken[],\n  options?: UseMutationOptions<Map<Address, bigint>, Error, BatchDecryptAsOptions>,\n) {\n  return useMutation<Map<Address, bigint>, Error, BatchDecryptAsOptions>({\n    mutationKey: [\"zama.batchDecryptBalancesAs\", ...tokens.map((t) => t.address)] as const,\n    mutationFn: async (params) => ReadonlyToken.batchDecryptBalancesAs(tokens, params),\n    ...options,\n  });\n}\n","\"use client\";\n\nimport type { UseMutationOptions } from \"@tanstack/react-query\";\nimport { useMutation } from \"@tanstack/react-query\";\nimport type { Address, TransactionResult } from \"@zama-fhe/sdk\";\nimport {\n  approveUnderlyingMutationOptions,\n  invalidateAfterApproveUnderlying,\n  type ApproveUnderlyingParams,\n} from \"@zama-fhe/sdk/query\";\nimport { useToken, type UseZamaConfig } from \"./use-token\";\n\n/**\n * Approve the wrapper contract to spend the underlying ERC-20.\n * Defaults to max uint256. Resets to zero first if there's an existing\n * non-zero allowance (required by tokens like USDT).\n *\n * Errors are {@link ZamaError} subclasses — use `instanceof` to handle specific failures:\n * - {@link SigningRejectedError} — user rejected the wallet prompt\n * - {@link TransactionRevertedError} — approval transaction reverted\n *\n * @param config - Token and wrapper addresses.\n * @param options - React Query mutation options.\n *\n * @example\n * ```tsx\n * const approve = useApproveUnderlying({ tokenAddress: \"0x...\", wrapperAddress: \"0x...\" });\n * approve.mutate({}); // max approval\n * approve.mutate({ amount: 1000n }); // exact amount\n * ```\n */\nexport function useApproveUnderlying(\n  config: UseZamaConfig,\n  options?: UseMutationOptions<TransactionResult, Error, ApproveUnderlyingParams, Address>,\n) {\n  const token = useToken(config);\n\n  return useMutation<TransactionResult, Error, ApproveUnderlyingParams, Address>({\n    ...approveUnderlyingMutationOptions(token),\n    ...options,\n    onSuccess: (data, variables, onMutateResult, context) => {\n      options?.onSuccess?.(data, variables, onMutateResult, context);\n      invalidateAfterApproveUnderlying(context.client, config.tokenAddress);\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { isConfidentialQueryOptions, isWrapperQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { isConfidentialQueryOptions, isWrapperQueryOptions };\n\n/**\n * Check if a token supports the ERC-7984 confidential interface via ERC-165.\n * Result is cached indefinitely since interface support does not change.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isConfidential } = useIsConfidential(\"0xToken\");\n * ```\n */\nexport function useIsConfidential(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<boolean>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<boolean>({\n    ...isConfidentialQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useIsConfidential}.\n * Suspends rendering until the ERC-165 check resolves.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @returns Suspense query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isConfidential } = useIsConfidentialSuspense(\"0xToken\");\n * ```\n */\nexport function useIsConfidentialSuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<boolean>({\n    ...isConfidentialQueryOptions(token.signer, tokenAddress),\n  });\n}\n\n/**\n * Check if a token supports the ERC-7984 wrapper interface via ERC-165.\n * Result is cached indefinitely since interface support does not change.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isWrapper } = useIsWrapper(\"0xToken\");\n * ```\n */\nexport function useIsWrapper(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<boolean>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<boolean>({\n    ...isWrapperQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useIsWrapper}.\n * Suspends rendering until the ERC-165 check resolves.\n *\n * @param tokenAddress - Address of the token contract to check.\n * @returns Suspense query result with `data: boolean`.\n *\n * @example\n * ```tsx\n * const { data: isWrapper } = useIsWrapperSuspense(\"0xToken\");\n * ```\n */\nexport function useIsWrapperSuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<boolean>({\n    ...isWrapperQueryOptions(token.signer, tokenAddress),\n  });\n}\n","\"use client\";\n\nimport { useQuery, useSuspenseQuery } from \"../utils/query\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport { totalSupplyQueryOptions } from \"@zama-fhe/sdk/query\";\nimport { useReadonlyToken } from \"./use-readonly-token\";\n\nexport { totalSupplyQueryOptions };\n\n/**\n * Read the total supply of a token.\n * Stale after 30 seconds to balance freshness and RPC cost.\n *\n * @param tokenAddress - Address of the token contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint`.\n *\n * @example\n * ```tsx\n * const { data: totalSupply } = useTotalSupply(\"0xToken\");\n * ```\n */\nexport function useTotalSupply(\n  tokenAddress: Address,\n  options?: Omit<UseQueryOptions<bigint>, \"queryKey\" | \"queryFn\">,\n) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useQuery<bigint>({\n    ...totalSupplyQueryOptions(token.signer, tokenAddress),\n    ...options,\n  });\n}\n\n/**\n * Suspense variant of {@link useTotalSupply}.\n * Suspends rendering until the total supply is loaded.\n *\n * @param tokenAddress - Address of the token contract.\n * @returns Suspense query result with `data: bigint`.\n *\n * @example\n * ```tsx\n * const { data: totalSupply } = useTotalSupplySuspense(\"0xToken\");\n * ```\n */\nexport function useTotalSupplySuspense(tokenAddress: Address) {\n  const token = useReadonlyToken(tokenAddress);\n\n  return useSuspenseQuery<bigint>({\n    ...totalSupplyQueryOptions(token.signer, tokenAddress),\n  });\n}\n","\"use client\";\n\nimport { useQuery } from \"../utils/query\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { Address } from \"@zama-fhe/sdk\";\nimport {\n  batchTransferFeeQueryOptions,\n  feeRecipientQueryOptions,\n  shieldFeeQueryOptions,\n  unshieldFeeQueryOptions,\n} from \"@zama-fhe/sdk/query\";\nimport { useZamaSDK } from \"../provider\";\n\nexport {\n  batchTransferFeeQueryOptions,\n  feeRecipientQueryOptions,\n  shieldFeeQueryOptions,\n  unshieldFeeQueryOptions,\n};\n\n/** Configuration for {@link useShieldFee} and {@link useUnshieldFee}. */\nexport interface UseFeeConfig {\n  /** Address of the fee manager contract. */\n  feeManagerAddress: Address;\n  /** Amount to calculate the fee for. */\n  amount: bigint;\n  /** Sender address. */\n  from: Address;\n  /** Receiver address. */\n  to: Address;\n}\n\n/**\n * Read the shield fee for a given amount and address pair.\n *\n * @param config - Fee manager address, amount, from, and to.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (the fee amount).\n *\n * @example\n * ```tsx\n * const { data: fee } = useShieldFee({\n *   feeManagerAddress: \"0xFeeManager\",\n *   amount: 1000n,\n *   from: \"0xSender\",\n *   to: \"0xReceiver\",\n * });\n * ```\n */\nexport function useShieldFee(\n  config: UseFeeConfig,\n  options?: Omit<UseQueryOptions<bigint>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = shieldFeeQueryOptions(sdk.signer, config);\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Read the unshield fee for a given amount and address pair.\n *\n * @param config - Fee manager address, amount, from, and to.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (the fee amount).\n *\n * @example\n * ```tsx\n * const { data: fee } = useUnshieldFee({\n *   feeManagerAddress: \"0xFeeManager\",\n *   amount: 1000n,\n *   from: \"0xSender\",\n *   to: \"0xReceiver\",\n * });\n * ```\n */\nexport function useUnshieldFee(\n  config: UseFeeConfig,\n  options?: Omit<UseQueryOptions<bigint>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = unshieldFeeQueryOptions(sdk.signer, config);\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Read the batch transfer fee from the fee manager.\n *\n * @param feeManagerAddress - Address of the fee manager contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: bigint` (the fee amount).\n *\n * @example\n * ```tsx\n * const { data: fee } = useBatchTransferFee(\"0xFeeManager\");\n * ```\n */\nexport function useBatchTransferFee(\n  feeManagerAddress: Address,\n  options?: Omit<UseQueryOptions<bigint>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = batchTransferFeeQueryOptions(sdk.signer, feeManagerAddress);\n\n  return useQuery<bigint>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n\n/**\n * Read the fee recipient address from the fee manager.\n *\n * @param feeManagerAddress - Address of the fee manager contract.\n * @param options - React Query options (forwarded to `useQuery`).\n * @returns Query result with `data: Address` (the fee recipient).\n *\n * @example\n * ```tsx\n * const { data: recipient } = useFeeRecipient(\"0xFeeManager\");\n * ```\n */\nexport function useFeeRecipient(\n  feeManagerAddress: Address,\n  options?: Omit<UseQueryOptions<Address>, \"queryKey\" | \"queryFn\">,\n) {\n  const sdk = useZamaSDK();\n  const baseOpts = feeRecipientQueryOptions(sdk.signer, feeManagerAddress);\n\n  return useQuery<Address>({\n    ...baseOpts,\n    ...options,\n    enabled: (baseOpts.enabled ?? true) && (options?.enabled ?? true),\n  });\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zama-fhe/react-sdk",
-  "version": "1.2.0-alpha.3",
+  "version": "1.2.0-alpha.5",
   "description": "React hooks for Zama SDK",
   "license": "BSD-3-Clause-Clear",
   "author": "Zama",
@@ -54,12 +54,12 @@
   "devDependencies": {
     "@zama-fhe/sdk": "workspace:*",
     "rolldown": "1.0.0-rc.7",
-    "rolldown-plugin-dts": "^0.22.4",
-    "viem": "^2.47.1"
+    "rolldown-plugin-dts": "^0.22.5",
+    "viem": "^2.47.4"
   },
   "peerDependencies": {
     "@tanstack/react-query": ">=5",
-    "@zama-fhe/sdk": "^1.2.0-alpha.3",
+    "@zama-fhe/sdk": "^1.2.0-alpha.5",
     "react": ">=18",
     "viem": "^2.47.0",
     "wagmi": ">=2"