@tokenops/sdk 1.6.0 → 2.0.0-alpha.1

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

@@ -1,21 +1,20 @@
 'use strict';
 
-var chunkOL6SHN3D_cjs = require('../../chunk-OL6SHN3D.cjs');
-require('../../chunk-LBWRFZR3.cjs');
-require('../../chunk-FWHYQZ5E.cjs');
-require('../../chunk-43RFBQ73.cjs');
-require('../../chunk-WUXUWTFW.cjs');
-require('../../chunk-VR3FREBX.cjs');
-require('../../chunk-2RNW4MIJ.cjs');
-require('../../chunk-VJKZWYYJ.cjs');
+var chunkM4IT6DNJ_cjs = require('../../chunk-M4IT6DNJ.cjs');
+require('../../chunk-MVDQMV25.cjs');
+require('../../chunk-67OV5CX2.cjs');
 
 
 
-Object.defineProperty(exports, "ConfidentialAirdropFactoryAdvancedClient", {
+Object.defineProperty(exports, "DEPLOYMENT_MODE", {
   enumerable: true,
-  get: function () { return chunkOL6SHN3D_cjs.ConfidentialAirdropFactoryAdvancedClient; }
+  get: function () { return chunkM4IT6DNJ_cjs.DEPLOYMENT_MODE; }
 });
-Object.defineProperty(exports, "createConfidentialAirdropFactoryAdvancedClient", {
+Object.defineProperty(exports, "assertPredictionFresh", {
   enumerable: true,
-  get: function () { return chunkOL6SHN3D_cjs.createConfidentialAirdropFactoryAdvancedClient; }
+  get: function () { return chunkM4IT6DNJ_cjs.assertPredictionFresh; }
+});
+Object.defineProperty(exports, "assertSaltAvailable", {
+  enumerable: true,
+  get: function () { return chunkM4IT6DNJ_cjs.assertSaltAvailable; }
 });

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

@@ -1,13 +1,36 @@
 /**
- * Advanced FHE-airdrop primitives — power-user surface kept off the headline
- * 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.
+ * `@tokenops/sdk/fhe-airdrop/advanced` - CREATE2 address prediction and the
+ * two guards that keep a prediction trustworthy.
+ *
+ * The headline subpath already runs both guards inside `createEcdsaAirdrop` /
+ * `createMerkleAirdrop`, and `preflightCreate` reports them read-only. This
+ * subpath is for callers driving prediction themselves: precomputing a
+ * campaign address to publish, binding Merkle ciphertexts to an instance that
+ * does not exist yet, or reconciling addresses across a deploy pipeline.
+ *
+ * **What a prediction commits to.** `(implementation, mode, deployer,
+ * userSalt)` and nothing else. The oracles take the params struct and ignore
+ * it - `predictECDSAAirdropAddress` does not even name that argument - so two
+ * campaigns differing in token, window, signer or root still land on one
+ * address. That makes `userSalt` the only thing separating them, and
+ * {@link assertSaltAvailable} the check that catches a reused one before the
+ * create is sent.
+ *
+ * **What can invalidate one.** The factory's implementation pointer. It moves
+ * under `IMPL_MANAGER_ROLE`, changes the init-code hash, and so changes every
+ * future predicted address. {@link assertPredictionFresh} judges the two
+ * `get*InitCodeHash` observations taken on either side of whatever work the
+ * prediction was used for.
+ *
+ * The prediction reads themselves (`predictEcdsaAirdropAddress`,
+ * `predictMerkleAirdropAddress`, `getEcdsaInitCodeHash`,
+ * `getMerkleInitCodeHash`) are methods on `ConfidentialAirdropFactoryClient`,
+ * exported from the headline `@tokenops/sdk/fhe-airdrop` subpath; their
+ * argument types are re-exported below so this subpath is self-contained.
  */
-export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient, } from "./factory-advanced.js";
-export type { PredictAirdropArgs } from "../factory.js";
+export type { InitCodeHashArgs, PredictArgs } from "../factory.js";
+/** @alpha */
+export { DEPLOYMENT_MODE } from "../constants.js";
+export type { DeploymentMode } from "../constants.js";
+export { assertPredictionFresh, assertSaltAvailable, type AssertPredictionFreshArgs, type AssertSaltAvailableArgs, } from "../guards.js";
+export type { AirdropVariant } from "../errors.js";

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

@@ -1,13 +1,36 @@
 /**
- * Advanced FHE-airdrop primitives — power-user surface kept off the headline
- * 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.
+ * `@tokenops/sdk/fhe-airdrop/advanced` - CREATE2 address prediction and the
+ * two guards that keep a prediction trustworthy.
+ *
+ * The headline subpath already runs both guards inside `createEcdsaAirdrop` /
+ * `createMerkleAirdrop`, and `preflightCreate` reports them read-only. This
+ * subpath is for callers driving prediction themselves: precomputing a
+ * campaign address to publish, binding Merkle ciphertexts to an instance that
+ * does not exist yet, or reconciling addresses across a deploy pipeline.
+ *
+ * **What a prediction commits to.** `(implementation, mode, deployer,
+ * userSalt)` and nothing else. The oracles take the params struct and ignore
+ * it - `predictECDSAAirdropAddress` does not even name that argument - so two
+ * campaigns differing in token, window, signer or root still land on one
+ * address. That makes `userSalt` the only thing separating them, and
+ * {@link assertSaltAvailable} the check that catches a reused one before the
+ * create is sent.
+ *
+ * **What can invalidate one.** The factory's implementation pointer. It moves
+ * under `IMPL_MANAGER_ROLE`, changes the init-code hash, and so changes every
+ * future predicted address. {@link assertPredictionFresh} judges the two
+ * `get*InitCodeHash` observations taken on either side of whatever work the
+ * prediction was used for.
+ *
+ * The prediction reads themselves (`predictEcdsaAirdropAddress`,
+ * `predictMerkleAirdropAddress`, `getEcdsaInitCodeHash`,
+ * `getMerkleInitCodeHash`) are methods on `ConfidentialAirdropFactoryClient`,
+ * exported from the headline `@tokenops/sdk/fhe-airdrop` subpath; their
+ * argument types are re-exported below so this subpath is self-contained.
  */
-export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient, } from "./factory-advanced.js";
-export type { PredictAirdropArgs } from "../factory.js";
+export type { InitCodeHashArgs, PredictArgs } from "../factory.js";
+/** @alpha */
+export { DEPLOYMENT_MODE } from "../constants.js";
+export type { DeploymentMode } from "../constants.js";
+export { assertPredictionFresh, assertSaltAvailable, type AssertPredictionFreshArgs, type AssertSaltAvailableArgs, } from "../guards.js";
+export type { AirdropVariant } from "../errors.js";

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

@@ -1,8 +1,3 @@
-export { ConfidentialAirdropFactoryAdvancedClient, createConfidentialAirdropFactoryAdvancedClient } from '../../chunk-KSDSXJ34.js';
-import '../../chunk-UE5XK2SY.js';
-import '../../chunk-7VELUOMI.js';
-import '../../chunk-6WSNS3UV.js';
-import '../../chunk-QKKBBH7I.js';
-import '../../chunk-46T67CE2.js';
-import '../../chunk-DRSPMIZ7.js';
-import '../../chunk-Q2GP5UDC.js';
+export { DEPLOYMENT_MODE, assertPredictionFresh, assertSaltAvailable } from '../../chunk-O5676ZWY.js';
+import '../../chunk-4RAAATVY.js';
+import '../../chunk-QBJ7O2B4.js';

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

@@ -1,61 +1,48 @@
 'use strict';
 
-var chunkWO72UBQD_cjs = require('../../../chunk-WO72UBQD.cjs');
-require('../../../chunk-SPGSO5SO.cjs');
-var chunkOL6SHN3D_cjs = require('../../../chunk-OL6SHN3D.cjs');
-var chunkLBWRFZR3_cjs = require('../../../chunk-LBWRFZR3.cjs');
-require('../../../chunk-SYHNZSZZ.cjs');
-require('../../../chunk-FWHYQZ5E.cjs');
-require('../../../chunk-43RFBQ73.cjs');
-var chunkWUXUWTFW_cjs = require('../../../chunk-WUXUWTFW.cjs');
-require('../../../chunk-VR3FREBX.cjs');
-require('../../../chunk-2RNW4MIJ.cjs');
+var chunkNCVX3K2N_cjs = require('../../../chunk-NCVX3K2N.cjs');
+require('../../../chunk-PUX5VXDB.cjs');
+require('../../../chunk-M4IT6DNJ.cjs');
+require('../../../chunk-FAXIIH5R.cjs');
+require('../../../chunk-UG5RKLU2.cjs');
+require('../../../chunk-MVDQMV25.cjs');
+require('../../../chunk-5576FRT3.cjs');
+require('../../../chunk-JK4XMMKM.cjs');
+require('../../../chunk-66IHPTOK.cjs');
+require('../../../chunk-67OV5CX2.cjs');
 require('../../../chunk-VJKZWYYJ.cjs');
-var react = require('react');
 var reactQuery = require('@tanstack/react-query');
-var wagmi = require('wagmi');
 
-function usePredictAirdropAddress(args = {}) {
-  const { params, userSalt, deployer, gasFee, address, chainId, publicClient, encryptor } = args;
-  const wagmiPublicClient = wagmi.usePublicClient({ ...chainId !== void 0 ? { chainId } : {} });
-  const resolvedPublicClient = publicClient ?? wagmiPublicClient;
-  const { data: walletClient } = wagmi.useWalletClient({
-    ...chainId !== void 0 ? { chainId } : {}
-  });
-  const resolvedChainId = chainId ?? resolvedPublicClient?.chain?.id;
-  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : chunkWUXUWTFW_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 chunkOL6SHN3D_cjs.createConfidentialAirdropFactoryAdvancedClient({
-      publicClient: resolvedPublicClient,
-      ...walletClient ? { walletClient } : {},
+function usePredictEcdsaAirdropAddress(args) {
+  const { params, mode, deployer, userSalt, ...base } = args;
+  const { client, chainId, resolvedAddress } = chunkNCVX3K2N_cjs.useMemoAirdropFactoryClient(base);
+  return reactQuery.useQuery({
+    ...args.query,
+    queryKey: chunkNCVX3K2N_cjs.airdropQueryKey({
+      chainId,
       address: resolvedAddress,
-      ...resolvedChainId !== void 0 ? { chainId: resolvedChainId } : {},
-      encryptor: () => chunkLBWRFZR3_cjs.resolveEncryptor(encryptorSourceRef.current)
-    });
-  }, [resolvedPublicClient, walletClient, resolvedAddress, resolvedChainId]);
+      fn: "predictEcdsaAirdropAddress",
+      args: [mode, deployer, userSalt]
+    }),
+    queryFn: () => client.predictEcdsaAirdropAddress({ params, mode, deployer, userSalt }),
+    enabled: Boolean(client && (args.query?.enabled ?? true))
+  });
+}
+function usePredictMerkleAirdropAddress(args) {
+  const { params, mode, deployer, userSalt, ...base } = args;
+  const { client, chainId, resolvedAddress } = chunkNCVX3K2N_cjs.useMemoAirdropFactoryClient(base);
   return reactQuery.useQuery({
-    queryKey: chunkWO72UBQD_cjs.buildQueryKey(
-      "factory:predictAirdropAddress",
-      resolvedChainId,
-      resolvedAddress,
-      params,
-      userSalt,
-      deployer,
-      gasFee
-    ),
-    queryFn: () => client.predictAirdropAddress({
-      params,
-      userSalt,
-      deployer,
-      gasFee
+    ...args.query,
+    queryKey: chunkNCVX3K2N_cjs.airdropQueryKey({
+      chainId,
+      address: resolvedAddress,
+      fn: "predictMerkleAirdropAddress",
+      args: [mode, deployer, userSalt]
     }),
-    enabled: !!client && !!params && !!userSalt && !!deployer && gasFee !== void 0,
-    staleTime: 0
+    queryFn: () => client.predictMerkleAirdropAddress({ params, mode, deployer, userSalt }),
+    enabled: Boolean(client && (args.query?.enabled ?? true))
   });
 }
 
-exports.usePredictAirdropAddress = usePredictAirdropAddress;
+exports.usePredictEcdsaAirdropAddress = usePredictEcdsaAirdropAddress;
+exports.usePredictMerkleAirdropAddress = usePredictMerkleAirdropAddress;

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

@@ -1,5 +1,11 @@
 /**
- * React hooks for `@tokenops/sdk/fhe-airdrop/advanced`. The headline React
- * subpath stays lean; pre-mine address prediction lives here.
+ * React hooks for `@tokenops/sdk/fhe-airdrop/advanced`.
+ *
+ * Unlike `/fhe-vesting/advanced/react` (which needs a separate
+ * block-dependent `*AdvancedClient` subclass), the airdrop v2 factory already
+ * exposes `predictEcdsaAirdropAddress` / `predictMerkleAirdropAddress` on its
+ * headline `ConfidentialAirdropFactoryClient` — so these hooks reuse the
+ * headline React subpath's factory-client memoization directly.
  */
-export { usePredictAirdropAddress, type UsePredictAirdropAddressArgs, } from "./usePredictAirdropAddress.js";
+export { usePredictEcdsaAirdropAddress, type UsePredictEcdsaAirdropAddressArgs, } from "./usePredictEcdsaAirdropAddress.js";
+export { usePredictMerkleAirdropAddress, type UsePredictMerkleAirdropAddressArgs, } from "./usePredictMerkleAirdropAddress.js";

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

@@ -1,5 +1,11 @@
 /**
- * React hooks for `@tokenops/sdk/fhe-airdrop/advanced`. The headline React
- * subpath stays lean; pre-mine address prediction lives here.
+ * React hooks for `@tokenops/sdk/fhe-airdrop/advanced`.
+ *
+ * Unlike `/fhe-vesting/advanced/react` (which needs a separate
+ * block-dependent `*AdvancedClient` subclass), the airdrop v2 factory already
+ * exposes `predictEcdsaAirdropAddress` / `predictMerkleAirdropAddress` on its
+ * headline `ConfidentialAirdropFactoryClient` — so these hooks reuse the
+ * headline React subpath's factory-client memoization directly.
  */
-export { usePredictAirdropAddress, type UsePredictAirdropAddressArgs, } from "./usePredictAirdropAddress.js";
+export { usePredictEcdsaAirdropAddress, type UsePredictEcdsaAirdropAddressArgs, } from "./usePredictEcdsaAirdropAddress.js";
+export { usePredictMerkleAirdropAddress, type UsePredictMerkleAirdropAddressArgs, } from "./usePredictMerkleAirdropAddress.js";

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

@@ -1,59 +1,45 @@
-import { buildQueryKey } from '../../../chunk-CNP4L3GF.js';
-import '../../../chunk-S2XD75JM.js';
-import { createConfidentialAirdropFactoryAdvancedClient } from '../../../chunk-KSDSXJ34.js';
-import { resolveEncryptor } from '../../../chunk-UE5XK2SY.js';
-import '../../../chunk-YPYCWLYP.js';
-import '../../../chunk-7VELUOMI.js';
-import '../../../chunk-6WSNS3UV.js';
-import { DEPLOYED_ADDRESSES } from '../../../chunk-QKKBBH7I.js';
-import '../../../chunk-46T67CE2.js';
-import '../../../chunk-DRSPMIZ7.js';
+import { useMemoAirdropFactoryClient, airdropQueryKey } from '../../../chunk-VP2B4WM2.js';
+import '../../../chunk-GKKDAW44.js';
+import '../../../chunk-O5676ZWY.js';
+import '../../../chunk-ZWXJTBZO.js';
+import '../../../chunk-NWFMBLSQ.js';
+import '../../../chunk-4RAAATVY.js';
+import '../../../chunk-DZHYSUGY.js';
+import '../../../chunk-ZA673I3O.js';
+import '../../../chunk-KWFFIJYX.js';
+import '../../../chunk-QBJ7O2B4.js';
 import '../../../chunk-Q2GP5UDC.js';
-import { useRef, useMemo } from 'react';
 import { useQuery } from '@tanstack/react-query';
-import { usePublicClient, useWalletClient } from 'wagmi';
 
-function usePredictAirdropAddress(args = {}) {
-  const { params, userSalt, deployer, gasFee, address, chainId, publicClient, encryptor } = args;
-  const wagmiPublicClient = usePublicClient({ ...chainId !== void 0 ? { chainId } : {} });
-  const resolvedPublicClient = publicClient ?? wagmiPublicClient;
-  const { data: walletClient } = useWalletClient({
-    ...chainId !== void 0 ? { chainId } : {}
-  });
-  const resolvedChainId = chainId ?? resolvedPublicClient?.chain?.id;
-  const resolvedAddress = address ?? (resolvedChainId === void 0 ? void 0 : DEPLOYED_ADDRESSES.fheAirdrop?.confidentialAirdropFactory?.[resolvedChainId] ?? void 0);
-  const encryptorSourceRef = useRef(encryptor);
-  encryptorSourceRef.current = encryptor;
-  const client = useMemo(() => {
-    if (!resolvedPublicClient) return void 0;
-    if (!resolvedAddress) return void 0;
-    return createConfidentialAirdropFactoryAdvancedClient({
-      publicClient: resolvedPublicClient,
-      ...walletClient ? { walletClient } : {},
+function usePredictEcdsaAirdropAddress(args) {
+  const { params, mode, deployer, userSalt, ...base } = args;
+  const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
+  return useQuery({
+    ...args.query,
+    queryKey: airdropQueryKey({
+      chainId,
       address: resolvedAddress,
-      ...resolvedChainId !== void 0 ? { chainId: resolvedChainId } : {},
-      encryptor: () => resolveEncryptor(encryptorSourceRef.current)
-    });
-  }, [resolvedPublicClient, walletClient, resolvedAddress, resolvedChainId]);
+      fn: "predictEcdsaAirdropAddress",
+      args: [mode, deployer, userSalt]
+    }),
+    queryFn: () => client.predictEcdsaAirdropAddress({ params, mode, deployer, userSalt }),
+    enabled: Boolean(client && (args.query?.enabled ?? true))
+  });
+}
+function usePredictMerkleAirdropAddress(args) {
+  const { params, mode, deployer, userSalt, ...base } = args;
+  const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
   return useQuery({
-    queryKey: buildQueryKey(
-      "factory:predictAirdropAddress",
-      resolvedChainId,
-      resolvedAddress,
-      params,
-      userSalt,
-      deployer,
-      gasFee
-    ),
-    queryFn: () => client.predictAirdropAddress({
-      params,
-      userSalt,
-      deployer,
-      gasFee
+    ...args.query,
+    queryKey: airdropQueryKey({
+      chainId,
+      address: resolvedAddress,
+      fn: "predictMerkleAirdropAddress",
+      args: [mode, deployer, userSalt]
     }),
-    enabled: !!client && !!params && !!userSalt && !!deployer && gasFee !== void 0,
-    staleTime: 0
+    queryFn: () => client.predictMerkleAirdropAddress({ params, mode, deployer, userSalt }),
+    enabled: Boolean(client && (args.query?.enabled ?? true))
   });
 }
 
-export { usePredictAirdropAddress };
+export { usePredictEcdsaAirdropAddress, usePredictMerkleAirdropAddress };

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

@@ -0,0 +1,33 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { Address, Hex } from "viem";
+import type { DeploymentMode } from "../../constants.js";
+import type { EcdsaAirdropParams } from "../../types.js";
+import { type AirdropHookOptions } from "../../react/_shared.js";
+/** @alpha */
+export interface UsePredictEcdsaAirdropAddressArgs extends AirdropHookOptions<Address> {
+    params: EcdsaAirdropParams;
+    mode: DeploymentMode;
+    deployer: Address;
+    userSalt: Hex;
+}
+/**
+ * Where an ECDSA `create*` from `deployer` with this `(mode, userSalt)` pair
+ * would land.
+ *
+ * **What a prediction commits to.** Only `(implementation, mode, deployer,
+ * userSalt)` — `params` is required because the ABI declares it, but the
+ * factory ignores it for this variant's oracle. Changing the token, window
+ * or signer does NOT move the predicted address.
+ *
+ * A returned address is not evidence the create will succeed — prediction is
+ * a pure oracle that answers even for a deployer not currently allowed to
+ * deploy the requested `mode`.
+ *
+ * @example
+ * const { data: predicted } = usePredictEcdsaAirdropAddress({
+ *   params, mode: "clone", deployer, userSalt,
+ * });
+ *
+ * @alpha
+ */
+export declare function usePredictEcdsaAirdropAddress(args: UsePredictEcdsaAirdropAddressArgs): UseQueryResult<Address, Error>;

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

@@ -0,0 +1,27 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { Address, Hex } from "viem";
+import type { DeploymentMode } from "../../constants.js";
+import type { MerkleAirdropParams } from "../../types.js";
+import { type AirdropHookOptions } from "../../react/_shared.js";
+/** @alpha */
+export interface UsePredictMerkleAirdropAddressArgs extends AirdropHookOptions<Address> {
+    params: MerkleAirdropParams;
+    mode: DeploymentMode;
+    deployer: Address;
+    userSalt: Hex;
+}
+/**
+ * Where a Merkle `create*` from `deployer` with this `(mode, userSalt)` pair
+ * would land.
+ *
+ * Same "only `(implementation, mode, deployer, userSalt)` matters" contract
+ * as {@link usePredictEcdsaAirdropAddress} — see its TSDoc.
+ *
+ * @example
+ * const { data: predicted } = usePredictMerkleAirdropAddress({
+ *   params, mode: "clone", deployer, userSalt,
+ * });
+ *
+ * @alpha
+ */
+export declare function usePredictMerkleAirdropAddress(args: UsePredictMerkleAirdropAddressArgs): UseQueryResult<Address, Error>;