@tokenops/sdk 1.5.1 → 2.0.0-alpha.1

package/dist/{chunk-IXLO7GO5.js → chunk-TWT3STIX.js}

@@ -1,13 +1,14 @@
 import { mapZamaError } from './chunk-WMACINXO.js';
-import { scaleRatio } from './chunk-AOP6HMPW.js';
+import { resolveEncryptor, encryptUint64Batch, scaleRatio, encryptUint64 } from './chunk-6GNR22OV.js';
 import { getFhevmAclAddress, requireFhevmAclAddress, ACL_ALLOWED_EVENT } from './chunk-ZWXJTBZO.js';
 import { erc7984OperatorAbi } from './chunk-7VELUOMI.js';
-import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-SG65XWH7.js';
+import { SDK_VERSION } from './chunk-NWFMBLSQ.js';
+import { mapContractRevert, isContractRevert } from './chunk-4RAAATVY.js';
 import { normaliseAddress } from './chunk-ZA673I3O.js';
+import { asEncryptedHandle, asTxHash } from './chunk-KWFFIJYX.js';
+import { TokenOpsSdkError, PausedError, InsufficientFeeError, AccessDeniedError, InvalidArgumentError, OperatorNotApprovedError, MissingEncryptorError, ReceiptEventNotFoundError, ReceiptEventAmbiguousError, MissingWalletClientError, MissingAccountError } from './chunk-QBJ7O2B4.js';
 import { withTelemetry } from './chunk-Q2GP5UDC.js';
-import { asExternalInputProof, asEncryptedHandle, asTxHash } from './chunk-KWFFIJYX.js';
-import { InvalidArgumentError, TokenOpsSdkError, PausedError, InsufficientFeeError, AccessDeniedError, OperatorNotApprovedError, MissingEncryptorError, ReceiptEventNotFoundError, ReceiptEventAmbiguousError, MissingWalletClientError, MissingAccountError } from './chunk-QBJ7O2B4.js';
-import { bytesToHex, parseEventLogs, isAddress } from 'viem';
+import { parseEventLogs, isAddress, BaseError, ContractFunctionZeroDataError } from 'viem';
 
 // src/fhe-vesting/abis/manager.ts
 var confidentialVestingManagerAbi = [
@@ -987,78 +988,6 @@ 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 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 InvalidArgumentError({
-      method: "encryptUint64",
-      argument: "handles",
-      reason: `expected 1 handle, got ${handles.length}`,
-      value: handles.length
-    });
-  }
-  return {
-    handle: asEncryptedHandle(bytesToHex(handles[0])),
-    inputProof: asExternalInputProof(bytesToHex(inputProof))
-  };
-}
-async function encryptUint64Batch({
-  encryptor,
-  contractAddress,
-  userAddress,
-  values
-}) {
-  if (values.length === 0) {
-    throw new 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 InvalidArgumentError({
-      method: "encryptUint64Batch",
-      argument: "handles",
-      reason: `expected ${values.length} handles, got ${handles.length}`,
-      value: handles.length
-    });
-  }
-  return {
-    handles: handles.map((h) => asEncryptedHandle(bytesToHex(h))),
-    inputProof: asExternalInputProof(bytesToHex(inputProof))
-  };
-}
 
 // src/fhe-vesting/errors.ts
 var VestingNotFoundError = class extends TokenOpsSdkError {
@@ -1554,6 +1483,11 @@ var ConfidentialVestingManagerClient = class {
    * - 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
@@ -1585,15 +1519,19 @@ var ConfidentialVestingManagerClient = class {
       this.token(),
       this.#read("VESTING_CREATOR_ROLE")
     ]);
-    const [hasCreatorRole, isOperatorSet] = await Promise.all([
+    const [hasCreatorRole, operatorRead] = await Promise.all([
       this.hasRole(creatorRole, args.creator),
       this.publicClient.readContract({
         address: token,
         abi: 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 AccessDeniedError({
@@ -1604,7 +1542,16 @@ var ConfidentialVestingManagerClient = class {
         })
       );
     }
-    if (!isOperatorSet) {
+    if (!operatorRead.ok) {
+      pushBlocker(
+        new 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 OperatorNotApprovedError({
           method: "createVesting",
@@ -1697,6 +1644,13 @@ var ConfidentialVestingManagerClient = class {
    * 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({
@@ -1746,6 +1700,13 @@ var ConfidentialVestingManagerClient = class {
    * 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) {
@@ -2858,6 +2819,11 @@ var ConfidentialVestingManagerClient = class {
 function createConfidentialVestingManagerClient(config) {
   return new ConfidentialVestingManagerClient(config);
 }
+function isNotErc7984Failure(err) {
+  if (isContractRevert(err)) return true;
+  if (!(err instanceof BaseError)) return false;
+  return err.walk((e) => e instanceof ContractFunctionZeroDataError) instanceof ContractFunctionZeroDataError;
+}
 function accountAddress(account) {
   return typeof account === "string" ? account : account.address;
 }
@@ -2915,4 +2881,4 @@ function collectVestingParamsErrors(params, where) {
   return errors;
 }
 
-export { ClaimLockedError, ConfidentialVestingManagerClient, NoPendingTransferError, NotPendingRecipientError, NotVestingRecipientError, TransferAlreadyPendingError, TransferExpiredError, VestingExpiredError, VestingNotFoundError, VestingNotRevocableError, VestingRevokedError, confidentialVestingManagerAbi, createConfidentialVestingManagerClient, encryptUint64, encryptUint64Batch, resolveEncryptor };
+export { ClaimLockedError, ConfidentialVestingManagerClient, NoPendingTransferError, NotPendingRecipientError, NotVestingRecipientError, TransferAlreadyPendingError, TransferExpiredError, VestingExpiredError, VestingNotFoundError, VestingNotRevocableError, VestingRevokedError, confidentialVestingManagerAbi, createConfidentialVestingManagerClient };

package/dist/chunk-UG5RKLU2.cjs

@@ -0,0 +1,6 @@
+'use strict';
+
+// src/core/version.ts
+var SDK_VERSION = "1.0.0";
+
+exports.SDK_VERSION = SDK_VERSION;

package/dist/chunk-VP2B4WM2.js

@@ -0,0 +1,154 @@
+import { createConfidentialAirdropFactoryClient, resolveEncryptor, createAirdropBaseClient, createMerkleAirdropClient, createEcdsaAirdropClient } from './chunk-GKKDAW44.js';
+import { getFheAirdropFactoryAddress } from './chunk-DZHYSUGY.js';
+import { DeploymentAddressUnavailableError } from './chunk-QBJ7O2B4.js';
+import { useRef, useMemo } from 'react';
+import { usePublicClient, useWalletClient } from 'wagmi';
+
+var FHE_AIRDROP_KEY = "tokenops-sdk";
+var FHE_AIRDROP_NAMESPACE = "fhe-airdrop";
+function airdropQueryKey(params) {
+  return [
+    FHE_AIRDROP_KEY,
+    FHE_AIRDROP_NAMESPACE,
+    params.chainId ?? null,
+    params.address ? normalizeKeyArg(params.address) : null,
+    params.fn,
+    params.args.map(normalizeKeyArg)
+  ];
+}
+function airdropQueryKeyPrefix(params) {
+  const prefix = [
+    FHE_AIRDROP_KEY,
+    FHE_AIRDROP_NAMESPACE,
+    params.chainId ?? null,
+    params.address ? normalizeKeyArg(params.address) : null
+  ];
+  if (params.fn !== void 0) prefix.push(params.fn);
+  return prefix;
+}
+function normalizeKeyArg(value) {
+  if (typeof value === "bigint") return value.toString();
+  if (Array.isArray(value)) return value.map(normalizeKeyArg);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([k, v]) => [k, normalizeKeyArg(v)])
+    );
+  }
+  if (typeof value === "string" && value.startsWith("0x")) return value.toLowerCase();
+  return value;
+}
+function tryResolveAirdropFactoryAddress(override, chainId) {
+  if (override) return override;
+  if (chainId === void 0) return void 0;
+  return getFheAirdropFactoryAddress(chainId);
+}
+function computeAirdropFactoryResolutionError(override, chainId) {
+  if (override) return void 0;
+  if (chainId === void 0) {
+    return new DeploymentAddressUnavailableError({
+      reason: "chain-id-missing",
+      product: "fheAirdrop",
+      contract: "airdropFactory",
+      clientLabel: "ConfidentialAirdropFactoryClient"
+    });
+  }
+  const resolved = getFheAirdropFactoryAddress(chainId);
+  if (!resolved) {
+    return new DeploymentAddressUnavailableError({
+      reason: "registry-not-deployed",
+      product: "fheAirdrop",
+      contract: "airdropFactory",
+      chainId,
+      clientLabel: "ConfidentialAirdropFactoryClient"
+    });
+  }
+  return void 0;
+}
+function useMemoAirdropFactoryClient(opts = {}) {
+  const publicClient = usePublicClient({ chainId: opts.chainId });
+  const { data: walletClient } = useWalletClient({ chainId: opts.chainId });
+  const chainId = opts.chainId ?? publicClient?.chain?.id;
+  const resolvedAddress = tryResolveAirdropFactoryAddress(opts.address, chainId);
+  const resolutionError = computeAirdropFactoryResolutionError(opts.address, chainId);
+  const encryptorSourceRef = useRef(opts.encryptor);
+  encryptorSourceRef.current = opts.encryptor;
+  const telemetry = opts.telemetry;
+  const client = useMemo(() => {
+    if (!publicClient) return void 0;
+    if (!resolvedAddress) return void 0;
+    return createConfidentialAirdropFactoryClient({
+      publicClient,
+      ...walletClient ? { walletClient } : {},
+      address: resolvedAddress,
+      ...chainId !== void 0 ? { chainId } : {},
+      // Lazy — invoked per-encryption inside the headless client.
+      encryptor: () => resolveEncryptor(encryptorSourceRef.current),
+      ...telemetry ? { telemetry } : {}
+    });
+  }, [publicClient, walletClient, resolvedAddress, chainId, telemetry]);
+  return {
+    client,
+    resolutionError,
+    publicClient,
+    walletClient: walletClient ?? void 0,
+    chainId,
+    resolvedAddress
+  };
+}
+function useMemoAirdropBaseClient(opts) {
+  const publicClient = usePublicClient({ chainId: opts.chainId });
+  const { data: walletClient } = useWalletClient({ chainId: opts.chainId });
+  const chainId = opts.chainId ?? publicClient?.chain?.id;
+  const telemetry = opts.telemetry;
+  const client = useMemo(() => {
+    if (!publicClient) return void 0;
+    if (!opts.address) return void 0;
+    return createAirdropBaseClient({
+      publicClient,
+      ...walletClient ? { walletClient } : {},
+      address: opts.address,
+      ...chainId !== void 0 ? { chainId } : {},
+      ...telemetry ? { telemetry } : {}
+    });
+  }, [publicClient, walletClient, opts.address, chainId, telemetry]);
+  return { client, publicClient, walletClient: walletClient ?? void 0, chainId };
+}
+function useMemoMerkleAirdropClient(opts) {
+  const publicClient = usePublicClient({ chainId: opts.chainId });
+  const { data: walletClient } = useWalletClient({ chainId: opts.chainId });
+  const chainId = opts.chainId ?? publicClient?.chain?.id;
+  const telemetry = opts.telemetry;
+  const client = useMemo(() => {
+    if (!publicClient) return void 0;
+    if (!opts.address) return void 0;
+    return createMerkleAirdropClient({
+      publicClient,
+      ...walletClient ? { walletClient } : {},
+      address: opts.address,
+      ...chainId !== void 0 ? { chainId } : {},
+      ...telemetry ? { telemetry } : {}
+    });
+  }, [publicClient, walletClient, opts.address, chainId, telemetry]);
+  return { client, publicClient, walletClient: walletClient ?? void 0, chainId };
+}
+function useMemoEcdsaAirdropClient(opts) {
+  const publicClient = usePublicClient({ chainId: opts.chainId });
+  const { data: walletClient } = useWalletClient({ chainId: opts.chainId });
+  const chainId = opts.chainId ?? publicClient?.chain?.id;
+  const telemetry = opts.telemetry;
+  const client = useMemo(() => {
+    if (!publicClient) return void 0;
+    if (!opts.address) return void 0;
+    return createEcdsaAirdropClient({
+      publicClient,
+      ...walletClient ? { walletClient } : {},
+      address: opts.address,
+      dedupMode: opts.dedupMode,
+      ...chainId !== void 0 ? { chainId } : {},
+      ...telemetry ? { telemetry } : {}
+    });
+  }, [publicClient, walletClient, opts.address, opts.dedupMode, chainId, telemetry]);
+  return { client, publicClient, walletClient: walletClient ?? void 0, chainId };
+}
+
+export { airdropQueryKey, airdropQueryKeyPrefix, useMemoAirdropBaseClient, useMemoAirdropFactoryClient, useMemoEcdsaAirdropClient, useMemoMerkleAirdropClient };

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

@@ -1,14 +1,15 @@
 'use strict';
 
 var chunkTEBM66WA_cjs = require('./chunk-TEBM66WA.cjs');
-var chunk2NCLOQ56_cjs = require('./chunk-2NCLOQ56.cjs');
+var chunk3QHNYEQD_cjs = require('./chunk-3QHNYEQD.cjs');
 var chunkFAXIIH5R_cjs = require('./chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('./chunk-FWHYQZ5E.cjs');
-var chunkKLKI352M_cjs = require('./chunk-KLKI352M.cjs');
+var chunkUG5RKLU2_cjs = require('./chunk-UG5RKLU2.cjs');
+var chunkMVDQMV25_cjs = require('./chunk-MVDQMV25.cjs');
 var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
-var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
 var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
+var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var viem = require('viem');
 
 // src/fhe-vesting/abis/manager.ts
@@ -989,78 +990,6 @@ 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 chunk67OV5CX2_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 chunk67OV5CX2_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 chunk67OV5CX2_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 chunk67OV5CX2_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 chunk67OV5CX2_cjs.TokenOpsSdkError {
@@ -1263,7 +1192,7 @@ var ConfidentialVestingManagerClient = class {
       chainId: chainIdForInit ?? null,
       hasWallet: !!this.walletClient,
       aclResolved: !!config.aclAddress || chainIdForInit !== void 0 && !!chunkFAXIIH5R_cjs.getFhevmAclAddress(chainIdForInit),
-      sdkVersion: chunkKLKI352M_cjs.SDK_VERSION
+      sdkVersion: chunkUG5RKLU2_cjs.SDK_VERSION
     });
   }
   /**
@@ -1556,6 +1485,11 @@ var ConfidentialVestingManagerClient = class {
    * - 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
@@ -1587,15 +1521,19 @@ var ConfidentialVestingManagerClient = class {
       this.token(),
       this.#read("VESTING_CREATOR_ROLE")
     ]);
-    const [hasCreatorRole, isOperatorSet] = await Promise.all([
+    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 chunk67OV5CX2_cjs.AccessDeniedError({
@@ -1606,7 +1544,16 @@ var ConfidentialVestingManagerClient = class {
         })
       );
     }
-    if (!isOperatorSet) {
+    if (!operatorRead.ok) {
+      pushBlocker(
+        new chunk67OV5CX2_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 chunk67OV5CX2_cjs.OperatorNotApprovedError({
           method: "createVesting",
@@ -1699,6 +1646,13 @@ var ConfidentialVestingManagerClient = class {
    * 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({
@@ -1748,6 +1702,13 @@ var ConfidentialVestingManagerClient = class {
    * 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) {
@@ -1764,14 +1725,14 @@ 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 ?? chunk3QHNYEQD_cjs.resolveEncryptor(this.encryptor);
       if (!encryptor) {
         throw new chunk67OV5CX2_cjs.MissingEncryptorError("batchCreateVesting");
       }
       const userAddress = accountAddress(account);
       let batch;
       try {
-        batch = await encryptUint64Batch({
+        batch = await chunk3QHNYEQD_cjs.encryptUint64Batch({
           encryptor,
           contractAddress: this.address,
           userAddress,
@@ -2018,7 +1979,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 } : chunk2NCLOQ56_cjs.scaleRatio({
+    const { numerator, denominator } = args.preScaled ? { numerator: args.numerator, denominator: args.denominator } : chunk3QHNYEQD_cjs.scaleRatio({
       numerator: args.numerator,
       denominator: args.denominator,
       // The encrypted numerator is submitted via `encryptUint64`, so
@@ -2553,14 +2514,14 @@ var ConfidentialVestingManagerClient = class {
     return acct;
   }
   async #encryptUint64(value, encryptor, account) {
-    const enc = encryptor ?? resolveEncryptor(this.encryptor);
+    const enc = encryptor ?? chunk3QHNYEQD_cjs.resolveEncryptor(this.encryptor);
     if (!enc) {
       throw new chunk67OV5CX2_cjs.MissingEncryptorError("encryptUint64", {
         hint: "Pass `encryptor` to the call or the client config (eager or lazy factory)."
       });
     }
     try {
-      return await encryptUint64({
+      return await chunk3QHNYEQD_cjs.encryptUint64({
         encryptor: enc,
         contractAddress: this.address,
         userAddress: accountAddress(account),
@@ -2604,7 +2565,7 @@ var ConfidentialVestingManagerClient = class {
    * the offending schedule id in its context.
    */
   #mapRevert(method, err, productContext, account) {
-    return chunkKLKI352M_cjs.mapContractRevert(err, {
+    return chunkMVDQMV25_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: confidentialVestingManagerAbi,
@@ -2650,7 +2611,7 @@ var ConfidentialVestingManagerClient = class {
         ...value !== void 0 ? { value } : {}
       });
     } catch (err) {
-      if (chunkKLKI352M_cjs.isContractRevert(err)) {
+      if (chunkMVDQMV25_cjs.isContractRevert(err)) {
         throw this.#mapRevert(method, err, productContext, accountAddress(account));
       }
     }
@@ -2860,6 +2821,11 @@ var ConfidentialVestingManagerClient = class {
 function createConfidentialVestingManagerClient(config) {
   return new ConfidentialVestingManagerClient(config);
 }
+function isNotErc7984Failure(err) {
+  if (chunkMVDQMV25_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;
 }
@@ -2930,6 +2896,3 @@ exports.VestingNotRevocableError = VestingNotRevocableError;
 exports.VestingRevokedError = VestingRevokedError;
 exports.confidentialVestingManagerAbi = confidentialVestingManagerAbi;
 exports.createConfidentialVestingManagerClient = createConfidentialVestingManagerClient;
-exports.encryptUint64 = encryptUint64;
-exports.encryptUint64Batch = encryptUint64Batch;
-exports.resolveEncryptor = resolveEncryptor;

package/dist/{chunk-WENHUPZC.cjs → chunk-XAYGD4E4.cjs}

@@ -1,11 +1,12 @@
 'use strict';
 
-var chunkKLKI352M_cjs = require('./chunk-KLKI352M.cjs');
-var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
+var chunkUG5RKLU2_cjs = require('./chunk-UG5RKLU2.cjs');
+var chunkMVDQMV25_cjs = require('./chunk-MVDQMV25.cjs');
+var chunk5576FRT3_cjs = require('./chunk-5576FRT3.cjs');
 var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
-var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
 var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
+var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chains = require('viem/chains');
 var viem = require('viem');
 
@@ -1825,7 +1826,7 @@ var TestnetFaucetClient = class {
     this.#chainId = chainId;
     assertTestnetFaucetChain(chainId);
     const addressOverride = config.address ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.getConfidentialTestTokenAddress(chainId));
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk5576FRT3_cjs.getConfidentialTestTokenAddress(chainId));
     if (!resolved) {
       throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
@@ -1840,7 +1841,7 @@ var TestnetFaucetClient = class {
     this.#telemetry?.event("testnet-faucet.client.init", {
       chainId: chainId ?? null,
       hasWallet: !!this.walletClient,
-      sdkVersion: chunkKLKI352M_cjs.SDK_VERSION
+      sdkVersion: chunkUG5RKLU2_cjs.SDK_VERSION
     });
   }
   // ============================================================
@@ -1863,7 +1864,7 @@ var TestnetFaucetClient = class {
    */
   async underlyingToken() {
     if (this.#cachedUnderlying) return this.#cachedUnderlying;
-    const fromRegistry = this.#cttAddressIsOverride || this.#chainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.getTestTokenAddress(this.#chainId);
+    const fromRegistry = this.#cttAddressIsOverride || this.#chainId === void 0 ? void 0 : chunk5576FRT3_cjs.getTestTokenAddress(this.#chainId);
     const resolved = fromRegistry ?? await this.#readCtt("underlying");
     this.#cachedUnderlying = chunkJK4XMMKM_cjs.normaliseAddress(resolved);
     return this.#cachedUnderlying;
@@ -2147,13 +2148,13 @@ var TestnetFaucetClient = class {
         account
       });
     } catch (err) {
-      if (chunkKLKI352M_cjs.isContractRevert(err)) {
+      if (chunkMVDQMV25_cjs.isContractRevert(err)) {
         throw this.#mapRevert(target, method, err, void 0, accountAddress(account));
       }
     }
   }
   #mapRevert(target, method, err, productContext, account) {
-    return chunkKLKI352M_cjs.mapContractRevert(err, {
+    return chunkMVDQMV25_cjs.mapContractRevert(err, {
       method,
       contractAddress: target.address,
       abi: target.abi,