@tokenops/sdk 1.0.0

package/dist/chunk-72YGZEQE.js

@@ -0,0 +1,742 @@
+import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-JFLEEXKP.js';
+import { getFheVestingFactoryAddress } from './chunk-COPFW5Z4.js';
+import { normaliseAddress } from './chunk-BE2AIZ3K.js';
+import { withTelemetry } from './chunk-Q2GP5UDC.js';
+import { asTxHash } from './chunk-KWFFIJYX.js';
+import { DeploymentAddressUnavailableError, TokenOpsSdkError, MissingWalletClientError, MissingAccountError } from './chunk-IVE3QEGD.js';
+import { parseEventLogs } from 'viem';
+
+// src/fhe-vesting/abis/factory.ts
+var confidentialVestingFactoryAbi = [
+  {
+    inputs: [
+      { internalType: "address", name: "_implementation", type: "address" },
+      { internalType: "address", name: "admin", type: "address" },
+      { internalType: "address", name: "initialFeeCollector", type: "address" },
+      { internalType: "uint256", name: "initialDefaultGasFee", type: "uint256" },
+      { internalType: "uint256", name: "initialDefaultTokenFee", type: "uint256" },
+      {
+        internalType: "enum IConfidentialVestingFactory.FeeType",
+        name: "initialDefaultFeeType",
+        type: "uint8"
+      }
+    ],
+    stateMutability: "nonpayable",
+    type: "constructor"
+  },
+  { inputs: [], name: "AccessControlBadConfirmation", type: "error" },
+  {
+    inputs: [
+      { internalType: "address", name: "account", type: "address" },
+      { internalType: "bytes32", name: "neededRole", type: "bytes32" }
+    ],
+    name: "AccessControlUnauthorizedAccount",
+    type: "error"
+  },
+  { inputs: [], name: "InvalidAdmin", type: "error" },
+  { inputs: [], name: "InvalidFeeBps", type: "error" },
+  { inputs: [], name: "InvalidFeeCollector", type: "error" },
+  { inputs: [], name: "InvalidFeeType", type: "error" },
+  { inputs: [], name: "InvalidImplementation", type: "error" },
+  { inputs: [], name: "InvalidToken", type: "error" },
+  { inputs: [], name: "ZamaProtocolUnsupported", type: "error" },
+  {
+    anonymous: false,
+    inputs: [{ indexed: true, internalType: "address", name: "creator", type: "address" }],
+    name: "CustomFeeDisabled",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "creator", type: "address" },
+      {
+        indexed: false,
+        internalType: "enum IConfidentialVestingFactory.FeeType",
+        name: "feeType",
+        type: "uint8"
+      },
+      { indexed: false, internalType: "uint256", name: "gasFee", type: "uint256" },
+      { indexed: false, internalType: "uint256", name: "tokenFee", type: "uint256" }
+    ],
+    name: "CustomFeeSet",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: false,
+        internalType: "enum IConfidentialVestingFactory.FeeType",
+        name: "oldType",
+        type: "uint8"
+      },
+      {
+        indexed: false,
+        internalType: "enum IConfidentialVestingFactory.FeeType",
+        name: "newType",
+        type: "uint8"
+      }
+    ],
+    name: "DefaultFeeTypeChanged",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: false, internalType: "uint256", name: "oldFee", type: "uint256" },
+      { indexed: false, internalType: "uint256", name: "newFee", type: "uint256" }
+    ],
+    name: "DefaultGasFeeUpdated",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: false, internalType: "uint256", name: "oldFee", type: "uint256" },
+      { indexed: false, internalType: "uint256", name: "newFee", type: "uint256" }
+    ],
+    name: "DefaultTokenFeeUpdated",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "oldCollector", type: "address" },
+      { indexed: true, internalType: "address", name: "newCollector", type: "address" }
+    ],
+    name: "FeeCollectorUpdated",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "manager", type: "address" },
+      { indexed: true, internalType: "address", name: "creator", type: "address" },
+      { indexed: true, internalType: "address", name: "token", type: "address" },
+      {
+        indexed: false,
+        internalType: "enum IConfidentialVestingFactory.FeeType",
+        name: "feeType",
+        type: "uint8"
+      },
+      { indexed: false, internalType: "uint256", name: "fee", type: "uint256" },
+      { indexed: false, internalType: "bytes32", name: "salt", type: "bytes32" }
+    ],
+    name: "ManagerCreated",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "bytes32", name: "role", type: "bytes32" },
+      { indexed: true, internalType: "bytes32", name: "previousAdminRole", type: "bytes32" },
+      { indexed: true, internalType: "bytes32", name: "newAdminRole", type: "bytes32" }
+    ],
+    name: "RoleAdminChanged",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "bytes32", name: "role", type: "bytes32" },
+      { indexed: true, internalType: "address", name: "account", type: "address" },
+      { indexed: true, internalType: "address", name: "sender", type: "address" }
+    ],
+    name: "RoleGranted",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "bytes32", name: "role", type: "bytes32" },
+      { indexed: true, internalType: "address", name: "account", type: "address" },
+      { indexed: true, internalType: "address", name: "sender", type: "address" }
+    ],
+    name: "RoleRevoked",
+    type: "event"
+  },
+  {
+    inputs: [],
+    name: "DEFAULT_ADMIN_ROLE",
+    outputs: [{ internalType: "bytes32", name: "", type: "bytes32" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "FEE_MANAGER_ROLE",
+    outputs: [{ internalType: "bytes32", name: "", type: "bytes32" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "bytes32", name: "userSalt", type: "bytes32" }
+    ],
+    name: "createManager",
+    outputs: [{ internalType: "address", name: "manager", type: "address" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "bytes32", name: "userSalt", type: "bytes32" },
+      { internalType: "bool", name: "splitEnabled", type: "bool" },
+      { internalType: "bool", name: "pausableEnabled", type: "bool" }
+    ],
+    name: "createManagerWithOptions",
+    outputs: [{ internalType: "address", name: "manager", type: "address" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "defaultFeeType",
+    outputs: [
+      { internalType: "enum IConfidentialVestingFactory.FeeType", name: "", type: "uint8" }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "defaultGasFee",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "defaultTokenFee",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "address", name: "creator", type: "address" }],
+    name: "disableCustomFee",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "feeCollector",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "address", name: "creator", type: "address" }],
+    name: "getCustomFee",
+    outputs: [
+      {
+        components: [
+          { internalType: "bool", name: "enabled", type: "bool" },
+          {
+            internalType: "enum IConfidentialVestingFactory.FeeType",
+            name: "preferredFeeType",
+            type: "uint8"
+          },
+          { internalType: "uint256", name: "gasFee", type: "uint256" },
+          { internalType: "uint256", name: "tokenFee", type: "uint256" }
+        ],
+        internalType: "struct IConfidentialVestingFactory.CustomFee",
+        name: "",
+        type: "tuple"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "address", name: "deployer", type: "address" }
+    ],
+    name: "getInitCodeHash",
+    outputs: [{ internalType: "bytes32", name: "", type: "bytes32" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "address", name: "deployer", type: "address" },
+      { internalType: "bool", name: "splitEnabled", type: "bool" },
+      { internalType: "bool", name: "pausableEnabled", type: "bool" }
+    ],
+    name: "getInitCodeHashWithOptions",
+    outputs: [{ internalType: "bytes32", name: "", type: "bytes32" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "bytes32", name: "role", type: "bytes32" }],
+    name: "getRoleAdmin",
+    outputs: [{ internalType: "bytes32", name: "", type: "bytes32" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "bytes32", name: "role", type: "bytes32" },
+      { internalType: "address", name: "account", type: "address" }
+    ],
+    name: "grantRole",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "bytes32", name: "role", type: "bytes32" },
+      { internalType: "address", name: "account", type: "address" }
+    ],
+    name: "hasRole",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "implementation",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "bytes32", name: "userSalt", type: "bytes32" },
+      { internalType: "address", name: "deployer", type: "address" }
+    ],
+    name: "predictManagerAddress",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "bytes32", name: "userSalt", type: "bytes32" },
+      { internalType: "address", name: "deployer", type: "address" },
+      { internalType: "bool", name: "splitEnabled", type: "bool" },
+      { internalType: "bool", name: "pausableEnabled", type: "bool" }
+    ],
+    name: "predictManagerAddressWithOptions",
+    outputs: [{ internalType: "address", name: "", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "bytes32", name: "role", type: "bytes32" },
+      { internalType: "address", name: "callerConfirmation", type: "address" }
+    ],
+    name: "renounceRole",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  { inputs: [], name: "resetGasFee", outputs: [], stateMutability: "nonpayable", type: "function" },
+  {
+    inputs: [],
+    name: "resetTokenFee",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "bytes32", name: "role", type: "bytes32" },
+      { internalType: "address", name: "account", type: "address" }
+    ],
+    name: "revokeRole",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "creator", type: "address" },
+      { internalType: "enum IConfidentialVestingFactory.FeeType", name: "feeType", type: "uint8" },
+      { internalType: "uint256", name: "gasFee", type: "uint256" },
+      { internalType: "uint256", name: "tokenFee", type: "uint256" }
+    ],
+    name: "setCustomFee",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "enum IConfidentialVestingFactory.FeeType", name: "feeType", type: "uint8" }
+    ],
+    name: "setDefaultFeeType",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "fee", type: "uint256" }],
+    name: "setDefaultGasFee",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "fee", type: "uint256" }],
+    name: "setDefaultTokenFee",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "address", name: "newCollector", type: "address" }],
+    name: "setFeeCollector",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "bytes4", name: "interfaceId", type: "bytes4" }],
+    name: "supportsInterface",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+
+// src/fhe-vesting/types.ts
+var FeeType = /* @__PURE__ */ ((FeeType2) => {
+  FeeType2[FeeType2["Gas"] = 0] = "Gas";
+  FeeType2[FeeType2["DistributionToken"] = 1] = "DistributionToken";
+  return FeeType2;
+})(FeeType || {});
+function feeTypeName(feeType) {
+  switch (feeType) {
+    case 0 /* Gas */:
+      return "Gas";
+    case 1 /* DistributionToken */:
+      return "DistributionToken";
+  }
+}
+var DisclosureType = /* @__PURE__ */ ((DisclosureType2) => {
+  DisclosureType2[DisclosureType2["TotalAllocation"] = 0] = "TotalAllocation";
+  DisclosureType2[DisclosureType2["SettledAmount"] = 1] = "SettledAmount";
+  DisclosureType2[DisclosureType2["VestedAmount"] = 2] = "VestedAmount";
+  DisclosureType2[DisclosureType2["ClaimableAmount"] = 3] = "ClaimableAmount";
+  return DisclosureType2;
+})(DisclosureType || {});
+var vestingFactoryProductMapper = () => void 0;
+var ConfidentialVestingFactoryClient = class {
+  publicClient;
+  walletClient;
+  address;
+  #telemetry;
+  constructor(config) {
+    this.publicClient = config.publicClient;
+    this.walletClient = config.walletClient;
+    const chainId = config.chainId ?? config.publicClient.chain?.id;
+    const addressOverride = config.address ? normaliseAddress(config.address) : void 0;
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : getFheVestingFactoryAddress(chainId));
+    if (!resolved) {
+      throw new DeploymentAddressUnavailableError({
+        reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
+        product: "fheVesting",
+        contract: "confidentialVestingFactory",
+        chainId,
+        clientLabel: "ConfidentialVestingFactoryClient"
+      });
+    }
+    this.address = resolved;
+    this.#telemetry = config.telemetry;
+    this.#telemetry?.event("fhe-vesting.client.init", {
+      surface: "factory",
+      chainId: chainId ?? null,
+      hasWallet: !!this.walletClient,
+      aclResolved: true,
+      // factory has no ACL dependency; constant for funnel-shape parity with manager.
+      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.** R02 ADR P-1 collapses the
+   * old hash-only + `…AndGetAddress` pair down to one rich-return method —
+   * 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
+   * forced 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;
+      const hash = hasOptions ? await this.#write(
+        "createManagerWithOptions",
+        [args.token, args.userSalt, args.splitEnabled ?? true, args.pausableEnabled ?? true],
+        args.account
+      ) : await this.#write("createManager", [args.token, args.userSalt], args.account);
+      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);
+  }
+  /**
+   * Set the factory-wide default gas fee (in wei). Factory admin only.
+   *
+   * @param fee Fee in wei charged per `claim` on `FeeType.Gas` managers.
+   */
+  async setDefaultGasFee(fee, account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.setDefaultGasFee", async () => {
+      return this.#write("setDefaultGasFee", [fee], account);
+    });
+  }
+  /**
+   * Set the factory-wide default token fee in basis points. Factory admin only.
+   *
+   * @param feeBps Basis points (1 bps = 0.01 %). Deducted from the claimed token
+   *   amount on `FeeType.DistributionToken` managers.
+   */
+  async setDefaultTokenFee(feeBps, account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.setDefaultTokenFee", async () => {
+      return this.#write("setDefaultTokenFee", [feeBps], account);
+    });
+  }
+  /** Set the default fee model (`FeeType.Gas` or `FeeType.DistributionToken`) for new clones. Factory admin only. */
+  async setDefaultFeeType(feeType, account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.setDefaultFeeType", async () => {
+      return this.#write("setDefaultFeeType", [feeType], account);
+    });
+  }
+  async resetGasFee(account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.resetGasFee", async () => {
+      return this.#write("resetGasFee", [], account);
+    });
+  }
+  async resetTokenFee(account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.resetTokenFee", async () => {
+      return this.#write("resetTokenFee", [], account);
+    });
+  }
+  /**
+   * Set a per-creator fee override. The override takes precedence over the factory
+   * defaults for all managers created by `args.creator`.
+   */
+  async setCustomFee(args, account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.setCustomFee", async () => {
+      return this.#write(
+        "setCustomFee",
+        [args.creator, args.feeType, args.gasFee, args.tokenFee],
+        account
+      );
+    });
+  }
+  async disableCustomFee(creator, account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.disableCustomFee", async () => {
+      return this.#write("disableCustomFee", [creator], account);
+    });
+  }
+  async setFeeCollector(newCollector, account) {
+    return withTelemetry(this.#telemetry, "fhe-vesting.factory.setFeeCollector", async () => {
+      return this.#write("setFeeCollector", [newCollector], account);
+    });
+  }
+  // ----------------------- reads -----------------------
+  /** Current LibClone implementation address. */
+  async implementation() {
+    return this.#read("implementation");
+  }
+  /**
+   * Alias for {@link ConfidentialVestingFactoryClient.implementation} that matches
+   * the contract's storage field name (`_managerImplementation`).
+   *
+   * Renamed for clarity per backend-integrator-r14 friction
+   * (`docs/feedback/inbox/2026-05-24-backend-integrator-r14-minor-implementation-vs-manager-implementation-naming.md`):
+   * server devs reading the Solidity reach for `factory.managerImplementation()`
+   * via autocomplete (the contract storage slot name) and hit a TS2551. The
+   * canonical `implementation()` method is retained for backwards-compat and
+   * cross-factory uniformity (fhe-airdrop exposes the same shape).
+   */
+  async managerImplementation() {
+    return this.implementation();
+  }
+  async defaultGasFee() {
+    return this.#read("defaultGasFee");
+  }
+  async defaultTokenFee() {
+    return this.#read("defaultTokenFee");
+  }
+  async defaultFeeType() {
+    const raw = await this.#read("defaultFeeType");
+    return raw;
+  }
+  async feeCollector() {
+    return this.#read("feeCollector");
+  }
+  async getCustomFee(creator) {
+    const raw = await this.#read("getCustomFee", [creator]);
+    return {
+      enabled: raw.enabled,
+      preferredFeeType: raw.preferredFeeType,
+      gasFee: raw.gasFee,
+      tokenFee: raw.tokenFee
+    };
+  }
+  async getInitCodeHash(args) {
+    const hasOptions = args.splitEnabled !== void 0 || args.pausableEnabled !== void 0;
+    if (hasOptions) {
+      return this.#read("getInitCodeHashWithOptions", [
+        args.token,
+        args.deployer,
+        args.splitEnabled ?? true,
+        args.pausableEnabled ?? true
+      ]);
+    }
+    return this.#read("getInitCodeHash", [args.token, args.deployer]);
+  }
+  // ----------------------- internals -----------------------
+  /**
+   * Wait for the receipt of a clone-deploy tx and parse the `ManagerCreated`
+   * event to extract the deployed manager address. Branded result; throws
+   * `TokenOpsSdkError` if zero or >1 events match this factory address.
+   */
+  async #resolveManagerFromReceipt(hash, method) {
+    const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+    const events = parseEventLogs({
+      abi: confidentialVestingFactoryAbi,
+      eventName: "ManagerCreated",
+      logs: receipt.logs
+    });
+    const ours = events.filter((ev) => ev.address.toLowerCase() === this.address.toLowerCase());
+    if (ours.length === 0) {
+      throw new TokenOpsSdkError(
+        `${method}: no ManagerCreated event from factory ${this.address} in tx ${hash}`
+      );
+    }
+    if (ours.length > 1) {
+      throw new TokenOpsSdkError(
+        `${method}: ${ours.length} ManagerCreated events from factory ${this.address} in tx ${hash}; ambiguous result`
+      );
+    }
+    return { hash: asTxHash(hash), manager: ours[0].args.manager };
+  }
+  #requireWallet(method) {
+    if (!this.walletClient) {
+      throw new MissingWalletClientError(method);
+    }
+    return this.walletClient;
+  }
+  async #write(functionName, args, account) {
+    const wallet = this.#requireWallet(functionName);
+    const acct = account ?? wallet.account;
+    if (!acct) {
+      throw new MissingAccountError(String(functionName));
+    }
+    await this.#preflightWrite(String(functionName), functionName, args, acct);
+    try {
+      return await wallet.writeContract({
+        address: this.address,
+        abi: confidentialVestingFactoryAbi,
+        functionName,
+        args,
+        account: acct,
+        chain: wallet.chain
+      });
+    } catch (err) {
+      throw this.#mapRevert(String(functionName), err, accountAddress(acct));
+    }
+  }
+  #mapRevert(method, err, account) {
+    return mapContractRevert(err, {
+      method,
+      contractAddress: this.address,
+      abi: confidentialVestingFactoryAbi,
+      productMapper: vestingFactoryProductMapper,
+      account
+    });
+  }
+  /**
+   * Pre-flight a write via `simulateContract` purely to surface typed reverts.
+   * The simulate's *return value* is discarded — only revert metadata matters,
+   * since wallet transports drop revert data during gas estimation
+   * (CLAUDE.md Pitfall #1).
+   */
+  async #preflightWrite(method, functionName, args, account, value) {
+    try {
+      await this.publicClient.simulateContract({
+        address: this.address,
+        abi: confidentialVestingFactoryAbi,
+        functionName,
+        args,
+        account,
+        ...value !== void 0 ? { value } : {}
+      });
+    } catch (err) {
+      if (isContractRevert(err)) {
+        throw this.#mapRevert(method, err, accountAddress(account));
+      }
+    }
+  }
+  async #read(functionName, args = [], blockNumber) {
+    const result = await this.publicClient.readContract({
+      address: this.address,
+      abi: confidentialVestingFactoryAbi,
+      functionName,
+      args,
+      ...blockNumber !== void 0 && { blockNumber }
+    });
+    return result;
+  }
+};
+function createConfidentialVestingFactoryClient(config) {
+  return new ConfidentialVestingFactoryClient(config);
+}
+function accountAddress(account) {
+  return typeof account === "string" ? account : account.address;
+}
+
+export { ConfidentialVestingFactoryClient, DisclosureType, FeeType, confidentialVestingFactoryAbi, createConfidentialVestingFactoryClient, feeTypeName };