@tokenops/sdk 1.0.0 → 1.1.1

package/dist/{chunk-62DF53UQ.cjs → chunk-SAGJIEQK.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
-var chunkOLDGMKW2_cjs = require('./chunk-OLDGMKW2.cjs');
+var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
 var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
@@ -445,7 +445,7 @@ var ConfidentialVestingFactoryClient = class {
     this.walletClient = config.walletClient;
     const chainId = config.chainId ?? config.publicClient.chain?.id;
     const addressOverride = config.address ? chunkCQIPRNS7_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkOLDGMKW2_cjs.getFheVestingFactoryAddress(chainId));
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId));
     if (!resolved) {
       throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
@@ -471,11 +471,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.
@@ -596,9 +595,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-JFR5J4FL.cjs → chunk-SEKC7H5Y.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkSUOG3BQS_cjs = require('./chunk-SUOG3BQS.cjs');
-var chunk62DF53UQ_cjs = require('./chunk-62DF53UQ.cjs');
-var chunkOLDGMKW2_cjs = require('./chunk-OLDGMKW2.cjs');
+var chunkOYLZEEHF_cjs = require('./chunk-OYLZEEHF.cjs');
+var chunkSAGJIEQK_cjs = require('./chunk-SAGJIEQK.cjs');
+var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
 var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
 var react = require('react');
 var wagmi = require('wagmi');
@@ -25,7 +25,7 @@ function useHookFiredEvent(hookName, telemetry, hasWallet, chainId) {
 function tryResolveFactoryAddress(override, chainId) {
   if (override) return override;
   if (chainId === void 0) return void 0;
-  return chunkOLDGMKW2_cjs.getFheVestingFactoryAddress(chainId);
+  return chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId);
 }
 function useMemoFactoryClient(opts = {}) {
   const publicClient = wagmi.usePublicClient({ chainId: opts.chainId });
@@ -38,7 +38,7 @@ function useMemoFactoryClient(opts = {}) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunk62DF53UQ_cjs.createConfidentialVestingFactoryClient({
+    return chunkSAGJIEQK_cjs.createConfidentialVestingFactoryClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
@@ -65,7 +65,7 @@ function computeFactoryResolutionError(override, chainId) {
       clientLabel: "ConfidentialVestingFactoryClient"
     });
   }
-  const resolved = chunkOLDGMKW2_cjs.getFheVestingFactoryAddress(chainId);
+  const resolved = chunk3ZRHDTEX_cjs.getFheVestingFactoryAddress(chainId);
   if (!resolved) {
     return new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
       reason: "registry-not-deployed",
@@ -88,13 +88,13 @@ function useMemoManagerClient(opts) {
   const client = react.useMemo(() => {
     if (!publicClient) return void 0;
     if (!opts.address) return void 0;
-    return chunkSUOG3BQS_cjs.createConfidentialVestingManagerClient({
+    return chunkOYLZEEHF_cjs.createConfidentialVestingManagerClient({
       publicClient,
       ...walletClient ? { walletClient } : {},
       address: opts.address,
       // Lazy — invoked per-encryption inside the headless client. Picks up
       // whichever EncryptorSource the consumer last passed in.
-      encryptor: () => chunkSUOG3BQS_cjs.resolveEncryptor(encryptorSourceRef.current),
+      encryptor: () => chunkOYLZEEHF_cjs.resolveEncryptor(encryptorSourceRef.current),
       ...opts.aclAddress ? { aclAddress: opts.aclAddress } : {},
       ...telemetry ? { telemetry } : {}
     });

package/dist/{chunk-6ECAHP5O.cjs → chunk-SYHXDHWX.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkVDXVNZCO_cjs = require('./chunk-VDXVNZCO.cjs');
-var chunkOLDGMKW2_cjs = require('./chunk-OLDGMKW2.cjs');
+var chunk3ZRHDTEX_cjs = require('./chunk-3ZRHDTEX.cjs');
 var chunkCQIPRNS7_cjs = require('./chunk-CQIPRNS7.cjs');
 var chunkVJKZWYYJ_cjs = require('./chunk-VJKZWYYJ.cjs');
 var chunk66IHPTOK_cjs = require('./chunk-66IHPTOK.cjs');
@@ -1053,7 +1053,7 @@ var ConfidentialAirdropFactoryClient = class {
     this.encryptor = config.encryptor;
     const chainId = config.chainId ?? config.publicClient.chain?.id;
     const addressOverride = config.address ? chunkCQIPRNS7_cjs.normaliseAddress(config.address) : void 0;
-    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunkOLDGMKW2_cjs.getFheAirdropFactoryAddress(chainId));
+    const resolved = addressOverride ?? (chainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.getFheAirdropFactoryAddress(chainId));
     if (!resolved) {
       throw new chunk56UI7LUR_cjs.DeploymentAddressUnavailableError({
         reason: chainId === void 0 ? "chain-id-missing" : "registry-not-deployed",
@@ -1079,11 +1079,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" })`.
@@ -1121,7 +1120,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({
@@ -1296,9 +1295,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-QCA7O2Q5.cjs → chunk-W7JHOK7G.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunk62DF53UQ_cjs = require('./chunk-62DF53UQ.cjs');
+var chunkSAGJIEQK_cjs = require('./chunk-SAGJIEQK.cjs');
 
 // src/fhe-vesting/advanced/factory-advanced.ts
-var ConfidentialVestingFactoryAdvancedClient = class extends chunk62DF53UQ_cjs.ConfidentialVestingFactoryClient {
+var ConfidentialVestingFactoryAdvancedClient = class extends chunkSAGJIEQK_cjs.ConfidentialVestingFactoryClient {
   /**
    * Compute the deterministic CREATE2 clone address as the factory would have
    * computed it at `args.blockNumber`.
@@ -20,7 +20,7 @@ var ConfidentialVestingFactoryAdvancedClient = class extends chunk62DF53UQ_cjs.C
     if (hasOptions) {
       return this.publicClient.readContract({
         address: this.address,
-        abi: chunk62DF53UQ_cjs.confidentialVestingFactoryAbi,
+        abi: chunkSAGJIEQK_cjs.confidentialVestingFactoryAbi,
         functionName: "predictManagerAddressWithOptions",
         args: [
           args.token,
@@ -34,7 +34,7 @@ var ConfidentialVestingFactoryAdvancedClient = class extends chunk62DF53UQ_cjs.C
     }
     return this.publicClient.readContract({
       address: this.address,
-      abi: chunk62DF53UQ_cjs.confidentialVestingFactoryAbi,
+      abi: chunkSAGJIEQK_cjs.confidentialVestingFactoryAbi,
       functionName: "predictManagerAddress",
       args: [args.token, args.userSalt, args.deployer],
       blockNumber: args.blockNumber

package/dist/{chunk-52TC6BF7.js → chunk-X56UVEXS.js}

@@ -1398,8 +1398,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)]);

package/dist/{chunk-HGXNRR25.js → chunk-XWDVPV42.js}

@@ -1,6 +1,6 @@
 import { createConfidentialAirdropClient } from './chunk-XXXDQSHE.js';
-import { createConfidentialAirdropFactoryClient, resolveEncryptor } from './chunk-UOG4PJL5.js';
-import { getFheAirdropFactoryAddress } from './chunk-COPFW5Z4.js';
+import { createConfidentialAirdropFactoryClient, resolveEncryptor } from './chunk-OQZAZIAS.js';
+import { getFheAirdropFactoryAddress } from './chunk-M7V2EDPB.js';
 import { DeploymentAddressUnavailableError } from './chunk-IVE3QEGD.js';
 import { useRef, useMemo } from 'react';
 import { usePublicClient, useWalletClient } from 'wagmi';

package/dist/core/addresses.d.ts

@@ -24,6 +24,14 @@ export declare const DEPLOYED_ADDRESSES: {
             readonly 11155111: "0x710dD9885Cc9986EfD234E7719483147a6d8DBb4";
         };
     };
+    readonly testnetFaucet: {
+        readonly testToken: {
+            readonly 11155111: "0x37a057Fa8C201a7bf8caF32dfa9A0878f577D92b";
+        };
+        readonly confidentialTestToken: {
+            readonly 11155111: "0x258F9D60dc023870e4E3109c894D834D5377361a";
+        };
+    };
 };
 export type DeployedAddresses = typeof DEPLOYED_ADDRESSES;
 export type ProductKey = keyof DeployedAddresses;
@@ -41,6 +49,20 @@ export declare function getFheAirdropFactoryAddress(chainId: number): Address |
 export declare function requireFheAirdropFactoryAddress(chainId: number): Address;
 export declare function getFheDisperseSingletonAddress(chainId: number): Address | undefined;
 export declare function requireFheDisperseSingletonAddress(chainId: number): Address;
+/**
+ * Address of the standard `TokenopsTestToken` (TTT) — the 18-decimal ERC-20
+ * with an open `mint` that backs the confidential faucet. Testnet-only;
+ * returns `undefined` on chains without a deployment (e.g. mainnet).
+ */
+export declare function getTestTokenAddress(chainId: number): Address | undefined;
+export declare function requireTestTokenAddress(chainId: number): Address;
+/**
+ * Address of the `ConfidentialTokenopsTestToken` (CTTT) UUPS proxy — the
+ * 6-decimal ERC-7984 confidential wrapper with an open backed faucet `mint`.
+ * Testnet-only; returns `undefined` on chains without a deployment.
+ */
+export declare function getConfidentialTestTokenAddress(chainId: number): Address | undefined;
+export declare function requireConfidentialTestTokenAddress(chainId: number): Address;
 /**
  * Chains with a registry entry for `product`, including ones explicitly
  * marked `null` (known chain, not yet deployed). Useful when the consumer

package/dist/core/errors.d.ts

@@ -12,7 +12,7 @@ declare const TOKENOPS_SDK_ERROR_BRAND: unique symbol;
  * on `error.code` in `onError` handlers and UI surfaces. Messages stay
  * human-readable and may evolve between versions.
  */
-export type TokenOpsSdkErrorCode = "TOKENOPS_UNSUPPORTED_CHAIN" | "TOKENOPS_DEPLOYMENT_ADDRESS_UNAVAILABLE" | "TOKENOPS_MISSING_PUBLIC_CLIENT" | "TOKENOPS_MISSING_WALLET_CLIENT" | "TOKENOPS_MISSING_ACCOUNT" | "TOKENOPS_MISSING_ENCRYPTOR" | "TOKENOPS_MISSING_CLIENT" | "TOKENOPS_INVALID_ARGUMENT" | "TOKENOPS_RECEIPT_EVENT_NOT_FOUND" | "TOKENOPS_RECEIPT_EVENT_AMBIGUOUS" | "TOKENOPS_CONTRACT_REVERT" | "TOKENOPS_PAUSED" | "TOKENOPS_ACCESS_DENIED" | "TOKENOPS_INSUFFICIENT_FEE" | "TOKENOPS_INSUFFICIENT_BALANCE" | "TOKENOPS_BATCH_TOO_LARGE" | "TOKENOPS_FEATURE_DISABLED" | "TOKENOPS_TRANSFER_FAILED" | "TOKENOPS_FHE_HANDLE_NOT_ALLOWED" | "TOKENOPS_ALREADY_INITIALIZED" | "TOKENOPS_REENTRANCY" | "TOKENOPS_INVALID_SIGNATURE" | "TOKENOPS_WALLET_REJECTED" | "TOKENOPS_WALLET_CHAIN_MISMATCH" | "TOKENOPS_NETWORK_ERROR" | "TOKENOPS_INSUFFICIENT_GAS_FUNDS" | "TOKENOPS_UNKNOWN_WRITE_FAILURE" | "TOKENOPS_USER_REJECTED" | "TOKENOPS_SIGNING_FAILED" | "TOKENOPS_RELAYER_UNREACHABLE" | "TOKENOPS_ENCRYPTION_FAILED" | "TOKENOPS_DECRYPTION_FAILED" | "TOKENOPS_USER_DECRYPT_NOT_ALLOWED" | "TOKENOPS_VESTING_NOT_FOUND" | "TOKENOPS_NOT_RECIPIENT" | "TOKENOPS_CLAIM_LOCKED" | "TOKENOPS_VESTING_REVOKED" | "TOKENOPS_NOT_REVOCABLE" | "TOKENOPS_VESTING_EXPIRED" | "TOKENOPS_TRANSFER_ALREADY_PENDING" | "TOKENOPS_NO_PENDING_TRANSFER" | "TOKENOPS_NOT_PENDING_RECIPIENT" | "TOKENOPS_TRANSFER_EXPIRED" | "TOKENOPS_ALREADY_CLAIMED" | "TOKENOPS_CLAIM_NOT_STARTED" | "TOKENOPS_CLAIM_WINDOW_CLOSED" | "TOKENOPS_NOT_REGISTERED" | "TOKENOPS_ALREADY_REGISTERED";
+export type TokenOpsSdkErrorCode = "TOKENOPS_UNSUPPORTED_CHAIN" | "TOKENOPS_DEPLOYMENT_ADDRESS_UNAVAILABLE" | "TOKENOPS_MISSING_PUBLIC_CLIENT" | "TOKENOPS_MISSING_WALLET_CLIENT" | "TOKENOPS_MISSING_ACCOUNT" | "TOKENOPS_MISSING_ENCRYPTOR" | "TOKENOPS_MISSING_CLIENT" | "TOKENOPS_INVALID_ARGUMENT" | "TOKENOPS_RECEIPT_EVENT_NOT_FOUND" | "TOKENOPS_RECEIPT_EVENT_AMBIGUOUS" | "TOKENOPS_CONTRACT_REVERT" | "TOKENOPS_PAUSED" | "TOKENOPS_ACCESS_DENIED" | "TOKENOPS_INSUFFICIENT_FEE" | "TOKENOPS_INSUFFICIENT_BALANCE" | "TOKENOPS_BATCH_TOO_LARGE" | "TOKENOPS_FEATURE_DISABLED" | "TOKENOPS_TRANSFER_FAILED" | "TOKENOPS_FHE_HANDLE_NOT_ALLOWED" | "TOKENOPS_ALREADY_INITIALIZED" | "TOKENOPS_REENTRANCY" | "TOKENOPS_INVALID_SIGNATURE" | "TOKENOPS_WALLET_REJECTED" | "TOKENOPS_WALLET_CHAIN_MISMATCH" | "TOKENOPS_NETWORK_ERROR" | "TOKENOPS_INSUFFICIENT_GAS_FUNDS" | "TOKENOPS_UNKNOWN_WRITE_FAILURE" | "TOKENOPS_USER_REJECTED" | "TOKENOPS_SIGNING_FAILED" | "TOKENOPS_RELAYER_UNREACHABLE" | "TOKENOPS_ENCRYPTION_FAILED" | "TOKENOPS_DECRYPTION_FAILED" | "TOKENOPS_USER_DECRYPT_NOT_ALLOWED" | "TOKENOPS_VESTING_NOT_FOUND" | "TOKENOPS_NOT_RECIPIENT" | "TOKENOPS_CLAIM_LOCKED" | "TOKENOPS_VESTING_REVOKED" | "TOKENOPS_NOT_REVOCABLE" | "TOKENOPS_VESTING_EXPIRED" | "TOKENOPS_TRANSFER_ALREADY_PENDING" | "TOKENOPS_NO_PENDING_TRANSFER" | "TOKENOPS_NOT_PENDING_RECIPIENT" | "TOKENOPS_TRANSFER_EXPIRED" | "TOKENOPS_ALREADY_CLAIMED" | "TOKENOPS_CLAIM_NOT_STARTED" | "TOKENOPS_CLAIM_WINDOW_CLOSED" | "TOKENOPS_NOT_REGISTERED" | "TOKENOPS_ALREADY_REGISTERED" | "TOKENOPS_FAUCET_SUPPLY_EXHAUSTED";
 export interface TokenOpsSdkErrorInit {
     code: TokenOpsSdkErrorCode;
     cause?: unknown;

package/dist/core/telemetry.d.ts

@@ -29,9 +29,6 @@ export interface SdkTelemetry {
      * Adapters that DO implement it should return a NEW telemetry instance —
      * mutating `this` would leak tags across unrelated consumers sharing the
      * same SDK client.
-     *
-     * Added per backend-integrator-r14 nit-positive friction
-     * (`docs/feedback/resolved/2026-05-24-backend-integrator-r14-minor-sdktelemetry-shape-matches-node-logger-pattern-cleanly.md`).
      */
     scope?(tags: SdkTelemetryTags): SdkTelemetry;
 }

package/dist/fhe/operators.d.ts

@@ -166,7 +166,7 @@ export interface RevokeOperatorArgs {
  * {@link ERC7984_OPERATOR_MAX_DEADLINE} (uint48 max ≈ year 8.9e+14) — useful
  * for local-chain dev loops, hostile for production deployments where a
  * stale manager clone (replaced by a new one) would otherwise keep operator
- * rights forever. R19 evm-audit M-3: the original `setOperator` shipped
+ * rights forever. The original `setOperator` shipped
  * without a revoke sibling, forcing consumers to hand-roll
  * `walletClient.writeContract({ ..., args: [spender, 0] })`.
  *

package/dist/fhe-airdrop/advanced/factory-advanced.d.ts

@@ -4,9 +4,9 @@ import { ConfidentialAirdropFactoryClient, type ConfidentialAirdropFactoryClient
  * Advanced extension of {@link ConfidentialAirdropFactoryClient} that re-exposes
  * the CREATE2 address prediction read.
  *
- * **Why this is "advanced" surface.** R02 ADR P-1 + P-2 (alignment-auditor R04
- * top-1): 90 % of consumers want one call back — `createConfidentialAirdrop`
- * (rich-return, `{ hash, airdrop }`). The factory still emits
+ * **Why this is "advanced" surface.** Most consumers want one call back —
+ * `createConfidentialAirdrop` (rich-return, `{ hash, airdrop }`). The factory
+ * still emits
  * `ConfidentialAirdropCreated`, the SDK still parses it, so consumers never
  * need to ask "what address will this deploy to before mining?" Hoisting
  * `predictAirdropAddress` onto the headline client surface gave consumers a

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

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkT5LVV3KY_cjs = require('../../chunk-T5LVV3KY.cjs');
-require('../../chunk-6ECAHP5O.cjs');
+var chunkFPQBFIUW_cjs = require('../../chunk-FPQBFIUW.cjs');
+require('../../chunk-SYHXDHWX.cjs');
 require('../../chunk-VDXVNZCO.cjs');
-require('../../chunk-OLDGMKW2.cjs');
+require('../../chunk-3ZRHDTEX.cjs');
 require('../../chunk-CQIPRNS7.cjs');
 require('../../chunk-VJKZWYYJ.cjs');
 require('../../chunk-66IHPTOK.cjs');
@@ -13,9 +13,9 @@ require('../../chunk-56UI7LUR.cjs');
 
 Object.defineProperty(exports, "ConfidentialAirdropFactoryAdvancedClient", {
   enumerable: true,
-  get: function () { return chunkT5LVV3KY_cjs.ConfidentialAirdropFactoryAdvancedClient; }
+  get: function () { return chunkFPQBFIUW_cjs.ConfidentialAirdropFactoryAdvancedClient; }
 });
 Object.defineProperty(exports, "createConfidentialAirdropFactoryAdvancedClient", {
   enumerable: true,
-  get: function () { return chunkT5LVV3KY_cjs.createConfidentialAirdropFactoryAdvancedClient; }
+  get: function () { return chunkFPQBFIUW_cjs.createConfidentialAirdropFactoryAdvancedClient; }
 });

package/dist/fhe-airdrop/advanced/index.d.cts

@@ -1,13 +1,13 @@
 /**
  * Advanced FHE-airdrop primitives — power-user surface kept off the headline
- * client to keep the 90 % path lean (R02 ADR P-2; alignment-auditor R04 top-1).
+ * client to keep the common path lean.
  *
  * Re-exports the {@link ConfidentialAirdropFactoryAdvancedClient} subclass,
  * which extends the headline factory client with `predictAirdropAddress`. Use
  * this subpath when you genuinely need to compute a clone address before
  * deploying — historical recovery, deterministic same-tx flows. For the
  * common "deploy and learn the address" case, the headline factory's
- * `createConfidentialAirdrop` returns `{ hash, airdrop }` directly (R02 ADR P-1).
+ * `createConfidentialAirdrop` returns `{ hash, airdrop }` directly.
  */
 export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient, } from "./factory-advanced.js";
 export type { PredictAirdropArgs } from "../factory.js";

package/dist/fhe-airdrop/advanced/index.d.ts

@@ -1,13 +1,13 @@
 /**
  * Advanced FHE-airdrop primitives — power-user surface kept off the headline
- * client to keep the 90 % path lean (R02 ADR P-2; alignment-auditor R04 top-1).
+ * client to keep the common path lean.
  *
  * Re-exports the {@link ConfidentialAirdropFactoryAdvancedClient} subclass,
  * which extends the headline factory client with `predictAirdropAddress`. Use
  * this subpath when you genuinely need to compute a clone address before
  * deploying — historical recovery, deterministic same-tx flows. For the
  * common "deploy and learn the address" case, the headline factory's
- * `createConfidentialAirdrop` returns `{ hash, airdrop }` directly (R02 ADR P-1).
+ * `createConfidentialAirdrop` returns `{ hash, airdrop }` directly.
  */
 export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient, } from "./factory-advanced.js";
 export type { PredictAirdropArgs } from "../factory.js";

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

@@ -1,7 +1,7 @@
-export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient } from '../../chunk-ZHFLRKFY.js';
-import '../../chunk-UOG4PJL5.js';
+export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient } from '../../chunk-JJ4R5QXF.js';
+import '../../chunk-OQZAZIAS.js';
 import '../../chunk-JFLEEXKP.js';
-import '../../chunk-COPFW5Z4.js';
+import '../../chunk-M7V2EDPB.js';
 import '../../chunk-BE2AIZ3K.js';
 import '../../chunk-Q2GP5UDC.js';
 import '../../chunk-KWFFIJYX.js';

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

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkK6MFFDBJ_cjs = require('../../../chunk-K6MFFDBJ.cjs');
+var chunkG7G75C46_cjs = require('../../../chunk-G7G75C46.cjs');
 require('../../../chunk-5SA2HF2W.cjs');
-var chunkT5LVV3KY_cjs = require('../../../chunk-T5LVV3KY.cjs');
-var chunk6ECAHP5O_cjs = require('../../../chunk-6ECAHP5O.cjs');
+var chunkFPQBFIUW_cjs = require('../../../chunk-FPQBFIUW.cjs');
+var chunkSYHXDHWX_cjs = require('../../../chunk-SYHXDHWX.cjs');
 require('../../../chunk-Q7ARQSUH.cjs');
 require('../../../chunk-VDXVNZCO.cjs');
-var chunkOLDGMKW2_cjs = require('../../../chunk-OLDGMKW2.cjs');
+var chunk3ZRHDTEX_cjs = require('../../../chunk-3ZRHDTEX.cjs');
 require('../../../chunk-CQIPRNS7.cjs');
 require('../../../chunk-VJKZWYYJ.cjs');
 require('../../../chunk-66IHPTOK.cjs');
@@ -23,22 +23,22 @@ function usePredictAirdropAddress(args = {}) {
     ...chainId !== void 0 ? { chainId } : {}
   });
   const resolvedChainId = chainId ?? resolvedPublicClient?.chain?.id;
-  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : chunkOLDGMKW2_cjs.DEPLOYED_ADDRESSES.fheAirdrop?.confidentialAirdropFactory?.[resolvedChainId] ?? void 0);
+  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : chunk3ZRHDTEX_cjs.DEPLOYED_ADDRESSES.fheAirdrop?.confidentialAirdropFactory?.[resolvedChainId] ?? void 0);
   const encryptorSourceRef = react.useRef(encryptor);
   encryptorSourceRef.current = encryptor;
   const client = react.useMemo(() => {
     if (!resolvedPublicClient) return void 0;
     if (!resolvedAddress) return void 0;
-    return chunkT5LVV3KY_cjs.createConfidentialAirdropFactoryAdvancedClient({
+    return chunkFPQBFIUW_cjs.createConfidentialAirdropFactoryAdvancedClient({
       publicClient: resolvedPublicClient,
       ...walletClient ? { walletClient } : {},
       address: resolvedAddress,
       ...resolvedChainId !== void 0 ? { chainId: resolvedChainId } : {},
-      encryptor: () => chunk6ECAHP5O_cjs.resolveEncryptor(encryptorSourceRef.current)
+      encryptor: () => chunkSYHXDHWX_cjs.resolveEncryptor(encryptorSourceRef.current)
     });
   }, [resolvedPublicClient, walletClient, resolvedAddress, resolvedChainId]);
   return reactQuery.useQuery({
-    queryKey: chunkK6MFFDBJ_cjs.buildQueryKey(
+    queryKey: chunkG7G75C46_cjs.buildQueryKey(
       "factory:predictAirdropAddress",
       resolvedChainId,
       resolvedAddress,

package/dist/fhe-airdrop/advanced/react/index.d.cts

@@ -1,5 +1,5 @@
 /**
  * React hooks for `@tokenops/sdk/fhe-airdrop/advanced`. The headline React
- * subpath stays lean; pre-mine address prediction lives here per R02 ADR P-2.
+ * subpath stays lean; pre-mine address prediction lives here.
  */
 export { usePredictAirdropAddress, type UsePredictAirdropAddressArgs, } from "./usePredictAirdropAddress.js";

package/dist/fhe-airdrop/advanced/react/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * React hooks for `@tokenops/sdk/fhe-airdrop/advanced`. The headline React
- * subpath stays lean; pre-mine address prediction lives here per R02 ADR P-2.
+ * subpath stays lean; pre-mine address prediction lives here.
  */
 export { usePredictAirdropAddress, type UsePredictAirdropAddressArgs, } from "./usePredictAirdropAddress.js";

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

@@ -1,10 +1,10 @@
-import { buildQueryKey } from '../../../chunk-HGXNRR25.js';
+import { buildQueryKey } from '../../../chunk-XWDVPV42.js';
 import '../../../chunk-XXXDQSHE.js';
-import { createConfidentialAirdropFactoryAdvancedClient } from '../../../chunk-ZHFLRKFY.js';
-import { resolveEncryptor } from '../../../chunk-UOG4PJL5.js';
+import { createConfidentialAirdropFactoryAdvancedClient } from '../../../chunk-JJ4R5QXF.js';
+import { resolveEncryptor } from '../../../chunk-OQZAZIAS.js';
 import '../../../chunk-FYQ2UW4T.js';
 import '../../../chunk-JFLEEXKP.js';
-import { DEPLOYED_ADDRESSES } from '../../../chunk-COPFW5Z4.js';
+import { DEPLOYED_ADDRESSES } from '../../../chunk-M7V2EDPB.js';
 import '../../../chunk-BE2AIZ3K.js';
 import '../../../chunk-Q2GP5UDC.js';
 import '../../../chunk-KWFFIJYX.js';

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

@@ -106,7 +106,7 @@ export type FundAirdropArgs = (FundAirdropArgsCommon & {
  * and {@link ConfidentialAirdropFactoryClient.createAndFundConfidentialAirdrop}.
  *
  * Branded `hash: TxHash` and `airdrop: Address` so consumers can't accidentally
- * swap them at the destructure site (R03 S-1 anti-footgun).
+ * swap them at the destructure site.
  */
 export interface CreateAirdropResult {
     /** Tx hash that deployed the clone. */
@@ -146,11 +146,10 @@ export declare class ConfidentialAirdropFactoryClient {
      * 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" })`.
@@ -175,7 +174,7 @@ export declare class ConfidentialAirdropFactoryClient {
      *
      * 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({
@@ -243,9 +242,8 @@ export declare class ConfidentialAirdropFactoryClient {
      * 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/fhe-airdrop/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
 var chunk5SA2HF2W_cjs = require('../chunk-5SA2HF2W.cjs');
-var chunk6ECAHP5O_cjs = require('../chunk-6ECAHP5O.cjs');
+var chunkSYHXDHWX_cjs = require('../chunk-SYHXDHWX.cjs');
 var chunkFWHYQZ5E_cjs = require('../chunk-FWHYQZ5E.cjs');
 require('../chunk-Q7ARQSUH.cjs');
 require('../chunk-VDXVNZCO.cjs');
-require('../chunk-OLDGMKW2.cjs');
+require('../chunk-3ZRHDTEX.cjs');
 require('../chunk-CQIPRNS7.cjs');
 require('../chunk-VJKZWYYJ.cjs');
 var chunk66IHPTOK_cjs = require('../chunk-66IHPTOK.cjs');
@@ -39,31 +39,31 @@ Object.defineProperty(exports, "createConfidentialAirdropClient", {
 });
 Object.defineProperty(exports, "ConfidentialAirdropFactoryClient", {
   enumerable: true,
-  get: function () { return chunk6ECAHP5O_cjs.ConfidentialAirdropFactoryClient; }
+  get: function () { return chunkSYHXDHWX_cjs.ConfidentialAirdropFactoryClient; }
 });
 Object.defineProperty(exports, "confidentialAirdropFactoryAbi", {
   enumerable: true,
-  get: function () { return chunk6ECAHP5O_cjs.confidentialAirdropFactoryAbi; }
+  get: function () { return chunkSYHXDHWX_cjs.confidentialAirdropFactoryAbi; }
 });
 Object.defineProperty(exports, "createConfidentialAirdropFactoryClient", {
   enumerable: true,
-  get: function () { return chunk6ECAHP5O_cjs.createConfidentialAirdropFactoryClient; }
+  get: function () { return chunkSYHXDHWX_cjs.createConfidentialAirdropFactoryClient; }
 });
 Object.defineProperty(exports, "encryptUint64", {
   enumerable: true,
-  get: function () { return chunk6ECAHP5O_cjs.encryptUint64; }
+  get: function () { return chunkSYHXDHWX_cjs.encryptUint64; }
 });
 Object.defineProperty(exports, "encryptUint64Batch", {
   enumerable: true,
-  get: function () { return chunk6ECAHP5O_cjs.encryptUint64Batch; }
+  get: function () { return chunkSYHXDHWX_cjs.encryptUint64Batch; }
 });
 Object.defineProperty(exports, "resolveEncryptor", {
   enumerable: true,
-  get: function () { return chunk6ECAHP5O_cjs.resolveEncryptor; }
+  get: function () { return chunkSYHXDHWX_cjs.resolveEncryptor; }
 });
 Object.defineProperty(exports, "signClaimAuthorization", {
   enumerable: true,
-  get: function () { return chunk6ECAHP5O_cjs.signClaimAuthorization; }
+  get: function () { return chunkSYHXDHWX_cjs.signClaimAuthorization; }
 });
 Object.defineProperty(exports, "erc7984OperatorAbi", {
   enumerable: true,

package/dist/fhe-airdrop/index.js

@@ -1,9 +1,9 @@
 export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError, ConfidentialAirdropClient, confidentialAirdropCloneableAbi, createConfidentialAirdropClient } from '../chunk-XXXDQSHE.js';
-export { ConfidentialAirdropFactoryClient, confidentialAirdropFactoryAbi, createConfidentialAirdropFactoryClient, encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization } from '../chunk-UOG4PJL5.js';
+export { ConfidentialAirdropFactoryClient, confidentialAirdropFactoryAbi, createConfidentialAirdropFactoryClient, encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization } from '../chunk-OQZAZIAS.js';
 export { erc7984OperatorAbi } from '../chunk-7VELUOMI.js';
 import '../chunk-FYQ2UW4T.js';
 import '../chunk-JFLEEXKP.js';
-import '../chunk-COPFW5Z4.js';
+import '../chunk-M7V2EDPB.js';
 import '../chunk-BE2AIZ3K.js';
 import '../chunk-Q2GP5UDC.js';
 export { asAirdropId, asEncryptedHandle } from '../chunk-KWFFIJYX.js';