@tokenops/sdk 1.1.1 → 1.5.1

package/dist/fhe-vesting/react/index.d.cts

@@ -65,6 +65,7 @@ export { useAllRecipients } from "./useAllRecipients.js";
 export { useAllRecipientsLength } from "./useAllRecipientsLength.js";
 export { useAllRecipientsSliced, type UseAllRecipientsSlicedArgs, } from "./useAllRecipientsSliced.js";
 export { useIsRecipient, type UseIsRecipientArgs } from "./useIsRecipient.js";
+export { usePreflightCreateVesting, type UsePreflightCreateVestingArgs, } from "./usePreflightCreateVesting.js";
 export { useRecipientVestings, type UseRecipientVestingsArgs } from "./useRecipientVestings.js";
 export { useRecipientVestingsLength, type UseRecipientVestingsLengthArgs, } from "./useRecipientVestingsLength.js";
 export { useRecipientVestingsSliced, type UseRecipientVestingsSlicedArgs, } from "./useRecipientVestingsSliced.js";
@@ -114,10 +115,10 @@ export { useRevokeRole, type UseRevokeRoleArgs } from "./useRevokeRole.js";
 export { useRenounceRole, type UseRenounceRoleArgs } from "./useRenounceRole.js";
 export type { BaseHookOptions, ManagerHookOptions } from "./_shared.js";
 export { encryptUint64, encryptUint64Batch, resolveEncryptor, type Encryptor, type EncryptorSource, type EncryptUint64Args, type EncryptUint64BatchArgs, type FheValueInput, } from "../encryption.js";
-export { DisclosureType, FeeType, type CustomFee, type EncryptedInput, type EncryptedInputs, type PendingTransfer, type VestingInfo, type VestingParams, } from "../types.js";
+export { DisclosureType, FeeType, type CreateVestingPreflightReport, type CustomFee, type EncryptedInput, type EncryptedInputs, type PendingTransfer, type VestingInfo, type VestingParams, } from "../types.js";
 export type { BatchCreateVestingArgs, ClaimArgs, CreateVestingArgs, DiscloseArgs, EncryptedViewResult, InitiateTransferArgs, PartialClaimArgs, SplitVestingArgs, } from "../manager.js";
 export type { CreateManagerResult, CreateManagerArgs, PredictManagerArgs } from "../factory.js";
 export { scaleRatio, type ScaleRatioArgs, type ScaledRatio } from "../../fhe/scale-ratio.js";
-export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ContractRevertError, PausedError, AccessDeniedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../../core/errors.js";
+export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ContractRevertError, PausedError, AccessDeniedError, OperatorNotApprovedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../../core/errors.js";
 export { type PreflightResult } from "../../core/preflight.js";
 export { VestingNotFoundError, NotVestingRecipientError, ClaimLockedError, VestingRevokedError, VestingNotRevocableError, VestingExpiredError, TransferAlreadyPendingError, NoPendingTransferError, NotPendingRecipientError, TransferExpiredError, } from "../errors.js";

package/dist/fhe-vesting/react/index.d.ts

@@ -65,6 +65,7 @@ export { useAllRecipients } from "./useAllRecipients.js";
 export { useAllRecipientsLength } from "./useAllRecipientsLength.js";
 export { useAllRecipientsSliced, type UseAllRecipientsSlicedArgs, } from "./useAllRecipientsSliced.js";
 export { useIsRecipient, type UseIsRecipientArgs } from "./useIsRecipient.js";
+export { usePreflightCreateVesting, type UsePreflightCreateVestingArgs, } from "./usePreflightCreateVesting.js";
 export { useRecipientVestings, type UseRecipientVestingsArgs } from "./useRecipientVestings.js";
 export { useRecipientVestingsLength, type UseRecipientVestingsLengthArgs, } from "./useRecipientVestingsLength.js";
 export { useRecipientVestingsSliced, type UseRecipientVestingsSlicedArgs, } from "./useRecipientVestingsSliced.js";
@@ -114,10 +115,10 @@ export { useRevokeRole, type UseRevokeRoleArgs } from "./useRevokeRole.js";
 export { useRenounceRole, type UseRenounceRoleArgs } from "./useRenounceRole.js";
 export type { BaseHookOptions, ManagerHookOptions } from "./_shared.js";
 export { encryptUint64, encryptUint64Batch, resolveEncryptor, type Encryptor, type EncryptorSource, type EncryptUint64Args, type EncryptUint64BatchArgs, type FheValueInput, } from "../encryption.js";
-export { DisclosureType, FeeType, type CustomFee, type EncryptedInput, type EncryptedInputs, type PendingTransfer, type VestingInfo, type VestingParams, } from "../types.js";
+export { DisclosureType, FeeType, type CreateVestingPreflightReport, type CustomFee, type EncryptedInput, type EncryptedInputs, type PendingTransfer, type VestingInfo, type VestingParams, } from "../types.js";
 export type { BatchCreateVestingArgs, ClaimArgs, CreateVestingArgs, DiscloseArgs, EncryptedViewResult, InitiateTransferArgs, PartialClaimArgs, SplitVestingArgs, } from "../manager.js";
 export type { CreateManagerResult, CreateManagerArgs, PredictManagerArgs } from "../factory.js";
 export { scaleRatio, type ScaleRatioArgs, type ScaledRatio } from "../../fhe/scale-ratio.js";
-export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ContractRevertError, PausedError, AccessDeniedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../../core/errors.js";
+export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ContractRevertError, PausedError, AccessDeniedError, OperatorNotApprovedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../../core/errors.js";
 export { type PreflightResult } from "../../core/preflight.js";
 export { VestingNotFoundError, NotVestingRecipientError, ClaimLockedError, VestingRevokedError, VestingNotRevocableError, VestingExpiredError, TransferAlreadyPendingError, NoPendingTransferError, NotPendingRecipientError, TransferExpiredError, } from "../errors.js";

package/dist/fhe-vesting/react/index.js

@@ -1,16 +1,17 @@
-import { useMemoFactoryClient, buildQueryKey, useMemoManagerClient } from '../../chunk-3PQ2RFPC.js';
-export { ClaimLockedError, NoPendingTransferError, NotPendingRecipientError, NotVestingRecipientError, TransferAlreadyPendingError, TransferExpiredError, VestingExpiredError, VestingNotFoundError, VestingNotRevocableError, VestingRevokedError, encryptUint64, encryptUint64Batch, resolveEncryptor } from '../../chunk-X56UVEXS.js';
-import '../../chunk-ZXCOJY2Z.js';
-export { scaleRatio } from '../../chunk-XSNLAS5M.js';
-import '../../chunk-FYQ2UW4T.js';
-export { DisclosureType, FeeType } from '../../chunk-IR5AK5U5.js';
-import '../../chunk-JFLEEXKP.js';
-import '../../chunk-M7V2EDPB.js';
-import '../../chunk-BE2AIZ3K.js';
+import { useMemoFactoryClient, buildQueryKey, useMemoManagerClient } from '../../chunk-NTZY6IB7.js';
+export { ClaimLockedError, NoPendingTransferError, NotPendingRecipientError, NotVestingRecipientError, TransferAlreadyPendingError, TransferExpiredError, VestingExpiredError, VestingNotFoundError, VestingNotRevocableError, VestingRevokedError, encryptUint64, encryptUint64Batch, resolveEncryptor } from '../../chunk-IXLO7GO5.js';
+import '../../chunk-WMACINXO.js';
+export { scaleRatio } from '../../chunk-AOP6HMPW.js';
+import '../../chunk-ZWXJTBZO.js';
+import '../../chunk-7VELUOMI.js';
+export { DisclosureType, FeeType } from '../../chunk-OXTLPTO3.js';
+import '../../chunk-SG65XWH7.js';
+import '../../chunk-XGGTQQFH.js';
+import '../../chunk-ZA673I3O.js';
 import '../../chunk-Q2GP5UDC.js';
 import '../../chunk-KWFFIJYX.js';
-import { MissingClientError } from '../../chunk-IVE3QEGD.js';
-export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsSdkError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError } from '../../chunk-IVE3QEGD.js';
+import { MissingClientError } from '../../chunk-QBJ7O2B4.js';
+export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, OperatorNotApprovedError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsSdkError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError } from '../../chunk-QBJ7O2B4.js';
 import { useQuery, useMutation } from '@tanstack/react-query';
 
 function useConfidentialVestingFactoryImplementation(options = {}) {
@@ -327,6 +328,22 @@ function useIsRecipient(args) {
     staleTime: 0
   });
 }
+function usePreflightCreateVesting(args) {
+  const { params, creator, ...base } = args;
+  const { client, chainId } = useMemoManagerClient(base);
+  return useQuery({
+    queryKey: buildQueryKey(
+      "manager:preflightCreateVesting",
+      chainId,
+      base.address,
+      creator,
+      params
+    ),
+    queryFn: () => client.preflightCreateVesting({ params, creator }),
+    enabled: !!client && !!params && !!creator,
+    staleTime: 0
+  });
+}
 function useRecipientVestings(args) {
   const { recipient, ...base } = args;
   const { client, chainId } = useMemoManagerClient(base);
@@ -768,4 +785,4 @@ function useRenounceRole(options) {
   });
 }
 
-export { useAcceptVestingTransfer, useAdminBatchDiscloseToParty, useAdminClaim, useAdminDiscloseToParty, useAdminGetClaimableAmount, useAdminGetSettledAmount, useAdminGetTokenBalance, useAdminGetTotalAllocation, useAdminGetVestedAmount, useAdminPartialClaim, useAllRecipients, useAllRecipientsLength, useAllRecipientsSliced, useBatchCreateVesting, useBatchDiscloseHandlesToParty, useBatchDiscloseToParty, useBatchRevokeVesting, useCancelVestingTransfer, useClaim, useConfidentialVestingFactoryImplementation, useCreateManager, useCreateManagerAndGetAddress, useCreateVesting, useDirectVestingTransfer, useDisableCustomFee, useDiscloseHandleToParty, useDiscloseToParty, useFactoryCustomFee, useFactoryDefaultFeeType, useFactoryDefaultGasFee, useFactoryDefaultTokenFee, useFactoryFeeCollector, useFactoryInitCodeHash, useGetClaimableAmount, useGetSettledAmount, useGetTotalAllocation, useGetVestedAmount, useGrantRole, useHasRole, useInitiateVestingTransfer, useIsRecipient, useManagerDeploymentBlockNumber, useManagerFee, useManagerFeeInfo, useManagerFeeType, useManagerIsPausable, useManagerIsSplitEnabled, useManagerMaxBatchSize, useManagerMaxRevokeBatchSize, useManagerPaused, useManagerToken, usePartialClaim, usePause, usePendingVestingTransfer, useRecipientVestings, useRecipientVestingsLength, useRecipientVestingsSliced, useRenounceRole, useResetGasFee, useResetTokenFee, useRevokeRole, useRevokeVesting, useRoleConstants, useSetCustomFee, useSetDefaultFeeType, useSetDefaultGasFee, useSetDefaultTokenFee, useSetFeeCollector, useSetMaxBatchSize, useSetMaxRevokeBatchSize, useSplitVesting, useTransferFeeCollectorRole, useUnpause, useVestingInfo, useWithdrawAdmin, useWithdrawGasFee, useWithdrawOtherConfidentialToken, useWithdrawOtherToken, useWithdrawTokenFee };
+export { useAcceptVestingTransfer, useAdminBatchDiscloseToParty, useAdminClaim, useAdminDiscloseToParty, useAdminGetClaimableAmount, useAdminGetSettledAmount, useAdminGetTokenBalance, useAdminGetTotalAllocation, useAdminGetVestedAmount, useAdminPartialClaim, useAllRecipients, useAllRecipientsLength, useAllRecipientsSliced, useBatchCreateVesting, useBatchDiscloseHandlesToParty, useBatchDiscloseToParty, useBatchRevokeVesting, useCancelVestingTransfer, useClaim, useConfidentialVestingFactoryImplementation, useCreateManager, useCreateManagerAndGetAddress, useCreateVesting, useDirectVestingTransfer, useDisableCustomFee, useDiscloseHandleToParty, useDiscloseToParty, useFactoryCustomFee, useFactoryDefaultFeeType, useFactoryDefaultGasFee, useFactoryDefaultTokenFee, useFactoryFeeCollector, useFactoryInitCodeHash, useGetClaimableAmount, useGetSettledAmount, useGetTotalAllocation, useGetVestedAmount, useGrantRole, useHasRole, useInitiateVestingTransfer, useIsRecipient, useManagerDeploymentBlockNumber, useManagerFee, useManagerFeeInfo, useManagerFeeType, useManagerIsPausable, useManagerIsSplitEnabled, useManagerMaxBatchSize, useManagerMaxRevokeBatchSize, useManagerPaused, useManagerToken, usePartialClaim, usePause, usePendingVestingTransfer, usePreflightCreateVesting, useRecipientVestings, useRecipientVestingsLength, useRecipientVestingsSliced, useRenounceRole, useResetGasFee, useResetTokenFee, useRevokeRole, useRevokeVesting, useRoleConstants, useSetCustomFee, useSetDefaultFeeType, useSetDefaultGasFee, useSetDefaultTokenFee, useSetFeeCollector, useSetMaxBatchSize, useSetMaxRevokeBatchSize, useSplitVesting, useTransferFeeCollectorRole, useUnpause, useVestingInfo, useWithdrawAdmin, useWithdrawGasFee, useWithdrawOtherConfidentialToken, useWithdrawOtherToken, useWithdrawTokenFee };

package/dist/fhe-vesting/react/useAdminClaim.d.ts

@@ -5,5 +5,7 @@ import { type ManagerHookOptions } from "./_shared.js";
 /**
  * Admin variant of {@link useClaim} — caller must hold `CLAIMER_ROLE`. Useful
  * for sweep / forced-claim flows initiated by a treasury.
+ *
+ * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
  */
 export declare function useAdminClaim(options: ManagerHookOptions): UseMutationResult<Hex, Error, ClaimArgs>;

package/dist/fhe-vesting/react/useAdminPartialClaim.d.ts

@@ -4,5 +4,7 @@ import type { PartialClaimArgs } from "../manager.js";
 import { type ManagerHookOptions } from "./_shared.js";
 /**
  * Admin variant of {@link usePartialClaim} — caller must hold `CLAIMER_ROLE`.
+ *
+ * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
  */
 export declare function useAdminPartialClaim(options: ManagerHookOptions): UseMutationResult<Hex, Error, PartialClaimArgs>;

package/dist/fhe-vesting/react/useBatchCreateVesting.d.ts

@@ -9,6 +9,14 @@ import { type ManagerHookOptions } from "./_shared.js";
  *
  * Respect `useManagerMaxBatchSize` before submitting large lists.
  *
+ * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
+ *
+ * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
+ * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
+ * ERC-20. Amount parameters are base units of the token's actual decimals:
+ * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
+ * transparent TTT test token uses 18 decimals.
+ *
  * After success, invalidate `["tokenops-sdk", "fhe-vesting"]` (broad) or the
  * narrower recipient/vesting query keys.
  *

package/dist/fhe-vesting/react/useClaim.d.ts

@@ -12,6 +12,8 @@ import { type ManagerHookOptions } from "./_shared.js";
  * After success, invalidate `useGetClaimableAmount` (the encrypted view) and
  * any UI counts you computed off it.
  *
+ * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
+ *
  * @example
  * const claim = useClaim({ address: managerAddress });
  * claim.mutate({ vestingId, value: gasFee });

package/dist/fhe-vesting/react/useCreateVesting.d.ts

@@ -7,12 +7,20 @@ import { type ManagerHookOptions } from "./_shared.js";
  * plaintext `amount` into an `externalEuint64` and submits it with an input
  * proof — callers never handle ciphertext.
  *
+ * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
+ * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
+ * ERC-20. Amount parameters are base units of the token's actual decimals:
+ * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
+ * transparent TTT test token uses 18 decimals.
+ *
  * **Encryptor resolution.** The hook-level `encryptor` (from
  * `ManagerHookOptions`) is forwarded lazily to the SDK client. You can also
  * pass `encryptor` per-mutation via `args.encryptor` to override it. If
  * neither is present, the SDK throws `Missing encryptor — pass encryptor…`
  * verbatim.
  *
+ * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
+ *
  * After a successful create, invalidate read queries that depend on
  * recipient/vesting state:
  *

package/dist/fhe-vesting/react/useManagerWithdrawTokenFee.d.ts

@@ -7,5 +7,11 @@ import { type ManagerHookOptions } from "./_shared.js";
  * (`FeeType.DistributionToken` managers). Pass `encryptor` (SDK encrypts
  * `amount`) XOR `encryptedInput` (pre-built) — discriminated union enforced
  * by TS. Caller must hold `FEE_COLLECTOR_ROLE`.
+ *
+ * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
+ * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
+ * ERC-20. Amount parameters are base units of the token's actual decimals:
+ * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
+ * transparent TTT test token uses 18 decimals.
  */
 export declare function useManagerWithdrawTokenFee(options: ManagerHookOptions): UseMutationResult<TxHash, Error, WithdrawTokenFeeArgs>;

package/dist/fhe-vesting/react/usePartialClaim.d.ts

@@ -6,8 +6,16 @@ import { type ManagerHookOptions } from "./_shared.js";
  * Partial-claim a specific encrypted amount from a vesting. The SDK encrypts
  * the plaintext `amount` (or use `args.encryptedInput` to bypass).
  *
+ * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
+ * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
+ * ERC-20. Amount parameters are base units of the token's actual decimals:
+ * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
+ * transparent TTT test token uses 18 decimals.
+ *
  * After success, invalidate `useGetClaimableAmount` and `useGetSettledAmount`.
  *
+ * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
+ *
  * @example
  * const partial = usePartialClaim({ address: managerAddress, encryptor: () => useZamaSDK() });
  * partial.mutate({ vestingId, amount: 50_000n, value: gasFee });

package/dist/fhe-vesting/react/usePreflightCreateVesting.d.ts

@@ -0,0 +1,37 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { Address } from "viem";
+import type { CreateVestingPreflightReport, VestingParams } from "../types.js";
+import { type ManagerHookOptions } from "./_shared.js";
+export interface UsePreflightCreateVestingArgs extends ManagerHookOptions {
+    /** The vesting schedule parameters to validate. */
+    params?: VestingParams;
+    /** The address that will send the create transaction. */
+    creator?: Address;
+}
+/**
+ * Read-only preflight for `useCreateVesting` / `useBatchCreateVesting` —
+ * wraps {@link ConfidentialVestingManagerClient.preflightCreateVesting} as a
+ * TanStack query.
+ *
+ * The report carries `token`, `hasCreatorRole`, `isOperatorSet`, `ready`,
+ * `blockers` (human-readable strings) and `blockerErrors` (typed
+ * `TokenOpsSdkError`s, index-aligned with `blockers` — branch on
+ * `error.code`).
+ *
+ * Checks: structural `params` validation, `VESTING_CREATOR_ROLE` membership,
+ * and ERC-7984 operator approval of the manager on the distribution token.
+ * The creator's confidential token balance is NOT checked (encrypted; an
+ * underfunded create silently zeroes amounts instead of reverting) — see the
+ * headless method's TSDoc.
+ *
+ * Hook is disabled until `params` and `creator` are both set. Refetch after
+ * the user grants the role or calls `setOperator` (e.g. via
+ * `queryClient.invalidateQueries` or a `refetchInterval`).
+ *
+ * @example
+ * const { data: report } = usePreflightCreateVesting({
+ *   address: managerAddress, params, creator,
+ * });
+ * if (report?.ready) { /* enable submit *\/ }
+ */
+export declare function usePreflightCreateVesting(args: UsePreflightCreateVestingArgs): UseQueryResult<CreateVestingPreflightReport, Error>;

package/dist/fhe-vesting/react/useVestingClaim.d.ts

@@ -12,6 +12,8 @@ import { type ManagerHookOptions } from "./_shared.js";
  * After success, invalidate `useAccessClaimableAmount` (the encrypted view) and
  * any UI counts you computed off it.
  *
+ * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
+ *
  * @example
  * const claim = useVestingClaim({ address: managerAddress });
  * claim.mutate({ vestingId, value: gasFee });

package/dist/fhe-vesting/react/useWithdrawAdmin.d.ts

@@ -13,5 +13,11 @@ export interface UseWithdrawAdminArgs {
  * Admin: withdraw an encrypted amount of the manager's distribution token to
  * `msg.sender`. Caller must hold `WITHDRAWER_ROLE`. The SDK encrypts `amount`
  * (or pass `encryptedInput` to bypass).
+ *
+ * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
+ * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
+ * ERC-20. Amount parameters are base units of the token's actual decimals:
+ * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
+ * transparent TTT test token uses 18 decimals.
  */
 export declare function useWithdrawAdmin(options: ManagerHookOptions): UseMutationResult<Hex, Error, UseWithdrawAdminArgs>;

package/dist/fhe-vesting/react/useWithdrawTokenFee.d.ts

@@ -14,5 +14,11 @@ export interface UseWithdrawTokenFeeArgs {
  * Fee collector: withdraw collected distribution-token fees
  * (`FeeType.DistributionToken` managers). SDK encrypts `amount` (or pass
  * `encryptedInput`). Caller must hold `FEE_COLLECTOR_ROLE`.
+ *
+ * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
+ * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
+ * ERC-20. Amount parameters are base units of the token's actual decimals:
+ * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
+ * transparent TTT test token uses 18 decimals.
  */
 export declare function useWithdrawTokenFee(options: ManagerHookOptions): UseMutationResult<Hex, Error, UseWithdrawTokenFeeArgs>;

package/dist/fhe-vesting/types.d.ts

@@ -1,4 +1,5 @@
 import type { Address } from "viem";
+import type { TokenOpsSdkError } from "../core/errors.js";
 export type { EncryptedInput, EncryptedInputs, EncryptedViewResult } from "../fhe/types.js";
 /**
  * Plaintext mirror of `IConfidentialVestingManagerTypes.VestingParams`. Field
@@ -68,3 +69,36 @@ export interface PendingTransfer {
     initiatedAt: number;
     expiresAt: number;
 }
+/**
+ * Report returned by `ConfidentialVestingManagerClient.preflightCreateVesting`.
+ *
+ * Fields:
+ * - `token` — the ERC-7984 distribution token this manager clone is bound to.
+ * - `hasCreatorRole` — `true` when the creator holds `VESTING_CREATOR_ROLE` on
+ *   the manager.
+ * - `isOperatorSet` — `true` when the creator has approved the manager as an
+ *   ERC-7984 operator on `token` (required for the manager's
+ *   `confidentialTransferFrom` pull).
+ * - `ready` — `true` when no blockers were detected.
+ * - `blockers` — human-readable blocker descriptions. Empty when
+ *   `ready === true`.
+ * - `blockerErrors` — the same blockers as typed `TokenOpsSdkError`s, index-
+ *   aligned with `blockers`. Branch on `error.code` to render UI.
+ */
+export interface CreateVestingPreflightReport {
+    /** The ERC-7984 distribution token the manager clone is bound to. */
+    token: Address;
+    /** `true` when the creator holds `VESTING_CREATOR_ROLE` on the manager. */
+    hasCreatorRole: boolean;
+    /** `true` when the creator has approved the manager as operator on `token`. */
+    isOperatorSet: boolean;
+    /** `true` when no blockers were detected — green light to submit the write. */
+    ready: boolean;
+    /** Human-readable blocker descriptions. Empty when `ready === true`. */
+    blockers: string[];
+    /**
+     * Typed errors that would otherwise surface at write time, index-aligned
+     * with `blockers`. Empty when `ready === true`.
+     */
+    blockerErrors: TokenOpsSdkError[];
+}

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
+var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var chains = require('viem/chains');
 
 var SUPPORTED_CHAINS = {
@@ -15,59 +15,59 @@ function isSupportedChainId(chainId) {
 
 Object.defineProperty(exports, "DEPLOYED_ADDRESSES", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.DEPLOYED_ADDRESSES; }
+  get: function () { return chunkPUPKNW3R_cjs.DEPLOYED_ADDRESSES; }
 });
 Object.defineProperty(exports, "chainsWithDeployment", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.chainsWithDeployment; }
+  get: function () { return chunkPUPKNW3R_cjs.chainsWithDeployment; }
 });
 Object.defineProperty(exports, "chainsWithKnownRegistryEntry", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.chainsWithKnownRegistryEntry; }
+  get: function () { return chunkPUPKNW3R_cjs.chainsWithKnownRegistryEntry; }
 });
 Object.defineProperty(exports, "getConfidentialTestTokenAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.getConfidentialTestTokenAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.getConfidentialTestTokenAddress; }
 });
 Object.defineProperty(exports, "getDeployedAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.getDeployedAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.getDeployedAddress; }
 });
 Object.defineProperty(exports, "getFheAirdropFactoryAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.getFheAirdropFactoryAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.getFheAirdropFactoryAddress; }
 });
 Object.defineProperty(exports, "getFheDisperseSingletonAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.getFheDisperseSingletonAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.getFheDisperseSingletonAddress; }
 });
 Object.defineProperty(exports, "getFheVestingFactoryAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.getFheVestingFactoryAddress; }
 });
 Object.defineProperty(exports, "getTestTokenAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.getTestTokenAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.getTestTokenAddress; }
 });
 Object.defineProperty(exports, "requireConfidentialTestTokenAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.requireConfidentialTestTokenAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.requireConfidentialTestTokenAddress; }
 });
 Object.defineProperty(exports, "requireFheAirdropFactoryAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.requireFheAirdropFactoryAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.requireFheAirdropFactoryAddress; }
 });
 Object.defineProperty(exports, "requireFheDisperseSingletonAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.requireFheDisperseSingletonAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.requireFheDisperseSingletonAddress; }
 });
 Object.defineProperty(exports, "requireFheVestingFactoryAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.requireFheVestingFactoryAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.requireFheVestingFactoryAddress; }
 });
 Object.defineProperty(exports, "requireTestTokenAddress", {
   enumerable: true,
-  get: function () { return chunk3ZRHDTEX_cjs.requireTestTokenAddress; }
+  get: function () { return chunkPUPKNW3R_cjs.requireTestTokenAddress; }
 });
 Object.defineProperty(exports, "asAirdropId", {
   enumerable: true,
@@ -103,151 +103,159 @@ Object.defineProperty(exports, "asVestingId", {
 });
 Object.defineProperty(exports, "AccessDeniedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.AccessDeniedError; }
+  get: function () { return chunk67OV5CX2_cjs.AccessDeniedError; }
 });
 Object.defineProperty(exports, "AlreadyInitializedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.AlreadyInitializedError; }
+  get: function () { return chunk67OV5CX2_cjs.AlreadyInitializedError; }
 });
 Object.defineProperty(exports, "BatchTooLargeError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.BatchTooLargeError; }
+  get: function () { return chunk67OV5CX2_cjs.BatchTooLargeError; }
 });
 Object.defineProperty(exports, "ContractRevertError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ContractRevertError; }
+  get: function () { return chunk67OV5CX2_cjs.ContractRevertError; }
 });
 Object.defineProperty(exports, "DecryptionFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.DecryptionFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.DecryptionFailedError; }
 });
 Object.defineProperty(exports, "DeploymentAddressUnavailableError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.DeploymentAddressUnavailableError; }
+  get: function () { return chunk67OV5CX2_cjs.DeploymentAddressUnavailableError; }
 });
 Object.defineProperty(exports, "EncryptionFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.EncryptionFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.EncryptionFailedError; }
 });
 Object.defineProperty(exports, "FeatureDisabledError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.FeatureDisabledError; }
+  get: function () { return chunk67OV5CX2_cjs.FeatureDisabledError; }
 });
 Object.defineProperty(exports, "FheHandleNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.FheHandleNotAllowedError; }
+  get: function () { return chunk67OV5CX2_cjs.FheHandleNotAllowedError; }
 });
 Object.defineProperty(exports, "InsufficientBalanceError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InsufficientBalanceError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientBalanceError; }
 });
 Object.defineProperty(exports, "InsufficientFeeError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InsufficientFeeError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientFeeError; }
 });
 Object.defineProperty(exports, "InsufficientGasFundsError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InsufficientGasFundsError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientGasFundsError; }
 });
 Object.defineProperty(exports, "InvalidArgumentError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InvalidArgumentError; }
+  get: function () { return chunk67OV5CX2_cjs.InvalidArgumentError; }
 });
 Object.defineProperty(exports, "InvalidSignatureError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InvalidSignatureError; }
+  get: function () { return chunk67OV5CX2_cjs.InvalidSignatureError; }
 });
 Object.defineProperty(exports, "MissingAccountError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingAccountError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingAccountError; }
 });
 Object.defineProperty(exports, "MissingClientError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingClientError; }
 });
 Object.defineProperty(exports, "MissingEncryptorError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingEncryptorError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingEncryptorError; }
 });
 Object.defineProperty(exports, "MissingPublicClientError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingPublicClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingPublicClientError; }
 });
 Object.defineProperty(exports, "MissingWalletClientError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingWalletClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingWalletClientError; }
 });
 Object.defineProperty(exports, "NetworkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.NetworkError; }
+  get: function () { return chunk67OV5CX2_cjs.NetworkError; }
+});
+Object.defineProperty(exports, "OPERATOR_NOT_APPROVED_REMEDIATION", {
+  enumerable: true,
+  get: function () { return chunk67OV5CX2_cjs.OPERATOR_NOT_APPROVED_REMEDIATION; }
+});
+Object.defineProperty(exports, "OperatorNotApprovedError", {
+  enumerable: true,
+  get: function () { return chunk67OV5CX2_cjs.OperatorNotApprovedError; }
 });
 Object.defineProperty(exports, "PausedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.PausedError; }
+  get: function () { return chunk67OV5CX2_cjs.PausedError; }
 });
 Object.defineProperty(exports, "ReceiptEventAmbiguousError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ReceiptEventAmbiguousError; }
+  get: function () { return chunk67OV5CX2_cjs.ReceiptEventAmbiguousError; }
 });
 Object.defineProperty(exports, "ReceiptEventNotFoundError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ReceiptEventNotFoundError; }
+  get: function () { return chunk67OV5CX2_cjs.ReceiptEventNotFoundError; }
 });
 Object.defineProperty(exports, "ReentrancyError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ReentrancyError; }
+  get: function () { return chunk67OV5CX2_cjs.ReentrancyError; }
 });
 Object.defineProperty(exports, "RelayerUnreachableError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.RelayerUnreachableError; }
+  get: function () { return chunk67OV5CX2_cjs.RelayerUnreachableError; }
 });
 Object.defineProperty(exports, "SigningFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.SigningFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.SigningFailedError; }
 });
 Object.defineProperty(exports, "TokenOpsContractError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsContractError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsContractError; }
 });
 Object.defineProperty(exports, "TokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsSdkError; }
 });
 Object.defineProperty(exports, "TokenOpsValidationError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsValidationError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsValidationError; }
 });
 Object.defineProperty(exports, "TransferFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TransferFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.TransferFailedError; }
 });
 Object.defineProperty(exports, "UnknownWriteFailureError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UnknownWriteFailureError; }
+  get: function () { return chunk67OV5CX2_cjs.UnknownWriteFailureError; }
 });
 Object.defineProperty(exports, "UnsupportedChainError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UnsupportedChainError; }
+  get: function () { return chunk67OV5CX2_cjs.UnsupportedChainError; }
 });
 Object.defineProperty(exports, "UserDecryptNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UserDecryptNotAllowedError; }
+  get: function () { return chunk67OV5CX2_cjs.UserDecryptNotAllowedError; }
 });
 Object.defineProperty(exports, "UserRejectedSignatureError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UserRejectedSignatureError; }
+  get: function () { return chunk67OV5CX2_cjs.UserRejectedSignatureError; }
 });
 Object.defineProperty(exports, "WalletChainMismatchError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.WalletChainMismatchError; }
+  get: function () { return chunk67OV5CX2_cjs.WalletChainMismatchError; }
 });
 Object.defineProperty(exports, "WalletRejectedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.WalletRejectedError; }
+  get: function () { return chunk67OV5CX2_cjs.WalletRejectedError; }
 });
 Object.defineProperty(exports, "isTokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.isTokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.isTokenOpsSdkError; }
 });
 exports.SUPPORTED_CHAINS = SUPPORTED_CHAINS;
 exports.isSupportedChainId = isSupportedChainId;

package/dist/index.d.cts

@@ -1,3 +1,3 @@
 export * from "./core/index.js";
-export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ContractRevertError, PausedError, AccessDeniedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "./core/errors.js";
+export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ContractRevertError, PausedError, AccessDeniedError, OperatorNotApprovedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "./core/errors.js";
 export { type PreflightResult } from "./core/preflight.js";