@tokenops/sdk 1.6.0 → 2.0.0-alpha.2

package/dist/fhe/index.cjs

@@ -1,11 +1,12 @@
 'use strict';
 
-var chunk4ZCXK4VI_cjs = require('../chunk-4ZCXK4VI.cjs');
-var chunkBD4LZBVF_cjs = require('../chunk-BD4LZBVF.cjs');
-var chunkSYHNZSZZ_cjs = require('../chunk-SYHNZSZZ.cjs');
+var chunkKFRDLKMA_cjs = require('../chunk-KFRDLKMA.cjs');
+var chunk3QHNYEQD_cjs = require('../chunk-3QHNYEQD.cjs');
+var chunkFAXIIH5R_cjs = require('../chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('../chunk-FWHYQZ5E.cjs');
-var chunkVR3FREBX_cjs = require('../chunk-VR3FREBX.cjs');
-var chunk2RNW4MIJ_cjs = require('../chunk-2RNW4MIJ.cjs');
+var chunkJK4XMMKM_cjs = require('../chunk-JK4XMMKM.cjs');
+require('../chunk-66IHPTOK.cjs');
+var chunk67OV5CX2_cjs = require('../chunk-67OV5CX2.cjs');
 var chunkVJKZWYYJ_cjs = require('../chunk-VJKZWYYJ.cjs');
 var sdk = require('@zama-fhe/sdk');
 
@@ -217,18 +218,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 = chunkVR3FREBX_cjs.normaliseAddress(args.token);
-  const to = chunkVR3FREBX_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 chunk2RNW4MIJ_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 chunk2RNW4MIJ_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() }
       );
@@ -246,7 +247,7 @@ async function mintMockERC7984(args) {
         chain: walletClient.chain
       });
     } catch (err) {
-      throw new chunk2RNW4MIJ_cjs.TokenOpsContractError(
+      throw new chunk67OV5CX2_cjs.TokenOpsContractError(
         `mintMockERC7984: writeContract failed (token=${token}, to=${to})`,
         {
           contract: "ERC7984",
@@ -263,7 +264,7 @@ async function mintMockERC7984(args) {
         const receipt = await publicClient.waitForTransactionReceipt({ hash });
         blockNumber = receipt.blockNumber;
       } catch (err) {
-        throw new chunk2RNW4MIJ_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,
@@ -275,7 +276,7 @@ async function mintMockERC7984(args) {
   });
 }
 function createMockErc7984Client(args) {
-  const address = chunkVR3FREBX_cjs.normaliseAddress(args.address);
+  const address = chunkJK4XMMKM_cjs.normaliseAddress(args.address);
   const { publicClient, walletClient, telemetry } = args;
   return {
     address,
@@ -448,55 +449,55 @@ function createSepoliaEncryptorWeb(opts) {
 
 Object.defineProperty(exports, "ERC7984_OPERATOR_MAX_DEADLINE", {
   enumerable: true,
-  get: function () { return chunk4ZCXK4VI_cjs.ERC7984_OPERATOR_MAX_DEADLINE; }
+  get: function () { return chunkKFRDLKMA_cjs.ERC7984_OPERATOR_MAX_DEADLINE; }
 });
 Object.defineProperty(exports, "ERC7984_SET_OPERATOR_ABI", {
   enumerable: true,
-  get: function () { return chunk4ZCXK4VI_cjs.ERC7984_SET_OPERATOR_ABI; }
+  get: function () { return chunkKFRDLKMA_cjs.ERC7984_SET_OPERATOR_ABI; }
 });
 Object.defineProperty(exports, "ensureOperator", {
   enumerable: true,
-  get: function () { return chunk4ZCXK4VI_cjs.ensureOperator; }
+  get: function () { return chunkKFRDLKMA_cjs.ensureOperator; }
 });
 Object.defineProperty(exports, "isOperator", {
   enumerable: true,
-  get: function () { return chunk4ZCXK4VI_cjs.isOperator; }
+  get: function () { return chunkKFRDLKMA_cjs.isOperator; }
 });
 Object.defineProperty(exports, "revokeOperator", {
   enumerable: true,
-  get: function () { return chunk4ZCXK4VI_cjs.revokeOperator; }
+  get: function () { return chunkKFRDLKMA_cjs.revokeOperator; }
 });
 Object.defineProperty(exports, "setOperator", {
   enumerable: true,
-  get: function () { return chunk4ZCXK4VI_cjs.setOperator; }
+  get: function () { return chunkKFRDLKMA_cjs.setOperator; }
 });
 Object.defineProperty(exports, "FHE_SPLIT_DENOMINATOR", {
   enumerable: true,
-  get: function () { return chunkBD4LZBVF_cjs.FHE_SPLIT_DENOMINATOR; }
+  get: function () { return chunk3QHNYEQD_cjs.FHE_SPLIT_DENOMINATOR; }
 });
 Object.defineProperty(exports, "scaleRatio", {
   enumerable: true,
-  get: function () { return chunkBD4LZBVF_cjs.scaleRatio; }
+  get: function () { return chunk3QHNYEQD_cjs.scaleRatio; }
 });
 Object.defineProperty(exports, "share", {
   enumerable: true,
-  get: function () { return chunkBD4LZBVF_cjs.share; }
+  get: function () { return chunk3QHNYEQD_cjs.share; }
 });
 Object.defineProperty(exports, "ACL_ALLOWED_EVENT", {
   enumerable: true,
-  get: function () { return chunkSYHNZSZZ_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 chunkSYHNZSZZ_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 chunkSYHNZSZZ_cjs.getFhevmAclAddress; }
+  get: function () { return chunkFAXIIH5R_cjs.getFhevmAclAddress; }
 });
 Object.defineProperty(exports, "requireFhevmAclAddress", {
   enumerable: true,
-  get: function () { return chunkSYHNZSZZ_cjs.requireFhevmAclAddress; }
+  get: function () { return chunkFAXIIH5R_cjs.requireFhevmAclAddress; }
 });
 Object.defineProperty(exports, "erc7984OperatorAbi", {
   enumerable: true,
@@ -504,155 +505,155 @@ Object.defineProperty(exports, "erc7984OperatorAbi", {
 });
 Object.defineProperty(exports, "AccessDeniedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.AccessDeniedError; }
+  get: function () { return chunk67OV5CX2_cjs.AccessDeniedError; }
 });
 Object.defineProperty(exports, "AlreadyInitializedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.AlreadyInitializedError; }
+  get: function () { return chunk67OV5CX2_cjs.AlreadyInitializedError; }
 });
 Object.defineProperty(exports, "BatchTooLargeError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.BatchTooLargeError; }
+  get: function () { return chunk67OV5CX2_cjs.BatchTooLargeError; }
 });
 Object.defineProperty(exports, "ContractRevertError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.ContractRevertError; }
+  get: function () { return chunk67OV5CX2_cjs.ContractRevertError; }
 });
 Object.defineProperty(exports, "DecryptionFailedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.DecryptionFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.DecryptionFailedError; }
 });
 Object.defineProperty(exports, "DeploymentAddressUnavailableError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.DeploymentAddressUnavailableError; }
+  get: function () { return chunk67OV5CX2_cjs.DeploymentAddressUnavailableError; }
 });
 Object.defineProperty(exports, "EncryptionFailedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.EncryptionFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.EncryptionFailedError; }
 });
 Object.defineProperty(exports, "FeatureDisabledError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.FeatureDisabledError; }
+  get: function () { return chunk67OV5CX2_cjs.FeatureDisabledError; }
 });
 Object.defineProperty(exports, "FheHandleNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.FheHandleNotAllowedError; }
+  get: function () { return chunk67OV5CX2_cjs.FheHandleNotAllowedError; }
 });
 Object.defineProperty(exports, "InsufficientBalanceError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.InsufficientBalanceError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientBalanceError; }
 });
 Object.defineProperty(exports, "InsufficientFeeError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.InsufficientFeeError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientFeeError; }
 });
 Object.defineProperty(exports, "InsufficientGasFundsError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.InsufficientGasFundsError; }
+  get: function () { return chunk67OV5CX2_cjs.InsufficientGasFundsError; }
 });
 Object.defineProperty(exports, "InvalidArgumentError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.InvalidArgumentError; }
+  get: function () { return chunk67OV5CX2_cjs.InvalidArgumentError; }
 });
 Object.defineProperty(exports, "InvalidSignatureError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.InvalidSignatureError; }
+  get: function () { return chunk67OV5CX2_cjs.InvalidSignatureError; }
 });
 Object.defineProperty(exports, "MissingAccountError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.MissingAccountError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingAccountError; }
 });
 Object.defineProperty(exports, "MissingClientError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.MissingClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingClientError; }
 });
 Object.defineProperty(exports, "MissingEncryptorError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.MissingEncryptorError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingEncryptorError; }
 });
 Object.defineProperty(exports, "MissingPublicClientError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.MissingPublicClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingPublicClientError; }
 });
 Object.defineProperty(exports, "MissingWalletClientError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.MissingWalletClientError; }
+  get: function () { return chunk67OV5CX2_cjs.MissingWalletClientError; }
 });
 Object.defineProperty(exports, "NetworkError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.NetworkError; }
+  get: function () { return chunk67OV5CX2_cjs.NetworkError; }
 });
 Object.defineProperty(exports, "OperatorNotApprovedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.OperatorNotApprovedError; }
+  get: function () { return chunk67OV5CX2_cjs.OperatorNotApprovedError; }
 });
 Object.defineProperty(exports, "PausedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.PausedError; }
+  get: function () { return chunk67OV5CX2_cjs.PausedError; }
 });
 Object.defineProperty(exports, "ReceiptEventAmbiguousError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.ReceiptEventAmbiguousError; }
+  get: function () { return chunk67OV5CX2_cjs.ReceiptEventAmbiguousError; }
 });
 Object.defineProperty(exports, "ReceiptEventNotFoundError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.ReceiptEventNotFoundError; }
+  get: function () { return chunk67OV5CX2_cjs.ReceiptEventNotFoundError; }
 });
 Object.defineProperty(exports, "ReentrancyError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.ReentrancyError; }
+  get: function () { return chunk67OV5CX2_cjs.ReentrancyError; }
 });
 Object.defineProperty(exports, "RelayerUnreachableError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.RelayerUnreachableError; }
+  get: function () { return chunk67OV5CX2_cjs.RelayerUnreachableError; }
 });
 Object.defineProperty(exports, "SigningFailedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.SigningFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.SigningFailedError; }
 });
 Object.defineProperty(exports, "TokenOpsContractError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.TokenOpsContractError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsContractError; }
 });
 Object.defineProperty(exports, "TokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.TokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsSdkError; }
 });
 Object.defineProperty(exports, "TokenOpsValidationError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.TokenOpsValidationError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsValidationError; }
 });
 Object.defineProperty(exports, "TransferFailedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.TransferFailedError; }
+  get: function () { return chunk67OV5CX2_cjs.TransferFailedError; }
 });
 Object.defineProperty(exports, "UnknownWriteFailureError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.UnknownWriteFailureError; }
+  get: function () { return chunk67OV5CX2_cjs.UnknownWriteFailureError; }
 });
 Object.defineProperty(exports, "UnsupportedChainError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.UnsupportedChainError; }
+  get: function () { return chunk67OV5CX2_cjs.UnsupportedChainError; }
 });
 Object.defineProperty(exports, "UserDecryptNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.UserDecryptNotAllowedError; }
+  get: function () { return chunk67OV5CX2_cjs.UserDecryptNotAllowedError; }
 });
 Object.defineProperty(exports, "UserRejectedSignatureError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.UserRejectedSignatureError; }
+  get: function () { return chunk67OV5CX2_cjs.UserRejectedSignatureError; }
 });
 Object.defineProperty(exports, "WalletChainMismatchError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.WalletChainMismatchError; }
+  get: function () { return chunk67OV5CX2_cjs.WalletChainMismatchError; }
 });
 Object.defineProperty(exports, "WalletRejectedError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.WalletRejectedError; }
+  get: function () { return chunk67OV5CX2_cjs.WalletRejectedError; }
 });
 Object.defineProperty(exports, "isTokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_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.js

@@ -1,10 +1,11 @@
-export { ERC7984_OPERATOR_MAX_DEADLINE, ERC7984_SET_OPERATOR_ABI, ensureOperator, isOperator, revokeOperator, setOperator } from '../chunk-4KJ66YRH.js';
-export { FHE_SPLIT_DENOMINATOR, scaleRatio, share } from '../chunk-PD7ME2BT.js';
-export { ACL_ALLOWED_EVENT, FHEVM_ACL_ADDRESS_BY_CHAIN, getFhevmAclAddress, requireFhevmAclAddress } from '../chunk-YPYCWLYP.js';
+export { ERC7984_OPERATOR_MAX_DEADLINE, ERC7984_SET_OPERATOR_ABI, ensureOperator, isOperator, revokeOperator, setOperator } from '../chunk-4TSDNZQ3.js';
+export { FHE_SPLIT_DENOMINATOR, scaleRatio, share } from '../chunk-6GNR22OV.js';
+export { ACL_ALLOWED_EVENT, FHEVM_ACL_ADDRESS_BY_CHAIN, getFhevmAclAddress, requireFhevmAclAddress } from '../chunk-ZWXJTBZO.js';
 export { erc7984OperatorAbi } from '../chunk-7VELUOMI.js';
-import { normaliseAddress } from '../chunk-46T67CE2.js';
-import { TokenOpsContractError } from '../chunk-DRSPMIZ7.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-DRSPMIZ7.js';
+import { normaliseAddress } from '../chunk-ZA673I3O.js';
+import '../chunk-KWFFIJYX.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 { withTelemetry } from '../chunk-Q2GP5UDC.js';
 import { RelayerWeb, MainnetConfig, SepoliaConfig } from '@zama-fhe/sdk';
 

package/dist/fhe/operators.d.ts

@@ -14,6 +14,7 @@ import { type SdkTelemetry } from "../core/telemetry.js";
  *
  * `uint48` upper bound (`2**48 - 1 ≈ 8.9e+14`) is comfortably past year 9999
  * in unix seconds, so a "far-future" deadline is structurally safe.
+ * @public
  */
 export declare const ERC7984_SET_OPERATOR_ABI: readonly [{
     readonly type: "function";
@@ -35,8 +36,10 @@ export declare const ERC7984_SET_OPERATOR_ABI: readonly [{
  * about expiry — typical for local-chain dev loops and end-to-end fixture
  * setup. For production flows, scope the deadline to the expected operation
  * window (e.g. `Date.now()/1000 + 3600`).
+ * @public
  */
 export declare const ERC7984_OPERATOR_MAX_DEADLINE: bigint;
+/** @public */
 export interface SetOperatorArgs {
     /** Read-only viem client for receipt waiting. */
     publicClient: PublicClient;
@@ -113,11 +116,12 @@ export interface SetOperatorArgs {
  *   // deadline defaults to ERC7984_OPERATOR_MAX_DEADLINE (forever).
  * });
  *
- * // Now safe to call manager.createVesting / factory.fundConfidentialAirdrop / etc.
+ * // Now safe to call manager.createVesting / factory.fundAirdrop / etc.
  * ```
  *
  * @throws {@link TokenOpsContractError} if the writeContract or receipt-wait
  *   step throws. The original viem error is attached as the cause.
+ * @public
  */
 export declare function setOperator(args: SetOperatorArgs): Promise<Hex>;
 /**
@@ -125,6 +129,7 @@ export declare function setOperator(args: SetOperatorArgs): Promise<Hex>;
  * minus the `deadline` field — revoke is a fixed `until=0` call that cannot
  * accept a non-zero deadline (the ERC-7984 contract treats `0` as the revoke
  * convention; any non-zero `until` would be a re-grant, not a revoke).
+ * @public
  */
 export interface RevokeOperatorArgs {
     /** Read-only viem client for receipt waiting. */
@@ -186,9 +191,14 @@ export interface RevokeOperatorArgs {
  *
  * @throws {@link TokenOpsContractError} if the writeContract or receipt-wait
  *   step throws. The original viem error is attached as the cause.
+ * @public
  */
 export declare function revokeOperator(args: RevokeOperatorArgs): Promise<Hex>;
-/** Arguments for {@link isOperator}. Read-only — no wallet required. */
+/**
+ * Arguments for {@link isOperator}. Read-only — no wallet required.
+ *
+ * @public
+ */
 export interface IsOperatorArgs {
     /** Read-only viem client the `isOperator` view call goes through. */
     publicClient: PublicClient;
@@ -236,6 +246,7 @@ export interface IsOperatorArgs {
  * @throws {@link TokenOpsContractError} if the read call itself fails (RPC
  *   error, non-ERC-7984 token). The original viem error is attached as the
  *   cause.
+ * @public
  */
 export declare function isOperator(args: IsOperatorArgs): Promise<boolean>;
 /**
@@ -245,6 +256,7 @@ export declare function isOperator(args: IsOperatorArgs): Promise<boolean>;
  * grant must be an explicit caller decision — the SDK refuses to default a
  * security-sensitive approval window (a silent
  * {@link ERC7984_OPERATOR_MAX_DEADLINE} would grant "forever").
+ * @public
  */
 export interface EnsureOperatorArgs {
     /** Read-only viem client for the `isOperator` pre-check + receipt waiting. */
@@ -277,7 +289,11 @@ export interface EnsureOperatorArgs {
     /** Optional telemetry sink — span emits as `fhe.ensureOperator`. */
     telemetry?: SdkTelemetry;
 }
-/** Result of {@link ensureOperator}. */
+/**
+ * Result of {@link ensureOperator}.
+ *
+ * @public
+ */
 export interface EnsureOperatorResult {
     /**
      * `true` when the authorization was already in place and no transaction
@@ -297,7 +313,7 @@ export interface EnsureOperatorResult {
  *
  * This is the recommended pre-step before any flow that pulls tokens from
  * the caller's balance (`createVesting` / `batchCreateVesting`,
- * `fundConfidentialAirdrop` / `createAndFundConfidentialAirdrop`, disperse
+ * `fundAirdrop` / `createAndFund{Ecdsa,Merkle}Airdrop`, disperse
  * registration) — skipping it fails with {@link OperatorNotApprovedError},
  * the SDK's mapping of the on-chain `ERC7984UnauthorizedSpender` revert,
  * whose message is the canonical {@link OPERATOR_NOT_APPROVED_REMEDIATION}
@@ -320,11 +336,12 @@ export interface EnsureOperatorResult {
  *   spender: manager,
  *   deadline: oneHour,
  * });
- * // Now safe to call manager.createVesting / factory.fundConfidentialAirdrop / etc.
+ * // Now safe to call manager.createVesting / factory.fundAirdrop / etc.
  * ```
  *
  * @throws {@link TokenOpsContractError} if no holder account can be
  *   resolved, if `deadline` is outside `(0, 2**48 - 1]`, or if the
  *   read/write/receipt step fails.
+ * @public
  */
 export declare function ensureOperator(args: EnsureOperatorArgs): Promise<EnsureOperatorResult>;

package/dist/fhe/react/index.cjs

@@ -1,11 +1,12 @@
 'use strict';
 
-var chunkWOEETTH7_cjs = require('../../chunk-WOEETTH7.cjs');
+var chunk7AFPOE7N_cjs = require('../../chunk-7AFPOE7N.cjs');
 require('../../chunk-ZQUE2B3Q.cjs');
-require('../../chunk-4ZCXK4VI.cjs');
+require('../../chunk-KFRDLKMA.cjs');
 require('../../chunk-FWHYQZ5E.cjs');
-require('../../chunk-VR3FREBX.cjs');
-var chunk2RNW4MIJ_cjs = require('../../chunk-2RNW4MIJ.cjs');
+require('../../chunk-JK4XMMKM.cjs');
+require('../../chunk-66IHPTOK.cjs');
+var chunk67OV5CX2_cjs = require('../../chunk-67OV5CX2.cjs');
 require('../../chunk-VJKZWYYJ.cjs');
 var react = require('react');
 
@@ -40,7 +41,7 @@ function useDecryptedHandle(opts) {
       setState({
         status: "error",
         value: void 0,
-        error: new chunk2RNW4MIJ_cjs.TokenOpsValidationError(
+        error: new chunk67OV5CX2_cjs.TokenOpsValidationError(
           "useDecryptedHandle: no `userDecryptor` resolved \u2014 pass `userDecryptor: () => useZamaSDK().relayer` (or an eager RelayerSDK / MockFhevmInstance).",
           { method: "useDecryptedHandle" }
         )
@@ -57,7 +58,7 @@ function useDecryptedHandle(opts) {
         });
         const plain = result[handleStr];
         if (plain === void 0) {
-          throw new chunk2RNW4MIJ_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 }
           );
@@ -90,26 +91,26 @@ function serializableSlice(v) {
 
 Object.defineProperty(exports, "useEnsureOperator", {
   enumerable: true,
-  get: function () { return chunkWOEETTH7_cjs.useEnsureOperator; }
+  get: function () { return chunk7AFPOE7N_cjs.useEnsureOperator; }
 });
 Object.defineProperty(exports, "useIsOperator", {
   enumerable: true,
-  get: function () { return chunkWOEETTH7_cjs.useIsOperator; }
+  get: function () { return chunk7AFPOE7N_cjs.useIsOperator; }
 });
 Object.defineProperty(exports, "TokenOpsContractError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.TokenOpsContractError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsContractError; }
 });
 Object.defineProperty(exports, "TokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.TokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsSdkError; }
 });
 Object.defineProperty(exports, "TokenOpsValidationError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.TokenOpsValidationError; }
+  get: function () { return chunk67OV5CX2_cjs.TokenOpsValidationError; }
 });
 Object.defineProperty(exports, "isTokenOpsSdkError", {
   enumerable: true,
-  get: function () { return chunk2RNW4MIJ_cjs.isTokenOpsSdkError; }
+  get: function () { return chunk67OV5CX2_cjs.isTokenOpsSdkError; }
 });
 exports.useDecryptedHandle = useDecryptedHandle;

package/dist/fhe/react/index.js

@@ -1,10 +1,11 @@
-export { useEnsureOperator, useIsOperator } from '../../chunk-U57COLUE.js';
+export { useEnsureOperator, useIsOperator } from '../../chunk-AXIPOR3C.js';
 import '../../chunk-FT4LNBOS.js';
-import '../../chunk-4KJ66YRH.js';
+import '../../chunk-4TSDNZQ3.js';
 import '../../chunk-7VELUOMI.js';
-import '../../chunk-46T67CE2.js';
-import { TokenOpsValidationError } from '../../chunk-DRSPMIZ7.js';
-export { TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, isTokenOpsSdkError } from '../../chunk-DRSPMIZ7.js';
+import '../../chunk-ZA673I3O.js';
+import '../../chunk-KWFFIJYX.js';
+import { TokenOpsValidationError } from '../../chunk-QBJ7O2B4.js';
+export { TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, isTokenOpsSdkError } from '../../chunk-QBJ7O2B4.js';
 import '../../chunk-Q2GP5UDC.js';
 import { useState, useRef, useEffect } from 'react';
 

package/dist/fhe/types.d.ts

@@ -13,6 +13,7 @@ import type { Hex } from "viem";
  * The current SDK only produces uint64 ciphertexts. If a future version
  * adds encryption helpers for other widths (e.g. `encryptUint128`), this
  * type may be specialised; existing uint64 usage will keep type-checking.
+ * @public
  */
 export interface EncryptedInput {
     handle: Hex;
@@ -24,6 +25,7 @@ export interface EncryptedInput {
  * encryptor returns from a batched `encrypt({ values: [...] })` call.
  *
  * `handles[i]` corresponds to the i-th plaintext value passed in.
+ * @public
  */
 export interface EncryptedInputs {
     handles: Hex[];
@@ -31,12 +33,13 @@ export interface EncryptedInputs {
 }
 /**
  * Return shape for SDK methods that perform an on-chain encrypted-view tx —
- * the contract emits `FHE.allow(handle, msg.sender)` and the SDK extracts
+ * the contract emits `FHE.allow(handle, grantee)` (usually `msg.sender`) and the SDK extracts
  * `handle` from the receipt's ACL `Allowed` event.
  *
- * Pass `handle` to the Zama relayer's `userDecrypt` to obtain the plaintext.
+ * Pass `handle` to the Zama relayer's `userDecrypt` to obtain the plaintext — AS THE GRANTEE. Most entrypoints grant the caller, but not all: `MerkleAirdropClient.getClaimAmount` grants the entry's `account`, so a third-party submitter receives a valid handle it is not authorised to read.
  * `hash` is the tx that committed the persistent ACL grant — surface it if
  * your UI needs to show the receipt.
+ * @public
  */
 export interface EncryptedViewResult {
     handle: Hex;
@@ -48,15 +51,18 @@ export interface EncryptedViewResult {
  * match the rest of the SDK or the on-chain calldata layout (the contracts
  * accept `bytes inputProof`). This alias points at the corrected shape and
  * will be removed in the next major.
+ * @public
  */
 export type EncryptedInput64 = EncryptedInput;
 /**
  * @deprecated Use `Hex` from `viem` directly. This alias added no narrowing
  * beyond `Hex` and will be removed in the next major.
+ * @public
  */
 export type EncryptedHandle = Hex;
 /**
  * @deprecated Use `Hex` from `viem` directly. This alias added no narrowing
  * beyond `Hex` and will be removed in the next major.
+ * @public
  */
 export type ExternalInputProof = Hex;