@tokenops/sdk 1.0.0 → 1.5.1

package/dist/{chunk-OLDGMKW2.cjs → chunk-PUPKNW3R.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var chains = require('viem/chains');
 
 var DEPLOYED_ADDRESSES = {
@@ -21,6 +21,23 @@ var DEPLOYED_ADDRESSES = {
       [chains.mainnet.id]: "0x4fC0d28cBe4B82D512Ad0B42F6787480Cc98cC70",
       [chains.sepolia.id]: "0x710dD9885Cc9986EfD234E7719483147a6d8DBb4"
     }
+  },
+  // Testnet-only faucet token pair (see `/testnet-faucet`). The standard
+  // `TokenopsTestToken` (TTT, 18-decimal ERC-20, open mint) and its
+  // confidential ERC-7984 wrapper `ConfidentialTokenopsTestToken` (CTTT,
+  // 6-decimal, open backed faucet mint). Sepolia only — these mint value-less
+  // test tokens to anyone, so they MUST NOT appear on mainnet.
+  // `confidentialTestToken` is the UUPS *proxy* address; call it with the
+  // implementation ABI.
+  testnetFaucet: {
+    testToken: {
+      [chains.sepolia.id]: "0x37a057Fa8C201a7bf8caF32dfa9A0878f577D92b"
+      // mainnet omitted — testnet-only by design.
+    },
+    confidentialTestToken: {
+      [chains.sepolia.id]: "0x258F9D60dc023870e4E3109c894D834D5377361a"
+      // mainnet omitted — testnet-only by design.
+    }
   }
 };
 function getDeployedAddress(product, contract, chainId) {
@@ -33,7 +50,7 @@ function requireDeployedAddress(product, contract, chainId) {
   const contractEntry = productEntry[contract];
   const entry = contractEntry?.[chainId];
   if (entry) return entry;
-  throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+  throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
     reason: entry === null ? "registry-not-deployed" : "registry-unknown-chain",
     product: String(product),
     contract: String(contract),
@@ -58,6 +75,18 @@ function getFheDisperseSingletonAddress(chainId) {
 function requireFheDisperseSingletonAddress(chainId) {
   return requireDeployedAddress("fheDisperse", "disperseConfidentialSingleton", chainId);
 }
+function getTestTokenAddress(chainId) {
+  return getDeployedAddress("testnetFaucet", "testToken", chainId);
+}
+function requireTestTokenAddress(chainId) {
+  return requireDeployedAddress("testnetFaucet", "testToken", chainId);
+}
+function getConfidentialTestTokenAddress(chainId) {
+  return getDeployedAddress("testnetFaucet", "confidentialTestToken", chainId);
+}
+function requireConfidentialTestTokenAddress(chainId) {
+  return requireDeployedAddress("testnetFaucet", "confidentialTestToken", chainId);
+}
 function chainsWithKnownRegistryEntry(product) {
   const productEntry = DEPLOYED_ADDRESSES[product];
   const ids = /* @__PURE__ */ new Set();
@@ -84,10 +113,14 @@ function chainsWithDeployment(product) {
 exports.DEPLOYED_ADDRESSES = DEPLOYED_ADDRESSES;
 exports.chainsWithDeployment = chainsWithDeployment;
 exports.chainsWithKnownRegistryEntry = chainsWithKnownRegistryEntry;
+exports.getConfidentialTestTokenAddress = getConfidentialTestTokenAddress;
 exports.getDeployedAddress = getDeployedAddress;
 exports.getFheAirdropFactoryAddress = getFheAirdropFactoryAddress;
 exports.getFheDisperseSingletonAddress = getFheDisperseSingletonAddress;
 exports.getFheVestingFactoryAddress = getFheVestingFactoryAddress;
+exports.getTestTokenAddress = getTestTokenAddress;
+exports.requireConfidentialTestTokenAddress = requireConfidentialTestTokenAddress;
 exports.requireFheAirdropFactoryAddress = requireFheAirdropFactoryAddress;
 exports.requireFheDisperseSingletonAddress = requireFheDisperseSingletonAddress;
 exports.requireFheVestingFactoryAddress = requireFheVestingFactoryAddress;
+exports.requireTestTokenAddress = requireTestTokenAddress;

package/dist/{chunk-IVE3QEGD.js → chunk-QBJ7O2B4.js}

@@ -206,6 +206,23 @@ var AccessDeniedError = class extends TokenOpsSdkError {
     });
   }
 };
+var OPERATOR_NOT_APPROVED_REMEDIATION = "The token has not approved this contract as an operator. Call `setOperator()` (see `/fhe` operators) before this transaction.";
+var OperatorNotApprovedError = class extends TokenOpsSdkError {
+  name = "OperatorNotApprovedError";
+  constructor(args) {
+    super(OPERATOR_NOT_APPROVED_REMEDIATION, {
+      code: "TOKENOPS_OPERATOR_NOT_APPROVED",
+      cause: args.cause,
+      context: {
+        method: args.method,
+        contractAddress: args.contractAddress,
+        tokenAddress: args.tokenAddress,
+        holder: args.holder,
+        spender: args.spender
+      }
+    });
+  }
+};
 var InsufficientFeeError = class extends TokenOpsSdkError {
   name = "InsufficientFeeError";
   constructor(args) {
@@ -475,4 +492,4 @@ var TokenOpsContractError = class extends TokenOpsSdkError {
   }
 };
 
-export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError };
+export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, OPERATOR_NOT_APPROVED_REMEDIATION, OperatorNotApprovedError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError };

package/dist/{chunk-JFLEEXKP.js → chunk-SG65XWH7.js}

@@ -1,8 +1,51 @@
-import { TokenOpsSdkError, ContractRevertError, InvalidArgumentError, InvalidSignatureError, FheHandleNotAllowedError, TransferFailedError, FeatureDisabledError, BatchTooLargeError, InsufficientBalanceError, InsufficientFeeError, ReentrancyError, AlreadyInitializedError, AccessDeniedError, PausedError, UnknownWriteFailureError, WalletRejectedError, WalletChainMismatchError, InsufficientGasFundsError, NetworkError } from './chunk-IVE3QEGD.js';
+import { TokenOpsSdkError, ContractRevertError, InvalidArgumentError, OperatorNotApprovedError, InvalidSignatureError, FheHandleNotAllowedError, TransferFailedError, FeatureDisabledError, BatchTooLargeError, InsufficientBalanceError, InsufficientFeeError, ReentrancyError, AlreadyInitializedError, AccessDeniedError, PausedError, UnknownWriteFailureError, WalletRejectedError, WalletChainMismatchError, InsufficientGasFundsError, NetworkError } from './chunk-QBJ7O2B4.js';
 import { decodeErrorResult, BaseError, ContractFunctionRevertedError, UserRejectedRequestError, TransactionRejectedRpcError, ChainMismatchError, InsufficientFundsError, HttpRequestError, TimeoutError } from '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 TokenOpsSdkError) return error;
   const ctx = {
@@ -22,7 +65,10 @@ function mapContractRevert(error, args) {
   if (revertName === void 0 && rawRevertData !== void 0 && rawRevertData.length >= 10) {
     revertSelector = rawRevertData.slice(0, 10);
     try {
-      const decoded = decodeErrorResult({ abi: args.abi, data: rawRevertData });
+      const decoded = decodeErrorResult({
+        abi: [...args.abi, ...ERC7984_ERRORS_ABI],
+        data: rawRevertData
+      });
       revertName = decoded.errorName;
       revertArgs = decoded.args;
     } catch {
@@ -120,6 +166,16 @@ function defaultRevertNameMapper(name, errArgs, ctx, account) {
     }
     case "InvalidSignature":
       return new InvalidSignatureError(ctx);
+    case "ERC7984UnauthorizedSpender": {
+      const holder = errArgs?.[0];
+      const spender = errArgs?.[1];
+      return new 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`

package/dist/{chunk-K6MFFDBJ.cjs → chunk-T46YXSBP.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunk5SA2HF2W_cjs = require('./chunk-5SA2HF2W.cjs');
-var chunk6ECAHP5O_cjs = require('./chunk-6ECAHP5O.cjs');
-var chunkOLDGMKW2_cjs = require('./chunk-OLDGMKW2.cjs');
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunkMCRBVJGZ_cjs = require('./chunk-MCRBVJGZ.cjs');
+var chunkTIUKIY5V_cjs = require('./chunk-TIUKIY5V.cjs');
+var chunkPUPKNW3R_cjs = require('./chunk-PUPKNW3R.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 var react = require('react');
 var wagmi = require('wagmi');
 
@@ -12,7 +12,7 @@ var FHE_AIRDROP_NAMESPACE = "fhe-airdrop";
 function tryResolveFactoryAddress(override, chainId) {
   if (override) return override;
   if (chainId === void 0) return void 0;
-  return chunkOLDGMKW2_cjs.getFheAirdropFactoryAddress(chainId);
+  return chunkPUPKNW3R_cjs.getFheAirdropFactoryAddress(chainId);
 }
 function useMemoFactoryClient(opts = {}) {
   const publicClient = wagmi.usePublicClient({ chainId: opts.chainId });
@@ -25,14 +25,14 @@ function useMemoFactoryClient(opts = {}) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunk6ECAHP5O_cjs.createConfidentialAirdropFactoryClient({
+    return chunkTIUKIY5V_cjs.createConfidentialAirdropFactoryClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
       ...chainId !== void 0 ? { chainId } : {},
       // Lazy — invoked per-encryption inside the headless client. Picks up
       // whichever EncryptorSource the consumer last passed in.
-      encryptor: () => chunk6ECAHP5O_cjs.resolveEncryptor(encryptorSourceRef.current)
+      encryptor: () => chunkTIUKIY5V_cjs.resolveEncryptor(encryptorSourceRef.current)
     });
   }, [publicClient, walletClient, resolvedAddress, chainId]);
   return {
@@ -47,16 +47,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: "fheAirdrop",
       contract: "confidentialAirdropFactory",
       clientLabel: "ConfidentialAirdropFactoryClient"
     });
   }
-  const resolved = chunkOLDGMKW2_cjs.getFheAirdropFactoryAddress(chainId);
+  const resolved = chunkPUPKNW3R_cjs.getFheAirdropFactoryAddress(chainId);
   if (!resolved) {
-    return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
+    return new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
       reason: "registry-not-deployed",
       product: "fheAirdrop",
       contract: "confidentialAirdropFactory",
@@ -73,7 +73,7 @@ function useMemoAirdropClient(opts) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!opts.address) return void 0;
-    return chunk5SA2HF2W_cjs.createConfidentialAirdropClient({
+    return chunkMCRBVJGZ_cjs.createConfidentialAirdropClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: opts.address,

package/dist/{chunk-NS44KBV5.cjs → chunk-TEBM66WA.cjs}

@@ -1,29 +1,29 @@
 'use strict';
 
-var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
 
 // src/core/zama-error-mapper.ts
 function mapZamaError(error, args) {
-  if (error instanceof chunk56UI7LUR_cjs.TokenOpsSdkError) return error;
+  if (error instanceof chunk67OV5CX2_cjs.TokenOpsSdkError) return error;
   const zama = readZamaError(error);
   if (zama?.code) {
     switch (zama.code) {
       case "SIGNING_REJECTED":
-        return new chunk56UI7LUR_cjs.UserRejectedSignatureError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.UserRejectedSignatureError({ ...args, cause: error });
       case "SIGNING_FAILED":
-        return new chunk56UI7LUR_cjs.SigningFailedError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.SigningFailedError({ ...args, cause: error });
       case "RELAYER_REQUEST_FAILED":
-        return new chunk56UI7LUR_cjs.RelayerUnreachableError({
+        return new chunk67OV5CX2_cjs.RelayerUnreachableError({
           ...args,
           statusCode: zama.statusCode,
           cause: error
         });
       case "ENCRYPTION_FAILED":
-        return new chunk56UI7LUR_cjs.EncryptionFailedError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.EncryptionFailedError({ ...args, cause: error });
       case "DECRYPTION_FAILED":
-        return new chunk56UI7LUR_cjs.DecryptionFailedError({ ...args, cause: error });
+        return new chunk67OV5CX2_cjs.DecryptionFailedError({ ...args, cause: error });
       case "CONFIGURATION":
-        return new chunk56UI7LUR_cjs.InvalidArgumentError({
+        return new chunk67OV5CX2_cjs.InvalidArgumentError({
           method: args.method,
           argument: "config",
           reason: "Zama SDK configuration is invalid (chain id, type, or signer state).",
@@ -34,13 +34,13 @@ function mapZamaError(error, args) {
   const message = readMessage(error);
   if (message) {
     if (USER_REJECTION_PATTERNS.some((pat) => pat.test(message))) {
-      return new chunk56UI7LUR_cjs.UserRejectedSignatureError({ ...args, cause: error });
+      return new chunk67OV5CX2_cjs.UserRejectedSignatureError({ ...args, cause: error });
     }
     if (USER_DECRYPT_NOT_ALLOWED_PATTERNS.some((pat) => pat.test(message))) {
-      return new chunk56UI7LUR_cjs.UserDecryptNotAllowedError({ method: args.method, cause: error });
+      return new chunk67OV5CX2_cjs.UserDecryptNotAllowedError({ method: args.method, cause: error });
     }
     if (INVALID_INPUT_PATTERNS.some((pat) => pat.test(message))) {
-      return new chunk56UI7LUR_cjs.InvalidArgumentError({
+      return new chunk67OV5CX2_cjs.InvalidArgumentError({
         method: args.method,
         argument: "input",
         reason: "encrypted input value rejected by FHE SDK \u2014 see `error.cause` for details",
@@ -48,7 +48,7 @@ function mapZamaError(error, args) {
       });
     }
   }
-  return args.operation === "encrypt" ? new chunk56UI7LUR_cjs.EncryptionFailedError({ ...args, cause: error }) : new chunk56UI7LUR_cjs.DecryptionFailedError({ ...args, cause: error });
+  return args.operation === "encrypt" ? new chunk67OV5CX2_cjs.EncryptionFailedError({ ...args, cause: error }) : new chunk67OV5CX2_cjs.DecryptionFailedError({ ...args, cause: error });
 }
 function readZamaError(err) {
   if (typeof err !== "object" || err === null) return void 0;