@tokenops/sdk 1.1.1 → 1.5.1

package/dist/fhe/index.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkITQ7WKVC_cjs = require('../chunk-ITQ7WKVC.cjs');
+var chunkJYOTGRSO_cjs = require('../chunk-JYOTGRSO.cjs');
+var chunk2NCLOQ56_cjs = require('../chunk-2NCLOQ56.cjs');
+var chunkFAXIIH5R_cjs = require('../chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('../chunk-FWHYQZ5E.cjs');
-var chunk5SGMJADP_cjs = require('../chunk-5SGMJADP.cjs');
-var chunkQ7ARQSUH_cjs = require('../chunk-Q7ARQSUH.cjs');
-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');
 var sdk = require('@zama-fhe/sdk');
 
 // src/fhe/mock-encryptor.ts
@@ -216,18 +216,18 @@ var MOCK_ERC7984_MINT_ABI = [
 var UINT64_MAX = (1n << 64n) - 1n;
 async function mintMockERC7984(args) {
   const { publicClient, walletClient, account, waitForReceipt = true, telemetry } = args;
-  const token = chunkCQIPRNS7_cjs.normaliseAddress(args.token);
-  const to = chunkCQIPRNS7_cjs.normaliseAddress(args.to);
+  const token = chunkJK4XMMKM_cjs.normaliseAddress(args.token);
+  const to = chunkJK4XMMKM_cjs.normaliseAddress(args.to);
   return chunkVJKZWYYJ_cjs.withTelemetry(telemetry, "fhe.mintMockERC7984", async () => {
     const fromAccount = account ?? walletClient.account;
     if (!fromAccount) {
-      throw new chunk56UI7LUR_cjs.TokenOpsContractError(
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
         "mintMockERC7984: no account available \u2014 pass `account` explicitly or attach an account to the walletClient",
         { contract: "ERC7984", call: "mint" }
       );
     }
     if (args.amount < 0n || args.amount > UINT64_MAX) {
-      throw new chunk56UI7LUR_cjs.TokenOpsContractError(
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
         `mintMockERC7984: amount ${args.amount} out of uint64 range [0, ${UINT64_MAX}]`,
         { contract: "ERC7984", call: "mint", amount: args.amount.toString() }
       );
@@ -245,7 +245,7 @@ async function mintMockERC7984(args) {
         chain: walletClient.chain
       });
     } catch (err) {
-      throw new chunk56UI7LUR_cjs.TokenOpsContractError(
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
         `mintMockERC7984: writeContract failed (token=${token}, to=${to})`,
         {
           contract: "ERC7984",
@@ -262,7 +262,7 @@ async function mintMockERC7984(args) {
         const receipt = await publicClient.waitForTransactionReceipt({ hash });
         blockNumber = receipt.blockNumber;
       } catch (err) {
-        throw new chunk56UI7LUR_cjs.TokenOpsContractError(`mintMockERC7984: receipt wait failed (tx=${hash})`, {
+        throw new chunk67OV5CX2_cjs.TokenOpsContractError(`mintMockERC7984: receipt wait failed (tx=${hash})`, {
           contract: "ERC7984",
           call: "mint",
           tx: hash,
@@ -274,7 +274,7 @@ async function mintMockERC7984(args) {
   });
 }
 function createMockErc7984Client(args) {
-  const address = chunkCQIPRNS7_cjs.normaliseAddress(args.address);
+  const address = chunkJK4XMMKM_cjs.normaliseAddress(args.address);
   const { publicClient, walletClient, telemetry } = args;
   return {
     address,
@@ -309,6 +309,14 @@ async function requirePeerDep2(spec, hint) {
 }
 async function createSepoliaEncryptor(options = {}) {
   const chainId = options.chainId ?? SEPOLIA_CHAIN_ID;
+  const firePhase = (phase) => {
+    if (!options.onPhase) return;
+    try {
+      options.onPhase(phase);
+    } catch {
+    }
+  };
+  firePhase("initializing");
   const zamaSdkNode = await requirePeerDep2(
     "@zama-fhe/sdk/node",
     "pnpm add @zama-fhe/sdk@^3"
@@ -337,11 +345,29 @@ async function createSepoliaEncryptor(options = {}) {
     fheArtifactStorage: options.fheArtifactStorage,
     fheArtifactCacheTTL: options.fheArtifactCacheTTL
   });
+  let initState = "idle";
   return {
     instance,
     chainId,
     async encrypt({ values, contractAddress, userAddress }) {
-      return instance.encrypt({ values, contractAddress, userAddress });
+      const startedInit = initState === "idle";
+      if (startedInit) {
+        initState = "in-flight";
+        firePhase("downloading-params");
+      }
+      try {
+        const result = await instance.encrypt({ values, contractAddress, userAddress });
+        if (initState !== "ready") {
+          initState = "ready";
+          firePhase("ready");
+        }
+        return result;
+      } catch (err) {
+        if (startedInit && initState === "in-flight") {
+          initState = "idle";
+        }
+        throw err;
+      }
     },
     terminate() {
       instance.terminate();
@@ -375,10 +401,26 @@ function createSepoliaEncryptorWeb(opts) {
     },
     ...opts.logger
   } : void 0;
+  const firePhase = (phase) => {
+    if (!opts.onPhase) return;
+    try {
+      opts.onPhase(phase);
+    } catch {
+    }
+  };
+  firePhase("initializing");
+  const onStatusChange = opts.onPhase ? (status) => {
+    if (status === "initializing") {
+      firePhase("downloading-params");
+    } else if (status === "ready") {
+      firePhase("ready");
+    }
+  } : void 0;
   const instance = new sdk.RelayerWeb({
     transports: { [chainId]: transportConfig },
     getChainId: () => Promise.resolve(chainId),
-    logger: safeLogger
+    logger: safeLogger,
+    onStatusChange
   });
   return Promise.resolve({
     instance,
@@ -394,199 +436,203 @@ function createSepoliaEncryptorWeb(opts) {
 
 Object.defineProperty(exports, "ERC7984_OPERATOR_MAX_DEADLINE", {
   enumerable: true,
-  get: function () { return chunkITQ7WKVC_cjs.ERC7984_OPERATOR_MAX_DEADLINE; }
+  get: function () { return chunkJYOTGRSO_cjs.ERC7984_OPERATOR_MAX_DEADLINE; }
 });
 Object.defineProperty(exports, "ERC7984_SET_OPERATOR_ABI", {
   enumerable: true,
-  get: function () { return chunkITQ7WKVC_cjs.ERC7984_SET_OPERATOR_ABI; }
+  get: function () { return chunkJYOTGRSO_cjs.ERC7984_SET_OPERATOR_ABI; }
 });
 Object.defineProperty(exports, "revokeOperator", {
   enumerable: true,
-  get: function () { return chunkITQ7WKVC_cjs.revokeOperator; }
+  get: function () { return chunkJYOTGRSO_cjs.revokeOperator; }
 });
 Object.defineProperty(exports, "setOperator", {
   enumerable: true,
-  get: function () { return chunkITQ7WKVC_cjs.setOperator; }
-});
-Object.defineProperty(exports, "erc7984OperatorAbi", {
-  enumerable: true,
-  get: function () { return chunkFWHYQZ5E_cjs.erc7984OperatorAbi; }
+  get: function () { return chunkJYOTGRSO_cjs.setOperator; }
 });
 Object.defineProperty(exports, "FHE_SPLIT_DENOMINATOR", {
   enumerable: true,
-  get: function () { return chunk5SGMJADP_cjs.FHE_SPLIT_DENOMINATOR; }
+  get: function () { return chunk2NCLOQ56_cjs.FHE_SPLIT_DENOMINATOR; }
 });
 Object.defineProperty(exports, "scaleRatio", {
   enumerable: true,
-  get: function () { return chunk5SGMJADP_cjs.scaleRatio; }
+  get: function () { return chunk2NCLOQ56_cjs.scaleRatio; }
 });
 Object.defineProperty(exports, "share", {
   enumerable: true,
-  get: function () { return chunk5SGMJADP_cjs.share; }
+  get: function () { return chunk2NCLOQ56_cjs.share; }
 });
 Object.defineProperty(exports, "ACL_ALLOWED_EVENT", {
   enumerable: true,
-  get: function () { return chunkQ7ARQSUH_cjs.ACL_ALLOWED_EVENT; }
+  get: function () { return chunkFAXIIH5R_cjs.ACL_ALLOWED_EVENT; }
 });
 Object.defineProperty(exports, "FHEVM_ACL_ADDRESS_BY_CHAIN", {
   enumerable: true,
-  get: function () { return chunkQ7ARQSUH_cjs.FHEVM_ACL_ADDRESS_BY_CHAIN; }
+  get: function () { return chunkFAXIIH5R_cjs.FHEVM_ACL_ADDRESS_BY_CHAIN; }
 });
 Object.defineProperty(exports, "getFhevmAclAddress", {
   enumerable: true,
-  get: function () { return chunkQ7ARQSUH_cjs.getFhevmAclAddress; }
+  get: function () { return chunkFAXIIH5R_cjs.getFhevmAclAddress; }
 });
 Object.defineProperty(exports, "requireFhevmAclAddress", {
   enumerable: true,
-  get: function () { return chunkQ7ARQSUH_cjs.requireFhevmAclAddress; }
+  get: function () { return chunkFAXIIH5R_cjs.requireFhevmAclAddress; }
+});
+Object.defineProperty(exports, "erc7984OperatorAbi", {
+  enumerable: true,
+  get: function () { return chunkFWHYQZ5E_cjs.erc7984OperatorAbi; }
 });
 Object.defineProperty(exports, "AccessDeniedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.AccessDeniedError; }
+  get: function () { return chunk67OV5CX2_cjs.AccessDeniedError; }
 });
 Object.defineProperty(exports, "AlreadyInitializedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.AlreadyInitializedError; }
+  get: function () { return chunk67OV5CX2_cjs.AlreadyInitializedError; }
 });
 Object.defineProperty(exports, "BatchTooLargeError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.BatchTooLargeError; }
+  get: function () { return chunk67OV5CX2_cjs.BatchTooLargeError; }
 });
 Object.defineProperty(exports, "ContractRevertError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ContractRevertError; }
+  get: function () { return chunk67OV5CX2_cjs.ContractRevertError; }
 });
 Object.defineProperty(exports, "DecryptionFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.DecryptionFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.DecryptionFailedError; }
 });
 Object.defineProperty(exports, "DeploymentAddressUnavailableError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.DeploymentAddressUnavailableError; }
+  get: function () { return chunk67OV5CX2_cjs.DeploymentAddressUnavailableError; }
 });
 Object.defineProperty(exports, "EncryptionFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.EncryptionFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.EncryptionFailedError; }
 });
 Object.defineProperty(exports, "FeatureDisabledError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.FeatureDisabledError; }
+  get: function () { return chunk67OV5CX2_cjs.FeatureDisabledError; }
 });
 Object.defineProperty(exports, "FheHandleNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.FheHandleNotAllowedError; }
+  get: function () { return chunk67OV5CX2_cjs.FheHandleNotAllowedError; }
 });
 Object.defineProperty(exports, "InsufficientBalanceError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InsufficientBalanceError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientBalanceError; }
 });
 Object.defineProperty(exports, "InsufficientFeeError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InsufficientFeeError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientFeeError; }
 });
 Object.defineProperty(exports, "InsufficientGasFundsError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InsufficientGasFundsError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientGasFundsError; }
 });
 Object.defineProperty(exports, "InvalidArgumentError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InvalidArgumentError; }
+  get: function () { return chunk67OV5CX2_cjs.InvalidArgumentError; }
 });
 Object.defineProperty(exports, "InvalidSignatureError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.InvalidSignatureError; }
+  get: function () { return chunk67OV5CX2_cjs.InvalidSignatureError; }
 });
 Object.defineProperty(exports, "MissingAccountError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingAccountError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingAccountError; }
 });
 Object.defineProperty(exports, "MissingClientError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingClientError; }
 });
 Object.defineProperty(exports, "MissingEncryptorError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingEncryptorError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingEncryptorError; }
 });
 Object.defineProperty(exports, "MissingPublicClientError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingPublicClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingPublicClientError; }
 });
 Object.defineProperty(exports, "MissingWalletClientError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.MissingWalletClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingWalletClientError; }
 });
 Object.defineProperty(exports, "NetworkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.NetworkError; }
+  get: function () { return chunk67OV5CX2_cjs.NetworkError; }
+});
+Object.defineProperty(exports, "OperatorNotApprovedError", {
+  enumerable: true,
+  get: function () { return chunk67OV5CX2_cjs.OperatorNotApprovedError; }
 });
 Object.defineProperty(exports, "PausedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.PausedError; }
+  get: function () { return chunk67OV5CX2_cjs.PausedError; }
 });
 Object.defineProperty(exports, "ReceiptEventAmbiguousError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ReceiptEventAmbiguousError; }
+  get: function () { return chunk67OV5CX2_cjs.ReceiptEventAmbiguousError; }
 });
 Object.defineProperty(exports, "ReceiptEventNotFoundError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ReceiptEventNotFoundError; }
+  get: function () { return chunk67OV5CX2_cjs.ReceiptEventNotFoundError; }
 });
 Object.defineProperty(exports, "ReentrancyError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.ReentrancyError; }
+  get: function () { return chunk67OV5CX2_cjs.ReentrancyError; }
 });
 Object.defineProperty(exports, "RelayerUnreachableError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.RelayerUnreachableError; }
+  get: function () { return chunk67OV5CX2_cjs.RelayerUnreachableError; }
 });
 Object.defineProperty(exports, "SigningFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.SigningFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.SigningFailedError; }
 });
 Object.defineProperty(exports, "TokenOpsContractError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsContractError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsContractError; }
 });
 Object.defineProperty(exports, "TokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsSdkError; }
 });
 Object.defineProperty(exports, "TokenOpsValidationError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsValidationError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsValidationError; }
 });
 Object.defineProperty(exports, "TransferFailedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TransferFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.TransferFailedError; }
 });
 Object.defineProperty(exports, "UnknownWriteFailureError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UnknownWriteFailureError; }
+  get: function () { return chunk67OV5CX2_cjs.UnknownWriteFailureError; }
 });
 Object.defineProperty(exports, "UnsupportedChainError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UnsupportedChainError; }
+  get: function () { return chunk67OV5CX2_cjs.UnsupportedChainError; }
 });
 Object.defineProperty(exports, "UserDecryptNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UserDecryptNotAllowedError; }
+  get: function () { return chunk67OV5CX2_cjs.UserDecryptNotAllowedError; }
 });
 Object.defineProperty(exports, "UserRejectedSignatureError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.UserRejectedSignatureError; }
+  get: function () { return chunk67OV5CX2_cjs.UserRejectedSignatureError; }
 });
 Object.defineProperty(exports, "WalletChainMismatchError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.WalletChainMismatchError; }
+  get: function () { return chunk67OV5CX2_cjs.WalletChainMismatchError; }
 });
 Object.defineProperty(exports, "WalletRejectedError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.WalletRejectedError; }
+  get: function () { return chunk67OV5CX2_cjs.WalletRejectedError; }
 });
 Object.defineProperty(exports, "isTokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.isTokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.isTokenOpsSdkError; }
 });
 exports.MAINNET_CHAIN_ID = MAINNET_CHAIN_ID;
 exports.MOCK_ERC7984_MINT_ABI = MOCK_ERC7984_MINT_ABI;

package/dist/fhe/index.d.cts

@@ -7,5 +7,5 @@ export * from "./sepolia-encryptor.js";
 export * from "./sepolia-encryptor-web.js";
 export * from "./types.js";
 export { erc7984OperatorAbi } from "./erc7984-abi.js";
-export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, PausedError, AccessDeniedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../core/errors.js";
+export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, PausedError, AccessDeniedError, OperatorNotApprovedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../core/errors.js";
 export { type PreflightResult } from "../core/preflight.js";

package/dist/fhe/index.d.ts

@@ -7,5 +7,5 @@ export * from "./sepolia-encryptor.js";
 export * from "./sepolia-encryptor-web.js";
 export * from "./types.js";
 export { erc7984OperatorAbi } from "./erc7984-abi.js";
-export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, PausedError, AccessDeniedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../core/errors.js";
+export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, PausedError, AccessDeniedError, OperatorNotApprovedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../core/errors.js";
 export { type PreflightResult } from "../core/preflight.js";

package/dist/fhe/index.js

@@ -1,11 +1,11 @@
-export { ERC7984_OPERATOR_MAX_DEADLINE, ERC7984_SET_OPERATOR_ABI, revokeOperator, setOperator } from '../chunk-WRCUDSUJ.js';
+export { ERC7984_OPERATOR_MAX_DEADLINE, ERC7984_SET_OPERATOR_ABI, revokeOperator, setOperator } from '../chunk-6BMP4ICG.js';
+export { FHE_SPLIT_DENOMINATOR, scaleRatio, share } from '../chunk-AOP6HMPW.js';
+export { ACL_ALLOWED_EVENT, FHEVM_ACL_ADDRESS_BY_CHAIN, getFhevmAclAddress, requireFhevmAclAddress } from '../chunk-ZWXJTBZO.js';
 export { erc7984OperatorAbi } from '../chunk-7VELUOMI.js';
-export { FHE_SPLIT_DENOMINATOR, scaleRatio, share } from '../chunk-XSNLAS5M.js';
-export { ACL_ALLOWED_EVENT, FHEVM_ACL_ADDRESS_BY_CHAIN, getFhevmAclAddress, requireFhevmAclAddress } from '../chunk-FYQ2UW4T.js';
-import { normaliseAddress } from '../chunk-BE2AIZ3K.js';
+import { normaliseAddress } from '../chunk-ZA673I3O.js';
 import { withTelemetry } from '../chunk-Q2GP5UDC.js';
-import { TokenOpsContractError } from '../chunk-IVE3QEGD.js';
-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 } from '../chunk-IVE3QEGD.js';
+import { TokenOpsContractError } from '../chunk-QBJ7O2B4.js';
+export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, OperatorNotApprovedError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError } from '../chunk-QBJ7O2B4.js';
 import { RelayerWeb, MainnetConfig, SepoliaConfig } from '@zama-fhe/sdk';
 
 // src/fhe/mock-encryptor.ts
@@ -308,6 +308,14 @@ async function requirePeerDep2(spec, hint) {
 }
 async function createSepoliaEncryptor(options = {}) {
   const chainId = options.chainId ?? SEPOLIA_CHAIN_ID;
+  const firePhase = (phase) => {
+    if (!options.onPhase) return;
+    try {
+      options.onPhase(phase);
+    } catch {
+    }
+  };
+  firePhase("initializing");
   const zamaSdkNode = await requirePeerDep2(
     "@zama-fhe/sdk/node",
     "pnpm add @zama-fhe/sdk@^3"
@@ -336,11 +344,29 @@ async function createSepoliaEncryptor(options = {}) {
     fheArtifactStorage: options.fheArtifactStorage,
     fheArtifactCacheTTL: options.fheArtifactCacheTTL
   });
+  let initState = "idle";
   return {
     instance,
     chainId,
     async encrypt({ values, contractAddress, userAddress }) {
-      return instance.encrypt({ values, contractAddress, userAddress });
+      const startedInit = initState === "idle";
+      if (startedInit) {
+        initState = "in-flight";
+        firePhase("downloading-params");
+      }
+      try {
+        const result = await instance.encrypt({ values, contractAddress, userAddress });
+        if (initState !== "ready") {
+          initState = "ready";
+          firePhase("ready");
+        }
+        return result;
+      } catch (err) {
+        if (startedInit && initState === "in-flight") {
+          initState = "idle";
+        }
+        throw err;
+      }
     },
     terminate() {
       instance.terminate();
@@ -374,10 +400,26 @@ function createSepoliaEncryptorWeb(opts) {
     },
     ...opts.logger
   } : void 0;
+  const firePhase = (phase) => {
+    if (!opts.onPhase) return;
+    try {
+      opts.onPhase(phase);
+    } catch {
+    }
+  };
+  firePhase("initializing");
+  const onStatusChange = opts.onPhase ? (status) => {
+    if (status === "initializing") {
+      firePhase("downloading-params");
+    } else if (status === "ready") {
+      firePhase("ready");
+    }
+  } : void 0;
   const instance = new RelayerWeb({
     transports: { [chainId]: transportConfig },
     getChainId: () => Promise.resolve(chainId),
-    logger: safeLogger
+    logger: safeLogger,
+    onStatusChange
   });
   return Promise.resolve({
     instance,

package/dist/fhe/react/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 require('../../chunk-66IHPTOK.cjs');
-var chunk56UI7LUR_cjs = require('../../chunk-56UI7LUR.cjs');
+var chunk67OV5CX2_cjs = require('../../chunk-67OV5CX2.cjs');
 var react = require('react');
 
 function resolveUserDecryptor(source) {
@@ -35,7 +35,7 @@ function useDecryptedHandle(opts) {
       setState({
         status: "error",
         value: void 0,
-        error: new chunk56UI7LUR_cjs.TokenOpsValidationError(
+        error: new chunk67OV5CX2_cjs.TokenOpsValidationError(
           "useDecryptedHandle: no `userDecryptor` resolved \u2014 pass `userDecryptor: () => useZamaSDK().relayer` (or an eager RelayerSDK / MockFhevmInstance).",
           { method: "useDecryptedHandle" }
         )
@@ -52,7 +52,7 @@ function useDecryptedHandle(opts) {
         });
         const plain = result[handleStr];
         if (plain === void 0) {
-          throw new chunk56UI7LUR_cjs.TokenOpsValidationError(
+          throw new chunk67OV5CX2_cjs.TokenOpsValidationError(
             `useDecryptedHandle: relayer returned no value for handle ${handleStr} on contract ${contractStr} \u2014 check ACL grant + (handle, contractAddress, userAddress) triple`,
             { method: "useDecryptedHandle", contractAddress: contractStr }
           );
@@ -85,18 +85,18 @@ function serializableSlice(v) {
 
 Object.defineProperty(exports, "TokenOpsContractError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsContractError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsContractError; }
 });
 Object.defineProperty(exports, "TokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsSdkError; }
 });
 Object.defineProperty(exports, "TokenOpsValidationError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.TokenOpsValidationError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsValidationError; }
 });
 Object.defineProperty(exports, "isTokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk56UI7LUR_cjs.isTokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.isTokenOpsSdkError; }
 });
 exports.useDecryptedHandle = useDecryptedHandle;

package/dist/fhe/react/index.js

@@ -1,6 +1,6 @@
 import '../../chunk-KWFFIJYX.js';
-import { TokenOpsValidationError } from '../../chunk-IVE3QEGD.js';
-export { TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, isTokenOpsSdkError } from '../../chunk-IVE3QEGD.js';
+import { TokenOpsValidationError } from '../../chunk-QBJ7O2B4.js';
+export { TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, isTokenOpsSdkError } from '../../chunk-QBJ7O2B4.js';
 import { useState, useRef, useEffect } from 'react';
 
 function resolveUserDecryptor(source) {

package/dist/fhe/sepolia-encryptor-web.d.ts

@@ -1,6 +1,6 @@
 import type { PublicClient, WalletClient } from "viem";
 import type { Encryptor } from "../fhe-vesting/encryption.js";
-import { type SepoliaEncryptorLogger } from "./sepolia-encryptor.js";
+import { type EncryptorInitPhase, type SepoliaEncryptorLogger } from "./sepolia-encryptor.js";
 /**
  * Configuration for {@link createSepoliaEncryptorWeb}. Minimal by design:
  * the browser path doesn't expose worker pool sizing or storage knobs (the
@@ -42,6 +42,32 @@ export interface CreateSepoliaEncryptorWebOpts {
      * background on why).
      */
     logger?: SepoliaEncryptorLogger;
+    /**
+     * Observe the encryptor's initialization lifecycle (see
+     * {@link EncryptorInitPhase}) — the signal to drive a loading state around
+     * the first in-browser encryption, which downloads several MB of FHE
+     * public material.
+     *
+     * `RelayerWeb` initializes lazily (Web Worker spawn + FHE param fetch
+     * happen inside the first operation), so phases map onto its REAL status
+     * events, not timers:
+     *
+     * - `"initializing"` fires synchronously while this helper constructs the
+     *   `RelayerWeb` instance.
+     * - `"downloading-params"` fires when the worker's lazy init actually
+     *   starts (upstream status `"initializing"`) — worker bring-up plus the
+     *   FHE public key + params fetch. Near-instant when the IndexedDB
+     *   artifact cache is warm.
+     * - `"ready"` fires when upstream reports `"ready"`.
+     *
+     * `"downloading-params"` / `"ready"` can fire again if the underlying
+     * relayer re-initializes (chain switch, stale artifact cache). Init
+     * failures surface as rejections from the pending operation — there is no
+     * error phase. No fake progress: no percentages, byte counts, or timers —
+     * upstream exposes no download-progress API. Callback exceptions are
+     * swallowed so a UI observer can never break encryption.
+     */
+    onPhase?: (phase: EncryptorInitPhase) => void;
 }
 /**
  * Returned by {@link createSepoliaEncryptorWeb}. Same structural