@zama-fhe/react-sdk 1.0.1 → 1.1.0-alpha.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 "use client";
 
 import * as _zama_fhe_sdk0 from "@zama-fhe/sdk";
-import { ActivityAmount, ActivityDirection, ActivityItem, ActivityItem as ActivityItem$1, ActivityLogMetadata, ActivityLogMetadata as ActivityLogMetadata$1, ActivityType, Address, Address as Address$1, ApprovalFailedError, ApproveSubmittedEvent, ApproveUnderlyingSubmittedEvent, BATCH_SWAP_ABI, BaseEvent, BatchDecryptOptions, BatchTransferData, ChromeSessionStorage, ClearValueType, ClearValueType as ClearValueType$1, ConfidentialTransferEvent, ContractAbi, CredentialsAllowedEvent, CredentialsCachedEvent, CredentialsCreatedEvent, CredentialsCreatingEvent, CredentialsExpiredEvent, CredentialsLoadingEvent, CredentialsManager, CredentialsManagerConfig, CredentialsRevokedEvent, DEPLOYMENT_COORDINATOR_ABI, DecryptEndEvent, DecryptErrorEvent, DecryptStartEvent, DecryptionFailedError, DelegatedUserDecryptParams, DelegatedUserDecryptParams as DelegatedUserDecryptParams$1, EIP712TypedData, EIP712TypedData as EIP712TypedData$1, ENCRYPTION_ABI, ERC165_ABI, ERC20_ABI, ERC20_METADATA_ABI, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, EncryptEndEvent, EncryptErrorEvent, EncryptInput, EncryptParams, EncryptParams as EncryptParams$1, EncryptResult, EncryptResult as EncryptResult$1, EncryptStartEvent, EncryptionFailedError, FEE_MANAGER_ABI, FheTypeName, FhevmInstanceConfig, FinalizeUnwrapSubmittedEvent, GenericSigner, GenericSigner as GenericSigner$1, GenericStorage, GenericStorage as GenericStorage$1, Handle, Handle as Handle$1, HardhatConfig, Hex, Hex as Hex$1, IndexedDBStorage, InputProofBytesType, InvalidKeypairError, KeypairExpiredError, KeypairType, KeypairType as KeypairType$1, KmsDelegatedUserDecryptEIP712Type, MainnetConfig, MemoryStorage, NetworkType, NoCiphertextError, OnChainEvent, PublicDecryptResult, PublicDecryptResult as PublicDecryptResult$1, RawLog, RawLog as RawLog$1, ReadContractArgs, ReadContractConfig, ReadContractReturnType, ReadFunctionName, ReadonlyToken, ReadonlyTokenConfig, RelayerRequestFailedError, RelayerSDK, RelayerSDK as RelayerSDK$1, RelayerSDKStatus, RelayerWeb, RelayerWebConfig, RelayerWebSecurityConfig, SepoliaConfig, SessionExpiredEvent, ShieldCallbacks, ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, StoredCredentials, TOKEN_TOPICS, TRANSFER_BATCHER_ABI, Token, TokenConfig, Topics, TransactionErrorEvent, TransactionReceipt, TransactionResult, TransactionResult as TransactionResult$1, TransactionRevertedError, TransferCallbacks, TransferFromSubmittedEvent, TransferSubmittedEvent, UnshieldCallbacks, UnshieldPhase1SubmittedEvent, UnshieldPhase2StartedEvent, UnshieldPhase2SubmittedEvent, UnwrapRequestedEvent, UnwrapSubmittedEvent, UnwrappedFinalizedEvent, UnwrappedStartedEvent, UserDecryptParams, UserDecryptParams as UserDecryptParams$1, WRAPPER_ABI, WrappedEvent, 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, confidentialBatchTransferContract, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, decimalsContract, decodeConfidentialTransfer, decodeOnChainEvent, decodeOnChainEvents, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, deploymentCoordinatorContract, extractEncryptedHandles, finalizeUnwrapContract, findUnwrapRequested, findWrapped, getBatchTransferFeeContract, getFeeRecipientContract, getUnwrapFeeContract, getWrapFeeContract, getWrapperContract, indexedDBStorage, isConfidentialTokenContract, isConfidentialWrapperContract, isFinalizeUnwrapOperatorContract, isOperatorContract, loadPendingUnshield, matchZamaError, nameContract, parseActivityFeed, rateContract, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, sortByBlockNumber, supportsInterfaceContract, symbolContract, totalSupplyContract, underlyingContract, unwrapContract, unwrapFromBalanceContract, wrapContract, wrapETHContract, wrapperExistsContract } from "@zama-fhe/sdk";
+import { ActivityAmount, ActivityDirection, ActivityItem, ActivityItem as ActivityItem$1, ActivityLogMetadata, ActivityLogMetadata as ActivityLogMetadata$1, ActivityType, Address, Address as Address$1, ApprovalFailedError, ApproveSubmittedEvent, ApproveUnderlyingSubmittedEvent, BATCH_SWAP_ABI, BaseEvent, BatchDecryptOptions, BatchTransferData, ChromeSessionStorage, ClearValueType, ClearValueType as ClearValueType$1, ConfidentialTransferEvent, ContractAbi, CredentialsAllowedEvent, CredentialsCachedEvent, CredentialsCreatedEvent, CredentialsCreatingEvent, CredentialsExpiredEvent, CredentialsLoadingEvent, CredentialsManager, CredentialsManagerConfig, CredentialsRevokedEvent, DEPLOYMENT_COORDINATOR_ABI, DecryptEndEvent, DecryptErrorEvent, DecryptStartEvent, DecryptionFailedError, DelegatedUserDecryptParams, DelegatedUserDecryptParams as DelegatedUserDecryptParams$1, EIP712TypedData, EIP712TypedData as EIP712TypedData$1, ENCRYPTION_ABI, ERC165_ABI, ERC20_ABI, ERC20_METADATA_ABI, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, EncryptEndEvent, EncryptErrorEvent, EncryptInput, EncryptParams, EncryptParams as EncryptParams$1, EncryptResult, EncryptResult as EncryptResult$1, EncryptStartEvent, EncryptionFailedError, FEE_MANAGER_ABI, FheTypeName, FhevmInstanceConfig, FinalizeUnwrapSubmittedEvent, GenericSigner, GenericSigner as GenericSigner$1, GenericStorage, GenericStorage as GenericStorage$1, Handle, Handle as Handle$1, HardhatConfig, Hex, Hex as Hex$1, IndexedDBStorage, InputProofBytesType, InvalidKeypairError, KeypairExpiredError, KeypairType, KmsDelegatedUserDecryptEIP712Type, MainnetConfig, MemoryStorage, NetworkType, NoCiphertextError, OnChainEvent, PublicDecryptResult, PublicDecryptResult as PublicDecryptResult$1, RawLog, RawLog as RawLog$1, ReadContractArgs, ReadContractConfig, ReadContractReturnType, ReadFunctionName, ReadonlyToken, ReadonlyTokenConfig, RelayerRequestFailedError, RelayerSDK, RelayerSDK as RelayerSDK$1, RelayerSDKStatus, RelayerWeb, RelayerWebConfig, RelayerWebSecurityConfig, SepoliaConfig, SessionExpiredEvent, ShieldCallbacks, ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, StoredCredentials, TOKEN_TOPICS, TRANSFER_BATCHER_ABI, Token, TokenConfig, Topics, TransactionErrorEvent, TransactionReceipt, TransactionResult, TransactionResult as TransactionResult$1, TransactionRevertedError, TransferCallbacks, TransferFromSubmittedEvent, TransferSubmittedEvent, UnshieldCallbacks, UnshieldPhase1SubmittedEvent, UnshieldPhase2StartedEvent, UnshieldPhase2SubmittedEvent, UnwrapRequestedEvent, UnwrapSubmittedEvent, UnwrappedFinalizedEvent, UnwrappedStartedEvent, UserDecryptParams, UserDecryptParams as UserDecryptParams$1, WRAPPER_ABI, WrappedEvent, 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, confidentialBatchTransferContract, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, decimalsContract, decodeConfidentialTransfer, decodeOnChainEvent, decodeOnChainEvents, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, deploymentCoordinatorContract, extractEncryptedHandles, finalizeUnwrapContract, findUnwrapRequested, findWrapped, getBatchTransferFeeContract, getFeeRecipientContract, getUnwrapFeeContract, getWrapFeeContract, getWrapperContract, indexedDBStorage, isConfidentialTokenContract, isConfidentialWrapperContract, isFinalizeUnwrapOperatorContract, isOperatorContract, loadPendingUnshield, matchZamaError, nameContract, parseActivityFeed, rateContract, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, sortByBlockNumber, supportsInterfaceContract, symbolContract, totalSupplyContract, underlyingContract, unwrapContract, unwrapFromBalanceContract, wrapContract, wrapETHContract, wrapperExistsContract } from "@zama-fhe/sdk";
 import { ApproveUnderlyingParams, ApproveUnderlyingParams as ApproveUnderlyingParams$1, ConfidentialApproveParams, ConfidentialApproveParams as ConfidentialApproveParams$1, ConfidentialBalancesData, ConfidentialBalancesData as ConfidentialBalancesData$1, ConfidentialTransferFromParams, ConfidentialTransferFromParams as ConfidentialTransferFromParams$1, ConfidentialTransferParams, ConfidentialTransferParams as ConfidentialTransferParams$1, FinalizeUnwrapParams, FinalizeUnwrapParams as FinalizeUnwrapParams$1, ResumeUnshieldParams, ResumeUnshieldParams as ResumeUnshieldParams$1, ShieldETHParams, ShieldETHParams as ShieldETHParams$1, ShieldParams, ShieldParams as ShieldParams$1, TokenMetadata, UnshieldAllParams, UnshieldAllParams as UnshieldAllParams$1, UnshieldParams, UnshieldParams as UnshieldParams$1, UnwrapParams, UnwrapParams as UnwrapParams$1, activityFeedQueryOptions, allowMutationOptions, approveUnderlyingMutationOptions, batchTransferFeeQueryOptions, confidentialApproveMutationOptions, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialHandleQueryOptions, confidentialHandlesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, encryptMutationOptions, feeRecipientQueryOptions, filterQueryOptions, finalizeUnwrapMutationOptions, hashFn, isAllowedQueryOptions, isConfidentialQueryOptions, isWrapperQueryOptions, publicKeyQueryOptions, publicParamsQueryOptions, resumeUnshieldMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, shieldETHMutationOptions, shieldFeeQueryOptions, shieldMutationOptions, signerAddressQueryOptions, tokenMetadataQueryOptions, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, unshieldAllMutationOptions, unshieldFeeQueryOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapMutationOptions, wrapperDiscoveryQueryOptions, zamaQueryKeys } from "@zama-fhe/sdk/query";
 import * as _tanstack_react_query0 from "@tanstack/react-query";
 import { QueryKey, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
@@ -129,15 +129,15 @@ declare function usePublicDecrypt(): _tanstack_react_query0.UseMutationResult<Pu
  * // generateKeypair.data?.publicKey, generateKeypair.data?.privateKey
  * ```
  */
-declare function useGenerateKeypair(): _tanstack_react_query0.UseMutationResult<KeypairType$1<string>, Error, void, unknown>;
+declare function useGenerateKeypair(): _tanstack_react_query0.UseMutationResult<_zama_fhe_sdk0.KeypairType<`0x${string}`>, Error, void, unknown>;
 //#endregion
 //#region src/relayer/use-create-eip712.d.ts
 /** Parameters for {@link useCreateEIP712}. */
 interface CreateEIP712Params {
   /** The FHE public key (hex-encoded). */
-  publicKey: string;
+  publicKey: `0x${string}`;
   /** Contract addresses the credential authorizes decryption for. */
-  contractAddresses: `0x${string}`[];
+  contractAddresses: Address$1[];
   /** Unix timestamp (seconds) when the credential becomes valid. */
   startTimestamp: number;
   /** Number of days the credential remains valid. Default: 1. */
@@ -165,11 +165,11 @@ declare function useCreateEIP712(): _tanstack_react_query0.UseMutationResult<EIP
 /** Parameters for {@link useCreateDelegatedUserDecryptEIP712}. */
 interface CreateDelegatedUserDecryptEIP712Params {
   /** The FHE public key (hex-encoded). */
-  publicKey: string;
+  publicKey: `0x${string}`;
   /** Contract addresses the credential authorizes decryption for. */
   contractAddresses: Address$1[];
   /** Address of the wallet that delegated decrypt authority. */
-  delegatorAddress: string;
+  delegatorAddress: Address$1;
   /** Unix timestamp (seconds) when the credential becomes valid. */
   startTimestamp: number;
   /** Number of days the credential remains valid. Default: 1. */
@@ -362,7 +362,7 @@ declare function useUserDecryptedValues(handles: Handle$1[]): {
  * and by useUserDecryptedValue to read.
  */
 declare const decryptionKeys: {
-  value: (handle: string, contractAddress?: string) => readonly ["zama.decryption", {
+  value: (handle: Handle$1, contractAddress?: Address$1) => readonly ["zama.decryption", {
     readonly contractAddress?: `0x${string}` | undefined;
     readonly handle: string;
   }];

package/dist/index.js

@@ -1,2 +1,2 @@
-"use client";import{ApprovalFailedError as e,BATCH_SWAP_ABI as t,ChromeSessionStorage as n,CredentialsManager as r,DEPLOYMENT_COORDINATOR_ABI as i,DecryptionFailedError as a,ENCRYPTION_ABI as o,ERC165_ABI as s,ERC20_ABI as c,ERC20_METADATA_ABI as l,ERC7984_INTERFACE_ID as u,ERC7984_WRAPPER_INTERFACE_ID as d,EncryptionFailedError as f,FEE_MANAGER_ABI as p,HardhatConfig as m,IndexedDBStorage as h,InvalidKeypairError as ee,KeypairExpiredError as te,MainnetConfig as ne,MemoryStorage as re,NoCiphertextError as ie,ReadonlyToken as ae,RelayerRequestFailedError as oe,RelayerWeb as se,SepoliaConfig as ce,SigningFailedError as le,SigningRejectedError as ue,TOKEN_TOPICS as de,TRANSFER_BATCHER_ABI as fe,Token as pe,Topics as me,TransactionRevertedError as he,WRAPPER_ABI as ge,ZERO_HANDLE as _e,ZamaError as ve,ZamaErrorCode as ye,ZamaSDK as be,ZamaSDK as xe,ZamaSDKEvents as Se,allowanceContract as Ce,applyDecryptedValues as we,approveContract as Te,balanceOfContract as Ee,chromeSessionStorage as De,clearPendingUnshield as Oe,confidentialBalanceOfContract as ke,confidentialBatchTransferContract as Ae,confidentialTotalSupplyContract as je,confidentialTransferContract as Me,confidentialTransferFromContract as g,decimalsContract as _,decodeConfidentialTransfer as v,decodeOnChainEvent as y,decodeOnChainEvents as b,decodeUnwrapRequested as x,decodeUnwrappedFinalized as Ne,decodeUnwrappedStarted as Pe,decodeWrapped as Fe,deploymentCoordinatorContract as Ie,extractEncryptedHandles as Le,finalizeUnwrapContract as Re,findUnwrapRequested as ze,findWrapped as Be,getBatchTransferFeeContract as Ve,getFeeRecipientContract as He,getUnwrapFeeContract as Ue,getWrapFeeContract as We,getWrapperContract as Ge,indexedDBStorage as Ke,isConfidentialTokenContract as qe,isConfidentialWrapperContract as Je,isFinalizeUnwrapOperatorContract as Ye,isOperatorContract as Xe,loadPendingUnshield as Ze,matchZamaError as Qe,nameContract as $e,parseActivityFeed as et,rateContract as tt,savePendingUnshield as nt,setFinalizeUnwrapOperatorContract as rt,setOperatorContract as it,sortByBlockNumber as at,supportsInterfaceContract as ot,symbolContract as st,totalSupplyContract as ct,underlyingContract as lt,unwrapContract as ut,unwrapFromBalanceContract as dt,wrapContract as ft,wrapETHContract as pt,wrapperExistsContract as mt}from"@zama-fhe/sdk";import{activityFeedQueryOptions as ht,activityFeedQueryOptions as gt,allowMutationOptions as _t,allowMutationOptions as vt,approveUnderlyingMutationOptions as yt,approveUnderlyingMutationOptions as bt,batchTransferFeeQueryOptions as xt,batchTransferFeeQueryOptions as St,confidentialApproveMutationOptions as Ct,confidentialApproveMutationOptions as wt,confidentialBalanceQueryOptions as Tt,confidentialBalanceQueryOptions as Et,confidentialBalancesQueryOptions as Dt,confidentialBalancesQueryOptions as Ot,confidentialHandleQueryOptions as kt,confidentialHandleQueryOptions as At,confidentialHandlesQueryOptions as jt,confidentialHandlesQueryOptions as Mt,confidentialIsApprovedQueryOptions as Nt,confidentialIsApprovedQueryOptions as S,confidentialTransferFromMutationOptions as Pt,confidentialTransferFromMutationOptions as Ft,confidentialTransferMutationOptions as It,confidentialTransferMutationOptions as Lt,encryptMutationOptions as Rt,encryptMutationOptions as zt,feeRecipientQueryOptions as Bt,feeRecipientQueryOptions as Vt,filterQueryOptions as Ht,finalizeUnwrapMutationOptions as Ut,finalizeUnwrapMutationOptions as Wt,hashFn as Gt,hashFn as C,invalidateAfterApprove as Kt,invalidateAfterApproveUnderlying as qt,invalidateAfterShield as w,invalidateAfterTransfer as T,invalidateAfterUnshield as E,invalidateAfterUnwrap as D,invalidateWalletLifecycleQueries as O,isAllowedQueryOptions as Jt,isAllowedQueryOptions as Yt,isConfidentialQueryOptions as Xt,isConfidentialQueryOptions as k,isWrapperQueryOptions as Zt,isWrapperQueryOptions as A,publicKeyQueryOptions as Qt,publicKeyQueryOptions as $t,publicParamsQueryOptions as en,publicParamsQueryOptions as tn,resumeUnshieldMutationOptions as nn,resumeUnshieldMutationOptions as rn,revokeMutationOptions as an,revokeMutationOptions as on,revokeSessionMutationOptions as sn,revokeSessionMutationOptions as cn,shieldETHMutationOptions as ln,shieldETHMutationOptions as un,shieldFeeQueryOptions as dn,shieldFeeQueryOptions as fn,shieldMutationOptions as pn,shieldMutationOptions as mn,signerAddressQueryOptions as hn,signerAddressQueryOptions as j,tokenMetadataQueryOptions as gn,tokenMetadataQueryOptions as M,totalSupplyQueryOptions as _n,totalSupplyQueryOptions as N,underlyingAllowanceQueryOptions as vn,underlyingAllowanceQueryOptions as P,unshieldAllMutationOptions as yn,unshieldAllMutationOptions as bn,unshieldFeeQueryOptions as xn,unshieldFeeQueryOptions as Sn,unshieldMutationOptions as Cn,unshieldMutationOptions as wn,unwrapAllMutationOptions as Tn,unwrapAllMutationOptions as En,unwrapMutationOptions as Dn,unwrapMutationOptions as On,wrapperDiscoveryQueryOptions as kn,wrapperDiscoveryQueryOptions as F,zamaQueryKeys as An,zamaQueryKeys as I}from"@zama-fhe/sdk/query";import{skipToken as L,useMutation as R,useQueries as jn,useQuery as z,useQueryClient as B,useSuspenseQuery as Mn}from"@tanstack/react-query";import{createContext as Nn,useContext as Pn,useEffect as V,useMemo as H,useRef as Fn}from"react";import{jsx as In}from"react/jsx-runtime";const U=Nn(null);function Ln({children:e,relayer:t,signer:n,storage:r,sessionStorage:i,keypairTTL:a,sessionTTL:o,onEvent:s}){let c=B(),l=Fn(s);V(()=>{l.current=s});let u=H(()=>n?.subscribe?{onDisconnect:()=>O(c),onAccountChange:()=>O(c),onChainChange:()=>O(c)}:void 0,[c,n]),d=H(()=>new xe({relayer:t,signer:n,storage:r,sessionStorage:i,keypairTTL:a,sessionTTL:o,onEvent:l.current,signerLifecycleCallbacks:u}),[t,n,r,i,a,o,u]);return V(()=>()=>d.dispose(),[d]),In(U.Provider,{value:d,children:e})}function W(){let e=Pn(U);if(!e)throw Error(`useZamaSDK must be used within a <ZamaProvider>. Wrap your component tree in <ZamaProvider relayer={…} signer={…} storage={…}>.`);return e}function Rn(){return R(zt(W()))}const G={value:(e,t)=>I.decryption.handle(e,t)};function zn(){let e=W(),t=B();return R({mutationFn:t=>e.relayer.userDecrypt(t),onSuccess:e=>{for(let[n,r]of Object.entries(e))t.setQueryData(G.value(n),r)}})}function Bn(){let e=W(),t=B();return R({mutationFn:t=>e.relayer.publicDecrypt(t),onSuccess:e=>{for(let[n,r]of Object.entries(e.clearValues))t.setQueryData(G.value(n),r)}})}function Vn(){let e=W();return R({mutationFn:()=>e.relayer.generateKeypair()})}function Hn(){let e=W();return R({mutationFn:({publicKey:t,contractAddresses:n,startTimestamp:r,durationDays:i})=>e.relayer.createEIP712(t,n,r,i)})}function Un(){let e=W();return R({mutationFn:({publicKey:t,contractAddresses:n,delegatorAddress:r,startTimestamp:i,durationDays:a})=>e.relayer.createDelegatedUserDecryptEIP712(t,n,r,i,a)})}function Wn(){let e=W();return R({mutationFn:t=>e.relayer.delegatedUserDecrypt(t)})}function Gn(){let e=W();return R({mutationFn:t=>e.relayer.requestZKProofVerification(t)})}function Kn(){return z({...$t(W()),queryKeyHashFn:C})}function qn(e){return z({...tn(W(),e),queryKeyHashFn:C})}function Jn(e){let t=W(),n=B(),r=e?.callbacks;return R({mutationKey:[`userDecryptFlow`],mutationFn:async({handles:e,durationDays:n=1})=>{let i=await t.relayer.generateKeypair();r?.onKeypairGenerated?.();let a=[...new Set(e.map(e=>e.contractAddress))],o=Math.floor(Date.now()/1e3),s=await t.relayer.createEIP712(i.publicKey,a,o,n);r?.onEIP712Created?.();let c=await t.signer.signTypedData(s);r?.onSigned?.(c);let l=await t.signer.getAddress(),u={},d=new Map;for(let t of e){let e=d.get(t.contractAddress)??[];e.push(t.handle),d.set(t.contractAddress,e)}for(let[e,r]of d){let s=await t.relayer.userDecrypt({handles:r,contractAddress:e,signedContractAddresses:a,privateKey:i.privateKey,publicKey:i.publicKey,signature:c,signerAddress:l,startTimestamp:o,durationDays:n});Object.assign(u,s)}let f=u;return r?.onDecrypted?.(f),f},onSuccess:e=>{for(let[t,r]of Object.entries(e))n.setQueryData(G.value(t),r)}})}function Yn(e){return z({queryKey:G.value(e??`0x`),queryKeyHashFn:C,queryFn:()=>void 0,enabled:!1})}function Xn(e){let t=jn({queries:e.map(e=>({queryKey:G.value(e),queryKeyHashFn:C,queryFn:()=>void 0,enabled:!1}))}),n={};for(let r=0;r<e.length;r++)n[e[r]]=t[r].data;return{data:n,results:t}}function K(e){let t=W();return H(()=>t.createToken(e.tokenAddress,e.wrapperAddress),[t,e.tokenAddress,e.wrapperAddress])}function q(e){let t=W();return H(()=>t.createReadonlyToken(e),[t,e])}function J(e){return z({...e,queryKeyHashFn:C})}function Y(e){return Mn({...e,queryKeyHashFn:C})}function Zn(e,t){let{tokenAddress:n,handleRefetchInterval:r}=e,i=t?.enabled,a=q(n),o=J({...j(a.signer)}).data,s=At(a.signer,n,{owner:o,pollingInterval:r}),c=s.enabled??!0,l=J({...s,enabled:c&&(i??!0)}),u=l.data,d=Et(a,{handle:u,owner:o}),f=d.enabled??!0;return{...J({...d,...t,enabled:f&&(i??!0)}),handleQuery:l}}function Qn(e,t){let{tokenAddresses:n,handleRefetchInterval:r,maxConcurrency:i}=e,a=t?.enabled,o=W(),s=J({...j(o.signer)}).data,c=H(()=>n.map(e=>o.createReadonlyToken(e)),[o,n]),l=Mt(o.signer,n,{owner:s,pollingInterval:r}),u=l.enabled??!0,d=J({...l,enabled:u&&(a??!0)}),f=d.data,p=Array.isArray(f)&&f.length===n.length,m=Ot(c,{owner:s,handles:f,maxConcurrency:i,resultAddresses:n}),h=m.enabled??!0;return{...J({...m,...t,enabled:h&&p&&(a??!0)}),handlesQuery:d}}function $n(e){return R({...vt(W()),...e,onSuccess:(t,n,r,i)=>{e?.onSuccess?.(t,n,r,i),i.client.invalidateQueries({queryKey:I.isAllowed.all})}})}function er(){let e=W(),t=J({...j(e.signer)}).data,n=t?Yt(e,{account:t}):{queryKey:I.isAllowed.all,queryFn:L},r=`enabled`in n?n.enabled??!0:!0;return J({...n,enabled:r})}function tr(e){return R({...on(W()),...e,onSuccess:(t,n,r,i)=>{e?.onSuccess?.(t,n,r,i),i.client.invalidateQueries({queryKey:I.isAllowed.all})}})}function nr(e){return R({...cn(W()),...e,onSuccess:(t,n,r,i)=>{e?.onSuccess?.(t,n,r,i),i.client.invalidateQueries({queryKey:I.isAllowed.all})}})}function X(e,t){let n=e?t:void 0;return{wrappedContext:n,callerContext:e?n?.callerContext:t}}async function Z(e,t,n,r){let i=I.confidentialBalance.token(t);await e.cancelQueries({queryKey:i});let a=e.getQueriesData({queryKey:i});for(let[t,i]of a)i!==void 0&&e.setQueryData(t,r===`add`?i+n:i-n);return a}function Q(e,t){for(let[n,r]of t)e.setQueryData(n,r)}function rr(e,t){let n=K(e),r=B();return R({...Lt(n),...t,onMutate:e.optimistic?async(n,i)=>({snapshot:await Z(r,e.tokenAddress,n.amount,`subtract`),callerContext:await t?.onMutate?.(n,i)}):t?.onMutate,onError:(n,i,a,o)=>{let{wrappedContext:s,callerContext:c}=X(e.optimistic,a);s&&Q(r,s.snapshot),t?.onError?.(n,i,c,o)},onSuccess:(n,r,i,a)=>{let{callerContext:o}=X(e.optimistic,i);t?.onSuccess?.(n,r,o,a),T(a.client,e.tokenAddress)},onSettled:(n,r,i,a,o)=>{let{callerContext:s}=X(e.optimistic,a);t?.onSettled?.(n,r,i,s,o)}})}function ir(e,t){return R({...Ft(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),T(a.client,e.tokenAddress)}})}function ar(e,t){return R({...wt(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),Kt(a.client,e.tokenAddress)}})}function or(e,t){let{spender:n,holder:r,...i}=e,a=t?.enabled,o=K(i),s=J({...j(o.signer),enabled:r===void 0}),c=r??s.data,l=n&&c?S(o.signer,o.address,{holder:c,spender:n}):{queryKey:I.confidentialIsApproved.token(e.tokenAddress),queryFn:L},u=`enabled`in l?l.enabled??!0:!0;return J({...l,...t,enabled:u&&(a??!0)})}function sr(e){let{spender:t,holder:n,...r}=e,i=K(r),a=Y({...j(i.signer)}),o=n??a.data;return Y({...S(i.signer,i.address,{holder:o,spender:t})})}function cr(e,t){let n=K(e),r=B();return R({...mn(n),...t,onMutate:e.optimistic?async(n,i)=>({snapshot:await Z(r,e.tokenAddress,n.amount,`add`),callerContext:await t?.onMutate?.(n,i)}):t?.onMutate,onError:(n,i,a,o)=>{let{wrappedContext:s,callerContext:c}=X(e.optimistic,a);s&&Q(r,s.snapshot),t?.onError?.(n,i,c,o)},onSuccess:(n,r,i,a)=>{let{callerContext:o}=X(e.optimistic,i);t?.onSuccess?.(n,r,o,a),w(a.client,e.tokenAddress)},onSettled:(n,r,i,a,o)=>{let{callerContext:s}=X(e.optimistic,a);t?.onSettled?.(n,r,i,s,o)}})}function lr(e,t){return R({...un(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),w(a.client,e.tokenAddress)}})}function ur(e,t){return R({...On(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),D(a.client,e.tokenAddress)}})}function dr(e,t){return R({...En(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),D(a.client,e.tokenAddress)}})}function fr(e,t){return R({...Wt(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function pr(e,t){return R({...wn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function mr(e,t){return R({...bn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function $(e,t){return R({...rn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function hr(e,t){let{tokenAddress:n,wrapperAddress:r}=e,i=t?.enabled,a=q(n),o=J({...j(a.signer)}).data,s=P(a.signer,n,{owner:o,wrapperAddress:r}),c=s.enabled??!0;return J({...s,...t,enabled:c&&(i??!0)})}function gr(e){let{tokenAddress:t,wrapperAddress:n}=e,r=q(t),i=Y({...j(r.signer)}).data;return Y({...P(r.signer,t,{owner:i,wrapperAddress:n})})}function _r(e,t){let{tokenAddress:n,coordinatorAddress:r}=e,i=q(n);return J({...r?F(i.signer,n,{coordinatorAddress:r}):{queryKey:I.wrapperDiscovery.all,queryFn:L},...t})}function vr(e){let{tokenAddress:t,coordinatorAddress:n}=e;return Y({...F(q(t).signer,t,{coordinatorAddress:n})})}function yr(e,t){return J({...M(q(e).signer,e),...t})}function br(e){return Y({...M(q(e).signer,e)})}function xr(e){let{tokenAddress:t,userAddress:n,logs:r,decrypt:i}=e;return J({...gt(q(t),{userAddress:n,logs:r,decrypt:i??!0,logsKey:r?.map(e=>`${e.transactionHash??``}:${e.logIndex??``}`).join(`,`)??``})})}function Sr(e,t){return R({...bt(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),qt(a.client,e.tokenAddress)}})}function Cr(e,t){return J({...k(q(e).signer,e),...t})}function wr(e){return Y({...k(q(e).signer,e)})}function Tr(e,t){return J({...A(q(e).signer,e),...t})}function Er(e){return Y({...A(q(e).signer,e)})}function Dr(e,t){return J({...N(q(e).signer,e),...t})}function Or(e){return Y({...N(q(e).signer,e)})}function kr(e,t){return J({...fn(W().signer,e),...t})}function Ar(e,t){return J({...Sn(W().signer,e),...t})}function jr(e,t){return J({...St(W().signer,e),...t})}function Mr(e,t){return J({...Vt(W().signer,e),...t})}export{e as ApprovalFailedError,t as BATCH_SWAP_ABI,n as ChromeSessionStorage,r as CredentialsManager,i as DEPLOYMENT_COORDINATOR_ABI,a as DecryptionFailedError,o as ENCRYPTION_ABI,s as ERC165_ABI,c as ERC20_ABI,l as ERC20_METADATA_ABI,u as ERC7984_INTERFACE_ID,d as ERC7984_WRAPPER_INTERFACE_ID,f as EncryptionFailedError,p as FEE_MANAGER_ABI,m as HardhatConfig,h as IndexedDBStorage,ee as InvalidKeypairError,te as KeypairExpiredError,ne as MainnetConfig,re as MemoryStorage,ie as NoCiphertextError,ae as ReadonlyToken,oe as RelayerRequestFailedError,se as RelayerWeb,ce as SepoliaConfig,le as SigningFailedError,ue as SigningRejectedError,de as TOKEN_TOPICS,fe as TRANSFER_BATCHER_ABI,pe as Token,me as Topics,he as TransactionRevertedError,ge as WRAPPER_ABI,_e as ZERO_HANDLE,ve as ZamaError,ye as ZamaErrorCode,Ln as ZamaProvider,be as ZamaSDK,Se as ZamaSDKEvents,ht as activityFeedQueryOptions,_t as allowMutationOptions,Ce as allowanceContract,we as applyDecryptedValues,Te as approveContract,yt as approveUnderlyingMutationOptions,Ee as balanceOfContract,xt as batchTransferFeeQueryOptions,De as chromeSessionStorage,Oe as clearPendingUnshield,Ct as confidentialApproveMutationOptions,ke as confidentialBalanceOfContract,Tt as confidentialBalanceQueryOptions,Dt as confidentialBalancesQueryOptions,Ae as confidentialBatchTransferContract,kt as confidentialHandleQueryOptions,jt as confidentialHandlesQueryOptions,Nt as confidentialIsApprovedQueryOptions,je as confidentialTotalSupplyContract,Me as confidentialTransferContract,g as confidentialTransferFromContract,Pt as confidentialTransferFromMutationOptions,It as confidentialTransferMutationOptions,_ as decimalsContract,v as decodeConfidentialTransfer,y as decodeOnChainEvent,b as decodeOnChainEvents,x as decodeUnwrapRequested,Ne as decodeUnwrappedFinalized,Pe as decodeUnwrappedStarted,Fe as decodeWrapped,G as decryptionKeys,Ie as deploymentCoordinatorContract,Rt as encryptMutationOptions,Le as extractEncryptedHandles,Bt as feeRecipientQueryOptions,Ht as filterQueryOptions,Re as finalizeUnwrapContract,Ut as finalizeUnwrapMutationOptions,ze as findUnwrapRequested,Be as findWrapped,Ve as getBatchTransferFeeContract,He as getFeeRecipientContract,Ue as getUnwrapFeeContract,We as getWrapFeeContract,Ge as getWrapperContract,Gt as hashFn,Ke as indexedDBStorage,Jt as isAllowedQueryOptions,Xt as isConfidentialQueryOptions,qe as isConfidentialTokenContract,Je as isConfidentialWrapperContract,Ye as isFinalizeUnwrapOperatorContract,Xe as isOperatorContract,Zt as isWrapperQueryOptions,Ze as loadPendingUnshield,Qe as matchZamaError,$e as nameContract,et as parseActivityFeed,Qt as publicKeyQueryOptions,en as publicParamsQueryOptions,tt as rateContract,nn as resumeUnshieldMutationOptions,an as revokeMutationOptions,sn as revokeSessionMutationOptions,nt as savePendingUnshield,rt as setFinalizeUnwrapOperatorContract,it as setOperatorContract,ln as shieldETHMutationOptions,dn as shieldFeeQueryOptions,pn as shieldMutationOptions,hn as signerAddressQueryOptions,at as sortByBlockNumber,ot as supportsInterfaceContract,st as symbolContract,gn as tokenMetadataQueryOptions,ct as totalSupplyContract,_n as totalSupplyQueryOptions,vn as underlyingAllowanceQueryOptions,lt as underlyingContract,yn as unshieldAllMutationOptions,xn as unshieldFeeQueryOptions,Cn as unshieldMutationOptions,Tn as unwrapAllMutationOptions,ut as unwrapContract,dt as unwrapFromBalanceContract,Dn as unwrapMutationOptions,xr as useActivityFeed,$n as useAllow,Sr as useApproveUnderlying,jr as useBatchTransferFee,ar as useConfidentialApprove,Zn as useConfidentialBalance,Qn as useConfidentialBalances,or as useConfidentialIsApproved,sr as useConfidentialIsApprovedSuspense,rr as useConfidentialTransfer,ir as useConfidentialTransferFrom,Un as useCreateDelegatedUserDecryptEIP712,Hn as useCreateEIP712,Wn as useDelegatedUserDecrypt,Rn as useEncrypt,Mr as useFeeRecipient,fr as useFinalizeUnwrap,Vn as useGenerateKeypair,er as useIsAllowed,Cr as useIsConfidential,wr as useIsConfidentialSuspense,Tr as useIsWrapper,Er as useIsWrapperSuspense,yr as useMetadata,br as useMetadataSuspense,Bn as usePublicDecrypt,Kn as usePublicKey,qn as usePublicParams,q as useReadonlyToken,Gn as useRequestZKProofVerification,$ as useResumeUnshield,tr as useRevoke,nr as useRevokeSession,cr as useShield,lr as useShieldETH,kr as useShieldFee,K as useToken,Dr as useTotalSupply,Or as useTotalSupplySuspense,hr as useUnderlyingAllowance,gr as useUnderlyingAllowanceSuspense,pr as useUnshield,mr as useUnshieldAll,Ar as useUnshieldFee,ur as useUnwrap,dr as useUnwrapAll,zn as useUserDecrypt,Jn as useUserDecryptFlow,Yn as useUserDecryptedValue,Xn as useUserDecryptedValues,_r as useWrapperDiscovery,vr as useWrapperDiscoverySuspense,W as useZamaSDK,ft as wrapContract,pt as wrapETHContract,kn as wrapperDiscoveryQueryOptions,mt as wrapperExistsContract,An as zamaQueryKeys};
+"use client";import{ApprovalFailedError as e,BATCH_SWAP_ABI as t,ChromeSessionStorage as n,CredentialsManager as r,DEPLOYMENT_COORDINATOR_ABI as i,DecryptionFailedError as a,ENCRYPTION_ABI as o,ERC165_ABI as s,ERC20_ABI as c,ERC20_METADATA_ABI as l,ERC7984_INTERFACE_ID as u,ERC7984_WRAPPER_INTERFACE_ID as d,EncryptionFailedError as f,FEE_MANAGER_ABI as p,HardhatConfig as m,IndexedDBStorage as h,InvalidKeypairError as ee,KeypairExpiredError as te,MainnetConfig as ne,MemoryStorage as re,NoCiphertextError as ie,ReadonlyToken as ae,RelayerRequestFailedError as oe,RelayerWeb as se,SepoliaConfig as ce,SigningFailedError as le,SigningRejectedError as ue,TOKEN_TOPICS as de,TRANSFER_BATCHER_ABI as fe,Token as pe,Topics as me,TransactionRevertedError as he,WRAPPER_ABI as ge,ZERO_HANDLE as _e,ZamaError as ve,ZamaErrorCode as ye,ZamaSDK as be,ZamaSDK as xe,ZamaSDKEvents as Se,allowanceContract as Ce,applyDecryptedValues as we,approveContract as Te,balanceOfContract as Ee,chromeSessionStorage as De,clearPendingUnshield as Oe,confidentialBalanceOfContract as ke,confidentialBatchTransferContract as Ae,confidentialTotalSupplyContract as je,confidentialTransferContract as Me,confidentialTransferFromContract as g,decimalsContract as _,decodeConfidentialTransfer as v,decodeOnChainEvent as y,decodeOnChainEvents as b,decodeUnwrapRequested as x,decodeUnwrappedFinalized as Ne,decodeUnwrappedStarted as Pe,decodeWrapped as Fe,deploymentCoordinatorContract as Ie,extractEncryptedHandles as Le,finalizeUnwrapContract as Re,findUnwrapRequested as ze,findWrapped as Be,getBatchTransferFeeContract as Ve,getFeeRecipientContract as He,getUnwrapFeeContract as Ue,getWrapFeeContract as We,getWrapperContract as Ge,indexedDBStorage as Ke,isConfidentialTokenContract as qe,isConfidentialWrapperContract as Je,isFinalizeUnwrapOperatorContract as Ye,isOperatorContract as Xe,loadPendingUnshield as Ze,matchZamaError as Qe,nameContract as $e,parseActivityFeed as et,rateContract as tt,savePendingUnshield as nt,setFinalizeUnwrapOperatorContract as rt,setOperatorContract as it,sortByBlockNumber as at,supportsInterfaceContract as ot,symbolContract as st,totalSupplyContract as ct,underlyingContract as lt,unwrapContract as ut,unwrapFromBalanceContract as dt,wrapContract as ft,wrapETHContract as pt,wrapperExistsContract as mt}from"@zama-fhe/sdk";import{activityFeedQueryOptions as ht,activityFeedQueryOptions as gt,allowMutationOptions as _t,allowMutationOptions as vt,approveUnderlyingMutationOptions as yt,approveUnderlyingMutationOptions as bt,batchTransferFeeQueryOptions as xt,batchTransferFeeQueryOptions as St,confidentialApproveMutationOptions as Ct,confidentialApproveMutationOptions as wt,confidentialBalanceQueryOptions as Tt,confidentialBalanceQueryOptions as Et,confidentialBalancesQueryOptions as Dt,confidentialBalancesQueryOptions as Ot,confidentialHandleQueryOptions as kt,confidentialHandleQueryOptions as At,confidentialHandlesQueryOptions as jt,confidentialHandlesQueryOptions as Mt,confidentialIsApprovedQueryOptions as Nt,confidentialIsApprovedQueryOptions as S,confidentialTransferFromMutationOptions as Pt,confidentialTransferFromMutationOptions as Ft,confidentialTransferMutationOptions as It,confidentialTransferMutationOptions as Lt,deriveActivityFeedLogsKey as Rt,encryptMutationOptions as zt,encryptMutationOptions as Bt,feeRecipientQueryOptions as Vt,feeRecipientQueryOptions as Ht,filterQueryOptions as Ut,finalizeUnwrapMutationOptions as Wt,finalizeUnwrapMutationOptions as Gt,hashFn as Kt,hashFn as C,invalidateAfterApprove as qt,invalidateAfterApproveUnderlying as Jt,invalidateAfterShield as w,invalidateAfterTransfer as T,invalidateAfterUnshield as E,invalidateAfterUnwrap as D,invalidateWalletLifecycleQueries as O,isAllowedQueryOptions as Yt,isAllowedQueryOptions as Xt,isConfidentialQueryOptions as Zt,isConfidentialQueryOptions as k,isWrapperQueryOptions as Qt,isWrapperQueryOptions as A,publicKeyQueryOptions as $t,publicKeyQueryOptions as en,publicParamsQueryOptions as tn,publicParamsQueryOptions as nn,resumeUnshieldMutationOptions as rn,resumeUnshieldMutationOptions as an,revokeMutationOptions as on,revokeMutationOptions as sn,revokeSessionMutationOptions as cn,revokeSessionMutationOptions as ln,shieldETHMutationOptions as un,shieldETHMutationOptions as dn,shieldFeeQueryOptions as fn,shieldFeeQueryOptions as pn,shieldMutationOptions as mn,shieldMutationOptions as hn,signerAddressQueryOptions as gn,signerAddressQueryOptions as j,tokenMetadataQueryOptions as _n,tokenMetadataQueryOptions as M,totalSupplyQueryOptions as vn,totalSupplyQueryOptions as N,underlyingAllowanceQueryOptions as yn,underlyingAllowanceQueryOptions as P,unshieldAllMutationOptions as bn,unshieldAllMutationOptions as xn,unshieldFeeQueryOptions as Sn,unshieldFeeQueryOptions as Cn,unshieldMutationOptions as wn,unshieldMutationOptions as Tn,unwrapAllMutationOptions as En,unwrapAllMutationOptions as Dn,unwrapMutationOptions as On,unwrapMutationOptions as kn,wrapperDiscoveryQueryOptions as An,wrapperDiscoveryQueryOptions as F,zamaQueryKeys as jn,zamaQueryKeys as I}from"@zama-fhe/sdk/query";import{skipToken as L,useMutation as R,useQueries as Mn,useQuery as z,useQueryClient as B,useSuspenseQuery as Nn}from"@tanstack/react-query";import{createContext as Pn,useContext as Fn,useEffect as V,useMemo as H,useRef as In}from"react";import{jsx as Ln}from"react/jsx-runtime";const U=Pn(null);function Rn({children:e,relayer:t,signer:n,storage:r,sessionStorage:i,keypairTTL:a,sessionTTL:o,onEvent:s}){let c=B(),l=In(s);V(()=>{l.current=s});let u=H(()=>n?.subscribe?{onDisconnect:()=>O(c),onAccountChange:()=>O(c),onChainChange:()=>O(c)}:void 0,[c,n]),d=H(()=>new xe({relayer:t,signer:n,storage:r,sessionStorage:i,keypairTTL:a,sessionTTL:o,onEvent:l.current,signerLifecycleCallbacks:u}),[t,n,r,i,a,o,u]);return V(()=>()=>d.dispose(),[d]),Ln(U.Provider,{value:d,children:e})}function W(){let e=Fn(U);if(!e)throw Error(`useZamaSDK must be used within a <ZamaProvider>. Wrap your component tree in <ZamaProvider relayer={…} signer={…} storage={…}>.`);return e}function zn(){return R(Bt(W()))}const G={value:(e,t)=>I.decryption.handle(e,t)};function Bn(){let e=W(),t=B();return R({mutationFn:t=>e.relayer.userDecrypt(t),onSuccess:e=>{for(let[n,r]of Object.entries(e))t.setQueryData(G.value(n),r)}})}function Vn(){let e=W(),t=B();return R({mutationFn:t=>e.relayer.publicDecrypt(t),onSuccess:e=>{for(let[n,r]of Object.entries(e.clearValues))t.setQueryData(G.value(n),r)}})}function Hn(){let e=W();return R({mutationFn:()=>e.relayer.generateKeypair()})}function Un(){let e=W();return R({mutationFn:({publicKey:t,contractAddresses:n,startTimestamp:r,durationDays:i})=>e.relayer.createEIP712(t,n,r,i)})}function Wn(){let e=W();return R({mutationFn:({publicKey:t,contractAddresses:n,delegatorAddress:r,startTimestamp:i,durationDays:a})=>e.relayer.createDelegatedUserDecryptEIP712(t,n,r,i,a)})}function Gn(){let e=W();return R({mutationFn:t=>e.relayer.delegatedUserDecrypt(t)})}function Kn(){let e=W();return R({mutationFn:t=>e.relayer.requestZKProofVerification(t)})}function qn(){return z({...en(W()),queryKeyHashFn:C})}function Jn(e){return z({...nn(W(),e),queryKeyHashFn:C})}function Yn(e){let t=W(),n=B(),r=e?.callbacks;return R({mutationKey:[`userDecryptFlow`],mutationFn:async({handles:e,durationDays:n=1})=>{let i=await t.relayer.generateKeypair();r?.onKeypairGenerated?.();let a=[...new Set(e.map(e=>e.contractAddress))],o=Math.floor(Date.now()/1e3),s=await t.relayer.createEIP712(i.publicKey,a,o,n);r?.onEIP712Created?.();let c=await t.signer.signTypedData(s);r?.onSigned?.(c);let l=await t.signer.getAddress(),u={},d=new Map;for(let t of e){let e=d.get(t.contractAddress)??[];e.push(t.handle),d.set(t.contractAddress,e)}for(let[e,r]of d){let s=await t.relayer.userDecrypt({handles:r,contractAddress:e,signedContractAddresses:a,privateKey:i.privateKey,publicKey:i.publicKey,signature:c,signerAddress:l,startTimestamp:o,durationDays:n});Object.assign(u,s)}let f=u;return r?.onDecrypted?.(f),f},onSuccess:e=>{for(let[t,r]of Object.entries(e))n.setQueryData(G.value(t),r)}})}function Xn(e){return z({queryKey:G.value(e??`0x`),queryKeyHashFn:C,queryFn:()=>void 0,enabled:!1})}function Zn(e){let t=Mn({queries:e.map(e=>({queryKey:G.value(e),queryKeyHashFn:C,queryFn:()=>void 0,enabled:!1}))}),n={};for(let r=0;r<e.length;r++)n[e[r]]=t[r].data;return{data:n,results:t}}function K(e){let t=W();return H(()=>t.createToken(e.tokenAddress,e.wrapperAddress),[t,e.tokenAddress,e.wrapperAddress])}function q(e){let t=W();return H(()=>t.createReadonlyToken(e),[t,e])}function J(e){return z({...e,queryKeyHashFn:C})}function Y(e){return Nn({...e,queryKeyHashFn:C})}function Qn(e,t){let{tokenAddress:n,handleRefetchInterval:r}=e,i=t?.enabled,a=q(n),o=J({...j(a.signer)}).data,s=At(a.signer,n,{owner:o,pollingInterval:r}),c=s.enabled??!0,l=J({...s,enabled:c&&(i??!0)}),u=l.data,d=Et(a,{handle:u,owner:o}),f=d.enabled??!0;return{...J({...d,...t,enabled:f&&(i??!0)}),handleQuery:l}}function $n(e,t){let{tokenAddresses:n,handleRefetchInterval:r,maxConcurrency:i}=e,a=t?.enabled,o=W(),s=J({...j(o.signer)}).data,c=H(()=>n.map(e=>o.createReadonlyToken(e)),[o,n]),l=Mt(o.signer,n,{owner:s,pollingInterval:r}),u=l.enabled??!0,d=J({...l,enabled:u&&(a??!0)}),f=d.data,p=Array.isArray(f)&&f.length===n.length,m=Ot(c,{owner:s,handles:f,maxConcurrency:i,resultAddresses:n}),h=m.enabled??!0;return{...J({...m,...t,enabled:h&&p&&(a??!0)}),handlesQuery:d}}function er(e){return R({...vt(W()),...e,onSuccess:(t,n,r,i)=>{e?.onSuccess?.(t,n,r,i),i.client.invalidateQueries({queryKey:I.isAllowed.all})}})}function tr(){let e=W(),t=J({...j(e.signer)}).data,n=t?Xt(e,{account:t}):{queryKey:I.isAllowed.all,queryFn:L},r=`enabled`in n?n.enabled??!0:!0;return J({...n,enabled:r})}function nr(e){return R({...sn(W()),...e,onSuccess:(t,n,r,i)=>{e?.onSuccess?.(t,n,r,i),i.client.invalidateQueries({queryKey:I.isAllowed.all})}})}function rr(e){return R({...ln(W()),...e,onSuccess:(t,n,r,i)=>{e?.onSuccess?.(t,n,r,i),i.client.invalidateQueries({queryKey:I.isAllowed.all})}})}function X(e,t){let n=e?t:void 0;return{wrappedContext:n,callerContext:e?n?.callerContext:t}}async function Z(e,t,n,r){let i=I.confidentialBalance.token(t);await e.cancelQueries({queryKey:i});let a=e.getQueriesData({queryKey:i});for(let[t,i]of a)i!==void 0&&e.setQueryData(t,r===`add`?i+n:i-n);return a}function Q(e,t){for(let[n,r]of t)e.setQueryData(n,r)}function ir(e,t){let n=K(e),r=B();return R({...Lt(n),...t,onMutate:e.optimistic?async(n,i)=>({snapshot:await Z(r,e.tokenAddress,n.amount,`subtract`),callerContext:await t?.onMutate?.(n,i)}):t?.onMutate,onError:(n,i,a,o)=>{let{wrappedContext:s,callerContext:c}=X(e.optimistic,a);s&&Q(r,s.snapshot),t?.onError?.(n,i,c,o)},onSuccess:(n,r,i,a)=>{let{callerContext:o}=X(e.optimistic,i);t?.onSuccess?.(n,r,o,a),T(a.client,e.tokenAddress)},onSettled:(n,r,i,a,o)=>{let{callerContext:s}=X(e.optimistic,a);t?.onSettled?.(n,r,i,s,o)}})}function ar(e,t){return R({...Ft(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),T(a.client,e.tokenAddress)}})}function or(e,t){return R({...wt(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),qt(a.client,e.tokenAddress)}})}function sr(e,t){let{spender:n,holder:r,...i}=e,a=t?.enabled,o=K(i),s=J({...j(o.signer),enabled:r===void 0}),c=r??s.data,l=n&&c?S(o.signer,o.address,{holder:c,spender:n}):{queryKey:I.confidentialIsApproved.token(e.tokenAddress),queryFn:L},u=`enabled`in l?l.enabled??!0:!0;return J({...l,...t,enabled:u&&(a??!0)})}function cr(e){let{spender:t,holder:n,...r}=e,i=K(r),a=Y({...j(i.signer)}),o=n??a.data;return Y({...S(i.signer,i.address,{holder:o,spender:t})})}function lr(e,t){let n=K(e),r=B();return R({...hn(n),...t,onMutate:e.optimistic?async(n,i)=>({snapshot:await Z(r,e.tokenAddress,n.amount,`add`),callerContext:await t?.onMutate?.(n,i)}):t?.onMutate,onError:(n,i,a,o)=>{let{wrappedContext:s,callerContext:c}=X(e.optimistic,a);s&&Q(r,s.snapshot),t?.onError?.(n,i,c,o)},onSuccess:(n,r,i,a)=>{let{callerContext:o}=X(e.optimistic,i);t?.onSuccess?.(n,r,o,a),w(a.client,e.tokenAddress)},onSettled:(n,r,i,a,o)=>{let{callerContext:s}=X(e.optimistic,a);t?.onSettled?.(n,r,i,s,o)}})}function ur(e,t){return R({...dn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),w(a.client,e.tokenAddress)}})}function dr(e,t){return R({...kn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),D(a.client,e.tokenAddress)}})}function fr(e,t){return R({...Dn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),D(a.client,e.tokenAddress)}})}function pr(e,t){return R({...Gt(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function mr(e,t){return R({...Tn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function hr(e,t){return R({...xn(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function gr(e,t){return R({...an(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),E(a.client,e.tokenAddress)}})}function _r(e,t){let{tokenAddress:n,wrapperAddress:r}=e,i=t?.enabled,a=q(n),o=J({...j(a.signer)}).data,s=P(a.signer,n,{owner:o,wrapperAddress:r}),c=s.enabled??!0;return J({...s,...t,enabled:c&&(i??!0)})}function vr(e){let{tokenAddress:t,wrapperAddress:n}=e,r=q(t),i=Y({...j(r.signer)}).data;return Y({...P(r.signer,t,{owner:i,wrapperAddress:n})})}function yr(e,t){let{tokenAddress:n,coordinatorAddress:r}=e,i=q(n);return J({...r?F(i.signer,n,{coordinatorAddress:r}):{queryKey:I.wrapperDiscovery.all,queryFn:L},...t})}function br(e){let{tokenAddress:t,coordinatorAddress:n}=e;return Y({...F(q(t).signer,t,{coordinatorAddress:n})})}function xr(e,t){return J({...M(q(e).signer,e),...t})}function Sr(e){return Y({...M(q(e).signer,e)})}function Cr(e){let{tokenAddress:t,userAddress:n,logs:r,decrypt:i}=e;return J({...gt(q(t),{userAddress:n,logs:r,decrypt:i??!0,logsKey:Rt(r)})})}function $(e,t){return R({...bt(K(e)),...t,onSuccess:(n,r,i,a)=>{t?.onSuccess?.(n,r,i,a),Jt(a.client,e.tokenAddress)}})}function wr(e,t){return J({...k(q(e).signer,e),...t})}function Tr(e){return Y({...k(q(e).signer,e)})}function Er(e,t){return J({...A(q(e).signer,e),...t})}function Dr(e){return Y({...A(q(e).signer,e)})}function Or(e,t){return J({...N(q(e).signer,e),...t})}function kr(e){return Y({...N(q(e).signer,e)})}function Ar(e,t){let n=W(),r=t?.enabled,i=pn(n.signer,e),a=i.enabled??!0;return J({...i,...t,enabled:a&&(r??!0)})}function jr(e,t){let n=W(),r=t?.enabled,i=Cn(n.signer,e),a=i.enabled??!0;return J({...i,...t,enabled:a&&(r??!0)})}function Mr(e,t){let n=W(),r=t?.enabled,i=St(n.signer,e),a=i.enabled??!0;return J({...i,...t,enabled:a&&(r??!0)})}function Nr(e,t){let n=W(),r=t?.enabled,i=Ht(n.signer,e),a=i.enabled??!0;return J({...i,...t,enabled:a&&(r??!0)})}export{e as ApprovalFailedError,t as BATCH_SWAP_ABI,n as ChromeSessionStorage,r as CredentialsManager,i as DEPLOYMENT_COORDINATOR_ABI,a as DecryptionFailedError,o as ENCRYPTION_ABI,s as ERC165_ABI,c as ERC20_ABI,l as ERC20_METADATA_ABI,u as ERC7984_INTERFACE_ID,d as ERC7984_WRAPPER_INTERFACE_ID,f as EncryptionFailedError,p as FEE_MANAGER_ABI,m as HardhatConfig,h as IndexedDBStorage,ee as InvalidKeypairError,te as KeypairExpiredError,ne as MainnetConfig,re as MemoryStorage,ie as NoCiphertextError,ae as ReadonlyToken,oe as RelayerRequestFailedError,se as RelayerWeb,ce as SepoliaConfig,le as SigningFailedError,ue as SigningRejectedError,de as TOKEN_TOPICS,fe as TRANSFER_BATCHER_ABI,pe as Token,me as Topics,he as TransactionRevertedError,ge as WRAPPER_ABI,_e as ZERO_HANDLE,ve as ZamaError,ye as ZamaErrorCode,Rn as ZamaProvider,be as ZamaSDK,Se as ZamaSDKEvents,ht as activityFeedQueryOptions,_t as allowMutationOptions,Ce as allowanceContract,we as applyDecryptedValues,Te as approveContract,yt as approveUnderlyingMutationOptions,Ee as balanceOfContract,xt as batchTransferFeeQueryOptions,De as chromeSessionStorage,Oe as clearPendingUnshield,Ct as confidentialApproveMutationOptions,ke as confidentialBalanceOfContract,Tt as confidentialBalanceQueryOptions,Dt as confidentialBalancesQueryOptions,Ae as confidentialBatchTransferContract,kt as confidentialHandleQueryOptions,jt as confidentialHandlesQueryOptions,Nt as confidentialIsApprovedQueryOptions,je as confidentialTotalSupplyContract,Me as confidentialTransferContract,g as confidentialTransferFromContract,Pt as confidentialTransferFromMutationOptions,It as confidentialTransferMutationOptions,_ as decimalsContract,v as decodeConfidentialTransfer,y as decodeOnChainEvent,b as decodeOnChainEvents,x as decodeUnwrapRequested,Ne as decodeUnwrappedFinalized,Pe as decodeUnwrappedStarted,Fe as decodeWrapped,G as decryptionKeys,Ie as deploymentCoordinatorContract,zt as encryptMutationOptions,Le as extractEncryptedHandles,Vt as feeRecipientQueryOptions,Ut as filterQueryOptions,Re as finalizeUnwrapContract,Wt as finalizeUnwrapMutationOptions,ze as findUnwrapRequested,Be as findWrapped,Ve as getBatchTransferFeeContract,He as getFeeRecipientContract,Ue as getUnwrapFeeContract,We as getWrapFeeContract,Ge as getWrapperContract,Kt as hashFn,Ke as indexedDBStorage,Yt as isAllowedQueryOptions,Zt as isConfidentialQueryOptions,qe as isConfidentialTokenContract,Je as isConfidentialWrapperContract,Ye as isFinalizeUnwrapOperatorContract,Xe as isOperatorContract,Qt as isWrapperQueryOptions,Ze as loadPendingUnshield,Qe as matchZamaError,$e as nameContract,et as parseActivityFeed,$t as publicKeyQueryOptions,tn as publicParamsQueryOptions,tt as rateContract,rn as resumeUnshieldMutationOptions,on as revokeMutationOptions,cn as revokeSessionMutationOptions,nt as savePendingUnshield,rt as setFinalizeUnwrapOperatorContract,it as setOperatorContract,un as shieldETHMutationOptions,fn as shieldFeeQueryOptions,mn as shieldMutationOptions,gn as signerAddressQueryOptions,at as sortByBlockNumber,ot as supportsInterfaceContract,st as symbolContract,_n as tokenMetadataQueryOptions,ct as totalSupplyContract,vn as totalSupplyQueryOptions,yn as underlyingAllowanceQueryOptions,lt as underlyingContract,bn as unshieldAllMutationOptions,Sn as unshieldFeeQueryOptions,wn as unshieldMutationOptions,En as unwrapAllMutationOptions,ut as unwrapContract,dt as unwrapFromBalanceContract,On as unwrapMutationOptions,Cr as useActivityFeed,er as useAllow,$ as useApproveUnderlying,Mr as useBatchTransferFee,or as useConfidentialApprove,Qn as useConfidentialBalance,$n as useConfidentialBalances,sr as useConfidentialIsApproved,cr as useConfidentialIsApprovedSuspense,ir as useConfidentialTransfer,ar as useConfidentialTransferFrom,Wn as useCreateDelegatedUserDecryptEIP712,Un as useCreateEIP712,Gn as useDelegatedUserDecrypt,zn as useEncrypt,Nr as useFeeRecipient,pr as useFinalizeUnwrap,Hn as useGenerateKeypair,tr as useIsAllowed,wr as useIsConfidential,Tr as useIsConfidentialSuspense,Er as useIsWrapper,Dr as useIsWrapperSuspense,xr as useMetadata,Sr as useMetadataSuspense,Vn as usePublicDecrypt,qn as usePublicKey,Jn as usePublicParams,q as useReadonlyToken,Kn as useRequestZKProofVerification,gr as useResumeUnshield,nr as useRevoke,rr as useRevokeSession,lr as useShield,ur as useShieldETH,Ar as useShieldFee,K as useToken,Or as useTotalSupply,kr as useTotalSupplySuspense,_r as useUnderlyingAllowance,vr as useUnderlyingAllowanceSuspense,mr as useUnshield,hr as useUnshieldAll,jr as useUnshieldFee,dr as useUnwrap,fr as useUnwrapAll,Bn as useUserDecrypt,Yn as useUserDecryptFlow,Xn as useUserDecryptedValue,Zn as useUserDecryptedValues,yr as useWrapperDiscovery,br as useWrapperDiscoverySuspense,W as useZamaSDK,ft as wrapContract,pt as wrapETHContract,An as wrapperDiscoveryQueryOptions,mt as wrapperExistsContract,jn as zamaQueryKeys};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

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