@zama-fhe/react-sdk 1.0.0-alpha.13 → 1.0.0-alpha.15

package/dist/index.d.ts

@@ -1,11 +1,14 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _zama_fhe_sdk from '@zama-fhe/sdk';
-import { RelayerSDK, GenericSigner, GenericStorage, ZamaSDKEventListener, ZamaSDK, EncryptParams, EncryptResult, DecryptedValue, UserDecryptParams, PublicDecryptResult, FHEKeypair, EIP712TypedData, Address, DelegatedUserDecryptParams, ZKProofLike, Hex, TransferCallbacks, Token, TransactionResult, ShieldCallbacks, UnshieldCallbacks, ReadonlyToken, RawLog, ActivityLogMetadata, ActivityItem } from '@zama-fhe/sdk';
-export { ActivityAmount, ActivityDirection, ActivityItem, ActivityLogMetadata, ActivityType, Address, ApprovalFailedError, ApproveSubmittedEvent, ApproveUnderlyingSubmittedEvent, BATCH_SWAP_ABI, BaseEvent, BatchDecryptOptions, BatchTransferData, ChromeSessionStorage, ConfidentialTransferEvent, ContractCallConfig, CredentialsAllowedEvent, CredentialsCachedEvent, CredentialsCreatedEvent, CredentialsCreatingEvent, CredentialsExpiredEvent, CredentialsLoadingEvent, CredentialsManager, CredentialsManagerConfig, CredentialsRevokedEvent, DEPLOYMENT_COORDINATOR_ABI, DecryptEndEvent, DecryptErrorEvent, DecryptStartEvent, DecryptedValue, DecryptionFailedError, DelegatedUserDecryptParams, EIP712TypedData, ENCRYPTION_ABI, ERC165_ABI, ERC20_ABI, ERC20_METADATA_ABI, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, EncryptEndEvent, EncryptErrorEvent, EncryptInput, EncryptParams, EncryptResult, EncryptStartEvent, EncryptionFailedError, FEE_MANAGER_ABI, FHEKeypair, FheType, FhevmInstanceConfig, FinalizeUnwrapSubmittedEvent, GenericSigner, GenericStorage, HardhatConfig, Hex, IndexedDBStorage, InputProofBytesType, InvalidKeypairError, KeypairExpiredError, KmsDelegatedUserDecryptEIP712Type, MainnetConfig, MemoryStorage, NetworkType, NoCiphertextError, OnChainEvent, PublicDecryptResult, RawLog, ReadonlyToken, ReadonlyTokenConfig, RelayerRequestFailedError, RelayerSDK, RelayerSDKStatus, RelayerWeb, RelayerWebConfig, RelayerWebSecurityConfig, SepoliaConfig, SessionExpiredEvent, ShieldCallbacks, ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, StoredCredentials, TOKEN_TOPICS, TRANSFER_BATCHER_ABI, Token, TokenConfig, Topics, TransactionErrorEvent, TransactionReceipt, TransactionResult, TransactionRevertedError, TransferCallbacks, TransferFromSubmittedEvent, TransferSubmittedEvent, UnshieldCallbacks, UnshieldPhase1SubmittedEvent, UnshieldPhase2StartedEvent, UnshieldPhase2SubmittedEvent, UnwrapRequestedEvent, UnwrapSubmittedEvent, UnwrappedFinalizedEvent, UnwrappedStartedEvent, UserDecryptParams, WRAPPER_ABI, WrappedEvent, ZERO_HANDLE, ZKProofLike, ZamaError, ZamaErrorCode, ZamaSDK, ZamaSDKConfig, ZamaSDKEvent, ZamaSDKEventInput, ZamaSDKEventListener, ZamaSDKEventType, ZamaSDKEvents, allowanceContract, applyDecryptedValues, approveContract, balanceOfContract, chromeSessionStorage, clearPendingUnshield, confidentialBalanceOfContract, confidentialBatchTransferContract, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, decimalsContract, decodeConfidentialTransfer, decodeOnChainEvent, decodeOnChainEvents, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, deploymentCoordinatorContract, extractEncryptedHandles, finalizeUnwrapContract, findUnwrapRequested, findWrapped, getBatchTransferFeeContract, getFeeRecipientContract, getUnwrapFeeContract, getWrapFeeContract, getWrapperContract, indexedDBStorage, isConfidentialTokenContract, isConfidentialWrapperContract, isFinalizeUnwrapOperatorContract, isOperatorContract, loadPendingUnshield, matchZamaError, nameContract, parseActivityFeed, rateContract, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, sortByBlockNumber, supportsInterfaceContract, symbolContract, totalSupplyContract, underlyingContract, unwrapContract, unwrapFromBalanceContract, wrapContract, wrapETHContract, wrapperExistsContract } from '@zama-fhe/sdk';
+import { RelayerSDK, GenericSigner, GenericStorage, ZamaSDKEventListener, ZamaSDK, EncryptResult, EncryptParams, ClearValueType, UserDecryptParams, PublicDecryptResult, KeypairType, EIP712TypedData, Address, DelegatedUserDecryptParams, ZKProofLike, Handle, Hex, TransactionResult, RawLog, ActivityLogMetadata, ActivityItem } from '@zama-fhe/sdk';
+export { ActivityAmount, ActivityDirection, ActivityItem, ActivityLogMetadata, ActivityType, Address, ApprovalFailedError, ApproveSubmittedEvent, ApproveUnderlyingSubmittedEvent, BATCH_SWAP_ABI, BaseEvent, BatchDecryptOptions, BatchTransferData, ChromeSessionStorage, ClearValueType, ConfidentialTransferEvent, ContractAbi, CredentialsAllowedEvent, CredentialsCachedEvent, CredentialsCreatedEvent, CredentialsCreatingEvent, CredentialsExpiredEvent, CredentialsLoadingEvent, CredentialsManager, CredentialsManagerConfig, CredentialsRevokedEvent, DEPLOYMENT_COORDINATOR_ABI, DecryptEndEvent, DecryptErrorEvent, DecryptStartEvent, DecryptionFailedError, DelegatedUserDecryptParams, EIP712TypedData, ENCRYPTION_ABI, ERC165_ABI, ERC20_ABI, ERC20_METADATA_ABI, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, EncryptEndEvent, EncryptErrorEvent, EncryptInput, EncryptParams, EncryptResult, EncryptStartEvent, EncryptionFailedError, FEE_MANAGER_ABI, FheTypeName, FhevmInstanceConfig, FinalizeUnwrapSubmittedEvent, GenericSigner, GenericStorage, Handle, HardhatConfig, Hex, IndexedDBStorage, InputProofBytesType, InvalidKeypairError, KeypairExpiredError, KeypairType, KmsDelegatedUserDecryptEIP712Type, MainnetConfig, MemoryStorage, NetworkType, NoCiphertextError, OnChainEvent, PublicDecryptResult, RawLog, ReadContractArgs, ReadContractConfig, ReadContractReturnType, ReadFunctionName, ReadonlyToken, ReadonlyTokenConfig, RelayerRequestFailedError, RelayerSDK, RelayerSDKStatus, RelayerWeb, RelayerWebConfig, RelayerWebSecurityConfig, SepoliaConfig, SessionExpiredEvent, ShieldCallbacks, ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, StoredCredentials, TOKEN_TOPICS, TRANSFER_BATCHER_ABI, Token, TokenConfig, Topics, TransactionErrorEvent, TransactionReceipt, TransactionResult, TransactionRevertedError, TransferCallbacks, TransferFromSubmittedEvent, TransferSubmittedEvent, UnshieldCallbacks, UnshieldPhase1SubmittedEvent, UnshieldPhase2StartedEvent, UnshieldPhase2SubmittedEvent, UnwrapRequestedEvent, UnwrapSubmittedEvent, UnwrappedFinalizedEvent, UnwrappedStartedEvent, UserDecryptParams, WRAPPER_ABI, WrappedEvent, WriteContractArgs, WriteContractConfig, WriteFunctionName, ZERO_HANDLE, ZKProofLike, ZamaError, ZamaErrorCode, ZamaSDK, ZamaSDKConfig, ZamaSDKEvent, ZamaSDKEventInput, ZamaSDKEventListener, ZamaSDKEventType, ZamaSDKEvents, allowanceContract, applyDecryptedValues, approveContract, balanceOfContract, chromeSessionStorage, clearPendingUnshield, confidentialBalanceOfContract, confidentialBatchTransferContract, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, decimalsContract, decodeConfidentialTransfer, decodeOnChainEvent, decodeOnChainEvents, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, deploymentCoordinatorContract, extractEncryptedHandles, finalizeUnwrapContract, findUnwrapRequested, findWrapped, getBatchTransferFeeContract, getFeeRecipientContract, getUnwrapFeeContract, getWrapFeeContract, getWrapperContract, indexedDBStorage, isConfidentialTokenContract, isConfidentialWrapperContract, isFinalizeUnwrapOperatorContract, isOperatorContract, loadPendingUnshield, matchZamaError, nameContract, parseActivityFeed, rateContract, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, sortByBlockNumber, supportsInterfaceContract, symbolContract, totalSupplyContract, underlyingContract, unwrapContract, unwrapFromBalanceContract, wrapContract, wrapETHContract, wrapperExistsContract } from '@zama-fhe/sdk';
 import { PropsWithChildren } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseQueryOptions, UseMutationOptions, UseQueryResult, UseSuspenseQueryResult } from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions, QueryKey } from '@tanstack/react-query';
 import * as _zama_fhe_relayer_sdk_web from '@zama-fhe/relayer-sdk/web';
+import * as _tanstack_query_core from '@tanstack/query-core';
+import { ConfidentialBalancesData, ConfidentialTransferParams, ConfidentialTransferFromParams, ConfidentialApproveParams, ShieldParams, ShieldETHParams, UnwrapParams, FinalizeUnwrapParams, UnshieldParams, UnshieldAllParams, ResumeUnshieldParams, TokenMetadata, ApproveUnderlyingParams } from '@zama-fhe/sdk/query';
+export { ApproveUnderlyingParams, ConfidentialApproveParams, ConfidentialBalancesData, ConfidentialTransferFromParams, ConfidentialTransferParams, FinalizeUnwrapParams, ResumeUnshieldParams, ShieldETHParams, ShieldParams, TokenMetadata, UnshieldAllParams, UnshieldParams, UnwrapParams, activityFeedQueryOptions, allowMutationOptions, approveUnderlyingMutationOptions, batchTransferFeeQueryOptions, confidentialApproveMutationOptions, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialHandleQueryOptions, confidentialHandlesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, encryptMutationOptions, feeRecipientQueryOptions, filterQueryOptions, finalizeUnwrapMutationOptions, hashFn, isAllowedQueryOptions, isConfidentialQueryOptions, isWrapperQueryOptions, publicKeyQueryOptions, publicParamsQueryOptions, resumeUnshieldMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, shieldETHMutationOptions, shieldFeeQueryOptions, shieldMutationOptions, signerAddressQueryOptions, tokenMetadataQueryOptions, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, unshieldAllMutationOptions, unshieldFeeQueryOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapMutationOptions, wrapperDiscoveryQueryOptions, zamaQueryKeys } from '@zama-fhe/sdk/query';
 
 /** Props for {@link ZamaProvider}. */
 interface ZamaProviderProps extends PropsWithChildren {
@@ -58,16 +61,6 @@ declare function ZamaProvider({ children, relayer, signer, storage, sessionStora
  */
 declare function useZamaSDK(): ZamaSDK;
 
-/**
- * TanStack Query mutation options factory for FHE encrypt.
- *
- * @param sdk - A `ZamaSDK` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function encryptMutationOptions(sdk: ZamaSDK): {
-    mutationKey: readonly ["encrypt"];
-    mutationFn: (params: EncryptParams) => Promise<EncryptResult>;
-};
 /**
  * Encrypt a plaintext value using FHE.
  * Calls the relayer's `encrypt` method via a mutation.
@@ -91,7 +84,7 @@ declare function useEncrypt(): _tanstack_react_query.UseMutationResult<EncryptRe
  * On success, populates the decryption cache so useUserDecryptedValue/useUserDecryptedValues
  * can read the results.
  */
-declare function useUserDecrypt(): _tanstack_react_query.UseMutationResult<Record<string, DecryptedValue>, Error, UserDecryptParams, unknown>;
+declare function useUserDecrypt(): _tanstack_react_query.UseMutationResult<Record<`0x${string}`, ClearValueType>, Error, UserDecryptParams, unknown>;
 
 /**
  * Decrypt FHE ciphertext handles using the network public key (no credential needed).
@@ -107,7 +100,7 @@ declare function useUserDecrypt(): _tanstack_react_query.UseMutationResult<Recor
  * // publicDecrypt.data?.clearValues => { "0xHandle1": 500n, ... }
  * ```
  */
-declare function usePublicDecrypt(): _tanstack_react_query.UseMutationResult<PublicDecryptResult, Error, string[], unknown>;
+declare function usePublicDecrypt(): _tanstack_react_query.UseMutationResult<PublicDecryptResult, Error, `0x${string}`[], unknown>;
 
 /**
  * Generate an FHE keypair via the relayer.
@@ -122,7 +115,7 @@ declare function usePublicDecrypt(): _tanstack_react_query.UseMutationResult<Pub
  * // generateKeypair.data?.publicKey, generateKeypair.data?.privateKey
  * ```
  */
-declare function useGenerateKeypair(): _tanstack_react_query.UseMutationResult<FHEKeypair, Error, void, unknown>;
+declare function useGenerateKeypair(): _tanstack_react_query.UseMutationResult<KeypairType<string>, Error, void, unknown>;
 
 /** Parameters for {@link useCreateEIP712}. */
 interface CreateEIP712Params {
@@ -203,7 +196,7 @@ declare function useCreateDelegatedUserDecryptEIP712(): _tanstack_react_query.Us
  * // decrypt.data => { "0xHandle1": 1000n }
  * ```
  */
-declare function useDelegatedUserDecrypt(): _tanstack_react_query.UseMutationResult<Record<string, DecryptedValue>, Error, DelegatedUserDecryptParams, unknown>;
+declare function useDelegatedUserDecrypt(): _tanstack_react_query.UseMutationResult<Record<`0x${string}`, ClearValueType>, Error, DelegatedUserDecryptParams, unknown>;
 
 /**
  * Submit a ZK proof for on-chain verification.
@@ -223,14 +216,6 @@ declare function useRequestZKProofVerification(): _tanstack_react_query.UseMutat
     inputProof: Uint8Array;
 }>, Error, ZKProofLike, unknown>;
 
-/**
- * Query key factory for the FHE public key query.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const publicKeyQueryKeys: {
-    /** Match the public key query. */
-    readonly all: readonly ["publicKey"];
-};
 /** Shape of the FHE public key data returned by the relayer. */
 interface PublicKeyData {
     /** Unique identifier for this public key version. */
@@ -238,18 +223,6 @@ interface PublicKeyData {
     /** The raw FHE public key bytes. */
     publicKey: Uint8Array;
 }
-type PublicKeyResult = PublicKeyData | null;
-/**
- * TanStack Query options factory for the FHE public key.
- *
- * @param sdk - A `ZamaSDK` instance.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function publicKeyQueryOptions(sdk: ZamaSDK): {
-    readonly queryKey: readonly ["publicKey"];
-    readonly queryFn: () => Promise<PublicKeyResult>;
-    readonly staleTime: number;
-};
 /**
  * Fetch the FHE network public key from the relayer.
  * Cached indefinitely since the key does not change during a session.
@@ -262,18 +235,11 @@ declare function publicKeyQueryOptions(sdk: ZamaSDK): {
  * // publicKey?.publicKeyId, publicKey?.publicKey
  * ```
  */
-declare function usePublicKey(): _tanstack_react_query.UseQueryResult<PublicKeyResult, Error>;
+declare function usePublicKey(): _tanstack_react_query.UseQueryResult<{
+    publicKeyId: string;
+    publicKey: Uint8Array;
+} | null, Error>;
 
-/**
- * Query key factory for FHE public params queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const publicParamsQueryKeys: {
-    /** Match all public params queries. */
-    readonly all: readonly ["publicParams"];
-    /** Match public params query for a specific bit size. */
-    readonly bits: (bits: number) => readonly ["publicParams", number];
-};
 /** Shape of the FHE public parameters returned by the relayer. */
 interface PublicParamsData {
     /** The raw public parameters bytes (WASM-ready). */
@@ -281,19 +247,6 @@ interface PublicParamsData {
     /** Unique identifier for this public params version. */
     publicParamsId: string;
 }
-type PublicParamsResult = PublicParamsData | null;
-/**
- * TanStack Query options factory for FHE public parameters.
- *
- * @param sdk - A `ZamaSDK` instance.
- * @param bits - The FHE bit size to fetch parameters for (e.g. 2048).
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function publicParamsQueryOptions(sdk: ZamaSDK, bits: number): {
-    readonly queryKey: readonly ["publicParams", number];
-    readonly queryFn: () => Promise<PublicParamsResult>;
-    readonly staleTime: number;
-};
 /**
  * Fetch FHE public parameters for a given bit size from the relayer.
  * Cached indefinitely since parameters do not change during a session.
@@ -307,11 +260,14 @@ declare function publicParamsQueryOptions(sdk: ZamaSDK, bits: number): {
  * // params?.publicParams, params?.publicParamsId
  * ```
  */
-declare function usePublicParams(bits: number): _tanstack_react_query.UseQueryResult<PublicParamsResult, Error>;
+declare function usePublicParams(bits: number): _tanstack_react_query.UseQueryResult<{
+    publicParams: Uint8Array;
+    publicParamsId: string;
+} | null, Error>;
 
 /** A handle to decrypt, paired with its originating contract address. */
 interface DecryptHandle {
-    handle: string;
+    handle: Handle;
     contractAddress: Address;
 }
 /** Parameters for {@link useUserDecryptFlow}. */
@@ -330,7 +286,7 @@ interface UserDecryptFlowCallbacks {
     /** Fired after the wallet signature is obtained. */
     onSigned?: (signature: Hex) => void;
     /** Fired after decryption completes. */
-    onDecrypted?: (values: Record<string, DecryptedValue>) => void;
+    onDecrypted?: (values: Record<Handle, ClearValueType>) => void;
 }
 /** Configuration for {@link useUserDecryptFlow}. */
 interface UseUserDecryptFlowConfig {
@@ -358,21 +314,21 @@ interface UseUserDecryptFlowConfig {
  * });
  * ```
  */
-declare function useUserDecryptFlow(config?: UseUserDecryptFlowConfig): _tanstack_react_query.UseMutationResult<Record<string, DecryptedValue>, Error, UserDecryptFlowParams, unknown>;
+declare function useUserDecryptFlow(config?: UseUserDecryptFlowConfig): _tanstack_react_query.UseMutationResult<Record<`0x${string}`, ClearValueType>, Error, UserDecryptFlowParams, unknown>;
 
 /**
  * Look up a single cached decrypted value by its handle.
  * Values are populated automatically when useUserDecrypt or usePublicDecrypt succeed.
  * You can also populate manually via queryClient.setQueryData(decryptionKeys.value(handle), value).
  */
-declare function useUserDecryptedValue(handle: string | undefined): _tanstack_react_query.UseQueryResult<DecryptedValue, Error>;
+declare function useUserDecryptedValue(handle: Handle | undefined): _tanstack_react_query.UseQueryResult<ClearValueType, Error>;
 
 /**
  * Look up multiple cached decrypted values by their handles.
  * Values are populated automatically when useUserDecrypt or usePublicDecrypt succeed.
  */
-declare function useUserDecryptedValues(handles: string[]): {
-    data: Record<string, DecryptedValue | undefined>;
+declare function useUserDecryptedValues(handles: Handle[]): {
+    data: Partial<Record<`0x${string}`, ClearValueType | undefined>>;
     results: _tanstack_react_query.UseQueryResult<never, Error>[];
 };
 
@@ -382,7 +338,10 @@ declare function useUserDecryptedValues(handles: string[]): {
  * and by useUserDecryptedValue to read.
  */
 declare const decryptionKeys: {
-    value: (handle: string) => readonly ["decryptedValue", string];
+    value: (handle: string, contractAddress?: string) => readonly ["zama.decryption", {
+        readonly contractAddress?: `0x${string}` | undefined;
+        readonly handle: string;
+    }];
 };
 
 /** Base configuration shared by all mutation hooks that need a Token instance. */
@@ -472,8 +431,8 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<bigint, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<bigint>;
 } | {
     handleQuery: _tanstack_react_query.UseQueryResult<`0x${string}`, Error>;
@@ -500,8 +459,8 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<bigint, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<bigint>;
 } | {
     handleQuery: _tanstack_react_query.UseQueryResult<`0x${string}`, Error>;
@@ -528,8 +487,8 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<bigint, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<bigint>;
 } | {
     handleQuery: _tanstack_react_query.UseQueryResult<`0x${string}`, Error>;
@@ -556,8 +515,8 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<bigint, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<bigint>;
 } | {
     handleQuery: _tanstack_react_query.UseQueryResult<`0x${string}`, Error>;
@@ -584,8 +543,8 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<bigint, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<bigint>;
 } | {
     handleQuery: _tanstack_react_query.UseQueryResult<`0x${string}`, Error>;
@@ -612,8 +571,8 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<bigint, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<bigint>;
 };
 
@@ -626,15 +585,7 @@ interface UseConfidentialBalancesConfig {
     /** Maximum number of concurrent decrypt calls. Default: `Infinity` (no limit). */
     maxConcurrency?: number;
 }
-/** Result type for the decrypt phase of {@link useConfidentialBalances}. */
-interface ConfidentialBalancesData {
-    /** Successfully decrypted balances (address → balance). */
-    balances: Map<Address, bigint>;
-    /** Per-token errors for tokens that failed to decrypt. */
-    errors: Map<Address, Error>;
-    /** `true` if some but not all tokens failed. */
-    isPartialError: boolean;
-}
+
 /** Query options for the decrypt phase of {@link useConfidentialBalances}. */
 type UseConfidentialBalancesOptions = Omit<UseQueryOptions<ConfidentialBalancesData, Error>, "queryKey" | "queryFn">;
 /**
@@ -685,8 +636,8 @@ declare function useConfidentialBalances(config: UseConfidentialBalancesConfig,
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<ConfidentialBalancesData, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<ConfidentialBalancesData, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<ConfidentialBalancesData>;
 } | {
     handlesQuery: _tanstack_react_query.UseQueryResult<`0x${string}`[], Error>;
@@ -713,8 +664,8 @@ declare function useConfidentialBalances(config: UseConfidentialBalancesConfig,
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<ConfidentialBalancesData, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<ConfidentialBalancesData, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<ConfidentialBalancesData>;
 } | {
     handlesQuery: _tanstack_react_query.UseQueryResult<`0x${string}`[], Error>;
@@ -741,8 +692,8 @@ declare function useConfidentialBalances(config: UseConfidentialBalancesConfig,
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<ConfidentialBalancesData, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<ConfidentialBalancesData, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<ConfidentialBalancesData>;
 } | {
     handlesQuery: _tanstack_react_query.UseQueryResult<`0x${string}`[], Error>;
@@ -769,8 +720,8 @@ declare function useConfidentialBalances(config: UseConfidentialBalancesConfig,
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<ConfidentialBalancesData, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<ConfidentialBalancesData, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<ConfidentialBalancesData>;
 } | {
     handlesQuery: _tanstack_react_query.UseQueryResult<`0x${string}`[], Error>;
@@ -797,8 +748,8 @@ declare function useConfidentialBalances(config: UseConfidentialBalancesConfig,
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<ConfidentialBalancesData, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<ConfidentialBalancesData, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<ConfidentialBalancesData>;
 } | {
     handlesQuery: _tanstack_react_query.UseQueryResult<`0x${string}`[], Error>;
@@ -825,21 +776,11 @@ declare function useConfidentialBalances(config: UseConfidentialBalancesConfig,
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<ConfidentialBalancesData, Error>>;
-    fetchStatus: _tanstack_react_query.FetchStatus;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<ConfidentialBalancesData, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
     promise: Promise<ConfidentialBalancesData>;
 };
 
-/**
- * TanStack Query mutation options factory for token allow.
- *
- * @param sdk - A `ZamaSDK` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function allowMutationOptions(sdk: ZamaSDK): {
-    mutationKey: readonly ["allow"];
-    mutationFn: (tokenAddresses: Address[]) => Promise<void>;
-};
 /**
  * Pre-authorize FHE decrypt credentials for a list of token addresses.
  * A single wallet signature covers all addresses, so subsequent decrypt
@@ -851,15 +792,8 @@ declare function allowMutationOptions(sdk: ZamaSDK): {
  * // Call allow(allTokenAddresses) before any individual reveal
  * ```
  */
-declare function useAllow(): _tanstack_react_query.UseMutationResult<void, Error, `0x${string}`[], unknown>;
+declare function useAllow(options?: UseMutationOptions<void, Error, Address[]>): _tanstack_react_query.UseMutationResult<void, Error, `0x${string}`[], unknown>;
 
-declare const isAllowedQueryKeys: {
-    all: readonly ["zama", "isAllowed"];
-};
-declare function isAllowedQueryOptions(sdk: ZamaSDK): {
-    queryKey: readonly ["zama", "isAllowed"];
-    queryFn: () => Promise<boolean>;
-};
 /**
  * Check whether a session signature is cached for the connected wallet.
  * Returns `true` if decrypt operations can proceed without a wallet prompt.
@@ -869,25 +803,11 @@ declare function isAllowedQueryOptions(sdk: ZamaSDK): {
  * const { data: allowed } = useIsAllowed();
  * ```
  */
-declare function useIsAllowed(): _tanstack_react_query.UseQueryResult<boolean, Error>;
+declare function useIsAllowed(): _tanstack_react_query.UseQueryResult<unknown, Error>;
 
 /**
- * TanStack Query mutation options factory for token revoke.
- *
- * @param sdk - A `ZamaSDK` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function revokeMutationOptions(sdk: ZamaSDK): {
-    mutationKey: readonly ["revoke"];
-    mutationFn: (tokenAddresses: Address[]) => Promise<void>;
-};
-/**
- * Revoke the session signature for the connected wallet.
- * Stored credentials remain intact, but the next decrypt operation
- * will require a fresh wallet signature.
- *
- * The addresses are passed through to the `credentials:revoked` event
- * for observability.
+ * Revoke stored FHE credentials for a list of token addresses.
+ * The next decrypt operation will require a fresh wallet signature.
  *
  * @example
  * ```tsx
@@ -895,18 +815,8 @@ declare function revokeMutationOptions(sdk: ZamaSDK): {
  * revoke(["0xTokenA", "0xTokenB"]);
  * ```
  */
-declare function useRevoke(): _tanstack_react_query.UseMutationResult<void, Error, `0x${string}`[], unknown>;
+declare function useRevoke(options?: UseMutationOptions<void, Error, Address[]>): _tanstack_react_query.UseMutationResult<void, Error, `0x${string}`[], unknown>;
 
-/**
- * TanStack Query mutation options factory for session revoke.
- *
- * @param sdk - A `ZamaSDK` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function revokeSessionMutationOptions(sdk: ZamaSDK): {
-    mutationKey: readonly ["revokeSession"];
-    mutationFn: () => Promise<void>;
-};
 /**
  * Revoke the session signature for the connected wallet without
  * specifying contract addresses. Useful for wallet disconnect handlers.
@@ -917,17 +827,15 @@ declare function revokeSessionMutationOptions(sdk: ZamaSDK): {
  * revokeSession();
  * ```
  */
-declare function useRevokeSession(): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
+declare function useRevokeSession(options?: UseMutationOptions<void, Error, void>): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
 
-/** Parameters passed to the `mutate` function of {@link useConfidentialTransfer}. */
-interface ConfidentialTransferParams {
-    /** Recipient address. */
-    to: Address;
-    /** Amount to transfer (plaintext — encrypted automatically). */
-    amount: bigint;
-    /** Optional progress callbacks for the multi-step transfer flow. */
-    callbacks?: TransferCallbacks;
+type OptimisticBalanceSnapshot = Array<[QueryKey, bigint | undefined]>;
+/** Combined context returned by optimistic `onMutate`. */
+interface OptimisticMutateContext {
+    snapshot: OptimisticBalanceSnapshot;
+    callerContext?: unknown;
 }
+
 /** Configuration for {@link useConfidentialTransfer}. */
 interface UseConfidentialTransferConfig extends UseZamaConfig {
     /**
@@ -937,16 +845,6 @@ interface UseConfidentialTransferConfig extends UseZamaConfig {
      */
     optimistic?: boolean;
 }
-/**
- * TanStack Query mutation options factory for confidential transfer.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function confidentialTransferMutationOptions(token: Token): {
-    mutationKey: readonly ["confidentialTransfer", `0x${string}`];
-    mutationFn: ({ to, amount, callbacks }: ConfidentialTransferParams) => Promise<TransactionResult>;
-};
 /**
  * Encrypt and send a confidential transfer. Invalidates balance caches on success.
  *
@@ -977,29 +875,8 @@ declare function confidentialTransferMutationOptions(token: Token): {
  * );
  * ```
  */
-declare function useConfidentialTransfer(config: UseConfidentialTransferConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, `0x${string}`>;
+declare function useConfidentialTransfer(config: UseConfidentialTransferConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferParams, OptimisticMutateContext>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, OptimisticMutateContext>;
 
-/** Parameters passed to the `mutate` function of {@link useConfidentialTransferFrom}. */
-interface ConfidentialTransferFromParams {
-    /** Address to transfer from. Caller must be an approved operator. */
-    from: Address;
-    /** Recipient address. */
-    to: Address;
-    /** Amount to transfer (plaintext — encrypted automatically). */
-    amount: bigint;
-    /** Optional progress callbacks for the multi-step transfer flow. */
-    callbacks?: TransferCallbacks;
-}
-/**
- * TanStack Query mutation options factory for confidential transfer-from.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function confidentialTransferFromMutationOptions(token: Token): {
-    mutationKey: readonly ["confidentialTransferFrom", `0x${string}`];
-    mutationFn: ({ from, to, amount, callbacks }: ConfidentialTransferFromParams) => Promise<TransactionResult>;
-};
 /**
  * Operator transfer on behalf of another address. Caller must be an approved operator.
  * Invalidates balance caches on success.
@@ -1015,23 +892,6 @@ declare function confidentialTransferFromMutationOptions(token: Token): {
  */
 declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferFromParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ConfidentialTransferFromParams, `0x${string}`>;
 
-/** Parameters passed to the `mutate` function of {@link useConfidentialApprove}. */
-interface ConfidentialApproveParams {
-    /** Address to approve as operator. */
-    spender: Address;
-    /** Unix timestamp until which the approval is valid. Defaults to 1 hour from now. */
-    until?: number;
-}
-/**
- * TanStack Query mutation options factory for confidential approve.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function confidentialApproveMutationOptions(token: Token): {
-    mutationKey: readonly ["confidentialApprove", `0x${string}`];
-    mutationFn: ({ spender, until }: ConfidentialApproveParams) => Promise<TransactionResult>;
-};
 /**
  * Set operator approval for a confidential token. Defaults to 1 hour.
  *
@@ -1050,18 +910,6 @@ declare function confidentialApproveMutationOptions(token: Token): {
  */
 declare function useConfidentialApprove(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialApproveParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ConfidentialApproveParams, `0x${string}`>;
 
-/**
- * Query key factory for confidential approval queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const confidentialIsApprovedQueryKeys: {
-    /** Match all approval queries. */
-    readonly all: readonly ["confidentialIsApproved"];
-    /** Match approval queries for a specific token. */
-    readonly token: (tokenAddress: string) => readonly ["confidentialIsApproved", string];
-    /** Match approval queries for a specific token + spender pair. */
-    readonly spender: (tokenAddress: string, spender: string, holder?: string) => readonly ["confidentialIsApproved", string, string, string];
-};
 /** Configuration for {@link useConfidentialIsApproved}. */
 interface UseConfidentialIsApprovedConfig extends UseZamaConfig {
     /** Address to check approval for. Pass `undefined` to disable the query. */
@@ -1076,19 +924,6 @@ interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {
     /** Token holder address. Defaults to the connected wallet. */
     holder?: Address;
 }
-/**
- * TanStack Query options factory for confidential approval check.
- *
- * @param token - A `Token` instance.
- * @param spender - Address to check approval for.
- * @param holder - Optional holder address. Defaults to the connected wallet.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function confidentialIsApprovedQueryOptions(token: Token, spender: Address, holder?: Address): {
-    readonly queryKey: readonly ["confidentialIsApproved", string, string, string];
-    readonly queryFn: () => Promise<boolean>;
-    readonly staleTime: 30000;
-};
 /**
  * Check if a spender is an approved operator for a given holder (defaults to connected wallet).
  *
@@ -1105,7 +940,7 @@ declare function confidentialIsApprovedQueryOptions(token: Token, spender: Addre
  * });
  * ```
  */
-declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConfig, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<boolean, Error>;
+declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConfig, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<unknown, Error>;
 /**
  * Suspense variant of {@link useConfidentialIsApproved}.
  * Suspends rendering until the approval check resolves.
@@ -1124,19 +959,6 @@ declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConf
  */
 declare function useConfidentialIsApprovedSuspense(config: UseConfidentialIsApprovedSuspenseConfig): _tanstack_react_query.UseSuspenseQueryResult<boolean, Error>;
 
-/** Parameters passed to the `mutate` function of {@link useShield}. */
-interface ShieldParams {
-    /** Amount of underlying ERC-20 tokens to wrap. */
-    amount: bigint;
-    /** Optional fee amount (for native ETH wrapping with fees). */
-    fees?: bigint;
-    /** ERC-20 approval strategy: `"exact"` (default), `"max"`, or `"skip"`. */
-    approvalStrategy?: "max" | "exact" | "skip";
-    /** Recipient address for the shielded tokens. Defaults to the connected wallet. */
-    to?: Address;
-    /** Optional progress callbacks for the multi-step shield flow. */
-    callbacks?: ShieldCallbacks;
-}
 /** Configuration for {@link useShield}. */
 interface UseShieldConfig extends UseZamaConfig {
     /**
@@ -1146,16 +968,6 @@ interface UseShieldConfig extends UseZamaConfig {
      */
     optimistic?: boolean;
 }
-/**
- * TanStack Query mutation options factory for shield.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function shieldMutationOptions(token: Token): {
-    mutationKey: readonly ["shield", `0x${string}`];
-    mutationFn: ({ amount, fees, approvalStrategy, to, callbacks }: ShieldParams) => Promise<TransactionResult>;
-};
 /**
  * Shield public ERC-20 tokens into confidential tokens.
  * Handles ERC-20 approval automatically. Invalidates balance caches on success.
@@ -1175,25 +987,8 @@ declare function shieldMutationOptions(token: Token): {
  * shield.mutate({ amount: 1000n });
  * ```
  */
-declare function useShield(config: UseShieldConfig, options?: UseMutationOptions<TransactionResult, Error, ShieldParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ShieldParams, `0x${string}`>;
+declare function useShield(config: UseShieldConfig, options?: UseMutationOptions<TransactionResult, Error, ShieldParams, OptimisticMutateContext>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ShieldParams, OptimisticMutateContext>;
 
-/** Parameters passed to the `mutate` function of {@link useShieldETH}. */
-interface ShieldETHParams {
-    /** Amount of ETH to wrap (in wei). */
-    amount: bigint;
-    /** ETH value to send with the transaction. Defaults to `amount`. */
-    value?: bigint;
-}
-/**
- * TanStack Query mutation options factory for shield ETH.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function shieldETHMutationOptions(token: Token): {
-    mutationKey: readonly ["shieldETH", `0x${string}`];
-    mutationFn: ({ amount, value }: ShieldETHParams) => Promise<TransactionResult>;
-};
 /**
  * Shield native ETH into confidential tokens.
  * Invalidates balance caches on success.
@@ -1209,21 +1004,6 @@ declare function shieldETHMutationOptions(token: Token): {
  */
 declare function useShieldETH(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ShieldETHParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ShieldETHParams, `0x${string}`>;
 
-/** Parameters passed to the `mutate` function of {@link useUnwrap}. */
-interface UnwrapParams {
-    /** Amount to unwrap (plaintext — encrypted automatically). */
-    amount: bigint;
-}
-/**
- * TanStack Query mutation options factory for unwrap.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function unwrapMutationOptions(token: Token): {
-    mutationKey: readonly ["unwrap", `0x${string}`];
-    mutationFn: ({ amount }: UnwrapParams) => Promise<TransactionResult>;
-};
 /**
  * Request an unwrap for a specific amount. Encrypts the amount first.
  * Call {@link useFinalizeUnwrap} after the request is processed on-chain,
@@ -1240,16 +1020,6 @@ declare function unwrapMutationOptions(token: Token): {
  */
 declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnwrapParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, UnwrapParams, `0x${string}`>;
 
-/**
- * TanStack Query mutation options factory for unwrap-all.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function unwrapAllMutationOptions(token: Token): {
-    mutationKey: readonly ["unwrapAll", `0x${string}`];
-    mutationFn: () => Promise<TransactionResult>;
-};
 /**
  * Request an unwrap for the entire confidential balance.
  * Uses the on-chain balance handle directly (no encryption needed).
@@ -1266,21 +1036,6 @@ declare function unwrapAllMutationOptions(token: Token): {
  */
 declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, void, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, void, `0x${string}`>;
 
-/** Parameters passed to the `mutate` function of {@link useFinalizeUnwrap}. */
-interface FinalizeUnwrapParams {
-    /** Encrypted amount handle from the UnwrapRequested event. */
-    burnAmountHandle: Address;
-}
-/**
- * TanStack Query mutation options factory for finalize-unwrap.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function finalizeUnwrapMutationOptions(token: Token): {
-    mutationKey: readonly ["finalizeUnwrap", `0x${string}`];
-    mutationFn: ({ burnAmountHandle }: FinalizeUnwrapParams) => Promise<TransactionResult>;
-};
 /**
  * Complete an unwrap by providing the public decryption proof.
  * Call this after an unwrap request has been processed on-chain.
@@ -1296,23 +1051,6 @@ declare function finalizeUnwrapMutationOptions(token: Token): {
  */
 declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, FinalizeUnwrapParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, FinalizeUnwrapParams, `0x${string}`>;
 
-/** Parameters passed to the `mutate` function of {@link useUnshield}. */
-interface UnshieldParams {
-    /** Amount to unshield (plaintext — encrypted automatically). */
-    amount: bigint;
-    /** Optional progress callbacks for the multi-step unshield flow. */
-    callbacks?: UnshieldCallbacks;
-}
-/**
- * TanStack Query mutation options factory for unshield.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function unshieldMutationOptions(token: Token): {
-    mutationKey: readonly ["unshield", `0x${string}`];
-    mutationFn: ({ amount, callbacks }: UnshieldParams) => Promise<TransactionResult>;
-};
 /**
  * Unshield a specific amount and finalize in one call.
  * Orchestrates: unwrap → wait for receipt → parse event → finalize.
@@ -1334,21 +1072,6 @@ declare function unshieldMutationOptions(token: Token): {
  */
 declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnshieldParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, UnshieldParams, `0x${string}`>;
 
-/**
- * TanStack Query mutation options factory for unshield-all.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-/** Parameters passed to the `mutate` function of {@link useUnshieldAll}. */
-interface UnshieldAllParams {
-    /** Optional progress callbacks for the multi-step unshield flow. */
-    callbacks?: UnshieldCallbacks;
-}
-declare function unshieldAllMutationOptions(token: Token): {
-    mutationKey: readonly ["unshieldAll", `0x${string}`];
-    mutationFn: (params?: UnshieldAllParams) => Promise<TransactionResult>;
-};
 /**
  * Unshield the entire balance and finalize in one call.
  * Orchestrates: unwrapAll → wait for receipt → parse event → finalize.
@@ -1364,23 +1087,6 @@ declare function unshieldAllMutationOptions(token: Token): {
  */
 declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnshieldAllParams | void, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, void | UnshieldAllParams, `0x${string}`>;
 
-/** Parameters passed to the `mutate` function of {@link useResumeUnshield}. */
-interface ResumeUnshieldParams {
-    /** The unwrap transaction hash from a previously interrupted unshield. */
-    unwrapTxHash: Hex;
-    /** Optional progress callbacks for the finalization flow. */
-    callbacks?: UnshieldCallbacks;
-}
-/**
- * TanStack Query mutation options factory for resume-unshield.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function resumeUnshieldMutationOptions(token: Token): {
-    mutationKey: readonly ["resumeUnshield", `0x${string}`];
-    mutationFn: ({ unwrapTxHash, callbacks }: ResumeUnshieldParams) => Promise<TransactionResult>;
-};
 /**
  * Resume an interrupted unshield from an existing unwrap tx hash.
  * Useful when the user submitted the unwrap but the finalize step was
@@ -1401,35 +1107,13 @@ declare function resumeUnshieldMutationOptions(token: Token): {
  */
 declare function useResumeUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ResumeUnshieldParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ResumeUnshieldParams, `0x${string}`>;
 
-/**
- * Query key factory for underlying ERC-20 allowance queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const underlyingAllowanceQueryKeys: {
-    /** Match all underlying allowance queries. */
-    readonly all: readonly ["underlyingAllowance"];
-    /** Match allowance query for a specific token + wrapper pair. */
-    readonly token: (tokenAddress: string, wrapper: string) => readonly ["underlyingAllowance", string, string];
-};
 /** Configuration for {@link useUnderlyingAllowance}. */
 interface UseUnderlyingAllowanceConfig {
-    /** Address of the underlying ERC-20 token. */
+    /** Address of the confidential token contract used to scope the query cache. */
     tokenAddress: Address;
-    /** Address of the wrapper contract (the spender). */
+    /** Address of the wrapper contract whose underlying ERC-20 allowance is checked. */
     wrapperAddress: Address;
 }
-/**
- * TanStack Query options factory for underlying ERC-20 allowance.
- *
- * @param token - A `ReadonlyToken` instance.
- * @param wrapperAddress - Address of the wrapper contract (the spender).
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function underlyingAllowanceQueryOptions(token: ReadonlyToken, wrapperAddress: Address): {
-    readonly queryKey: readonly ["underlyingAllowance", string, string];
-    readonly queryFn: () => Promise<bigint>;
-    readonly staleTime: 30000;
-};
 /**
  * Read the underlying ERC-20 allowance granted to the wrapper contract.
  * Useful to check if an approval is needed before shielding.
@@ -1441,7 +1125,7 @@ declare function underlyingAllowanceQueryOptions(token: ReadonlyToken, wrapperAd
  * @example
  * ```tsx
  * const { data: allowance } = useUnderlyingAllowance({
- *   tokenAddress: "0xUnderlying",
+ *   tokenAddress: "0xConfidentialToken",
  *   wrapperAddress: "0xWrapper",
  * });
  * ```
@@ -1457,81 +1141,13 @@ declare function useUnderlyingAllowance(config: UseUnderlyingAllowanceConfig, op
  * @example
  * ```tsx
  * const { data: allowance } = useUnderlyingAllowanceSuspense({
- *   tokenAddress: "0xUnderlying",
+ *   tokenAddress: "0xConfidentialToken",
  *   wrapperAddress: "0xWrapper",
  * });
  * ```
  */
 declare function useUnderlyingAllowanceSuspense(config: UseUnderlyingAllowanceConfig): _tanstack_react_query.UseSuspenseQueryResult<bigint, Error>;
 
-/**
- * Query key factories for confidential balance queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()` / `removeQueries()`.
- *
- * @example
- * ```ts
- * // Invalidate all balance queries
- * queryClient.invalidateQueries({ queryKey: confidentialBalanceQueryKeys.all });
- *
- * // Reset balance for a specific token + owner
- * queryClient.resetQueries({
- *   queryKey: confidentialBalanceQueryKeys.owner("0xToken", "0xOwner"),
- * });
- * ```
- */
-declare const confidentialBalanceQueryKeys: {
-    /** Match all single-token balance queries. */
-    readonly all: readonly ["confidentialBalance"];
-    /** Match balance queries for a specific token (any owner). */
-    readonly token: (tokenAddress: string) => readonly ["confidentialBalance", string];
-    /** Match balance query for a specific token + owner. */
-    readonly owner: (tokenAddress: string, owner: string) => readonly ["confidentialBalance", string, string];
-};
-/**
- * Query key factory for batch balance queries (multiple tokens).
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const confidentialBalancesQueryKeys: {
-    /** Match all batch balance queries. */
-    readonly all: readonly ["confidentialBalances"];
-    /** Match batch balance query for a specific token set + owner. */
-    readonly tokens: (tokenAddresses: string[], owner: string) => readonly ["confidentialBalances", string[], string];
-};
-/**
- * Query key factory for encrypted handle queries (Phase 1 of two-phase polling).
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const confidentialHandleQueryKeys: {
-    /** Match all single-token handle queries. */
-    readonly all: readonly ["confidentialHandle"];
-    /** Match handle queries for a specific token (any owner). */
-    readonly token: (tokenAddress: string) => readonly ["confidentialHandle", string];
-    /** Match handle query for a specific token + owner. */
-    readonly owner: (tokenAddress: string, owner: string) => readonly ["confidentialHandle", string, string];
-};
-/**
- * Query key factory for batch encrypted handle queries (Phase 1, multiple tokens).
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const confidentialHandlesQueryKeys: {
-    /** Match all batch handle queries. */
-    readonly all: readonly ["confidentialHandles"];
-    /** Match batch handle query for a specific token set + owner. */
-    readonly tokens: (tokenAddresses: string[], owner: string) => readonly ["confidentialHandles", string[], string];
-};
-
-/**
- * Query key factory for wrapper discovery queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const wrapperDiscoveryQueryKeys: {
-    /** Match all wrapper discovery queries. */
-    readonly all: readonly ["wrapperDiscovery"];
-    /** Match wrapper discovery queries for a specific token. */
-    readonly token: (tokenAddress: string) => readonly ["wrapperDiscovery", string];
-    /** Match wrapper discovery query for a specific token + coordinator pair. */
-    readonly tokenCoordinator: (tokenAddress: string, coordinatorAddress: string) => readonly ["wrapperDiscovery", string, string];
-};
 /** Configuration for {@link useWrapperDiscovery}. */
 interface UseWrapperDiscoveryConfig {
     /** Address of the underlying ERC-20 token. */
@@ -1546,18 +1162,6 @@ interface UseWrapperDiscoverySuspenseConfig {
     /** Address of the wrapper coordinator. */
     coordinatorAddress: Address;
 }
-/**
- * TanStack Query options factory for wrapper discovery.
- *
- * @param token - A `ReadonlyToken` instance.
- * @param coordinatorAddress - Address of the wrapper coordinator.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function wrapperDiscoveryQueryOptions(token: ReadonlyToken, coordinatorAddress: Address): {
-    readonly queryKey: readonly ["wrapperDiscovery", string, string];
-    readonly queryFn: () => Promise<`0x${string}` | null>;
-    readonly staleTime: number;
-};
 /**
  * Discover the wrapper contract for an ERC-20 token.
  * Returns the wrapper address if one exists, or `null` if not.
@@ -1575,7 +1179,7 @@ declare function wrapperDiscoveryQueryOptions(token: ReadonlyToken, coordinatorA
  * });
  * ```
  */
-declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address | null, Error>, "queryKey" | "queryFn">): UseQueryResult<Address | null, Error>;
+declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address | null, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<`0x${string}` | null, Error>;
 /**
  * Suspense variant of {@link useWrapperDiscovery}.
  * Suspends rendering until the wrapper address is resolved.
@@ -1591,45 +1195,8 @@ declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?
  * });
  * ```
  */
-declare function useWrapperDiscoverySuspense(config: UseWrapperDiscoverySuspenseConfig): UseSuspenseQueryResult<Address | null, Error>;
+declare function useWrapperDiscoverySuspense(config: UseWrapperDiscoverySuspenseConfig): _tanstack_react_query.UseSuspenseQueryResult<`0x${string}` | null, Error>;
 
-/**
- * Query key factory for token metadata queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const metadataQueryKeys: {
-    /** Match all token metadata queries. */
-    readonly all: readonly ["tokenMetadata"];
-    /** Match metadata query for a specific token. */
-    readonly token: (tokenAddress: string) => readonly ["tokenMetadata", string];
-};
-/** ERC-20 token metadata (name, symbol, decimals). */
-interface TokenMetadata {
-    /** Human-readable token name (e.g. "Wrapped Ether"). */
-    name: string;
-    /** Short ticker symbol (e.g. "WETH"). */
-    symbol: string;
-    /** Number of decimal places (e.g. 18). */
-    decimals: number;
-}
-/**
- * TanStack Query options factory for token metadata.
- * Returns a config object usable with `useQuery`, `prefetchQuery`, `useQueries`, etc.
- *
- * @param token - A `ReadonlyToken` instance.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- *
- * @example
- * ```ts
- * const options = metadataQueryOptions(token);
- * await queryClient.prefetchQuery(options);
- * ```
- */
-declare function metadataQueryOptions(token: ReadonlyToken): {
-    readonly queryKey: readonly ["tokenMetadata", string];
-    readonly queryFn: () => Promise<TokenMetadata>;
-    readonly staleTime: number;
-};
 /**
  * Read ERC-20 token metadata (name, symbol, decimals).
  * Fetches all three in parallel. Cached indefinitely since metadata is immutable.
@@ -1644,7 +1211,7 @@ declare function metadataQueryOptions(token: ReadonlyToken): {
  * // metadata?.name, metadata?.symbol, metadata?.decimals
  * ```
  */
-declare function useMetadata(tokenAddress: Address, options?: Omit<UseQueryOptions<TokenMetadata, Error>, "queryKey" | "queryFn">): UseQueryResult<TokenMetadata, Error>;
+declare function useMetadata(tokenAddress: Address, options?: Omit<UseQueryOptions<TokenMetadata, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<TokenMetadata, Error>;
 /**
  * Suspense variant of {@link useMetadata}.
  * Suspends rendering until metadata is loaded.
@@ -1657,18 +1224,8 @@ declare function useMetadata(tokenAddress: Address, options?: Omit<UseQueryOptio
  * const { data: metadata } = useMetadataSuspense("0xToken");
  * ```
  */
-declare function useMetadataSuspense(tokenAddress: Address): UseSuspenseQueryResult<TokenMetadata, Error>;
+declare function useMetadataSuspense(tokenAddress: Address): _tanstack_react_query.UseSuspenseQueryResult<TokenMetadata, Error>;
 
-/**
- * Query key factory for activity feed queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const activityFeedQueryKeys: {
-    /** Match all activity feed queries. */
-    readonly all: readonly ["activityFeed"];
-    /** Match activity feed queries for a specific token. */
-    readonly token: (tokenAddress: string) => readonly ["activityFeed", string];
-};
 /** Configuration for {@link useActivityFeed}. */
 interface UseActivityFeedConfig {
     /** Address of the confidential token contract. */
@@ -1700,23 +1257,8 @@ interface UseActivityFeedConfig {
  * });
  * ```
  */
-declare function useActivityFeed(config: UseActivityFeedConfig): UseQueryResult<ActivityItem[], Error>;
+declare function useActivityFeed(config: UseActivityFeedConfig): _tanstack_react_query.UseQueryResult<ActivityItem[], Error>;
 
-/** Parameters passed to the `mutate` function of {@link useApproveUnderlying}. */
-interface ApproveUnderlyingParams {
-    /** Approval amount. Defaults to max uint256 if omitted. */
-    amount?: bigint;
-}
-/**
- * TanStack Query mutation options factory for approve-underlying.
- *
- * @param token - A `Token` instance.
- * @returns Mutation options with `mutationKey` and `mutationFn`.
- */
-declare function approveUnderlyingMutationOptions(token: Token): {
-    mutationKey: readonly ["approveUnderlying", `0x${string}`];
-    mutationFn: ({ amount }: ApproveUnderlyingParams) => Promise<TransactionResult>;
-};
 /**
  * Approve the wrapper contract to spend the underlying ERC-20.
  * Defaults to max uint256. Resets to zero first if there's an existing
@@ -1734,48 +1276,6 @@ declare function approveUnderlyingMutationOptions(token: Token): {
  */
 declare function useApproveUnderlying(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ApproveUnderlyingParams, Address>): _tanstack_react_query.UseMutationResult<TransactionResult, Error, ApproveUnderlyingParams, `0x${string}`>;
 
-/**
- * Query key factory for ERC-165 confidential interface checks.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const isConfidentialQueryKeys: {
-    /** Match all confidential interface queries. */
-    readonly all: readonly ["isConfidential"];
-    /** Match confidential interface query for a specific token. */
-    readonly token: (tokenAddress: string) => readonly ["isConfidential", string];
-};
-/**
- * Query key factory for ERC-165 wrapper interface checks.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const isWrapperQueryKeys: {
-    /** Match all wrapper interface queries. */
-    readonly all: readonly ["isWrapper"];
-    /** Match wrapper interface query for a specific token. */
-    readonly token: (tokenAddress: string) => readonly ["isWrapper", string];
-};
-/**
- * TanStack Query options factory for ERC-165 confidential interface check.
- *
- * @param token - A `ReadonlyToken` instance.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function isConfidentialQueryOptions(token: ReadonlyToken): {
-    readonly queryKey: readonly ["isConfidential", string];
-    readonly queryFn: () => Promise<boolean>;
-    readonly staleTime: number;
-};
-/**
- * TanStack Query options factory for ERC-165 wrapper interface check.
- *
- * @param token - A `ReadonlyToken` instance.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function isWrapperQueryOptions(token: ReadonlyToken): {
-    readonly queryKey: readonly ["isWrapper", string];
-    readonly queryFn: () => Promise<boolean>;
-    readonly staleTime: number;
-};
 /**
  * Check if a token supports the ERC-7984 confidential interface via ERC-165.
  * Result is cached indefinitely since interface support does not change.
@@ -1789,7 +1289,7 @@ declare function isWrapperQueryOptions(token: ReadonlyToken): {
  * const { data: isConfidential } = useIsConfidential("0xToken");
  * ```
  */
-declare function useIsConfidential(tokenAddress: Address, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): UseQueryResult<boolean, Error>;
+declare function useIsConfidential(tokenAddress: Address, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<boolean, Error>;
 /**
  * Suspense variant of {@link useIsConfidential}.
  * Suspends rendering until the ERC-165 check resolves.
@@ -1802,7 +1302,7 @@ declare function useIsConfidential(tokenAddress: Address, options?: Omit<UseQuer
  * const { data: isConfidential } = useIsConfidentialSuspense("0xToken");
  * ```
  */
-declare function useIsConfidentialSuspense(tokenAddress: Address): UseSuspenseQueryResult<boolean, Error>;
+declare function useIsConfidentialSuspense(tokenAddress: Address): _tanstack_react_query.UseSuspenseQueryResult<boolean, Error>;
 /**
  * Check if a token supports the ERC-7984 wrapper interface via ERC-165.
  * Result is cached indefinitely since interface support does not change.
@@ -1816,7 +1316,7 @@ declare function useIsConfidentialSuspense(tokenAddress: Address): UseSuspenseQu
  * const { data: isWrapper } = useIsWrapper("0xToken");
  * ```
  */
-declare function useIsWrapper(tokenAddress: Address, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): UseQueryResult<boolean, Error>;
+declare function useIsWrapper(tokenAddress: Address, options?: Omit<UseQueryOptions<boolean, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<boolean, Error>;
 /**
  * Suspense variant of {@link useIsWrapper}.
  * Suspends rendering until the ERC-165 check resolves.
@@ -1829,29 +1329,8 @@ declare function useIsWrapper(tokenAddress: Address, options?: Omit<UseQueryOpti
  * const { data: isWrapper } = useIsWrapperSuspense("0xToken");
  * ```
  */
-declare function useIsWrapperSuspense(tokenAddress: Address): UseSuspenseQueryResult<boolean, Error>;
+declare function useIsWrapperSuspense(tokenAddress: Address): _tanstack_react_query.UseSuspenseQueryResult<boolean, Error>;
 
-/**
- * Query key factory for total supply queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const totalSupplyQueryKeys: {
-    /** Match all total supply queries. */
-    readonly all: readonly ["totalSupply"];
-    /** Match total supply query for a specific token. */
-    readonly token: (tokenAddress: string) => readonly ["totalSupply", string];
-};
-/**
- * TanStack Query options factory for total supply.
- *
- * @param token - A `ReadonlyToken` instance.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function totalSupplyQueryOptions(token: ReadonlyToken): {
-    readonly queryKey: readonly ["totalSupply", string];
-    readonly queryFn: () => Promise<bigint>;
-    readonly staleTime: 30000;
-};
 /**
  * Read the total supply of a token.
  * Stale after 30 seconds to balance freshness and RPC cost.
@@ -1865,7 +1344,7 @@ declare function totalSupplyQueryOptions(token: ReadonlyToken): {
  * const { data: totalSupply } = useTotalSupply("0xToken");
  * ```
  */
-declare function useTotalSupply(tokenAddress: Address, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): UseQueryResult<bigint, Error>;
+declare function useTotalSupply(tokenAddress: Address, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<bigint, Error>;
 /**
  * Suspense variant of {@link useTotalSupply}.
  * Suspends rendering until the total supply is loaded.
@@ -1878,22 +1357,8 @@ declare function useTotalSupply(tokenAddress: Address, options?: Omit<UseQueryOp
  * const { data: totalSupply } = useTotalSupplySuspense("0xToken");
  * ```
  */
-declare function useTotalSupplySuspense(tokenAddress: Address): UseSuspenseQueryResult<bigint, Error>;
+declare function useTotalSupplySuspense(tokenAddress: Address): _tanstack_react_query.UseSuspenseQueryResult<bigint, Error>;
 
-/**
- * Query key factory for fee-related queries.
- * Use with `queryClient.invalidateQueries()` / `resetQueries()`.
- */
-declare const feeQueryKeys: {
-    /** Match shield fee query for given parameters. */
-    readonly shieldFee: (feeManagerAddress: string, amount?: string, from?: string, to?: string) => readonly ["shieldFee", string, ...(string | undefined)[]];
-    /** Match unshield fee query for given parameters. */
-    readonly unshieldFee: (feeManagerAddress: string, amount?: string, from?: string, to?: string) => readonly ["unshieldFee", string, ...(string | undefined)[]];
-    /** Match batch transfer fee query for a specific fee manager. */
-    readonly batchTransferFee: (feeManagerAddress: string) => readonly ["batchTransferFee", string];
-    /** Match fee recipient query for a specific fee manager. */
-    readonly feeRecipient: (feeManagerAddress: string) => readonly ["feeRecipient", string];
-};
 /** Configuration for {@link useShieldFee} and {@link useUnshieldFee}. */
 interface UseFeeConfig {
     /** Address of the fee manager contract. */
@@ -1905,54 +1370,6 @@ interface UseFeeConfig {
     /** Receiver address. */
     to: Address;
 }
-/**
- * TanStack Query options factory for shield fee.
- *
- * @param signer - A `GenericSigner` instance.
- * @param config - {@link UseFeeConfig} with fee manager address, amount, from, and to.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function shieldFeeQueryOptions(signer: GenericSigner, config: UseFeeConfig): {
-    readonly queryKey: readonly ["shieldFee", string, ...(string | undefined)[]];
-    readonly queryFn: () => Promise<bigint>;
-    readonly staleTime: 30000;
-};
-/**
- * TanStack Query options factory for unshield fee.
- *
- * @param signer - A `GenericSigner` instance.
- * @param config - Fee manager address, amount, from, and to.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function unshieldFeeQueryOptions(signer: GenericSigner, config: UseFeeConfig): {
-    readonly queryKey: readonly ["unshieldFee", string, ...(string | undefined)[]];
-    readonly queryFn: () => Promise<bigint>;
-    readonly staleTime: 30000;
-};
-/**
- * TanStack Query options factory for batch transfer fee.
- *
- * @param signer - A `GenericSigner` instance.
- * @param feeManagerAddress - Address of the fee manager contract.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function batchTransferFeeQueryOptions(signer: GenericSigner, feeManagerAddress: Address): {
-    readonly queryKey: readonly ["batchTransferFee", string];
-    readonly queryFn: () => Promise<bigint>;
-    readonly staleTime: 30000;
-};
-/**
- * TanStack Query options factory for fee recipient.
- *
- * @param signer - A `GenericSigner` instance.
- * @param feeManagerAddress - Address of the fee manager contract.
- * @returns Query options with `queryKey`, `queryFn`, and `staleTime`.
- */
-declare function feeRecipientQueryOptions(signer: GenericSigner, feeManagerAddress: Address): {
-    readonly queryKey: readonly ["feeRecipient", string];
-    readonly queryFn: () => Promise<`0x${string}`>;
-    readonly staleTime: 30000;
-};
 /**
  * Read the shield fee for a given amount and address pair.
  *
@@ -1970,7 +1387,7 @@ declare function feeRecipientQueryOptions(signer: GenericSigner, feeManagerAddre
  * });
  * ```
  */
-declare function useShieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): UseQueryResult<bigint, Error>;
+declare function useShieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<bigint, Error>;
 /**
  * Read the unshield fee for a given amount and address pair.
  *
@@ -1988,7 +1405,7 @@ declare function useShieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptio
  * });
  * ```
  */
-declare function useUnshieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): UseQueryResult<bigint, Error>;
+declare function useUnshieldFee(config: UseFeeConfig, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<bigint, Error>;
 /**
  * Read the batch transfer fee from the fee manager.
  *
@@ -2001,7 +1418,7 @@ declare function useUnshieldFee(config: UseFeeConfig, options?: Omit<UseQueryOpt
  * const { data: fee } = useBatchTransferFee("0xFeeManager");
  * ```
  */
-declare function useBatchTransferFee(feeManagerAddress: Address, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): UseQueryResult<bigint, Error>;
+declare function useBatchTransferFee(feeManagerAddress: Address, options?: Omit<UseQueryOptions<bigint, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<bigint, Error>;
 /**
  * Read the fee recipient address from the fee manager.
  *
@@ -2014,6 +1431,6 @@ declare function useBatchTransferFee(feeManagerAddress: Address, options?: Omit<
  * const { data: recipient } = useFeeRecipient("0xFeeManager");
  * ```
  */
-declare function useFeeRecipient(feeManagerAddress: Address, options?: Omit<UseQueryOptions<Address, Error>, "queryKey" | "queryFn">): UseQueryResult<Address, Error>;
+declare function useFeeRecipient(feeManagerAddress: Address, options?: Omit<UseQueryOptions<Address, Error>, "queryKey" | "queryFn">): _tanstack_react_query.UseQueryResult<`0x${string}`, Error>;
 
-export { type ApproveUnderlyingParams, type ConfidentialApproveParams, type ConfidentialBalancesData, type ConfidentialTransferFromParams, type ConfidentialTransferParams, type CreateDelegatedUserDecryptEIP712Params, type CreateEIP712Params, type DecryptHandle, type FinalizeUnwrapParams, type PublicKeyData, type PublicKeyResult, type PublicParamsData, type PublicParamsResult, type ResumeUnshieldParams, type ShieldETHParams, type ShieldParams, type TokenMetadata, type UnshieldAllParams, type UnshieldParams, type UnwrapParams, type UseActivityFeedConfig, type UseConfidentialBalanceConfig, type UseConfidentialBalanceOptions, type UseConfidentialBalancesConfig, type UseConfidentialBalancesOptions, type UseConfidentialIsApprovedConfig, type UseConfidentialIsApprovedSuspenseConfig, type UseConfidentialTransferConfig, type UseFeeConfig, type UseShieldConfig, type UseUnderlyingAllowanceConfig, type UseUserDecryptFlowConfig, type UseWrapperDiscoveryConfig, type UseWrapperDiscoverySuspenseConfig, type UseZamaConfig, type UserDecryptFlowCallbacks, type UserDecryptFlowParams, ZamaProvider, type ZamaProviderProps, activityFeedQueryKeys, allowMutationOptions, approveUnderlyingMutationOptions, batchTransferFeeQueryOptions, confidentialApproveMutationOptions, confidentialBalanceQueryKeys, confidentialBalancesQueryKeys, confidentialHandleQueryKeys, confidentialHandlesQueryKeys, confidentialIsApprovedQueryKeys, confidentialIsApprovedQueryOptions, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, decryptionKeys, encryptMutationOptions, feeQueryKeys, feeRecipientQueryOptions, finalizeUnwrapMutationOptions, isAllowedQueryKeys, isAllowedQueryOptions, isConfidentialQueryKeys, isConfidentialQueryOptions, isWrapperQueryKeys, isWrapperQueryOptions, metadataQueryKeys, metadataQueryOptions, publicKeyQueryKeys, publicKeyQueryOptions, publicParamsQueryKeys, publicParamsQueryOptions, resumeUnshieldMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, shieldETHMutationOptions, shieldFeeQueryOptions, shieldMutationOptions, totalSupplyQueryKeys, totalSupplyQueryOptions, underlyingAllowanceQueryKeys, underlyingAllowanceQueryOptions, unshieldAllMutationOptions, unshieldFeeQueryOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapMutationOptions, useActivityFeed, useAllow, useApproveUnderlying, useBatchTransferFee, useConfidentialApprove, useConfidentialBalance, useConfidentialBalances, useConfidentialIsApproved, useConfidentialIsApprovedSuspense, useConfidentialTransfer, useConfidentialTransferFrom, useCreateDelegatedUserDecryptEIP712, useCreateEIP712, useDelegatedUserDecrypt, useEncrypt, useFeeRecipient, useFinalizeUnwrap, useGenerateKeypair, useIsAllowed, useIsConfidential, useIsConfidentialSuspense, useIsWrapper, useIsWrapperSuspense, useMetadata, useMetadataSuspense, usePublicDecrypt, usePublicKey, usePublicParams, useReadonlyToken, useRequestZKProofVerification, useResumeUnshield, useRevoke, useRevokeSession, useShield, useShieldETH, useShieldFee, useToken, useTotalSupply, useTotalSupplySuspense, useUnderlyingAllowance, useUnderlyingAllowanceSuspense, useUnshield, useUnshieldAll, useUnshieldFee, useUnwrap, useUnwrapAll, useUserDecrypt, useUserDecryptFlow, useUserDecryptedValue, useUserDecryptedValues, useWrapperDiscovery, useWrapperDiscoverySuspense, useZamaSDK, wrapperDiscoveryQueryKeys, wrapperDiscoveryQueryOptions };
+export { type CreateDelegatedUserDecryptEIP712Params, type CreateEIP712Params, type DecryptHandle, type OptimisticBalanceSnapshot, type OptimisticMutateContext, type PublicKeyData, type PublicParamsData, type UseActivityFeedConfig, type UseConfidentialBalanceConfig, type UseConfidentialBalanceOptions, type UseConfidentialBalancesConfig, type UseConfidentialBalancesOptions, type UseConfidentialIsApprovedConfig, type UseConfidentialIsApprovedSuspenseConfig, type UseConfidentialTransferConfig, type UseFeeConfig, type UseShieldConfig, type UseUnderlyingAllowanceConfig, type UseUserDecryptFlowConfig, type UseWrapperDiscoveryConfig, type UseWrapperDiscoverySuspenseConfig, type UseZamaConfig, type UserDecryptFlowCallbacks, type UserDecryptFlowParams, ZamaProvider, type ZamaProviderProps, decryptionKeys, useActivityFeed, useAllow, useApproveUnderlying, useBatchTransferFee, useConfidentialApprove, useConfidentialBalance, useConfidentialBalances, useConfidentialIsApproved, useConfidentialIsApprovedSuspense, useConfidentialTransfer, useConfidentialTransferFrom, useCreateDelegatedUserDecryptEIP712, useCreateEIP712, useDelegatedUserDecrypt, useEncrypt, useFeeRecipient, useFinalizeUnwrap, useGenerateKeypair, useIsAllowed, useIsConfidential, useIsConfidentialSuspense, useIsWrapper, useIsWrapperSuspense, useMetadata, useMetadataSuspense, usePublicDecrypt, usePublicKey, usePublicParams, useReadonlyToken, useRequestZKProofVerification, useResumeUnshield, useRevoke, useRevokeSession, useShield, useShieldETH, useShieldFee, useToken, useTotalSupply, useTotalSupplySuspense, useUnderlyingAllowance, useUnderlyingAllowanceSuspense, useUnshield, useUnshieldAll, useUnshieldFee, useUnwrap, useUnwrapAll, useUserDecrypt, useUserDecryptFlow, useUserDecryptedValue, useUserDecryptedValues, useWrapperDiscovery, useWrapperDiscoverySuspense, useZamaSDK };