@tokenops/sdk 1.0.0 → 1.1.1

package/dist/{chunk-T5LVV3KY.cjs → chunk-FPQBFIUW.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunk6ECAHP5O_cjs = require('./chunk-6ECAHP5O.cjs');
+var chunkSYHXDHWX_cjs = require('./chunk-SYHXDHWX.cjs');
 
 // src/fhe-airdrop/advanced/factory-advanced.ts
-var ConfidentialAirdropFactoryAdvancedClient = class extends chunk6ECAHP5O_cjs.ConfidentialAirdropFactoryClient {
+var ConfidentialAirdropFactoryAdvancedClient = class extends chunkSYHXDHWX_cjs.ConfidentialAirdropFactoryClient {
   /**
    * Compute the deterministic CREATE2 address for an airdrop clone without
    * deploying it.
@@ -21,7 +21,7 @@ var ConfidentialAirdropFactoryAdvancedClient = class extends chunk6ECAHP5O_cjs.C
   async predictAirdropAddress(args) {
     return this.publicClient.readContract({
       address: this.address,
-      abi: chunk6ECAHP5O_cjs.confidentialAirdropFactoryAbi,
+      abi: chunkSYHXDHWX_cjs.confidentialAirdropFactoryAbi,
       functionName: "predictAirdropAddress",
       args: [toAbiParams(args.params), args.userSalt, args.deployer, args.gasFee]
     });

package/dist/{chunk-QIHZVLIK.js → chunk-FXCW7LVB.js}

@@ -1,7 +1,7 @@
 import { mapZamaError } from './chunk-ZXCOJY2Z.js';
 import { getFhevmAclAddress, requireFhevmAclAddress, ACL_ALLOWED_EVENT } from './chunk-FYQ2UW4T.js';
 import { SDK_VERSION, isContractRevert, mapContractRevert } from './chunk-JFLEEXKP.js';
-import { getFheDisperseSingletonAddress } from './chunk-COPFW5Z4.js';
+import { getFheDisperseSingletonAddress } from './chunk-M7V2EDPB.js';
 import { normaliseAddress } from './chunk-BE2AIZ3K.js';
 import { withTelemetry } from './chunk-Q2GP5UDC.js';
 import { asExternalInputProof, asEncryptedHandle } from './chunk-KWFFIJYX.js';

package/dist/{chunk-K6MFFDBJ.cjs → chunk-G7G75C46.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var chunk5SA2HF2W_cjs = require('./chunk-5SA2HF2W.cjs');
-var chunk6ECAHP5O_cjs = require('./chunk-6ECAHP5O.cjs');
-var chunkOLDGMKW2_cjs = require('./chunk-OLDGMKW2.cjs');
+var chunkSYHXDHWX_cjs = require('./chunk-SYHXDHWX.cjs');
+var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
 var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
 var react = require('react');
 var wagmi = require('wagmi');
@@ -12,7 +12,7 @@ var FHE_AIRDROP_NAMESPACE = "fhe-airdrop";
 function tryResolveFactoryAddress(override, chainId) {
   if (override) return override;
   if (chainId === void 0) return void 0;
-  return chunkOLDGMKW2_cjs.getFheAirdropFactoryAddress(chainId);
+  return chunk3ZRHDTEX_cjs.getFheAirdropFactoryAddress(chainId);
 }
 function useMemoFactoryClient(opts = {}) {
   const publicClient = wagmi.usePublicClient({ chainId: opts.chainId });
@@ -25,14 +25,14 @@ function useMemoFactoryClient(opts = {}) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunk6ECAHP5O_cjs.createConfidentialAirdropFactoryClient({
+    return chunkSYHXDHWX_cjs.createConfidentialAirdropFactoryClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
       ...chainId !== void 0 ? { chainId } : {},
       // Lazy — invoked per-encryption inside the headless client. Picks up
       // whichever EncryptorSource the consumer last passed in.
-      encryptor: () => chunk6ECAHP5O_cjs.resolveEncryptor(encryptorSourceRef.current)
+      encryptor: () => chunkSYHXDHWX_cjs.resolveEncryptor(encryptorSourceRef.current)
     });
   }, [publicClient, walletClient, resolvedAddress, chainId]);
   return {
@@ -54,7 +54,7 @@ function computeFactoryResolutionError(override, chainId) {
       clientLabel: "ConfidentialAirdropFactoryClient"
     });
   }
-  const resolved = chunkOLDGMKW2_cjs.getFheAirdropFactoryAddress(chainId);
+  const resolved = chunk3ZRHDTEX_cjs.getFheAirdropFactoryAddress(chainId);
   if (!resolved) {
     return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
       reason: "registry-not-deployed",

package/dist/{chunk-72YGZEQE.js → chunk-IR5AK5U5.js}

@@ -1,5 +1,5 @@
 import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-JFLEEXKP.js';
-import { getFheVestingFactoryAddress } from './chunk-COPFW5Z4.js';
+import { getFheVestingFactoryAddress } from './chunk-M7V2EDPB.js';
 import { normaliseAddress } from './chunk-BE2AIZ3K.js';
 import { withTelemetry } from './chunk-Q2GP5UDC.js';
 import { asTxHash } from './chunk-KWFFIJYX.js';
@@ -469,11 +469,10 @@ var ConfidentialVestingFactoryClient = class {
    * 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
+   * **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
-   * forced consumers to re-derive what the SDK already had to compute.
+   * 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.
@@ -594,9 +593,8 @@ var ConfidentialVestingFactoryClient = class {
    * 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()`
+   * Named for clarity: 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).

package/dist/{chunk-CMRETRZO.js → chunk-ITQBDRWX.js}

@@ -1,4 +1,4 @@
-import { ConfidentialVestingFactoryClient, confidentialVestingFactoryAbi } from './chunk-72YGZEQE.js';
+import { ConfidentialVestingFactoryClient, confidentialVestingFactoryAbi } from './chunk-IR5AK5U5.js';
 
 // src/fhe-vesting/advanced/factory-advanced.ts
 var ConfidentialVestingFactoryAdvancedClient = class extends ConfidentialVestingFactoryClient {

package/dist/{chunk-ZHFLRKFY.js → chunk-JJ4R5QXF.js}

@@ -1,4 +1,4 @@
-import { ConfidentialAirdropFactoryClient, confidentialAirdropFactoryAbi } from './chunk-UOG4PJL5.js';
+import { ConfidentialAirdropFactoryClient, confidentialAirdropFactoryAbi } from './chunk-OQZAZIAS.js';
 
 // src/fhe-airdrop/advanced/factory-advanced.ts
 var ConfidentialAirdropFactoryAdvancedClient = class extends ConfidentialAirdropFactoryClient {

package/dist/{chunk-COPFW5Z4.js → chunk-M7V2EDPB.js}

@@ -19,6 +19,23 @@ var DEPLOYED_ADDRESSES = {
       [mainnet.id]: "0x4fC0d28cBe4B82D512Ad0B42F6787480Cc98cC70",
       [sepolia.id]: "0x710dD9885Cc9986EfD234E7719483147a6d8DBb4"
     }
+  },
+  // Testnet-only faucet token pair (see `/testnet-faucet`). The standard
+  // `TokenopsTestToken` (TTT, 18-decimal ERC-20, open mint) and its
+  // confidential ERC-7984 wrapper `ConfidentialTokenopsTestToken` (CTTT,
+  // 6-decimal, open backed faucet mint). Sepolia only — these mint value-less
+  // test tokens to anyone, so they MUST NOT appear on mainnet.
+  // `confidentialTestToken` is the UUPS *proxy* address; call it with the
+  // implementation ABI.
+  testnetFaucet: {
+    testToken: {
+      [sepolia.id]: "0x37a057Fa8C201a7bf8caF32dfa9A0878f577D92b"
+      // mainnet omitted — testnet-only by design.
+    },
+    confidentialTestToken: {
+      [sepolia.id]: "0x258F9D60dc023870e4E3109c894D834D5377361a"
+      // mainnet omitted — testnet-only by design.
+    }
   }
 };
 function getDeployedAddress(product, contract, chainId) {
@@ -56,6 +73,18 @@ function getFheDisperseSingletonAddress(chainId) {
 function requireFheDisperseSingletonAddress(chainId) {
   return requireDeployedAddress("fheDisperse", "disperseConfidentialSingleton", chainId);
 }
+function getTestTokenAddress(chainId) {
+  return getDeployedAddress("testnetFaucet", "testToken", chainId);
+}
+function requireTestTokenAddress(chainId) {
+  return requireDeployedAddress("testnetFaucet", "testToken", chainId);
+}
+function getConfidentialTestTokenAddress(chainId) {
+  return getDeployedAddress("testnetFaucet", "confidentialTestToken", chainId);
+}
+function requireConfidentialTestTokenAddress(chainId) {
+  return requireDeployedAddress("testnetFaucet", "confidentialTestToken", chainId);
+}
 function chainsWithKnownRegistryEntry(product) {
   const productEntry = DEPLOYED_ADDRESSES[product];
   const ids = /* @__PURE__ */ new Set();
@@ -79,4 +108,4 @@ function chainsWithDeployment(product) {
   ).sort((a, b) => a - b);
 }
 
-export { DEPLOYED_ADDRESSES, chainsWithDeployment, chainsWithKnownRegistryEntry, getDeployedAddress, getFheAirdropFactoryAddress, getFheDisperseSingletonAddress, getFheVestingFactoryAddress, requireFheAirdropFactoryAddress, requireFheDisperseSingletonAddress, requireFheVestingFactoryAddress };
+export { DEPLOYED_ADDRESSES, chainsWithDeployment, chainsWithKnownRegistryEntry, getConfidentialTestTokenAddress, getDeployedAddress, getFheAirdropFactoryAddress, getFheDisperseSingletonAddress, getFheVestingFactoryAddress, getTestTokenAddress, requireConfidentialTestTokenAddress, requireFheAirdropFactoryAddress, requireFheDisperseSingletonAddress, requireFheVestingFactoryAddress, requireTestTokenAddress };

package/dist/{chunk-UOG4PJL5.js → chunk-OQZAZIAS.js}

@@ -1,5 +1,5 @@
 import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-JFLEEXKP.js';
-import { getFheAirdropFactoryAddress } from './chunk-COPFW5Z4.js';
+import { getFheAirdropFactoryAddress } from './chunk-M7V2EDPB.js';
 import { normaliseAddress } from './chunk-BE2AIZ3K.js';
 import { withTelemetry } from './chunk-Q2GP5UDC.js';
 import { asExternalInputProof, asEncryptedHandle, asSignature, asTxHash } from './chunk-KWFFIJYX.js';
@@ -1077,11 +1077,10 @@ var ConfidentialAirdropFactoryClient = class {
    * Deploy a new airdrop clone via the factory and return its address, parsed
    * from the `ConfidentialAirdropCreated` 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 —
-   * 90 %+ of consumers want the deployed address back, and the SDK already
-   * waits + parses the event, so there's no reason to make consumers do it
-   * themselves.
+   * **This is the headline factory entry point.** It returns one rich-return
+   * shape: most consumers want the deployed address back, and the SDK already
+   * waits for and parses the event, so there's no reason to make consumers do
+   * it themselves.
    *
    * Internally: `writeContract` → {@link PublicClient.waitForTransactionReceipt} →
    * `parseEventLogs({ eventName: "ConfidentialAirdropCreated" })`.
@@ -1119,7 +1118,7 @@ var ConfidentialAirdropFactoryClient = class {
    *
    * Symmetric with {@link ConfidentialAirdropFactoryClient.createConfidentialAirdrop}
    * — both return `{ hash, airdrop }` parsed from the
-   * `ConfidentialAirdropCreated` event (R02 ADR P-1).
+   * `ConfidentialAirdropCreated` event.
    *
    * @example
    * const { hash, airdrop } = await factory.createAndFundConfidentialAirdrop({
@@ -1294,9 +1293,8 @@ var ConfidentialAirdropFactoryClient = class {
    * Alias for {@link ConfidentialAirdropFactoryClient.implementation} that matches
    * the contract's storage field name (`_airdropImplementation`).
    *
-   * Shipped proactively in R17 for parity with `fhe-vesting`'s
-   * `managerImplementation()` alias (commit 6f6d7bc, closing
-   * backend-integrator-r14 minor). The airdrop factory has the same
+   * Provided for parity with `fhe-vesting`'s `managerImplementation()` alias.
+   * The airdrop factory has the same
    * LibClone shape mirroring `_airdropImplementation` storage, so server
    * devs reading the Solidity first reach for `factory.airdropImplementation()`
    * via autocomplete and would otherwise hit a TS2551 on the SDK's

package/dist/{chunk-SUOG3BQS.cjs → chunk-OYLZEEHF.cjs}

@@ -1400,8 +1400,7 @@ var ConfidentialVestingManagerClient = class {
    * Accepts `bigint | number` for `start` / `end` for ergonomics on read paths
    * — CI scripts typically derive these from `Number(process.env.X)` and
    * forcing bigint coercion at the call site is a pure paper cut. The
-   * underlying contract reads through unchanged (viem coerces). R22
-   * devops-integrator MINOR-4; R25 close.
+   * underlying contract reads through unchanged (viem coerces).
    */
   async getAllRecipientsSliced(start, end) {
     return this.#read("getAllRecipientsSliced", [BigInt(start), BigInt(end)]);