@tokenops/sdk 1.5.1 → 2.0.0-alpha.1

package/dist/{chunk-2PWNH3UE.js → chunk-H5POPGOZ.js}

@@ -1,11 +1,12 @@
 import { mapZamaError } from './chunk-WMACINXO.js';
 import { getFhevmAclAddress, requireFhevmAclAddress, ACL_ALLOWED_EVENT } from './chunk-ZWXJTBZO.js';
-import { SDK_VERSION, isContractRevert, mapContractRevert } from './chunk-SG65XWH7.js';
-import { getFheDisperseSingletonAddress } from './chunk-XGGTQQFH.js';
+import { SDK_VERSION } from './chunk-NWFMBLSQ.js';
+import { isContractRevert, mapContractRevert } from './chunk-4RAAATVY.js';
+import { getFheDisperseSingletonAddress } from './chunk-DZHYSUGY.js';
 import { normaliseAddress } from './chunk-ZA673I3O.js';
-import { withTelemetry } from './chunk-Q2GP5UDC.js';
 import { asExternalInputProof, asEncryptedHandle } from './chunk-KWFFIJYX.js';
 import { InvalidArgumentError, TokenOpsSdkError, DeploymentAddressUnavailableError, PausedError, InsufficientFeeError, MissingEncryptorError, ReceiptEventAmbiguousError, MissingWalletClientError, MissingAccountError, BatchTooLargeError } from './chunk-QBJ7O2B4.js';
+import { withTelemetry } from './chunk-Q2GP5UDC.js';
 import { bytesToHex, keccak256, encodePacked, parseEventLogs, isAddress, getCreate2Address } from 'viem';
 
 // src/fhe-disperse/abis/singleton.ts
@@ -1771,6 +1772,44 @@ var NotRegisteredError = class extends TokenOpsSdkError {
     );
   }
 };
+var SubwalletsNotApprovedError = class extends TokenOpsSdkError {
+  name = "SubwalletsNotApprovedError";
+  constructor(args) {
+    super(
+      `${args.method}: sub-wallets are not fully approved for token ${args.token} \u2014 wallet0: ${args.wallet0Approved}, wallet1: ${args.wallet1Approved}. Call \`approveUserWalletsForToken\` first.`,
+      {
+        code: "TOKENOPS_SUBWALLETS_NOT_APPROVED",
+        cause: args.cause,
+        context: {
+          method: args.method,
+          contractAddress: args.contractAddress,
+          user: args.user,
+          token: args.token,
+          wallet0Approved: args.wallet0Approved,
+          wallet1Approved: args.wallet1Approved
+        }
+      }
+    );
+  }
+};
+var SingletonNotApprovedError = class extends TokenOpsSdkError {
+  name = "SingletonNotApprovedError";
+  constructor(args) {
+    super(
+      `${args.method}: ${args.user} has not approved the singleton ${args.contractAddress} as an operator on token ${args.token}. Call setOperator() (see @tokenops/sdk/fhe) before this transaction.`,
+      {
+        code: "TOKENOPS_SINGLETON_NOT_APPROVED",
+        cause: args.cause,
+        context: {
+          method: args.method,
+          contractAddress: args.contractAddress,
+          user: args.user,
+          token: args.token
+        }
+      }
+    );
+  }
+};
 var AlreadyRegisteredError = class extends TokenOpsSdkError {
   name = "AlreadyRegisteredError";
   constructor(args) {
@@ -2335,13 +2374,32 @@ var ConfidentialDisperseClient = class {
         })
       );
     } else if (mode === "wallet" || mode === "wallet-token-fee") {
-      if (!hasApprovedSubwallets.both)
+      if (!hasApprovedSubwallets.both) {
         blockers.push(
           `Wallets not fully approved for token \u2014 wallet0: ${hasApprovedSubwallets.wallet0}, wallet1: ${hasApprovedSubwallets.wallet1}`
         );
+        blockerErrors.push(
+          new SubwalletsNotApprovedError({
+            method: "preflightDisperse",
+            contractAddress: this.address,
+            user: args.user,
+            token: args.token,
+            wallet0Approved: hasApprovedSubwallets.wallet0,
+            wallet1Approved: hasApprovedSubwallets.wallet1
+          })
+        );
+      }
     }
     if (mode === "direct" && hasApprovedSingleton === false) {
       blockers.push("Sender has not approved the singleton as operator on the token");
+      blockerErrors.push(
+        new SingletonNotApprovedError({
+          method: "preflightDisperse",
+          contractAddress: this.address,
+          user: args.user,
+          token: args.token
+        })
+      );
     }
     if (isPaused) {
       blockers.push("Singleton is paused");
@@ -3414,4 +3472,4 @@ var PAUSER_ROLE = "0x65d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440
 var WITHDRAWER_ROLE = "0x10dac8c06a04bec0b551627dad28bc00d6516b0caacd1c7b345fcdb5211334e4";
 var DEFAULT_ADMIN_ROLE = "0x0000000000000000000000000000000000000000000000000000000000000000";
 
-export { AlreadyRegisteredError, ConfidentialDisperseClient, DEFAULT_ADMIN_ROLE, DisperseEncryptedReserveNotGrantedError, DisperseSubwalletNotFoundError, FEE_COLLECTOR_ROLE, FEE_MANAGER_ROLE, NotRegisteredError, PAUSER_ROLE, WITHDRAWER_ROLE, computeSubtotals, createConfidentialDisperseClient, disperseConfidentialAbi, disperseWalletAbi, encryptUint64, encryptUint64Batch, resolveEncryptor };
+export { AlreadyRegisteredError, ConfidentialDisperseClient, DEFAULT_ADMIN_ROLE, DisperseEncryptedReserveNotGrantedError, DisperseSubwalletNotFoundError, FEE_COLLECTOR_ROLE, FEE_MANAGER_ROLE, NotRegisteredError, PAUSER_ROLE, SingletonNotApprovedError, SubwalletsNotApprovedError, WITHDRAWER_ROLE, computeSubtotals, createConfidentialDisperseClient, disperseConfidentialAbi, disperseWalletAbi, encryptUint64, encryptUint64Batch, resolveEncryptor };

package/dist/{chunk-W7IGCOVL.cjs → chunk-JQYC66TO.cjs}

@@ -1,8 +1,9 @@
 'use strict';
 
-var chunk5X5WL5CU_cjs = require('./chunk-5X5WL5CU.cjs');
-var chunkC7BRZXJA_cjs = require('./chunk-C7BRZXJA.cjs');
-var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
+var chunkWJLECC22_cjs = require('./chunk-WJLECC22.cjs');
+var chunk3QHNYEQD_cjs = require('./chunk-3QHNYEQD.cjs');
+var chunk6PXXGACR_cjs = require('./chunk-6PXXGACR.cjs');
+var chunk5576FRT3_cjs = require('./chunk-5576FRT3.cjs');
 var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var react = require('react');
 var wagmi = require('wagmi');
@@ -25,7 +26,7 @@ function useHookFiredEvent(hookName, telemetry, hasWallet, chainId) {
 function tryResolveFactoryAddress(override, chainId) {
   if (override) return override;
   if (chainId === void 0) return void 0;
-  return chunkPUPKNW3R_cjs.getFheVestingFactoryAddress(chainId);
+  return chunk5576FRT3_cjs.getFheVestingFactoryAddress(chainId);
 }
 function useMemoFactoryClient(opts = {}) {
   const publicClient = wagmi.usePublicClient({ chainId: opts.chainId });
@@ -38,7 +39,7 @@ function useMemoFactoryClient(opts = {}) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunkC7BRZXJA_cjs.createConfidentialVestingFactoryClient({
+    return chunk6PXXGACR_cjs.createConfidentialVestingFactoryClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
@@ -65,7 +66,7 @@ function computeFactoryResolutionError(override, chainId) {
       clientLabel: "ConfidentialVestingFactoryClient"
     });
   }
-  const resolved = chunkPUPKNW3R_cjs.getFheVestingFactoryAddress(chainId);
+  const resolved = chunk5576FRT3_cjs.getFheVestingFactoryAddress(chainId);
   if (!resolved) {
     return new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
       reason: "registry-not-deployed",
@@ -88,13 +89,13 @@ function useMemoManagerClient(opts) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!opts.address) return void 0;
-    return chunk5X5WL5CU_cjs.createConfidentialVestingManagerClient({
+    return chunkWJLECC22_cjs.createConfidentialVestingManagerClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: opts.address,
       // Lazy — invoked per-encryption inside the headless client. Picks up
       // whichever EncryptorSource the consumer last passed in.
-      encryptor: () => chunk5X5WL5CU_cjs.resolveEncryptor(encryptorSourceRef.current),
+      encryptor: () => chunk3QHNYEQD_cjs.resolveEncryptor(encryptorSourceRef.current),
       ...opts.aclAddress ? { aclAddress: opts.aclAddress } : {},
       ...telemetry ? { telemetry } : {}
     });

package/dist/{chunk-PFXURMBZ.cjs → chunk-JZLGCTGK.cjs}

@@ -2,12 +2,13 @@
 
 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 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 viem = require('viem');
 
 // src/fhe-disperse/abis/singleton.ts
@@ -1773,6 +1774,44 @@ var NotRegisteredError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
     );
   }
 };
+var SubwalletsNotApprovedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
+  name = "SubwalletsNotApprovedError";
+  constructor(args) {
+    super(
+      `${args.method}: sub-wallets are not fully approved for token ${args.token} \u2014 wallet0: ${args.wallet0Approved}, wallet1: ${args.wallet1Approved}. Call \`approveUserWalletsForToken\` first.`,
+      {
+        code: "TOKENOPS_SUBWALLETS_NOT_APPROVED",
+        cause: args.cause,
+        context: {
+          method: args.method,
+          contractAddress: args.contractAddress,
+          user: args.user,
+          token: args.token,
+          wallet0Approved: args.wallet0Approved,
+          wallet1Approved: args.wallet1Approved
+        }
+      }
+    );
+  }
+};
+var SingletonNotApprovedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
+  name = "SingletonNotApprovedError";
+  constructor(args) {
+    super(
+      `${args.method}: ${args.user} has not approved the singleton ${args.contractAddress} as an operator on token ${args.token}. Call setOperator() (see @tokenops/sdk/fhe) before this transaction.`,
+      {
+        code: "TOKENOPS_SINGLETON_NOT_APPROVED",
+        cause: args.cause,
+        context: {
+          method: args.method,
+          contractAddress: args.contractAddress,
+          user: args.user,
+          token: args.token
+        }
+      }
+    );
+  }
+};
 var AlreadyRegisteredError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "AlreadyRegisteredError";
   constructor(args) {
@@ -2013,7 +2052,7 @@ var ConfidentialDisperseClient = class {
     this.#telemetry = config.telemetry;
     const chainId = config.chainId ?? config.publicClient.chain?.id;
     const addressOverride = config.address ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.getFheDisperseSingletonAddress(chainId));
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk5576FRT3_cjs.getFheDisperseSingletonAddress(chainId));
     if (!resolved) {
       throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
@@ -2030,7 +2069,7 @@ var ConfidentialDisperseClient = class {
       chainId: chainId ?? null,
       hasWallet: !!this.walletClient,
       aclResolved: !!config.aclAddress || chainId !== void 0 && !!chunkFAXIIH5R_cjs.getFhevmAclAddress(chainId),
-      sdkVersion: chunkKLKI352M_cjs.SDK_VERSION
+      sdkVersion: chunkUG5RKLU2_cjs.SDK_VERSION
     });
   }
   /**
@@ -2337,13 +2376,32 @@ var ConfidentialDisperseClient = class {
         })
       );
     } else if (mode === "wallet" || mode === "wallet-token-fee") {
-      if (!hasApprovedSubwallets.both)
+      if (!hasApprovedSubwallets.both) {
         blockers.push(
           `Wallets not fully approved for token \u2014 wallet0: ${hasApprovedSubwallets.wallet0}, wallet1: ${hasApprovedSubwallets.wallet1}`
         );
+        blockerErrors.push(
+          new SubwalletsNotApprovedError({
+            method: "preflightDisperse",
+            contractAddress: this.address,
+            user: args.user,
+            token: args.token,
+            wallet0Approved: hasApprovedSubwallets.wallet0,
+            wallet1Approved: hasApprovedSubwallets.wallet1
+          })
+        );
+      }
     }
     if (mode === "direct" && hasApprovedSingleton === false) {
       blockers.push("Sender has not approved the singleton as operator on the token");
+      blockerErrors.push(
+        new SingletonNotApprovedError({
+          method: "preflightDisperse",
+          contractAddress: this.address,
+          user: args.user,
+          token: args.token
+        })
+      );
     }
     if (isPaused) {
       blockers.push("Singleton is paused");
@@ -3231,13 +3289,13 @@ var ConfidentialDisperseClient = 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));
       }
     }
   }
   #mapRevert(method, err, productContext, account) {
-    return chunkKLKI352M_cjs.mapContractRevert(err, {
+    return chunkMVDQMV25_cjs.mapContractRevert(err, {
       method,
       contractAddress: this.address,
       abi: disperseConfidentialAbi,
@@ -3425,6 +3483,8 @@ exports.FEE_COLLECTOR_ROLE = FEE_COLLECTOR_ROLE;
 exports.FEE_MANAGER_ROLE = FEE_MANAGER_ROLE;
 exports.NotRegisteredError = NotRegisteredError;
 exports.PAUSER_ROLE = PAUSER_ROLE;
+exports.SingletonNotApprovedError = SingletonNotApprovedError;
+exports.SubwalletsNotApprovedError = SubwalletsNotApprovedError;
 exports.WITHDRAWER_ROLE = WITHDRAWER_ROLE;
 exports.computeSubtotals = computeSubtotals;
 exports.createConfidentialDisperseClient = createConfidentialDisperseClient;

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

@@ -1,8 +1,9 @@
 'use strict';
 
+var chunkFWHYQZ5E_cjs = require('./chunk-FWHYQZ5E.cjs');
 var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
-var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
+var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 
 // src/fhe/operators.ts
 var ERC7984_SET_OPERATOR_ABI = [
@@ -94,8 +95,67 @@ async function revokeOperator(args) {
     });
   });
 }
+async function isOperator(args) {
+  const token = chunkJK4XMMKM_cjs.normaliseAddress(args.token);
+  const holder = chunkJK4XMMKM_cjs.normaliseAddress(args.holder);
+  const spender = chunkJK4XMMKM_cjs.normaliseAddress(args.spender);
+  return chunkVJKZWYYJ_cjs.withTelemetry(args.telemetry, "fhe.isOperator", async () => {
+    try {
+      return await args.publicClient.readContract({
+        address: token,
+        abi: chunkFWHYQZ5E_cjs.erc7984OperatorAbi,
+        functionName: "isOperator",
+        args: [holder, spender]
+      });
+    } catch (err) {
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
+        `isOperator: readContract failed (token=${token}, holder=${holder}, spender=${spender})`,
+        { contract: "ERC7984", call: "isOperator", token, holder, spender, cause: err }
+      );
+    }
+  });
+}
+async function ensureOperator(args) {
+  return chunkVJKZWYYJ_cjs.withTelemetry(args.telemetry, "fhe.ensureOperator", async () => {
+    if (args.deadline <= 0n || args.deadline > ERC7984_OPERATOR_MAX_DEADLINE) {
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
+        `ensureOperator: deadline ${args.deadline} out of range (0, ${ERC7984_OPERATOR_MAX_DEADLINE}]`,
+        { contract: "ERC7984", call: "ensureOperator", deadline: args.deadline.toString() }
+      );
+    }
+    const fromAccount = args.account ?? args.walletClient.account;
+    if (!fromAccount) {
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
+        "ensureOperator: no account available \u2014 pass `account` explicitly or attach an account to the walletClient",
+        { contract: "ERC7984", call: "ensureOperator" }
+      );
+    }
+    const holder = typeof fromAccount === "string" ? fromAccount : fromAccount.address;
+    const authorized = await isOperator({
+      publicClient: args.publicClient,
+      token: args.token,
+      holder,
+      spender: args.spender
+    });
+    if (authorized) {
+      return { alreadyOperator: true, hash: null };
+    }
+    const hash = await setOperator({
+      publicClient: args.publicClient,
+      walletClient: args.walletClient,
+      ...args.account !== void 0 ? { account: args.account } : {},
+      token: args.token,
+      spender: args.spender,
+      deadline: args.deadline,
+      ...args.waitForReceipt !== void 0 ? { waitForReceipt: args.waitForReceipt } : {}
+    });
+    return { alreadyOperator: false, hash };
+  });
+}
 
 exports.ERC7984_OPERATOR_MAX_DEADLINE = ERC7984_OPERATOR_MAX_DEADLINE;
 exports.ERC7984_SET_OPERATOR_ABI = ERC7984_SET_OPERATOR_ABI;
+exports.ensureOperator = ensureOperator;
+exports.isOperator = isOperator;
 exports.revokeOperator = revokeOperator;
 exports.setOperator = setOperator;