@tokenops/sdk 1.1.1 → 1.6.0

package/dist/{chunk-OYLZEEHF.cjs → chunk-BK7YIVLK.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkNS44KBV5_cjs = require('./chunk-NS44KBV5.cjs');
-var chunk5SGMJADP_cjs = require('./chunk-5SGMJADP.cjs');
-var chunkQ7ARQSUH_cjs = require('./chunk-Q7ARQSUH.cjs');
-var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
-var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.cjs');
+var chunkUJS4N2XM_cjs = require('./chunk-UJS4N2XM.cjs');
+var chunkBD4LZBVF_cjs = require('./chunk-BD4LZBVF.cjs');
+var chunkSYHNZSZZ_cjs = require('./chunk-SYHNZSZZ.cjs');
+var chunkFWHYQZ5E_cjs = require('./chunk-FWHYQZ5E.cjs');
+var chunk43RFBQ73_cjs = require('./chunk-43RFBQ73.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/manager.ts
@@ -988,81 +988,9 @@ var confidentialVestingManagerAbi = [
     type: "function"
   }
 ];
-function resolveEncryptor(source) {
-  if (source === void 0) return void 0;
-  return typeof source === "function" ? source() : source;
-}
-var MAX_UINT64 = (1n << 64n) - 1n;
-function assertUint64(value, label) {
-  if (value < 0n || value > MAX_UINT64) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-      method: "encryptUint64",
-      argument: label,
-      reason: `does not fit in uint64 (0..2^64-1)`,
-      value
-    });
-  }
-}
-async function encryptUint64({
-  encryptor,
-  contractAddress,
-  userAddress,
-  value
-}) {
-  assertUint64(value, "value");
-  const { handles, inputProof } = await encryptor.encrypt({
-    values: [{ value, type: "euint64" }],
-    contractAddress,
-    userAddress
-  });
-  if (handles.length !== 1) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-      method: "encryptUint64",
-      argument: "handles",
-      reason: `expected 1 handle, got ${handles.length}`,
-      value: handles.length
-    });
-  }
-  return {
-    handle: chunk66IHPTOK_cjs.asEncryptedHandle(viem.bytesToHex(handles[0])),
-    inputProof: chunk66IHPTOK_cjs.asExternalInputProof(viem.bytesToHex(inputProof))
-  };
-}
-async function encryptUint64Batch({
-  encryptor,
-  contractAddress,
-  userAddress,
-  values
-}) {
-  if (values.length === 0) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-      method: "encryptUint64Batch",
-      argument: "values",
-      reason: "must be non-empty"
-    });
-  }
-  values.forEach((v, i) => assertUint64(v, `values[${i}]`));
-  const { handles, inputProof } = await encryptor.encrypt({
-    values: values.map((value) => ({ value, type: "euint64" })),
-    contractAddress,
-    userAddress
-  });
-  if (handles.length !== values.length) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-      method: "encryptUint64Batch",
-      argument: "handles",
-      reason: `expected ${values.length} handles, got ${handles.length}`,
-      value: handles.length
-    });
-  }
-  return {
-    handles: handles.map((h) => chunk66IHPTOK_cjs.asEncryptedHandle(viem.bytesToHex(h))),
-    inputProof: chunk66IHPTOK_cjs.asExternalInputProof(viem.bytesToHex(inputProof))
-  };
-}
 
 // src/fhe-vesting/errors.ts
-var VestingNotFoundError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingNotFoundError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "VestingNotFoundError";
   constructor(args) {
     super(`${args.method}: no vesting schedule found for ${args.vestingId}.`, {
@@ -1076,7 +1004,7 @@ var VestingNotFoundError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var NotVestingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var NotVestingRecipientError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "NotVestingRecipientError";
   constructor(args) {
     super(`${args.method}: caller is not the recipient of vesting ${args.vestingId}.`, {
@@ -1092,7 +1020,7 @@ var NotVestingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError
     });
   }
 };
-var ClaimLockedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var ClaimLockedError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "ClaimLockedError";
   constructor(args) {
     const detail = args.unlocksAt !== void 0 ? ` Unlocks at unix timestamp ${args.unlocksAt}.` : "";
@@ -1108,7 +1036,7 @@ var ClaimLockedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var VestingRevokedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingRevokedError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "VestingRevokedError";
   constructor(args) {
     const detail = args.revokedAt !== void 0 ? ` at unix timestamp ${args.revokedAt}` : "";
@@ -1124,7 +1052,7 @@ var VestingRevokedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var VestingNotRevocableError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingNotRevocableError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "VestingNotRevocableError";
   constructor(args) {
     super(`${args.method}: vesting ${args.vestingId} was created as non-revocable.`, {
@@ -1138,7 +1066,7 @@ var VestingNotRevocableError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError
     });
   }
 };
-var VestingExpiredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingExpiredError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "VestingExpiredError";
   constructor(args) {
     super(`${args.method}: vesting ${args.vestingId} has already ended.`, {
@@ -1153,7 +1081,7 @@ var VestingExpiredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var TransferAlreadyPendingError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var TransferAlreadyPendingError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "TransferAlreadyPendingError";
   constructor(args) {
     super(`${args.method}: a transfer is already pending for vesting ${args.vestingId}.`, {
@@ -1169,7 +1097,7 @@ var TransferAlreadyPendingError = class extends chunk56UI7LUR_cjs.TokenOpsSdkErr
     });
   }
 };
-var NoPendingTransferError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var NoPendingTransferError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "NoPendingTransferError";
   constructor(args) {
     super(`${args.method}: no pending transfer for vesting ${args.vestingId}.`, {
@@ -1183,7 +1111,7 @@ var NoPendingTransferError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var NotPendingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var NotPendingRecipientError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "NotPendingRecipientError";
   constructor(args) {
     super(`${args.method}: caller is not the pending recipient of vesting ${args.vestingId}.`, {
@@ -1199,7 +1127,7 @@ var NotPendingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError
     });
   }
 };
-var TransferExpiredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var TransferExpiredError = class extends chunk2RNW4MIJ_cjs.TokenOpsSdkError {
   name = "TransferExpiredError";
   constructor(args) {
     super(`${args.method}: pending transfer for vesting ${args.vestingId} has expired.`, {
@@ -1252,7 +1180,7 @@ var ConfidentialVestingManagerClient = class {
   constructor(config) {
     this.publicClient = config.publicClient;
     this.walletClient = config.walletClient;
-    this.address = chunkCQIPRNS7_cjs.normaliseAddress(config.address);
+    this.address = chunkVR3FREBX_cjs.normaliseAddress(config.address);
     this.encryptor = config.encryptor;
     this.#telemetry = config.telemetry;
     this.#aclAddressOverride = config.aclAddress;
@@ -1261,8 +1189,8 @@ var ConfidentialVestingManagerClient = class {
       surface: "manager",
       chainId: chainIdForInit ?? null,
       hasWallet: !!this.walletClient,
-      aclResolved: !!config.aclAddress || chainIdForInit !== void 0 && !!chunkQ7ARQSUH_cjs.getFhevmAclAddress(chainIdForInit),
-      sdkVersion: chunkVDXVNZCO_cjs.SDK_VERSION
+      aclResolved: !!config.aclAddress || chainIdForInit !== void 0 && !!chunkSYHNZSZZ_cjs.getFhevmAclAddress(chainIdForInit),
+      sdkVersion: chunk43RFBQ73_cjs.SDK_VERSION
     });
   }
   /**
@@ -1273,7 +1201,7 @@ var ConfidentialVestingManagerClient = class {
    */
   get aclAddress() {
     if (this.#cachedAclAddress) return this.#cachedAclAddress;
-    this.#cachedAclAddress = this.#aclAddressOverride ?? chunkQ7ARQSUH_cjs.requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialVestingManagerClient");
+    this.#cachedAclAddress = this.#aclAddressOverride ?? chunkSYHNZSZZ_cjs.requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialVestingManagerClient");
     return this.#cachedAclAddress;
   }
   // ============================================================
@@ -1516,11 +1444,11 @@ var ConfidentialVestingManagerClient = class {
       );
     }
     if (paused) {
-      blockers.push(new chunk56UI7LUR_cjs.PausedError({ method: "claim", contractAddress: this.address }));
+      blockers.push(new chunk2RNW4MIJ_cjs.PausedError({ method: "claim", contractAddress: this.address }));
     }
     if (feeInfo.feeType === 0 /* Gas */ && callerBalance < feeInfo.fee) {
       blockers.push(
-        new chunk56UI7LUR_cjs.InsufficientFeeError({
+        new chunk2RNW4MIJ_cjs.InsufficientFeeError({
           method: "claim",
           contractAddress: this.address,
           feeKind: "gas",
@@ -1531,6 +1459,118 @@ var ConfidentialVestingManagerClient = class {
     }
     return { ready: blockers.length === 0, blockers };
   }
+  /**
+   * Read-only preflight for {@link createVesting} / {@link batchCreateVesting}.
+   * 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: `token`, `hasCreatorRole`, `isOperatorSet`, `ready`,
+   * `blockers`, `blockerErrors` — see {@link CreateVestingPreflightReport} for
+   * the meaning of each.
+   *
+   * Checks performed (all read-only, no gas):
+   * - Structural `params` validation mirroring the contract's
+   *   `_validateVestingParams` (`InvalidArgumentError` blockers): recipient is
+   *   a checksummed non-zero address, `startTimestamp < endTimestamp`, cliff
+   *   within the window, `initialUnlockBps + cliffAmountBps ≤ 10000`.
+   * - Role: creator holds `VESTING_CREATOR_ROLE`
+   *   ({@link AccessDeniedError} blocker).
+   * - Operator: creator has approved this manager as an ERC-7984 operator on
+   *   the distribution token, required for the manager's
+   *   `confidentialTransferFrom` pull ({@link OperatorNotApprovedError} blocker).
+   *   If the bound `token` does not implement the ERC-7984 `isOperator`
+   *   view — a revert, or a zero-data response for an EOA / undeployed
+   *   address — operator status is undetermined rather than the call
+   *   throwing: `isOperatorSet` reports `false` and the read failure becomes
+   *   an {@link InvalidArgumentError} blocker on `token` instead (TOK-436).
+   *
+   * **Not preflight-detectable — read before trusting `ready: true`:**
+   * - The creator's confidential token balance is an encrypted `euint64` the
+   *   SDK cannot read in plaintext. An underfunded create does **not** revert:
+   *   the contract's all-or-nothing `FHE.select` pattern silently zeroes the
+   *   vesting amounts instead. Confirm the creator's balance covers the total
+   *   before submitting.
+   * - `batchCreateVesting` additionally enforces `items.length ≤ maxBatchSize()`
+   *   on-chain; check {@link maxBatchSize} for batches.
+   *
+   * Pausing the manager does NOT block vesting creation (only claims), so
+   * paused state is intentionally not a blocker here.
+   *
+   * @param args.params The vesting schedule parameters to validate.
+   * @param args.creator The address that will send the create transaction.
+   * @returns A {@link CreateVestingPreflightReport}.
+   */
+  async preflightCreateVesting(args) {
+    const blockers = [];
+    const blockerErrors = [];
+    const pushBlocker = (err) => {
+      blockerErrors.push(err);
+      blockers.push(err.message);
+    };
+    for (const err of collectVestingParamsErrors(args.params, "createVesting")) {
+      pushBlocker(err);
+    }
+    const [token, creatorRole] = await Promise.all([
+      this.token(),
+      this.#read("VESTING_CREATOR_ROLE")
+    ]);
+    const [hasCreatorRole, operatorRead] = await Promise.all([
+      this.hasRole(creatorRole, args.creator),
+      this.publicClient.readContract({
+        address: token,
+        abi: chunkFWHYQZ5E_cjs.erc7984OperatorAbi,
+        functionName: "isOperator",
+        args: [args.creator, this.address]
+      }).then((v) => ({ ok: true, value: v })).catch((err) => {
+        if (isNotErc7984Failure(err)) return { ok: false, err };
+        throw err;
+      })
+    ]);
+    const isOperatorSet = operatorRead.ok ? operatorRead.value : false;
+    if (!hasCreatorRole) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.AccessDeniedError({
+          method: "createVesting",
+          contractAddress: this.address,
+          account: args.creator,
+          role: creatorRole
+        })
+      );
+    }
+    if (!operatorRead.ok) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+          method: "createVesting",
+          argument: "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: token
+        })
+      );
+    } else if (!isOperatorSet) {
+      pushBlocker(
+        new chunk2RNW4MIJ_cjs.OperatorNotApprovedError({
+          method: "createVesting",
+          contractAddress: this.address,
+          tokenAddress: token,
+          holder: args.creator,
+          spender: this.address
+        })
+      );
+    }
+    return {
+      token,
+      hasCreatorRole,
+      isOperatorSet,
+      ready: blockers.length === 0,
+      blockers,
+      blockerErrors
+    };
+  }
   // ============================================================
   //                     ENCRYPTED VIEWS (TX)
   // ============================================================
@@ -1596,6 +1636,21 @@ var ConfidentialVestingManagerClient = class {
    *
    * Pass `encryptedInput` to bypass the encryptor when you manage encryption yourself.
    *
+   * **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.
+   *
+   * Prerequisites: caller must have set this manager as an operator on the
+   * token: `token.setOperator(managerAddress, deadline)` — or use
+   * `ensureOperator()` from `@tokenops/sdk/fhe`. Skipping it fails with
+   * {@link OperatorNotApprovedError} (the SDK's mapping of the on-chain
+   * `ERC7984UnauthorizedSpender` revert, whose message is the canonical
+   * `OPERATOR_NOT_APPROVED_REMEDIATION` copy).
+   *
    * @returns Transaction hash. Parse the `VestingCreated` event to extract the `vestingId`.
    * @example
    * const hash = await manager.createVesting({
@@ -1637,12 +1692,27 @@ var ConfidentialVestingManagerClient = class {
    *
    * Respects `maxBatchSize` — check before calling on large lists.
    *
+   * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
+   *
+   * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
+   * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
+   * ERC-20. Amount parameters are base units of the token's actual decimals:
+   * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
+   * transparent TTT test token uses 18 decimals.
+   *
+   * Prerequisites: caller must have set this manager as an operator on the
+   * token: `token.setOperator(managerAddress, deadline)` — or use
+   * `ensureOperator()` from `@tokenops/sdk/fhe`. Skipping it fails with
+   * {@link OperatorNotApprovedError} (the SDK's mapping of the on-chain
+   * `ERC7984UnauthorizedSpender` revert, whose message is the canonical
+   * `OPERATOR_NOT_APPROVED_REMEDIATION` copy).
+   *
    * @returns Transaction hash.
    */
   async batchCreateVesting(args) {
     return chunkVJKZWYYJ_cjs.withTelemetry(this.#telemetry, "fhe-vesting.manager.batchCreateVesting", async () => {
       if (args.items.length === 0) {
-        throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+        throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
           method: "batchCreateVesting",
           argument: "items",
           reason: "must be non-empty"
@@ -1653,21 +1723,21 @@ var ConfidentialVestingManagerClient = class {
       );
       const wallet = this.#requireWallet("batchCreateVesting");
       const account = this.#resolveAccount(wallet, args.account, "batchCreateVesting");
-      const encryptor = args.encryptor ?? resolveEncryptor(this.encryptor);
+      const encryptor = args.encryptor ?? chunkBD4LZBVF_cjs.resolveEncryptor(this.encryptor);
       if (!encryptor) {
-        throw new chunk56UI7LUR_cjs.MissingEncryptorError("batchCreateVesting");
+        throw new chunk2RNW4MIJ_cjs.MissingEncryptorError("batchCreateVesting");
       }
       const userAddress = accountAddress(account);
       let batch;
       try {
-        batch = await encryptUint64Batch({
+        batch = await chunkBD4LZBVF_cjs.encryptUint64Batch({
           encryptor,
           contractAddress: this.address,
           userAddress,
           values: args.items.map((it) => it.amount)
         });
       } catch (err) {
-        throw chunkNS44KBV5_cjs.mapZamaError(err, { method: "batchCreateVesting", operation: "encrypt" });
+        throw chunkUJS4N2XM_cjs.mapZamaError(err, { method: "batchCreateVesting", operation: "encrypt" });
       }
       try {
         return await wallet.writeContract({
@@ -1687,6 +1757,9 @@ var ConfidentialVestingManagerClient = class {
   /**
    * Claim all currently vested tokens for `vestingId`.
    * For `FeeType.Gas` managers, pass `value` (gas fee in wei from `getFeeInfo()`).
+   *
+   * **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.
+   *
    * @param args Discriminated by `feeType`: pass `{ feeType, vestingId, value }` for Gas, `{ feeType, vestingId }` for DistributionToken.
    * @returns Transaction hash.
    * @example
@@ -1715,6 +1788,9 @@ var ConfidentialVestingManagerClient = class {
   /**
    * Admin variant of `claim` — callable by the manager admin on behalf of any recipient.
    * Useful for gas-sponsored claim flows. Same fee rules as `claim`.
+   *
+   * **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.
+   *
    * @param args Same discriminated union as `claim`.
    * @returns Transaction hash.
    */
@@ -1743,6 +1819,15 @@ var ConfidentialVestingManagerClient = class {
   /**
    * Claim a specific encrypted amount from a vesting schedule rather than the full claimable balance.
    * The SDK encrypts `amount` — pass plaintext. Alternatively pass `encryptedInput` to bypass encryption.
+   *
+   * **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.
+   *
    * @param args Includes `vestingId`, `amount` or `encryptedInput`, and optional `value` for Gas-fee managers.
    * @returns Transaction hash.
    */
@@ -1777,6 +1862,15 @@ var ConfidentialVestingManagerClient = class {
   }
   /**
    * Admin variant of `partialClaim` — callable by the manager admin on behalf of any recipient.
+   *
+   * **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.
+   *
    * @param args Same as `partialClaim`.
    * @returns Transaction hash.
    */
@@ -1827,7 +1921,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async batchRevokeVesting(vestingIds, account) {
     if (vestingIds.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "batchRevokeVesting",
         argument: "vestingIds",
         reason: "must be non-empty"
@@ -1883,7 +1977,7 @@ var ConfidentialVestingManagerClient = class {
   async splitVesting(args) {
     const wallet = this.#requireWallet("splitVesting");
     const account = this.#resolveAccount(wallet, args.account, "splitVesting");
-    const { numerator, denominator } = args.preScaled ? { numerator: args.numerator, denominator: args.denominator } : chunk5SGMJADP_cjs.scaleRatio({
+    const { numerator, denominator } = args.preScaled ? { numerator: args.numerator, denominator: args.denominator } : chunkBD4LZBVF_cjs.scaleRatio({
       numerator: args.numerator,
       denominator: args.denominator,
       // The encrypted numerator is submitted via `encryptUint64`, so
@@ -1893,7 +1987,7 @@ var ConfidentialVestingManagerClient = class {
       width: "uint64"
     });
     if (denominator < 10000n) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "splitVesting",
         argument: "denominator",
         reason: "must be \u2265 10000 (the contract's MIN_SPLIT_DENOMINATOR floor)",
@@ -1901,7 +1995,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (args.newRecipient === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "splitVesting",
         argument: "newRecipient",
         reason: "must not be the zero address"
@@ -1941,7 +2035,7 @@ var ConfidentialVestingManagerClient = class {
       (ev) => ev.args.originalVestingId.toLowerCase() === args.vestingId.toLowerCase() && ev.args.newRecipient.toLowerCase() === args.newRecipient.toLowerCase()
     );
     if (matches.length === 0) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventNotFoundError({
+      throw new chunk2RNW4MIJ_cjs.ReceiptEventNotFoundError({
         method: "splitVesting",
         eventName: "VestingSplit",
         contractAddress: this.address,
@@ -1950,7 +2044,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (matches.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk2RNW4MIJ_cjs.ReceiptEventAmbiguousError({
         method: "splitVesting",
         eventName: "VestingSplit",
         contractAddress: this.address,
@@ -1971,7 +2065,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async initiateVestingTransfer(args) {
     if (!viem.isAddress(args.newRecipient, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "initiateVestingTransfer",
         argument: "newRecipient",
         reason: "must be a valid EIP-55 checksummed address",
@@ -1979,14 +2073,14 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (args.newRecipient === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "initiateVestingTransfer",
         argument: "newRecipient",
         reason: "must not be the zero address"
       });
     }
     if (args.transferDurationSeconds <= 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "initiateVestingTransfer",
         argument: "transferDurationSeconds",
         reason: "must be > 0",
@@ -2025,7 +2119,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async directVestingTransfer(vestingId, newOwner, account) {
     if (!viem.isAddress(newOwner, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "directVestingTransfer",
         argument: "newOwner",
         reason: "must be a valid EIP-55 checksummed address",
@@ -2033,7 +2127,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (newOwner === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "directVestingTransfer",
         argument: "newOwner",
         reason: "must not be the zero address"
@@ -2073,14 +2167,14 @@ var ConfidentialVestingManagerClient = class {
    */
   async batchDiscloseToParty(args) {
     if (args.vestingIds.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "batchDiscloseToParty",
         argument: "vestingIds",
         reason: "must be non-empty"
       });
     }
     if (args.vestingIds.length !== args.disclosureTypes.length) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "batchDiscloseToParty",
         argument: "disclosureTypes",
         reason: `length mismatch: vestingIds=${args.vestingIds.length}, disclosureTypes=${args.disclosureTypes.length}`
@@ -2113,14 +2207,14 @@ var ConfidentialVestingManagerClient = class {
    */
   async adminBatchDiscloseToParty(args) {
     if (args.vestingIds.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "adminBatchDiscloseToParty",
         argument: "vestingIds",
         reason: "must be non-empty"
       });
     }
     if (args.vestingIds.length !== args.disclosureTypes.length) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "adminBatchDiscloseToParty",
         argument: "disclosureTypes",
         reason: `length mismatch: vestingIds=${args.vestingIds.length}, disclosureTypes=${args.disclosureTypes.length}`
@@ -2152,7 +2246,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async batchDiscloseHandlesToParty(handles, party, account) {
     if (handles.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "batchDiscloseHandlesToParty",
         argument: "handles",
         reason: "must be non-empty"
@@ -2166,6 +2260,13 @@ var ConfidentialVestingManagerClient = class {
   /**
    * Withdraw a confidential token amount from the manager's balance back to the admin.
    * The SDK encrypts `amount` — pass plaintext. Alternatively pass `encryptedInput`.
+   *
+   * **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.
+   *
    * @param args `{ amount }` (plaintext, SDK encrypts) or `{ encryptedInput }` (pre-encrypted).
    * @returns Transaction hash.
    */
@@ -2222,12 +2323,19 @@ var ConfidentialVestingManagerClient = class {
   /**
    * Withdraw accumulated token fees from a `FeeType.DistributionToken` manager. Admin only.
    * The SDK encrypts `amount` — pass plaintext. Alternatively pass `encryptedInput`.
+   *
+   * **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.
+   *
    * @param args `{ to, amount }` (plaintext, SDK encrypts) or `{ to, encryptedInput }` (pre-encrypted).
    * @returns Transaction hash.
    */
   async withdrawTokenFee(args) {
     if (args.to === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: "withdrawTokenFee",
         argument: "to",
         reason: "must not be the zero address"
@@ -2392,33 +2500,33 @@ var ConfidentialVestingManagerClient = class {
   // ============================================================
   #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;
   }
   async #encryptUint64(value, encryptor, account) {
-    const enc = encryptor ?? resolveEncryptor(this.encryptor);
+    const enc = encryptor ?? chunkBD4LZBVF_cjs.resolveEncryptor(this.encryptor);
     if (!enc) {
-      throw new chunk56UI7LUR_cjs.MissingEncryptorError("encryptUint64", {
+      throw new chunk2RNW4MIJ_cjs.MissingEncryptorError("encryptUint64", {
         hint: "Pass `encryptor` to the call or the client config (eager or lazy factory)."
       });
     }
     try {
-      return await encryptUint64({
+      return await chunkBD4LZBVF_cjs.encryptUint64({
         encryptor: enc,
         contractAddress: this.address,
         userAddress: accountAddress(account),
         value
       });
     } catch (err) {
-      throw chunkNS44KBV5_cjs.mapZamaError(err, { method: "encryptUint64", operation: "encrypt" });
+      throw chunkUJS4N2XM_cjs.mapZamaError(err, { method: "encryptUint64", operation: "encrypt" });
     }
   }
   /**
@@ -2432,14 +2540,14 @@ var ConfidentialVestingManagerClient = class {
     const hasAmount = args.amount !== void 0;
     const hasInput = args.encryptedInput !== void 0;
     if (hasAmount && hasInput) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: args.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: args.method,
         argument: "amount/encryptedInput",
         reason: "exactly one of `amount` (plaintext, SDK encrypts) or `encryptedInput` (pre-encrypted) must be supplied \u2014 got neither"
@@ -2455,7 +2563,7 @@ var ConfidentialVestingManagerClient = class {
    * the offending schedule id in its context.
    */
   #mapRevert(method, err, productContext, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunk43RFBQ73_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: confidentialVestingManagerAbi,
@@ -2501,7 +2609,7 @@ var ConfidentialVestingManagerClient = class {
         ...value !== void 0 ? { value } : {}
       });
     } catch (err) {
-      if (chunkVDXVNZCO_cjs.isContractRevert(err)) {
+      if (chunk43RFBQ73_cjs.isContractRevert(err)) {
         throw this.#mapRevert(method, err, productContext, accountAddress(account));
       }
     }
@@ -2514,7 +2622,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async #discloseSingleWithReceipt(input) {
     if (!viem.isAddress(input.party, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: input.functionName,
         argument: "party",
         reason: "must be a valid EIP-55 checksummed address",
@@ -2551,7 +2659,7 @@ var ConfidentialVestingManagerClient = class {
       (ev) => ev.args.vestingId.toLowerCase() === input.vestingId.toLowerCase() && ev.args.discloser.toLowerCase() === callerAddress && ev.args.party.toLowerCase() === input.party.toLowerCase()
     );
     if (matches.length === 0) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventNotFoundError({
+      throw new chunk2RNW4MIJ_cjs.ReceiptEventNotFoundError({
         method: input.functionName,
         eventName: "AmountDisclosed",
         contractAddress: this.address,
@@ -2560,7 +2668,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (matches.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk2RNW4MIJ_cjs.ReceiptEventAmbiguousError({
         method: input.functionName,
         eventName: "AmountDisclosed",
         contractAddress: this.address,
@@ -2577,7 +2685,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async #discloseBatchWithReceipt(input) {
     if (!viem.isAddress(input.party, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk2RNW4MIJ_cjs.InvalidArgumentError({
         method: input.functionName,
         argument: "party",
         reason: "must be a valid EIP-55 checksummed address",
@@ -2616,7 +2724,7 @@ var ConfidentialVestingManagerClient = class {
     for (const id of input.vestingIds) {
       const handle = byVestingId.get(id.toLowerCase());
       if (handle === void 0) {
-        throw new chunk56UI7LUR_cjs.ReceiptEventNotFoundError({
+        throw new chunk2RNW4MIJ_cjs.ReceiptEventNotFoundError({
           method: input.functionName,
           eventName: "AmountDisclosed",
           contractAddress: this.address,
@@ -2635,45 +2743,8 @@ var ConfidentialVestingManagerClient = class {
    * than wait for the on-chain revert.
    */
   #validateVestingParams(params, where) {
-    if (!viem.isAddress(params.recipient, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-        method: where,
-        argument: "recipient",
-        reason: "must be a valid EIP-55 checksummed address",
-        value: params.recipient
-      });
-    }
-    if (params.recipient === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-        method: where,
-        argument: "recipient",
-        reason: "must not be the zero address"
-      });
-    }
-    if (params.startTimestamp >= params.endTimestamp) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-        method: where,
-        argument: "startTimestamp/endTimestamp",
-        reason: "startTimestamp must be strictly less than endTimestamp",
-        value: { startTimestamp: params.startTimestamp, endTimestamp: params.endTimestamp }
-      });
-    }
-    if (params.startTimestamp + params.cliffSeconds > params.endTimestamp) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-        method: where,
-        argument: "cliffSeconds",
-        reason: "cliff cannot extend past endTimestamp",
-        value: params.cliffSeconds
-      });
-    }
-    if (params.initialUnlockBps + params.cliffAmountBps > 1e4) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
-        method: where,
-        argument: "initialUnlockBps + cliffAmountBps",
-        reason: "must be \u2264 10000 (100%)",
-        value: { initialUnlockBps: params.initialUnlockBps, cliffAmountBps: params.cliffAmountBps }
-      });
-    }
+    const [first] = collectVestingParamsErrors(params, where);
+    if (first) throw first;
   }
   async #read(functionName, args = []) {
     const result = await this.publicClient.readContract({
@@ -2719,12 +2790,12 @@ var ConfidentialVestingManagerClient = class {
     const aclLogs = receipt.logs.filter(
       (log) => log.address.toLowerCase() === this.aclAddress.toLowerCase()
     );
-    const events = viem.parseEventLogs({ abi: [chunkQ7ARQSUH_cjs.ACL_ALLOWED_EVENT], logs: aclLogs });
+    const events = viem.parseEventLogs({ abi: [chunkSYHNZSZZ_cjs.ACL_ALLOWED_EVENT], logs: aclLogs });
     const granted = events.filter(
       (ev) => ev.args.account.toLowerCase() === callerAddress && ev.args.caller.toLowerCase() === this.address.toLowerCase()
     );
     if (granted.length === 0) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventNotFoundError({
+      throw new chunk2RNW4MIJ_cjs.ReceiptEventNotFoundError({
         method: functionName,
         eventName: "Allowed",
         contractAddress: this.aclAddress,
@@ -2733,7 +2804,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (granted.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk2RNW4MIJ_cjs.ReceiptEventAmbiguousError({
         method: functionName,
         eventName: "Allowed",
         contractAddress: this.aclAddress,
@@ -2741,17 +2812,74 @@ var ConfidentialVestingManagerClient = class {
         count: granted.length
       });
     }
-    const handle = chunk66IHPTOK_cjs.asEncryptedHandle(granted[0].args.handle);
-    return { handle, hash: chunk66IHPTOK_cjs.asTxHash(hash) };
+    const handle = chunk2RNW4MIJ_cjs.asEncryptedHandle(granted[0].args.handle);
+    return { handle, hash: chunk2RNW4MIJ_cjs.asTxHash(hash) };
   }
 };
 function createConfidentialVestingManagerClient(config) {
   return new ConfidentialVestingManagerClient(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;
+}
 function accountAddress(account) {
   return typeof account === "string" ? account : account.address;
 }
 var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+function collectVestingParamsErrors(params, where) {
+  const errors = [];
+  if (!viem.isAddress(params.recipient, { strict: true })) {
+    errors.push(
+      new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+        method: where,
+        argument: "recipient",
+        reason: "must be a valid EIP-55 checksummed address",
+        value: params.recipient
+      })
+    );
+  } else if (params.recipient === ZERO_ADDRESS) {
+    errors.push(
+      new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+        method: where,
+        argument: "recipient",
+        reason: "must not be the zero address"
+      })
+    );
+  }
+  if (params.startTimestamp >= params.endTimestamp) {
+    errors.push(
+      new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+        method: where,
+        argument: "startTimestamp/endTimestamp",
+        reason: "startTimestamp must be strictly less than endTimestamp",
+        value: { startTimestamp: params.startTimestamp, endTimestamp: params.endTimestamp }
+      })
+    );
+  }
+  if (params.startTimestamp < params.endTimestamp && params.startTimestamp + params.cliffSeconds > params.endTimestamp) {
+    errors.push(
+      new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+        method: where,
+        argument: "cliffSeconds",
+        reason: "cliff cannot extend past endTimestamp",
+        value: params.cliffSeconds
+      })
+    );
+  }
+  if (params.initialUnlockBps + params.cliffAmountBps > 1e4) {
+    errors.push(
+      new chunk2RNW4MIJ_cjs.InvalidArgumentError({
+        method: where,
+        argument: "initialUnlockBps + cliffAmountBps",
+        reason: "must be \u2264 10000 (100%)",
+        value: { initialUnlockBps: params.initialUnlockBps, cliffAmountBps: params.cliffAmountBps }
+      })
+    );
+  }
+  return errors;
+}
 
 exports.ClaimLockedError = ClaimLockedError;
 exports.ConfidentialVestingManagerClient = ConfidentialVestingManagerClient;
@@ -2766,6 +2894,3 @@ exports.VestingNotRevocableError = VestingNotRevocableError;
 exports.VestingRevokedError = VestingRevokedError;
 exports.confidentialVestingManagerAbi = confidentialVestingManagerAbi;
 exports.createConfidentialVestingManagerClient = createConfidentialVestingManagerClient;
-exports.encryptUint64 = encryptUint64;
-exports.encryptUint64Batch = encryptUint64Batch;
-exports.resolveEncryptor = resolveEncryptor;