@tokenops/sdk 1.1.1 → 1.5.1

package/dist/{chunk-5SA2HF2W.cjs → chunk-MCRBVJGZ.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkQ7ARQSUH_cjs = require('./chunk-Q7ARQSUH.cjs');
-var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
+var chunkFAXIIH5R_cjs = require('./chunk-FAXIIH5R.cjs');
+var chunkKLKI352M_cjs = require('./chunk-KLKI352M.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var viem = require('viem');
 
 // src/fhe-airdrop/abis/cloneable.ts
@@ -1016,7 +1016,7 @@ var confidentialAirdropCloneableAbi = [
 ];
 
 // src/fhe-airdrop/errors.ts
-var AlreadyClaimedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var AlreadyClaimedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "AlreadyClaimedError";
   constructor(args) {
     const who = args.caller ? `${args.caller}: ` : "";
@@ -1031,7 +1031,7 @@ var AlreadyClaimedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var ClaimNotStartedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var ClaimNotStartedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "ClaimNotStartedError";
   constructor(args) {
     const detail = args.startsAt !== void 0 ? ` Opens at unix timestamp ${args.startsAt}.` : "";
@@ -1046,7 +1046,7 @@ var ClaimNotStartedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     });
   }
 };
-var ClaimWindowClosedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var ClaimWindowClosedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "ClaimWindowClosedError";
   constructor(args) {
     const detail = args.endedAt !== void 0 ? ` Closed at unix timestamp ${args.endedAt}.` : "";
@@ -1081,10 +1081,10 @@ var airdropProductMapper = (name, _args, ctx) => {
     case "ECDSAInvalidSignature":
     case "ECDSAInvalidSignatureS":
     case "ECDSAInvalidSignatureLength":
-      return new chunk56UI7LUR_cjs.InvalidSignatureError(ctx);
+      return new chunk67OV5CX2_cjs.InvalidSignatureError(ctx);
     case "ZeroBalance":
     case "InsufficientBalance":
-      return CONFIDENTIAL_POOL_BALANCE_METHODS.has(ctx.method) ? new chunk56UI7LUR_cjs.InsufficientBalanceError({ ...ctx, balanceKind: "confidential" }) : void 0;
+      return CONFIDENTIAL_POOL_BALANCE_METHODS.has(ctx.method) ? new chunk67OV5CX2_cjs.InsufficientBalanceError({ ...ctx, balanceKind: "confidential" }) : void 0;
     default:
       return void 0;
   }
@@ -1107,8 +1107,8 @@ var ConfidentialAirdropClient = class {
       surface: "client",
       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
     });
   }
   /**
@@ -1119,7 +1119,7 @@ var ConfidentialAirdropClient = class {
    */
   get aclAddress() {
     if (this.#cachedAclAddress) return this.#cachedAclAddress;
-    this.#cachedAclAddress = this.#aclAddressOverride ?? chunkQ7ARQSUH_cjs.requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialAirdropClient");
+    this.#cachedAclAddress = this.#aclAddressOverride ?? chunkFAXIIH5R_cjs.requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialAirdropClient");
     return this.#cachedAclAddress;
   }
   // ============================================================
@@ -1254,7 +1254,7 @@ var ConfidentialAirdropClient = class {
         account: args.caller
       });
     } catch (err) {
-      throw chunkVDXVNZCO_cjs.mapContractRevert(err, {
+      throw chunkKLKI352M_cjs.mapContractRevert(err, {
         method: "isSignatureValid",
         contractAddress: this.address,
         abi: confidentialAirdropCloneableAbi,
@@ -1308,7 +1308,7 @@ var ConfidentialAirdropClient = class {
     ]);
     const now = Number(block.timestamp);
     if (isPaused) {
-      blockers.push(new chunk56UI7LUR_cjs.PausedError({ method: "claim", contractAddress: this.address }));
+      blockers.push(new chunk67OV5CX2_cjs.PausedError({ method: "claim", contractAddress: this.address }));
     }
     if (now < startTime) {
       blockers.push(
@@ -1339,7 +1339,7 @@ var ConfidentialAirdropClient = class {
     }
     if (callerBalance < gasFee) {
       blockers.push(
-        new chunk56UI7LUR_cjs.InsufficientFeeError({
+        new chunk67OV5CX2_cjs.InsufficientFeeError({
           method: "claim",
           contractAddress: this.address,
           feeKind: "gas",
@@ -1360,6 +1360,8 @@ var ConfidentialAirdropClient = class {
    * {@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();
@@ -1433,12 +1435,12 @@ var ConfidentialAirdropClient = 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: "getClaimAmount",
         eventName: "Allowed",
         contractAddress: this.aclAddress,
@@ -1447,7 +1449,7 @@ var ConfidentialAirdropClient = class {
       });
     }
     if (granted.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk67OV5CX2_cjs.ReceiptEventAmbiguousError({
         method: "getClaimAmount",
         eventName: "Allowed",
         contractAddress: this.aclAddress,
@@ -1535,7 +1537,7 @@ var ConfidentialAirdropClient = class {
   // ============================================================
   #requireChecksumAddress(method, argument, value) {
     if (!viem.isAddress(value, { strict: true })) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method,
         argument,
         reason: "must be a valid EIP-55 checksummed address",
@@ -1545,14 +1547,14 @@ var ConfidentialAirdropClient = 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);
     }
     if (typeof acct === "string") {
       this.#requireChecksumAddress(method, "account", acct);
@@ -1560,7 +1562,7 @@ var ConfidentialAirdropClient = class {
     return acct;
   }
   #mapRevert(method, err, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunkKLKI352M_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: confidentialAirdropCloneableAbi,
@@ -1605,7 +1607,7 @@ var ConfidentialAirdropClient = class {
         ...value !== void 0 ? { value } : {}
       });
     } catch (err) {
-      if (chunkVDXVNZCO_cjs.isContractRevert(err)) {
+      if (chunkKLKI352M_cjs.isContractRevert(err)) {
         throw this.#mapRevert(method, err, accountAddress(account));
       }
     }

package/dist/{chunk-3PQ2RFPC.js → chunk-NTZY6IB7.js}

@@ -1,7 +1,7 @@
-import { createConfidentialVestingManagerClient, resolveEncryptor } from './chunk-X56UVEXS.js';
-import { createConfidentialVestingFactoryClient } from './chunk-IR5AK5U5.js';
-import { getFheVestingFactoryAddress } from './chunk-M7V2EDPB.js';
-import { DeploymentAddressUnavailableError } from './chunk-IVE3QEGD.js';
+import { createConfidentialVestingManagerClient, resolveEncryptor } from './chunk-IXLO7GO5.js';
+import { createConfidentialVestingFactoryClient } from './chunk-OXTLPTO3.js';
+import { getFheVestingFactoryAddress } from './chunk-XGGTQQFH.js';
+import { DeploymentAddressUnavailableError } from './chunk-QBJ7O2B4.js';
 import { useMemo, useRef, useEffect } from 'react';
 import { usePublicClient, useWalletClient } from 'wagmi';
 

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

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

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

@@ -1,7 +1,7 @@
-import { createConfidentialAirdropClient } from './chunk-XXXDQSHE.js';
-import { createConfidentialAirdropFactoryClient, resolveEncryptor } from './chunk-OQZAZIAS.js';
-import { getFheAirdropFactoryAddress } from './chunk-M7V2EDPB.js';
-import { DeploymentAddressUnavailableError } from './chunk-IVE3QEGD.js';
+import { createConfidentialAirdropClient } from './chunk-6R4KNAPK.js';
+import { createConfidentialAirdropFactoryClient, resolveEncryptor } from './chunk-DUZIIRPF.js';
+import { getFheAirdropFactoryAddress } from './chunk-XGGTQQFH.js';
+import { DeploymentAddressUnavailableError } from './chunk-QBJ7O2B4.js';
 import { useRef, useMemo } from 'react';
 import { usePublicClient, useWalletClient } from 'wagmi';
 

package/dist/{chunk-IR5AK5U5.js → chunk-OXTLPTO3.js}

@@ -1,9 +1,9 @@
-import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-JFLEEXKP.js';
-import { getFheVestingFactoryAddress } from './chunk-M7V2EDPB.js';
-import { normaliseAddress } from './chunk-BE2AIZ3K.js';
+import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-SG65XWH7.js';
+import { getFheVestingFactoryAddress } from './chunk-XGGTQQFH.js';
+import { normaliseAddress } from './chunk-ZA673I3O.js';
 import { withTelemetry } from './chunk-Q2GP5UDC.js';
 import { asTxHash } from './chunk-KWFFIJYX.js';
-import { DeploymentAddressUnavailableError, TokenOpsSdkError, MissingWalletClientError, MissingAccountError } from './chunk-IVE3QEGD.js';
+import { DeploymentAddressUnavailableError, TokenOpsSdkError, MissingWalletClientError, MissingAccountError } from './chunk-QBJ7O2B4.js';
 import { parseEventLogs } from 'viem';
 
 // src/fhe-vesting/abis/factory.ts

package/dist/{chunk-23F7JIK5.cjs → chunk-PFXURMBZ.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkNS44KBV5_cjs = require('./chunk-NS44KBV5.cjs');
-var chunkQ7ARQSUH_cjs = require('./chunk-Q7ARQSUH.cjs');
-var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
-var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.cjs');
+var chunkTEBM66WA_cjs = require('./chunk-TEBM66WA.cjs');
+var chunkFAXIIH5R_cjs = require('./chunk-FAXIIH5R.cjs');
+var chunkKLKI352M_cjs = require('./chunk-KLKI352M.cjs');
+var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
+var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var viem = require('viem');
 
 // src/fhe-disperse/abis/singleton.ts
@@ -1689,7 +1689,7 @@ function resolveEncryptor(source) {
 var MAX_UINT64 = (1n << 64n) - 1n;
 function assertUint64(value, label) {
   if (value < 0n || value > MAX_UINT64) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method: "encryptUint64",
       argument: label,
       reason: "exceeds uint64 range (0..2^64-1)",
@@ -1710,7 +1710,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}`,
@@ -1729,7 +1729,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"
@@ -1742,7 +1742,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}`,
@@ -1756,7 +1756,7 @@ async function encryptUint64Batch({
 }
 
 // src/fhe-disperse/errors.ts
-var NotRegisteredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var NotRegisteredError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "NotRegisteredError";
   constructor(args) {
     super(
@@ -1773,7 +1773,7 @@ var NotRegisteredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
     );
   }
 };
-var AlreadyRegisteredError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var AlreadyRegisteredError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "AlreadyRegisteredError";
   constructor(args) {
     super(
@@ -1810,7 +1810,7 @@ function validateDisperseInputs(args) {
   const errors = [];
   if (recipients.length === 0) {
     errors.push(
-      new chunk56UI7LUR_cjs.InvalidArgumentError({
+      new chunk67OV5CX2_cjs.InvalidArgumentError({
         method,
         argument: "recipients",
         reason: "must be non-empty"
@@ -1819,7 +1819,7 @@ function validateDisperseInputs(args) {
   }
   if (amounts.length !== recipients.length) {
     errors.push(
-      new chunk56UI7LUR_cjs.InvalidArgumentError({
+      new chunk67OV5CX2_cjs.InvalidArgumentError({
         method,
         argument: "amounts",
         reason: `length mismatch: recipients.length (${recipients.length}) !== amounts.length (${amounts.length})`
@@ -1829,7 +1829,7 @@ function validateDisperseInputs(args) {
   recipients.forEach((r, i) => {
     if (!viem.isAddress(r, { strict: true })) {
       errors.push(
-        new chunk56UI7LUR_cjs.InvalidArgumentError({
+        new chunk67OV5CX2_cjs.InvalidArgumentError({
           method,
           argument: `recipients[${i}]`,
           reason: "must be a valid EIP-55 checksummed address",
@@ -1840,7 +1840,7 @@ function validateDisperseInputs(args) {
     }
     if (r === ZERO_ADDRESS) {
       errors.push(
-        new chunk56UI7LUR_cjs.InvalidArgumentError({
+        new chunk67OV5CX2_cjs.InvalidArgumentError({
           method,
           argument: `recipients[${i}]`,
           reason: "zero address",
@@ -1852,7 +1852,7 @@ function validateDisperseInputs(args) {
   amounts.forEach((v, i) => {
     if (v < 0n || v > MAX_UINT642) {
       errors.push(
-        new chunk56UI7LUR_cjs.InvalidArgumentError({
+        new chunk67OV5CX2_cjs.InvalidArgumentError({
           method,
           argument: `amounts[${i}]`,
           reason: "exceeds uint64 range (0..2^64-1)"
@@ -1866,7 +1866,7 @@ function validateDisperseInputs(args) {
     const { group0, group1 } = computeSubtotals([...amounts]);
     if (group0 > MAX_UINT642) {
       errors.push(
-        new chunk56UI7LUR_cjs.InvalidArgumentError({
+        new chunk67OV5CX2_cjs.InvalidArgumentError({
           method,
           argument: "amounts",
           reason: "wallet-mode subtotal exceeds uint64 range"
@@ -1875,7 +1875,7 @@ function validateDisperseInputs(args) {
     }
     if (group1 > MAX_UINT642) {
       errors.push(
-        new chunk56UI7LUR_cjs.InvalidArgumentError({
+        new chunk67OV5CX2_cjs.InvalidArgumentError({
           method,
           argument: "amounts",
           reason: "wallet-mode subtotal exceeds uint64 range"
@@ -1884,7 +1884,7 @@ function validateDisperseInputs(args) {
     }
     if (group0 <= MAX_UINT642 && group1 <= MAX_UINT642 && group0 + group1 > MAX_UINT642) {
       errors.push(
-        new chunk56UI7LUR_cjs.InvalidArgumentError({
+        new chunk67OV5CX2_cjs.InvalidArgumentError({
           method,
           argument: "amounts",
           reason: "wallet-mode subtotals sum exceeds uint64 range (would silently zero on-chain)"
@@ -1894,7 +1894,7 @@ function validateDisperseInputs(args) {
   }
   if (batchLimit > 0n && BigInt(recipients.length) > batchLimit) {
     errors.push(
-      new chunk56UI7LUR_cjs.BatchTooLargeError({
+      new chunk67OV5CX2_cjs.BatchTooLargeError({
         method,
         contractAddress,
         requested: recipients.length,
@@ -1907,7 +1907,7 @@ function validateDisperseInputs(args) {
 function assertChecksumAddress(value, argument, method) {
   if (value === void 0) return;
   if (!viem.isAddress(value, { strict: true })) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "must be a valid EIP-55 checksummed address \u2014 use viem's getAddress(addr) to fix the checksum",
@@ -1919,7 +1919,7 @@ function assertNonZeroChecksumAddress(value, argument, method) {
   if (value === void 0) return;
   assertChecksumAddress(value, argument, method);
   if (value === ZERO_ADDRESS) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "must not be the zero address",
@@ -1934,7 +1934,7 @@ function batchLimitForMode(mode, limits) {
 }
 
 // src/fhe-disperse/types.ts
-var DisperseSubwalletNotFoundError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var DisperseSubwalletNotFoundError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "DisperseSubwalletNotFoundError";
   constructor(txHash, singletonAddress) {
     super(
@@ -1946,7 +1946,7 @@ var DisperseSubwalletNotFoundError = class extends chunk56UI7LUR_cjs.TokenOpsSdk
     );
   }
 };
-var DisperseEncryptedReserveNotGrantedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var DisperseEncryptedReserveNotGrantedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "DisperseEncryptedReserveNotGrantedError";
   constructor(txHash, callerAddress) {
     super(
@@ -1968,7 +1968,7 @@ var disperseProductMapper = (name, _args, ctx) => {
     case "UserNotRegistered":
       return new NotRegisteredError({ ...ctx, user });
     case "ContractNotAllowed":
-      return new chunk56UI7LUR_cjs.InvalidArgumentError({
+      return new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: ctx.method,
         argument: "handle",
         reason: "the handle's origin contract did not grant this singleton persistent ACL on the handle. ERC-7984 `transferred` handles are scoped to the token contract \u2014 disclose them through the token, not through `DisperseConfidential`."
@@ -2012,10 +2012,10 @@ var ConfidentialDisperseClient = class {
     this.encryptor = config.encryptor;
     this.#telemetry = config.telemetry;
     const chainId = config.chainId ?? config.publicClient.chain?.id;
-    const addressOverride = config.address ? chunkCQIPRNS7_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.getFheDisperseSingletonAddress(chainId));
+    const addressOverride = config.address ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : void 0;
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.getFheDisperseSingletonAddress(chainId));
     if (!resolved) {
-      throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+      throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
         product: "fheDisperse",
         contract: "disperseConfidentialSingleton",
@@ -2029,8 +2029,8 @@ var ConfidentialDisperseClient = class {
       surface: "singleton",
       chainId: chainId ?? null,
       hasWallet: !!this.walletClient,
-      aclResolved: !!config.aclAddress || chainId !== void 0 && !!chunkQ7ARQSUH_cjs.getFhevmAclAddress(chainId),
-      sdkVersion: chunkVDXVNZCO_cjs.SDK_VERSION
+      aclResolved: !!config.aclAddress || chainId !== void 0 && !!chunkFAXIIH5R_cjs.getFhevmAclAddress(chainId),
+      sdkVersion: chunkKLKI352M_cjs.SDK_VERSION
     });
   }
   /**
@@ -2041,7 +2041,7 @@ var ConfidentialDisperseClient = class {
    */
   get aclAddress() {
     if (this.#cachedAclAddress) return this.#cachedAclAddress;
-    this.#cachedAclAddress = this.#aclAddressOverride ?? chunkQ7ARQSUH_cjs.requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialDisperseClient");
+    this.#cachedAclAddress = this.#aclAddressOverride ?? chunkFAXIIH5R_cjs.requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialDisperseClient");
     return this.#cachedAclAddress;
   }
   // ============================================================
@@ -2168,13 +2168,20 @@ var ConfidentialDisperseClient = class {
    * subtotal1` for the result to match the on-chain computation. Both this
    * SDK and the contract round the BPS multiplication down (floor division).
    *
+   * **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. `totalTokens` follows this
+   * convention.
+   *
    * @throws {TokenOpsSdkError} if mode is `"wallet-token-fee"` and `totalTokens` is not provided.
    */
   async calculateFee(args) {
     const fees = await this.getFees(args.user);
     if (args.mode === "wallet-token-fee") {
       if (args.totalTokens === void 0) {
-        throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+        throw new chunk67OV5CX2_cjs.InvalidArgumentError({
           method: "calculateFee",
           argument: "totalTokens",
           reason: "is required for wallet-token-fee mode"
@@ -2231,6 +2238,13 @@ var ConfidentialDisperseClient = class {
    * - `hasApprovedSubwallets` (wallet modes) or `isOperator(sender, singleton)` (direct mode)
    * - `calculateFee` / `getBatchLimits`
    * - Structural recipient + amount validation
+   *
+   * **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. Pass `amounts[]` in the same
+   * units you will pass to `disperse` so the report reflects the real call.
    */
   async preflightDisperse(args) {
     const { user, token, recipients, amounts, mode } = args;
@@ -2334,12 +2348,12 @@ var ConfidentialDisperseClient = class {
     if (isPaused) {
       blockers.push("Singleton is paused");
       blockerErrors.push(
-        new chunk56UI7LUR_cjs.PausedError({ method: "preflightDisperse", contractAddress: this.address })
+        new chunk67OV5CX2_cjs.PausedError({ method: "preflightDisperse", contractAddress: this.address })
       );
     }
     if (callerBalance < fee.ethValue) {
       blockerErrors.push(
-        new chunk56UI7LUR_cjs.InsufficientFeeError({
+        new chunk67OV5CX2_cjs.InsufficientFeeError({
           method: "preflightDisperse",
           contractAddress: this.address,
           feeKind: "gas",
@@ -2476,6 +2490,15 @@ var ConfidentialDisperseClient = class {
    * 4. Computes `msg.value` for gas-fee modes; `0` for token-fee mode.
    * 5. Dispatches to the correct contract function based on `mode`.
    *
+   * **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. Every entry of `amounts[]`
+   * follows this convention.
+   *
    * @throws {TokenOpsSdkError} on input validation failure (first deterministic error).
    * @throws {TokenOpsSdkError} if no encryptor is available at call time.
    */
@@ -2487,7 +2510,7 @@ var ConfidentialDisperseClient = class {
       const account = this.#resolveAccount(wallet, args.account, "disperse");
       const enc = resolveEncryptor(this.encryptor);
       if (!enc) {
-        throw new chunk56UI7LUR_cjs.MissingEncryptorError("disperse", {
+        throw new chunk67OV5CX2_cjs.MissingEncryptorError("disperse", {
           hint: "Pass `encryptor` to the call or the client config."
         });
       }
@@ -2582,7 +2605,7 @@ var ConfidentialDisperseClient = 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()
     );
@@ -2590,7 +2613,7 @@ var ConfidentialDisperseClient = class {
       throw new DisperseEncryptedReserveNotGrantedError(hash, accountAddress(account));
     }
     if (granted.length > 1) {
-      throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+      throw new chunk67OV5CX2_cjs.ReceiptEventAmbiguousError({
         method: "getEncryptedFeeReserve",
         eventName: "Allowed",
         contractAddress: this.aclAddress,
@@ -2791,6 +2814,12 @@ var ConfidentialDisperseClient = class {
    * encryptor, or pass `encryptedInput` directly. The contract caps the
    * withdrawal at the available reserve via `FHE.min`.
    *
+   * **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 the tx hash plus the **transferred** handle parsed from the
    * `TokenFeeWithdrawn` event. Decrypt the handle via Zama's `userDecrypt`
    * to view the actual amount moved (which can be less than requested when
@@ -2936,7 +2965,7 @@ var ConfidentialDisperseClient = class {
         values: amounts
       });
     } catch (err) {
-      throw chunkNS44KBV5_cjs.mapZamaError(err, { method: "disperse[direct]", operation: "encrypt" });
+      throw chunkTEBM66WA_cjs.mapZamaError(err, { method: "disperse[direct]", operation: "encrypt" });
     }
     let ethValue = gasFeeOverride;
     if (ethValue === void 0) {
@@ -2982,7 +3011,7 @@ var ConfidentialDisperseClient = class {
         values: allValues
       });
     } catch (err) {
-      throw chunkNS44KBV5_cjs.mapZamaError(err, { method: `disperse[${mode}]`, operation: "encrypt" });
+      throw chunkTEBM66WA_cjs.mapZamaError(err, { method: `disperse[${mode}]`, operation: "encrypt" });
     }
     const amountHandles = encrypted.handles.slice(0, count);
     const subtotal0Handle = encrypted.handles[count];
@@ -3109,14 +3138,14 @@ var ConfidentialDisperseClient = class {
     const hasAmount = amount !== void 0;
     const hasInput = preEncrypted !== void 0;
     if (hasAmount && hasInput) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method,
         argument: "amount/encryptedInput",
         reason: "exactly one of `amount` (plaintext, SDK encrypts) or `encryptedInput` (pre-encrypted) must be supplied \u2014 got both"
       });
     }
     if (!hasAmount && !hasInput) {
-      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      throw new chunk67OV5CX2_cjs.InvalidArgumentError({
         method,
         argument: "amount/encryptedInput",
         reason: "exactly one of `amount` (plaintext, SDK encrypts) or `encryptedInput` (pre-encrypted) must be supplied \u2014 got neither"
@@ -3125,7 +3154,7 @@ var ConfidentialDisperseClient = class {
     if (hasInput) return preEncrypted;
     const enc = encryptor ?? resolveEncryptor(this.encryptor);
     if (!enc) {
-      throw new chunk56UI7LUR_cjs.MissingEncryptorError("encryptSingle", {
+      throw new chunk67OV5CX2_cjs.MissingEncryptorError("encryptSingle", {
         hint: "Pass `encryptor` to the call or the client config (eager or lazy factory)."
       });
     }
@@ -3137,19 +3166,19 @@ var ConfidentialDisperseClient = class {
         value: amount
       });
     } catch (err) {
-      throw chunkNS44KBV5_cjs.mapZamaError(err, { method: "encryptSingle", operation: "encrypt" });
+      throw chunkTEBM66WA_cjs.mapZamaError(err, { method: "encryptSingle", operation: "encrypt" });
     }
   }
   #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;
   }
@@ -3202,13 +3231,13 @@ var ConfidentialDisperseClient = 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));
       }
     }
   }
   #mapRevert(method, err, productContext, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunkKLKI352M_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: disperseConfidentialAbi,

package/dist/{chunk-3ZRHDTEX.cjs → chunk-PUPKNW3R.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var chains = require('viem/chains');
 
 var DEPLOYED_ADDRESSES = {
@@ -50,7 +50,7 @@ function requireDeployedAddress(product, contract, chainId) {
   const contractEntry = productEntry[contract];
   const entry = contractEntry?.[chainId];
   if (entry) return entry;
-  throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+  throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
     reason: entry === null ? "registry-not-deployed" : "registry-unknown-chain",
     product: String(product),
     contract: String(contract),