@tokenops/sdk 1.0.0 → 1.5.1

package/dist/{chunk-52TC6BF7.js → chunk-IXLO7GO5.js}

@@ -1,11 +1,12 @@
-import { mapZamaError } from './chunk-ZXCOJY2Z.js';
-import { scaleRatio } from './chunk-XSNLAS5M.js';
-import { getFhevmAclAddress, requireFhevmAclAddress, ACL_ALLOWED_EVENT } from './chunk-FYQ2UW4T.js';
-import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-JFLEEXKP.js';
-import { normaliseAddress } from './chunk-BE2AIZ3K.js';
+import { mapZamaError } from './chunk-WMACINXO.js';
+import { scaleRatio } from './chunk-AOP6HMPW.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 { normaliseAddress } from './chunk-ZA673I3O.js';
 import { withTelemetry } from './chunk-Q2GP5UDC.js';
 import { asExternalInputProof, asEncryptedHandle, asTxHash } from './chunk-KWFFIJYX.js';
-import { InvalidArgumentError, TokenOpsSdkError, PausedError, InsufficientFeeError, MissingEncryptorError, ReceiptEventNotFoundError, ReceiptEventAmbiguousError, MissingWalletClientError, MissingAccountError } from './chunk-IVE3QEGD.js';
+import { InvalidArgumentError, TokenOpsSdkError, PausedError, InsufficientFeeError, AccessDeniedError, OperatorNotApprovedError, MissingEncryptorError, ReceiptEventNotFoundError, ReceiptEventAmbiguousError, MissingWalletClientError, MissingAccountError } from './chunk-QBJ7O2B4.js';
 import { bytesToHex, parseEventLogs, isAddress } from 'viem';
 
 // src/fhe-vesting/abis/manager.ts
@@ -1398,8 +1399,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)]);
@@ -1530,6 +1530,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: erc7984OperatorAbi,
+        functionName: "isOperator",
+        args: [args.creator, this.address]
+      })
+    ]);
+    if (!hasCreatorRole) {
+      pushBlocker(
+        new AccessDeniedError({
+          method: "createVesting",
+          contractAddress: this.address,
+          account: args.creator,
+          role: creatorRole
+        })
+      );
+    }
+    if (!isOperatorSet) {
+      pushBlocker(
+        new 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)
   // ============================================================
@@ -1595,6 +1689,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({
@@ -1636,6 +1738,14 @@ 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) {
@@ -1686,6 +1796,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
@@ -1714,6 +1827,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.
    */
@@ -1742,6 +1858,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.
    */
@@ -1776,6 +1901,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.
    */
@@ -2165,6 +2299,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.
    */
@@ -2221,6 +2362,13 @@ 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.
    */
@@ -2634,45 +2782,8 @@ var ConfidentialVestingManagerClient = class {
    * than wait for the on-chain revert.
    */
   #validateVestingParams(params, where) {
-    if (!isAddress(params.recipient, { strict: true })) {
-      throw new InvalidArgumentError({
-        method: where,
-        argument: "recipient",
-        reason: "must be a valid EIP-55 checksummed address",
-        value: params.recipient
-      });
-    }
-    if (params.recipient === ZERO_ADDRESS) {
-      throw new InvalidArgumentError({
-        method: where,
-        argument: "recipient",
-        reason: "must not be the zero address"
-      });
-    }
-    if (params.startTimestamp >= params.endTimestamp) {
-      throw new 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 InvalidArgumentError({
-        method: where,
-        argument: "cliffSeconds",
-        reason: "cliff cannot extend past endTimestamp",
-        value: params.cliffSeconds
-      });
-    }
-    if (params.initialUnlockBps + params.cliffAmountBps > 1e4) {
-      throw new 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({
@@ -2751,5 +2862,57 @@ function accountAddress(account) {
   return typeof account === "string" ? account : account.address;
 }
 var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+function collectVestingParamsErrors(params, where) {
+  const errors = [];
+  if (!isAddress(params.recipient, { strict: true })) {
+    errors.push(
+      new 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 InvalidArgumentError({
+        method: where,
+        argument: "recipient",
+        reason: "must not be the zero address"
+      })
+    );
+  }
+  if (params.startTimestamp >= params.endTimestamp) {
+    errors.push(
+      new 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 InvalidArgumentError({
+        method: where,
+        argument: "cliffSeconds",
+        reason: "cliff cannot extend past endTimestamp",
+        value: params.cliffSeconds
+      })
+    );
+  }
+  if (params.initialUnlockBps + params.cliffAmountBps > 1e4) {
+    errors.push(
+      new InvalidArgumentError({
+        method: where,
+        argument: "initialUnlockBps + cliffAmountBps",
+        reason: "must be \u2264 10000 (100%)",
+        value: { initialUnlockBps: params.initialUnlockBps, cliffAmountBps: params.cliffAmountBps }
+      })
+    );
+  }
+  return errors;
+}
 
 export { ClaimLockedError, ConfidentialVestingManagerClient, NoPendingTransferError, NotPendingRecipientError, NotVestingRecipientError, TransferAlreadyPendingError, TransferExpiredError, VestingExpiredError, VestingNotFoundError, VestingNotRevocableError, VestingRevokedError, confidentialVestingManagerAbi, createConfidentialVestingManagerClient, encryptUint64, encryptUint64Batch, resolveEncryptor };

package/dist/{chunk-CQIPRNS7.cjs → chunk-JK4XMMKM.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var viem = require('viem');
 
 function normaliseAddress(input) {
   if (typeof input !== "string") {
-    throw new chunk56UI7LUR_cjs.TokenOpsValidationError("normaliseAddress: input is not a string", {
+    throw new chunk67OV5CX2_cjs.TokenOpsValidationError("normaliseAddress: input is not a string", {
       method: "normaliseAddress",
       args: { input: typeof input }
     });
   }
   if (!viem.isAddress(input, { strict: false })) {
-    throw new chunk56UI7LUR_cjs.TokenOpsValidationError(
+    throw new chunk67OV5CX2_cjs.TokenOpsValidationError(
       `normaliseAddress: '${input}' is not a valid 0x-prefixed 20-byte hex address`,
       {
         method: "normaliseAddress",

package/dist/{chunk-ITQ7WKVC.cjs → chunk-JYOTGRSO.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.cjs');
+var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 
 // src/fhe/operators.ts
 var ERC7984_SET_OPERATOR_ABI = [
@@ -20,19 +20,19 @@ var ERC7984_SET_OPERATOR_ABI = [
 var ERC7984_OPERATOR_MAX_DEADLINE = (1n << 48n) - 1n;
 async function setOperator(args) {
   const { publicClient, walletClient, account, waitForReceipt = true, telemetry } = args;
-  const token = chunkCQIPRNS7_cjs.normaliseAddress(args.token);
-  const spender = chunkCQIPRNS7_cjs.normaliseAddress(args.spender);
+  const token = chunkJK4XMMKM_cjs.normaliseAddress(args.token);
+  const spender = chunkJK4XMMKM_cjs.normaliseAddress(args.spender);
   const deadline = args.deadline ?? ERC7984_OPERATOR_MAX_DEADLINE;
   return chunkVJKZWYYJ_cjs.withTelemetry(telemetry, "fhe.setOperator", async () => {
     const fromAccount = account ?? walletClient.account;
     if (!fromAccount) {
-      throw new chunk56UI7LUR_cjs.TokenOpsContractError(
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
         "setOperator: no account available \u2014 pass `account` explicitly or attach an account to the walletClient",
         { contract: "ERC7984", call: "setOperator" }
       );
     }
     if (deadline < 0n || deadline > ERC7984_OPERATOR_MAX_DEADLINE) {
-      throw new chunk56UI7LUR_cjs.TokenOpsContractError(
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
         `setOperator: deadline ${deadline} out of uint48 range [0, ${ERC7984_OPERATOR_MAX_DEADLINE}]`,
         { contract: "ERC7984", call: "setOperator", deadline: deadline.toString() }
       );
@@ -53,7 +53,7 @@ async function setOperator(args) {
         chain: walletClient.chain
       });
     } catch (err) {
-      throw new chunk56UI7LUR_cjs.TokenOpsContractError(
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
         `setOperator: writeContract failed (token=${token}, spender=${spender})`,
         {
           contract: "ERC7984",
@@ -68,7 +68,7 @@ async function setOperator(args) {
       try {
         await publicClient.waitForTransactionReceipt({ hash });
       } catch (err) {
-        throw new chunk56UI7LUR_cjs.TokenOpsContractError(`setOperator: receipt wait failed (tx=${hash})`, {
+        throw new chunk67OV5CX2_cjs.TokenOpsContractError(`setOperator: receipt wait failed (tx=${hash})`, {
           contract: "ERC7984",
           call: "setOperator",
           tx: hash,

package/dist/{chunk-VDXVNZCO.cjs → chunk-KLKI352M.cjs}

@@ -1,12 +1,55 @@
 'use strict';
 
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var viem = require('viem');
 
 // src/core/version.ts
 var SDK_VERSION = "1.0.0";
+var ERC7984_ERRORS_ABI = [
+  {
+    type: "error",
+    name: "ERC7984UnauthorizedSpender",
+    inputs: [
+      { name: "holder", type: "address" },
+      { name: "spender", type: "address" }
+    ]
+  },
+  {
+    type: "error",
+    name: "ERC7984UnauthorizedCaller",
+    inputs: [{ name: "caller", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984UnauthorizedUseOfEncryptedAmount",
+    inputs: [
+      { name: "amount", type: "bytes32" },
+      { name: "user", type: "address" }
+    ]
+  },
+  {
+    type: "error",
+    name: "ERC7984InvalidReceiver",
+    inputs: [{ name: "receiver", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984InvalidSender",
+    inputs: [{ name: "sender", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984ZeroBalance",
+    inputs: [{ name: "holder", type: "address" }]
+  },
+  {
+    type: "error",
+    name: "ERC7984InvalidGatewayRequest",
+    inputs: [{ name: "requestId", type: "uint256" }]
+  }
+];
 function mapContractRevert(error, args) {
-  if (error instanceof chunk56UI7LUR_cjs.TokenOpsSdkError) return error;
+  if (error instanceof chunk67OV5CX2_cjs.TokenOpsSdkError) return error;
   const ctx = {
     method: args.method,
     contractAddress: args.contractAddress,
@@ -24,7 +67,10 @@ function mapContractRevert(error, args) {
   if (revertName === void 0 && rawRevertData !== void 0 && rawRevertData.length >= 10) {
     revertSelector = rawRevertData.slice(0, 10);
     try {
-      const decoded = viem.decodeErrorResult({ abi: args.abi, data: rawRevertData });
+      const decoded = viem.decodeErrorResult({
+        abi: [...args.abi, ...ERC7984_ERRORS_ABI],
+        data: rawRevertData
+      });
       revertName = decoded.errorName;
       revertArgs = decoded.args;
     } catch {
@@ -38,7 +84,7 @@ function mapContractRevert(error, args) {
     const fromDefault = defaultRevertNameMapper(revertName, revertArgs, ctx, args.account);
     if (fromDefault) return attachCause(fromDefault, error);
   }
-  return new chunk56UI7LUR_cjs.ContractRevertError({
+  return new chunk67OV5CX2_cjs.ContractRevertError({
     method: args.method,
     contractAddress: args.contractAddress,
     revertName,
@@ -66,62 +112,72 @@ function defaultRevertNameMapper(name, errArgs, ctx, account) {
     case "EnforcedPause":
     case "PausableUpgradeable__Paused":
     case "ClaimsPaused":
-      return new chunk56UI7LUR_cjs.PausedError(ctx);
+      return new chunk67OV5CX2_cjs.PausedError(ctx);
     case "AccessControlUnauthorizedAccount": {
       const acct = errArgs?.[0] ?? account;
       const role = errArgs?.[1];
-      return new chunk56UI7LUR_cjs.AccessDeniedError({ ...ctx, account: acct, role });
+      return new chunk67OV5CX2_cjs.AccessDeniedError({ ...ctx, account: acct, role });
     }
     case "AccessControlBadConfirmation":
-      return new chunk56UI7LUR_cjs.InvalidArgumentError({
+      return new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: ctx.method,
         argument: "callerConfirmation",
         reason: "must equal msg.sender for renounceRole"
       });
     case "InvalidInitialization":
     case "Initializable_InvalidInitialization":
-      return new chunk56UI7LUR_cjs.AlreadyInitializedError(ctx);
+      return new chunk67OV5CX2_cjs.AlreadyInitializedError(ctx);
     case "ReentrancyGuardReentrantCall":
     case "ReentrancyGuardTransient":
-      return new chunk56UI7LUR_cjs.ReentrancyError(ctx);
+      return new chunk67OV5CX2_cjs.ReentrancyError(ctx);
     // Cross-product custom errors with stable, unambiguous meaning.
     case "InsufficientFee":
     case "InsufficientGasFee":
-      return new chunk56UI7LUR_cjs.InsufficientFeeError({ ...ctx, feeKind: "gas" });
+      return new chunk67OV5CX2_cjs.InsufficientFeeError({ ...ctx, feeKind: "gas" });
     case "InsufficientAmount": {
       const provided = errArgs?.[0];
       const required = errArgs?.[1];
-      return new chunk56UI7LUR_cjs.InsufficientFeeError({ ...ctx, feeKind: "gas", required, provided });
+      return new chunk67OV5CX2_cjs.InsufficientFeeError({ ...ctx, feeKind: "gas", required, provided });
     }
     case "ZeroBalance":
     case "InsufficientBalance":
-      return new chunk56UI7LUR_cjs.InsufficientBalanceError({ ...ctx, balanceKind: "eth" });
+      return new chunk67OV5CX2_cjs.InsufficientBalanceError({ ...ctx, balanceKind: "eth" });
     case "BatchTooLarge": {
       const requested = Number(errArgs?.[0] ?? 0);
       const max = errArgs?.[1] ?? 0n;
-      return new chunk56UI7LUR_cjs.BatchTooLargeError({ ...ctx, requested, max });
+      return new chunk67OV5CX2_cjs.BatchTooLargeError({ ...ctx, requested, max });
     }
     case "SplitDisabled":
-      return new chunk56UI7LUR_cjs.FeatureDisabledError({ ...ctx, feature: "split" });
+      return new chunk67OV5CX2_cjs.FeatureDisabledError({ ...ctx, feature: "split" });
     case "PausableDisabled":
-      return new chunk56UI7LUR_cjs.FeatureDisabledError({ ...ctx, feature: "pause" });
+      return new chunk67OV5CX2_cjs.FeatureDisabledError({ ...ctx, feature: "pause" });
     case "ExtensionNotAllowed":
-      return new chunk56UI7LUR_cjs.FeatureDisabledError({ ...ctx, feature: "extendClaimWindow" });
+      return new chunk67OV5CX2_cjs.FeatureDisabledError({ ...ctx, feature: "extendClaimWindow" });
     case "TransferFailed":
-      return new chunk56UI7LUR_cjs.TransferFailedError({ ...ctx, asset: "eth" });
+      return new chunk67OV5CX2_cjs.TransferFailedError({ ...ctx, asset: "eth" });
     case "HandleNotAllowed":
-      return new chunk56UI7LUR_cjs.FheHandleNotAllowedError({ ...ctx, account });
+      return new chunk67OV5CX2_cjs.FheHandleNotAllowedError({ ...ctx, account });
     case "SenderNotAllowedToUseHandle": {
       const handle = errArgs?.[0];
       const sender = errArgs?.[1] ?? account;
-      return new chunk56UI7LUR_cjs.FheHandleNotAllowedError({ ...ctx, handle, account: sender });
+      return new chunk67OV5CX2_cjs.FheHandleNotAllowedError({ ...ctx, handle, account: sender });
     }
     case "SenderNotAllowed": {
       const sender = errArgs?.[0] ?? account;
-      return new chunk56UI7LUR_cjs.FheHandleNotAllowedError({ ...ctx, account: sender });
+      return new chunk67OV5CX2_cjs.FheHandleNotAllowedError({ ...ctx, account: sender });
     }
     case "InvalidSignature":
-      return new chunk56UI7LUR_cjs.InvalidSignatureError(ctx);
+      return new chunk67OV5CX2_cjs.InvalidSignatureError(ctx);
+    case "ERC7984UnauthorizedSpender": {
+      const holder = errArgs?.[0];
+      const spender = errArgs?.[1];
+      return new chunk67OV5CX2_cjs.OperatorNotApprovedError({
+        method: ctx.method,
+        contractAddress: ctx.contractAddress,
+        holder,
+        spender
+      });
+    }
     // Range / arg-validation reverts the SDK should already have caught in
     // preflight or input validation. If they slip through, surface them as
     // structural `InvalidArgumentError` so consumers see `TOKENOPS_INVALID_ARGUMENT`
@@ -155,7 +211,7 @@ function defaultRevertNameMapper(name, errArgs, ctx, account) {
     case "ArrayLengthMismatch":
     case "VestingIdsNotStrictlyAsc":
     case "CustomFeeNotSet":
-      return new chunk56UI7LUR_cjs.InvalidArgumentError({
+      return new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: ctx.method,
         argument: invalidArgumentLabelFor(name),
         reason: `the contract reverted with \`${name}\`. If you did not pass an invalid value, this may be an SDK bug \u2014 please file an issue.`
@@ -228,7 +284,7 @@ function isContractRevert(error) {
 }
 function classifyNonRevert(error, args) {
   if (!(error instanceof viem.BaseError)) {
-    return new chunk56UI7LUR_cjs.UnknownWriteFailureError({
+    return new chunk67OV5CX2_cjs.UnknownWriteFailureError({
       method: args.method,
       contractAddress: args.contractAddress,
       cause: error
@@ -239,21 +295,21 @@ function classifyNonRevert(error, args) {
     return predicate(frame) ? frame : void 0;
   };
   if (walk((e) => e instanceof viem.UserRejectedRequestError) || walk((e) => e instanceof viem.TransactionRejectedRpcError)) {
-    return new chunk56UI7LUR_cjs.WalletRejectedError({
+    return new chunk67OV5CX2_cjs.WalletRejectedError({
       method: args.method,
       contractAddress: args.contractAddress,
       cause: error
     });
   }
   if (walk((e) => e instanceof viem.ChainMismatchError)) {
-    return new chunk56UI7LUR_cjs.WalletChainMismatchError({
+    return new chunk67OV5CX2_cjs.WalletChainMismatchError({
       method: args.method,
       contractAddress: args.contractAddress,
       cause: error
     });
   }
   if (walk((e) => e instanceof viem.InsufficientFundsError)) {
-    return new chunk56UI7LUR_cjs.InsufficientGasFundsError({
+    return new chunk67OV5CX2_cjs.InsufficientGasFundsError({
       method: args.method,
       contractAddress: args.contractAddress,
       cause: error
@@ -261,7 +317,7 @@ function classifyNonRevert(error, args) {
   }
   const httpFrame = walk((e) => e instanceof viem.HttpRequestError);
   if (httpFrame) {
-    return new chunk56UI7LUR_cjs.NetworkError({
+    return new chunk67OV5CX2_cjs.NetworkError({
       method: args.method,
       contractAddress: args.contractAddress,
       statusCode: httpFrame.status,
@@ -269,13 +325,13 @@ function classifyNonRevert(error, args) {
     });
   }
   if (walk((e) => e instanceof viem.TimeoutError)) {
-    return new chunk56UI7LUR_cjs.NetworkError({
+    return new chunk67OV5CX2_cjs.NetworkError({
       method: args.method,
       contractAddress: args.contractAddress,
       cause: error
     });
   }
-  return new chunk56UI7LUR_cjs.UnknownWriteFailureError({
+  return new chunk67OV5CX2_cjs.UnknownWriteFailureError({
     method: args.method,
     contractAddress: args.contractAddress,
     cause: error