@tokenops/sdk 1.1.1 → 1.6.0

package/dist/{chunk-SEKC7H5Y.cjs → chunk-CBRL2PJA.cjs}

@@ -1,9 +1,10 @@
 'use strict';
 
-var chunkOYLZEEHF_cjs = require('./chunk-OYLZEEHF.cjs');
-var chunkSAGJIEQK_cjs = require('./chunk-SAGJIEQK.cjs');
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunkBK7YIVLK_cjs = require('./chunk-BK7YIVLK.cjs');
+var chunkBD4LZBVF_cjs = require('./chunk-BD4LZBVF.cjs');
+var chunkEUKPOXWR_cjs = require('./chunk-EUKPOXWR.cjs');
+var chunkWUXUWTFW_cjs = require('./chunk-WUXUWTFW.cjs');
+var chunk2RNW4MIJ_cjs = require('./chunk-2RNW4MIJ.cjs');
 var react = require('react');
 var wagmi = require('wagmi');
 
@@ -25,7 +26,7 @@ function useHookFiredEvent(hookName, telemetry, hasWallet, chainId) {
 function tryResolveFactoryAddress(override, chainId) {
   if (override) return override;
   if (chainId === void 0) return void 0;
-  return chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId);
+  return chunkWUXUWTFW_cjs.getFheVestingFactoryAddress(chainId);
 }
 function useMemoFactoryClient(opts = {}) {
   const publicClient = wagmi.usePublicClient({ chainId: opts.chainId });
@@ -38,7 +39,7 @@ function useMemoFactoryClient(opts = {}) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunkSAGJIEQK_cjs.createConfidentialVestingFactoryClient({
+    return chunkEUKPOXWR_cjs.createConfidentialVestingFactoryClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
@@ -58,16 +59,16 @@ function useMemoFactoryClient(opts = {}) {
 function computeFactoryResolutionError(override, chainId) {
   if (override) return void 0;
   if (chainId === void 0) {
-    return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+    return new chunk2RNW4MIJ_cjs.DeploymentAddressUnavailableError({
       reason: "chain-id-missing",
       product: "fheVesting",
       contract: "confidentialVestingFactory",
       clientLabel: "ConfidentialVestingFactoryClient"
     });
   }
-  const resolved = chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId);
+  const resolved = chunkWUXUWTFW_cjs.getFheVestingFactoryAddress(chainId);
   if (!resolved) {
-    return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+    return new chunk2RNW4MIJ_cjs.DeploymentAddressUnavailableError({
       reason: "registry-not-deployed",
       product: "fheVesting",
       contract: "confidentialVestingFactory",
@@ -88,13 +89,13 @@ function useMemoManagerClient(opts) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!opts.address) return void 0;
-    return chunkOYLZEEHF_cjs.createConfidentialVestingManagerClient({
+    return chunkBK7YIVLK_cjs.createConfidentialVestingManagerClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: opts.address,
       // Lazy — invoked per-encryption inside the headless client. Picks up
       // whichever EncryptorSource the consumer last passed in.
-      encryptor: () => chunkOYLZEEHF_cjs.resolveEncryptor(encryptorSourceRef.current),
+      encryptor: () => chunkBD4LZBVF_cjs.resolveEncryptor(encryptorSourceRef.current),
       ...opts.aclAddress ? { aclAddress: opts.aclAddress } : {},
       ...telemetry ? { telemetry } : {}
     });

package/dist/{chunk-XWDVPV42.js → chunk-CNP4L3GF.js}

@@ -1,7 +1,7 @@
-import { createConfidentialAirdropClient } from './chunk-XXXDQSHE.js';
-import { createConfidentialAirdropFactoryClient, resolveEncryptor } from './chunk-OQZAZIAS.js';
-import { getFheAirdropFactoryAddress } from './chunk-M7V2EDPB.js';
-import { DeploymentAddressUnavailableError } from './chunk-IVE3QEGD.js';
+import { createConfidentialAirdropClient } from './chunk-S2XD75JM.js';
+import { createConfidentialAirdropFactoryClient, resolveEncryptor } from './chunk-UE5XK2SY.js';
+import { getFheAirdropFactoryAddress } from './chunk-QKKBBH7I.js';
+import { DeploymentAddressUnavailableError } from './chunk-DRSPMIZ7.js';
 import { useRef, useMemo } from 'react';
 import { usePublicClient, useWalletClient } from 'wagmi';
 

package/dist/{chunk-IVE3QEGD.js → chunk-DRSPMIZ7.js}

@@ -206,6 +206,23 @@ var AccessDeniedError = class extends TokenOpsSdkError {
     });
   }
 };
+var OPERATOR_NOT_APPROVED_REMEDIATION = "The token has not approved this contract as an operator. Call `setOperator()` (see `/fhe` operators) before this transaction.";
+var OperatorNotApprovedError = class extends TokenOpsSdkError {
+  name = "OperatorNotApprovedError";
+  constructor(args) {
+    super(OPERATOR_NOT_APPROVED_REMEDIATION, {
+      code: "TOKENOPS_OPERATOR_NOT_APPROVED",
+      cause: args.cause,
+      context: {
+        method: args.method,
+        contractAddress: args.contractAddress,
+        tokenAddress: args.tokenAddress,
+        holder: args.holder,
+        spender: args.spender
+      }
+    });
+  }
+};
 var InsufficientFeeError = class extends TokenOpsSdkError {
   name = "InsufficientFeeError";
   constructor(args) {
@@ -475,4 +492,14 @@ var TokenOpsContractError = class extends TokenOpsSdkError {
   }
 };
 
-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, TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError };
+// src/core/brands.ts
+var asEncryptedHandle = (h) => h;
+var asExternalInputProof = (h) => h;
+var asTxHash = (h) => h;
+var asVestingId = (h) => h;
+var asAirdropId = (h) => h;
+var asDisperseId = (h) => h;
+var asRole = (h) => h;
+var asSignature = (h) => h;
+
+export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, OPERATOR_NOT_APPROVED_REMEDIATION, OperatorNotApprovedError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, asAirdropId, asDisperseId, asEncryptedHandle, asExternalInputProof, asRole, asSignature, asTxHash, asVestingId, isTokenOpsSdkError };

package/dist/{chunk-SAGJIEQK.cjs → chunk-EUKPOXWR.cjs}

@@ -1,11 +1,10 @@
 'use strict';
 
-var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
-var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.cjs');
+var chunk43RFBQ73_cjs = require('./chunk-43RFBQ73.cjs');
+var chunkWUXUWTFW_cjs = require('./chunk-WUXUWTFW.cjs');
+var chunkVR3FREBX_cjs = require('./chunk-VR3FREBX.cjs');
+var chunk2RNW4MIJ_cjs = require('./chunk-2RNW4MIJ.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
-var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
 var viem = require('viem');
 
 // src/fhe-vesting/abis/factory.ts
@@ -444,10 +443,10 @@ var ConfidentialVestingFactoryClient = class {
     this.publicClient = config.publicClient;
     this.walletClient = config.walletClient;
     const chainId = config.chainId ?? config.publicClient.chain?.id;
-    const addressOverride = config.address ? chunkCQIPRNS7_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId));
+    const addressOverride = config.address ? chunkVR3FREBX_cjs.normaliseAddress(config.address) : void 0;
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkWUXUWTFW_cjs.getFheVestingFactoryAddress(chainId));
     if (!resolved) {
-      throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+      throw new chunk2RNW4MIJ_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
         product: "fheVesting",
         contract: "confidentialVestingFactory",
@@ -463,7 +462,7 @@ var ConfidentialVestingFactoryClient = class {
       hasWallet: !!this.walletClient,
       aclResolved: true,
       // factory has no ACL dependency; constant for funnel-shape parity with manager.
-      sdkVersion: chunkVDXVNZCO_cjs.SDK_VERSION
+      sdkVersion: chunk43RFBQ73_cjs.SDK_VERSION
     });
   }
   // ----------------------- writes -----------------------
@@ -653,20 +652,20 @@ var ConfidentialVestingFactoryClient = class {
     });
     const ours = events.filter((ev) => ev.address.toLowerCase() === this.address.toLowerCase());
     if (ours.length === 0) {
-      throw new chunk56UI7LUR_cjs.TokenOpsSdkError(
+      throw new chunk2RNW4MIJ_cjs.TokenOpsSdkError(
         `${method}: no ManagerCreated event from factory ${this.address} in tx ${hash}`
       );
     }
     if (ours.length > 1) {
-      throw new chunk56UI7LUR_cjs.TokenOpsSdkError(
+      throw new chunk2RNW4MIJ_cjs.TokenOpsSdkError(
         `${method}: ${ours.length} ManagerCreated events from factory ${this.address} in tx ${hash}; ambiguous result`
       );
     }
-    return { hash: chunk66IHPTOK_cjs.asTxHash(hash), manager: ours[0].args.manager };
+    return { hash: chunk2RNW4MIJ_cjs.asTxHash(hash), manager: ours[0].args.manager };
   }
   #requireWallet(method) {
     if (!this.walletClient) {
-      throw new chunk56UI7LUR_cjs.MissingWalletClientError(method);
+      throw new chunk2RNW4MIJ_cjs.MissingWalletClientError(method);
     }
     return this.walletClient;
   }
@@ -674,7 +673,7 @@ var ConfidentialVestingFactoryClient = class {
     const wallet = this.#requireWallet(functionName);
     const acct = account ?? wallet.account;
     if (!acct) {
-      throw new chunk56UI7LUR_cjs.MissingAccountError(String(functionName));
+      throw new chunk2RNW4MIJ_cjs.MissingAccountError(String(functionName));
     }
     await this.#preflightWrite(String(functionName), functionName, args, acct);
     try {
@@ -691,7 +690,7 @@ var ConfidentialVestingFactoryClient = class {
     }
   }
   #mapRevert(method, err, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunk43RFBQ73_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: confidentialVestingFactoryAbi,
@@ -716,7 +715,7 @@ var ConfidentialVestingFactoryClient = class {
         ...value !== void 0 ? { value } : {}
       });
     } catch (err) {
-      if (chunkVDXVNZCO_cjs.isContractRevert(err)) {
+      if (chunk43RFBQ73_cjs.isContractRevert(err)) {
         throw this.#mapRevert(method, err, accountAddress(account));
       }
     }

package/dist/chunk-FT4LNBOS.js

@@ -0,0 +1,11 @@
+import * as wagmi from 'wagmi';
+
+// src/core/wagmi-compat.ts
+var wagmiModule = wagmi;
+var useWagmiAccount = wagmiModule.useConnection ?? wagmiModule.useAccount ?? (() => {
+  throw new Error(
+    "@tokenops/sdk: the installed `wagmi` package exposes neither `useConnection` (v3) nor `useAccount` (v2). Install wagmi ^2.0.0 or ^3.0.0 \u2014 the SDK's /react subpaths support both majors."
+  );
+});
+
+export { useWagmiAccount };

package/dist/{chunk-ITQBDRWX.js → chunk-HETNKZEE.js}

@@ -1,4 +1,4 @@
-import { ConfidentialVestingFactoryClient, confidentialVestingFactoryAbi } from './chunk-IR5AK5U5.js';
+import { ConfidentialVestingFactoryClient, confidentialVestingFactoryAbi } from './chunk-V5D7BHW3.js';
 
 // src/fhe-vesting/advanced/factory-advanced.ts
 var ConfidentialVestingFactoryAdvancedClient = class extends ConfidentialVestingFactoryClient {

package/dist/{chunk-JJ4R5QXF.js → chunk-KSDSXJ34.js}

@@ -1,4 +1,4 @@
-import { ConfidentialAirdropFactoryClient, confidentialAirdropFactoryAbi } from './chunk-OQZAZIAS.js';
+import { ConfidentialAirdropFactoryClient, confidentialAirdropFactoryAbi } from './chunk-UE5XK2SY.js';
 
 // src/fhe-airdrop/advanced/factory-advanced.ts
 var ConfidentialAirdropFactoryAdvancedClient = class extends ConfidentialAirdropFactoryClient {

package/dist/{chunk-SYHXDHWX.cjs → chunk-LBWRFZR3.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
-var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.cjs');
+var chunkFWHYQZ5E_cjs = require('./chunk-FWHYQZ5E.cjs');
+var chunk43RFBQ73_cjs = require('./chunk-43RFBQ73.cjs');
+var chunkWUXUWTFW_cjs = require('./chunk-WUXUWTFW.cjs');
+var chunkVR3FREBX_cjs = require('./chunk-VR3FREBX.cjs');
+var chunk2RNW4MIJ_cjs = require('./chunk-2RNW4MIJ.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
-var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
 var viem = require('viem');
 
 // src/fhe-airdrop/abis/factory.ts
@@ -935,7 +935,7 @@ function resolveEncryptor(source) {
 var MAX_UINT64 = (1n << 64n) - 1n;
 function assertUint64(value, label) {
   if (value < 0n || value > MAX_UINT64) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
       method: "encryptUint64",
       argument: label,
       reason: "exceeds uint64 range (0..2^64-1)",
@@ -956,7 +956,7 @@ async function encryptUint64({
     userAddress
   });
   if (handles.length !== 1) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
       method: "encryptUint64",
       argument: "handles",
       reason: `expected 1 handle, got ${handles.length}`,
@@ -964,8 +964,8 @@ async function encryptUint64({
     });
   }
   return {
-    handle: chunk66IHPTOK_cjs.asEncryptedHandle(viem.bytesToHex(handles[0])),
-    inputProof: chunk66IHPTOK_cjs.asExternalInputProof(viem.bytesToHex(inputProof))
+    handle: chunk2RNW4MIJ_cjs.asEncryptedHandle(viem.bytesToHex(handles[0])),
+    inputProof: chunk2RNW4MIJ_cjs.asExternalInputProof(viem.bytesToHex(inputProof))
   };
 }
 async function encryptUint64Batch({
@@ -975,7 +975,7 @@ async function encryptUint64Batch({
   values
 }) {
   if (values.length === 0) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
       method: "encryptUint64Batch",
       argument: "values",
       reason: "must be non-empty"
@@ -988,7 +988,7 @@ async function encryptUint64Batch({
     userAddress
   });
   if (handles.length !== values.length) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
       method: "encryptUint64Batch",
       argument: "handles",
       reason: `expected ${values.length} handles, got ${handles.length}`,
@@ -996,23 +996,23 @@ async function encryptUint64Batch({
     });
   }
   return {
-    handles: handles.map((h) => chunk66IHPTOK_cjs.asEncryptedHandle(viem.bytesToHex(h))),
-    inputProof: chunk66IHPTOK_cjs.asExternalInputProof(viem.bytesToHex(inputProof))
+    handles: handles.map((h) => chunk2RNW4MIJ_cjs.asEncryptedHandle(viem.bytesToHex(h))),
+    inputProof: chunk2RNW4MIJ_cjs.asExternalInputProof(viem.bytesToHex(inputProof))
   };
 }
 async function signClaimAuthorization(args) {
   if (args.encryptedAmountHandle.length !== 66) {
-    throw new chunk56UI7LUR_cjs.TokenOpsSdkError(
+    throw new chunk2RNW4MIJ_cjs.TokenOpsSdkError(
       `signClaimAuthorization: encryptedAmountHandle must be a 32-byte hex string (0x + 64 chars), got length ${args.encryptedAmountHandle.length}`
     );
   }
   const account = args.walletClient.account;
   if (!account) {
-    throw new chunk56UI7LUR_cjs.MissingAccountError("signClaimAuthorization");
+    throw new chunk2RNW4MIJ_cjs.MissingAccountError("signClaimAuthorization");
   }
   const chainId = args.walletClient.chain?.id;
   if (!chainId) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
       method: "signClaimAuthorization",
       argument: "walletClient.chain.id",
       reason: "required for EIP712 chainId binding; pass a walletClient constructed with a known chain (e.g. `createWalletClient({ chain: sepolia, ... })`)."
@@ -1038,7 +1038,7 @@ async function signClaimAuthorization(args) {
       encryptedAmount: args.encryptedAmountHandle
     }
   });
-  return chunk66IHPTOK_cjs.asSignature(sig);
+  return chunk2RNW4MIJ_cjs.asSignature(sig);
 }
 var airdropFactoryProductMapper = () => void 0;
 var ConfidentialAirdropFactoryClient = class {
@@ -1052,10 +1052,10 @@ var ConfidentialAirdropFactoryClient = class {
     this.walletClient = config.walletClient;
     this.encryptor = config.encryptor;
     const chainId = config.chainId ?? config.publicClient.chain?.id;
-    const addressOverride = config.address ? chunkCQIPRNS7_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.getFheAirdropFactoryAddress(chainId));
+    const addressOverride = config.address ? chunkVR3FREBX_cjs.normaliseAddress(config.address) : void 0;
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkWUXUWTFW_cjs.getFheAirdropFactoryAddress(chainId));
     if (!resolved) {
-      throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+      throw new chunk2RNW4MIJ_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
         product: "fheAirdrop",
         contract: "confidentialAirdropFactory",
@@ -1071,7 +1071,7 @@ var ConfidentialAirdropFactoryClient = class {
       hasWallet: !!this.walletClient,
       aclResolved: true,
       // factory has no ACL dependency; constant for funnel-shape parity with client.
-      sdkVersion: chunkVDXVNZCO_cjs.SDK_VERSION
+      sdkVersion: chunk43RFBQ73_cjs.SDK_VERSION
     });
   }
   // ----------------------- writes -----------------------
@@ -1118,6 +1118,14 @@ var ConfidentialAirdropFactoryClient = class {
    * Prerequisites: caller must have set this factory as an operator on the
    * token: `token.setOperator(factoryAddress, deadline)`.
    *
+   * **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.
+   *
    * Symmetric with {@link ConfidentialAirdropFactoryClient.createConfidentialAirdrop}
    * — both return `{ hash, airdrop }` parsed from the
    * `ConfidentialAirdropCreated` event.
@@ -1180,6 +1188,14 @@ var ConfidentialAirdropFactoryClient = class {
    * Prerequisites: caller must have set this factory as an operator on the token:
    * `token.setOperator(factoryAddress, deadline)`
    *
+   * **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.
+   *
    * @returns Transaction hash.
    */
   async fundConfidentialAirdrop(args) {
@@ -1249,6 +1265,14 @@ var ConfidentialAirdropFactoryClient = class {
    * Symmetry with {@link ConfidentialAirdropFactoryClient.createConfidentialAirdropAndGetAddress}
    * — use this when you also need to seed the pool in the same transaction.
    *
+   * **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.
+   *
    * Internally: {@link ConfidentialAirdropFactoryClient.createAndFundConfidentialAirdrop} →
    * {@link PublicClient.waitForTransactionReceipt} →
    * `parseEventLogs({ eventName: "ConfidentialAirdropCreated" })`.
@@ -1331,6 +1355,163 @@ var ConfidentialAirdropFactoryClient = class {
   async getInitCodeHash(args) {
     return this.#read("getInitCodeHash", [toAbiParams(args.params), args.gasFee]);
   }
+  // ----------------------- preflight -----------------------
+  /**
+   * Read-only preflight for {@link createConfidentialAirdrop} /
+   * {@link createAndFundConfidentialAirdrop}. Runs the
+   * deterministic-from-off-chain checks and reports blockers both as
+   * human-readable strings (`blockers`) and as typed {@link TokenOpsSdkError}s
+   * (`blockerErrors`), index-aligned.
+   *
+   * Preflight is **opt-in**. Consumers who have already validated state can
+   * skip this call and invoke the write directly — they'll receive the same
+   * typed errors at write time via the revert mapper.
+   *
+   * Report fields: `isFactoryOperator`, `gasFee`, `predictedAirdrop`,
+   * `alreadyDeployed`, `ready`, `blockers`, `blockerErrors` — see
+   * {@link CreateAirdropPreflightReport} for the meaning of each.
+   *
+   * Checks performed (all read-only, no gas):
+   * - Structural `params` validation mirroring the factory + clone
+   *   `initialize` requirements (`InvalidArgumentError` blockers): `token` and
+   *   `admin` are checksummed non-zero addresses,
+   *   `startTimestamp < endTimestamp`, and `endTimestamp` is in the future
+   *   (the clone's `initialize` reverts with `EndTimeInPast`).
+   * - Operator: creator has approved this factory as an ERC-7984 operator on
+   *   `params.token` — a blocker only when `funding: true`
+   *   ({@link OperatorNotApprovedError}); otherwise informational via
+   *   `isFactoryOperator`.
+   * - Collision (only when `userSalt` is supplied): bytecode already at the
+   *   predicted CREATE2 address means a repeat create with the same
+   *   `(params, userSalt, gasFee)` would revert
+   *   ({@link AlreadyInitializedError} blocker).
+   *
+   * **Not preflight-detectable — read before trusting `ready: true`:** the
+   * creator's confidential token balance is an encrypted `euint64` the SDK
+   * cannot read in plaintext, and an underfunded `createAndFund` does **not**
+   * revert — the ERC-7984 transfer silently moves an encrypted zero. Confirm
+   * the creator's balance covers the pool before submitting.
+   *
+   * @param args See {@link PreflightCreateAirdropArgs}.
+   * @returns A {@link CreateAirdropPreflightReport}.
+   */
+  async preflightCreateAirdrop(args) {
+    const { params, creator, userSalt, funding } = args;
+    const blockers = [];
+    const blockerErrors = [];
+    const pushBlocker = (err) => {
+      blockerErrors.push(err);
+      blockers.push(err.message);
+    };
+    const tokenOk = viem.isAddress(params.token, { strict: true }) && params.token !== ZERO_ADDRESS;
+    if (!tokenOk) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+          method: "createConfidentialAirdrop",
+          argument: "params.token",
+          reason: "must be a valid, non-zero EIP-55 checksummed address",
+          value: params.token
+        })
+      );
+    }
+    const adminOk = viem.isAddress(params.admin, { strict: true }) && params.admin !== ZERO_ADDRESS;
+    if (!adminOk) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+          method: "createConfidentialAirdrop",
+          argument: "params.admin",
+          reason: "must be a valid, non-zero EIP-55 checksummed address",
+          value: params.admin
+        })
+      );
+    }
+    if (params.startTimestamp >= params.endTimestamp) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+          method: "createConfidentialAirdrop",
+          argument: "params.startTimestamp/params.endTimestamp",
+          reason: "startTimestamp must be strictly less than endTimestamp",
+          value: { startTimestamp: params.startTimestamp, endTimestamp: params.endTimestamp }
+        })
+      );
+    }
+    const [block, customFee, defaultFee, operatorRead] = await Promise.all([
+      this.publicClient.getBlock(),
+      this.getCustomFee(creator),
+      this.defaultGasFee(),
+      tokenOk ? this.publicClient.readContract({
+        address: params.token,
+        abi: chunkFWHYQZ5E_cjs.erc7984OperatorAbi,
+        functionName: "isOperator",
+        args: [creator, this.address]
+      }).then((v) => ({ ok: true, value: v })).catch((err) => {
+        if (isNotErc7984Failure(err)) return { ok: false, err };
+        throw err;
+      }) : Promise.resolve({ ok: true, value: false })
+    ]);
+    const isFactoryOperator = operatorRead.ok ? operatorRead.value : false;
+    if (!operatorRead.ok) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+          method: "createConfidentialAirdrop",
+          argument: "params.token",
+          reason: "does not implement the ERC-7984 `isOperator(address,address)` view \u2014 it is not a confidential token (or the address holds no contract on this chain)",
+          value: params.token
+        })
+      );
+    }
+    const gasFee = customFee.enabled ? customFee.gasFee : defaultFee;
+    if (params.endTimestamp <= Number(block.timestamp)) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+          method: "createConfidentialAirdrop",
+          argument: "params.endTimestamp",
+          reason: "must be in the future (the clone's initialize reverts with EndTimeInPast)",
+          value: params.endTimestamp
+        })
+      );
+    }
+    if (funding === true && tokenOk && operatorRead.ok && !isFactoryOperator) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.OperatorNotApprovedError({
+          method: "createAndFundConfidentialAirdrop",
+          contractAddress: this.address,
+          tokenAddress: params.token,
+          holder: creator,
+          spender: this.address
+        })
+      );
+    }
+    let predictedAirdrop;
+    let alreadyDeployed;
+    if (userSalt !== void 0 && tokenOk && adminOk) {
+      predictedAirdrop = await this.#read("predictAirdropAddress", [
+        toAbiParams(params),
+        userSalt,
+        creator,
+        gasFee
+      ]);
+      const bytecode = await this.publicClient.getCode({ address: predictedAirdrop });
+      alreadyDeployed = bytecode !== void 0 && bytecode !== "0x";
+      if (alreadyDeployed) {
+        pushBlocker(
+          new chunk2RNW4MIJ_cjs.AlreadyInitializedError({
+            method: "createConfidentialAirdrop",
+            contractAddress: predictedAirdrop
+          })
+        );
+      }
+    }
+    return {
+      isFactoryOperator,
+      gasFee,
+      predictedAirdrop,
+      alreadyDeployed,
+      ready: blockers.length === 0,
+      blockers,
+      blockerErrors
+    };
+  }
   // ----------------------- internals -----------------------
   /**
    * Wait for the receipt of a clone-deploy tx and parse the
@@ -1347,27 +1528,27 @@ var ConfidentialAirdropFactoryClient = class {
     });
     const ours = events.filter((ev) => ev.address.toLowerCase() === this.address.toLowerCase());
     if (ours.length === 0) {
-      throw new chunk56UI7LUR_cjs.TokenOpsSdkError(
+      throw new chunk2RNW4MIJ_cjs.TokenOpsSdkError(
         `${method}: no ConfidentialAirdropCreated event from factory ${this.address} in tx ${hash}`
       );
     }
     if (ours.length > 1) {
-      throw new chunk56UI7LUR_cjs.TokenOpsSdkError(
+      throw new chunk2RNW4MIJ_cjs.TokenOpsSdkError(
         `${method}: ${ours.length} ConfidentialAirdropCreated events from factory ${this.address} in tx ${hash}; ambiguous result`
       );
     }
-    return { hash: chunk66IHPTOK_cjs.asTxHash(hash), airdrop: ours[0].args.airdrop };
+    return { hash: chunk2RNW4MIJ_cjs.asTxHash(hash), airdrop: ours[0].args.airdrop };
   }
   #requireWallet(method) {
     if (!this.walletClient) {
-      throw new chunk56UI7LUR_cjs.MissingWalletClientError(method);
+      throw new chunk2RNW4MIJ_cjs.MissingWalletClientError(method);
     }
     return this.walletClient;
   }
   #resolveAccount(wallet, override, method) {
     const acct = override ?? wallet.account;
     if (!acct) {
-      throw new chunk56UI7LUR_cjs.MissingAccountError(method);
+      throw new chunk2RNW4MIJ_cjs.MissingAccountError(method);
     }
     return acct;
   }
@@ -1381,14 +1562,14 @@ var ConfidentialAirdropFactoryClient = class {
     const hasAmount = amount !== void 0;
     const hasInput = preEncrypted !== void 0;
     if (hasAmount && hasInput) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method,
         argument: "amount/encryptedInput",
         reason: "exactly one of `amount` (plaintext, SDK encrypts) or `encryptedInput` (pre-encrypted) must be supplied \u2014 got both"
       });
     }
     if (!hasAmount && !hasInput) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method,
         argument: "amount/encryptedInput",
         reason: "exactly one of `amount` (plaintext, SDK encrypts) or `encryptedInput` (pre-encrypted) must be supplied \u2014 got neither"
@@ -1397,7 +1578,7 @@ var ConfidentialAirdropFactoryClient = class {
     if (hasInput) return preEncrypted;
     const enc = encryptor ?? resolveEncryptor(this.encryptor);
     if (!enc) {
-      throw new chunk56UI7LUR_cjs.MissingEncryptorError("encryptAmount", {
+      throw new chunk2RNW4MIJ_cjs.MissingEncryptorError("encryptAmount", {
         hint: "Pass `encryptor` to the call or the client config (eager or lazy factory)."
       });
     }
@@ -1426,7 +1607,7 @@ var ConfidentialAirdropFactoryClient = class {
     }
   }
   #mapRevert(method, err, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunk43RFBQ73_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: confidentialAirdropFactoryAbi,
@@ -1454,7 +1635,7 @@ var ConfidentialAirdropFactoryClient = class {
         ...value !== void 0 ? { value } : {}
       });
     } catch (err) {
-      if (chunkVDXVNZCO_cjs.isContractRevert(err)) {
+      if (chunk43RFBQ73_cjs.isContractRevert(err)) {
         throw this.#mapRevert(method, err, accountAddress(account));
       }
     }
@@ -1472,6 +1653,12 @@ var ConfidentialAirdropFactoryClient = class {
 function createConfidentialAirdropFactoryClient(config) {
   return new ConfidentialAirdropFactoryClient(config);
 }
+function isNotErc7984Failure(err) {
+  if (chunk43RFBQ73_cjs.isContractRevert(err)) return true;
+  if (!(err instanceof viem.BaseError)) return false;
+  return err.walk((e) => e instanceof viem.ContractFunctionZeroDataError) instanceof viem.ContractFunctionZeroDataError;
+}
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 function accountAddress(account) {
   return typeof account === "string" ? account : account.address;
 }

package/dist/{chunk-ZXCOJY2Z.js → chunk-NFW7AUEX.js}

@@ -1,4 +1,4 @@
-import { TokenOpsSdkError, InvalidArgumentError, DecryptionFailedError, EncryptionFailedError, RelayerUnreachableError, SigningFailedError, UserRejectedSignatureError, UserDecryptNotAllowedError } from './chunk-IVE3QEGD.js';
+import { TokenOpsSdkError, InvalidArgumentError, DecryptionFailedError, EncryptionFailedError, RelayerUnreachableError, SigningFailedError, UserRejectedSignatureError, UserDecryptNotAllowedError } from './chunk-DRSPMIZ7.js';
 
 // src/core/zama-error-mapper.ts
 function mapZamaError(error, args) {