@tokenops/sdk 1.6.0 → 2.0.0-alpha.2

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 chunkAREQJHKA_cjs = require('../../chunk-AREQJHKA.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 chunkAREQJHKA_cjs.DEPLOYMENT_MODE; }
 });
-Object.defineProperty(exports, "createConfidentialAirdropFactoryAdvancedClient", {
+Object.defineProperty(exports, "assertPredictionFresh", {
   enumerable: true,
-  get: function () { return chunkOL6SHN3D_cjs.createConfidentialAirdropFactoryAdvancedClient; }
+  get: function () { return chunkAREQJHKA_cjs.assertPredictionFresh; }
+});
+Object.defineProperty(exports, "assertSaltAvailable", {
+  enumerable: true,
+  get: function () { return chunkAREQJHKA_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-VW356KR3.js';
+import '../../chunk-4RAAATVY.js';
+import '../../chunk-QBJ7O2B4.js';