@tokenops/sdk 1.0.0 → 1.5.1

package/dist/{chunk-SUOG3BQS.cjs → chunk-5X5WL5CU.cjs}

@@ -1,13 +1,14 @@
 '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 chunkTEBM66WA_cjs = require('./chunk-TEBM66WA.cjs');
+var chunk2NCLOQ56_cjs = require('./chunk-2NCLOQ56.cjs');
+var chunkFAXIIH5R_cjs = require('./chunk-FAXIIH5R.cjs');
+var chunkFWHYQZ5E_cjs = require('./chunk-FWHYQZ5E.cjs');
+var chunkKLKI352M_cjs = require('./chunk-KLKI352M.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-vesting/abis/manager.ts
@@ -995,7 +996,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: `does not fit in uint64 (0..2^64-1)`,
@@ -1016,7 +1017,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}`,
@@ -1035,7 +1036,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"
@@ -1048,7 +1049,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}`,
@@ -1062,7 +1063,7 @@ async function encryptUint64Batch({
 }
 
 // src/fhe-vesting/errors.ts
-var VestingNotFoundError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingNotFoundError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "VestingNotFoundError";
   constructor(args) {
     super(`${args.method}: no vesting schedule found for ${args.vestingId}.`, {
@@ -1076,7 +1077,7 @@ var VestingNotFoundError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var NotVestingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var NotVestingRecipientError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "NotVestingRecipientError";
   constructor(args) {
     super(`${args.method}: caller is not the recipient of vesting ${args.vestingId}.`, {
@@ -1092,7 +1093,7 @@ var NotVestingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError
     });
   }
 };
-var ClaimLockedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var ClaimLockedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "ClaimLockedError";
   constructor(args) {
     const detail = args.unlocksAt !== void 0 ? ` Unlocks at unix timestamp ${args.unlocksAt}.` : "";
@@ -1108,7 +1109,7 @@ var ClaimLockedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var VestingRevokedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingRevokedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "VestingRevokedError";
   constructor(args) {
     const detail = args.revokedAt !== void 0 ? ` at unix timestamp ${args.revokedAt}` : "";
@@ -1124,7 +1125,7 @@ var VestingRevokedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var VestingNotRevocableError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingNotRevocableError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "VestingNotRevocableError";
   constructor(args) {
     super(`${args.method}: vesting ${args.vestingId} was created as non-revocable.`, {
@@ -1138,7 +1139,7 @@ var VestingNotRevocableError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError
     });
   }
 };
-var VestingExpiredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var VestingExpiredError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "VestingExpiredError";
   constructor(args) {
     super(`${args.method}: vesting ${args.vestingId} has already ended.`, {
@@ -1153,7 +1154,7 @@ var VestingExpiredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var TransferAlreadyPendingError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var TransferAlreadyPendingError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "TransferAlreadyPendingError";
   constructor(args) {
     super(`${args.method}: a transfer is already pending for vesting ${args.vestingId}.`, {
@@ -1169,7 +1170,7 @@ var TransferAlreadyPendingError = class extends chunk56UI7LUR_cjs.TokenOpsSdkErr
     });
   }
 };
-var NoPendingTransferError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var NoPendingTransferError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "NoPendingTransferError";
   constructor(args) {
     super(`${args.method}: no pending transfer for vesting ${args.vestingId}.`, {
@@ -1183,7 +1184,7 @@ var NoPendingTransferError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var NotPendingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var NotPendingRecipientError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "NotPendingRecipientError";
   constructor(args) {
     super(`${args.method}: caller is not the pending recipient of vesting ${args.vestingId}.`, {
@@ -1199,7 +1200,7 @@ var NotPendingRecipientError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError
     });
   }
 };
-var TransferExpiredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var TransferExpiredError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "TransferExpiredError";
   constructor(args) {
     super(`${args.method}: pending transfer for vesting ${args.vestingId} has expired.`, {
@@ -1252,7 +1253,7 @@ var ConfidentialVestingManagerClient = class {
   constructor(config) {
     this.publicClient = config.publicClient;
     this.walletClient = config.walletClient;
-    this.address = chunkCQIPRNS7_cjs.normaliseAddress(config.address);
+    this.address = chunkJK4XMMKM_cjs.normaliseAddress(config.address);
     this.encryptor = config.encryptor;
     this.#telemetry = config.telemetry;
     this.#aclAddressOverride = config.aclAddress;
@@ -1261,8 +1262,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 && !!chunkFAXIIH5R_cjs.getFhevmAclAddress(chainIdForInit),
+      sdkVersion: chunkKLKI352M_cjs.SDK_VERSION
     });
   }
   /**
@@ -1273,7 +1274,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 ?? chunkFAXIIH5R_cjs.requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialVestingManagerClient");
     return this.#cachedAclAddress;
   }
   // ============================================================
@@ -1400,8 +1401,7 @@ var ConfidentialVestingManagerClient = class {
    * Accepts `bigint | number` for `start` / `end` for ergonomics on read paths
    * — CI scripts typically derive these from `Number(process.env.X)` and
    * forcing bigint coercion at the call site is a pure paper cut. The
-   * underlying contract reads through unchanged (viem coerces). R22
-   * devops-integrator MINOR-4; R25 close.
+   * underlying contract reads through unchanged (viem coerces).
    */
   async getAllRecipientsSliced(start, end) {
     return this.#read("getAllRecipientsSliced", [BigInt(start), BigInt(end)]);
@@ -1517,11 +1517,11 @@ var ConfidentialVestingManagerClient = class {
       );
     }
     if (paused) {
-      blockers.push(new chunk56UI7LUR_cjs.PausedError({ method: "claim", contractAddress: this.address }));
+      blockers.push(new chunk67OV5CX2_cjs.PausedError({ method: "claim", contractAddress: this.address }));
     }
     if (feeInfo.feeType === 0 /* Gas */ && callerBalance < feeInfo.fee) {
       blockers.push(
-        new chunk56UI7LUR_cjs.InsufficientFeeError({
+        new chunk67OV5CX2_cjs.InsufficientFeeError({
           method: "claim",
           contractAddress: this.address,
           feeKind: "gas",
@@ -1532,6 +1532,100 @@ 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).
+   *
+   * **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, isOperatorSet] = await Promise.all([
+      this.hasRole(creatorRole, args.creator),
+      this.publicClient.readContract({
+        address: token,
+        abi: chunkFWHYQZ5E_cjs.erc7984OperatorAbi,
+        functionName: "isOperator",
+        args: [args.creator, this.address]
+      })
+    ]);
+    if (!hasCreatorRole) {
+      pushBlocker(
+        new chunk67OV5CX2_cjs.AccessDeniedError({
+          method: "createVesting",
+          contractAddress: this.address,
+          account: args.creator,
+          role: creatorRole
+        })
+      );
+    }
+    if (!isOperatorSet) {
+      pushBlocker(
+        new chunk67OV5CX2_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)
   // ============================================================
@@ -1597,6 +1691,14 @@ 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.
+   *
    * @returns Transaction hash. Parse the `VestingCreated` event to extract the `vestingId`.
    * @example
    * const hash = await manager.createVesting({
@@ -1638,12 +1740,20 @@ 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.
+   *
    * @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 chunk67OV5CX2_cjs.InvalidArgumentError({
           method: "batchCreateVesting",
           argument: "items",
           reason: "must be non-empty"
@@ -1656,7 +1766,7 @@ var ConfidentialVestingManagerClient = class {
       const account = this.#resolveAccount(wallet, args.account, "batchCreateVesting");
       const encryptor = args.encryptor ?? resolveEncryptor(this.encryptor);
       if (!encryptor) {
-        throw new chunk56UI7LUR_cjs.MissingEncryptorError("batchCreateVesting");
+        throw new chunk67OV5CX2_cjs.MissingEncryptorError("batchCreateVesting");
       }
       const userAddress = accountAddress(account);
       let batch;
@@ -1668,7 +1778,7 @@ var ConfidentialVestingManagerClient = class {
           values: args.items.map((it) => it.amount)
         });
       } catch (err) {
-        throw chunkNS44KBV5_cjs.mapZamaError(err, { method: "batchCreateVesting", operation: "encrypt" });
+        throw chunkTEBM66WA_cjs.mapZamaError(err, { method: "batchCreateVesting", operation: "encrypt" });
       }
       try {
         return await wallet.writeContract({
@@ -1688,6 +1798,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
@@ -1716,6 +1829,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.
    */
@@ -1744,6 +1860,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.
    */
@@ -1778,6 +1903,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.
    */
@@ -1828,7 +1962,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async batchRevokeVesting(vestingIds, account) {
     if (vestingIds.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "batchRevokeVesting",
         argument: "vestingIds",
         reason: "must be non-empty"
@@ -1884,7 +2018,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 } : chunk2NCLOQ56_cjs.scaleRatio({
       numerator: args.numerator,
       denominator: args.denominator,
       // The encrypted numerator is submitted via `encryptUint64`, so
@@ -1894,7 +2028,7 @@ var ConfidentialVestingManagerClient = class {
       width: "uint64"
     });
     if (denominator < 10000n) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "splitVesting",
         argument: "denominator",
         reason: "must be \u2265 10000 (the contract's MIN_SPLIT_DENOMINATOR floor)",
@@ -1902,7 +2036,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (args.newRecipient === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "splitVesting",
         argument: "newRecipient",
         reason: "must not be the zero address"
@@ -1942,7 +2076,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 chunk67OV5CX2_cjs.ReceiptEventNotFoundError({
         method: "splitVesting",
         eventName: "VestingSplit",
         contractAddress: this.address,
@@ -1951,7 +2085,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (matches.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk67OV5CX2_cjs.ReceiptEventAmbiguousError({
         method: "splitVesting",
         eventName: "VestingSplit",
         contractAddress: this.address,
@@ -1972,7 +2106,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async initiateVestingTransfer(args) {
     if (!viem.isAddress(args.newRecipient, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "initiateVestingTransfer",
         argument: "newRecipient",
         reason: "must be a valid EIP-55 checksummed address",
@@ -1980,14 +2114,14 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (args.newRecipient === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "initiateVestingTransfer",
         argument: "newRecipient",
         reason: "must not be the zero address"
       });
     }
     if (args.transferDurationSeconds <= 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "initiateVestingTransfer",
         argument: "transferDurationSeconds",
         reason: "must be > 0",
@@ -2026,7 +2160,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async directVestingTransfer(vestingId, newOwner, account) {
     if (!viem.isAddress(newOwner, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "directVestingTransfer",
         argument: "newOwner",
         reason: "must be a valid EIP-55 checksummed address",
@@ -2034,7 +2168,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (newOwner === ZERO_ADDRESS) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "directVestingTransfer",
         argument: "newOwner",
         reason: "must not be the zero address"
@@ -2074,14 +2208,14 @@ var ConfidentialVestingManagerClient = class {
    */
   async batchDiscloseToParty(args) {
     if (args.vestingIds.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_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 chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "batchDiscloseToParty",
         argument: "disclosureTypes",
         reason: `length mismatch: vestingIds=${args.vestingIds.length}, disclosureTypes=${args.disclosureTypes.length}`
@@ -2114,14 +2248,14 @@ var ConfidentialVestingManagerClient = class {
    */
   async adminBatchDiscloseToParty(args) {
     if (args.vestingIds.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_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 chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "adminBatchDiscloseToParty",
         argument: "disclosureTypes",
         reason: `length mismatch: vestingIds=${args.vestingIds.length}, disclosureTypes=${args.disclosureTypes.length}`
@@ -2153,7 +2287,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async batchDiscloseHandlesToParty(handles, party, account) {
     if (handles.length === 0) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "batchDiscloseHandlesToParty",
         argument: "handles",
         reason: "must be non-empty"
@@ -2167,6 +2301,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.
    */
@@ -2223,12 +2364,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 chunk67OV5CX2_cjs.InvalidArgumentError({
         method: "withdrawTokenFee",
         argument: "to",
         reason: "must not be the zero address"
@@ -2393,21 +2541,21 @@ var ConfidentialVestingManagerClient = 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;
   }
   async #encryptUint64(value, encryptor, account) {
     const enc = encryptor ?? resolveEncryptor(this.encryptor);
     if (!enc) {
-      throw new chunk56UI7LUR_cjs.MissingEncryptorError("encryptUint64", {
+      throw new chunk67OV5CX2_cjs.MissingEncryptorError("encryptUint64", {
         hint: "Pass `encryptor` to the call or the client config (eager or lazy factory)."
       });
     }
@@ -2419,7 +2567,7 @@ var ConfidentialVestingManagerClient = class {
         value
       });
     } catch (err) {
-      throw chunkNS44KBV5_cjs.mapZamaError(err, { method: "encryptUint64", operation: "encrypt" });
+      throw chunkTEBM66WA_cjs.mapZamaError(err, { method: "encryptUint64", operation: "encrypt" });
     }
   }
   /**
@@ -2433,14 +2581,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 chunk67OV5CX2_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 chunk67OV5CX2_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"
@@ -2456,7 +2604,7 @@ var ConfidentialVestingManagerClient = class {
    * the offending schedule id in its context.
    */
   #mapRevert(method, err, productContext, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunkKLKI352M_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: confidentialVestingManagerAbi,
@@ -2502,7 +2650,7 @@ var ConfidentialVestingManagerClient = class {
         ...value !== void 0 ? { value } : {}
       });
     } catch (err) {
-      if (chunkVDXVNZCO_cjs.isContractRevert(err)) {
+      if (chunkKLKI352M_cjs.isContractRevert(err)) {
         throw this.#mapRevert(method, err, productContext, accountAddress(account));
       }
     }
@@ -2515,7 +2663,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async #discloseSingleWithReceipt(input) {
     if (!viem.isAddress(input.party, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: input.functionName,
         argument: "party",
         reason: "must be a valid EIP-55 checksummed address",
@@ -2552,7 +2700,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 chunk67OV5CX2_cjs.ReceiptEventNotFoundError({
         method: input.functionName,
         eventName: "AmountDisclosed",
         contractAddress: this.address,
@@ -2561,7 +2709,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (matches.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk67OV5CX2_cjs.ReceiptEventAmbiguousError({
         method: input.functionName,
         eventName: "AmountDisclosed",
         contractAddress: this.address,
@@ -2578,7 +2726,7 @@ var ConfidentialVestingManagerClient = class {
    */
   async #discloseBatchWithReceipt(input) {
     if (!viem.isAddress(input.party, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: input.functionName,
         argument: "party",
         reason: "must be a valid EIP-55 checksummed address",
@@ -2617,7 +2765,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 chunk67OV5CX2_cjs.ReceiptEventNotFoundError({
           method: input.functionName,
           eventName: "AmountDisclosed",
           contractAddress: this.address,
@@ -2636,45 +2784,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({
@@ -2720,12 +2831,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: [chunkFAXIIH5R_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 chunk67OV5CX2_cjs.ReceiptEventNotFoundError({
         method: functionName,
         eventName: "Allowed",
         contractAddress: this.aclAddress,
@@ -2734,7 +2845,7 @@ var ConfidentialVestingManagerClient = class {
       });
     }
     if (granted.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk67OV5CX2_cjs.ReceiptEventAmbiguousError({
         method: functionName,
         eventName: "Allowed",
         contractAddress: this.aclAddress,
@@ -2753,6 +2864,58 @@ 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 chunk67OV5CX2_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 chunk67OV5CX2_cjs.InvalidArgumentError({
+        method: where,
+        argument: "recipient",
+        reason: "must not be the zero address"
+      })
+    );
+  }
+  if (params.startTimestamp >= params.endTimestamp) {
+    errors.push(
+      new chunk67OV5CX2_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 chunk67OV5CX2_cjs.InvalidArgumentError({
+        method: where,
+        argument: "cliffSeconds",
+        reason: "cliff cannot extend past endTimestamp",
+        value: params.cliffSeconds
+      })
+    );
+  }
+  if (params.initialUnlockBps + params.cliffAmountBps > 1e4) {
+    errors.push(
+      new chunk67OV5CX2_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;