@zama-fhe/react-sdk 2.1.1-alpha.2 → 2.2.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -673,7 +673,7 @@ interface UseUnderlyingAllowanceConfig {
673
673
 
674
674
  #### `useWrapperDiscovery`
675
675
 
676
- Find the wrapper contract for a given token via the deployment coordinator. Enabled only when `coordinatorAddress` is defined. Results are cached indefinitely (`staleTime: Infinity`).
676
+ Find the wrapper contract for a given token via the on-chain registry. Enabled only when `erc20Address` is defined. Results are cached indefinitely (`staleTime: Infinity`).
677
677
 
678
678
  ```ts
679
679
  function useWrapperDiscovery(
@@ -683,7 +683,7 @@ function useWrapperDiscovery(
683
683
 
684
684
  interface UseWrapperDiscoveryConfig {
685
685
  tokenAddress: Address;
686
- coordinatorAddress: Address | undefined;
686
+ erc20Address: Address | undefined;
687
687
  }
688
688
  ```
689
689
 
package/dist/index.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  "use client";
2
2
 
3
3
  import * as _zama_fhe_sdk0 from "@zama-fhe/sdk";
4
- import { ActivityAmount, ActivityDirection, ActivityItem, ActivityItem as ActivityItem$1, ActivityLogMetadata, ActivityLogMetadata as ActivityLogMetadata$1, ActivityType, Address, Address as Address$1, ApprovalFailedError, ApproveSubmittedEvent, ApproveUnderlyingSubmittedEvent, BaseEvent, BatchDecryptAsOptions, BatchDecryptAsOptions as BatchDecryptAsOptions$1, BatchDecryptOptions, BatchTransferData, ChromeSessionStorage, ClearValueType, ClearValueType as ClearValueType$1, ConfidentialTransferEvent, ContractAbi, CredentialsAllowedEvent, CredentialsCachedEvent, CredentialsCreatedEvent, CredentialsCreatingEvent, CredentialsExpiredEvent, CredentialsLoadingEvent, CredentialsManager, CredentialsManagerConfig, CredentialsRevokedEvent, DecryptEndEvent, DecryptErrorEvent, DecryptStartEvent, DecryptionFailedError, DelegatedCredentialsManager, DelegatedCredentialsManagerConfig, DelegatedStoredCredentials, DelegatedUserDecryptParams, DelegatedUserDecryptParams as DelegatedUserDecryptParams$1, EIP712TypedData, EIP712TypedData as EIP712TypedData$1, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, EncryptEndEvent, EncryptErrorEvent, EncryptInput, EncryptParams, EncryptParams as EncryptParams$1, EncryptResult, EncryptResult as EncryptResult$1, EncryptStartEvent, EncryptionFailedError, FheTypeName, FhevmInstanceConfig, FinalizeUnwrapSubmittedEvent, GenericSigner, GenericSigner as GenericSigner$1, GenericStorage, GenericStorage as GenericStorage$1, Handle, Handle as Handle$1, HardhatConfig, Hex, 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, ReadonlyToken as ReadonlyToken$1, ReadonlyTokenConfig, RelayerRequestFailedError, RelayerSDK, RelayerSDK as RelayerSDK$1, RelayerSDKStatus, RelayerWeb, RelayerWebConfig, RelayerWebSecurityConfig, SepoliaConfig, SessionExpiredEvent, ShieldCallbacks, ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, StoredCredentials, TOKEN_TOPICS, Token, TokenConfig, Topics, TransactionErrorEvent, TransactionReceipt, TransactionResult, TransactionResult as TransactionResult$1, TransactionRevertedError, TransferCallbacks, TransferFromSubmittedEvent, TransferSubmittedEvent, UnshieldCallbacks, UnshieldPhase1SubmittedEvent, UnshieldPhase2StartedEvent, UnshieldPhase2SubmittedEvent, UnwrapRequestedEvent, UnwrapSubmittedEvent, UnwrappedFinalizedEvent, UnwrappedStartedEvent, UserDecryptParams, 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, memoryStorage, nameContract, parseActivityFeed, rateContract, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, sortByBlockNumber, supportsInterfaceContract, symbolContract, totalSupplyContract, underlyingContract, unwrapContract, unwrapFromBalanceContract, wrapContract, wrapETHContract, wrapperExistsContract } from "@zama-fhe/sdk";
5
- import { ApproveUnderlyingParams, ApproveUnderlyingParams as ApproveUnderlyingParams$1, BatchDecryptBalancesAsParams, ConfidentialApproveParams, ConfidentialApproveParams as ConfidentialApproveParams$1, ConfidentialBalancesData, ConfidentialBalancesData as ConfidentialBalancesData$1, ConfidentialTransferFromParams, ConfidentialTransferFromParams as ConfidentialTransferFromParams$1, ConfidentialTransferParams, ConfidentialTransferParams as ConfidentialTransferParams$1, CreateDelegatedUserDecryptEIP712Params, CreateEIP712Params, DecryptBalanceAsParams, DecryptBalanceAsParams as DecryptBalanceAsParams$1, DecryptHandle, DelegateDecryptionParams, DelegateDecryptionParams as DelegateDecryptionParams$1, DelegationStatusData, DelegationStatusData as DelegationStatusData$1, DelegationStatusQueryConfig, FinalizeUnwrapParams, FinalizeUnwrapParams as FinalizeUnwrapParams$1, ResumeUnshieldParams, ResumeUnshieldParams as ResumeUnshieldParams$1, RevokeDelegationParams, RevokeDelegationParams as RevokeDelegationParams$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, UserDecryptCallbacks, UserDecryptCallbacks as UserDecryptCallbacks$1, UserDecryptMutationParams, UserDecryptMutationParams as UserDecryptMutationParams$1, activityFeedQueryOptions, allowMutationOptions, approveUnderlyingMutationOptions, batchDecryptBalancesAsMutationOptions, batchTransferFeeQueryOptions, confidentialApproveMutationOptions, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialHandleQueryOptions, confidentialHandlesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, createDelegatedUserDecryptEIP712MutationOptions, createEIP712MutationOptions, decryptBalanceAsMutationOptions, delegateDecryptionMutationOptions, delegatedUserDecryptMutationOptions, delegationStatusQueryOptions, encryptMutationOptions, feeRecipientQueryOptions, filterQueryOptions, finalizeUnwrapMutationOptions, generateKeypairMutationOptions, hashFn, isAllowedQueryOptions, isConfidentialQueryOptions, isWrapperQueryOptions, publicDecryptMutationOptions, publicKeyQueryOptions, publicParamsQueryOptions, requestZKProofVerificationMutationOptions, resumeUnshieldMutationOptions, revokeDelegationMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, shieldETHMutationOptions, shieldFeeQueryOptions, shieldMutationOptions, signerAddressQueryOptions, tokenMetadataQueryOptions, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, unshieldAllMutationOptions, unshieldFeeQueryOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapMutationOptions, userDecryptMutationOptions, wrapperDiscoveryQueryOptions, zamaQueryKeys } from "@zama-fhe/sdk/query";
4
+ import { ActivityAmount, ActivityDirection, ActivityItem, ActivityItem as ActivityItem$1, ActivityLogMetadata, ActivityLogMetadata as ActivityLogMetadata$1, ActivityType, Address, Address as Address$1, ApprovalFailedError, ApproveSubmittedEvent, ApproveUnderlyingSubmittedEvent, BaseEvent, BatchDecryptAsOptions, BatchDecryptAsOptions as BatchDecryptAsOptions$1, BatchDecryptOptions, BatchTransferData, ChromeSessionStorage, ClearValueType, ClearValueType as ClearValueType$1, ConfidentialTransferEvent, ConfigurationError, ContractAbi, CredentialsAllowedEvent, CredentialsCachedEvent, CredentialsCreatedEvent, CredentialsCreatingEvent, CredentialsExpiredEvent, CredentialsLoadingEvent, CredentialsManager, CredentialsManagerConfig, CredentialsRevokedEvent, DecryptEndEvent, DecryptErrorEvent, DecryptStartEvent, DecryptionFailedError, DefaultRegistryAddresses, DelegatedCredentialsManager, DelegatedCredentialsManagerConfig, DelegatedStoredCredentials, DelegatedUserDecryptParams, DelegatedUserDecryptParams as DelegatedUserDecryptParams$1, EIP712TypedData, EIP712TypedData as EIP712TypedData$1, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, EncryptEndEvent, EncryptErrorEvent, EncryptInput, EncryptParams, EncryptParams as EncryptParams$1, EncryptResult, EncryptResult as EncryptResult$1, EncryptStartEvent, EncryptionFailedError, FheTypeName, FhevmInstanceConfig, FinalizeUnwrapSubmittedEvent, GenericSigner, GenericSigner as GenericSigner$1, GenericStorage, GenericStorage as GenericStorage$1, Handle, Handle as Handle$1, HardhatConfig, Hex, IndexedDBStorage, InputProofBytesType, InvalidKeypairError, KeypairExpiredError, KeypairType, KmsDelegatedUserDecryptEIP712Type, ListPairsOptions, MainnetConfig, MemoryStorage, NetworkType, NoCiphertextError, OnChainEvent, PaginatedResult, PaginatedResult as PaginatedResult$1, PublicDecryptResult, PublicDecryptResult as PublicDecryptResult$1, RawLog, RawLog as RawLog$1, ReadContractArgs, ReadContractConfig, ReadContractReturnType, ReadFunctionName, ReadonlyToken, ReadonlyToken as ReadonlyToken$1, ReadonlyTokenConfig, RelayerRequestFailedError, RelayerSDK, RelayerSDK as RelayerSDK$1, RelayerSDKStatus, RelayerWeb, RelayerWebConfig, RelayerWebSecurityConfig, SepoliaConfig, SessionExpiredEvent, ShieldCallbacks, ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, StoredCredentials, TOKEN_TOPICS, Token, TokenConfig, TokenWrapperPair, TokenWrapperPair as TokenWrapperPair$1, TokenWrapperPairWithMetadata, TokenWrapperPairWithMetadata as TokenWrapperPairWithMetadata$1, Topics, TransactionErrorEvent, TransactionReceipt, TransactionResult, TransactionResult as TransactionResult$1, TransactionRevertedError, TransferCallbacks, TransferFromSubmittedEvent, TransferSubmittedEvent, UnshieldCallbacks, UnshieldPhase1SubmittedEvent, UnshieldPhase2StartedEvent, UnshieldPhase2SubmittedEvent, UnwrapRequestedEvent, UnwrapSubmittedEvent, UnwrappedFinalizedEvent, UnwrappedStartedEvent, UserDecryptParams, WrappedEvent, WrappersRegistry, WrappersRegistryConfig, WriteContractArgs, WriteContractConfig, WriteFunctionName, ZERO_HANDLE, ZKProofLike, ZKProofLike as ZKProofLike$1, ZamaError, ZamaErrorCode, ZamaSDK, ZamaSDK as ZamaSDK$1, ZamaSDKConfig, ZamaSDKEvent, ZamaSDKEventInput, ZamaSDKEventListener, ZamaSDKEventListener as ZamaSDKEventListener$1, ZamaSDKEventType, ZamaSDKEvents, allowanceContract, applyDecryptedValues, approveContract, balanceOfContract, chromeSessionStorage, clearPendingUnshield, confidentialBalanceOfContract, 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, memoryStorage, nameContract, parseActivityFeed, rateContract, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, sortByBlockNumber, supportsInterfaceContract, symbolContract, totalSupplyContract, underlyingContract, unwrapContract, unwrapFromBalanceContract, wrapContract, wrapETHContract, wrapperExistsContract } from "@zama-fhe/sdk";
5
+ import { ApproveUnderlyingParams, ApproveUnderlyingParams as ApproveUnderlyingParams$1, BatchDecryptBalancesAsParams, ConfidentialApproveParams, ConfidentialApproveParams as ConfidentialApproveParams$1, ConfidentialBalancesData, ConfidentialBalancesData as ConfidentialBalancesData$1, ConfidentialTransferFromParams, ConfidentialTransferFromParams as ConfidentialTransferFromParams$1, ConfidentialTransferParams, ConfidentialTransferParams as ConfidentialTransferParams$1, CreateDelegatedUserDecryptEIP712Params, CreateEIP712Params, DecryptBalanceAsParams, DecryptBalanceAsParams as DecryptBalanceAsParams$1, DecryptHandle, DelegateDecryptionParams, DelegateDecryptionParams as DelegateDecryptionParams$1, DelegationStatusData, DelegationStatusData as DelegationStatusData$1, DelegationStatusQueryConfig, FinalizeUnwrapParams, FinalizeUnwrapParams as FinalizeUnwrapParams$1, ListPairsQueryConfig, ResumeUnshieldParams, ResumeUnshieldParams as ResumeUnshieldParams$1, RevokeDelegationParams, RevokeDelegationParams as RevokeDelegationParams$1, 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, UserDecryptCallbacks, UserDecryptCallbacks as UserDecryptCallbacks$1, UserDecryptMutationParams, UserDecryptMutationParams as UserDecryptMutationParams$1, activityFeedQueryOptions, allowMutationOptions, approveUnderlyingMutationOptions, batchDecryptBalancesAsMutationOptions, batchTransferFeeQueryOptions, confidentialApproveMutationOptions, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialHandleQueryOptions, confidentialHandlesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, createDelegatedUserDecryptEIP712MutationOptions, createEIP712MutationOptions, decryptBalanceAsMutationOptions, delegateDecryptionMutationOptions, delegatedUserDecryptMutationOptions, delegationStatusQueryOptions, encryptMutationOptions, feeRecipientQueryOptions, filterQueryOptions, finalizeUnwrapMutationOptions, generateKeypairMutationOptions, hashFn, isAllowedQueryOptions, isConfidentialQueryOptions, isWrapperQueryOptions, listPairsQueryOptions, publicDecryptMutationOptions, publicKeyQueryOptions, publicParamsQueryOptions, requestZKProofVerificationMutationOptions, resumeUnshieldMutationOptions, revokeDelegationMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, shieldETHMutationOptions, shieldFeeQueryOptions, shieldMutationOptions, signerAddressQueryOptions, tokenMetadataQueryOptions, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, unshieldAllMutationOptions, unshieldFeeQueryOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapMutationOptions, userDecryptMutationOptions, wrapperDiscoveryQueryOptions, zamaQueryKeys } from "@zama-fhe/sdk/query";
6
6
  import * as _tanstack_react_query0 from "@tanstack/react-query";
7
7
  import { QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions } from "@tanstack/react-query";
8
8
  import { PropsWithChildren } from "react";
@@ -36,6 +36,16 @@ interface ZamaProviderProps extends PropsWithChildren {
36
36
  * - Positive number: seconds until the session signature expires and requires re-authentication.
37
37
  */
38
38
  sessionTTL?: number;
39
+ /**
40
+ * Per-chain wrappers registry address overrides, merged on top of built-in defaults.
41
+ * Use this for custom or local chains (e.g. Hardhat) where no default registry exists.
42
+ */
43
+ registryAddresses?: Record<number, Address$1>;
44
+ /**
45
+ * How long cached registry results remain valid, in seconds.
46
+ * Default: `86400` (24 hours).
47
+ */
48
+ registryTTL?: number;
39
49
  /** Callback invoked on SDK lifecycle events. */
40
50
  onEvent?: ZamaSDKEventListener$1;
41
51
  }
@@ -57,6 +67,8 @@ declare function ZamaProvider({
57
67
  sessionStorage,
58
68
  keypairTTL,
59
69
  sessionTTL,
70
+ registryAddresses,
71
+ registryTTL,
60
72
  onEvent
61
73
  }: ZamaProviderProps): react_jsx_runtime0.JSX.Element;
62
74
  /**
@@ -296,7 +308,7 @@ declare function useUserDecryptedValues(handles: Handle$1[]): {
296
308
  results: _tanstack_react_query0.UseQueryResult<never, Error>[];
297
309
  };
298
310
  //#endregion
299
- //#region src/token/use-allow.d.ts
311
+ //#region src/authorization/use-allow.d.ts
300
312
  /**
301
313
  * Sign an EIP-712 message authorizing decryption of confidential handles
302
314
  * for a list of contract addresses. This is not token-specific — any
@@ -319,7 +331,7 @@ declare function useUserDecryptedValues(handles: Handle$1[]): {
319
331
  */
320
332
  declare function useAllow(options?: UseMutationOptions<void, Error, Address$1[]>): _tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
321
333
  //#endregion
322
- //#region src/token/use-is-allowed.d.ts
334
+ //#region src/authorization/use-is-allowed.d.ts
323
335
  /**
324
336
  * Check whether a session signature is cached for the connected wallet.
325
337
  * Returns `true` if decrypt operations can proceed without a wallet prompt.
@@ -329,9 +341,9 @@ declare function useAllow(options?: UseMutationOptions<void, Error, Address$1[]>
329
341
  * const { data: allowed } = useIsAllowed();
330
342
  * ```
331
343
  */
332
- declare function useIsAllowed(): _tanstack_react_query0.UseQueryResult<unknown, Error>;
344
+ declare function useIsAllowed(): _tanstack_react_query0.UseQueryResult<boolean, Error>;
333
345
  //#endregion
334
- //#region src/token/use-revoke.d.ts
346
+ //#region src/authorization/use-revoke.d.ts
335
347
  /**
336
348
  * Revoke stored FHE decrypt credentials for a list of contract addresses.
337
349
  * This is not token-specific — it revokes the EIP-712 authorization for
@@ -348,7 +360,7 @@ declare function useIsAllowed(): _tanstack_react_query0.UseQueryResult<unknown,
348
360
  */
349
361
  declare function useRevoke(options?: UseMutationOptions<void, Error, Address$1[]>): _tanstack_react_query0.UseMutationResult<void, Error, `0x${string}`[], unknown>;
350
362
  //#endregion
351
- //#region src/token/use-revoke-session.d.ts
363
+ //#region src/authorization/use-revoke-session.d.ts
352
364
  /**
353
365
  * Revoke the session signature for the connected wallet without
354
366
  * specifying contract addresses. Useful for wallet disconnect handlers.
@@ -400,7 +412,7 @@ declare function useToken(config: UseZamaConfig): _zama_fhe_sdk0.Token;
400
412
  */
401
413
  declare function useReadonlyToken(address: Address$1): _zama_fhe_sdk0.ReadonlyToken;
402
414
  //#endregion
403
- //#region src/token/use-confidential-balance.d.ts
415
+ //#region src/balance/use-confidential-balance.d.ts
404
416
  /** Configuration for {@link useConfidentialBalance}. */
405
417
  interface UseConfidentialBalanceConfig {
406
418
  /** Address of the confidential token contract. */
@@ -409,7 +421,10 @@ interface UseConfidentialBalanceConfig {
409
421
  handleRefetchInterval?: number;
410
422
  }
411
423
  /** Query options for the decrypt phase of {@link useConfidentialBalance}. */
412
- type UseConfidentialBalanceOptions = Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn">;
424
+ interface UseConfidentialBalanceOptions extends Omit<UseQueryOptions<bigint>, "queryKey" | "queryFn" | "enabled"> {
425
+ /** Whether the query is enabled. Callback form is not supported in composite hooks. */
426
+ enabled?: boolean;
427
+ }
413
428
  /**
414
429
  * Declarative hook to read the connected wallet's confidential token balance.
415
430
  * Uses two-phase polling: cheaply polls the encrypted handle, then only
@@ -596,7 +611,7 @@ declare function useConfidentialBalance(config: UseConfidentialBalanceConfig, op
596
611
  promise: Promise<bigint>;
597
612
  };
598
613
  //#endregion
599
- //#region src/token/use-confidential-balances.d.ts
614
+ //#region src/balance/use-confidential-balances.d.ts
600
615
  /** Configuration for {@link useConfidentialBalances}. */
601
616
  interface UseConfidentialBalancesConfig {
602
617
  /** Addresses of the confidential token contracts to batch-query. */
@@ -607,7 +622,10 @@ interface UseConfidentialBalancesConfig {
607
622
  maxConcurrency?: number;
608
623
  }
609
624
  /** Query options for the decrypt phase of {@link useConfidentialBalances}. */
610
- type UseConfidentialBalancesOptions = Omit<UseQueryOptions<ConfidentialBalancesData$1>, "queryKey" | "queryFn">;
625
+ interface UseConfidentialBalancesOptions extends Omit<UseQueryOptions<ConfidentialBalancesData$1>, "queryKey" | "queryFn" | "enabled"> {
626
+ /** Whether the query is enabled. Callback form is not supported in composite hooks. */
627
+ enabled?: boolean;
628
+ }
611
629
  /**
612
630
  * Declarative hook to read multiple confidential token balances in batch.
613
631
  * Uses two-phase polling: cheaply polls encrypted handles, then only
@@ -801,7 +819,7 @@ declare function useConfidentialBalances(config: UseConfidentialBalancesConfig,
801
819
  promise: Promise<ConfidentialBalancesData$1>;
802
820
  };
803
821
  //#endregion
804
- //#region src/token/use-confidential-transfer.d.ts
822
+ //#region src/transfer/use-confidential-transfer.d.ts
805
823
  /** Configuration for {@link useConfidentialTransfer}. */
806
824
  interface UseConfidentialTransferConfig extends UseZamaConfig {
807
825
  /**
@@ -843,7 +861,7 @@ interface UseConfidentialTransferConfig extends UseZamaConfig {
843
861
  */
844
862
  declare function useConfidentialTransfer<TContext = unknown>(config: UseConfidentialTransferConfig, options?: UseMutationOptions<TransactionResult$1, Error, ConfidentialTransferParams$1, TContext>): UseMutationResult<TransactionResult$1, Error, ConfidentialTransferParams$1, TContext>;
845
863
  //#endregion
846
- //#region src/token/use-confidential-transfer-from.d.ts
864
+ //#region src/transfer/use-confidential-transfer-from.d.ts
847
865
  /**
848
866
  * Operator transfer on behalf of another address. Caller must be an approved operator.
849
867
  * Invalidates balance caches on success.
@@ -864,7 +882,7 @@ declare function useConfidentialTransfer<TContext = unknown>(config: UseConfiden
864
882
  */
865
883
  declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, ConfidentialTransferFromParams$1, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, ConfidentialTransferFromParams$1, `0x${string}`>;
866
884
  //#endregion
867
- //#region src/token/use-confidential-approve.d.ts
885
+ //#region src/transfer/use-confidential-approve.d.ts
868
886
  /**
869
887
  * Set operator approval for a confidential token. Defaults to 1 hour.
870
888
  *
@@ -883,7 +901,7 @@ declare function useConfidentialTransferFrom(config: UseZamaConfig, options?: Us
883
901
  */
884
902
  declare function useConfidentialApprove(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, ConfidentialApproveParams$1, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, ConfidentialApproveParams$1, `0x${string}`>;
885
903
  //#endregion
886
- //#region src/token/use-confidential-is-approved.d.ts
904
+ //#region src/transfer/use-confidential-is-approved.d.ts
887
905
  /** Configuration for {@link useConfidentialIsApproved}. */
888
906
  interface UseConfidentialIsApprovedConfig {
889
907
  /** Address of the confidential token contract. Pass `undefined` to disable the query. */
@@ -916,7 +934,7 @@ interface UseConfidentialIsApprovedSuspenseConfig extends UseZamaConfig {
916
934
  * });
917
935
  * ```
918
936
  */
919
- declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConfig, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<unknown, Error>;
937
+ declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConfig, options?: Omit<UseQueryOptions<boolean>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<boolean, Error>;
920
938
  /**
921
939
  * Suspense variant of {@link useConfidentialIsApproved}.
922
940
  * Suspends rendering until the approval check resolves.
@@ -935,7 +953,7 @@ declare function useConfidentialIsApproved(config: UseConfidentialIsApprovedConf
935
953
  */
936
954
  declare function useConfidentialIsApprovedSuspense(config: UseConfidentialIsApprovedSuspenseConfig): _tanstack_react_query0.UseSuspenseQueryResult<boolean, Error>;
937
955
  //#endregion
938
- //#region src/token/use-shield.d.ts
956
+ //#region src/shield/use-shield.d.ts
939
957
  /** Configuration for {@link useShield}. */
940
958
  interface UseShieldConfig extends UseZamaConfig {
941
959
  /**
@@ -966,7 +984,7 @@ interface UseShieldConfig extends UseZamaConfig {
966
984
  */
967
985
  declare function useShield<TContext = unknown>(config: UseShieldConfig, options?: UseMutationOptions<TransactionResult$1, Error, ShieldParams$1, TContext>): UseMutationResult<TransactionResult$1, Error, ShieldParams$1, TContext>;
968
986
  //#endregion
969
- //#region src/token/use-shield-eth.d.ts
987
+ //#region src/shield/use-shield-eth.d.ts
970
988
  /** Configuration for {@link useShieldETH}. */
971
989
  interface UseShieldETHConfig extends UseZamaConfig {
972
990
  /**
@@ -996,7 +1014,7 @@ interface UseShieldETHConfig extends UseZamaConfig {
996
1014
  */
997
1015
  declare function useShieldETH<TContext = unknown>(config: UseShieldETHConfig, options?: UseMutationOptions<TransactionResult$1, Error, ShieldETHParams$1, TContext>): UseMutationResult<TransactionResult$1, Error, ShieldETHParams$1, TContext>;
998
1016
  //#endregion
999
- //#region src/token/use-unwrap.d.ts
1017
+ //#region src/unwrap/use-unwrap.d.ts
1000
1018
  /**
1001
1019
  * Request an unwrap for a specific amount. Encrypts the amount first.
1002
1020
  * Call {@link useFinalizeUnwrap} after the request is processed on-chain,
@@ -1018,7 +1036,7 @@ declare function useShieldETH<TContext = unknown>(config: UseShieldETHConfig, op
1018
1036
  */
1019
1037
  declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, UnwrapParams$1, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, UnwrapParams$1, `0x${string}`>;
1020
1038
  //#endregion
1021
- //#region src/token/use-unwrap-all.d.ts
1039
+ //#region src/unwrap/use-unwrap-all.d.ts
1022
1040
  /**
1023
1041
  * Request an unwrap for the entire confidential balance.
1024
1042
  * Uses the on-chain balance handle directly (no encryption needed).
@@ -1039,7 +1057,7 @@ declare function useUnwrap(config: UseZamaConfig, options?: UseMutationOptions<T
1039
1057
  */
1040
1058
  declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, void, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, void, `0x${string}`>;
1041
1059
  //#endregion
1042
- //#region src/token/use-finalize-unwrap.d.ts
1060
+ //#region src/unwrap/use-finalize-unwrap.d.ts
1043
1061
  /**
1044
1062
  * Complete an unwrap by providing the public decryption proof.
1045
1063
  * Call this after an unwrap request has been processed on-chain.
@@ -1060,7 +1078,7 @@ declare function useUnwrapAll(config: UseZamaConfig, options?: UseMutationOption
1060
1078
  */
1061
1079
  declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, FinalizeUnwrapParams$1, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, FinalizeUnwrapParams$1, `0x${string}`>;
1062
1080
  //#endregion
1063
- //#region src/token/use-unshield.d.ts
1081
+ //#region src/unshield/use-unshield.d.ts
1064
1082
  /**
1065
1083
  * Unshield a specific amount and finalize in one call.
1066
1084
  * Orchestrates: unwrap → wait for receipt → parse event → finalize.
@@ -1082,7 +1100,7 @@ declare function useFinalizeUnwrap(config: UseZamaConfig, options?: UseMutationO
1082
1100
  */
1083
1101
  declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, UnshieldParams$1, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, UnshieldParams$1, `0x${string}`>;
1084
1102
  //#endregion
1085
- //#region src/token/use-unshield-all.d.ts
1103
+ //#region src/unshield/use-unshield-all.d.ts
1086
1104
  /**
1087
1105
  * Unshield the entire balance and finalize in one call.
1088
1106
  * Orchestrates: unwrapAll → wait for receipt → parse event → finalize.
@@ -1103,7 +1121,7 @@ declare function useUnshield(config: UseZamaConfig, options?: UseMutationOptions
1103
1121
  */
1104
1122
  declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, UnshieldAllParams$1 | void, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, void | UnshieldAllParams$1, `0x${string}`>;
1105
1123
  //#endregion
1106
- //#region src/token/use-resume-unshield.d.ts
1124
+ //#region src/unshield/use-resume-unshield.d.ts
1107
1125
  /**
1108
1126
  * Resume an interrupted unshield from an existing unwrap tx hash.
1109
1127
  * Useful when the user submitted the unwrap but the finalize step was
@@ -1124,7 +1142,7 @@ declare function useUnshieldAll(config: UseZamaConfig, options?: UseMutationOpti
1124
1142
  */
1125
1143
  declare function useResumeUnshield(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, ResumeUnshieldParams$1, Address$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, ResumeUnshieldParams$1, `0x${string}`>;
1126
1144
  //#endregion
1127
- //#region src/token/use-underlying-allowance.d.ts
1145
+ //#region src/shield/use-underlying-allowance.d.ts
1128
1146
  /** Configuration for {@link useUnderlyingAllowance}. */
1129
1147
  interface UseUnderlyingAllowanceConfig {
1130
1148
  /** Address of the confidential token contract used to scope the query cache. */
@@ -1169,32 +1187,40 @@ declare function useUnderlyingAllowanceSuspense(config: UseUnderlyingAllowanceCo
1169
1187
  //#region src/token/use-wrapper-discovery.d.ts
1170
1188
  /** Configuration for {@link useWrapperDiscovery}. */
1171
1189
  interface UseWrapperDiscoveryConfig {
1172
- /** Address of the underlying ERC-20 token. Pass `undefined` to disable the query. */
1173
- tokenAddress: Address$1 | undefined;
1174
- /** Address of the wrapper coordinator. Pass `undefined` to disable the query. */
1175
- coordinatorAddress: Address$1 | undefined;
1190
+ /**
1191
+ * Address of any confidential token you control.
1192
+ * Used only to derive the signer context and to scope the query cache key —
1193
+ * it does not affect which wrapper the registry returns.
1194
+ */
1195
+ tokenAddress: Address$1;
1196
+ /** ERC-20 address to discover the wrapper for. Pass `undefined` to disable the query. */
1197
+ erc20Address: Address$1 | undefined;
1176
1198
  }
1177
1199
  /** Configuration for {@link useWrapperDiscoverySuspense}. */
1178
1200
  interface UseWrapperDiscoverySuspenseConfig {
1179
- /** Address of the underlying ERC-20 token. */
1201
+ /**
1202
+ * Address of any confidential token you control.
1203
+ * Used only to derive the signer context and to scope the query cache key —
1204
+ * it does not affect which wrapper the registry returns.
1205
+ */
1180
1206
  tokenAddress: Address$1;
1181
- /** Address of the wrapper coordinator. */
1182
- coordinatorAddress: Address$1;
1207
+ /** ERC-20 address to discover the wrapper for. */
1208
+ erc20Address: Address$1;
1183
1209
  }
1184
1210
  /**
1185
- * Discover the wrapper contract for an ERC-20 token.
1211
+ * Discover the confidential wrapper for an ERC-20 token via the on-chain registry.
1186
1212
  * Returns the wrapper address if one exists, or `null` if not.
1187
1213
  * Cached indefinitely since wrapper mappings are immutable.
1188
1214
  *
1189
- * @param config - Token and coordinator addresses.
1215
+ * @param config - Token and ERC-20 addresses.
1190
1216
  * @param options - React Query options (forwarded to `useQuery`).
1191
1217
  * @returns Query result with `data: Address | null`.
1192
1218
  *
1193
1219
  * @example
1194
1220
  * ```tsx
1195
1221
  * const { data: wrapperAddress } = useWrapperDiscovery({
1196
- * tokenAddress: "0xUnderlying",
1197
- * coordinatorAddress: "0xCoordinator",
1222
+ * tokenAddress: "0xConfidentialToken",
1223
+ * erc20Address: "0xUSDC",
1198
1224
  * });
1199
1225
  * ```
1200
1226
  */
@@ -1203,14 +1229,14 @@ declare function useWrapperDiscovery(config: UseWrapperDiscoveryConfig, options?
1203
1229
  * Suspense variant of {@link useWrapperDiscovery}.
1204
1230
  * Suspends rendering until the wrapper address is resolved.
1205
1231
  *
1206
- * @param config - Token and coordinator addresses.
1232
+ * @param config - Token and ERC-20 addresses.
1207
1233
  * @returns Suspense query result with `data: Address | null`.
1208
1234
  *
1209
1235
  * @example
1210
1236
  * ```tsx
1211
1237
  * const { data: wrapperAddress } = useWrapperDiscoverySuspense({
1212
- * tokenAddress: "0xUnderlying",
1213
- * coordinatorAddress: "0xCoordinator",
1238
+ * tokenAddress: "0xConfidentialToken",
1239
+ * erc20Address: "0xUSDC",
1214
1240
  * });
1215
1241
  * ```
1216
1242
  */
@@ -1246,7 +1272,7 @@ declare function useMetadata(tokenAddress: Address$1, options?: Omit<UseQueryOpt
1246
1272
  */
1247
1273
  declare function useMetadataSuspense(tokenAddress: Address$1): _tanstack_react_query0.UseSuspenseQueryResult<TokenMetadata, Error>;
1248
1274
  //#endregion
1249
- //#region src/token/use-activity-feed.d.ts
1275
+ //#region src/balance/use-activity-feed.d.ts
1250
1276
  /** Configuration for {@link useActivityFeed}. */
1251
1277
  interface UseActivityFeedConfig {
1252
1278
  /** Address of the confidential token contract. */
@@ -1280,7 +1306,7 @@ interface UseActivityFeedConfig {
1280
1306
  */
1281
1307
  declare function useActivityFeed(config: UseActivityFeedConfig): _tanstack_react_query0.UseQueryResult<ActivityItem$1[], Error>;
1282
1308
  //#endregion
1283
- //#region src/token/use-delegate-decryption.d.ts
1309
+ //#region src/delegation/use-delegate-decryption.d.ts
1284
1310
  /**
1285
1311
  * Delegate FHE decryption rights for a token to another address via the on-chain ACL.
1286
1312
  *
@@ -1295,7 +1321,7 @@ declare function useActivityFeed(config: UseActivityFeedConfig): _tanstack_react
1295
1321
  */
1296
1322
  declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, DelegateDecryptionParams$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, DelegateDecryptionParams$1, unknown>;
1297
1323
  //#endregion
1298
- //#region src/token/use-revoke-delegation.d.ts
1324
+ //#region src/delegation/use-revoke-delegation.d.ts
1299
1325
  /**
1300
1326
  * Revoke FHE decryption delegation for a token from a delegate address.
1301
1327
  *
@@ -1310,7 +1336,7 @@ declare function useDelegateDecryption(config: UseZamaConfig, options?: UseMutat
1310
1336
  */
1311
1337
  declare function useRevokeDelegation(config: UseZamaConfig, options?: UseMutationOptions<TransactionResult$1, Error, RevokeDelegationParams$1>): _tanstack_react_query0.UseMutationResult<TransactionResult$1, Error, RevokeDelegationParams$1, unknown>;
1312
1338
  //#endregion
1313
- //#region src/token/use-delegation-status.d.ts
1339
+ //#region src/delegation/use-delegation-status.d.ts
1314
1340
  interface UseDelegationStatusConfig {
1315
1341
  /** Address of the confidential token contract. Pass `undefined` to disable the query. */
1316
1342
  tokenAddress: Address$1 | undefined;
@@ -1336,9 +1362,9 @@ interface UseDelegationStatusConfig {
1336
1362
  * // data?.isDelegated, data?.expiryTimestamp
1337
1363
  * ```
1338
1364
  */
1339
- declare function useDelegationStatus(config: UseDelegationStatusConfig, options?: Omit<UseQueryOptions<DelegationStatusData$1, Error>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<DelegationStatusData$1, Error>;
1365
+ declare function useDelegationStatus(config: UseDelegationStatusConfig, options?: Omit<UseQueryOptions<DelegationStatusData$1>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<DelegationStatusData$1, Error>;
1340
1366
  //#endregion
1341
- //#region src/token/use-decrypt-balance-as.d.ts
1367
+ //#region src/delegation/use-decrypt-balance-as.d.ts
1342
1368
  /**
1343
1369
  * Decrypt another user's confidential balance as a delegate.
1344
1370
  *
@@ -1354,7 +1380,7 @@ declare function useDelegationStatus(config: UseDelegationStatusConfig, options?
1354
1380
  */
1355
1381
  declare function useDecryptBalanceAs(tokenAddress: Address$1, options?: UseMutationOptions<bigint, Error, DecryptBalanceAsParams$1>): _tanstack_react_query0.UseMutationResult<bigint, Error, DecryptBalanceAsParams$1, unknown>;
1356
1382
  //#endregion
1357
- //#region src/token/use-batch-decrypt-balances-as.d.ts
1383
+ //#region src/delegation/use-batch-decrypt-balances-as.d.ts
1358
1384
  /**
1359
1385
  * Batch decrypt confidential balances as a delegate across multiple tokens.
1360
1386
  *
@@ -1372,7 +1398,7 @@ declare function useDecryptBalanceAs(tokenAddress: Address$1, options?: UseMutat
1372
1398
  */
1373
1399
  declare function useBatchDecryptBalancesAs(tokens: ReadonlyToken$1[], options?: UseMutationOptions<Map<Address$1, bigint>, Error, BatchDecryptAsOptions$1>): _tanstack_react_query0.UseMutationResult<Map<`0x${string}`, bigint>, Error, BatchDecryptAsOptions$1, unknown>;
1374
1400
  //#endregion
1375
- //#region src/token/use-approve-underlying.d.ts
1401
+ //#region src/shield/use-approve-underlying.d.ts
1376
1402
  /**
1377
1403
  * Approve the wrapper contract to spend the underlying ERC-20.
1378
1404
  * Defaults to max uint256. Resets to zero first if there's an existing
@@ -1554,7 +1580,118 @@ declare function useBatchTransferFee(feeManagerAddress: Address$1, options?: Omi
1554
1580
  */
1555
1581
  declare function useFeeRecipient(feeManagerAddress: Address$1, options?: Omit<UseQueryOptions<Address$1>, "queryKey" | "queryFn">): _tanstack_react_query0.UseQueryResult<`0x${string}`, Error>;
1556
1582
  //#endregion
1557
- //#region src/token/optimistic-balance-update.d.ts
1583
+ //#region src/wrappers-registry/use-wrappers-registry-address.d.ts
1584
+ /**
1585
+ * Resolves the wrappers registry address for the current chain.
1586
+ * Uses the merged registry addresses from `sdk.registry` (built-in defaults
1587
+ * plus any `registryAddresses` overrides passed to `ZamaSDKConfig`).
1588
+ *
1589
+ * Returns `undefined` when the chain ID hasn't been fetched yet
1590
+ * or when no registry is configured for the connected chain.
1591
+ *
1592
+ * The chain ID is cached for 30 seconds (`staleTime`), so chain
1593
+ * switches may take up to 30s to reflect.
1594
+ */
1595
+ declare function useWrappersRegistryAddress(): Address$1 | undefined;
1596
+ //#endregion
1597
+ //#region src/wrappers-registry/use-token-pairs-registry.d.ts
1598
+ /**
1599
+ * Fetches all token wrapper pairs from the ConfidentialTokenWrappersRegistry
1600
+ * contract on the current chain.
1601
+ */
1602
+ declare function useTokenPairsRegistry(): _tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair$1[], Error>;
1603
+ //#endregion
1604
+ //#region src/wrappers-registry/use-token-pairs-length.d.ts
1605
+ /**
1606
+ * Returns the total number of token wrapper pairs in the registry.
1607
+ */
1608
+ declare function useTokenPairsLength(): _tanstack_react_query0.UseQueryResult<bigint, Error>;
1609
+ //#endregion
1610
+ //#region src/wrappers-registry/use-token-pairs-slice.d.ts
1611
+ /**
1612
+ * Fetches a range of token wrapper pairs from the registry (paginated).
1613
+ *
1614
+ * @param fromIndex - Start index (inclusive). Pass `undefined` to disable.
1615
+ * @param toIndex - End index (exclusive). Pass `undefined` to disable.
1616
+ */
1617
+ declare function useTokenPairsSlice({
1618
+ fromIndex,
1619
+ toIndex
1620
+ }: {
1621
+ fromIndex: bigint | undefined;
1622
+ toIndex: bigint | undefined;
1623
+ }): _tanstack_react_query0.UseQueryResult<readonly TokenWrapperPair$1[], Error>;
1624
+ //#endregion
1625
+ //#region src/wrappers-registry/use-token-pair.d.ts
1626
+ /**
1627
+ * Fetches a single token wrapper pair by index from the registry.
1628
+ *
1629
+ * @param index - Zero-based pair index. Pass `undefined` to disable.
1630
+ */
1631
+ declare function useTokenPair({
1632
+ index
1633
+ }: {
1634
+ index: bigint | undefined;
1635
+ }): _tanstack_react_query0.UseQueryResult<TokenWrapperPair$1, Error>;
1636
+ //#endregion
1637
+ //#region src/wrappers-registry/use-confidential-token-address.d.ts
1638
+ /**
1639
+ * Looks up the confidential token address for a given plain token address.
1640
+ */
1641
+ declare function useConfidentialTokenAddress({
1642
+ tokenAddress
1643
+ }: {
1644
+ tokenAddress: Address$1 | undefined;
1645
+ }): _tanstack_react_query0.UseQueryResult<readonly [boolean, `0x${string}`], Error>;
1646
+ //#endregion
1647
+ //#region src/wrappers-registry/use-token-address.d.ts
1648
+ /**
1649
+ * Looks up the plain token address for a given confidential token address.
1650
+ */
1651
+ declare function useTokenAddress({
1652
+ confidentialTokenAddress
1653
+ }: {
1654
+ confidentialTokenAddress: Address$1 | undefined;
1655
+ }): _tanstack_react_query0.UseQueryResult<readonly [boolean, `0x${string}`], Error>;
1656
+ //#endregion
1657
+ //#region src/wrappers-registry/use-is-confidential-token-valid.d.ts
1658
+ /**
1659
+ * Checks whether a confidential token is registered and valid in the
1660
+ * on-chain wrappers registry.
1661
+ *
1662
+ * @param confidentialTokenAddress - The confidential token to check. Pass `undefined` to disable.
1663
+ */
1664
+ declare function useIsConfidentialTokenValid({
1665
+ confidentialTokenAddress
1666
+ }: {
1667
+ confidentialTokenAddress: Address$1 | undefined;
1668
+ }): _tanstack_react_query0.UseQueryResult<boolean, Error>;
1669
+ //#endregion
1670
+ //#region src/wrappers-registry/use-list-pairs.d.ts
1671
+ /**
1672
+ * Fetches paginated token wrapper pairs from the registry.
1673
+ *
1674
+ * @param options - Query options: `page` (1-indexed, default `1`), `pageSize` (default `100`), `metadata` (fetch on-chain metadata for both tokens, default `false`).
1675
+ *
1676
+ * @example
1677
+ * ```tsx
1678
+ * const { data, isLoading } = useListPairs({ page: 1, pageSize: 20 });
1679
+ * if (data) {
1680
+ * console.log(`${data.total} pairs, showing page ${data.page}`);
1681
+ * }
1682
+ * ```
1683
+ */
1684
+ declare function useListPairs({
1685
+ page,
1686
+ pageSize,
1687
+ metadata
1688
+ }?: {
1689
+ page?: number;
1690
+ pageSize?: number;
1691
+ metadata?: boolean;
1692
+ }): _tanstack_react_query0.UseQueryResult<PaginatedResult$1<TokenWrapperPair$1 | TokenWrapperPairWithMetadata$1>, Error>;
1693
+ //#endregion
1694
+ //#region src/balance/optimistic-balance-update.d.ts
1558
1695
  type OptimisticBalanceSnapshot = [QueryKey, bigint | undefined][];
1559
1696
  /** Combined context returned by optimistic `onMutate`. */
1560
1697
  interface OptimisticMutateContext {
@@ -1562,5 +1699,5 @@ interface OptimisticMutateContext {
1562
1699
  callerContext?: unknown;
1563
1700
  }
1564
1701
  //#endregion
1565
- export { type ActivityAmount, type ActivityDirection, type ActivityItem, type ActivityLogMetadata, type ActivityType, type Address, ApprovalFailedError, type ApproveSubmittedEvent, type ApproveUnderlyingParams, type ApproveUnderlyingSubmittedEvent, type BaseEvent, type BatchDecryptAsOptions, type BatchDecryptBalancesAsParams, type BatchDecryptOptions, type BatchTransferData, ChromeSessionStorage, type ClearValueType, type ConfidentialApproveParams, type ConfidentialBalancesData, type ConfidentialTransferEvent, type ConfidentialTransferFromParams, type ConfidentialTransferParams, type ContractAbi, type CreateDelegatedUserDecryptEIP712Params, type CreateEIP712Params, type CredentialsAllowedEvent, type CredentialsCachedEvent, type CredentialsCreatedEvent, type CredentialsCreatingEvent, type CredentialsExpiredEvent, type CredentialsLoadingEvent, CredentialsManager, type CredentialsManagerConfig, type CredentialsRevokedEvent, type DecryptBalanceAsParams, type UserDecryptCallbacks as DecryptCallbacks, type DecryptEndEvent, type DecryptErrorEvent, type DecryptHandle, type UserDecryptMutationParams as DecryptParams, type DecryptStartEvent, DecryptionFailedError, type DelegateDecryptionParams, DelegatedCredentialsManager, type DelegatedCredentialsManagerConfig, type DelegatedStoredCredentials, type DelegatedUserDecryptParams, type DelegationStatusData, type DelegationStatusQueryConfig, type EIP712TypedData, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, type EncryptEndEvent, type EncryptErrorEvent, type EncryptInput, type EncryptParams, type EncryptResult, type EncryptStartEvent, EncryptionFailedError, type FheTypeName, type FhevmInstanceConfig, type FinalizeUnwrapParams, type FinalizeUnwrapSubmittedEvent, type GenericSigner, type GenericStorage, type Handle, HardhatConfig, type Hex, IndexedDBStorage, type InputProofBytesType, InvalidKeypairError, KeypairExpiredError, type KeypairType, type KmsDelegatedUserDecryptEIP712Type, MainnetConfig, MemoryStorage, type NetworkType, NoCiphertextError, type OnChainEvent, type OptimisticBalanceSnapshot, type OptimisticMutateContext, type PublicDecryptResult, type PublicKeyData, type PublicParamsData, type RawLog, type ReadContractArgs, type ReadContractConfig, type ReadContractReturnType, type ReadFunctionName, ReadonlyToken, type ReadonlyTokenConfig, RelayerRequestFailedError, type RelayerSDK, type RelayerSDKStatus, RelayerWeb, type RelayerWebConfig, type RelayerWebSecurityConfig, type ResumeUnshieldParams, type RevokeDelegationParams, SepoliaConfig, type SessionExpiredEvent, type ShieldCallbacks, type ShieldETHParams, type ShieldParams, type ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, type StoredCredentials, TOKEN_TOPICS, Token, type TokenConfig, type TokenMetadata, Topics, type TransactionErrorEvent, type TransactionReceipt, type TransactionResult, TransactionRevertedError, type TransferCallbacks, type TransferFromSubmittedEvent, type TransferSubmittedEvent, type UnshieldAllParams, type UnshieldCallbacks, type UnshieldParams, type UnshieldPhase1SubmittedEvent, type UnshieldPhase2StartedEvent, type UnshieldPhase2SubmittedEvent, type UnwrapParams, type UnwrapRequestedEvent, type UnwrapSubmittedEvent, type UnwrappedFinalizedEvent, type UnwrappedStartedEvent, type UseActivityFeedConfig, type UseConfidentialBalanceConfig, type UseConfidentialBalanceOptions, type UseConfidentialBalancesConfig, type UseConfidentialBalancesOptions, type UseConfidentialIsApprovedConfig, type UseConfidentialIsApprovedSuspenseConfig, type UseConfidentialTransferConfig, type UseDelegationStatusConfig, type UseFeeConfig, type UseShieldConfig, type UseShieldETHConfig, type UseUnderlyingAllowanceConfig, type UseUserDecryptConfig, type UseWrapperDiscoveryConfig, type UseWrapperDiscoverySuspenseConfig, type UseZamaConfig, type UserDecryptCallbacks$1 as UserDecryptCallbacks, type UserDecryptMutationParams$1 as UserDecryptMutationParams, type UserDecryptParams, type WrappedEvent, type WriteContractArgs, type WriteContractConfig, type WriteFunctionName, ZERO_HANDLE, type ZKProofLike, ZamaError, ZamaErrorCode, ZamaProvider, type ZamaProviderProps, ZamaSDK, type ZamaSDKConfig, type ZamaSDKEvent, type ZamaSDKEventInput, type ZamaSDKEventListener, type ZamaSDKEventType, ZamaSDKEvents, activityFeedQueryOptions, allowMutationOptions, allowanceContract, applyDecryptedValues, approveContract, approveUnderlyingMutationOptions, balanceOfContract, batchDecryptBalancesAsMutationOptions, batchTransferFeeQueryOptions, chromeSessionStorage, clearPendingUnshield, confidentialApproveMutationOptions, confidentialBalanceOfContract, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialBatchTransferContract, confidentialHandleQueryOptions, confidentialHandlesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, createDelegatedUserDecryptEIP712MutationOptions, createEIP712MutationOptions, decimalsContract, decodeConfidentialTransfer, decodeOnChainEvent, decodeOnChainEvents, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, decryptBalanceAsMutationOptions, delegateDecryptionMutationOptions, delegatedUserDecryptMutationOptions, delegationStatusQueryOptions, deploymentCoordinatorContract, encryptMutationOptions, extractEncryptedHandles, feeRecipientQueryOptions, filterQueryOptions, finalizeUnwrapContract, finalizeUnwrapMutationOptions, findUnwrapRequested, findWrapped, generateKeypairMutationOptions, getBatchTransferFeeContract, getFeeRecipientContract, getUnwrapFeeContract, getWrapFeeContract, getWrapperContract, hashFn, indexedDBStorage, isAllowedQueryOptions, isConfidentialQueryOptions, isConfidentialTokenContract, isConfidentialWrapperContract, isFinalizeUnwrapOperatorContract, isOperatorContract, isWrapperQueryOptions, loadPendingUnshield, matchZamaError, memoryStorage, nameContract, parseActivityFeed, publicDecryptMutationOptions, publicKeyQueryOptions, publicParamsQueryOptions, rateContract, requestZKProofVerificationMutationOptions, resumeUnshieldMutationOptions, revokeDelegationMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, shieldETHMutationOptions, shieldFeeQueryOptions, shieldMutationOptions, signerAddressQueryOptions, sortByBlockNumber, supportsInterfaceContract, symbolContract, tokenMetadataQueryOptions, totalSupplyContract, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, underlyingContract, unshieldAllMutationOptions, unshieldFeeQueryOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapContract, unwrapFromBalanceContract, unwrapMutationOptions, useActivityFeed, useAllow, useApproveUnderlying, useBatchDecryptBalancesAs, useBatchTransferFee, useConfidentialApprove, useConfidentialBalance, useConfidentialBalances, useConfidentialIsApproved, useConfidentialIsApprovedSuspense, useConfidentialTransfer, useConfidentialTransferFrom, useCreateDelegatedUserDecryptEIP712, useCreateEIP712, useDecryptBalanceAs, useDelegateDecryption, useDelegatedUserDecrypt, useDelegationStatus, useEncrypt, useFeeRecipient, useFinalizeUnwrap, useGenerateKeypair, useIsAllowed, useIsConfidential, useIsConfidentialSuspense, useIsWrapper, useIsWrapperSuspense, useMetadata, useMetadataSuspense, usePublicDecrypt, usePublicKey, usePublicParams, useReadonlyToken, useRequestZKProofVerification, useResumeUnshield, useRevoke, useRevokeDelegation, useRevokeSession, useShield, useShieldETH, useShieldFee, useToken, useTotalSupply, useTotalSupplySuspense, useUnderlyingAllowance, useUnderlyingAllowanceSuspense, useUnshield, useUnshieldAll, useUnshieldFee, useUnwrap, useUnwrapAll, useUserDecrypt, useUserDecryptedValue, useUserDecryptedValues, useWrapperDiscovery, useWrapperDiscoverySuspense, useZamaSDK, userDecryptMutationOptions, wrapContract, wrapETHContract, wrapperDiscoveryQueryOptions, wrapperExistsContract, zamaQueryKeys };
1702
+ export { type ActivityAmount, type ActivityDirection, type ActivityItem, type ActivityLogMetadata, type ActivityType, type Address, ApprovalFailedError, type ApproveSubmittedEvent, type ApproveUnderlyingParams, type ApproveUnderlyingSubmittedEvent, type BaseEvent, type BatchDecryptAsOptions, type BatchDecryptBalancesAsParams, type BatchDecryptOptions, type BatchTransferData, ChromeSessionStorage, type ClearValueType, type ConfidentialApproveParams, type ConfidentialBalancesData, type ConfidentialTransferEvent, type ConfidentialTransferFromParams, type ConfidentialTransferParams, ConfigurationError, type ContractAbi, type CreateDelegatedUserDecryptEIP712Params, type CreateEIP712Params, type CredentialsAllowedEvent, type CredentialsCachedEvent, type CredentialsCreatedEvent, type CredentialsCreatingEvent, type CredentialsExpiredEvent, type CredentialsLoadingEvent, CredentialsManager, type CredentialsManagerConfig, type CredentialsRevokedEvent, type DecryptBalanceAsParams, type UserDecryptCallbacks as DecryptCallbacks, type DecryptEndEvent, type DecryptErrorEvent, type DecryptHandle, type UserDecryptMutationParams as DecryptParams, type DecryptStartEvent, DecryptionFailedError, DefaultRegistryAddresses, type DelegateDecryptionParams, DelegatedCredentialsManager, type DelegatedCredentialsManagerConfig, type DelegatedStoredCredentials, type DelegatedUserDecryptParams, type DelegationStatusData, type DelegationStatusQueryConfig, type EIP712TypedData, ERC7984_INTERFACE_ID, ERC7984_WRAPPER_INTERFACE_ID, type EncryptEndEvent, type EncryptErrorEvent, type EncryptInput, type EncryptParams, type EncryptResult, type EncryptStartEvent, EncryptionFailedError, type FheTypeName, type FhevmInstanceConfig, type FinalizeUnwrapParams, type FinalizeUnwrapSubmittedEvent, type GenericSigner, type GenericStorage, type Handle, HardhatConfig, type Hex, IndexedDBStorage, type InputProofBytesType, InvalidKeypairError, KeypairExpiredError, type KeypairType, type KmsDelegatedUserDecryptEIP712Type, type ListPairsOptions, type ListPairsQueryConfig, MainnetConfig, MemoryStorage, type NetworkType, NoCiphertextError, type OnChainEvent, type OptimisticBalanceSnapshot, type OptimisticMutateContext, type PaginatedResult, type PublicDecryptResult, type PublicKeyData, type PublicParamsData, type RawLog, type ReadContractArgs, type ReadContractConfig, type ReadContractReturnType, type ReadFunctionName, ReadonlyToken, type ReadonlyTokenConfig, RelayerRequestFailedError, type RelayerSDK, type RelayerSDKStatus, RelayerWeb, type RelayerWebConfig, type RelayerWebSecurityConfig, type ResumeUnshieldParams, type RevokeDelegationParams, SepoliaConfig, type SessionExpiredEvent, type ShieldCallbacks, type ShieldETHParams, type ShieldParams, type ShieldSubmittedEvent, SigningFailedError, SigningRejectedError, type StoredCredentials, TOKEN_TOPICS, Token, type TokenConfig, type TokenMetadata, type TokenWrapperPair, type TokenWrapperPairWithMetadata, Topics, type TransactionErrorEvent, type TransactionReceipt, type TransactionResult, TransactionRevertedError, type TransferCallbacks, type TransferFromSubmittedEvent, type TransferSubmittedEvent, type UnshieldAllParams, type UnshieldCallbacks, type UnshieldParams, type UnshieldPhase1SubmittedEvent, type UnshieldPhase2StartedEvent, type UnshieldPhase2SubmittedEvent, type UnwrapParams, type UnwrapRequestedEvent, type UnwrapSubmittedEvent, type UnwrappedFinalizedEvent, type UnwrappedStartedEvent, type UseActivityFeedConfig, type UseConfidentialBalanceConfig, type UseConfidentialBalanceOptions, type UseConfidentialBalancesConfig, type UseConfidentialBalancesOptions, type UseConfidentialIsApprovedConfig, type UseConfidentialIsApprovedSuspenseConfig, type UseConfidentialTransferConfig, type UseDelegationStatusConfig, type UseFeeConfig, type UseShieldConfig, type UseShieldETHConfig, type UseUnderlyingAllowanceConfig, type UseUserDecryptConfig, type UseWrapperDiscoveryConfig, type UseWrapperDiscoverySuspenseConfig, type UseZamaConfig, type UserDecryptCallbacks$1 as UserDecryptCallbacks, type UserDecryptMutationParams$1 as UserDecryptMutationParams, type UserDecryptParams, type WrappedEvent, WrappersRegistry, type WrappersRegistryConfig, type WriteContractArgs, type WriteContractConfig, type WriteFunctionName, ZERO_HANDLE, type ZKProofLike, ZamaError, ZamaErrorCode, ZamaProvider, type ZamaProviderProps, ZamaSDK, type ZamaSDKConfig, type ZamaSDKEvent, type ZamaSDKEventInput, type ZamaSDKEventListener, type ZamaSDKEventType, ZamaSDKEvents, activityFeedQueryOptions, allowMutationOptions, allowanceContract, applyDecryptedValues, approveContract, approveUnderlyingMutationOptions, balanceOfContract, batchDecryptBalancesAsMutationOptions, batchTransferFeeQueryOptions, chromeSessionStorage, clearPendingUnshield, confidentialApproveMutationOptions, confidentialBalanceOfContract, confidentialBalanceQueryOptions, confidentialBalancesQueryOptions, confidentialBatchTransferContract, confidentialHandleQueryOptions, confidentialHandlesQueryOptions, confidentialIsApprovedQueryOptions, confidentialTotalSupplyContract, confidentialTransferContract, confidentialTransferFromContract, confidentialTransferFromMutationOptions, confidentialTransferMutationOptions, createDelegatedUserDecryptEIP712MutationOptions, createEIP712MutationOptions, decimalsContract, decodeConfidentialTransfer, decodeOnChainEvent, decodeOnChainEvents, decodeUnwrapRequested, decodeUnwrappedFinalized, decodeUnwrappedStarted, decodeWrapped, decryptBalanceAsMutationOptions, delegateDecryptionMutationOptions, delegatedUserDecryptMutationOptions, delegationStatusQueryOptions, deploymentCoordinatorContract, encryptMutationOptions, extractEncryptedHandles, feeRecipientQueryOptions, filterQueryOptions, finalizeUnwrapContract, finalizeUnwrapMutationOptions, findUnwrapRequested, findWrapped, generateKeypairMutationOptions, getBatchTransferFeeContract, getFeeRecipientContract, getUnwrapFeeContract, getWrapFeeContract, getWrapperContract, hashFn, indexedDBStorage, isAllowedQueryOptions, isConfidentialQueryOptions, isConfidentialTokenContract, isConfidentialWrapperContract, isFinalizeUnwrapOperatorContract, isOperatorContract, isWrapperQueryOptions, listPairsQueryOptions, loadPendingUnshield, matchZamaError, memoryStorage, nameContract, parseActivityFeed, publicDecryptMutationOptions, publicKeyQueryOptions, publicParamsQueryOptions, rateContract, requestZKProofVerificationMutationOptions, resumeUnshieldMutationOptions, revokeDelegationMutationOptions, revokeMutationOptions, revokeSessionMutationOptions, savePendingUnshield, setFinalizeUnwrapOperatorContract, setOperatorContract, shieldETHMutationOptions, shieldFeeQueryOptions, shieldMutationOptions, signerAddressQueryOptions, sortByBlockNumber, supportsInterfaceContract, symbolContract, tokenMetadataQueryOptions, totalSupplyContract, totalSupplyQueryOptions, underlyingAllowanceQueryOptions, underlyingContract, unshieldAllMutationOptions, unshieldFeeQueryOptions, unshieldMutationOptions, unwrapAllMutationOptions, unwrapContract, unwrapFromBalanceContract, unwrapMutationOptions, useActivityFeed, useAllow, useApproveUnderlying, useBatchDecryptBalancesAs, useBatchTransferFee, useConfidentialApprove, useConfidentialBalance, useConfidentialBalances, useConfidentialIsApproved, useConfidentialIsApprovedSuspense, useConfidentialTokenAddress, useConfidentialTransfer, useConfidentialTransferFrom, useCreateDelegatedUserDecryptEIP712, useCreateEIP712, useDecryptBalanceAs, useDelegateDecryption, useDelegatedUserDecrypt, useDelegationStatus, useEncrypt, useFeeRecipient, useFinalizeUnwrap, useGenerateKeypair, useIsAllowed, useIsConfidential, useIsConfidentialSuspense, useIsConfidentialTokenValid, useIsWrapper, useIsWrapperSuspense, useListPairs, useMetadata, useMetadataSuspense, usePublicDecrypt, usePublicKey, usePublicParams, useReadonlyToken, useRequestZKProofVerification, useResumeUnshield, useRevoke, useRevokeDelegation, useRevokeSession, useShield, useShieldETH, useShieldFee, useToken, useTokenAddress, useTokenPair, useTokenPairsLength, useTokenPairsRegistry, useTokenPairsSlice, useTotalSupply, useTotalSupplySuspense, useUnderlyingAllowance, useUnderlyingAllowanceSuspense, useUnshield, useUnshieldAll, useUnshieldFee, useUnwrap, useUnwrapAll, useUserDecrypt, useUserDecryptedValue, useUserDecryptedValues, useWrapperDiscovery, useWrapperDiscoverySuspense, useWrappersRegistryAddress, useZamaSDK, userDecryptMutationOptions, wrapContract, wrapETHContract, wrapperDiscoveryQueryOptions, wrapperExistsContract, zamaQueryKeys };
1566
1703
  //# sourceMappingURL=index.d.ts.map