@zama-fhe/react-sdk 3.0.0-alpha.2 → 3.0.0-alpha.20

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 "use client";
 
 import * as _$_zama_fhe_sdk0 from "@zama-fhe/sdk";
-import { ACL_TOPICS, AclEvent, AclPausedError, Address, Address as Address$1, ApprovalFailedError, ApproveSubmittedEvent, ApproveUnderlyingSubmittedEvent, BalanceCheckUnavailableError, BaseEvent, BatchBalancesResult, BatchBalancesResult as BatchBalancesResult$1, BatchDecryptAsOptions, ChromeSessionStorage, ClearValueType, ClearValueType as ClearValueType$1, ConfidentialTransferEvent, ConfigurationError, ContractAbi, CredentialsAllowedEvent, CredentialsCachedEvent, CredentialsCreatedEvent, CredentialsCreatingEvent, CredentialsExpiredEvent, CredentialsLoadingEvent, CredentialsManager, CredentialsManagerConfig, CredentialsRevokedEvent, DecryptEndEvent, DecryptErrorEvent, DecryptStartEvent, DecryptionFailedError, DefaultRegistryAddresses, DelegatedCredentialsManager, DelegatedCredentialsManagerConfig, DelegatedForUserDecryptionEvent, DelegatedStoredCredentials, DelegatedUserDecryptParams, DelegatedUserDecryptParams as DelegatedUserDecryptParams$1, DelegationContractIsSelfError, DelegationCooldownError, DelegationDelegateEqualsContractError, DelegationExpirationTooSoonError, DelegationExpiredError, DelegationExpiryUnchangedError, DelegationNotFoundError, DelegationNotPropagatedError, DelegationSelfNotAllowedError, EIP712TypedData, EIP712TypedData as EIP712TypedData$1, ERC20ReadFailedError, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, EncryptEndEvent, EncryptErrorEvent, EncryptInput, EncryptParams, EncryptParams as EncryptParams$1, EncryptResult, EncryptResult as EncryptResult$1, EncryptStartEvent, EncryptionFailedError, FheTypeName, FhevmInstanceConfig, FinalizeUnwrapSubmittedEvent, GenericSigner, GenericSigner as GenericSigner$1, GenericStorage, GenericStorage as GenericStorage$1, Handle, HardhatConfig, Hex, IndexedDBStorage, InputProofBytesType, InsufficientConfidentialBalanceError, InsufficientERC20BalanceError, InvalidKeypairError, KeypairExpiredError, KeypairType, KmsDelegatedUserDecryptEIP712Type, ListPairsOptions, MainnetConfig, MemoryStorage, NetworkType, NoCiphertextError, OnChainEvent, PaginatedResult, PaginatedResult as PaginatedResult$1, PublicDecryptResult, PublicDecryptResult as PublicDecryptResult$1, RawLog, ReadContractArgs, ReadContractConfig, ReadContractReturnType, ReadFunctionName, ReadonlyToken, ReadonlyToken as ReadonlyToken$1, RelayerRequestFailedError, RelayerSDK, RelayerSDK as RelayerSDK$1, RelayerSDKStatus, RelayerWeb, RelayerWebConfig, RelayerWebSecurityConfig, RevokedDelegationForUserDecryptionEvent, SepoliaConfig, SessionExpiredEvent, ShieldCallbacks, ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, StoredCredentials, TOKEN_TOPICS, Token, TokenWrapperPair, TokenWrapperPair as TokenWrapperPair$1, TokenWrapperPairWithMetadata, TokenWrapperPairWithMetadata as TokenWrapperPairWithMetadata$1, Topics, TransactionErrorEvent, TransactionReceipt, TransactionResult, TransactionResult as TransactionResult$1, TransactionRevertedError, TransferCallbacks, TransferFromSubmittedEvent, TransferSubmittedEvent, UnshieldCallbacks, UnshieldPhase1SubmittedEvent, UnshieldPhase2StartedEvent, UnshieldPhase2SubmittedEvent, UnwrapRequestedEvent, UnwrapSubmittedEvent, UnwrappedFinalizedEvent, UnwrappedStartedEvent, UserDecryptParams, WrappedEvent, WrappersRegistry, WrappersRegistryConfig, WriteContractArgs, WriteContractConfig, WriteFunctionName, ZERO_HANDLE, ZKProofLike, ZKProofLike as ZKProofLike$1, ZamaError, ZamaErrorCode, ZamaSDK, ZamaSDK as ZamaSDK$1, ZamaSDKConfig, ZamaSDKEvent, ZamaSDKEventInput, ZamaSDKEventListener, ZamaSDKEventListener as ZamaSDKEventListener$1, ZamaSDKEventType, ZamaSDKEvents, allowanceContract, approveContract, balanceOfContract, chromeSessionStorage, clearPendingUnshield, confidentialBalanceOfContract, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, decimalsContract, decodeAclEvent, decodeAclEvents, decodeConfidentialTransfer, decodeDelegatedForUserDecryption, decodeOnChainEvent, decodeOnChainEvents, decodeRevokedDelegationForUserDecryption, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, delegateForUserDecryptionContract, finalizeUnwrapContract, findDelegatedForUserDecryption, findRevokedDelegationForUserDecryption, findUnwrapRequested, findWrapped, getDelegationExpiryContract, indexedDBStorage, inferredTotalSupplyContract, isConfidentialTokenContract, isConfidentialWrapperContract, isHandleDelegatedContract, isOperatorContract, isZeroHandle, loadPendingUnshield, matchAclRevert, matchZamaError, memoryStorage, nameContract, rateContract, revokeDelegationContract, savePendingUnshield, setOperatorContract, supportsInterfaceContract, symbolContract, totalSupplyContract, underlyingContract, unwrapContract, unwrapFromBalanceContract, wrapContract } from "@zama-fhe/sdk";
-import { ApproveUnderlyingParams, ApproveUnderlyingParams as ApproveUnderlyingParams$1, BatchDecryptBalancesAsParams, BatchDecryptBalancesAsParams as BatchDecryptBalancesAsParams$1, ConfidentialApproveParams, ConfidentialApproveParams as ConfidentialApproveParams$1, ConfidentialTransferFromParams, ConfidentialTransferFromParams as ConfidentialTransferFromParams$1, ConfidentialTransferParams, ConfidentialTransferParams as ConfidentialTransferParams$1, CreateDelegatedUserDecryptEIP712Params, CreateEIP712Params, DecryptBalanceAsParams, DecryptBalanceAsParams as DecryptBalanceAsParams$1, DecryptHandle, DecryptResult, DecryptResult as DecryptResult$1, DelegateDecryptionParams, DelegateDecryptionParams as DelegateDecryptionParams$1, DelegationStatusData, DelegationStatusData as DelegationStatusData$1, DelegationStatusQueryConfig, FinalizeUnwrapParams, FinalizeUnwrapParams as FinalizeUnwrapParams$1, ListPairsQueryConfig, ResumeUnshieldParams, ResumeUnshieldParams as ResumeUnshieldParams$1, RevokeDelegationParams, RevokeDelegationParams as RevokeDelegationParams$1, ShieldParams, ShieldParams as ShieldParams$1, TokenMetadata, UnshieldAllParams, UnshieldAllParams as UnshieldAllParams$1, UnshieldParams, UnshieldParams as UnshieldParams$1, UnwrapParams, UnwrapParams as UnwrapParams$1, UserDecryptQueryConfig, UserDecryptQueryConfig as UserDecryptQueryConfig$1, allowMutationOptions, approveUnderlyingMutationOptions, batchDecryptBalancesAsMutationOptions, confidentialApproveMutationOptions, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, createDelegatedUserDecryptEIP712MutationOptions, createEIP712MutationOptions, decryptBalanceAsMutationOptions, delegateDecryptionMutationOptions, delegatedUserDecryptMutationOptions, delegationStatusQueryOptions, encryptMutationOptions, filterQueryOptions, finalizeUnwrapMutationOptions, generateKeypairMutationOptions, hashFn, isAllowedQueryOptions, isConfidentialQueryOptions, isWrapperQueryOptions, listPairsQueryOptions, publicDecryptMutationOptions, publicKeyQueryOptions, publicParamsQueryOptions, requestZKProofVerificationMutationOptions, resumeUnshieldMutationOptions, revokeDelegationMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, shieldMutationOptions, signerAddressQueryOptions, tokenMetadataQueryOptions, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, unshieldAllMutationOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapMutationOptions, userDecryptQueryOptions, wrapperDiscoveryQueryOptions, zamaQueryKeys } from "@zama-fhe/sdk/query";
+import { Address, BatchBalancesResult, ClearValueType, DelegatedUserDecryptParams, EIP712TypedData, EncryptParams, PaginatedResult, PublicKeyData, ReadonlyToken, Token, TokenWrapperPair, TokenWrapperPairWithMetadata, TransactionResult, ZKProofLike, ZamaConfig, ZamaSDK } from "@zama-fhe/sdk";
+import { ApproveUnderlyingParams, BatchDecryptBalancesAsParams, ConfidentialApproveParams, ConfidentialTransferFromParams, ConfidentialTransferParams, CreateDelegatedUserDecryptEIP712Params, CreateEIP712Params, DecryptBalanceAsParams, DecryptResult, DelegateDecryptionParams, DelegationStatusData, FinalizeUnwrapParams, ResumeUnshieldParams, RevokeDelegationParams, ShieldParams, TokenMetadata, UnshieldAllParams, UnshieldParams, UnwrapParams, UserDecryptQueryConfig } from "@zama-fhe/sdk/query";
 import * as _$_tanstack_react_query0 from "@tanstack/react-query";
-import { QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions } from "@tanstack/react-query";
+import { UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
 import { PropsWithChildren } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import * as _$_zama_fhe_relayer_sdk_web0 from "@zama-fhe/relayer-sdk/web";
@@ -12,75 +12,55 @@ import * as _$_zama_fhe_relayer_sdk_web0 from "@zama-fhe/relayer-sdk/web";
 //#region src/provider.d.ts
 /** Props for {@link ZamaProvider}. */
 interface ZamaProviderProps extends PropsWithChildren {
-  /** FHE relayer backend (RelayerWeb for browser, RelayerNode for server). */
-  relayer: RelayerSDK$1;
-  /** Wallet signer (`ViemSigner`, `EthersSigner`, or custom {@link GenericSigner}). */
-  signer: GenericSigner$1;
-  /** Credential storage backend (IndexedDBStorage for browser, MemoryStorage for tests). */
-  storage: GenericStorage$1;
-  /**
-   * Session storage for wallet signatures. Defaults to in-memory (lost on reload).
-   * Pass a `chrome.storage.session`-backed store for web extensions.
-   */
-  sessionStorage?: GenericStorage$1;
-  /**
-   * How long the ML-KEM re-encryption keypair remains valid, in seconds.
-   * Default: `86400` (1 day). Must be positive — `0` is rejected.
-   */
-  keypairTTL?: number;
-  /**
-   * Controls how long session signatures (EIP-712 wallet signatures) remain valid, in seconds.
-   * Default: `2592000` (30 days).
-   * - `0`: never persist — every operation triggers a signing prompt (high-security mode).
-   * - Positive number: seconds until the session signature expires and requires re-authentication.
-   */
-  sessionTTL?: number;
-  /**
-   * Per-chain wrappers registry address overrides, merged on top of built-in defaults.
-   * Use this for custom or local chains (e.g. Hardhat) where no default registry exists.
-   */
-  registryAddresses?: Record<number, Address$1>;
-  /**
-   * How long cached registry results remain valid, in seconds.
-   * Default: `86400` (24 hours).
-   */
-  registryTTL?: number;
-  /** Callback invoked on SDK lifecycle events. */
-  onEvent?: ZamaSDKEventListener$1;
+  /** Configuration object created by {@link createConfig}. */
+  config: ZamaConfig;
 }
 /**
  * Provides a {@link ZamaSDK} instance to all descendant hooks.
  *
  * @example
  * ```tsx
- * <ZamaProvider relayer={relayer} signer={signer} storage={storage}>
+ * <ZamaProvider config={zamaConfig}>
  *   <App />
  * </ZamaProvider>
  * ```
  */
 declare function ZamaProvider({
   children,
-  relayer,
-  signer,
-  storage,
-  sessionStorage,
-  keypairTTL,
-  sessionTTL,
-  registryAddresses,
-  registryTTL,
-  onEvent
+  config
 }: ZamaProviderProps): _$react_jsx_runtime0.JSX.Element;
 /**
  * Access the {@link ZamaSDK} instance from context.
- * Throws if called outside a {@link ZamaProvider} or when no signer is provided.
+ * Throws if called outside a {@link ZamaProvider}.
  *
  * @example
  * ```tsx
  * const sdk = useZamaSDK();
- * const token = sdk.createReadonlyToken("0x...");
+ * const token = sdk.createToken("0x...", "0x...");
+ * ```
+ */
+declare function useZamaSDK(): ZamaSDK;
+//#endregion
+//#region src/use-signer-address.d.ts
+/**
+ * Read the connected signer address.
+ *
+ * @example
+ * ```tsx
+ * const { data: address, isPending, isError } = useSignerAddress();
+ * ```
+ */
+declare function useSignerAddress(): UseQueryResult<Address>;
+/**
+ * Suspense variant of {@link useSignerAddress}.
+ * Suspends rendering until the signer address resolves.
+ *
+ * @example
+ * ```tsx
+ * const { data: address } = useSignerAddressSuspense();
  * ```
  */
-declare function useZamaSDK(): ZamaSDK$1;
+declare function useSignerAddressSuspense(): _$_tanstack_react_query0.UseSuspenseQueryResult<`0x${string}`, Error>;
 //#endregion
 //#region src/relayer/use-encrypt.d.ts
 /**
@@ -98,14 +78,17 @@ declare function useZamaSDK(): ZamaSDK$1;
  * encrypt.mutate({ values: [{ value: 1000n, type: "euint64" }], contractAddress: "0x...", userAddress: "0x..." });
  * ```
  */
-declare function useEncrypt(): _$_tanstack_react_query0.UseMutationResult<EncryptResult$1, Error, EncryptParams$1, unknown>;
+declare function useEncrypt(): _$_tanstack_react_query0.UseMutationResult<Readonly<{
+  handles: Uint8Array[];
+  inputProof: Uint8Array;
+}>, Error, EncryptParams, unknown>;
 //#endregion
 //#region src/relayer/use-user-decrypt.d.ts
 /**
  * React hook for FHE user decryption. Thin wrapper around
  * `userDecryptQueryOptions` with `useQuery` semantics.
  */
-declare function useUserDecrypt(config: UserDecryptQueryConfig$1, options?: Omit<UseQueryOptions<DecryptResult$1>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<DecryptResult$1, Error>;
+declare function useUserDecrypt(config: UserDecryptQueryConfig, options?: Omit<UseQueryOptions<DecryptResult>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<Readonly<Record<`0x${string}`, _$_zama_fhe_sdk0.ClearValueType>>, Error>;
 /** Return type of {@link useUserDecrypt}. */
 type UseUserDecryptResult = ReturnType<typeof useUserDecrypt>;
 //#endregion
@@ -124,7 +107,11 @@ type UseUserDecryptResult = ReturnType<typeof useUserDecrypt>;
  * // publicDecrypt.data?.clearValues => { "0xHandle1": 500n, ... }
  * ```
  */
-declare function usePublicDecrypt(): _$_tanstack_react_query0.UseMutationResult<PublicDecryptResult$1, Error, `0x${string}`[], unknown>;
+declare function usePublicDecrypt(): _$_tanstack_react_query0.UseMutationResult<Readonly<{
+  clearValues: _$_zama_fhe_relayer_sdk_web0.ClearValues;
+  abiEncodedClearValues: `0x${string}`;
+  decryptionProof: `0x${string}`;
+}>, Error, `0x${string}`[], unknown>;
 //#endregion
 //#region src/relayer/use-generate-keypair.d.ts
 /**
@@ -162,7 +149,7 @@ declare function useGenerateKeypair(): _$_tanstack_react_query0.UseMutationResul
  * });
  * ```
  */
-declare function useCreateEIP712(): _$_tanstack_react_query0.UseMutationResult<EIP712TypedData$1, Error, CreateEIP712Params, unknown>;
+declare function useCreateEIP712(): _$_tanstack_react_query0.UseMutationResult<EIP712TypedData, Error, CreateEIP712Params, unknown>;
 //#endregion
 //#region src/relayer/use-create-delegated-user-decrypt-eip712.d.ts
 /**
@@ -203,7 +190,7 @@ declare function useCreateDelegatedUserDecryptEIP712(): _$_tanstack_react_query0
  * // decrypt.data => { "0xHandle1": 1000n }
  * ```
  */
-declare function useDelegatedUserDecrypt(): _$_tanstack_react_query0.UseMutationResult<Record<`0x${string}`, ClearValueType$1>, Error, DelegatedUserDecryptParams$1, unknown>;
+declare function useDelegatedUserDecrypt(): _$_tanstack_react_query0.UseMutationResult<Record<`0x${string}`, ClearValueType>, Error, DelegatedUserDecryptParams, unknown>;
 //#endregion
 //#region src/relayer/use-request-zk-proof-verification.d.ts
 /**
@@ -222,16 +209,9 @@ declare function useDelegatedUserDecrypt(): _$_tanstack_react_query0.UseMutation
 declare function useRequestZKProofVerification(): _$_tanstack_react_query0.UseMutationResult<Readonly<{
   handles: Uint8Array[];
   inputProof: Uint8Array;
-}>, Error, ZKProofLike$1, unknown>;
+}>, Error, ZKProofLike, unknown>;
 //#endregion
 //#region src/relayer/use-public-key.d.ts
-/** Shape of the FHE public key data returned by the relayer. */
-interface PublicKeyData {
-  /** Unique identifier for this public key version. */
-  publicKeyId: string;
-  /** The raw FHE public key bytes. */
-  publicKey: Uint8Array;
-}
 /**
  * Fetch the FHE network public key from the relayer.
  * Cached indefinitely since the key does not change during a session.
@@ -247,13 +227,6 @@ interface PublicKeyData {
 declare function usePublicKey(): _$_tanstack_react_query0.UseQueryResult<PublicKeyData | null, Error>;
 //#endregion
 //#region src/relayer/use-public-params.d.ts
-/** Shape of the FHE public parameters returned by the relayer. */
-interface PublicParamsData {
-  /** The raw public parameters bytes (WASM-ready). */
-  publicParams: Uint8Array;
-  /** Unique identifier for this public params version. */
-  publicParamsId: string;
-}
 /**
  * Fetch FHE public parameters for a given bit size from the relayer.
  * Cached indefinitely since parameters do not change during a session.
@@ -267,7 +240,10 @@ interface PublicParamsData {
  * // params?.publicParams, params?.publicParamsId
  * ```
  */
-declare function usePublicParams(bits: number): _$_tanstack_react_query0.UseQueryResult<PublicParamsData | null, Error>;
+declare function usePublicParams(bits: number): _$_tanstack_react_query0.UseQueryResult<{
+  publicParams: Uint8Array<ArrayBufferLike>;
+  publicParamsId: string;
+} | null, Error>;
 //#endregion
 //#region src/authorization/use-allow.d.ts
 /**
@@ -290,13 +266,13 @@ declare function usePublicParams(bits: number): _$_tanstack_react_query0.UseQuer
  * await allow([tokenAddress, auctionAddress, governanceAddress]);
  * ```
  */
-declare function useAllow(options?: UseMutationOptions<void, Error, Address$1[]>): _$_tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
+declare function useAllow(options?: UseMutationOptions<void, Error, Address[]>): _$_tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
 //#endregion
 //#region src/authorization/use-is-allowed.d.ts
 /** Configuration for {@link useIsAllowed}. */
 interface UseIsAllowedConfig {
   /** Contract addresses to check credentials against (at least one required). */
-  contractAddresses: [Address$1, ...Address$1[]];
+  contractAddresses: [Address, ...Address[]];
 }
 /**
  * Check whether a session signature is cached for the connected wallet
@@ -325,7 +301,7 @@ declare function useIsAllowed(config: UseIsAllowedConfig): _$_tanstack_react_que
  * revoke([tokenAddress, auctionAddress]);
  * ```
  */
-declare function useRevoke(options?: UseMutationOptions<void, Error, Address$1[]>): _$_tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
+declare function useRevoke(options?: UseMutationOptions<void, Error, Address[]>): _$_tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
 //#endregion
 //#region src/authorization/use-revoke-session.d.ts
 /**
@@ -344,13 +320,12 @@ declare function useRevokeSession(options?: UseMutationOptions<void>): _$_tansta
 /** Base configuration shared by all mutation hooks that need a Token instance. */
 interface UseZamaConfig {
   /** Address of the confidential token contract. */
-  tokenAddress: Address$1;
+  tokenAddress: Address;
   /** Address of the wrapper contract (required for shield/unshield operations). */
-  wrapperAddress?: Address$1;
+  wrapperAddress?: Address;
 }
 /**
  * Get a {@link Token} instance, memoized by address pair.
- * Reads signer and storage from the nearest {@link ZamaProvider}.
  *
  * @param config - Token and optional wrapper addresses.
  * @returns A memoized `Token` instance.
@@ -360,7 +335,7 @@ interface UseZamaConfig {
  * const token = useToken({ tokenAddress: "0xToken", wrapperAddress: "0xWrapper" });
  * ```
  */
-declare function useToken(config: UseZamaConfig): _$_zama_fhe_sdk0.Token;
+declare function useToken(config: UseZamaConfig): Token;
 //#endregion
 //#region src/token/use-readonly-token.d.ts
 /**
@@ -377,58 +352,49 @@ declare function useToken(config: UseZamaConfig): _$_zama_fhe_sdk0.Token;
  * // token.balanceOf(), token.isConfidential(), etc.
  * ```
  */
-declare function useReadonlyToken(address: Address$1): _$_zama_fhe_sdk0.ReadonlyToken;
+declare function useReadonlyToken(address: Address): _$_zama_fhe_sdk0.ReadonlyToken;
 //#endregion
 //#region src/balance/use-confidential-balance.d.ts
-/** Configuration for {@link useConfidentialBalance}. */
 interface UseConfidentialBalanceConfig {
   /** Address of the confidential token contract. */
-  tokenAddress: Address$1;
+  tokenAddress: Address;
+  /** Account to fetch balance for. The query is disabled while `undefined`. */
+  account: Address | undefined;
 }
-/** Query options for {@link useConfidentialBalance}. */
 interface UseConfidentialBalanceOptions extends Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn" | "enabled"> {
-  /** Whether the query is enabled. Callback form is not supported in composite hooks. */
+  /** Set this to `false` to disable this query from automatically running. */
   enabled?: boolean;
 }
 /**
- * Declarative hook to read the connected wallet's confidential token balance.
- * Calls `token.balanceOf(owner)` which reads the on-chain handle and decrypts
- * via the SDK. Cached values are returned instantly — the relayer is only hit
- * when the handle changes.
- *
- * @param config - Token address configuration.
- * @param options - React Query options forwarded to the balance query.
- * @returns The balance query result.
+ * Hook for fetching a confidential token balance. Reads the on-chain handle and
+ * decrypts via the SDK; cached values are returned instantly and the relayer is
+ * only hit when the handle changes.
  *
  * @example
  * ```tsx
- * const { data: balance, isLoading } = useConfidentialBalance({
- *   tokenAddress: "0x...",
+ * const { data: balance } = useConfidentialBalance({
+ *   tokenAddress: "0xToken",
+ *   account: "0xAccount",
  * });
  * ```
  */
 declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, options?: UseConfidentialBalanceOptions): _$_tanstack_react_query0.UseQueryResult<bigint, Error>;
 //#endregion
 //#region src/balance/use-confidential-balances.d.ts
-/** Configuration for {@link useConfidentialBalances}. */
 interface UseConfidentialBalancesConfig {
-  /** Addresses of the confidential token contracts to batch-query. */
-  tokenAddresses: Address$1[];
+  /** Addresses of the confidential token contracts to batch-query. The query is disabled while empty. */
+  tokenAddresses: Address[];
+  /** Account to fetch balances for. The query is disabled while `undefined`. */
+  account: Address | undefined;
 }
-/** Query options for {@link useConfidentialBalances}. */
-interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<BatchBalancesResult$1>, "queryKey" | "queryFn" | "enabled"> {
-  /** Whether the query is enabled. Callback form is not supported in composite hooks. */
+interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<BatchBalancesResult>, "queryKey" | "queryFn" | "enabled"> {
+  /** Set this to `false` to disable this query from automatically running. */
   enabled?: boolean;
 }
 /**
- * Declarative hook to read multiple confidential token balances in batch.
- * Calls `ReadonlyToken.batchBalancesOf()` which decrypts each token via the
- * SDK. Cached values are returned instantly — the relayer is only hit for
- * changed handles.
- *
- * Returns partial results when some tokens fail — successful balances are
- * always returned alongside per-token error information.
- *
+ * Hook for fetching multiple confidential token balances in batch. Returns
+ * partial results when some tokens fail — successful balances are available
+ * alongside per-token error information.
  * @param config - Token addresses configuration.
  * @param options - React Query options forwarded to the balance query.
  * @returns The balance query result.
@@ -437,6 +403,7 @@ interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<BatchBalan
  * ```tsx
  * const { data } = useConfidentialBalances({
  *   tokenAddresses: ["0xTokenA", "0xTokenB"],
+ *   account: "0xAccount",
  * });
  * const balance = data?.results.get("0xTokenA");
  * if (data && data.errors.size > 0) {
@@ -444,7 +411,7 @@ interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<BatchBalan
  * }
  * ```
  */
-declare function useConfidentialBalances(config: UseConfidentialBalancesConfig, options?: UseConfidentialBalancesOptions): _$_tanstack_react_query0.UseQueryResult<BatchBalancesResult$1, Error>;
+declare function useConfidentialBalances(config: UseConfidentialBalancesConfig, options?: UseConfidentialBalancesOptions): _$_tanstack_react_query0.UseQueryResult<BatchBalancesResult, Error>;
 //#endregion
 //#region src/transfer/use-confidential-transfer.d.ts
 /** Configuration for {@link useConfidentialTransfer}. */
@@ -486,7 +453,7 @@ interface UseConfidentialTransferConfig extends UseZamaConfig {
  * );
  * ```
  */
-declare function useConfidentialTransfer<TContext = unknown>(config: UseConfidentialTransferConfig, options?: UseMutationOptions<TransactionResult$1, Error, ConfidentialTransferParams$1, TContext>): UseMutationResult<TransactionResult$1, Error, ConfidentialTransferParams$1, TContext>;
+declare function useConfidentialTransfer<TContext = unknown>(config: UseConfidentialTransferConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferParams, TContext>): UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, TContext>;
 //#endregion
 //#region src/transfer/use-confidential-transfer-from.d.ts
 /**
@@ -507,7 +474,7 @@ declare function useConfidentialTransfer<TContext = unknown>(config: UseConfiden
  * transferFrom.mutate({ from: "0xOwner", to: "0xRecipient", amount: 500n });
  * ```
  */
-declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, ConfidentialTransferFromParams$1, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, ConfidentialTransferFromParams$1, `0x${string}`>;
+declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferFromParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ConfidentialTransferFromParams, `0x${string}`>;
 //#endregion
 //#region src/transfer/use-confidential-approve.d.ts
 /**
@@ -526,28 +493,27 @@ declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: Us
  * approve.mutate({ spender: "0xOperator" });
  * ```
  */
-declare function useConfidentialApprove(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, ConfidentialApproveParams$1, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, ConfidentialApproveParams$1, `0x${string}`>;
+declare function useConfidentialApprove(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialApproveParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ConfidentialApproveParams, `0x${string}`>;
 //#endregion
 //#region src/transfer/use-confidential-is-approved.d.ts
-/** Configuration for {@link useConfidentialIsApproved}. */
 interface UseConfidentialIsApprovedConfig {
-  /** Address of the confidential token contract. Pass `undefined` to disable the query. */
-  tokenAddress: Address$1 | undefined;
-  /** Address to check approval for. Pass `undefined` to disable the query. */
-  spender: Address$1 | undefined;
-  /** Token holder address. Defaults to the connected wallet. */
-  holder?: Address$1;
+  /** Address of the confidential token contract. The query is disabled while `undefined`. */
+  tokenAddress: Address | undefined;
+  /** Address to check approval for. The query is disabled while `undefined`. */
+  spender: Address | undefined;
+  /** Token holder address. The query is disabled while `undefined`. */
+  holder: Address | undefined;
 }
-/** Configuration for {@link useConfidentialIsApprovedSuspense}. */
-interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {
+interface UseConfidentialIsApprovedSuspenseConfig {
+  /** Address of the confidential token contract. */
+  tokenAddress: Address;
   /** Address to check approval for. */
-  spender: Address$1;
-  /** Token holder address. Defaults to the connected wallet. */
-  holder?: Address$1;
+  spender: Address;
+  /** Token holder address. */
+  holder: Address;
 }
 /**
- * Check if a spender is an approved operator for a given holder (defaults to connected wallet).
- *
+ * Check if a spender is an approved operator for a holder.
  * @param config - Token address, spender, and optional holder to check.
  * @param options - React Query options (forwarded to `useQuery`).
  * @returns Query result with `data: boolean`.
@@ -557,24 +523,21 @@ interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {
  * const { data: isApproved } = useConfidentialIsApproved({
  *   tokenAddress: "0xToken",
  *   spender: "0xSpender",
- *   holder: "0xHolder", // optional
+ *   holder: "0xHolder",
  * });
  * ```
  */
 declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConfig, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
 /**
- * Suspense variant of {@link useConfidentialIsApproved}.
- * Suspends rendering until the approval check resolves.
- *
- * @param config - Token address, spender, and optional holder to check.
- * @returns Suspense query result with `data: boolean`.
+ * Suspense variant of {@link useConfidentialIsApproved}. Suspends rendering
+ * until the approval check resolves.
  *
  * @example
  * ```tsx
  * const { data: isApproved } = useConfidentialIsApprovedSuspense({
  *   tokenAddress: "0xToken",
  *   spender: "0xSpender",
- *   holder: "0xHolder", // optional
+ *   holder: "0xHolder",
  * });
  * ```
  */
@@ -609,7 +572,7 @@ interface UseShieldConfig extends UseZamaConfig {
  * shield.mutate({ amount: 1000n });
  * ```
  */
-declare function useShield<TContext = unknown>(config: UseShieldConfig, options?: UseMutationOptions<TransactionResult$1, Error, ShieldParams$1, TContext>): UseMutationResult<TransactionResult$1, Error, ShieldParams$1, TContext>;
+declare function useShield<TContext = unknown>(config: UseShieldConfig, options?: UseMutationOptions<TransactionResult, Error, ShieldParams, TContext>): UseMutationResult<TransactionResult, Error, ShieldParams, TContext>;
 //#endregion
 //#region src/unwrap/use-unwrap.d.ts
 /**
@@ -631,7 +594,7 @@ declare function useShield<TContext = unknown>(config: UseShieldConfig, options?
  * unwrap.mutate({ amount: 500n });
  * ```
  */
-declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, UnwrapParams$1, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, UnwrapParams$1, `0x${string}`>;
+declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnwrapParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, UnwrapParams, `0x${string}`>;
 //#endregion
 //#region src/unwrap/use-unwrap-all.d.ts
 /**
@@ -652,7 +615,7 @@ declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<T
  * unwrapAll.mutate();
  * ```
  */
-declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, void, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, void, `0x${string}`>;
+declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, void, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, void, `0x${string}`>;
 //#endregion
 //#region src/unwrap/use-finalize-unwrap.d.ts
 /**
@@ -670,10 +633,16 @@ declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOption
  * @example
  * ```tsx
  * const finalize = useFinalizeUnwrap({ tokenAddress: "0x..." });
- * finalize.mutate({ unwrapRequestId: event.unwrapRequestId });
+ * const event = findUnwrapRequested(receipt.logs);
+ * // Pass unwrapRequestId from upgraded events, or fall back to encryptedAmount for legacy ones.
+ * finalize.mutate(
+ *   event.unwrapRequestId
+ *     ? { unwrapRequestId: event.unwrapRequestId }
+ *     : { burnAmountHandle: event.encryptedAmount },
+ * );
  * ```
  */
-declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, FinalizeUnwrapParams$1, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, FinalizeUnwrapParams$1, `0x${string}`>;
+declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, FinalizeUnwrapParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, FinalizeUnwrapParams, `0x${string}`>;
 //#endregion
 //#region src/unshield/use-unshield.d.ts
 /**
@@ -695,7 +664,7 @@ declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationO
  * unshield.mutate({ amount: 500n });
  * ```
  */
-declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, UnshieldParams$1, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, UnshieldParams$1, `0x${string}`>;
+declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnshieldParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, UnshieldParams, `0x${string}`>;
 //#endregion
 //#region src/unshield/use-unshield-all.d.ts
 /**
@@ -716,7 +685,7 @@ declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions
  * unshieldAll.mutate();
  * ```
  */
-declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, UnshieldAllParams$1 | void, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, void | UnshieldAllParams$1, `0x${string}`>;
+declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnshieldAllParams | void, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, void | UnshieldAllParams, `0x${string}`>;
 //#endregion
 //#region src/unshield/use-resume-unshield.d.ts
 /**
@@ -737,49 +706,53 @@ declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOpti
  * resumeUnshield.mutate({ unwrapTxHash: "0xabc..." });
  * ```
  */
-declare function useResumeUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, ResumeUnshieldParams$1, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, ResumeUnshieldParams$1, `0x${string}`>;
+declare function useResumeUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ResumeUnshieldParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ResumeUnshieldParams, `0x${string}`>;
 //#endregion
 //#region src/shield/use-underlying-allowance.d.ts
-/** Configuration for {@link useUnderlyingAllowance}. */
 interface UseUnderlyingAllowanceConfig {
   /** Address of the confidential token contract used to scope the query cache. */
-  tokenAddress: Address$1;
+  tokenAddress: Address;
   /** Address of the wrapper contract whose underlying ERC-20 allowance is checked. */
-  wrapperAddress: Address$1;
+  wrapperAddress: Address;
+  /** Owner to fetch allowance for. The query is disabled while `undefined`. */
+  owner: Address | undefined;
+}
+interface UseUnderlyingAllowanceSuspenseConfig {
+  /** Address of the confidential token contract used to scope the query cache. */
+  tokenAddress: Address;
+  /** Address of the wrapper contract whose underlying ERC-20 allowance is checked. */
+  wrapperAddress: Address;
+  /** Owner to fetch allowance for. */
+  owner: Address;
 }
 /**
- * Read the underlying ERC-20 allowance granted to the wrapper contract.
- * Useful to check if an approval is needed before shielding.
- *
- * @param config - Token and wrapper addresses.
- * @param options - React Query options (forwarded to `useQuery`).
- * @returns Query result with `data: bigint` (current allowance).
+ * Hook for fetching the underlying ERC-20 allowance granted to the wrapper
+ * contract. Useful to check if an approval is needed before shielding.
  *
  * @example
  * ```tsx
  * const { data: allowance } = useUnderlyingAllowance({
  *   tokenAddress: "0xConfidentialToken",
  *   wrapperAddress: "0xWrapper",
+ *   owner: "0xOwner",
  * });
  * ```
  */
 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.
- *
- * @param config - Token and wrapper addresses.
- * @returns Suspense query result with `data: bigint`.
+ * Suspense variant of {@link useUnderlyingAllowance}. Suspends rendering until
+ * the allowance resolves.
  *
  * @example
  * ```tsx
  * const { data: allowance } = useUnderlyingAllowanceSuspense({
  *   tokenAddress: "0xConfidentialToken",
  *   wrapperAddress: "0xWrapper",
+ *   owner: "0xOwner",
  * });
  * ```
  */
-declare function useUnderlyingAllowanceSuspense(config: UseUnderlyingAllowanceConfig): _$_tanstack_react_query0.UseSuspenseQueryResult<bigint, Error>;
+declare function useUnderlyingAllowanceSuspense(config: UseUnderlyingAllowanceSuspenseConfig): _$_tanstack_react_query0.UseSuspenseQueryResult<bigint, Error>;
 //#endregion
 //#region src/token/use-wrapper-discovery.d.ts
 /** Configuration for {@link useWrapperDiscovery}. */
@@ -789,9 +762,9 @@ interface UseWrapperDiscoveryConfig {
    * Used only to derive the signer context and to scope the query cache key —
    * it does not affect which wrapper the registry returns.
    */
-  tokenAddress: Address$1;
+  tokenAddress: Address;
   /** ERC-20 address to discover the wrapper for. Pass `undefined` to disable the query. */
-  erc20Address: Address$1 | undefined;
+  erc20Address: Address | undefined;
 }
 /** Configuration for {@link useWrapperDiscoverySuspense}. */
 interface UseWrapperDiscoverySuspenseConfig {
@@ -800,9 +773,9 @@ interface UseWrapperDiscoverySuspenseConfig {
    * Used only to derive the signer context and to scope the query cache key —
    * it does not affect which wrapper the registry returns.
    */
-  tokenAddress: Address$1;
+  tokenAddress: Address;
   /** ERC-20 address to discover the wrapper for. */
-  erc20Address: Address$1;
+  erc20Address: Address;
 }
 /**
  * Discover the confidential wrapper for an ERC-20 token via the on-chain registry.
@@ -821,7 +794,7 @@ interface UseWrapperDiscoverySuspenseConfig {
  * });
  * ```
  */
-declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address$1 | null>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<`0x${string}` | null, Error>;
+declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address | null>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<`0x${string}` | null, Error>;
 /**
  * Suspense variant of {@link useWrapperDiscovery}.
  * Suspends rendering until the wrapper address is resolved.
@@ -854,7 +827,7 @@ declare function useWrapperDiscoverySuspense(config: UseWrapperDiscoverySuspense
  * // metadata?.name, metadata?.symbol, metadata?.decimals
  * ```
  */
-declare function useMetadata(tokenAddress: Address$1, options?: Omit<UseQueryOptions<TokenMetadata>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<TokenMetadata, Error>;
+declare function useMetadata(tokenAddress: Address, options?: Omit<UseQueryOptions<TokenMetadata>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<TokenMetadata, Error>;
 /**
  * Suspense variant of {@link useMetadata}.
  * Suspends rendering until metadata is loaded.
@@ -867,7 +840,7 @@ declare function useMetadata(tokenAddress: Address$1, options?: Omit<UseQueryOpt
  * const { data: metadata } = useMetadataSuspense("0xToken");
  * ```
  */
-declare function useMetadataSuspense(tokenAddress: Address$1): _$_tanstack_react_query0.UseSuspenseQueryResult<TokenMetadata, Error>;
+declare function useMetadataSuspense(tokenAddress: Address): _$_tanstack_react_query0.UseSuspenseQueryResult<TokenMetadata, Error>;
 //#endregion
 //#region src/delegation/use-delegate-decryption.d.ts
 /**
@@ -882,7 +855,7 @@ declare function useMetadataSuspense(tokenAddress: Address$1): _$_tanstack_react
  * delegate.mutate({ delegateAddress: "0xDelegate" });
  * ```
  */
-declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, DelegateDecryptionParams$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, DelegateDecryptionParams$1, unknown>;
+declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, DelegateDecryptionParams>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, DelegateDecryptionParams, unknown>;
 //#endregion
 //#region src/delegation/use-revoke-delegation.d.ts
 /**
@@ -897,16 +870,16 @@ declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutat
  * revoke.mutate({ delegateAddress: "0xDelegate" });
  * ```
  */
-declare function useRevokeDelegation(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, RevokeDelegationParams$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, RevokeDelegationParams$1, unknown>;
+declare function useRevokeDelegation(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, RevokeDelegationParams>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, RevokeDelegationParams, unknown>;
 //#endregion
 //#region src/delegation/use-delegation-status.d.ts
 interface UseDelegationStatusConfig {
   /** Address of the confidential token contract. Pass `undefined` to disable the query. */
-  tokenAddress: Address$1 | undefined;
+  tokenAddress: Address | undefined;
   /** The address that granted the delegation. */
-  delegatorAddress?: Address$1;
+  delegatorAddress?: Address;
   /** The address that received delegation rights. */
-  delegateAddress?: Address$1;
+  delegateAddress?: Address;
 }
 /**
  * Query delegation status between a delegator and delegate for a token.
@@ -925,7 +898,7 @@ interface UseDelegationStatusConfig {
  * // data?.isDelegated, data?.expiryTimestamp
  * ```
  */
-declare function useDelegationStatus(config: UseDelegationStatusConfig, options?: Omit<UseQueryOptions<DelegationStatusData$1>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<DelegationStatusData$1, Error>;
+declare function useDelegationStatus(config: UseDelegationStatusConfig, options?: Omit<UseQueryOptions<DelegationStatusData>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<DelegationStatusData, Error>;
 //#endregion
 //#region src/delegation/use-decrypt-balance-as.d.ts
 /**
@@ -941,7 +914,7 @@ declare function useDelegationStatus(config: UseDelegationStatusConfig, options?
  * // decryptAs.data => 1000n
  * ```
  */
-declare function useDecryptBalanceAs(tokenAddress: Address$1, options?: UseMutationOptions<bigint, Error, DecryptBalanceAsParams$1>): _$_tanstack_react_query0.UseMutationResult<bigint, Error, DecryptBalanceAsParams$1, unknown>;
+declare function useDecryptBalanceAs(tokenAddress: Address, options?: UseMutationOptions<bigint, Error, DecryptBalanceAsParams>): _$_tanstack_react_query0.UseMutationResult<bigint, Error, DecryptBalanceAsParams, unknown>;
 //#endregion
 //#region src/delegation/use-batch-decrypt-balances-as.d.ts
 /**
@@ -959,7 +932,7 @@ declare function useDecryptBalanceAs(tokenAddress: Address$1, options?: UseMutat
  * // batchDecryptAs.data => Map { "0xTokenA" => 100n, "0xTokenB" => 200n }
  * ```
  */
-declare function useBatchDecryptBalancesAs(tokens: ReadonlyToken$1[], options?: UseMutationOptions<Map<Address$1, bigint>, Error, BatchDecryptBalancesAsParams$1>): _$_tanstack_react_query0.UseMutationResult<Map<`0x${string}`, bigint>, Error, _$_zama_fhe_sdk0.BatchDecryptAsOptions, unknown>;
+declare function useBatchDecryptBalancesAs(tokens: ReadonlyToken[], options?: UseMutationOptions<Map<Address, bigint>, Error, BatchDecryptBalancesAsParams>): _$_tanstack_react_query0.UseMutationResult<Map<`0x${string}`, bigint>, Error, _$_zama_fhe_sdk0.BatchDecryptAsOptions, unknown>;
 //#endregion
 //#region src/shield/use-approve-underlying.d.ts
 /**
@@ -981,7 +954,7 @@ declare function useBatchDecryptBalancesAs(tokens: ReadonlyToken$1[], options?:
  * approve.mutate({ amount: 1000n }); // exact amount
  * ```
  */
-declare function useApproveUnderlying(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, ApproveUnderlyingParams$1, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, ApproveUnderlyingParams$1, `0x${string}`>;
+declare function useApproveUnderlying(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ApproveUnderlyingParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ApproveUnderlyingParams, `0x${string}`>;
 //#endregion
 //#region src/token/use-is-confidential.d.ts
 /**
@@ -997,7 +970,7 @@ declare function useApproveUnderlying(config: UseZamaConfig, options?: UseMutati
  * const { data: isConfidential } = useIsConfidential("0xToken");
  * ```
  */
-declare function useIsConfidential(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
+declare function useIsConfidential(tokenAddress: Address, 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.
@@ -1010,7 +983,7 @@ declare function useIsConfidential(tokenAddress: Address$1, options?: Omit<UseQu
  * const { data: isConfidential } = useIsConfidentialSuspense("0xToken");
  * ```
  */
-declare function useIsConfidentialSuspense(tokenAddress: Address$1): _$_tanstack_react_query0.UseSuspenseQueryResult<boolean, Error>;
+declare function useIsConfidentialSuspense(tokenAddress: Address): _$_tanstack_react_query0.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.
@@ -1024,7 +997,7 @@ declare function useIsConfidentialSuspense(tokenAddress: Address$1): _$_tanstack
  * const { data: isWrapper } = useIsWrapper("0xToken");
  * ```
  */
-declare function useIsWrapper(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
+declare function useIsWrapper(tokenAddress: Address, 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.
@@ -1037,7 +1010,7 @@ declare function useIsWrapper(tokenAddress: Address$1, options?: Omit<UseQueryOp
  * const { data: isWrapper } = useIsWrapperSuspense("0xToken");
  * ```
  */
-declare function useIsWrapperSuspense(tokenAddress: Address$1): _$_tanstack_react_query0.UseSuspenseQueryResult<boolean, Error>;
+declare function useIsWrapperSuspense(tokenAddress: Address): _$_tanstack_react_query0.UseSuspenseQueryResult<boolean, Error>;
 //#endregion
 //#region src/token/use-total-supply.d.ts
 /**
@@ -1047,32 +1020,35 @@ declare function useIsWrapperSuspense(tokenAddress: Address$1): _$_tanstack_reac
  * @param tokenAddress - Address of the token contract.
  * @param options - React Query options (forwarded to `useQuery`).
  * @returns Query result with `data: bigint`.
+ * Uses ERC-165 to call `inferredTotalSupply()` on upgraded wrappers and
+ * legacy `totalSupply()` on pre-upgrade wrappers.
  *
  * @example
  * ```tsx
  * const { data: totalSupply } = useTotalSupply("0xToken");
  * ```
  */
-declare function useTotalSupply(tokenAddress: Address$1, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<bigint, Error>;
+declare function useTotalSupply(tokenAddress: Address, 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.
  *
  * @param tokenAddress - Address of the token contract.
  * @returns Suspense query result with `data: bigint`.
+ * Uses ERC-165 to call `inferredTotalSupply()` on upgraded wrappers and
+ * legacy `totalSupply()` on pre-upgrade wrappers.
  *
  * @example
  * ```tsx
  * const { data: totalSupply } = useTotalSupplySuspense("0xToken");
  * ```
  */
-declare function useTotalSupplySuspense(tokenAddress: Address$1): _$_tanstack_react_query0.UseSuspenseQueryResult<bigint, Error>;
+declare function useTotalSupplySuspense(tokenAddress: Address): _$_tanstack_react_query0.UseSuspenseQueryResult<bigint, Error>;
 //#endregion
 //#region src/wrappers-registry/use-wrappers-registry-address.d.ts
 /**
  * Resolves the wrappers registry address for the current chain.
- * Uses the merged registry addresses from `sdk.registry` (built-in defaults
- * plus any `registryAddresses` overrides passed to `ZamaSDKConfig`).
+ * Uses the registry addresses from `sdk.registry` (built-in defaults from chain configs).
  *
  * Returns `undefined` when the chain ID hasn't been fetched yet
  * or when no registry is configured for the connected chain.
@@ -1080,14 +1056,14 @@ declare function useTotalSupplySuspense(tokenAddress: Address$1): _$_tanstack_re
  * The chain ID is cached for 30 seconds (`staleTime`), so chain
  * switches may take up to 30s to reflect.
  */
-declare function useWrappersRegistryAddress(): Address$1 | undefined;
+declare function useWrappersRegistryAddress(): Address | undefined;
 //#endregion
 //#region src/wrappers-registry/use-token-pairs-registry.d.ts
 /**
  * Fetches all token wrapper pairs from the ConfidentialTokenWrappersRegistry
  * contract on the current chain.
  */
-declare function useTokenPairsRegistry(): _$_tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair$1[], Error>;
+declare function useTokenPairsRegistry(): _$_tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair[], Error>;
 //#endregion
 //#region src/wrappers-registry/use-token-pairs-length.d.ts
 /**
@@ -1108,7 +1084,7 @@ declare function useTokenPairsSlice({
 }: {
   fromIndex: bigint | undefined;
   toIndex: bigint | undefined;
-}): _$_tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair$1[], Error>;
+}): _$_tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair[], Error>;
 //#endregion
 //#region src/wrappers-registry/use-token-pair.d.ts
 /**
@@ -1120,7 +1096,7 @@ declare function useTokenPair({
   index
 }: {
   index: bigint | undefined;
-}): _$_tanstack_react_query0.UseQueryResult<TokenWrapperPair$1, Error>;
+}): _$_tanstack_react_query0.UseQueryResult<TokenWrapperPair, Error>;
 //#endregion
 //#region src/wrappers-registry/use-confidential-token-address.d.ts
 /**
@@ -1129,7 +1105,7 @@ declare function useTokenPair({
 declare function useConfidentialTokenAddress({
   tokenAddress
 }: {
-  tokenAddress: Address$1 | undefined;
+  tokenAddress: Address | undefined;
 }): _$_tanstack_react_query0.UseQueryResult<readonly [boolean, `0x${string}`], Error>;
 //#endregion
 //#region src/wrappers-registry/use-token-address.d.ts
@@ -1139,7 +1115,7 @@ declare function useConfidentialTokenAddress({
 declare function useTokenAddress({
   confidentialTokenAddress
 }: {
-  confidentialTokenAddress: Address$1 | undefined;
+  confidentialTokenAddress: Address | undefined;
 }): _$_tanstack_react_query0.UseQueryResult<readonly [boolean, `0x${string}`], Error>;
 //#endregion
 //#region src/wrappers-registry/use-is-confidential-token-valid.d.ts
@@ -1152,7 +1128,7 @@ declare function useTokenAddress({
 declare function useIsConfidentialTokenValid({
   confidentialTokenAddress
 }: {
-  confidentialTokenAddress: Address$1 | undefined;
+  confidentialTokenAddress: Address | undefined;
 }): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
 //#endregion
 //#region src/wrappers-registry/use-list-pairs.d.ts
@@ -1177,15 +1153,7 @@ declare function useListPairs({
   page?: number;
   pageSize?: number;
   metadata?: boolean;
-}): _$_tanstack_react_query0.UseQueryResult<PaginatedResult$1<TokenWrapperPair$1 | TokenWrapperPairWithMetadata$1>, Error>;
-//#endregion
-//#region src/balance/optimistic-balance-update.d.ts
-type OptimisticBalanceSnapshot = [QueryKey, bigint | undefined][];
-/** Combined context returned by optimistic `onMutate`. */
-interface OptimisticMutateContext {
-  snapshot: OptimisticBalanceSnapshot;
-  callerContext?: unknown;
-}
+}): _$_tanstack_react_query0.UseQueryResult<PaginatedResult<TokenWrapperPair | TokenWrapperPairWithMetadata>, Error>;
 //#endregion
-export { ACL_TOPICS, type AclEvent, AclPausedError, type Address, ApprovalFailedError, type ApproveSubmittedEvent, type ApproveUnderlyingParams, type ApproveUnderlyingSubmittedEvent, BalanceCheckUnavailableError, type BaseEvent, type BatchBalancesResult, type BatchDecryptAsOptions, type BatchDecryptBalancesAsParams, ChromeSessionStorage, type ClearValueType, type ConfidentialApproveParams, type ConfidentialTransferEvent, type ConfidentialTransferFromParams, type ConfidentialTransferParams, ConfigurationError, type ContractAbi, type CreateDelegatedUserDecryptEIP712Params, type CreateEIP712Params, type CredentialsAllowedEvent, type CredentialsCachedEvent, type CredentialsCreatedEvent, type CredentialsCreatingEvent, type CredentialsExpiredEvent, type CredentialsLoadingEvent, CredentialsManager, type CredentialsManagerConfig, type CredentialsRevokedEvent, type DecryptBalanceAsParams, type DecryptEndEvent, type DecryptErrorEvent, type DecryptHandle, type DecryptResult, type DecryptStartEvent, DecryptionFailedError, DefaultRegistryAddresses, type DelegateDecryptionParams, DelegatedCredentialsManager, type DelegatedCredentialsManagerConfig, type DelegatedForUserDecryptionEvent, type DelegatedStoredCredentials, type DelegatedUserDecryptParams, DelegationContractIsSelfError, DelegationCooldownError, DelegationDelegateEqualsContractError, DelegationExpirationTooSoonError, DelegationExpiredError, DelegationExpiryUnchangedError, DelegationNotFoundError, DelegationNotPropagatedError, DelegationSelfNotAllowedError, type DelegationStatusData, type DelegationStatusQueryConfig, type EIP712TypedData, ERC20ReadFailedError, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, type EncryptEndEvent, type EncryptErrorEvent, type EncryptInput, type EncryptParams, type EncryptResult, type EncryptStartEvent, EncryptionFailedError, type FheTypeName, type FhevmInstanceConfig, type FinalizeUnwrapParams, type FinalizeUnwrapSubmittedEvent, type GenericSigner, type GenericStorage, type Handle, HardhatConfig, type Hex, IndexedDBStorage, type InputProofBytesType, InsufficientConfidentialBalanceError, InsufficientERC20BalanceError, InvalidKeypairError, KeypairExpiredError, type KeypairType, type KmsDelegatedUserDecryptEIP712Type, type ListPairsOptions, type ListPairsQueryConfig, MainnetConfig, MemoryStorage, type NetworkType, NoCiphertextError, type OnChainEvent, type OptimisticBalanceSnapshot, type OptimisticMutateContext, type PaginatedResult, type PublicDecryptResult, type PublicKeyData, type PublicParamsData, type RawLog, type ReadContractArgs, type ReadContractConfig, type ReadContractReturnType, type ReadFunctionName, ReadonlyToken, RelayerRequestFailedError, type RelayerSDK, type RelayerSDKStatus, RelayerWeb, type RelayerWebConfig, type RelayerWebSecurityConfig, type ResumeUnshieldParams, type RevokeDelegationParams, type RevokedDelegationForUserDecryptionEvent, SepoliaConfig, type SessionExpiredEvent, type ShieldCallbacks, type ShieldParams, type ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, type StoredCredentials, TOKEN_TOPICS, Token, type TokenMetadata, type TokenWrapperPair, type TokenWrapperPairWithMetadata, Topics, type TransactionErrorEvent, type TransactionReceipt, type TransactionResult, TransactionRevertedError, type TransferCallbacks, type TransferFromSubmittedEvent, type TransferSubmittedEvent, type UnshieldAllParams, type UnshieldCallbacks, type UnshieldParams, type UnshieldPhase1SubmittedEvent, type UnshieldPhase2StartedEvent, type UnshieldPhase2SubmittedEvent, type UnwrapParams, type UnwrapRequestedEvent, type UnwrapSubmittedEvent, type UnwrappedFinalizedEvent, type UnwrappedStartedEvent, type UseConfidentialBalanceConfig, type UseConfidentialBalanceOptions, type UseConfidentialBalancesConfig, type UseConfidentialBalancesOptions, type UseConfidentialIsApprovedConfig, type UseConfidentialIsApprovedSuspenseConfig, type UseConfidentialTransferConfig, type UseDelegationStatusConfig, type UseIsAllowedConfig, type UseShieldConfig, type UseUnderlyingAllowanceConfig, type UseUserDecryptResult, type UseWrapperDiscoveryConfig, type UseWrapperDiscoverySuspenseConfig, type UseZamaConfig, type UserDecryptParams, type UserDecryptQueryConfig, type WrappedEvent, WrappersRegistry, type WrappersRegistryConfig, type WriteContractArgs, type WriteContractConfig, type WriteFunctionName, ZERO_HANDLE, type ZKProofLike, ZamaError, ZamaErrorCode, ZamaProvider, type ZamaProviderProps, ZamaSDK, type ZamaSDKConfig, type ZamaSDKEvent, type ZamaSDKEventInput, type ZamaSDKEventListener, type ZamaSDKEventType, ZamaSDKEvents, allowMutationOptions, allowanceContract, approveContract, approveUnderlyingMutationOptions, balanceOfContract, batchDecryptBalancesAsMutationOptions, chromeSessionStorage, clearPendingUnshield, confidentialApproveMutationOptions, confidentialBalanceOfContract, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, createDelegatedUserDecryptEIP712MutationOptions, createEIP712MutationOptions, decimalsContract, decodeAclEvent, decodeAclEvents, decodeConfidentialTransfer, decodeDelegatedForUserDecryption, decodeOnChainEvent, decodeOnChainEvents, decodeRevokedDelegationForUserDecryption, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, decryptBalanceAsMutationOptions, delegateDecryptionMutationOptions, delegateForUserDecryptionContract, delegatedUserDecryptMutationOptions, delegationStatusQueryOptions, encryptMutationOptions, filterQueryOptions, finalizeUnwrapContract, finalizeUnwrapMutationOptions, findDelegatedForUserDecryption, findRevokedDelegationForUserDecryption, findUnwrapRequested, findWrapped, generateKeypairMutationOptions, getDelegationExpiryContract, hashFn, indexedDBStorage, inferredTotalSupplyContract, isAllowedQueryOptions, isConfidentialQueryOptions, isConfidentialTokenContract, isConfidentialWrapperContract, isHandleDelegatedContract, isOperatorContract, isWrapperQueryOptions, isZeroHandle, listPairsQueryOptions, loadPendingUnshield, matchAclRevert, matchZamaError, memoryStorage, nameContract, publicDecryptMutationOptions, publicKeyQueryOptions, publicParamsQueryOptions, rateContract, requestZKProofVerificationMutationOptions, resumeUnshieldMutationOptions, revokeDelegationContract, revokeDelegationMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, savePendingUnshield, setOperatorContract, shieldMutationOptions, signerAddressQueryOptions, supportsInterfaceContract, symbolContract, tokenMetadataQueryOptions, totalSupplyContract, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, underlyingContract, unshieldAllMutationOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapContract, unwrapFromBalanceContract, unwrapMutationOptions, useAllow, useApproveUnderlying, useBatchDecryptBalancesAs, useConfidentialApprove, useConfidentialBalance, useConfidentialBalances, useConfidentialIsApproved, useConfidentialIsApprovedSuspense, useConfidentialTokenAddress, useConfidentialTransfer, useConfidentialTransferFrom, useCreateDelegatedUserDecryptEIP712, useCreateEIP712, useDecryptBalanceAs, useDelegateDecryption, useDelegatedUserDecrypt, useDelegationStatus, useEncrypt, useFinalizeUnwrap, useGenerateKeypair, useIsAllowed, useIsConfidential, useIsConfidentialSuspense, useIsConfidentialTokenValid, useIsWrapper, useIsWrapperSuspense, useListPairs, useMetadata, useMetadataSuspense, usePublicDecrypt, usePublicKey, usePublicParams, useReadonlyToken, useRequestZKProofVerification, useResumeUnshield, useRevoke, useRevokeDelegation, useRevokeSession, useShield, useToken, useTokenAddress, useTokenPair, useTokenPairsLength, useTokenPairsRegistry, useTokenPairsSlice, useTotalSupply, useTotalSupplySuspense, useUnderlyingAllowance, useUnderlyingAllowanceSuspense, useUnshield, useUnshieldAll, useUnwrap, useUnwrapAll, useUserDecrypt, useWrapperDiscovery, useWrapperDiscoverySuspense, useWrappersRegistryAddress, useZamaSDK, userDecryptQueryOptions, wrapContract, wrapperDiscoveryQueryOptions, zamaQueryKeys };
+export { type UseConfidentialBalanceConfig, type UseConfidentialBalanceOptions, type UseConfidentialBalancesConfig, type UseConfidentialBalancesOptions, type UseConfidentialIsApprovedConfig, type UseConfidentialIsApprovedSuspenseConfig, type UseConfidentialTransferConfig, type UseDelegationStatusConfig, type UseIsAllowedConfig, type UseShieldConfig, type UseUnderlyingAllowanceConfig, type UseUnderlyingAllowanceSuspenseConfig, type UseUserDecryptResult, type UseWrapperDiscoveryConfig, type UseWrapperDiscoverySuspenseConfig, type UseZamaConfig, ZamaProvider, type ZamaProviderProps, useAllow, useApproveUnderlying, useBatchDecryptBalancesAs, useConfidentialApprove, useConfidentialBalance, useConfidentialBalances, useConfidentialIsApproved, useConfidentialIsApprovedSuspense, useConfidentialTokenAddress, useConfidentialTransfer, useConfidentialTransferFrom, useCreateDelegatedUserDecryptEIP712, useCreateEIP712, useDecryptBalanceAs, useDelegateDecryption, useDelegatedUserDecrypt, useDelegationStatus, useEncrypt, useFinalizeUnwrap, useGenerateKeypair, useIsAllowed, useIsConfidential, useIsConfidentialSuspense, useIsConfidentialTokenValid, useIsWrapper, useIsWrapperSuspense, useListPairs, useMetadata, useMetadataSuspense, usePublicDecrypt, usePublicKey, usePublicParams, useReadonlyToken, useRequestZKProofVerification, useResumeUnshield, useRevoke, useRevokeDelegation, useRevokeSession, useShield, useSignerAddress, useSignerAddressSuspense, useToken, useTokenAddress, useTokenPair, useTokenPairsLength, useTokenPairsRegistry, useTokenPairsSlice, useTotalSupply, useTotalSupplySuspense, useUnderlyingAllowance, useUnderlyingAllowanceSuspense, useUnshield, useUnshieldAll, useUnwrap, useUnwrapAll, useUserDecrypt, useWrapperDiscovery, useWrapperDiscoverySuspense, useWrappersRegistryAddress, useZamaSDK };
 //# sourceMappingURL=index.d.ts.map