@tokenops/sdk 1.1.1 → 1.5.1

package/dist/{chunk-IVE3QEGD.js → chunk-QBJ7O2B4.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,4 @@ 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 };
+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, isTokenOpsSdkError };

package/dist/{chunk-JFLEEXKP.js → chunk-SG65XWH7.js}

@@ -1,8 +1,51 @@
-import { TokenOpsSdkError, ContractRevertError, InvalidArgumentError, InvalidSignatureError, FheHandleNotAllowedError, TransferFailedError, FeatureDisabledError, BatchTooLargeError, InsufficientBalanceError, InsufficientFeeError, ReentrancyError, AlreadyInitializedError, AccessDeniedError, PausedError, UnknownWriteFailureError, WalletRejectedError, WalletChainMismatchError, InsufficientGasFundsError, NetworkError } from './chunk-IVE3QEGD.js';
+import { TokenOpsSdkError, ContractRevertError, InvalidArgumentError, OperatorNotApprovedError, InvalidSignatureError, FheHandleNotAllowedError, TransferFailedError, FeatureDisabledError, BatchTooLargeError, InsufficientBalanceError, InsufficientFeeError, ReentrancyError, AlreadyInitializedError, AccessDeniedError, PausedError, UnknownWriteFailureError, WalletRejectedError, WalletChainMismatchError, InsufficientGasFundsError, NetworkError } from './chunk-QBJ7O2B4.js';
 import { decodeErrorResult, BaseError, ContractFunctionRevertedError, UserRejectedRequestError, TransactionRejectedRpcError, ChainMismatchError, InsufficientFundsError, HttpRequestError, TimeoutError } from 'viem';
 
 // src/core/version.ts
 var SDK_VERSION = "1.0.0";
+var ERC7984_ERRORS_ABI = [
+  {
+    type: "error",
+    name: "ERC7984UnauthorizedSpender",
+    inputs: [
+      { name: "holder", type: "address" },
+      { name: "spender", type: "address" }
+    ]
+  },
+  {
+    type: "error",
+    name: "ERC7984UnauthorizedCaller",
+    inputs: [{ name: "caller", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984UnauthorizedUseOfEncryptedAmount",
+    inputs: [
+      { name: "amount", type: "bytes32" },
+      { name: "user", type: "address" }
+    ]
+  },
+  {
+    type: "error",
+    name: "ERC7984InvalidReceiver",
+    inputs: [{ name: "receiver", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984InvalidSender",
+    inputs: [{ name: "sender", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984ZeroBalance",
+    inputs: [{ name: "holder", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984InvalidGatewayRequest",
+    inputs: [{ name: "requestId", type: "uint256" }]
+  }
+];
 function mapContractRevert(error, args) {
   if (error instanceof TokenOpsSdkError) return error;
   const ctx = {
@@ -22,7 +65,10 @@ function mapContractRevert(error, args) {
   if (revertName === void 0 && rawRevertData !== void 0 && rawRevertData.length >= 10) {
     revertSelector = rawRevertData.slice(0, 10);
     try {
-      const decoded = decodeErrorResult({ abi: args.abi, data: rawRevertData });
+      const decoded = decodeErrorResult({
+        abi: [...args.abi, ...ERC7984_ERRORS_ABI],
+        data: rawRevertData
+      });
       revertName = decoded.errorName;
       revertArgs = decoded.args;
     } catch {
@@ -120,6 +166,16 @@ function defaultRevertNameMapper(name, errArgs, ctx, account) {
     }
     case "InvalidSignature":
       return new InvalidSignatureError(ctx);
+    case "ERC7984UnauthorizedSpender": {
+      const holder = errArgs?.[0];
+      const spender = errArgs?.[1];
+      return new OperatorNotApprovedError({
+        method: ctx.method,
+        contractAddress: ctx.contractAddress,
+        holder,
+        spender
+      });
+    }
     // Range / arg-validation reverts the SDK should already have caught in
     // preflight or input validation. If they slip through, surface them as
     // structural `InvalidArgumentError` so consumers see `TOKENOPS_INVALID_ARGUMENT`

package/dist/{chunk-G7G75C46.cjs → chunk-T46YXSBP.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunk5SA2HF2W_cjs = require('./chunk-5SA2HF2W.cjs');
-var chunkSYHXDHWX_cjs = require('./chunk-SYHXDHWX.cjs');
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunkMCRBVJGZ_cjs = require('./chunk-MCRBVJGZ.cjs');
+var chunkTIUKIY5V_cjs = require('./chunk-TIUKIY5V.cjs');
+var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var react = require('react');
 var wagmi = require('wagmi');
 
@@ -12,7 +12,7 @@ var FHE_AIRDROP_NAMESPACE = "fhe-airdrop";
 function tryResolveFactoryAddress(override, chainId) {
   if (override) return override;
   if (chainId === void 0) return void 0;
-  return chunk3ZRHDTEX_cjs.getFheAirdropFactoryAddress(chainId);
+  return chunkPUPKNW3R_cjs.getFheAirdropFactoryAddress(chainId);
 }
 function useMemoFactoryClient(opts = {}) {
   const publicClient = wagmi.usePublicClient({ chainId: opts.chainId });
@@ -25,14 +25,14 @@ function useMemoFactoryClient(opts = {}) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunkSYHXDHWX_cjs.createConfidentialAirdropFactoryClient({
+    return chunkTIUKIY5V_cjs.createConfidentialAirdropFactoryClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
       ...chainId !== void 0 ? { chainId } : {},
       // Lazy — invoked per-encryption inside the headless client. Picks up
       // whichever EncryptorSource the consumer last passed in.
-      encryptor: () => chunkSYHXDHWX_cjs.resolveEncryptor(encryptorSourceRef.current)
+      encryptor: () => chunkTIUKIY5V_cjs.resolveEncryptor(encryptorSourceRef.current)
     });
   }, [publicClient, walletClient, resolvedAddress, chainId]);
   return {
@@ -47,16 +47,16 @@ function useMemoFactoryClient(opts = {}) {
 function computeFactoryResolutionError(override, chainId) {
   if (override) return void 0;
   if (chainId === void 0) {
-    return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+    return new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
       reason: "chain-id-missing",
       product: "fheAirdrop",
       contract: "confidentialAirdropFactory",
       clientLabel: "ConfidentialAirdropFactoryClient"
     });
   }
-  const resolved = chunk3ZRHDTEX_cjs.getFheAirdropFactoryAddress(chainId);
+  const resolved = chunkPUPKNW3R_cjs.getFheAirdropFactoryAddress(chainId);
   if (!resolved) {
-    return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+    return new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
       reason: "registry-not-deployed",
       product: "fheAirdrop",
       contract: "confidentialAirdropFactory",
@@ -73,7 +73,7 @@ function useMemoAirdropClient(opts) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!opts.address) return void 0;
-    return chunk5SA2HF2W_cjs.createConfidentialAirdropClient({
+    return chunkMCRBVJGZ_cjs.createConfidentialAirdropClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: opts.address,

package/dist/{chunk-NS44KBV5.cjs → chunk-TEBM66WA.cjs}

@@ -1,29 +1,29 @@
 'use strict';
 
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 
 // src/core/zama-error-mapper.ts
 function mapZamaError(error, args) {
-  if (error instanceof chunk56UI7LUR_cjs.TokenOpsSdkError) return error;
+  if (error instanceof chunk67OV5CX2_cjs.TokenOpsSdkError) return error;
   const zama = readZamaError(error);
   if (zama?.code) {
     switch (zama.code) {
       case "SIGNING_REJECTED":
-        return new chunk56UI7LUR_cjs.UserRejectedSignatureError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.UserRejectedSignatureError({ ...args, cause: error });
       case "SIGNING_FAILED":
-        return new chunk56UI7LUR_cjs.SigningFailedError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.SigningFailedError({ ...args, cause: error });
       case "RELAYER_REQUEST_FAILED":
-        return new chunk56UI7LUR_cjs.RelayerUnreachableError({
+        return new chunk67OV5CX2_cjs.RelayerUnreachableError({
           ...args,
           statusCode: zama.statusCode,
           cause: error
         });
       case "ENCRYPTION_FAILED":
-        return new chunk56UI7LUR_cjs.EncryptionFailedError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.EncryptionFailedError({ ...args, cause: error });
       case "DECRYPTION_FAILED":
-        return new chunk56UI7LUR_cjs.DecryptionFailedError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.DecryptionFailedError({ ...args, cause: error });
       case "CONFIGURATION":
-        return new chunk56UI7LUR_cjs.InvalidArgumentError({
+        return new chunk67OV5CX2_cjs.InvalidArgumentError({
           method: args.method,
           argument: "config",
           reason: "Zama SDK configuration is invalid (chain id, type, or signer state).",
@@ -34,13 +34,13 @@ function mapZamaError(error, args) {
   const message = readMessage(error);
   if (message) {
     if (USER_REJECTION_PATTERNS.some((pat) => pat.test(message))) {
-      return new chunk56UI7LUR_cjs.UserRejectedSignatureError({ ...args, cause: error });
+      return new chunk67OV5CX2_cjs.UserRejectedSignatureError({ ...args, cause: error });
     }
     if (USER_DECRYPT_NOT_ALLOWED_PATTERNS.some((pat) => pat.test(message))) {
-      return new chunk56UI7LUR_cjs.UserDecryptNotAllowedError({ method: args.method, cause: error });
+      return new chunk67OV5CX2_cjs.UserDecryptNotAllowedError({ method: args.method, cause: error });
     }
     if (INVALID_INPUT_PATTERNS.some((pat) => pat.test(message))) {
-      return new chunk56UI7LUR_cjs.InvalidArgumentError({
+      return new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: args.method,
         argument: "input",
         reason: "encrypted input value rejected by FHE SDK \u2014 see `error.cause` for details",
@@ -48,7 +48,7 @@ function mapZamaError(error, args) {
       });
     }
   }
-  return args.operation === "encrypt" ? new chunk56UI7LUR_cjs.EncryptionFailedError({ ...args, cause: error }) : new chunk56UI7LUR_cjs.DecryptionFailedError({ ...args, cause: error });
+  return args.operation === "encrypt" ? new chunk67OV5CX2_cjs.EncryptionFailedError({ ...args, cause: error }) : new chunk67OV5CX2_cjs.DecryptionFailedError({ ...args, cause: error });
 }
 function readZamaError(err) {
   if (typeof err !== "object" || err === null) return void 0;

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

@@ -1,11 +1,12 @@
 '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 chunkKLKI352M_cjs = require('./chunk-KLKI352M.cjs');
+var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
+var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var viem = require('viem');
 
 // src/fhe-airdrop/abis/factory.ts
@@ -935,7 +936,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 chunk67OV5CX2_cjs.InvalidArgumentError({
       method: "encryptUint64",
       argument: label,
       reason: "exceeds uint64 range (0..2^64-1)",
@@ -956,7 +957,7 @@ async function encryptUint64({
     userAddress
   });
   if (handles.length !== 1) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method: "encryptUint64",
       argument: "handles",
       reason: `expected 1 handle, got ${handles.length}`,
@@ -975,7 +976,7 @@ async function encryptUint64Batch({
   values
 }) {
   if (values.length === 0) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method: "encryptUint64Batch",
       argument: "values",
       reason: "must be non-empty"
@@ -988,7 +989,7 @@ async function encryptUint64Batch({
     userAddress
   });
   if (handles.length !== values.length) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method: "encryptUint64Batch",
       argument: "handles",
       reason: `expected ${values.length} handles, got ${handles.length}`,
@@ -1002,17 +1003,17 @@ async function encryptUint64Batch({
 }
 async function signClaimAuthorization(args) {
   if (args.encryptedAmountHandle.length !== 66) {
-    throw new chunk56UI7LUR_cjs.TokenOpsSdkError(
+    throw new chunk67OV5CX2_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 chunk67OV5CX2_cjs.MissingAccountError("signClaimAuthorization");
   }
   const chainId = args.walletClient.chain?.id;
   if (!chainId) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_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, ... })`)."
@@ -1052,10 +1053,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 ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : void 0;
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.getFheAirdropFactoryAddress(chainId));
     if (!resolved) {
-      throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+      throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
         product: "fheAirdrop",
         contract: "confidentialAirdropFactory",
@@ -1071,7 +1072,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: chunkKLKI352M_cjs.SDK_VERSION
     });
   }
   // ----------------------- writes -----------------------
@@ -1118,6 +1119,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 +1189,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 +1266,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 +1356,149 @@ 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 chunk67OV5CX2_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 chunk67OV5CX2_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 chunk67OV5CX2_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, isFactoryOperator] = 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]
+      }) : Promise.resolve(false)
+    ]);
+    const gasFee = customFee.enabled ? customFee.gasFee : defaultFee;
+    if (params.endTimestamp <= Number(block.timestamp)) {
+      pushBlocker(
+        new chunk67OV5CX2_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 && !isFactoryOperator) {
+      pushBlocker(
+        new chunk67OV5CX2_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 chunk67OV5CX2_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,12 +1515,12 @@ 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 chunk67OV5CX2_cjs.TokenOpsSdkError(
         `${method}: no ConfidentialAirdropCreated event from factory ${this.address} in tx ${hash}`
       );
     }
     if (ours.length > 1) {
-      throw new chunk56UI7LUR_cjs.TokenOpsSdkError(
+      throw new chunk67OV5CX2_cjs.TokenOpsSdkError(
         `${method}: ${ours.length} ConfidentialAirdropCreated events from factory ${this.address} in tx ${hash}; ambiguous result`
       );
     }
@@ -1360,14 +1528,14 @@ var ConfidentialAirdropFactoryClient = class {
   }
   #requireWallet(method) {
     if (!this.walletClient) {
-      throw new chunk56UI7LUR_cjs.MissingWalletClientError(method);
+      throw new chunk67OV5CX2_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 chunk67OV5CX2_cjs.MissingAccountError(method);
     }
     return acct;
   }
@@ -1381,14 +1549,14 @@ var ConfidentialAirdropFactoryClient = class {
     const hasAmount = amount !== void 0;
     const hasInput = preEncrypted !== void 0;
     if (hasAmount && hasInput) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_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 chunk67OV5CX2_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 +1565,7 @@ var ConfidentialAirdropFactoryClient = class {
     if (hasInput) return preEncrypted;
     const enc = encryptor ?? resolveEncryptor(this.encryptor);
     if (!enc) {
-      throw new chunk56UI7LUR_cjs.MissingEncryptorError("encryptAmount", {
+      throw new chunk67OV5CX2_cjs.MissingEncryptorError("encryptAmount", {
         hint: "Pass `encryptor` to the call or the client config (eager or lazy factory)."
       });
     }
@@ -1426,7 +1594,7 @@ var ConfidentialAirdropFactoryClient = class {
     }
   }
   #mapRevert(method, err, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunkKLKI352M_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: confidentialAirdropFactoryAbi,
@@ -1454,7 +1622,7 @@ var ConfidentialAirdropFactoryClient = class {
         ...value !== void 0 ? { value } : {}
       });
     } catch (err) {
-      if (chunkVDXVNZCO_cjs.isContractRevert(err)) {
+      if (chunkKLKI352M_cjs.isContractRevert(err)) {
         throw this.#mapRevert(method, err, accountAddress(account));
       }
     }
@@ -1472,6 +1640,7 @@ var ConfidentialAirdropFactoryClient = class {
 function createConfidentialAirdropFactoryClient(config) {
   return new ConfidentialAirdropFactoryClient(config);
 }
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 function accountAddress(account) {
   return typeof account === "string" ? account : account.address;
 }

package/dist/{chunk-W7JHOK7G.cjs → chunk-V2PXZVBF.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkSAGJIEQK_cjs = require('./chunk-SAGJIEQK.cjs');
+var chunkC7BRZXJA_cjs = require('./chunk-C7BRZXJA.cjs');
 
 // src/fhe-vesting/advanced/factory-advanced.ts
-var ConfidentialVestingFactoryAdvancedClient = class extends chunkSAGJIEQK_cjs.ConfidentialVestingFactoryClient {
+var ConfidentialVestingFactoryAdvancedClient = class extends chunkC7BRZXJA_cjs.ConfidentialVestingFactoryClient {
   /**
    * Compute the deterministic CREATE2 clone address as the factory would have
    * computed it at `args.blockNumber`.
@@ -20,7 +20,7 @@ var ConfidentialVestingFactoryAdvancedClient = class extends chunkSAGJIEQK_cjs.C
     if (hasOptions) {
       return this.publicClient.readContract({
         address: this.address,
-        abi: chunkSAGJIEQK_cjs.confidentialVestingFactoryAbi,
+        abi: chunkC7BRZXJA_cjs.confidentialVestingFactoryAbi,
         functionName: "predictManagerAddressWithOptions",
         args: [
           args.token,
@@ -34,7 +34,7 @@ var ConfidentialVestingFactoryAdvancedClient = class extends chunkSAGJIEQK_cjs.C
     }
     return this.publicClient.readContract({
       address: this.address,
-      abi: chunkSAGJIEQK_cjs.confidentialVestingFactoryAbi,
+      abi: chunkC7BRZXJA_cjs.confidentialVestingFactoryAbi,
       functionName: "predictManagerAddress",
       args: [args.token, args.userSalt, args.deployer],
       blockNumber: args.blockNumber