@tokenops/sdk 2.0.0-alpha.3 → 2.0.0-alpha.4

package/dist/{chunk-IEKTGJ4J.cjs → chunk-S47IBDTA.cjs}

@@ -2,9 +2,9 @@
 
 var chunkTEBM66WA_cjs = require('./chunk-TEBM66WA.cjs');
 var chunkFAXIIH5R_cjs = require('./chunk-FAXIIH5R.cjs');
-var chunkUG5RKLU2_cjs = require('./chunk-UG5RKLU2.cjs');
+var chunkSUYBAF27_cjs = require('./chunk-SUYBAF27.cjs');
 var chunkMVDQMV25_cjs = require('./chunk-MVDQMV25.cjs');
-var chunkPG3WXT3K_cjs = require('./chunk-PG3WXT3K.cjs');
+var chunkYAL6JSAZ_cjs = require('./chunk-YAL6JSAZ.cjs');
 var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
 var chunk67OV5CX2_cjs = require('./chunk-67OV5CX2.cjs');
@@ -2052,7 +2052,7 @@ var ConfidentialDisperseClient = class {
     this.#telemetry = config.telemetry;
     const chainId = config.chainId ?? config.publicClient.chain?.id;
     const addressOverride = config.address ? chunkJK4XMMKM_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkPG3WXT3K_cjs.getFheDisperseSingletonAddress(chainId));
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkYAL6JSAZ_cjs.getFheDisperseSingletonAddress(chainId));
     if (!resolved) {
       throw new chunk67OV5CX2_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
@@ -2069,7 +2069,7 @@ var ConfidentialDisperseClient = class {
       chainId: chainId ?? null,
       hasWallet: !!this.walletClient,
       aclResolved: !!config.aclAddress || chainId !== void 0 && !!chunkFAXIIH5R_cjs.getFhevmAclAddress(chainId),
-      sdkVersion: chunkUG5RKLU2_cjs.SDK_VERSION
+      sdkVersion: chunkSUYBAF27_cjs.SDK_VERSION
     });
   }
   /**
@@ -2274,7 +2274,8 @@ var ConfidentialDisperseClient = class {
    *
    * Internally composes:
    * - `isRegistered` + `getWallets` / `predictWallets`
-   * - `hasApprovedSubwallets` (wallet modes) or `isOperator(sender, singleton)` (direct mode)
+   * - `isOperator(sender, singleton)` (every mode: each one pulls from the sender) and,
+   *   for the wallet modes, `hasApprovedSubwallets` as well
    * - `calculateFee` / `getBatchLimits`
    * - Structural recipient + amount validation
    *
@@ -2289,12 +2290,25 @@ var ConfidentialDisperseClient = class {
     const { user, token, recipients, amounts, mode } = args;
     assertChecksumAddress(user, "user", "preflightDisperse");
     assertChecksumAddress(token, "token", "preflightDisperse");
-    const [isUserRegistered, predictedWallets, batchLimits, callerBalance, isPaused] = await Promise.all([
+    const [
+      isUserRegistered,
+      predictedWallets,
+      batchLimits,
+      callerBalance,
+      isPaused,
+      hasApprovedSingleton
+    ] = await Promise.all([
       this.isRegistered(user),
       this.predictWallets(user),
       this.getBatchLimits(),
       this.publicClient.getBalance({ address: user }),
-      this.paused()
+      this.paused(),
+      this.publicClient.readContract({
+        address: token,
+        abi: ERC7984_IS_OPERATOR_ABI,
+        functionName: "isOperator",
+        args: [user, this.address]
+      })
     ]);
     const wallets = isUserRegistered ? await this.getWallets(user) : null;
     let hasApprovedSubwallets = {
@@ -2302,15 +2316,7 @@ var ConfidentialDisperseClient = class {
       wallet1: false,
       both: false
     };
-    let hasApprovedSingleton = null;
-    if (mode === "direct") {
-      hasApprovedSingleton = await this.publicClient.readContract({
-        address: token,
-        abi: ERC7984_IS_OPERATOR_ABI,
-        functionName: "isOperator",
-        args: [user, this.address]
-      });
-    } else {
+    if (mode !== "direct") {
       if (isUserRegistered) {
         hasApprovedSubwallets = await this.hasApprovedSubwallets({ user, token });
       } else if (predictedWallets) {
@@ -2392,7 +2398,7 @@ var ConfidentialDisperseClient = class {
         );
       }
     }
-    if (mode === "direct" && hasApprovedSingleton === false) {
+    if (!hasApprovedSingleton) {
       blockers.push("Sender has not approved the singleton as operator on the token");
       blockerErrors.push(
         new SingletonNotApprovedError({
@@ -2441,18 +2447,6 @@ var ConfidentialDisperseClient = class {
       blockerErrors
     };
   }
-  // ============================================================
-  //                       WRITE METHODS
-  // ============================================================
-  /**
-   * Register the caller's dedicated wallet pair for wallet-mode disperses.
-   *
-   * Deploys two deterministic ERC-1167 wallet clones and approves them for `token`.
-   * Can only be called once per user — subsequent calls revert with `UserAlreadyRegistered`.
-   *
-   * @returns `{ hash, wallets }` — `wallets` is parsed from the `UserRegistered` event.
-   * @throws {DisperseSubwalletNotFoundError} if no `UserRegistered` event matching the singleton is found.
-   */
   async register(args) {
     return chunkVJKZWYYJ_cjs.withTelemetry(this.#telemetry, "fhe-disperse.singleton.register", async () => {
       assertChecksumAddress(args.token, "token", "register");
@@ -2475,6 +2469,9 @@ var ConfidentialDisperseClient = class {
       } catch (err) {
         throw this.#mapRevert("register", err, { user: userAddress }, userAddress);
       }
+      if (args.waitForReceipt === false) {
+        return { hash, wallets: void 0, pending: true };
+      }
       const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
       const events = viem.parseEventLogs({
         abi: disperseConfidentialAbi,
@@ -2534,32 +2531,6 @@ var ConfidentialDisperseClient = class {
     const user = this.#userAddressFromOverride(args.account, "recoverERC20FromWallets");
     return this.#write("recoverERC20FromWallets", [args.token, args.to], args.account, { user });
   }
-  /**
-   * Disperse confidential tokens to multiple recipients.
-   *
-   * SDK responsibilities:
-   * 1. Validates input deterministically (lengths, zero addresses, per-amount
-   *    uint64 bounds, wallet-mode subtotal overflow, batch-limit for the
-   *    selected mode) — using the same {@link validateDisperseInputs} helper
-   *    `preflightDisperse` uses, so an oversized or malformed batch is rejected
-   *    before any FHE encryption time is spent.
-   * 2. For wallet modes: computes group subtotals using the contract's exact split rule.
-   * 3. Encrypts amounts + subtotals in a single batch call (one input proof).
-   * 4. Computes `msg.value` for gas-fee modes; `0` for token-fee mode.
-   * 5. Dispatches to the correct contract function based on `mode`.
-   *
-   * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
-   *
-   * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
-   * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
-   * ERC-20. Amount parameters are base units of the token's actual decimals:
-   * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
-   * transparent TTT test token uses 18 decimals. Every entry of `amounts[]`
-   * follows this convention.
-   *
-   * @throws {TokenOpsSdkError} on input validation failure (first deterministic error).
-   * @throws {TokenOpsSdkError} if no encryptor is available at call time.
-   */
   async disperse(args) {
     return chunkVJKZWYYJ_cjs.withTelemetry(this.#telemetry, "fhe-disperse.singleton.disperse", async () => {
       const { token, mode, recipients, amounts } = args;
@@ -2592,7 +2563,8 @@ var ConfidentialDisperseClient = class {
           wallet,
           userAddr,
           enc,
-          gasFeeOverride: args.gasFeeOverride
+          gasFeeOverride: args.gasFeeOverride,
+          waitForReceipt: args.waitForReceipt
         });
       }
       return this.#disperseWallet({
@@ -2604,7 +2576,8 @@ var ConfidentialDisperseClient = class {
         wallet,
         userAddr,
         enc,
-        gasFeeOverride: args.gasFeeOverride
+        gasFeeOverride: args.gasFeeOverride,
+        waitForReceipt: args.waitForReceipt
       });
     });
   }
@@ -2865,32 +2838,6 @@ var ConfidentialDisperseClient = class {
     assertNonZeroChecksumAddress(to, "to", "withdrawGasFee");
     return this.#write("withdrawGasFee", [to, amount], account);
   }
-  /**
-   * Withdraw accumulated encrypted token fees.
-   *
-   * The amount is encrypted by the caller — pass plaintext `amount` and an
-   * encryptor, or pass `encryptedInput` directly. The contract caps the
-   * withdrawal at the available reserve via `FHE.min`.
-   *
-   * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
-   * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
-   * ERC-20. Amount parameters are base units of the token's actual decimals:
-   * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
-   * transparent TTT test token uses 18 decimals.
-   *
-   * Returns the tx hash plus the **transferred** handle parsed from the
-   * `TokenFeeWithdrawn` event. Decrypt the handle via Zama's `userDecrypt`
-   * to view the actual amount moved (which can be less than requested when
-   * the reserve was smaller than the request). The caller is granted
-   * persistent ACL on this handle by the contract.
-   *
-   * **`encryptedInput` is bound to (this singleton, this caller).** Zama's
-   * KMSVerifier rejects proofs whose `contractAddress` or `userAddress`
-   * don't match the executing tx. If you pre-encrypt on a different chain's
-   * singleton, or for a different caller, the on-chain submission will
-   * revert with a generic verification failure. The plaintext `amount`
-   * path is safer when the caller / chain isn't fixed yet.
-   */
   async withdrawTokenFee(args) {
     assertChecksumAddress(args.token, "token", "withdrawTokenFee");
     assertNonZeroChecksumAddress(args.to, "to", "withdrawTokenFee");
@@ -2922,6 +2869,9 @@ var ConfidentialDisperseClient = class {
     } catch (err) {
       throw this.#mapRevert("withdrawTokenFee", err, void 0, accountAddress(account));
     }
+    if (args.waitForReceipt === false) {
+      return { hash, transferredHandle: void 0, pending: true };
+    }
     const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
     const events = viem.parseEventLogs({
       abi: disperseConfidentialAbi,
@@ -3052,6 +3002,7 @@ var ConfidentialDisperseClient = class {
     } catch (err) {
       throw this.#mapRevert("disperse[direct]", err, { user: userAddr }, userAddr);
     }
+    if (args.waitForReceipt === false) return { hash, distributions: void 0, pending: true };
     const distributions = await this.#parseDirectDistributions(hash);
     return { hash, distributions };
   }
@@ -3102,6 +3053,7 @@ var ConfidentialDisperseClient = class {
       } catch (err) {
         throw this.#mapRevert("disperse[wallet-token-fee]", err, { user: userAddr }, userAddr);
       }
+      if (args.waitForReceipt === false) return { hash: hash2, distributions: void 0, pending: true };
       const distributions2 = await this.#parseWalletDistributions(hash2);
       return { hash: hash2, distributions: distributions2 };
     }
@@ -3139,6 +3091,7 @@ var ConfidentialDisperseClient = class {
     } catch (err) {
       throw this.#mapRevert("disperse[wallet]", err, { user: userAddr }, userAddr);
     }
+    if (args.waitForReceipt === false) return { hash, distributions: void 0, pending: true };
     const distributions = await this.#parseWalletDistributions(hash);
     return { hash, distributions };
   }

package/dist/{chunk-UG5RKLU2.cjs → chunk-SUYBAF27.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
 // src/core/version.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "2.0.0-alpha.4";
 
 exports.SDK_VERSION = SDK_VERSION;

package/dist/{chunk-WRWRA4TN.js → chunk-TWU7L5H7.js}

@@ -1,6 +1,6 @@
-import { SDK_VERSION } from './chunk-NWFMBLSQ.js';
+import { SDK_VERSION } from './chunk-7KY4K4PH.js';
 import { mapContractRevert, isContractRevert } from './chunk-4RAAATVY.js';
-import { getFheVestingFactoryAddress } from './chunk-6HCT4QIX.js';
+import { getFheVestingFactoryAddress } from './chunk-GHGF65LN.js';
 import { normaliseAddress } from './chunk-ZA673I3O.js';
 import { asTxHash } from './chunk-KWFFIJYX.js';
 import { DeploymentAddressUnavailableError, TokenOpsSdkError, MissingWalletClientError, MissingAccountError } from './chunk-QBJ7O2B4.js';
@@ -465,33 +465,6 @@ var ConfidentialVestingFactoryClient = class {
       sdkVersion: SDK_VERSION
     });
   }
-  // ----------------------- writes -----------------------
-  /**
-   * Deploy a new `ConfidentialVestingManager` clone via the factory and return
-   * its address, parsed from the `ManagerCreated` event in the tx receipt.
-   *
-   * **This is the headline factory entry point.** It returns one rich-return
-   * shape: the address is only knowable after the tx mines (the factory packs
-   * `block.number` into the clone's immutable args), so a hash-only variant
-   * would force consumers to re-derive what the SDK already had to compute.
-   *
-   * Calls `createManagerWithOptions` when `splitEnabled` or `pausableEnabled`
-   * is provided; otherwise calls the simpler `createManager` entry point.
-   *
-   * Internally: `writeContract` → {@link PublicClient.waitForTransactionReceipt} →
-   * `parseEventLogs({ eventName: "ManagerCreated" })`.
-   *
-   * Pre-mine prediction is exposed only on
-   * `ConfidentialVestingFactoryAdvancedClient` from
-   * `@tokenops/sdk/fhe-vesting/advanced` — predict at block N, mine at N+1,
-   * the addresses differ.
-   *
-   * @example
-   * const { hash, manager } = await factory.createManager({
-   *   token: "0xYourToken",
-   *   userSalt: "0x0000000000000000000000000000000000000000000000000000000000000001",
-   * });
-   */
   async createManager(args) {
     return withTelemetry(this.#telemetry, "fhe-vesting.factory.createManager", async () => {
       const hasOptions = args.splitEnabled !== void 0 || args.pausableEnabled !== void 0;
@@ -500,28 +473,12 @@ var ConfidentialVestingFactoryClient = class {
         [args.token, args.userSalt, args.splitEnabled ?? true, args.pausableEnabled ?? true],
         args.account
       ) : await this.#write("createManager", [args.token, args.userSalt], args.account);
+      if (args.waitForReceipt === false) {
+        return { hash: asTxHash(hash), manager: void 0, pending: true };
+      }
       return this.#resolveManagerFromReceipt(hash, "createManager");
     });
   }
-  /**
-   * Deploy a new manager clone and return its address, parsed from the
-   * `ManagerCreated` event in the tx receipt.
-   *
-   * This is the recommended entry point for the common "deploy a clone and use
-   * its address" flow. {@link ConfidentialVestingFactoryClient.predictManagerAddress}
-   * is unreliable on a live chain because the factory packs the deployment
-   * block number into the clone's immutable args — predict at block N, mine at
-   * N+1, and the addresses differ.
-   *
-   * Internally: {@link ConfidentialVestingFactoryClient.createManager} →
-   * {@link PublicClient.waitForTransactionReceipt} →
-   * `parseEventLogs({ eventName: "ManagerCreated" })`.
-   *
-   * @example
-   * const { hash, manager } = await factory.createManagerAndGetAddress({
-   *   token, userSalt,
-   * });
-   */
   async createManagerAndGetAddress(args) {
     return this.createManager(args);
   }

package/dist/{chunk-WJLECC22.cjs → chunk-UUSSWOPR.cjs}

@@ -4,7 +4,7 @@ var chunkTEBM66WA_cjs = require('./chunk-TEBM66WA.cjs');
 var chunk3QHNYEQD_cjs = require('./chunk-3QHNYEQD.cjs');
 var chunkFAXIIH5R_cjs = require('./chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('./chunk-FWHYQZ5E.cjs');
-var chunkUG5RKLU2_cjs = require('./chunk-UG5RKLU2.cjs');
+var chunkSUYBAF27_cjs = require('./chunk-SUYBAF27.cjs');
 var chunkMVDQMV25_cjs = require('./chunk-MVDQMV25.cjs');
 var chunkJK4XMMKM_cjs = require('./chunk-JK4XMMKM.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
@@ -1192,7 +1192,7 @@ var ConfidentialVestingManagerClient = class {
       chainId: chainIdForInit ?? null,
       hasWallet: !!this.walletClient,
       aclResolved: !!config.aclAddress || chainIdForInit !== void 0 && !!chunkFAXIIH5R_cjs.getFhevmAclAddress(chainIdForInit),
-      sdkVersion: chunkUG5RKLU2_cjs.SDK_VERSION
+      sdkVersion: chunkSUYBAF27_cjs.SDK_VERSION
     });
   }
   /**
@@ -1652,6 +1652,8 @@ var ConfidentialVestingManagerClient = class {
    * {@link OperatorNotApprovedError} (the SDK's mapping of the on-chain
    * `ERC7984UnauthorizedSpender` revert, whose message is the canonical
    * `OPERATOR_NOT_APPROVED_REMEDIATION` copy).
+   * Both helpers wait for their receipt by default; a Safe / multisig signer
+   * passes `waitForReceipt: false` to them.
    *
    * @returns Transaction hash. Parse the `VestingCreated` event to extract the `vestingId`.
    * @example
@@ -1708,6 +1710,8 @@ var ConfidentialVestingManagerClient = class {
    * {@link OperatorNotApprovedError} (the SDK's mapping of the on-chain
    * `ERC7984UnauthorizedSpender` revert, whose message is the canonical
    * `OPERATOR_NOT_APPROVED_REMEDIATION` copy).
+   * Both helpers wait for their receipt by default; a Safe / multisig signer
+   * passes `waitForReceipt: false` to them.
    *
    * @returns Transaction hash.
    */
@@ -1931,51 +1935,6 @@ var ConfidentialVestingManagerClient = class {
     }
     return this.#simpleWrite("batchRevokeVesting", [vestingIds], account);
   }
-  /**
-   * Split a vesting into two positions.
-   *
-   * The `numerator/denominator` ratio is auto-scaled via `scaleRatio` to the
-   * universal split constant `FHE_SPLIT_DENOMINATOR` (`90_090_000` =
-   * LCM(1..16, 10_000)) unless `args.preScaled` is set. Every confidential
-   * split lands on the same plaintext denominator so the constant itself
-   * leaks no information about the split's shape; only the encrypted
-   * numerator carries the share. `90_090_000` is well above the contract's
-   * `MIN_SPLIT_DENOMINATOR` (10_000) floor. The SDK encrypts `numerator` —
-   * pass plaintext.
-   *
-   * Two natural input shapes both produce exact integer numerators against
-   * the universal denominator:
-   * - `n/m` with `m ∈ 1..16` (halves, thirds, …, sixteenths)
-   * - `bps/10_000` (basis points)
-   *
-   * Use the {@link share} builder to construct them without manual math:
-   * `share.fraction(1, 7)` or `share.basisPoints(250)` → pass the returned
-   * `{ numerator, denominator }` with `preScaled: true`.
-   *
-   * @param args.numerator Plaintext share numerator (kept confidential on-chain).
-   * @param args.denominator Plaintext denominator — auto-scaled to 90_090_000.
-   * @param args.newRecipient Recipient address for the split-off position.
-   * @returns `{ hash, newVestingId }` — the receipt-derived id of the
-   *          newly-created vesting position, required for any follow-up call
-   *          (claim, transfer, disclose) on the split-off position.
-   * @example
-   * const { newVestingId } = await manager.splitVesting({
-   *   vestingId,
-   *   numerator: 1n, denominator: 2n,   // 50% split; SDK scales to 45_045_000 / 90_090_000
-   *   newRecipient: "0xNewRecipient",
-   * });
-   *
-   * @example
-   * // Basis-point style via the guided builder:
-   * const ratio = share.basisPoints(250);    // 2.5%
-   * const { newVestingId } = await manager.splitVesting({
-   *   vestingId,
-   *   numerator: ratio.numerator,
-   *   denominator: ratio.denominator,
-   *   preScaled: true,
-   *   newRecipient: "0xNewRecipient",
-   * });
-   */
   async splitVesting(args) {
     const wallet = this.#requireWallet("splitVesting");
     const account = this.#resolveAccount(wallet, args.account, "splitVesting");
@@ -2028,6 +1987,9 @@ var ConfidentialVestingManagerClient = class {
         accountAddress(account)
       );
     }
+    if (args.waitForReceipt === false) {
+      return { hash, newVestingId: void 0, pending: true };
+    }
     const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
     const ours = receipt.logs.filter(
       (log) => log.address.toLowerCase() === this.address.toLowerCase()