@zama-fhe/react-sdk 3.0.0-alpha.9 → 3.0.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 "use client";
 
 import * as _$_zama_fhe_sdk0 from "@zama-fhe/sdk";
-import { Address, BatchBalancesResult, ClearValueType, DelegatedUserDecryptParams, EIP712TypedData, EncryptParams, GenericSigner, GenericStorage, PaginatedResult, PublicKeyData, ReadonlyToken, RelayerSDK, TokenWrapperPair, TokenWrapperPairWithMetadata, TransactionResult, ZKProofLike, ZamaSDK, ZamaSDKEventListener } 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 { ACL_TOPICS, AclEvent, AclPausedError, ActivityAmount, ActivityDirection, ActivityItem, ActivityItem as ActivityItem$1, ActivityLogMetadata, ActivityLogMetadata as ActivityLogMetadata$1, ActivityType, 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, RawLog as RawLog$1, 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, applyDecryptedValues, approveContract, balanceOfContract, chromeSessionStorage, clearPendingUnshield, confidentialBalanceOfContract, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, decimalsContract, decodeAclEvent, decodeAclEvents, decodeConfidentialTransfer, decodeDelegatedForUserDecryption, decodeOnChainEvent, decodeOnChainEvents, decodeRevokedDelegationForUserDecryption, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, delegateForUserDecryptionContract, extractEncryptedHandles, finalizeUnwrapContract, findDelegatedForUserDecryption, findRevokedDelegationForUserDecryption, findUnwrapRequested, findWrapped, getDelegationExpiryContract, indexedDBStorage, inferredTotalSupplyContract, isConfidentialTokenContract, isConfidentialWrapperContract, isHandleDelegatedContract, isOperatorContract, isZeroHandle, loadPendingUnshield, matchAclRevert, matchZamaError, memoryStorage, nameContract, parseActivityFeed, rateContract, revokeDelegationContract, savePendingUnshield, setOperatorContract, sortByBlockNumber, 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, activityFeedQueryOptions, 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 * as _$_tanstack_react_query0 from "@tanstack/react-query";
-import { UseMutationOptions, UseMutationResult, UseQueryOptions } from "@tanstack/react-query";
+import { QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions } 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";
@@ -13,16 +13,16 @@ import * as _$_zama_fhe_relayer_sdk_web0 from "@zama-fhe/relayer-sdk/web";
 /** Props for {@link ZamaProvider}. */
 interface ZamaProviderProps extends PropsWithChildren {
   /** FHE relayer backend (RelayerWeb for browser, RelayerNode for server). */
-  relayer: RelayerSDK;
+  relayer: RelayerSDK$1;
   /** Wallet signer (`ViemSigner`, `EthersSigner`, or custom {@link GenericSigner}). */
-  signer: GenericSigner;
+  signer: GenericSigner$1;
   /** Credential storage backend (IndexedDBStorage for browser, MemoryStorage for tests). */
-  storage: GenericStorage;
+  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;
+  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.
@@ -39,14 +39,14 @@ interface ZamaProviderProps extends PropsWithChildren {
    * 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>;
+  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;
+  onEvent?: ZamaSDKEventListener$1;
 }
 /**
  * Provides a {@link ZamaSDK} instance to all descendant hooks.
@@ -80,7 +80,7 @@ declare function ZamaProvider({
  * const token = sdk.createReadonlyToken("0x...");
  * ```
  */
-declare function useZamaSDK(): ZamaSDK;
+declare function useZamaSDK(): ZamaSDK$1;
 //#endregion
 //#region src/relayer/use-encrypt.d.ts
 /**
@@ -98,17 +98,14 @@ declare function useZamaSDK(): ZamaSDK;
  * encrypt.mutate({ values: [{ value: 1000n, type: "euint64" }], contractAddress: "0x...", userAddress: "0x..." });
  * ```
  */
-declare function useEncrypt(): _$_tanstack_react_query0.UseMutationResult<Readonly<{
-  handles: Uint8Array[];
-  inputProof: Uint8Array;
-}>, Error, EncryptParams, unknown>;
+declare function useEncrypt(): _$_tanstack_react_query0.UseMutationResult<EncryptResult$1, Error, EncryptParams$1, 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, options?: Omit<UseQueryOptions<DecryptResult>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<Readonly<Record<`0x${string}`, _$_zama_fhe_sdk0.ClearValueType>>, Error>;
+declare function useUserDecrypt(config: UserDecryptQueryConfig$1, options?: Omit<UseQueryOptions<DecryptResult$1>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<DecryptResult$1, Error>;
 /** Return type of {@link useUserDecrypt}. */
 type UseUserDecryptResult = ReturnType<typeof useUserDecrypt>;
 //#endregion
@@ -127,11 +124,7 @@ type UseUserDecryptResult = ReturnType<typeof useUserDecrypt>;
  * // publicDecrypt.data?.clearValues => { "0xHandle1": 500n, ... }
  * ```
  */
-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>;
+declare function usePublicDecrypt(): _$_tanstack_react_query0.UseMutationResult<PublicDecryptResult$1, Error, `0x${string}`[], unknown>;
 //#endregion
 //#region src/relayer/use-generate-keypair.d.ts
 /**
@@ -169,7 +162,7 @@ declare function useGenerateKeypair(): _$_tanstack_react_query0.UseMutationResul
  * });
  * ```
  */
-declare function useCreateEIP712(): _$_tanstack_react_query0.UseMutationResult<EIP712TypedData, Error, CreateEIP712Params, unknown>;
+declare function useCreateEIP712(): _$_tanstack_react_query0.UseMutationResult<EIP712TypedData$1, Error, CreateEIP712Params, unknown>;
 //#endregion
 //#region src/relayer/use-create-delegated-user-decrypt-eip712.d.ts
 /**
@@ -210,7 +203,7 @@ declare function useCreateDelegatedUserDecryptEIP712(): _$_tanstack_react_query0
  * // decrypt.data => { "0xHandle1": 1000n }
  * ```
  */
-declare function useDelegatedUserDecrypt(): _$_tanstack_react_query0.UseMutationResult<Record<`0x${string}`, ClearValueType>, Error, DelegatedUserDecryptParams, unknown>;
+declare function useDelegatedUserDecrypt(): _$_tanstack_react_query0.UseMutationResult<Record<`0x${string}`, ClearValueType$1>, Error, DelegatedUserDecryptParams$1, unknown>;
 //#endregion
 //#region src/relayer/use-request-zk-proof-verification.d.ts
 /**
@@ -229,9 +222,16 @@ declare function useDelegatedUserDecrypt(): _$_tanstack_react_query0.UseMutation
 declare function useRequestZKProofVerification(): _$_tanstack_react_query0.UseMutationResult<Readonly<{
   handles: Uint8Array[];
   inputProof: Uint8Array;
-}>, Error, ZKProofLike, unknown>;
+}>, Error, ZKProofLike$1, 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,6 +247,13 @@ declare function useRequestZKProofVerification(): _$_tanstack_react_query0.UseMu
 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.
@@ -260,10 +267,7 @@ declare function usePublicKey(): _$_tanstack_react_query0.UseQueryResult<PublicK
  * // params?.publicParams, params?.publicParamsId
  * ```
  */
-declare function usePublicParams(bits: number): _$_tanstack_react_query0.UseQueryResult<{
-  publicParams: Uint8Array<ArrayBufferLike>;
-  publicParamsId: string;
-} | null, Error>;
+declare function usePublicParams(bits: number): _$_tanstack_react_query0.UseQueryResult<PublicParamsData | null, Error>;
 //#endregion
 //#region src/authorization/use-allow.d.ts
 /**
@@ -286,13 +290,13 @@ declare function usePublicParams(bits: number): _$_tanstack_react_query0.UseQuer
  * await allow([tokenAddress, auctionAddress, governanceAddress]);
  * ```
  */
-declare function useAllow(options?: UseMutationOptions<void, Error, Address[]>): _$_tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
+declare function useAllow(options?: UseMutationOptions<void, Error, Address$1[]>): _$_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, ...Address[]];
+  contractAddresses: [Address$1, ...Address$1[]];
 }
 /**
  * Check whether a session signature is cached for the connected wallet
@@ -321,7 +325,7 @@ declare function useIsAllowed(config: UseIsAllowedConfig): _$_tanstack_react_que
  * revoke([tokenAddress, auctionAddress]);
  * ```
  */
-declare function useRevoke(options?: UseMutationOptions<void, Error, Address[]>): _$_tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
+declare function useRevoke(options?: UseMutationOptions<void, Error, Address$1[]>): _$_tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
 //#endregion
 //#region src/authorization/use-revoke-session.d.ts
 /**
@@ -340,9 +344,9 @@ 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;
+  tokenAddress: Address$1;
   /** Address of the wrapper contract (required for shield/unshield operations). */
-  wrapperAddress?: Address;
+  wrapperAddress?: Address$1;
 }
 /**
  * Get a {@link Token} instance, memoized by address pair.
@@ -373,13 +377,13 @@ declare function useToken(config: UseZamaConfig): _$_zama_fhe_sdk0.Token;
  * // token.balanceOf(), token.isConfidential(), etc.
  * ```
  */
-declare function useReadonlyToken(address: Address): _$_zama_fhe_sdk0.ReadonlyToken;
+declare function useReadonlyToken(address: Address$1): _$_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;
+  tokenAddress: Address$1;
 }
 /** Query options for {@link useConfidentialBalance}. */
 interface UseConfidentialBalanceOptions extends Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn" | "enabled"> {
@@ -409,10 +413,10 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
 /** Configuration for {@link useConfidentialBalances}. */
 interface UseConfidentialBalancesConfig {
   /** Addresses of the confidential token contracts to batch-query. */
-  tokenAddresses: Address[];
+  tokenAddresses: Address$1[];
 }
 /** Query options for {@link useConfidentialBalances}. */
-interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<BatchBalancesResult>, "queryKey" | "queryFn" | "enabled"> {
+interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<BatchBalancesResult$1>, "queryKey" | "queryFn" | "enabled"> {
   /** Whether the query is enabled. Callback form is not supported in composite hooks. */
   enabled?: boolean;
 }
@@ -440,7 +444,7 @@ interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<BatchBalan
  * }
  * ```
  */
-declare function useConfidentialBalances(config: UseConfidentialBalancesConfig, options?: UseConfidentialBalancesOptions): _$_tanstack_react_query0.UseQueryResult<BatchBalancesResult, Error>;
+declare function useConfidentialBalances(config: UseConfidentialBalancesConfig, options?: UseConfidentialBalancesOptions): _$_tanstack_react_query0.UseQueryResult<BatchBalancesResult$1, Error>;
 //#endregion
 //#region src/transfer/use-confidential-transfer.d.ts
 /** Configuration for {@link useConfidentialTransfer}. */
@@ -482,7 +486,7 @@ interface UseConfidentialTransferConfig extends UseZamaConfig {
  * );
  * ```
  */
-declare function useConfidentialTransfer<TContext = unknown>(config: UseConfidentialTransferConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferParams, TContext>): UseMutationResult<TransactionResult, Error, ConfidentialTransferParams, TContext>;
+declare function useConfidentialTransfer<TContext = unknown>(config: UseConfidentialTransferConfig, options?: UseMutationOptions<TransactionResult$1, Error, ConfidentialTransferParams$1, TContext>): UseMutationResult<TransactionResult$1, Error, ConfidentialTransferParams$1, TContext>;
 //#endregion
 //#region src/transfer/use-confidential-transfer-from.d.ts
 /**
@@ -503,7 +507,7 @@ declare function useConfidentialTransfer<TContext = unknown>(config: UseConfiden
  * transferFrom.mutate({ from: "0xOwner", to: "0xRecipient", amount: 500n });
  * ```
  */
-declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialTransferFromParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ConfidentialTransferFromParams, `0x${string}`>;
+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}`>;
 //#endregion
 //#region src/transfer/use-confidential-approve.d.ts
 /**
@@ -522,24 +526,24 @@ declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: Us
  * approve.mutate({ spender: "0xOperator" });
  * ```
  */
-declare function useConfidentialApprove(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ConfidentialApproveParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ConfidentialApproveParams, `0x${string}`>;
+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}`>;
 //#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 | undefined;
+  tokenAddress: Address$1 | undefined;
   /** Address to check approval for. Pass `undefined` to disable the query. */
-  spender: Address | undefined;
+  spender: Address$1 | undefined;
   /** Token holder address. Defaults to the connected wallet. */
-  holder?: Address;
+  holder?: Address$1;
 }
 /** Configuration for {@link useConfidentialIsApprovedSuspense}. */
 interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {
   /** Address to check approval for. */
-  spender: Address;
+  spender: Address$1;
   /** Token holder address. Defaults to the connected wallet. */
-  holder?: Address;
+  holder?: Address$1;
 }
 /**
  * Check if a spender is an approved operator for a given holder (defaults to connected wallet).
@@ -605,7 +609,7 @@ interface UseShieldConfig extends UseZamaConfig {
  * shield.mutate({ amount: 1000n });
  * ```
  */
-declare function useShield<TContext = unknown>(config: UseShieldConfig, options?: UseMutationOptions<TransactionResult, Error, ShieldParams, TContext>): UseMutationResult<TransactionResult, Error, ShieldParams, TContext>;
+declare function useShield<TContext = unknown>(config: UseShieldConfig, options?: UseMutationOptions<TransactionResult$1, Error, ShieldParams$1, TContext>): UseMutationResult<TransactionResult$1, Error, ShieldParams$1, TContext>;
 //#endregion
 //#region src/unwrap/use-unwrap.d.ts
 /**
@@ -627,7 +631,7 @@ declare function useShield<TContext = unknown>(config: UseShieldConfig, options?
  * unwrap.mutate({ amount: 500n });
  * ```
  */
-declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnwrapParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, UnwrapParams, `0x${string}`>;
+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}`>;
 //#endregion
 //#region src/unwrap/use-unwrap-all.d.ts
 /**
@@ -648,7 +652,7 @@ declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<T
  * unwrapAll.mutate();
  * ```
  */
-declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, void, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, void, `0x${string}`>;
+declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, void, Address$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, void, `0x${string}`>;
 //#endregion
 //#region src/unwrap/use-finalize-unwrap.d.ts
 /**
@@ -666,10 +670,10 @@ declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOption
  * @example
  * ```tsx
  * const finalize = useFinalizeUnwrap({ tokenAddress: "0x..." });
- * finalize.mutate({ unwrapRequestId: event.unwrapRequestId });
+ * finalize.mutate({ burnAmountHandle: event.encryptedAmount });
  * ```
  */
-declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, FinalizeUnwrapParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, FinalizeUnwrapParams, `0x${string}`>;
+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}`>;
 //#endregion
 //#region src/unshield/use-unshield.d.ts
 /**
@@ -691,7 +695,7 @@ declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationO
  * unshield.mutate({ amount: 500n });
  * ```
  */
-declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnshieldParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, UnshieldParams, `0x${string}`>;
+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}`>;
 //#endregion
 //#region src/unshield/use-unshield-all.d.ts
 /**
@@ -712,7 +716,7 @@ declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions
  * unshieldAll.mutate();
  * ```
  */
-declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, UnshieldAllParams | void, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, void | UnshieldAllParams, `0x${string}`>;
+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}`>;
 //#endregion
 //#region src/unshield/use-resume-unshield.d.ts
 /**
@@ -733,15 +737,15 @@ declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOpti
  * resumeUnshield.mutate({ unwrapTxHash: "0xabc..." });
  * ```
  */
-declare function useResumeUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ResumeUnshieldParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ResumeUnshieldParams, `0x${string}`>;
+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}`>;
 //#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;
+  tokenAddress: Address$1;
   /** Address of the wrapper contract whose underlying ERC-20 allowance is checked. */
-  wrapperAddress: Address;
+  wrapperAddress: Address$1;
 }
 /**
  * Read the underlying ERC-20 allowance granted to the wrapper contract.
@@ -785,9 +789,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;
+  tokenAddress: Address$1;
   /** ERC-20 address to discover the wrapper for. Pass `undefined` to disable the query. */
-  erc20Address: Address | undefined;
+  erc20Address: Address$1 | undefined;
 }
 /** Configuration for {@link useWrapperDiscoverySuspense}. */
 interface UseWrapperDiscoverySuspenseConfig {
@@ -796,9 +800,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;
+  tokenAddress: Address$1;
   /** ERC-20 address to discover the wrapper for. */
-  erc20Address: Address;
+  erc20Address: Address$1;
 }
 /**
  * Discover the confidential wrapper for an ERC-20 token via the on-chain registry.
@@ -817,7 +821,7 @@ interface UseWrapperDiscoverySuspenseConfig {
  * });
  * ```
  */
-declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address | null>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<`0x${string}` | null, Error>;
+declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?: Omit<UseQueryOptions<Address$1 | null>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<`0x${string}` | null, Error>;
 /**
  * Suspense variant of {@link useWrapperDiscovery}.
  * Suspends rendering until the wrapper address is resolved.
@@ -850,7 +854,7 @@ declare function useWrapperDiscoverySuspense(config: UseWrapperDiscoverySuspense
  * // metadata?.name, metadata?.symbol, metadata?.decimals
  * ```
  */
-declare function useMetadata(tokenAddress: Address, options?: Omit<UseQueryOptions<TokenMetadata>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<TokenMetadata, Error>;
+declare function useMetadata(tokenAddress: Address$1, options?: Omit<UseQueryOptions<TokenMetadata>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<TokenMetadata, Error>;
 /**
  * Suspense variant of {@link useMetadata}.
  * Suspends rendering until metadata is loaded.
@@ -863,7 +867,41 @@ declare function useMetadata(tokenAddress: Address, options?: Omit<UseQueryOptio
  * const { data: metadata } = useMetadataSuspense("0xToken");
  * ```
  */
-declare function useMetadataSuspense(tokenAddress: Address): _$_tanstack_react_query0.UseSuspenseQueryResult<TokenMetadata, Error>;
+declare function useMetadataSuspense(tokenAddress: Address$1): _$_tanstack_react_query0.UseSuspenseQueryResult<TokenMetadata, Error>;
+//#endregion
+//#region src/balance/use-activity-feed.d.ts
+/** Configuration for {@link useActivityFeed}. */
+interface UseActivityFeedConfig {
+  /** Address of the confidential token contract. */
+  tokenAddress: Address$1;
+  /** Connected wallet address. Pass `undefined` to disable the query. */
+  userAddress: Address$1 | undefined;
+  /** Raw event logs from the provider (viem, ethers, etc.). Pass `undefined` to disable. */
+  logs: readonly (RawLog$1 & Partial<ActivityLogMetadata$1>)[] | undefined;
+  /** Whether to batch-decrypt encrypted transfer amounts. Default: `true`. */
+  decrypt?: boolean;
+}
+/**
+ * Two-phase activity feed hook.
+ * Phase 1: Instantly parses raw logs into classified {@link ActivityItem}s (sync, cheap).
+ * Phase 2: Batch-decrypts encrypted transfer amounts via the relayer (async).
+ *
+ * The wallet provides logs (from its own provider — viem, ethers, etc.)
+ * and this hook normalizes + decrypts them.
+ *
+ * @param config - Token address, user address, raw logs, and decrypt option.
+ * @returns Query result with `data: ActivityItem[]`.
+ *
+ * @example
+ * ```tsx
+ * const { data: activity } = useActivityFeed({
+ *   tokenAddress: "0xToken",
+ *   userAddress: "0xUser",
+ *   logs: rawLogs,
+ * });
+ * ```
+ */
+declare function useActivityFeed(config: UseActivityFeedConfig): _$_tanstack_react_query0.UseQueryResult<ActivityItem$1[], Error>;
 //#endregion
 //#region src/delegation/use-delegate-decryption.d.ts
 /**
@@ -878,7 +916,7 @@ declare function useMetadataSuspense(tokenAddress: Address): _$_tanstack_react_q
  * delegate.mutate({ delegateAddress: "0xDelegate" });
  * ```
  */
-declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, DelegateDecryptionParams>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, DelegateDecryptionParams, unknown>;
+declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, DelegateDecryptionParams$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, DelegateDecryptionParams$1, unknown>;
 //#endregion
 //#region src/delegation/use-revoke-delegation.d.ts
 /**
@@ -893,16 +931,16 @@ declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutat
  * revoke.mutate({ delegateAddress: "0xDelegate" });
  * ```
  */
-declare function useRevokeDelegation(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, RevokeDelegationParams>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, RevokeDelegationParams, unknown>;
+declare function useRevokeDelegation(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, RevokeDelegationParams$1>): _$_tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, RevokeDelegationParams$1, 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 | undefined;
+  tokenAddress: Address$1 | undefined;
   /** The address that granted the delegation. */
-  delegatorAddress?: Address;
+  delegatorAddress?: Address$1;
   /** The address that received delegation rights. */
-  delegateAddress?: Address;
+  delegateAddress?: Address$1;
 }
 /**
  * Query delegation status between a delegator and delegate for a token.
@@ -921,7 +959,7 @@ interface UseDelegationStatusConfig {
  * // data?.isDelegated, data?.expiryTimestamp
  * ```
  */
-declare function useDelegationStatus(config: UseDelegationStatusConfig, options?: Omit<UseQueryOptions<DelegationStatusData>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<DelegationStatusData, Error>;
+declare function useDelegationStatus(config: UseDelegationStatusConfig, options?: Omit<UseQueryOptions<DelegationStatusData$1>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<DelegationStatusData$1, Error>;
 //#endregion
 //#region src/delegation/use-decrypt-balance-as.d.ts
 /**
@@ -937,7 +975,7 @@ declare function useDelegationStatus(config: UseDelegationStatusConfig, options?
  * // decryptAs.data => 1000n
  * ```
  */
-declare function useDecryptBalanceAs(tokenAddress: Address, options?: UseMutationOptions<bigint, Error, DecryptBalanceAsParams>): _$_tanstack_react_query0.UseMutationResult<bigint, Error, DecryptBalanceAsParams, unknown>;
+declare function useDecryptBalanceAs(tokenAddress: Address$1, options?: UseMutationOptions<bigint, Error, DecryptBalanceAsParams$1>): _$_tanstack_react_query0.UseMutationResult<bigint, Error, DecryptBalanceAsParams$1, unknown>;
 //#endregion
 //#region src/delegation/use-batch-decrypt-balances-as.d.ts
 /**
@@ -955,7 +993,7 @@ declare function useDecryptBalanceAs(tokenAddress: Address, options?: UseMutatio
  * // batchDecryptAs.data => Map { "0xTokenA" => 100n, "0xTokenB" => 200n }
  * ```
  */
-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>;
+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>;
 //#endregion
 //#region src/shield/use-approve-underlying.d.ts
 /**
@@ -977,7 +1015,7 @@ declare function useBatchDecryptBalancesAs(tokens: ReadonlyToken[], options?: Us
  * approve.mutate({ amount: 1000n }); // exact amount
  * ```
  */
-declare function useApproveUnderlying(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult, Error, ApproveUnderlyingParams, Address>): _$_tanstack_react_query0.UseMutationResult<TransactionResult, Error, ApproveUnderlyingParams, `0x${string}`>;
+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}`>;
 //#endregion
 //#region src/token/use-is-confidential.d.ts
 /**
@@ -993,7 +1031,7 @@ declare function useApproveUnderlying(config: UseZamaConfig, options?: UseMutati
  * const { data: isConfidential } = useIsConfidential("0xToken");
  * ```
  */
-declare function useIsConfidential(tokenAddress: Address, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
+declare function useIsConfidential(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
 /**
  * Suspense variant of {@link useIsConfidential}.
  * Suspends rendering until the ERC-165 check resolves.
@@ -1006,7 +1044,7 @@ declare function useIsConfidential(tokenAddress: Address, options?: Omit<UseQuer
  * const { data: isConfidential } = useIsConfidentialSuspense("0xToken");
  * ```
  */
-declare function useIsConfidentialSuspense(tokenAddress: Address): _$_tanstack_react_query0.UseSuspenseQueryResult<boolean, Error>;
+declare function useIsConfidentialSuspense(tokenAddress: Address$1): _$_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.
@@ -1020,7 +1058,7 @@ declare function useIsConfidentialSuspense(tokenAddress: Address): _$_tanstack_r
  * const { data: isWrapper } = useIsWrapper("0xToken");
  * ```
  */
-declare function useIsWrapper(tokenAddress: Address, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
+declare function useIsWrapper(tokenAddress: Address$1, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
 /**
  * Suspense variant of {@link useIsWrapper}.
  * Suspends rendering until the ERC-165 check resolves.
@@ -1033,7 +1071,7 @@ declare function useIsWrapper(tokenAddress: Address, options?: Omit<UseQueryOpti
  * const { data: isWrapper } = useIsWrapperSuspense("0xToken");
  * ```
  */
-declare function useIsWrapperSuspense(tokenAddress: Address): _$_tanstack_react_query0.UseSuspenseQueryResult<boolean, Error>;
+declare function useIsWrapperSuspense(tokenAddress: Address$1): _$_tanstack_react_query0.UseSuspenseQueryResult<boolean, Error>;
 //#endregion
 //#region src/token/use-total-supply.d.ts
 /**
@@ -1049,7 +1087,7 @@ declare function useIsWrapperSuspense(tokenAddress: Address): _$_tanstack_react_
  * const { data: totalSupply } = useTotalSupply("0xToken");
  * ```
  */
-declare function useTotalSupply(tokenAddress: Address, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<bigint, Error>;
+declare function useTotalSupply(tokenAddress: Address$1, options?: Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">): _$_tanstack_react_query0.UseQueryResult<bigint, Error>;
 /**
  * Suspense variant of {@link useTotalSupply}.
  * Suspends rendering until the total supply is loaded.
@@ -1062,7 +1100,7 @@ declare function useTotalSupply(tokenAddress: Address, options?: Omit<UseQueryOp
  * const { data: totalSupply } = useTotalSupplySuspense("0xToken");
  * ```
  */
-declare function useTotalSupplySuspense(tokenAddress: Address): _$_tanstack_react_query0.UseSuspenseQueryResult<bigint, Error>;
+declare function useTotalSupplySuspense(tokenAddress: Address$1): _$_tanstack_react_query0.UseSuspenseQueryResult<bigint, Error>;
 //#endregion
 //#region src/wrappers-registry/use-wrappers-registry-address.d.ts
 /**
@@ -1076,14 +1114,14 @@ declare function useTotalSupplySuspense(tokenAddress: Address): _$_tanstack_reac
  * The chain ID is cached for 30 seconds (`staleTime`), so chain
  * switches may take up to 30s to reflect.
  */
-declare function useWrappersRegistryAddress(): Address | undefined;
+declare function useWrappersRegistryAddress(): Address$1 | 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[], Error>;
+declare function useTokenPairsRegistry(): _$_tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair$1[], Error>;
 //#endregion
 //#region src/wrappers-registry/use-token-pairs-length.d.ts
 /**
@@ -1104,7 +1142,7 @@ declare function useTokenPairsSlice({
 }: {
   fromIndex: bigint | undefined;
   toIndex: bigint | undefined;
-}): _$_tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair[], Error>;
+}): _$_tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair$1[], Error>;
 //#endregion
 //#region src/wrappers-registry/use-token-pair.d.ts
 /**
@@ -1116,7 +1154,7 @@ declare function useTokenPair({
   index
 }: {
   index: bigint | undefined;
-}): _$_tanstack_react_query0.UseQueryResult<TokenWrapperPair, Error>;
+}): _$_tanstack_react_query0.UseQueryResult<TokenWrapperPair$1, Error>;
 //#endregion
 //#region src/wrappers-registry/use-confidential-token-address.d.ts
 /**
@@ -1125,7 +1163,7 @@ declare function useTokenPair({
 declare function useConfidentialTokenAddress({
   tokenAddress
 }: {
-  tokenAddress: Address | undefined;
+  tokenAddress: Address$1 | undefined;
 }): _$_tanstack_react_query0.UseQueryResult<readonly [boolean, `0x${string}`], Error>;
 //#endregion
 //#region src/wrappers-registry/use-token-address.d.ts
@@ -1135,7 +1173,7 @@ declare function useConfidentialTokenAddress({
 declare function useTokenAddress({
   confidentialTokenAddress
 }: {
-  confidentialTokenAddress: Address | undefined;
+  confidentialTokenAddress: Address$1 | undefined;
 }): _$_tanstack_react_query0.UseQueryResult<readonly [boolean, `0x${string}`], Error>;
 //#endregion
 //#region src/wrappers-registry/use-is-confidential-token-valid.d.ts
@@ -1148,7 +1186,7 @@ declare function useTokenAddress({
 declare function useIsConfidentialTokenValid({
   confidentialTokenAddress
 }: {
-  confidentialTokenAddress: Address | undefined;
+  confidentialTokenAddress: Address$1 | undefined;
 }): _$_tanstack_react_query0.UseQueryResult<boolean, Error>;
 //#endregion
 //#region src/wrappers-registry/use-list-pairs.d.ts
@@ -1173,7 +1211,15 @@ declare function useListPairs({
   page?: number;
   pageSize?: number;
   metadata?: boolean;
-}): _$_tanstack_react_query0.UseQueryResult<PaginatedResult<TokenWrapperPair | TokenWrapperPairWithMetadata>, Error>;
+}): _$_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;
+}
 //#endregion
-export { 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, 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, useToken, useTokenAddress, useTokenPair, useTokenPairsLength, useTokenPairsRegistry, useTokenPairsSlice, useTotalSupply, useTotalSupplySuspense, useUnderlyingAllowance, useUnderlyingAllowanceSuspense, useUnshield, useUnshieldAll, useUnwrap, useUnwrapAll, useUserDecrypt, useWrapperDiscovery, useWrapperDiscoverySuspense, useWrappersRegistryAddress, useZamaSDK };
+export { ACL_TOPICS, type AclEvent, AclPausedError, type ActivityAmount, type ActivityDirection, type ActivityItem, type ActivityLogMetadata, type ActivityType, 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 UseActivityFeedConfig, 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, activityFeedQueryOptions, allowMutationOptions, allowanceContract, applyDecryptedValues, 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, extractEncryptedHandles, 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, parseActivityFeed, publicDecryptMutationOptions, publicKeyQueryOptions, publicParamsQueryOptions, rateContract, requestZKProofVerificationMutationOptions, resumeUnshieldMutationOptions, revokeDelegationContract, revokeDelegationMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, savePendingUnshield, setOperatorContract, shieldMutationOptions, signerAddressQueryOptions, sortByBlockNumber, supportsInterfaceContract, symbolContract, tokenMetadataQueryOptions, totalSupplyContract, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, underlyingContract, unshieldAllMutationOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapContract, unwrapFromBalanceContract, unwrapMutationOptions, useActivityFeed, 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 };
 //# sourceMappingURL=index.d.ts.map