@tokenops/sdk 1.1.1 → 1.5.1

package/dist/fhe/sepolia-encryptor.d.ts

@@ -5,6 +5,24 @@ import type { Encryptor } from "../fhe-vesting/encryption.js";
 export declare const SEPOLIA_CHAIN_ID: 11155111;
 /** Mainnet chain id (`1`). Same use as {@link SEPOLIA_CHAIN_ID}. */
 export declare const MAINNET_CHAIN_ID: 1;
+/**
+ * Lifecycle phase reported by the `onPhase` callback of
+ * {@link createSepoliaEncryptor} / `createSepoliaEncryptorWeb`.
+ *
+ * - `"initializing"` — the helper started constructing the underlying Zama
+ *   relayer instance (module resolution + constructor; cheap and local).
+ * - `"downloading-params"` — the relayer's real lazy initialization began:
+ *   worker bring-up plus fetching the FHE public key and public params
+ *   (several MB on a cold cache; near-instant when served from cache).
+ * - `"ready"` — initialization completed; subsequent encrypts skip the
+ *   download entirely.
+ *
+ * Phases carry **no** percentages, byte counts, or time estimates — neither
+ * `@zama-fhe/sdk@3` nor the underlying relayer SDK exposes any
+ * download-progress API, so anything finer-grained would be fabricated.
+ * If upstream later exposes real progress this union will widen.
+ */
+export type EncryptorInitPhase = "initializing" | "downloading-params" | "ready";
 /** Subset of `@zama-fhe/sdk/node`'s `GenericLogger` we accept. Mirrored
  * structurally so consumers don't need to import the optional peer dep just
  * to type-narrow a logger arg. */
@@ -69,6 +87,26 @@ export interface CreateSepoliaEncryptorOptions {
      * that want to exercise the fetch path).
      */
     fheArtifactCacheTTL?: number;
+    /**
+     * Observe the encryptor's initialization lifecycle (see
+     * {@link EncryptorInitPhase}). `RelayerNode` initializes its worker pool
+     * lazily and exposes no status events, so the phases bracket the first
+     * operation that triggers the real init:
+     *
+     * - `"initializing"` fires when this helper starts (module load +
+     *   `RelayerNode` construction).
+     * - `"downloading-params"` fires immediately before the first `encrypt`
+     *   call, which is what actually spawns the worker pool and fetches the
+     *   FHE public key + params.
+     * - `"ready"` fires once that first `encrypt` resolves. If it rejects,
+     *   `"ready"` is not fired and the next attempt re-fires
+     *   `"downloading-params"` (the underlying SDK retries init from scratch).
+     *
+     * No fake progress: no percentages, byte counts, or timers — upstream
+     * exposes no download-progress API. Callback exceptions are swallowed so
+     * a UI observer can never break encryption.
+     */
+    onPhase?: (phase: EncryptorInitPhase) => void;
 }
 /**
  * Returned by {@link createSepoliaEncryptor}. Carries the underlying

package/dist/fhe-airdrop/advanced/index.cjs

@@ -1,21 +1,22 @@
 'use strict';
 
-var chunkFPQBFIUW_cjs = require('../../chunk-FPQBFIUW.cjs');
-require('../../chunk-SYHXDHWX.cjs');
-require('../../chunk-VDXVNZCO.cjs');
-require('../../chunk-3ZRHDTEX.cjs');
-require('../../chunk-CQIPRNS7.cjs');
+var chunk4WPGQSNT_cjs = require('../../chunk-4WPGQSNT.cjs');
+require('../../chunk-TIUKIY5V.cjs');
+require('../../chunk-FWHYQZ5E.cjs');
+require('../../chunk-KLKI352M.cjs');
+require('../../chunk-PUPKNW3R.cjs');
+require('../../chunk-JK4XMMKM.cjs');
 require('../../chunk-VJKZWYYJ.cjs');
 require('../../chunk-66IHPTOK.cjs');
-require('../../chunk-56UI7LUR.cjs');
+require('../../chunk-67OV5CX2.cjs');
 
 
 
 Object.defineProperty(exports, "ConfidentialAirdropFactoryAdvancedClient", {
   enumerable: true,
-  get: function () { return chunkFPQBFIUW_cjs.ConfidentialAirdropFactoryAdvancedClient; }
+  get: function () { return chunk4WPGQSNT_cjs.ConfidentialAirdropFactoryAdvancedClient; }
 });
 Object.defineProperty(exports, "createConfidentialAirdropFactoryAdvancedClient", {
   enumerable: true,
-  get: function () { return chunkFPQBFIUW_cjs.createConfidentialAirdropFactoryAdvancedClient; }
+  get: function () { return chunk4WPGQSNT_cjs.createConfidentialAirdropFactoryAdvancedClient; }
 });

package/dist/fhe-airdrop/advanced/index.js

@@ -1,8 +1,9 @@
-export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient } from '../../chunk-JJ4R5QXF.js';
-import '../../chunk-OQZAZIAS.js';
-import '../../chunk-JFLEEXKP.js';
-import '../../chunk-M7V2EDPB.js';
-import '../../chunk-BE2AIZ3K.js';
+export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient } from '../../chunk-ODLTEGHB.js';
+import '../../chunk-DUZIIRPF.js';
+import '../../chunk-7VELUOMI.js';
+import '../../chunk-SG65XWH7.js';
+import '../../chunk-XGGTQQFH.js';
+import '../../chunk-ZA673I3O.js';
 import '../../chunk-Q2GP5UDC.js';
 import '../../chunk-KWFFIJYX.js';
-import '../../chunk-IVE3QEGD.js';
+import '../../chunk-QBJ7O2B4.js';

package/dist/fhe-airdrop/advanced/react/index.cjs

@@ -1,16 +1,17 @@
 'use strict';
 
-var chunkG7G75C46_cjs = require('../../../chunk-G7G75C46.cjs');
-require('../../../chunk-5SA2HF2W.cjs');
-var chunkFPQBFIUW_cjs = require('../../../chunk-FPQBFIUW.cjs');
-var chunkSYHXDHWX_cjs = require('../../../chunk-SYHXDHWX.cjs');
-require('../../../chunk-Q7ARQSUH.cjs');
-require('../../../chunk-VDXVNZCO.cjs');
-var chunk3ZRHDTEX_cjs = require('../../../chunk-3ZRHDTEX.cjs');
-require('../../../chunk-CQIPRNS7.cjs');
+var chunkT46YXSBP_cjs = require('../../../chunk-T46YXSBP.cjs');
+require('../../../chunk-MCRBVJGZ.cjs');
+var chunk4WPGQSNT_cjs = require('../../../chunk-4WPGQSNT.cjs');
+var chunkTIUKIY5V_cjs = require('../../../chunk-TIUKIY5V.cjs');
+require('../../../chunk-FAXIIH5R.cjs');
+require('../../../chunk-FWHYQZ5E.cjs');
+require('../../../chunk-KLKI352M.cjs');
+var chunkPUPKNW3R_cjs = require('../../../chunk-PUPKNW3R.cjs');
+require('../../../chunk-JK4XMMKM.cjs');
 require('../../../chunk-VJKZWYYJ.cjs');
 require('../../../chunk-66IHPTOK.cjs');
-require('../../../chunk-56UI7LUR.cjs');
+require('../../../chunk-67OV5CX2.cjs');
 var react = require('react');
 var reactQuery = require('@tanstack/react-query');
 var wagmi = require('wagmi');
@@ -23,22 +24,22 @@ function usePredictAirdropAddress(args = {}) {
     ...chainId !== void 0 ? { chainId } : {}
   });
   const resolvedChainId = chainId ?? resolvedPublicClient?.chain?.id;
-  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.DEPLOYED_ADDRESSES.fheAirdrop?.confidentialAirdropFactory?.[resolvedChainId] ?? void 0);
+  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.DEPLOYED_ADDRESSES.fheAirdrop?.confidentialAirdropFactory?.[resolvedChainId] ?? void 0);
   const encryptorSourceRef = react.useRef(encryptor);
   encryptorSourceRef.current = encryptor;
   const client = react.useMemo(() => {
     if (!resolvedPublicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunkFPQBFIUW_cjs.createConfidentialAirdropFactoryAdvancedClient({
+    return chunk4WPGQSNT_cjs.createConfidentialAirdropFactoryAdvancedClient({
       publicClient: resolvedPublicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
       ...resolvedChainId !== void 0 ? { chainId: resolvedChainId } : {},
-      encryptor: () => chunkSYHXDHWX_cjs.resolveEncryptor(encryptorSourceRef.current)
+      encryptor: () => chunkTIUKIY5V_cjs.resolveEncryptor(encryptorSourceRef.current)
     });
   }, [resolvedPublicClient, walletClient, resolvedAddress, resolvedChainId]);
   return reactQuery.useQuery({
-    queryKey: chunkG7G75C46_cjs.buildQueryKey(
+    queryKey: chunkT46YXSBP_cjs.buildQueryKey(
       "factory:predictAirdropAddress",
       resolvedChainId,
       resolvedAddress,

package/dist/fhe-airdrop/advanced/react/index.js

@@ -1,14 +1,15 @@
-import { buildQueryKey } from '../../../chunk-XWDVPV42.js';
-import '../../../chunk-XXXDQSHE.js';
-import { createConfidentialAirdropFactoryAdvancedClient } from '../../../chunk-JJ4R5QXF.js';
-import { resolveEncryptor } from '../../../chunk-OQZAZIAS.js';
-import '../../../chunk-FYQ2UW4T.js';
-import '../../../chunk-JFLEEXKP.js';
-import { DEPLOYED_ADDRESSES } from '../../../chunk-M7V2EDPB.js';
-import '../../../chunk-BE2AIZ3K.js';
+import { buildQueryKey } from '../../../chunk-ORFTDNFZ.js';
+import '../../../chunk-6R4KNAPK.js';
+import { createConfidentialAirdropFactoryAdvancedClient } from '../../../chunk-ODLTEGHB.js';
+import { resolveEncryptor } from '../../../chunk-DUZIIRPF.js';
+import '../../../chunk-ZWXJTBZO.js';
+import '../../../chunk-7VELUOMI.js';
+import '../../../chunk-SG65XWH7.js';
+import { DEPLOYED_ADDRESSES } from '../../../chunk-XGGTQQFH.js';
+import '../../../chunk-ZA673I3O.js';
 import '../../../chunk-Q2GP5UDC.js';
 import '../../../chunk-KWFFIJYX.js';
-import '../../../chunk-IVE3QEGD.js';
+import '../../../chunk-QBJ7O2B4.js';
 import { useRef, useMemo } from 'react';
 import { useQuery } from '@tanstack/react-query';
 import { usePublicClient, useWalletClient } from 'wagmi';

package/dist/fhe-airdrop/airdrop.d.ts

@@ -239,6 +239,8 @@ export declare class ConfidentialAirdropClient {
      * {@link signClaimAuthorization}. The signature commits to that handle, so the SDK
      * does NOT re-encrypt — submit the admin-issued payload as-is.
      *
+     * **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.
+     *
      * @returns Transaction hash.
      * @example
      * const fee = await airdrop.gasFee();

package/dist/fhe-airdrop/encryption.d.ts

@@ -71,6 +71,14 @@ export interface EncryptUint64BatchArgs {
  * `userAddress` MUST be the **recipient** (not the admin), because the contract's
  * `FHE.fromExternal` rejects proofs bound to any other address.
  *
+ * **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. `value` (and each entry of
+ * `values` in {@link encryptUint64Batch}) follows this convention when it
+ * encodes a token amount.
+ *
  * @param args Encryption request; `value` must fit in `uint64` (0 to 2^64-1).
  * @returns `{ handle: Hex, inputProof: Hex }` — pass both to the contract.
  * @example

package/dist/fhe-airdrop/factory.d.ts

@@ -2,7 +2,7 @@ import type { Account, Address, Hex, PublicClient, WalletClient } from "viem";
 import { type TxHash } from "../core/brands.js";
 import { type SdkTelemetry } from "../core/telemetry.js";
 import { type Encryptor, type EncryptorSource } from "./encryption.js";
-import type { AirdropParams, CustomFee, EncryptedInput } from "./types.js";
+import type { AirdropParams, CreateAirdropPreflightReport, CustomFee, EncryptedInput } from "./types.js";
 export interface ConfidentialAirdropFactoryClientConfig {
     publicClient: PublicClient;
     walletClient?: WalletClient;
@@ -114,6 +114,27 @@ export interface CreateAirdropResult {
     /** Address of the deployed clone, parsed from the `ConfidentialAirdropCreated` event. */
     airdrop: Address;
 }
+/** Arguments for {@link ConfidentialAirdropFactoryClient.preflightCreateAirdrop}. */
+export interface PreflightCreateAirdropArgs {
+    /** The airdrop parameters that will be passed to the create call. */
+    params: AirdropParams;
+    /** The address that will send the create transaction (`msg.sender`). */
+    creator: Address;
+    /**
+     * The `userSalt` planned for the create call. Optional — when supplied, the
+     * preflight also predicts the CREATE2 clone address and reports whether a
+     * clone already exists there (a repeat create with the same salt reverts).
+     */
+    userSalt?: Hex;
+    /**
+     * Set `true` when the plan is `createAndFundConfidentialAirdrop` (or a
+     * follow-up `fundConfidentialAirdrop`). Funding pulls tokens from the
+     * creator via `confidentialTransferFrom`, so a missing factory-operator
+     * approval becomes a blocker. When `false`/omitted, the operator state is
+     * still reported (`isFactoryOperator`) but does not block a create-only tx.
+     */
+    funding?: boolean;
+}
 export interface PredictAirdropArgs {
     params: AirdropParams;
     userSalt: Hex;
@@ -172,6 +193,14 @@ export declare class ConfidentialAirdropFactoryClient {
      * 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.
@@ -188,6 +217,14 @@ export declare class ConfidentialAirdropFactoryClient {
      * 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.
      */
     fundConfidentialAirdrop(args: FundAirdropArgs): Promise<Hex>;
@@ -218,6 +255,14 @@ export declare class ConfidentialAirdropFactoryClient {
      * 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" })`.
@@ -268,6 +313,46 @@ export declare class ConfidentialAirdropFactoryClient {
         params: AirdropParams;
         gasFee: bigint;
     }): Promise<Hex>;
+    /**
+     * 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}.
+     */
+    preflightCreateAirdrop(args: PreflightCreateAirdropArgs): Promise<CreateAirdropPreflightReport>;
 }
 /**
  * Create a {@link ConfidentialAirdropFactoryClient}. Mirrors viem's `create*` convention.

package/dist/fhe-airdrop/index.cjs

@@ -1,69 +1,69 @@
 'use strict';
 
-var chunk5SA2HF2W_cjs = require('../chunk-5SA2HF2W.cjs');
-var chunkSYHXDHWX_cjs = require('../chunk-SYHXDHWX.cjs');
+var chunkMCRBVJGZ_cjs = require('../chunk-MCRBVJGZ.cjs');
+var chunkTIUKIY5V_cjs = require('../chunk-TIUKIY5V.cjs');
+require('../chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('../chunk-FWHYQZ5E.cjs');
-require('../chunk-Q7ARQSUH.cjs');
-require('../chunk-VDXVNZCO.cjs');
-require('../chunk-3ZRHDTEX.cjs');
-require('../chunk-CQIPRNS7.cjs');
+require('../chunk-KLKI352M.cjs');
+require('../chunk-PUPKNW3R.cjs');
+require('../chunk-JK4XMMKM.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');
 
 
 
 Object.defineProperty(exports, "AlreadyClaimedError", {
   enumerable: true,
-  get: function () { return chunk5SA2HF2W_cjs.AlreadyClaimedError; }
+  get: function () { return chunkMCRBVJGZ_cjs.AlreadyClaimedError; }
 });
 Object.defineProperty(exports, "ClaimNotStartedError", {
   enumerable: true,
-  get: function () { return chunk5SA2HF2W_cjs.ClaimNotStartedError; }
+  get: function () { return chunkMCRBVJGZ_cjs.ClaimNotStartedError; }
 });
 Object.defineProperty(exports, "ClaimWindowClosedError", {
   enumerable: true,
-  get: function () { return chunk5SA2HF2W_cjs.ClaimWindowClosedError; }
+  get: function () { return chunkMCRBVJGZ_cjs.ClaimWindowClosedError; }
 });
 Object.defineProperty(exports, "ConfidentialAirdropClient", {
   enumerable: true,
-  get: function () { return chunk5SA2HF2W_cjs.ConfidentialAirdropClient; }
+  get: function () { return chunkMCRBVJGZ_cjs.ConfidentialAirdropClient; }
 });
 Object.defineProperty(exports, "confidentialAirdropCloneableAbi", {
   enumerable: true,
-  get: function () { return chunk5SA2HF2W_cjs.confidentialAirdropCloneableAbi; }
+  get: function () { return chunkMCRBVJGZ_cjs.confidentialAirdropCloneableAbi; }
 });
 Object.defineProperty(exports, "createConfidentialAirdropClient", {
   enumerable: true,
-  get: function () { return chunk5SA2HF2W_cjs.createConfidentialAirdropClient; }
+  get: function () { return chunkMCRBVJGZ_cjs.createConfidentialAirdropClient; }
 });
 Object.defineProperty(exports, "ConfidentialAirdropFactoryClient", {
   enumerable: true,
-  get: function () { return chunkSYHXDHWX_cjs.ConfidentialAirdropFactoryClient; }
+  get: function () { return chunkTIUKIY5V_cjs.ConfidentialAirdropFactoryClient; }
 });
 Object.defineProperty(exports, "confidentialAirdropFactoryAbi", {
   enumerable: true,
-  get: function () { return chunkSYHXDHWX_cjs.confidentialAirdropFactoryAbi; }
+  get: function () { return chunkTIUKIY5V_cjs.confidentialAirdropFactoryAbi; }
 });
 Object.defineProperty(exports, "createConfidentialAirdropFactoryClient", {
   enumerable: true,
-  get: function () { return chunkSYHXDHWX_cjs.createConfidentialAirdropFactoryClient; }
+  get: function () { return chunkTIUKIY5V_cjs.createConfidentialAirdropFactoryClient; }
 });
 Object.defineProperty(exports, "encryptUint64", {
   enumerable: true,
-  get: function () { return chunkSYHXDHWX_cjs.encryptUint64; }
+  get: function () { return chunkTIUKIY5V_cjs.encryptUint64; }
 });
 Object.defineProperty(exports, "encryptUint64Batch", {
   enumerable: true,
-  get: function () { return chunkSYHXDHWX_cjs.encryptUint64Batch; }
+  get: function () { return chunkTIUKIY5V_cjs.encryptUint64Batch; }
 });
 Object.defineProperty(exports, "resolveEncryptor", {
   enumerable: true,
-  get: function () { return chunkSYHXDHWX_cjs.resolveEncryptor; }
+  get: function () { return chunkTIUKIY5V_cjs.resolveEncryptor; }
 });
 Object.defineProperty(exports, "signClaimAuthorization", {
   enumerable: true,
-  get: function () { return chunkSYHXDHWX_cjs.signClaimAuthorization; }
+  get: function () { return chunkTIUKIY5V_cjs.signClaimAuthorization; }
 });
 Object.defineProperty(exports, "erc7984OperatorAbi", {
   enumerable: true,
@@ -79,149 +79,153 @@ Object.defineProperty(exports, "asEncryptedHandle", {
 });
 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, "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; }
 });

package/dist/fhe-airdrop/index.d.cts

@@ -1,10 +1,10 @@
-export { ConfidentialAirdropFactoryClient, createConfidentialAirdropFactoryClient, type ConfidentialAirdropFactoryClientConfig, type CreateAirdropArgs, type CreateAirdropResult, type CreateAndFundAirdropArgs, type FundAirdropArgs, } from "./factory.js";
+export { ConfidentialAirdropFactoryClient, createConfidentialAirdropFactoryClient, type ConfidentialAirdropFactoryClientConfig, type CreateAirdropArgs, type CreateAirdropResult, type CreateAndFundAirdropArgs, type FundAirdropArgs, type PreflightCreateAirdropArgs, } from "./factory.js";
 export { ConfidentialAirdropClient, createConfidentialAirdropClient, type ClaimArgs, type ConfidentialAirdropClientConfig, type EncryptedViewResult, type GetClaimAmountArgs, type IsSignatureValidArgs, } from "./airdrop.js";
 export { encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization, type Encryptor, type EncryptorSource, type EncryptUint64Args, type EncryptUint64BatchArgs, type FheValueInput, } from "./encryption.js";
-export { type AirdropParams, type CustomFee, type EncryptedInput, type EncryptedInputs, } from "./types.js";
+export { type AirdropParams, type CreateAirdropPreflightReport, type CustomFee, type EncryptedInput, type EncryptedInputs, } from "./types.js";
 export { asAirdropId, type AirdropId, asEncryptedHandle, type EncryptedHandle, } from "../core/brands.js";
 export { confidentialAirdropFactoryAbi, confidentialAirdropCloneableAbi } from "./abis/index.js";
 export { erc7984OperatorAbi } from "../fhe/erc7984-abi.js";
-export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, 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, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, 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 { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError } from "./errors.js";