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

package/dist/fhe-disperse/react/useSingletonWithdrawTokenFee.d.ts

@@ -1,7 +1,7 @@
 import { type UseMutationResult } from "@tanstack/react-query";
 import type { Account, Address } from "viem";
 import { type EncryptorSource } from "../encryption.js";
-import { type EncryptedInput, type WithdrawTokenFeeResult } from "../types.js";
+import { type EncryptedInput, type PendingWithdrawTokenFeeResult, type WithdrawTokenFeeResult } from "../types.js";
 import { type DisperseHookOptions } from "./_shared.js";
 /**
  * Hook-level args. The hook accepts an {@link EncryptorSource} (eager OR lazy),
@@ -30,6 +30,11 @@ export interface UseSingletonWithdrawTokenFeeArgs {
     encryptedInput?: EncryptedInput;
     /** Override signer account. Falls back to `walletClient.account`. */
     account?: Account | Address;
+    /**
+     * See {@link ReceiptMode}. With `false` the mutation resolves to a
+     * {@link PendingWithdrawTokenFeeResult}.
+     */
+    waitForReceipt?: boolean | undefined;
 }
 /**
  * Fee-collector: withdraw accumulated encrypted token fees. The plaintext
@@ -53,4 +58,4 @@ export interface UseSingletonWithdrawTokenFeeArgs {
  * const withdraw = useSingletonWithdrawTokenFee({ encryptor: () => useZamaSDK().relayer });
  * withdraw.mutate({ token, to: collector, amount: 1_000_000n });
  */
-export declare function useSingletonWithdrawTokenFee(options?: DisperseHookOptions): UseMutationResult<WithdrawTokenFeeResult, Error, UseSingletonWithdrawTokenFeeArgs>;
+export declare function useSingletonWithdrawTokenFee(options?: DisperseHookOptions): UseMutationResult<WithdrawTokenFeeResult | PendingWithdrawTokenFeeResult, Error, UseSingletonWithdrawTokenFeeArgs>;

package/dist/fhe-disperse/react/useWithdrawTokenFee.d.ts

@@ -1,7 +1,7 @@
 import { type UseMutationResult } from "@tanstack/react-query";
 import type { Account, Address } from "viem";
 import { type EncryptorSource } from "../encryption.js";
-import { type EncryptedInput, type WithdrawTokenFeeResult } from "../types.js";
+import { type EncryptedInput, type PendingWithdrawTokenFeeResult, type WithdrawTokenFeeResult } from "../types.js";
 import { type DisperseHookOptions } from "./_shared.js";
 interface WithdrawTokenFeeCommon {
     /** ERC-7984 token whose accumulated fee reserve to withdraw from. */
@@ -10,6 +10,11 @@ interface WithdrawTokenFeeCommon {
     to: Address;
     /** Override signer account. Falls back to `walletClient.account`. */
     account?: Account | Address;
+    /**
+     * See `ReceiptMode`. With `false` the mutation resolves to a
+     * {@link PendingWithdrawTokenFeeResult}.
+     */
+    waitForReceipt?: boolean | undefined;
 }
 /** Plaintext path: SDK encrypts `amount` before submission. */
 export interface UseWithdrawTokenFeePlaintextArgs extends WithdrawTokenFeeCommon {
@@ -72,5 +77,5 @@ export type UseWithdrawTokenFeeArgs = UseWithdrawTokenFeePlaintextArgs | UseWith
  * // Pre-encrypted path — no encryptor needed at call time.
  * withdraw.mutate({ token, to: collector, encryptedInput });
  */
-export declare function useWithdrawTokenFee(options?: DisperseHookOptions): UseMutationResult<WithdrawTokenFeeResult, Error, UseWithdrawTokenFeeArgs>;
+export declare function useWithdrawTokenFee(options?: DisperseHookOptions): UseMutationResult<WithdrawTokenFeeResult | PendingWithdrawTokenFeeResult, Error, UseWithdrawTokenFeeArgs>;
 export {};

package/dist/fhe-disperse/singleton.d.ts

@@ -1,8 +1,9 @@
 import type { Account, Address, Hex, PublicClient, WalletClient } from "viem";
 import { type TxHash } from "../core/brands.js";
+import type { ReceiptMode } from "../core/pending.js";
 import { type SdkTelemetry } from "../core/telemetry.js";
-import { type Encryptor, type EncryptorSource } from "./encryption.js";
-import { type BatchLimits, type CalculateFeeArgs, type CalculatedFee, type CustomFee, type DisperseArgs, type DisperseResult, type DisclosureResult, type BatchDiscloseHandlesArgs, type DiscloseHandleArgs, type EncryptedInput, type EncryptedViewResult, type FeeConfig, type GetEncryptedFeeReserveArgs, type PreflightDisperseArgs, type PreflightReport, type RegisterResult, type SubwalletApprovalState, type UserFees, type WithdrawTokenFeeResult } from "./types.js";
+import { type EncryptorSource } from "./encryption.js";
+import { type BatchLimits, type CalculateFeeArgs, type CalculatedFee, type CustomFee, type DisperseArgs, type DisperseResult, type DisclosureResult, type BatchDiscloseHandlesArgs, type DiscloseHandleArgs, type EncryptedViewResult, type FeeConfig, type GetEncryptedFeeReserveArgs, type PendingDisperseResult, type PendingRegisterResult, type PendingWithdrawTokenFeeResult, type PreflightDisperseArgs, type PreflightReport, type RegisterArgs, type RegisterResult, type SubwalletApprovalState, type UserFees, type WithdrawTokenFeeArgs, type WithdrawTokenFeeResult } from "./types.js";
 export interface ConfidentialDisperseClientConfig {
     /** viem public client for read calls. */
     publicClient: PublicClient;
@@ -58,6 +59,11 @@ export interface ConfidentialDisperseClientConfig {
  * wired to a specific chain's singleton address, either by explicit `address`
  * override or via `DEPLOYED_ADDRESSES.fheDisperse.disperseConfidentialSingleton[chainId]`.
  *
+ * Safe / multisig signers: `register`, `disperse` and `withdrawTokenFee` take
+ * `waitForReceipt: false`. `getEncryptedFeeReserve` and the disclosure methods
+ * do not, because their handle is only useful to an account that can
+ * user-decrypt in-session (an EOA or a delegate).
+ *
  * @example
  * // On Sepolia or mainnet the singleton address auto-resolves from
  * // `DEPLOYED_ADDRESSES.fheDisperse.disperseConfidentialSingleton[chainId]`;
@@ -183,7 +189,8 @@ export declare class ConfidentialDisperseClient {
      *
      * 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
      *
@@ -201,13 +208,15 @@ export declare class ConfidentialDisperseClient {
      * 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.
+     * @returns `{ hash, wallets }` - `wallets` is parsed from the `UserRegistered` event. With
+     *   `waitForReceipt: false`, a {@link PendingRegisterResult}.
      * @throws {DisperseSubwalletNotFoundError} if no `UserRegistered` event matching the singleton is found.
      */
-    register(args: {
-        token: Address;
-        account?: Account | Address;
-    }): Promise<RegisterResult>;
+    register(args: RegisterArgs & ReceiptMode<true>): Promise<RegisterResult>;
+    /** With `waitForReceipt: false`: returns on submission, before the receipt exists. */
+    register(args: RegisterArgs & ReceiptMode<false>): Promise<PendingRegisterResult>;
+    /** With a runtime `boolean`: either result, narrowed by `pending`. */
+    register(args: RegisterArgs & ReceiptMode): Promise<RegisterResult | PendingRegisterResult>;
     /**
      * Approve the caller's existing registered wallets as ERC-7984 operators for `token`.
      *
@@ -263,6 +272,12 @@ export declare class ConfidentialDisperseClient {
      * 4. Computes `msg.value` for gas-fee modes; `0` for token-fee mode.
      * 5. Dispatches to the correct contract function based on `mode`.
      *
+     * **Operator prerequisite.** Every mode pulls from the caller with
+     * `confidentialTransferFrom(msg.sender, ...)`, so the caller must have approved this
+     * singleton as an ERC-7984 operator on `token` (`setOperator` / `ensureOperator` from
+     * `@tokenops/sdk/fhe`). Those wait for their receipt by default; a Safe / multisig signer
+     * passes `waitForReceipt: false` to them as well.
+     *
      * **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
@@ -275,7 +290,11 @@ export declare class ConfidentialDisperseClient {
      * @throws {TokenOpsSdkError} on input validation failure (first deterministic error).
      * @throws {TokenOpsSdkError} if no encryptor is available at call time.
      */
-    disperse(args: DisperseArgs): Promise<DisperseResult>;
+    disperse(args: DisperseArgs & ReceiptMode<true>): Promise<DisperseResult>;
+    /** With `waitForReceipt: false`: returns on submission, before the receipt exists. */
+    disperse(args: DisperseArgs & ReceiptMode<false>): Promise<PendingDisperseResult>;
+    /** With a runtime `boolean`: either result, narrowed by `pending`. */
+    disperse(args: DisperseArgs & ReceiptMode): Promise<DisperseResult | PendingDisperseResult>;
     /**
      * **This is a write transaction, not a free view. It costs gas.**
      *
@@ -394,16 +413,11 @@ export declare class ConfidentialDisperseClient {
      * revert with a generic verification failure. The plaintext `amount`
      * path is safer when the caller / chain isn't fixed yet.
      */
-    withdrawTokenFee(args: {
-        token: Address;
-        to: Address;
-        /** Plaintext amount. Mutually exclusive with `encryptedInput` — supply exactly one. */
-        amount?: bigint;
-        encryptor?: Encryptor;
-        /** Pre-encrypted input. Mutually exclusive with `amount`. */
-        encryptedInput?: EncryptedInput;
-        account?: Account | Address;
-    }): Promise<WithdrawTokenFeeResult>;
+    withdrawTokenFee(args: WithdrawTokenFeeArgs & ReceiptMode<true>): Promise<WithdrawTokenFeeResult>;
+    /** With `waitForReceipt: false`: returns on submission, before the receipt exists. */
+    withdrawTokenFee(args: WithdrawTokenFeeArgs & ReceiptMode<false>): Promise<PendingWithdrawTokenFeeResult>;
+    /** With a runtime `boolean`: either result, narrowed by `pending`. */
+    withdrawTokenFee(args: WithdrawTokenFeeArgs & ReceiptMode): Promise<WithdrawTokenFeeResult | PendingWithdrawTokenFeeResult>;
     /**
      * Rescue accidentally-sent ERC-7984 confidential tokens from the singleton.
      * Requires WITHDRAWER_ROLE.

package/dist/fhe-disperse/types.d.ts

@@ -1,6 +1,7 @@
 import type { Account, Address, Hex } from "viem";
 import type { EncryptedHandle, TxHash } from "../core/brands.js";
 import { TokenOpsSdkError } from "../core/errors.js";
+import type { MinedWrite, PendingWrite } from "../core/pending.js";
 import type { EncryptedInput, EncryptedInputs, EncryptedViewResult } from "../fhe/types.js";
 import type { Encryptor } from "./encryption.js";
 export type { EncryptedInput, EncryptedInputs, EncryptedViewResult };
@@ -106,17 +107,18 @@ export interface PreflightReport {
      * registration state.
      */
     predictedWallets: [Address, Address];
-    /** Per-wallet approval state for the given token. Only relevant for wallet modes. */
+    /** Per-wallet approval state for the given token. Only relevant for wallet modes, alongside {@link hasApprovedSingleton}. */
     hasApprovedSubwallets: {
         wallet0: boolean;
         wallet1: boolean;
         both: boolean;
     };
     /**
-     * For `"direct"` mode: whether the sender itself has approved the singleton as operator.
-     * `null` for wallet modes (approval is on the subwallets, not the sender).
+     * Whether the sender has approved the singleton as operator on the token. Required in
+     * every mode: each disperse entrypoint, and the wallet-token-fee fee pull, transfers
+     * from the sender. The wallet modes need {@link hasApprovedSubwallets} in addition.
      */
-    hasApprovedSingleton: boolean | null;
+    hasApprovedSingleton: boolean;
     /** ETH to attach as `msg.value`. */
     feeEth: bigint;
     /** Token BPS fee amount. Defined only for `"wallet-token-fee"` mode. */
@@ -164,12 +166,22 @@ export interface SubwalletApprovalState {
     both: boolean;
 }
 /** Result of `register()`. */
-export interface RegisterResult {
+export interface RegisterResult extends MinedWrite {
     /** Transaction hash. */
     hash: TxHash;
     /** The two subwallet addresses parsed from the `UserRegistered` event. */
     wallets: [Address, Address];
 }
+/**
+ * What `register()` returns with `waitForReceipt: false`: the submission hash only. Read the
+ * subwallets from the executed transaction's `UserRegistered` log.
+ */
+export interface PendingRegisterResult extends PendingWrite {
+    /** What the wallet returned for the submission; from a Safe, the `safeTxHash`. */
+    hash: TxHash;
+    /** Unknown until the registration executes. */
+    wallets: undefined;
+}
 /**
  * Per-wallet (wallet modes) or single (direct mode) distribution row, parsed
  * from a `WalletDistribution` / `DirectDistribution` event in the disperse
@@ -197,7 +209,7 @@ export interface DisperseDistribution {
     transferred: Hex[];
 }
 /** Result of `disperse()`. */
-export interface DisperseResult {
+export interface DisperseResult extends MinedWrite {
     /** Transaction hash. */
     hash: Hex;
     /**
@@ -208,8 +220,19 @@ export interface DisperseResult {
      */
     distributions: DisperseDistribution[];
 }
+/**
+ * What `disperse()` returns with `waitForReceipt: false`: the submission hash only. Read the
+ * `WalletDistribution` / `DirectDistribution` logs of the executed transaction once owners
+ * co-sign.
+ */
+export interface PendingDisperseResult extends PendingWrite {
+    /** What the wallet returned for the submission; from a Safe, the `safeTxHash`. */
+    hash: Hex;
+    /** Unknown until the disperse executes. */
+    distributions: undefined;
+}
 /** Result of `withdrawTokenFee()`. */
-export interface WithdrawTokenFeeResult {
+export interface WithdrawTokenFeeResult extends MinedWrite {
     /** Transaction hash. */
     hash: Hex;
     /**
@@ -222,6 +245,16 @@ export interface WithdrawTokenFeeResult {
      */
     transferredHandle?: Hex;
 }
+/**
+ * What `withdrawTokenFee()` returns with `waitForReceipt: false`: the submission hash only.
+ * Read the handle from the executed transaction's `TokenFeeWithdrawn` log.
+ */
+export interface PendingWithdrawTokenFeeResult extends PendingWrite {
+    /** What the wallet returned for the submission; from a Safe, the `safeTxHash`. */
+    hash: Hex;
+    /** Unknown until the withdrawal executes. */
+    transferredHandle: undefined;
+}
 /** Result of `discloseHandleToParty()` / `batchDiscloseHandlesToParty()`. */
 export interface DisclosureResult {
     /** Transaction hash. */
@@ -248,6 +281,13 @@ export interface DisperseArgs {
     /** Override signer account. Falls back to `walletClient.account`. */
     account?: Account | Address | undefined;
 }
+/** Arguments for `register()`. */
+export interface RegisterArgs {
+    /** ERC-7984 token to approve the new subwallets for. */
+    token: Address;
+    /** Override signer account. Falls back to `walletClient.account`. */
+    account?: Account | Address | undefined;
+}
 /** Arguments for `getEncryptedFeeReserve()`. */
 export interface GetEncryptedFeeReserveArgs {
     /** ERC-7984 token to query the fee reserve for. */
@@ -271,7 +311,7 @@ export interface BatchDiscloseHandlesArgs {
     party: Address;
     account?: Account | Address | undefined;
 }
-/** Common fields for {@link WithdrawTokenFeeArgs} — discriminated below. */
+/** Common fields for {@link WithdrawTokenFeeArgs} - discriminated below. */
 interface WithdrawTokenFeeArgsCommon {
     token: Address;
     to: Address;

package/dist/fhe-vesting/advanced/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunk6XOAYDC6_cjs = require('../../chunk-6XOAYDC6.cjs');
-require('../../chunk-JVNJSDQ4.cjs');
-require('../../chunk-UG5RKLU2.cjs');
+var chunkPO3A2AQX_cjs = require('../../chunk-PO3A2AQX.cjs');
+require('../../chunk-6AYJRUGP.cjs');
+require('../../chunk-SUYBAF27.cjs');
 require('../../chunk-MVDQMV25.cjs');
-require('../../chunk-PG3WXT3K.cjs');
+require('../../chunk-YAL6JSAZ.cjs');
 require('../../chunk-JK4XMMKM.cjs');
 require('../../chunk-66IHPTOK.cjs');
 require('../../chunk-67OV5CX2.cjs');
@@ -14,9 +14,9 @@ require('../../chunk-VJKZWYYJ.cjs');
 
 Object.defineProperty(exports, "ConfidentialVestingFactoryAdvancedClient", {
   enumerable: true,
-  get: function () { return chunk6XOAYDC6_cjs.ConfidentialVestingFactoryAdvancedClient; }
+  get: function () { return chunkPO3A2AQX_cjs.ConfidentialVestingFactoryAdvancedClient; }
 });
 Object.defineProperty(exports, "createConfidentialVestingFactoryAdvancedClient", {
   enumerable: true,
-  get: function () { return chunk6XOAYDC6_cjs.createConfidentialVestingFactoryAdvancedClient; }
+  get: function () { return chunkPO3A2AQX_cjs.createConfidentialVestingFactoryAdvancedClient; }
 });

package/dist/fhe-vesting/advanced/index.js

@@ -1,8 +1,8 @@
-export { ConfidentialVestingFactoryAdvancedClient, createConfidentialVestingFactoryAdvancedClient } from '../../chunk-NGU4JYIR.js';
-import '../../chunk-WRWRA4TN.js';
-import '../../chunk-NWFMBLSQ.js';
+export { ConfidentialVestingFactoryAdvancedClient, createConfidentialVestingFactoryAdvancedClient } from '../../chunk-2ND7US2I.js';
+import '../../chunk-TWU7L5H7.js';
+import '../../chunk-7KY4K4PH.js';
 import '../../chunk-4RAAATVY.js';
-import '../../chunk-6HCT4QIX.js';
+import '../../chunk-GHGF65LN.js';
 import '../../chunk-ZA673I3O.js';
 import '../../chunk-KWFFIJYX.js';
 import '../../chunk-QBJ7O2B4.js';

package/dist/fhe-vesting/advanced/react/index.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkYABHXJNH_cjs = require('../../../chunk-YABHXJNH.cjs');
-require('../../../chunk-WJLECC22.cjs');
+var chunkARZ5C3FS_cjs = require('../../../chunk-ARZ5C3FS.cjs');
+require('../../../chunk-UUSSWOPR.cjs');
 require('../../../chunk-TEBM66WA.cjs');
 require('../../../chunk-3QHNYEQD.cjs');
 require('../../../chunk-FAXIIH5R.cjs');
 require('../../../chunk-FWHYQZ5E.cjs');
-var chunk6XOAYDC6_cjs = require('../../../chunk-6XOAYDC6.cjs');
-require('../../../chunk-JVNJSDQ4.cjs');
-require('../../../chunk-UG5RKLU2.cjs');
+var chunkPO3A2AQX_cjs = require('../../../chunk-PO3A2AQX.cjs');
+require('../../../chunk-6AYJRUGP.cjs');
+require('../../../chunk-SUYBAF27.cjs');
 require('../../../chunk-MVDQMV25.cjs');
-var chunkPG3WXT3K_cjs = require('../../../chunk-PG3WXT3K.cjs');
+var chunkYAL6JSAZ_cjs = require('../../../chunk-YAL6JSAZ.cjs');
 require('../../../chunk-JK4XMMKM.cjs');
 require('../../../chunk-66IHPTOK.cjs');
 require('../../../chunk-67OV5CX2.cjs');
@@ -37,12 +37,12 @@ function usePredictManagerAddress(args = {}) {
     ...chainId !== void 0 ? { chainId } : {}
   });
   const resolvedChainId = chainId ?? resolvedPublicClient?.chain?.id;
-  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : chunkPG3WXT3K_cjs.DEPLOYED_ADDRESSES.fheVesting?.confidentialVestingFactory?.[resolvedChainId] ?? void 0);
+  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : chunkYAL6JSAZ_cjs.DEPLOYED_ADDRESSES.fheVesting?.confidentialVestingFactory?.[resolvedChainId] ?? void 0);
   react.useRef(void 0);
   const client = react.useMemo(() => {
     if (!resolvedPublicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunk6XOAYDC6_cjs.createConfidentialVestingFactoryAdvancedClient({
+    return chunkPO3A2AQX_cjs.createConfidentialVestingFactoryAdvancedClient({
       publicClient: resolvedPublicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
@@ -50,7 +50,7 @@ function usePredictManagerAddress(args = {}) {
     });
   }, [resolvedPublicClient, walletClient, resolvedAddress, resolvedChainId]);
   return reactQuery.useQuery({
-    queryKey: chunkYABHXJNH_cjs.buildQueryKey(
+    queryKey: chunkARZ5C3FS_cjs.buildQueryKey(
       "factory:predictManagerAddress",
       resolvedChainId,
       resolvedAddress,

package/dist/fhe-vesting/advanced/react/index.js

@@ -1,14 +1,14 @@
-import { buildQueryKey } from '../../../chunk-BPIVVCSQ.js';
-import '../../../chunk-TWT3STIX.js';
+import { buildQueryKey } from '../../../chunk-BSXEX2SH.js';
+import '../../../chunk-K3R27WX4.js';
 import '../../../chunk-WMACINXO.js';
 import '../../../chunk-6GNR22OV.js';
 import '../../../chunk-ZWXJTBZO.js';
 import '../../../chunk-7VELUOMI.js';
-import { createConfidentialVestingFactoryAdvancedClient } from '../../../chunk-NGU4JYIR.js';
-import '../../../chunk-WRWRA4TN.js';
-import '../../../chunk-NWFMBLSQ.js';
+import { createConfidentialVestingFactoryAdvancedClient } from '../../../chunk-2ND7US2I.js';
+import '../../../chunk-TWU7L5H7.js';
+import '../../../chunk-7KY4K4PH.js';
 import '../../../chunk-4RAAATVY.js';
-import { DEPLOYED_ADDRESSES } from '../../../chunk-6HCT4QIX.js';
+import { DEPLOYED_ADDRESSES } from '../../../chunk-GHGF65LN.js';
 import '../../../chunk-ZA673I3O.js';
 import '../../../chunk-KWFFIJYX.js';
 import '../../../chunk-QBJ7O2B4.js';

package/dist/fhe-vesting/factory.d.ts

@@ -1,5 +1,6 @@
 import type { Account, Address, Hex, PublicClient, WalletClient } from "viem";
 import { type TxHash } from "../core/brands.js";
+import type { MinedWrite, PendingWrite, ReceiptMode } from "../core/pending.js";
 import { type SdkTelemetry } from "../core/telemetry.js";
 import type { FeeType } from "./types.js";
 import { type CustomFee } from "./types.js";
@@ -74,12 +75,23 @@ export interface PredictManagerArgs {
  * Branded `hash: TxHash` and `manager: Address` so consumers can't accidentally
  * swap them at the destructure site.
  */
-export interface CreateManagerResult {
+export interface CreateManagerResult extends MinedWrite {
     /** Transaction hash of the deploy. */
     hash: TxHash;
     /** Address of the deployed clone, parsed from the `ManagerCreated` event. */
     manager: Address;
 }
+/**
+ * What {@link ConfidentialVestingFactoryClient.createManager} returns with
+ * `waitForReceipt: false` ({@link ReceiptMode}): the submission hash only. Resolve the
+ * manager address from the executed transaction's `ManagerCreated` log.
+ */
+export interface PendingCreateManagerResult extends PendingWrite {
+    /** What the wallet returned for the submission; from a Safe, the `safeTxHash`. */
+    hash: TxHash;
+    /** Unknown until the deploy executes; read its `ManagerCreated` log. */
+    manager: undefined;
+}
 /**
  * Typed wrapper around the deployed `ConfidentialVestingFactory`. Mirrors the
  * Solidity interface 1:1 — the only "abstraction" is plumbing viem clients and
@@ -87,7 +99,7 @@ export interface CreateManagerResult {
  *
  * @example
  * const factory = createConfidentialVestingFactoryClient({ publicClient, walletClient });
- * const hash = await factory.createManager({ token, userSalt });
+ * const { hash, manager } = await factory.createManager({ token, userSalt });
  */
 export declare class ConfidentialVestingFactoryClient {
     #private;
@@ -99,10 +111,10 @@ export declare class ConfidentialVestingFactoryClient {
      * 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.
+     * **This is the headline factory entry point.** By default it returns the
+     * rich shape: the address is only knowable after the tx mines (the factory
+     * packs `block.number` into the clone's immutable args). The hash-only result
+     * exists only for signers that cannot wait, through `waitForReceipt: false`.
      *
      * Calls `createManagerWithOptions` when `splitEnabled` or `pausableEnabled`
      * is provided; otherwise calls the simpler `createManager` entry point.
@@ -110,6 +122,9 @@ export declare class ConfidentialVestingFactoryClient {
      * Internally: `writeContract` → {@link PublicClient.waitForTransactionReceipt} →
      * `parseEventLogs({ eventName: "ManagerCreated" })`.
      *
+     * Safe / multisig signers pass `waitForReceipt: false` ({@link ReceiptMode}) and get a
+     * {@link PendingCreateManagerResult}.
+     *
      * Pre-mine prediction is exposed only on
      * `ConfidentialVestingFactoryAdvancedClient` from
      * `@tokenops/sdk/fhe-vesting/advanced` — predict at block N, mine at N+1,
@@ -121,7 +136,11 @@ export declare class ConfidentialVestingFactoryClient {
      *   userSalt: "0x0000000000000000000000000000000000000000000000000000000000000001",
      * });
      */
-    createManager(args: CreateManagerArgs): Promise<CreateManagerResult>;
+    createManager(args: CreateManagerArgs & ReceiptMode<true>): Promise<CreateManagerResult>;
+    /** With `waitForReceipt: false`: returns on submission, before the receipt exists. */
+    createManager(args: CreateManagerArgs & ReceiptMode<false>): Promise<PendingCreateManagerResult>;
+    /** With a runtime `boolean`: either result, narrowed by `pending`. */
+    createManager(args: CreateManagerArgs & ReceiptMode): Promise<CreateManagerResult | PendingCreateManagerResult>;
     /**
      * Deploy a new manager clone and return its address, parsed from the
      * `ManagerCreated` event in the tx receipt.
@@ -141,7 +160,11 @@ export declare class ConfidentialVestingFactoryClient {
      *   token, userSalt,
      * });
      */
-    createManagerAndGetAddress(args: CreateManagerArgs): Promise<CreateManagerResult>;
+    createManagerAndGetAddress(args: CreateManagerArgs & ReceiptMode<true>): Promise<CreateManagerResult>;
+    /** With `waitForReceipt: false`: returns on submission, before the receipt exists. */
+    createManagerAndGetAddress(args: CreateManagerArgs & ReceiptMode<false>): Promise<PendingCreateManagerResult>;
+    /** With a runtime `boolean`: either result, narrowed by `pending`. */
+    createManagerAndGetAddress(args: CreateManagerArgs & ReceiptMode): Promise<CreateManagerResult | PendingCreateManagerResult>;
     /**
      * Set the factory-wide default gas fee (in wei). Factory admin only.
      *

package/dist/fhe-vesting/index.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
-var chunkWJLECC22_cjs = require('../chunk-WJLECC22.cjs');
+var chunkUUSSWOPR_cjs = require('../chunk-UUSSWOPR.cjs');
 require('../chunk-TEBM66WA.cjs');
 var chunk3QHNYEQD_cjs = require('../chunk-3QHNYEQD.cjs');
 require('../chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('../chunk-FWHYQZ5E.cjs');
-var chunkJVNJSDQ4_cjs = require('../chunk-JVNJSDQ4.cjs');
-require('../chunk-UG5RKLU2.cjs');
+var chunk6AYJRUGP_cjs = require('../chunk-6AYJRUGP.cjs');
+require('../chunk-SUYBAF27.cjs');
 require('../chunk-MVDQMV25.cjs');
-require('../chunk-PG3WXT3K.cjs');
+require('../chunk-YAL6JSAZ.cjs');
 require('../chunk-JK4XMMKM.cjs');
 require('../chunk-66IHPTOK.cjs');
 var chunk67OV5CX2_cjs = require('../chunk-67OV5CX2.cjs');
@@ -18,55 +18,55 @@ require('../chunk-VJKZWYYJ.cjs');
 
 Object.defineProperty(exports, "ClaimLockedError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.ClaimLockedError; }
+  get: function () { return chunkUUSSWOPR_cjs.ClaimLockedError; }
 });
 Object.defineProperty(exports, "ConfidentialVestingManagerClient", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.ConfidentialVestingManagerClient; }
+  get: function () { return chunkUUSSWOPR_cjs.ConfidentialVestingManagerClient; }
 });
 Object.defineProperty(exports, "NoPendingTransferError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.NoPendingTransferError; }
+  get: function () { return chunkUUSSWOPR_cjs.NoPendingTransferError; }
 });
 Object.defineProperty(exports, "NotPendingRecipientError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.NotPendingRecipientError; }
+  get: function () { return chunkUUSSWOPR_cjs.NotPendingRecipientError; }
 });
 Object.defineProperty(exports, "NotVestingRecipientError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.NotVestingRecipientError; }
+  get: function () { return chunkUUSSWOPR_cjs.NotVestingRecipientError; }
 });
 Object.defineProperty(exports, "TransferAlreadyPendingError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.TransferAlreadyPendingError; }
+  get: function () { return chunkUUSSWOPR_cjs.TransferAlreadyPendingError; }
 });
 Object.defineProperty(exports, "TransferExpiredError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.TransferExpiredError; }
+  get: function () { return chunkUUSSWOPR_cjs.TransferExpiredError; }
 });
 Object.defineProperty(exports, "VestingExpiredError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.VestingExpiredError; }
+  get: function () { return chunkUUSSWOPR_cjs.VestingExpiredError; }
 });
 Object.defineProperty(exports, "VestingNotFoundError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.VestingNotFoundError; }
+  get: function () { return chunkUUSSWOPR_cjs.VestingNotFoundError; }
 });
 Object.defineProperty(exports, "VestingNotRevocableError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.VestingNotRevocableError; }
+  get: function () { return chunkUUSSWOPR_cjs.VestingNotRevocableError; }
 });
 Object.defineProperty(exports, "VestingRevokedError", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.VestingRevokedError; }
+  get: function () { return chunkUUSSWOPR_cjs.VestingRevokedError; }
 });
 Object.defineProperty(exports, "confidentialVestingManagerAbi", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.confidentialVestingManagerAbi; }
+  get: function () { return chunkUUSSWOPR_cjs.confidentialVestingManagerAbi; }
 });
 Object.defineProperty(exports, "createConfidentialVestingManagerClient", {
   enumerable: true,
-  get: function () { return chunkWJLECC22_cjs.createConfidentialVestingManagerClient; }
+  get: function () { return chunkUUSSWOPR_cjs.createConfidentialVestingManagerClient; }
 });
 Object.defineProperty(exports, "FHE_SPLIT_DENOMINATOR", {
   enumerable: true,
@@ -98,27 +98,27 @@ Object.defineProperty(exports, "erc7984OperatorAbi", {
 });
 Object.defineProperty(exports, "ConfidentialVestingFactoryClient", {
   enumerable: true,
-  get: function () { return chunkJVNJSDQ4_cjs.ConfidentialVestingFactoryClient; }
+  get: function () { return chunk6AYJRUGP_cjs.ConfidentialVestingFactoryClient; }
 });
 Object.defineProperty(exports, "DisclosureType", {
   enumerable: true,
-  get: function () { return chunkJVNJSDQ4_cjs.DisclosureType; }
+  get: function () { return chunk6AYJRUGP_cjs.DisclosureType; }
 });
 Object.defineProperty(exports, "FeeType", {
   enumerable: true,
-  get: function () { return chunkJVNJSDQ4_cjs.FeeType; }
+  get: function () { return chunk6AYJRUGP_cjs.FeeType; }
 });
 Object.defineProperty(exports, "confidentialVestingFactoryAbi", {
   enumerable: true,
-  get: function () { return chunkJVNJSDQ4_cjs.confidentialVestingFactoryAbi; }
+  get: function () { return chunk6AYJRUGP_cjs.confidentialVestingFactoryAbi; }
 });
 Object.defineProperty(exports, "createConfidentialVestingFactoryClient", {
   enumerable: true,
-  get: function () { return chunkJVNJSDQ4_cjs.createConfidentialVestingFactoryClient; }
+  get: function () { return chunk6AYJRUGP_cjs.createConfidentialVestingFactoryClient; }
 });
 Object.defineProperty(exports, "feeTypeName", {
   enumerable: true,
-  get: function () { return chunkJVNJSDQ4_cjs.feeTypeName; }
+  get: function () { return chunk6AYJRUGP_cjs.feeTypeName; }
 });
 Object.defineProperty(exports, "AccessDeniedError", {
   enumerable: true,

package/dist/fhe-vesting/index.d.cts

@@ -1,9 +1,10 @@
-export { ConfidentialVestingFactoryClient, createConfidentialVestingFactoryClient, type ConfidentialVestingFactoryClientConfig, type CreateManagerArgs, type CreateManagerResult, } from "./factory.js";
-export { ConfidentialVestingManagerClient, createConfidentialVestingManagerClient, type BatchCreateVestingArgs, type BatchDiscloseToPartyResult, type ClaimArgs, type ConfidentialVestingManagerClientConfig, type CreateVestingArgs, type DiscloseArgs, type DiscloseToPartyResult, type EncryptedViewResult, type InitiateTransferArgs, type PartialClaimArgs, type SplitVestingArgs, type SplitVestingResult, } from "./manager.js";
+export { ConfidentialVestingFactoryClient, createConfidentialVestingFactoryClient, type ConfidentialVestingFactoryClientConfig, type CreateManagerArgs, type CreateManagerResult, type PendingCreateManagerResult, } from "./factory.js";
+export { ConfidentialVestingManagerClient, createConfidentialVestingManagerClient, type BatchCreateVestingArgs, type BatchDiscloseToPartyResult, type ClaimArgs, type ConfidentialVestingManagerClientConfig, type CreateVestingArgs, type DiscloseArgs, type DiscloseToPartyResult, type EncryptedViewResult, type InitiateTransferArgs, type PartialClaimArgs, type SplitVestingArgs, type PendingSplitVestingResult, type SplitVestingResult, } from "./manager.js";
 export { encryptUint64, encryptUint64Batch, resolveEncryptor, type Encryptor, type EncryptorSource, type EncryptUint64Args, type EncryptUint64BatchArgs, type FheValueInput, } from "./encryption.js";
 export { DisclosureType, FeeType, feeTypeName, type CreateVestingPreflightReport, type CustomFee, type EncryptedInput, type EncryptedInputs, type PendingTransfer, type VestingInfo, type VestingParams, } from "./types.js";
 export { confidentialVestingFactoryAbi, confidentialVestingManagerAbi, erc7984OperatorAbi, } from "./abis/index.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";
+export type { MinedWrite, PendingWrite, ReceiptMode } from "../core/pending.js";
 export { VestingNotFoundError, NotVestingRecipientError, ClaimLockedError, VestingRevokedError, VestingNotRevocableError, VestingExpiredError, TransferAlreadyPendingError, NoPendingTransferError, NotPendingRecipientError, TransferExpiredError, } from "./errors.js";
 export { FHE_SPLIT_DENOMINATOR, scaleRatio, share, type ScaleRatioArgs, type ScaleRatioWidth, type ScaledRatio, } from "../fhe/scale-ratio.js";