@tokenops/sdk 1.1.1 → 1.5.1

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

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkOYLZEEHF_cjs = require('./chunk-OYLZEEHF.cjs');
-var chunkSAGJIEQK_cjs = require('./chunk-SAGJIEQK.cjs');
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk5X5WL5CU_cjs = require('./chunk-5X5WL5CU.cjs');
+var chunkC7BRZXJA_cjs = require('./chunk-C7BRZXJA.cjs');
+var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var react = require('react');
 var wagmi = require('wagmi');
 
@@ -25,7 +25,7 @@ function useHookFiredEvent(hookName, telemetry, hasWallet, chainId) {
 function tryResolveFactoryAddress(override, chainId) {
   if (override) return override;
   if (chainId === void 0) return void 0;
-  return chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId);
+  return chunkPUPKNW3R_cjs.getFheVestingFactoryAddress(chainId);
 }
 function useMemoFactoryClient(opts = {}) {
   const publicClient = wagmi.usePublicClient({ chainId: opts.chainId });
@@ -38,7 +38,7 @@ function useMemoFactoryClient(opts = {}) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunkSAGJIEQK_cjs.createConfidentialVestingFactoryClient({
+    return chunkC7BRZXJA_cjs.createConfidentialVestingFactoryClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
@@ -58,16 +58,16 @@ function useMemoFactoryClient(opts = {}) {
 function computeFactoryResolutionError(override, chainId) {
   if (override) return void 0;
   if (chainId === void 0) {
-    return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+    return new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
       reason: "chain-id-missing",
       product: "fheVesting",
       contract: "confidentialVestingFactory",
       clientLabel: "ConfidentialVestingFactoryClient"
     });
   }
-  const resolved = chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId);
+  const resolved = chunkPUPKNW3R_cjs.getFheVestingFactoryAddress(chainId);
   if (!resolved) {
-    return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+    return new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
       reason: "registry-not-deployed",
       product: "fheVesting",
       contract: "confidentialVestingFactory",
@@ -88,13 +88,13 @@ function useMemoManagerClient(opts) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!opts.address) return void 0;
-    return chunkOYLZEEHF_cjs.createConfidentialVestingManagerClient({
+    return chunk5X5WL5CU_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: () => chunkOYLZEEHF_cjs.resolveEncryptor(encryptorSourceRef.current),
+      encryptor: () => chunk5X5WL5CU_cjs.resolveEncryptor(encryptorSourceRef.current),
       ...opts.aclAddress ? { aclAddress: opts.aclAddress } : {},
       ...telemetry ? { telemetry } : {}
     });

package/dist/{chunk-5KHIQG7Y.cjs → chunk-WENHUPZC.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
-var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
-var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.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 chains = require('viem/chains');
 var viem = require('viem');
 
@@ -1701,7 +1701,7 @@ var tokenopsTestTokenAbi = [
 ];
 
 // src/testnet-faucet/errors.ts
-var FaucetSupplyExhaustedError = class extends chunk56UI7LUR_cjs.TokenOpsSdkError {
+var FaucetSupplyExhaustedError = class extends chunk67OV5CX2_cjs.TokenOpsSdkError {
   name = "FaucetSupplyExhaustedError";
   constructor(args) {
     super(
@@ -1721,14 +1721,14 @@ function isTestnetFaucetChainId(chainId) {
 function assertTestnetFaucetChain(chainId) {
   if (chainId === void 0) return;
   if (!isTestnetFaucetChainId(chainId)) {
-    throw new chunk56UI7LUR_cjs.UnsupportedChainError(chainId);
+    throw new chunk67OV5CX2_cjs.UnsupportedChainError(chainId);
   }
 }
 var UINT64_MAX = (1n << 64n) - 1n;
 var UINT256_MAX = (1n << 256n) - 1n;
 function assertUint64Amount(value, argument, method) {
   if (typeof value !== "bigint") {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "amount must be a bigint",
@@ -1736,7 +1736,7 @@ function assertUint64Amount(value, argument, method) {
     });
   }
   if (value <= 0n) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "amount must be greater than zero",
@@ -1744,7 +1744,7 @@ function assertUint64Amount(value, argument, method) {
     });
   }
   if (value > UINT64_MAX) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: `amount exceeds uint64 max (${UINT64_MAX.toString()})`,
@@ -1754,7 +1754,7 @@ function assertUint64Amount(value, argument, method) {
 }
 function assertUint256Amount(value, argument, method) {
   if (typeof value !== "bigint") {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "amount must be a bigint",
@@ -1762,7 +1762,7 @@ function assertUint256Amount(value, argument, method) {
     });
   }
   if (value <= 0n) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "amount must be greater than zero",
@@ -1770,7 +1770,7 @@ function assertUint256Amount(value, argument, method) {
     });
   }
   if (value > UINT256_MAX) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "amount exceeds uint256 max",
@@ -1779,9 +1779,9 @@ function assertUint256Amount(value, argument, method) {
   }
 }
 function assertNonZeroRecipient(input, argument, method) {
-  const normalised = chunkCQIPRNS7_cjs.normaliseAddress(input);
+  const normalised = chunkJK4XMMKM_cjs.normaliseAddress(input);
   if (/^0x0{40}$/i.test(normalised)) {
-    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+    throw new chunk67OV5CX2_cjs.InvalidArgumentError({
       method,
       argument,
       reason: "recipient must not be the zero address",
@@ -1799,7 +1799,7 @@ var faucetProductMapper = (name, _args, ctx) => {
       });
     case "ERC7984InvalidReceiver":
     case "ERC20InvalidReceiver":
-      return new chunk56UI7LUR_cjs.InvalidArgumentError({
+      return new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: ctx.method,
         argument: "to",
         reason: "recipient must not be the zero address"
@@ -1824,10 +1824,10 @@ var TestnetFaucetClient = class {
     const chainId = config.chainId ?? config.publicClient.chain?.id;
     this.#chainId = chainId;
     assertTestnetFaucetChain(chainId);
-    const addressOverride = config.address ? chunkCQIPRNS7_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.getConfidentialTestTokenAddress(chainId));
+    const addressOverride = config.address ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : void 0;
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.getConfidentialTestTokenAddress(chainId));
     if (!resolved) {
-      throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+      throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
         product: "testnetFaucet",
         contract: "confidentialTestToken",
@@ -1840,7 +1840,7 @@ var TestnetFaucetClient = class {
     this.#telemetry?.event("testnet-faucet.client.init", {
       chainId: chainId ?? null,
       hasWallet: !!this.walletClient,
-      sdkVersion: chunkVDXVNZCO_cjs.SDK_VERSION
+      sdkVersion: chunkKLKI352M_cjs.SDK_VERSION
     });
   }
   // ============================================================
@@ -1863,9 +1863,9 @@ var TestnetFaucetClient = class {
    */
   async underlyingToken() {
     if (this.#cachedUnderlying) return this.#cachedUnderlying;
-    const fromRegistry = this.#cttAddressIsOverride || this.#chainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.getTestTokenAddress(this.#chainId);
+    const fromRegistry = this.#cttAddressIsOverride || this.#chainId === void 0 ? void 0 : chunkPUPKNW3R_cjs.getTestTokenAddress(this.#chainId);
     const resolved = fromRegistry ?? await this.#readCtt("underlying");
-    this.#cachedUnderlying = chunkCQIPRNS7_cjs.normaliseAddress(resolved);
+    this.#cachedUnderlying = chunkJK4XMMKM_cjs.normaliseAddress(resolved);
     return this.#cachedUnderlying;
   }
   /**
@@ -1997,7 +1997,7 @@ var TestnetFaucetClient = class {
       }
       const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
       if (receipt.status !== "success") {
-        throw new chunk56UI7LUR_cjs.TokenOpsContractError(`mintConfidential: transaction ${hash} reverted`, {
+        throw new chunk67OV5CX2_cjs.TokenOpsContractError(`mintConfidential: transaction ${hash} reverted`, {
           contract: "ConfidentialTokenopsTestToken",
           call: "mint",
           tx: hash
@@ -2010,7 +2010,7 @@ var TestnetFaucetClient = class {
       });
       const ours = events.filter((ev2) => ev2.address.toLowerCase() === this.address.toLowerCase());
       if (ours.length === 0) {
-        throw new chunk56UI7LUR_cjs.ReceiptEventNotFoundError({
+        throw new chunk67OV5CX2_cjs.ReceiptEventNotFoundError({
           method: "mintConfidential",
           eventName: "ConfidentialMint",
           contractAddress: this.address,
@@ -2018,7 +2018,7 @@ var TestnetFaucetClient = class {
         });
       }
       if (ours.length > 1) {
-        throw new chunk56UI7LUR_cjs.ReceiptEventAmbiguousError({
+        throw new chunk67OV5CX2_cjs.ReceiptEventAmbiguousError({
           method: "mintConfidential",
           eventName: "ConfidentialMint",
           contractAddress: this.address,
@@ -2071,7 +2071,7 @@ var TestnetFaucetClient = class {
       }
       const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
       if (receipt.status !== "success") {
-        throw new chunk56UI7LUR_cjs.TokenOpsContractError(`mintUnderlying: transaction ${hash} reverted`, {
+        throw new chunk67OV5CX2_cjs.TokenOpsContractError(`mintUnderlying: transaction ${hash} reverted`, {
           contract: "TokenopsTestToken",
           call: "mint",
           tx: hash
@@ -2088,14 +2088,14 @@ var TestnetFaucetClient = class {
   }
   #requireWallet(method) {
     if (!this.walletClient) {
-      throw new chunk56UI7LUR_cjs.MissingWalletClientError(method);
+      throw new chunk67OV5CX2_cjs.MissingWalletClientError(method);
     }
     return this.walletClient;
   }
   #resolveAccount(wallet, override, method) {
     const acct = override ?? wallet.account;
     if (!acct) {
-      throw new chunk56UI7LUR_cjs.MissingAccountError(method);
+      throw new chunk67OV5CX2_cjs.MissingAccountError(method);
     }
     return acct;
   }
@@ -2105,10 +2105,10 @@ var TestnetFaucetClient = class {
    * neither is available (a read-only client must be told whose balance to read).
    */
   #resolveReadAddress(override, method) {
-    if (override) return chunkCQIPRNS7_cjs.normaliseAddress(override);
+    if (override) return chunkJK4XMMKM_cjs.normaliseAddress(override);
     const acct = this.walletClient?.account?.address;
     if (!acct) {
-      throw new chunk56UI7LUR_cjs.MissingAccountError(method);
+      throw new chunk67OV5CX2_cjs.MissingAccountError(method);
     }
     return acct;
   }
@@ -2147,13 +2147,13 @@ var TestnetFaucetClient = class {
         account
       });
     } catch (err) {
-      if (chunkVDXVNZCO_cjs.isContractRevert(err)) {
+      if (chunkKLKI352M_cjs.isContractRevert(err)) {
         throw this.#mapRevert(target, method, err, void 0, accountAddress(account));
       }
     }
   }
   #mapRevert(target, method, err, productContext, account) {
-    return chunkVDXVNZCO_cjs.mapContractRevert(err, {
+    return chunkKLKI352M_cjs.mapContractRevert(err, {
       method,
       contractAddress: target.address,
       abi: target.abi,

package/dist/{chunk-ZXCOJY2Z.js → chunk-WMACINXO.js}

@@ -1,4 +1,4 @@
-import { TokenOpsSdkError, InvalidArgumentError, DecryptionFailedError, EncryptionFailedError, RelayerUnreachableError, SigningFailedError, UserRejectedSignatureError, UserDecryptNotAllowedError } from './chunk-IVE3QEGD.js';
+import { TokenOpsSdkError, InvalidArgumentError, DecryptionFailedError, EncryptionFailedError, RelayerUnreachableError, SigningFailedError, UserRejectedSignatureError, UserDecryptNotAllowedError } from './chunk-QBJ7O2B4.js';
 
 // src/core/zama-error-mapper.ts
 function mapZamaError(error, args) {

package/dist/{chunk-M7V2EDPB.js → chunk-XGGTQQFH.js}

@@ -1,4 +1,4 @@
-import { DeploymentAddressUnavailableError } from './chunk-IVE3QEGD.js';
+import { DeploymentAddressUnavailableError } from './chunk-QBJ7O2B4.js';
 import { sepolia, mainnet } from 'viem/chains';
 
 var DEPLOYED_ADDRESSES = {

package/dist/{chunk-ITQBDRWX.js → chunk-YQIBBEFJ.js}

@@ -1,4 +1,4 @@
-import { ConfidentialVestingFactoryClient, confidentialVestingFactoryAbi } from './chunk-IR5AK5U5.js';
+import { ConfidentialVestingFactoryClient, confidentialVestingFactoryAbi } from './chunk-OXTLPTO3.js';
 
 // src/fhe-vesting/advanced/factory-advanced.ts
 var ConfidentialVestingFactoryAdvancedClient = class extends ConfidentialVestingFactoryClient {

package/dist/{chunk-BE2AIZ3K.js → chunk-ZA673I3O.js}

@@ -1,4 +1,4 @@
-import { TokenOpsValidationError } from './chunk-IVE3QEGD.js';
+import { TokenOpsValidationError } from './chunk-QBJ7O2B4.js';
 import { isAddress, getAddress } from 'viem';
 
 function normaliseAddress(input) {

package/dist/chunk-ZQUE2B3Q.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var wagmi = require('wagmi');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var wagmi__namespace = /*#__PURE__*/_interopNamespace(wagmi);
+
+// src/core/wagmi-compat.ts
+var wagmiModule = wagmi__namespace;
+var useWagmiAccount = wagmiModule.useConnection ?? wagmiModule.useAccount ?? (() => {
+  throw new Error(
+    "@tokenops/sdk: the installed `wagmi` package exposes neither `useConnection` (v3) nor `useAccount` (v2). Install wagmi ^2.0.0 or ^3.0.0 \u2014 the SDK's /react subpaths support both majors."
+  );
+});
+
+exports.useWagmiAccount = useWagmiAccount;

package/dist/{chunk-FYQ2UW4T.js → chunk-ZWXJTBZO.js}

@@ -1,4 +1,4 @@
-import { DeploymentAddressUnavailableError } from './chunk-IVE3QEGD.js';
+import { DeploymentAddressUnavailableError } from './chunk-QBJ7O2B4.js';
 import { parseAbiItem } from 'viem';
 
 var FHEVM_ACL_ADDRESS_BY_CHAIN = {

package/dist/core/errors.d.ts

@@ -12,7 +12,7 @@ declare const TOKENOPS_SDK_ERROR_BRAND: unique symbol;
  * on `error.code` in `onError` handlers and UI surfaces. Messages stay
  * human-readable and may evolve between versions.
  */
-export type TokenOpsSdkErrorCode = "TOKENOPS_UNSUPPORTED_CHAIN" | "TOKENOPS_DEPLOYMENT_ADDRESS_UNAVAILABLE" | "TOKENOPS_MISSING_PUBLIC_CLIENT" | "TOKENOPS_MISSING_WALLET_CLIENT" | "TOKENOPS_MISSING_ACCOUNT" | "TOKENOPS_MISSING_ENCRYPTOR" | "TOKENOPS_MISSING_CLIENT" | "TOKENOPS_INVALID_ARGUMENT" | "TOKENOPS_RECEIPT_EVENT_NOT_FOUND" | "TOKENOPS_RECEIPT_EVENT_AMBIGUOUS" | "TOKENOPS_CONTRACT_REVERT" | "TOKENOPS_PAUSED" | "TOKENOPS_ACCESS_DENIED" | "TOKENOPS_INSUFFICIENT_FEE" | "TOKENOPS_INSUFFICIENT_BALANCE" | "TOKENOPS_BATCH_TOO_LARGE" | "TOKENOPS_FEATURE_DISABLED" | "TOKENOPS_TRANSFER_FAILED" | "TOKENOPS_FHE_HANDLE_NOT_ALLOWED" | "TOKENOPS_ALREADY_INITIALIZED" | "TOKENOPS_REENTRANCY" | "TOKENOPS_INVALID_SIGNATURE" | "TOKENOPS_WALLET_REJECTED" | "TOKENOPS_WALLET_CHAIN_MISMATCH" | "TOKENOPS_NETWORK_ERROR" | "TOKENOPS_INSUFFICIENT_GAS_FUNDS" | "TOKENOPS_UNKNOWN_WRITE_FAILURE" | "TOKENOPS_USER_REJECTED" | "TOKENOPS_SIGNING_FAILED" | "TOKENOPS_RELAYER_UNREACHABLE" | "TOKENOPS_ENCRYPTION_FAILED" | "TOKENOPS_DECRYPTION_FAILED" | "TOKENOPS_USER_DECRYPT_NOT_ALLOWED" | "TOKENOPS_VESTING_NOT_FOUND" | "TOKENOPS_NOT_RECIPIENT" | "TOKENOPS_CLAIM_LOCKED" | "TOKENOPS_VESTING_REVOKED" | "TOKENOPS_NOT_REVOCABLE" | "TOKENOPS_VESTING_EXPIRED" | "TOKENOPS_TRANSFER_ALREADY_PENDING" | "TOKENOPS_NO_PENDING_TRANSFER" | "TOKENOPS_NOT_PENDING_RECIPIENT" | "TOKENOPS_TRANSFER_EXPIRED" | "TOKENOPS_ALREADY_CLAIMED" | "TOKENOPS_CLAIM_NOT_STARTED" | "TOKENOPS_CLAIM_WINDOW_CLOSED" | "TOKENOPS_NOT_REGISTERED" | "TOKENOPS_ALREADY_REGISTERED" | "TOKENOPS_FAUCET_SUPPLY_EXHAUSTED";
+export type TokenOpsSdkErrorCode = "TOKENOPS_UNSUPPORTED_CHAIN" | "TOKENOPS_DEPLOYMENT_ADDRESS_UNAVAILABLE" | "TOKENOPS_MISSING_PUBLIC_CLIENT" | "TOKENOPS_MISSING_WALLET_CLIENT" | "TOKENOPS_MISSING_ACCOUNT" | "TOKENOPS_MISSING_ENCRYPTOR" | "TOKENOPS_MISSING_CLIENT" | "TOKENOPS_INVALID_ARGUMENT" | "TOKENOPS_RECEIPT_EVENT_NOT_FOUND" | "TOKENOPS_RECEIPT_EVENT_AMBIGUOUS" | "TOKENOPS_CONTRACT_REVERT" | "TOKENOPS_PAUSED" | "TOKENOPS_ACCESS_DENIED" | "TOKENOPS_OPERATOR_NOT_APPROVED" | "TOKENOPS_INSUFFICIENT_FEE" | "TOKENOPS_INSUFFICIENT_BALANCE" | "TOKENOPS_BATCH_TOO_LARGE" | "TOKENOPS_FEATURE_DISABLED" | "TOKENOPS_TRANSFER_FAILED" | "TOKENOPS_FHE_HANDLE_NOT_ALLOWED" | "TOKENOPS_ALREADY_INITIALIZED" | "TOKENOPS_REENTRANCY" | "TOKENOPS_INVALID_SIGNATURE" | "TOKENOPS_WALLET_REJECTED" | "TOKENOPS_WALLET_CHAIN_MISMATCH" | "TOKENOPS_NETWORK_ERROR" | "TOKENOPS_INSUFFICIENT_GAS_FUNDS" | "TOKENOPS_UNKNOWN_WRITE_FAILURE" | "TOKENOPS_USER_REJECTED" | "TOKENOPS_SIGNING_FAILED" | "TOKENOPS_RELAYER_UNREACHABLE" | "TOKENOPS_ENCRYPTION_FAILED" | "TOKENOPS_DECRYPTION_FAILED" | "TOKENOPS_USER_DECRYPT_NOT_ALLOWED" | "TOKENOPS_VESTING_NOT_FOUND" | "TOKENOPS_NOT_RECIPIENT" | "TOKENOPS_CLAIM_LOCKED" | "TOKENOPS_VESTING_REVOKED" | "TOKENOPS_NOT_REVOCABLE" | "TOKENOPS_VESTING_EXPIRED" | "TOKENOPS_TRANSFER_ALREADY_PENDING" | "TOKENOPS_NO_PENDING_TRANSFER" | "TOKENOPS_NOT_PENDING_RECIPIENT" | "TOKENOPS_TRANSFER_EXPIRED" | "TOKENOPS_ALREADY_CLAIMED" | "TOKENOPS_CLAIM_NOT_STARTED" | "TOKENOPS_CLAIM_WINDOW_CLOSED" | "TOKENOPS_NOT_REGISTERED" | "TOKENOPS_ALREADY_REGISTERED" | "TOKENOPS_FAUCET_SUPPLY_EXHAUSTED";
 export interface TokenOpsSdkErrorInit {
     code: TokenOpsSdkErrorCode;
     cause?: unknown;
@@ -286,6 +286,46 @@ export declare class AccessDeniedError extends TokenOpsSdkError {
         cause?: unknown;
     });
 }
+/**
+ * Canonical remediation copy for the ERC-7984 operator prerequisite. Kept as
+ * a single exported constant so every surface that mentions the prerequisite
+ * (this error, operator helpers, docs) reuses the exact same wording.
+ * Do NOT reword — the string is shared verbatim with the docs repo.
+ */
+export declare const OPERATOR_NOT_APPROVED_REMEDIATION: "The token has not approved this contract as an operator. Call `setOperator()` (see `/fhe` operators) before this transaction.";
+/**
+ * The ERC-7984 token rejected the product contract as a spender —
+ * `ERC7984UnauthorizedSpender(address holder, address spender)` (selector
+ * `0x79f2cb38`). Raised whenever a TokenOps contract tries to pull
+ * confidential tokens from a holder that never called `setOperator()` for it
+ * (vesting `createVesting`, airdrop funding, disperse pulls). Also surfaced
+ * pre-write as a `blockerErrors[]` entry by the create-side preflights
+ * (`preflightCreateVesting` / `preflightCreateAirdrop`).
+ *
+ * Remediation: call `setOperator()` on the token (see the `/fhe` operator
+ * helpers) with the product contract as operator, then retry.
+ */
+export declare class OperatorNotApprovedError extends TokenOpsSdkError {
+    readonly name = "OperatorNotApprovedError";
+    readonly context: {
+        method: string;
+        contractAddress: Address;
+        /** ERC-7984 token whose operator approval is missing (known statically on preflight paths). */
+        tokenAddress?: Address;
+        /** Token holder whose balance the contract tried to pull (decoded from the revert when available). */
+        holder?: Address;
+        /** Address the token refused as a spender — the product contract needing operator approval. */
+        spender?: Address;
+    };
+    constructor(args: {
+        method: string;
+        contractAddress: Address;
+        tokenAddress?: Address;
+        holder?: Address;
+        spender?: Address;
+        cause?: unknown;
+    });
+}
 /**
  * Native ETH (gas) fee or token fee did not match what the contract requires.
  * `feeKind === "gas"` means the `msg.value` was wrong; `"token"` means the

package/dist/core/revert-mapper.d.ts

@@ -1,5 +1,82 @@
 import type { Abi, Address } from "viem";
 import { TokenOpsSdkError } from "./errors.js";
+/**
+ * ERC-7984 (Confidential Token) standard error signatures, from the reference
+ * implementation the TokenOps tokens vendor
+ * (`openzeppelin-confidential/ERC7984.sol`). None of the product contracts
+ * declare these in their own ABIs — the revert originates in the *token*, not
+ * the product contract — so {@link mapContractRevert} merges this set into
+ * every decode. Without it, `decodeErrorResult` fails and consumers see a raw
+ * selector hex string (`ContractRevertError: "… reverted with 0x79f2cb38."`).
+ *
+ * Selectors (keccak-256 of the signature, first 4 bytes):
+ *
+ * - `ERC7984UnauthorizedSpender(address,address)` → `0x79f2cb38`
+ * - `ERC7984UnauthorizedCaller(address)`          → `0x782c6ffd`
+ * - `ERC7984UnauthorizedUseOfEncryptedAmount(bytes32,address)` → `0x67cfe805`
+ * - `ERC7984InvalidReceiver(address)`             → `0x8d518801`
+ * - `ERC7984InvalidSender(address)`               → `0xee457ebf`
+ * - `ERC7984ZeroBalance(address)`                 → `0x5ff91cdc`
+ * - `ERC7984InvalidGatewayRequest(uint256)`       → `0x05c5b389`
+ *
+ * `euint64` parameters are `bytes32` at the ABI boundary.
+ */
+export declare const ERC7984_ERRORS_ABI: readonly [{
+    readonly type: "error";
+    readonly name: "ERC7984UnauthorizedSpender";
+    readonly inputs: readonly [{
+        readonly name: "holder";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ERC7984UnauthorizedCaller";
+    readonly inputs: readonly [{
+        readonly name: "caller";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ERC7984UnauthorizedUseOfEncryptedAmount";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "user";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ERC7984InvalidReceiver";
+    readonly inputs: readonly [{
+        readonly name: "receiver";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ERC7984InvalidSender";
+    readonly inputs: readonly [{
+        readonly name: "sender";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ERC7984ZeroBalance";
+    readonly inputs: readonly [{
+        readonly name: "holder";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ERC7984InvalidGatewayRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }];
+}];
 /** Per-product mapping: contract error name → typed SDK error constructor. */
 export type RevertNameMapper = (name: string, args: readonly unknown[] | undefined, ctx: RevertMapperContext) => TokenOpsSdkError | undefined;
 /** Context passed into product mappers. `productContext` lets the call site forward args (vestingId, user, etc.) for the mapper to embed in the typed error. */

package/dist/core/wagmi-compat.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Internal wagmi v2/v3 compatibility layer.
+ *
+ * The SDK supports both wagmi majors (`peerDependencies.wagmi: "^2.0.0 || ^3.0.0"`).
+ * wagmi v3 renamed `useAccount` → `useConnection` (official v2→v3 migration
+ * guide); `usePublicClient` and `useWalletClient` survive unchanged, so hooks
+ * import those from `"wagmi"` directly. Only the account hook needs resolving.
+ *
+ * The fields the SDK reads are shape-identical across both majors: `address`
+ * lives at the top level of both `useAccount()` (v2) and `useConnection()`
+ * (v3) return values, typed `Address | undefined` until connected.
+ *
+ * This module is intentionally NOT exported from any public subpath — it is an
+ * internal helper for the `src/<product>/react/` hook files. We namespace-import
+ * wagmi so the module typechecks against either major: a named import of
+ * `useAccount` would fail `tsc --noEmit` under v3 (and vice versa for
+ * `useConnection` under v2).
+ */
+import type { Address } from "viem";
+/**
+ * Minimal slice of the wagmi account-hook return value the SDK reads.
+ *
+ * Deliberately narrow: widening this to the full upstream shape would force
+ * this module to pick one major's type surface and break typechecking against
+ * the other. Every field listed here has been verified shape-identical in
+ * wagmi v2 `useAccount()` and wagmi v3 `useConnection()`.
+ */
+export interface WagmiAccountResult {
+    /** Connected address from the active connector; `undefined` while disconnected. */
+    address: Address | undefined;
+}
+/**
+ * The installed wagmi major's account hook: `useConnection` (v3) when present,
+ * else `useAccount` (v2). Resolved once at module load — the installed wagmi
+ * major cannot change at runtime.
+ *
+ * This IS a React hook (it aliases one) — the rules of hooks apply at every
+ * call site.
+ */
+export declare const useWagmiAccount: () => WagmiAccountResult;