@tokenops/sdk 2.0.0-alpha.2 → 2.0.0-alpha.4

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

@@ -1,9 +1,9 @@
 import type { Address, Hex, PublicClient } from "viem";
 import type { PreflightResult } from "../core/preflight.js";
-import type { DeploymentMode } from "./constants.js";
+import { type DeploymentMode } from "./constants.js";
 import { type AirdropVariant } from "./errors.js";
 import type { ConfidentialAirdropFactoryClient } from "./factory.js";
-import type { EcdsaAirdropParams, MerkleAirdropParams } from "./types.js";
+import type { CreateCommitments, EcdsaAirdropParams, MerkleAirdropParams, PlannedCampaign } from "./types.js";
 /**
  * Chains the airdrop v2 contracts are reachable on.
  *
@@ -104,6 +104,57 @@ export interface AssertSaltAvailableArgs {
  * @alpha
  */
 export declare function assertSaltAvailable(args: AssertSaltAvailableArgs): Promise<void>;
+/**
+ * The slice of {@link ConfidentialAirdropFactoryClient} the create fee checks
+ * read. Structural so this module keeps its runtime-import-free shape; the real
+ * client satisfies it as-is.
+ *
+ * @alpha
+ */
+export interface GasFeeResolver {
+    address: Address;
+    resolveGasFee(creator: Address): Promise<bigint>;
+}
+/**
+ * Inputs for {@link assertCreateGasFee}.
+ *
+ * @alpha
+ */
+export interface AssertGasFeeAcceptedArgs {
+    factory: GasFeeResolver;
+    /** The account that will send `create*`; fee overrides are per-creator. */
+    creator: Address;
+    /** `CommonAirdropParams.maxAcceptedGasFee`, in wei. */
+    maxAcceptedGasFee: bigint;
+    /** Label for the thrown error. */
+    method: string;
+}
+/**
+ * Both create-time fee checks, in the order the factory's `_create` runs them:
+ * the resolved fee against the factory's own `maxGasFee` ceiling first
+ * (`GasFeeExceedsMaximum`), then against the creator's `maxAcceptedGasFee`
+ * (`GasFeeNotAccepted`). Reporting the bound first would tell a creator to
+ * raise it when the ceiling would refuse the create anyway.
+ *
+ * The contract enforces both. Doing it here buys the reason: the revert
+ * carries the numbers but not which factory knob produced them, and a creator
+ * who sees `resolvedFee` next to their own bound can tell a raised default from
+ * a custom override they did not know they had.
+ *
+ * The range check is not redundant with the comparison - a bound outside
+ * `uint96` silently wraps at the ABI edge and could encode as a SMALLER number
+ * than intended, turning "accept anything" into "accept almost nothing".
+ *
+ * @throws {@link InvalidArgumentError} when `maxAcceptedGasFee` is outside `uint96`, or on `gasFee` when the resolved fee exceeds the ceiling.
+ * @throws {@link GasFeeNotAcceptedError} when the resolved fee is within the ceiling but above the bound.
+ *
+ * @internal
+ */
+export declare function assertCreateGasFee(args: AssertGasFeeAcceptedArgs & {
+    factory: GasFeeResolver & {
+        maxGasFee(): Promise<bigint>;
+    };
+}): Promise<void>;
 /**
  * Inputs for {@link assertPredictionFresh}.
  *
@@ -132,6 +183,38 @@ export interface AssertPredictionFreshArgs {
  * @alpha
  */
 export declare function assertPredictionFresh(args: AssertPredictionFreshArgs): void;
+/**
+ * Inputs for {@link resolvePlannedCreate}.
+ *
+ * @internal
+ */
+export interface ResolvePlannedCreateArgs {
+    /** Label for the thrown error. */
+    method: string;
+    params: MerkleAirdropParams;
+    expected?: Partial<CreateCommitments> | undefined;
+    /** Preflight only; the write path reads the live hash itself. */
+    expectedInitCodeHash?: Hex | undefined;
+    plan?: PlannedCampaign | undefined;
+}
+/**
+ * Fold a {@link PlannedCampaign} into the pins a Merkle create is sent with.
+ *
+ * Without a plan the caller's `expected` and `expectedInitCodeHash` come back
+ * untouched. With one, `expected.airdrop` becomes `plan.predictedAddress` and
+ * the drift check is judged against `plan.initCodeHashAfter`. A caller-supplied
+ * value that disagrees with the plan is refused rather than overridden, so the
+ * plan never silently wins over something the caller wrote down. Static: no RPC.
+ *
+ * @throws {@link InvalidArgumentError} when `params.merkleRoot`, `expected.airdrop`
+ *   or `expectedInitCodeHash` disagrees with the plan.
+ *
+ * @internal
+ */
+export declare function resolvePlannedCreate(args: ResolvePlannedCreateArgs): {
+    expected: Partial<CreateCommitments> | undefined;
+    expectedInitCodeHash: Hex | undefined;
+};
 /** Fields shared by both variants of {@link PreflightCreateArgs}. */
 interface PreflightCreateCommon {
     factory: ConfidentialAirdropFactoryClient;
@@ -140,11 +223,35 @@ interface PreflightCreateCommon {
     creator: Address;
     userSalt: Hex;
     /**
-     * The variant's init-code hash observed when the address was predicted -
-     * e.g. `PlannedCampaign.initCodeHashAfter`. Supplying it turns on the
-     * drift check; omitting it skips that one check only.
+     * The variant's init-code hash observed when the address was predicted.
+     * Supplying it turns on the drift check; omitting it skips that one check
+     * only. A Merkle `plan` supplies `plan.initCodeHashAfter` for you.
      */
     expectedInitCodeHash?: Hex | undefined;
+    /**
+     * Commitments to pin instead of quoting fresh at send time. Anything omitted is read
+     * from the factory just before the transaction. For a {@link PlannedCampaign}, pass
+     * `plan` on the Merkle arm instead; `{ airdrop: plan.predictedAddress }` here is the
+     * lower-level equivalent of its pin.
+     *
+     * The preflight compares each pinned field with the factory's fresh quote and reports a
+     * `CreateCommitmentMismatchError` blocker (with that `field`) when they differ, since the
+     * factory would revert the create on it.
+     */
+    expected?: Partial<CreateCommitments> | undefined;
+}
+/** @alpha */
+export interface PreflightCreateResult extends PreflightResult {
+    /**
+     * The commitments the create would be sent with - the fresh quote with any pinned
+     * `expected` field taking precedence - what an app shows the creator and compares with a
+     * published record. A pinned field that differs from the fresh quote is reported here as
+     * pinned and also as a `CreateCommitmentMismatchError` blocker. Absent when a read
+     * producing the quote failed: with nothing pinned no blocker is added, and with a pin
+     * the failure is a blocker (a typed SDK error) or is rethrown (anything else), so the
+     * mismatch check is never skipped silently.
+     */
+    commitments?: CreateCommitments;
 }
 /**
  * Inputs for {@link preflightCreate}.
@@ -157,32 +264,49 @@ export type PreflightCreateArgs = PreflightCreateCommon & ({
 } | {
     variant: "merkle";
     params: MerkleAirdropParams;
+    /**
+     * The {@link PlannedCampaign} the create will realise. Pins
+     * `expected.airdrop` to `plan.predictedAddress` and turns the drift check
+     * on against `plan.initCodeHashAfter`. A `params.merkleRoot`,
+     * `expected.airdrop` or `expectedInitCodeHash` that disagrees with the
+     * plan is reported as an `InvalidArgumentError` blocker.
+     */
+    plan?: PlannedCampaign | undefined;
 });
 /**
  * Run every create-time guardrail read-only and report what would block the
  * transaction, instead of throwing on the first problem.
  *
  * Same checks and the same typed errors the write path enforces: chain
- * support, the Merkle/UUPS refusal, the creator's effective
+ * support, the Merkle/UUPS refusal, params the instance initializer would
+ * revert on (a zero token, an `endTime` less than a minute away, a window
+ * that does not open before it closes, a zero immutable Merkle root, a zero
+ * ECDSA signer; `InvalidArgumentError` naming the field), the creator's resolved gas fee against
+ * `common.maxAcceptedGasFee` and against the factory's `maxGasFee` ceiling
+ * (an `InvalidArgumentError` on `gasFee`, the same error the create's
+ * `GasFeeExceedsMaximum` revert maps to), the creator's effective
  * upgradeability policy when `mode: "uups"` is requested, the stock-wrapper
  * probe when `unwrappable` is set, a salt collision on the predicted
- * address, and - when `expectedInitCodeHash` is supplied - implementation
- * drift since the prediction was taken.
+ * address (the pinned `expected.airdrop` when given), a pinned commitment
+ * that no longer matches the factory's fresh quote, and - when
+ * `expectedInitCodeHash` or a Merkle `plan` is supplied - implementation
+ * drift since the prediction was taken. A `plan` that disagrees with
+ * `params.merkleRoot`, `expected.airdrop` or `expectedInitCodeHash` is an
+ * `InvalidArgumentError` blocker.
  *
- * @returns `{ ready, blockers }`. `blockers` carries the errors `create*`
- *   would have thrown, so a UI can branch on `error.code` exactly as it does
- *   in `onError`.
+ * @returns `{ ready, blockers, commitments }`. `blockers` carries the errors
+ *   `create*` would have thrown, so a UI can branch on `error.code` exactly as
+ *   it does in `onError`; `commitments` is what the create would be sent with.
  *
  * @example
  * const { ready, blockers } = await preflightCreate({
- *   factory, variant: "merkle", params, mode: "clone", creator, userSalt,
- *   expectedInitCodeHash: plan.initCodeHashAfter,
+ *   factory, variant: "merkle", params, mode: "clone", creator, userSalt, plan,
  * });
  * if (!ready) return blockers.map((b) => b.code);
  *
  * @alpha
  */
-export declare function preflightCreate(args: PreflightCreateArgs): Promise<PreflightResult>;
+export declare function preflightCreate(args: PreflightCreateArgs): Promise<PreflightCreateResult>;
 /**
  * The subset of an instance client {@link preflightClaim} reads.
  *
@@ -222,6 +346,40 @@ export interface ClaimPreflightTarget {
         signature: Hex;
     }) => Promise<boolean>;
 }
+/**
+ * The slice of {@link ConfidentialAirdropFactoryClient} the genuineness check reads.
+ *
+ * @alpha
+ */
+export interface AirdropRegistry {
+    readonly address: Address;
+    /**
+     * The chain this factory is bound to. Checked against the instance's own
+     * `chainId` before the registry is consulted - a registry answer from the
+     * wrong chain is worse than no answer, because it reads as a `true`.
+     */
+    readonly chainId: number;
+    isAirdrop(candidate: Address): Promise<boolean>;
+}
+/**
+ * Refuse an instance the canonical factory's registry does not contain.
+ *
+ * The factory has to be one the caller already trusts - taken from
+ * `src/core/addresses.ts`, not read off the instance. An instance that names
+ * its own factory proves nothing: a fake instance names a fake factory, which
+ * answers `true`.
+ *
+ * @throws {@link UnrecognisedAirdropError} when the registry does not contain `airdrop`.
+ *
+ * @alpha
+ */
+export declare function assertKnownAirdrop(args: {
+    factory: AirdropRegistry;
+    airdrop: Address;
+    /** The chain the instance being vetted lives on. */
+    chainId: number;
+    method: string;
+}): Promise<void>;
 /**
  * The signature material {@link preflightClaim} needs to check an ECDSA claim.
  *
@@ -265,25 +423,31 @@ export interface PreflightClaimArgs {
      * `isSignatureValid`, it adds the authorisation check to the report.
      */
     signature?: EcdsaClaimPreflightSignature | undefined;
+    /**
+     * The canonical factory, from `src/core/addresses.ts`. Supplying it adds the
+     * genuineness check (audit-10): every other blocker here describes a claim
+     * that will fail, but a claim against a look-alike instance SUCCEEDS and
+     * delivers nothing. Omitting it skips that one check.
+     */
+    factory?: AirdropRegistry | undefined;
 }
 /**
  * The three argument-relation rules the Merkle claim path enforces before it touches the
- * coprocessor. All are decidable from the arguments alone, so both `preflightClaim` and
- * the client's own write path run them — no RPC, no chance of a wasted fee.
+ * coprocessor: non-zero account, `claimAndUnwrap` is self-only, and only the account itself
+ * may redirect payout. All are decidable from the arguments alone, so both `preflightClaim`
+ * and the client's own write path run them - no RPC, no chance of a wasted fee.
  *
  * @param account The claim identity (`claim`'s leading argument).
  * @param submitter The address that will send the transaction.
- * @param boundTo The address the entry's input proof is bound to, when known.
  * @param to The payout destination, if one will be passed.
  * @param entrypoint `claimAndUnwrap` is self-only; `claim` accepts a third-party submitter.
- * @throws {@link InvalidArgumentError} on a zero `account`, a proof bound to another address, or a relayed `claimAndUnwrap`.
+ * @throws {@link InvalidArgumentError} on a zero `account` or a third-party `claimAndUnwrap`.
  * @throws {@link UnauthorizedRedirectError} when a third party tries to redirect payout.
  */
 export declare function assertMerkleClaimIdentity(args: {
     method: string;
     account: Address;
     submitter: Address;
-    boundTo?: Address | undefined;
     to?: Address | undefined;
     entrypoint?: "claim" | "claimAndUnwrap" | undefined;
 }): void;

package/dist/fhe-airdrop/index.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
-var chunkIUKKNJ2R_cjs = require('../chunk-IUKKNJ2R.cjs');
-var chunkPZZK3O3S_cjs = require('../chunk-PZZK3O3S.cjs');
-var chunkAREQJHKA_cjs = require('../chunk-AREQJHKA.cjs');
+var chunkDFK5GCJP_cjs = require('../chunk-DFK5GCJP.cjs');
+var chunkE4IV4M4E_cjs = require('../chunk-E4IV4M4E.cjs');
+var chunkVHKMWWBA_cjs = require('../chunk-VHKMWWBA.cjs');
 var chunkKFRDLKMA_cjs = require('../chunk-KFRDLKMA.cjs');
 require('../chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('../chunk-FWHYQZ5E.cjs');
-require('../chunk-UG5RKLU2.cjs');
+require('../chunk-SUYBAF27.cjs');
 require('../chunk-MVDQMV25.cjs');
-require('../chunk-FT5H2Q7Y.cjs');
+require('../chunk-YAL6JSAZ.cjs');
 require('../chunk-JK4XMMKM.cjs');
 require('../chunk-66IHPTOK.cjs');
 var chunk67OV5CX2_cjs = require('../chunk-67OV5CX2.cjs');
@@ -16,209 +16,241 @@ require('../chunk-VJKZWYYJ.cjs');
 
 
 
+Object.defineProperty(exports, "MERKLE_BATCH_LIMIT", {
+  enumerable: true,
+  get: function () { return chunkDFK5GCJP_cjs.MERKLE_BATCH_LIMIT; }
+});
 Object.defineProperty(exports, "buildMerkleCampaign", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.buildMerkleCampaign; }
+  get: function () { return chunkDFK5GCJP_cjs.buildMerkleCampaign; }
 });
 Object.defineProperty(exports, "buildMerkleTree", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.buildMerkleTree; }
+  get: function () { return chunkDFK5GCJP_cjs.buildMerkleTree; }
+});
+Object.defineProperty(exports, "encodeInstanceRoleSplit", {
+  enumerable: true,
+  get: function () { return chunkDFK5GCJP_cjs.encodeInstanceRoleSplit; }
 });
 Object.defineProperty(exports, "encryptCampaignAmounts", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.encryptCampaignAmounts; }
+  get: function () { return chunkDFK5GCJP_cjs.encryptCampaignAmounts; }
 });
 Object.defineProperty(exports, "grantInstanceRoles", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.grantInstanceRoles; }
+  get: function () { return chunkDFK5GCJP_cjs.grantInstanceRoles; }
 });
 Object.defineProperty(exports, "leafOf", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.leafOf; }
+  get: function () { return chunkDFK5GCJP_cjs.leafOf; }
 });
 Object.defineProperty(exports, "planInstanceRoleSplit", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.planInstanceRoleSplit; }
+  get: function () { return chunkDFK5GCJP_cjs.planInstanceRoleSplit; }
 });
 Object.defineProperty(exports, "planMerkleCampaign", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.planMerkleCampaign; }
+  get: function () { return chunkDFK5GCJP_cjs.planMerkleCampaign; }
 });
 Object.defineProperty(exports, "rotateMerkleRoot", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.rotateMerkleRoot; }
+  get: function () { return chunkDFK5GCJP_cjs.rotateMerkleRoot; }
 });
 Object.defineProperty(exports, "validateCampaignRecipients", {
   enumerable: true,
-  get: function () { return chunkIUKKNJ2R_cjs.validateCampaignRecipients; }
+  get: function () { return chunkDFK5GCJP_cjs.validateCampaignRecipients; }
 });
 Object.defineProperty(exports, "AirdropBaseClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.AirdropBaseClient; }
+  get: function () { return chunkE4IV4M4E_cjs.AirdropBaseClient; }
 });
 Object.defineProperty(exports, "CLAIM_TYPEHASH", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.CLAIM_TYPEHASH; }
+  get: function () { return chunkE4IV4M4E_cjs.CLAIM_TYPEHASH; }
 });
 Object.defineProperty(exports, "CLAIM_TYPES", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.CLAIM_TYPES; }
+  get: function () { return chunkE4IV4M4E_cjs.CLAIM_TYPES; }
 });
 Object.defineProperty(exports, "ComplianceManagerClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.ComplianceManagerClient; }
+  get: function () { return chunkE4IV4M4E_cjs.ComplianceManagerClient; }
 });
 Object.defineProperty(exports, "ConfidentialAirdropFactoryClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.ConfidentialAirdropFactoryClient; }
+  get: function () { return chunkE4IV4M4E_cjs.ConfidentialAirdropFactoryClient; }
 });
 Object.defineProperty(exports, "EIP712_DOMAIN_NAME", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.EIP712_DOMAIN_NAME; }
+  get: function () { return chunkE4IV4M4E_cjs.EIP712_DOMAIN_NAME; }
 });
 Object.defineProperty(exports, "EIP712_DOMAIN_VERSION", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.EIP712_DOMAIN_VERSION; }
+  get: function () { return chunkE4IV4M4E_cjs.EIP712_DOMAIN_VERSION; }
 });
 Object.defineProperty(exports, "EcdsaAirdropClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.EcdsaAirdropClient; }
+  get: function () { return chunkE4IV4M4E_cjs.EcdsaAirdropClient; }
 });
 Object.defineProperty(exports, "FACTORY_ROLE_CONCENTRATION_NOTE", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.FACTORY_ROLE_CONCENTRATION_NOTE; }
+  get: function () { return chunkE4IV4M4E_cjs.FACTORY_ROLE_CONCENTRATION_NOTE; }
 });
 Object.defineProperty(exports, "MerkleAirdropClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.MerkleAirdropClient; }
+  get: function () { return chunkE4IV4M4E_cjs.MerkleAirdropClient; }
 });
 Object.defineProperty(exports, "airdropFactoryAbi", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.airdropFactoryAbi; }
+  get: function () { return chunkE4IV4M4E_cjs.airdropFactoryAbi; }
 });
 Object.defineProperty(exports, "complianceRoleManagerAbi", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.complianceRoleManagerAbi; }
+  get: function () { return chunkE4IV4M4E_cjs.complianceRoleManagerAbi; }
 });
 Object.defineProperty(exports, "confidentialAirdropBaseAbi", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.confidentialAirdropBaseAbi; }
+  get: function () { return chunkE4IV4M4E_cjs.confidentialAirdropBaseAbi; }
 });
 Object.defineProperty(exports, "createAirdropBaseClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.createAirdropBaseClient; }
+  get: function () { return chunkE4IV4M4E_cjs.createAirdropBaseClient; }
 });
 Object.defineProperty(exports, "createComplianceManagerClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.createComplianceManagerClient; }
+  get: function () { return chunkE4IV4M4E_cjs.createComplianceManagerClient; }
 });
 Object.defineProperty(exports, "createConfidentialAirdropFactoryClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.createConfidentialAirdropFactoryClient; }
+  get: function () { return chunkE4IV4M4E_cjs.createConfidentialAirdropFactoryClient; }
 });
 Object.defineProperty(exports, "createEcdsaAirdropClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.createEcdsaAirdropClient; }
+  get: function () { return chunkE4IV4M4E_cjs.createEcdsaAirdropClient; }
 });
 Object.defineProperty(exports, "createMerkleAirdropClient", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.createMerkleAirdropClient; }
+  get: function () { return chunkE4IV4M4E_cjs.createMerkleAirdropClient; }
 });
 Object.defineProperty(exports, "ecdsaConfidentialAirdropAbi", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.ecdsaConfidentialAirdropAbi; }
+  get: function () { return chunkE4IV4M4E_cjs.ecdsaConfidentialAirdropAbi; }
 });
 Object.defineProperty(exports, "encryptUint64", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.encryptUint64; }
+  get: function () { return chunkE4IV4M4E_cjs.encryptUint64; }
 });
 Object.defineProperty(exports, "encryptUint64Batch", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.encryptUint64Batch; }
+  get: function () { return chunkE4IV4M4E_cjs.encryptUint64Batch; }
 });
 Object.defineProperty(exports, "isAclPropagationError", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.isAclPropagationError; }
+  get: function () { return chunkE4IV4M4E_cjs.isAclPropagationError; }
 });
 Object.defineProperty(exports, "merkleConfidentialAirdropAbi", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.merkleConfidentialAirdropAbi; }
+  get: function () { return chunkE4IV4M4E_cjs.merkleConfidentialAirdropAbi; }
 });
 Object.defineProperty(exports, "resolveEncryptor", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.resolveEncryptor; }
+  get: function () { return chunkE4IV4M4E_cjs.resolveEncryptor; }
 });
 Object.defineProperty(exports, "signClaimAuthorization", {
   enumerable: true,
-  get: function () { return chunkPZZK3O3S_cjs.signClaimAuthorization; }
+  get: function () { return chunkE4IV4M4E_cjs.signClaimAuthorization; }
 });
 Object.defineProperty(exports, "AIRDROP_CONTRACTS_COMMIT", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.AIRDROP_CONTRACTS_COMMIT; }
+  get: function () { return chunkVHKMWWBA_cjs.AIRDROP_CONTRACTS_COMMIT; }
 });
 Object.defineProperty(exports, "AlreadyClaimedError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.AlreadyClaimedError; }
+  get: function () { return chunkVHKMWWBA_cjs.AlreadyClaimedError; }
 });
 Object.defineProperty(exports, "ClaimNotStartedError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.ClaimNotStartedError; }
+  get: function () { return chunkVHKMWWBA_cjs.ClaimNotStartedError; }
 });
 Object.defineProperty(exports, "ClaimWindowClosedError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.ClaimWindowClosedError; }
+  get: function () { return chunkVHKMWWBA_cjs.ClaimWindowClosedError; }
+});
+Object.defineProperty(exports, "ClawbackRequiresPauseError", {
+  enumerable: true,
+  get: function () { return chunkVHKMWWBA_cjs.ClawbackRequiresPauseError; }
+});
+Object.defineProperty(exports, "CreateCommitmentMismatchError", {
+  enumerable: true,
+  get: function () { return chunkVHKMWWBA_cjs.CreateCommitmentMismatchError; }
 });
 Object.defineProperty(exports, "DEDUP_MODE", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.DEDUP_MODE; }
+  get: function () { return chunkVHKMWWBA_cjs.DEDUP_MODE; }
 });
 Object.defineProperty(exports, "DEPLOYMENT_MODE", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.DEPLOYMENT_MODE; }
+  get: function () { return chunkVHKMWWBA_cjs.DEPLOYMENT_MODE; }
 });
 Object.defineProperty(exports, "DedupIdConsumedError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.DedupIdConsumedError; }
+  get: function () { return chunkVHKMWWBA_cjs.DedupIdConsumedError; }
 });
 Object.defineProperty(exports, "FeeCollectorSelfAdministeredError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.FeeCollectorSelfAdministeredError; }
+  get: function () { return chunkVHKMWWBA_cjs.FeeCollectorSelfAdministeredError; }
+});
+Object.defineProperty(exports, "GasFeeNotAcceptedError", {
+  enumerable: true,
+  get: function () { return chunkVHKMWWBA_cjs.GasFeeNotAcceptedError; }
 });
 Object.defineProperty(exports, "MerkleUupsUnsupportedError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.MerkleUupsUnsupportedError; }
+  get: function () { return chunkVHKMWWBA_cjs.MerkleUupsUnsupportedError; }
+});
+Object.defineProperty(exports, "NativeRescueRequiresZeroFeeError", {
+  enumerable: true,
+  get: function () { return chunkVHKMWWBA_cjs.NativeRescueRequiresZeroFeeError; }
 });
 Object.defineProperty(exports, "NonStockWrapperError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.NonStockWrapperError; }
+  get: function () { return chunkVHKMWWBA_cjs.NonStockWrapperError; }
 });
 Object.defineProperty(exports, "PredictionDriftError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.PredictionDriftError; }
+  get: function () { return chunkVHKMWWBA_cjs.PredictionDriftError; }
 });
 Object.defineProperty(exports, "SaltCollisionError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.SaltCollisionError; }
+  get: function () { return chunkVHKMWWBA_cjs.SaltCollisionError; }
 });
 Object.defineProperty(exports, "SignatureExpiredError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.SignatureExpiredError; }
+  get: function () { return chunkVHKMWWBA_cjs.SignatureExpiredError; }
+});
+Object.defineProperty(exports, "UINT96_MAX", {
+  enumerable: true,
+  get: function () { return chunkVHKMWWBA_cjs.UINT96_MAX; }
 });
 Object.defineProperty(exports, "UnauthorizedRedirectError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.UnauthorizedRedirectError; }
+  get: function () { return chunkVHKMWWBA_cjs.UnauthorizedRedirectError; }
+});
+Object.defineProperty(exports, "UnrecognisedAirdropError", {
+  enumerable: true,
+  get: function () { return chunkVHKMWWBA_cjs.UnrecognisedAirdropError; }
 });
 Object.defineProperty(exports, "UpgradeabilityNotAllowedError", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.UpgradeabilityNotAllowedError; }
+  get: function () { return chunkVHKMWWBA_cjs.UpgradeabilityNotAllowedError; }
 });
 Object.defineProperty(exports, "preflightClaim", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.preflightClaim; }
+  get: function () { return chunkVHKMWWBA_cjs.preflightClaim; }
 });
 Object.defineProperty(exports, "preflightCreate", {
   enumerable: true,
-  get: function () { return chunkAREQJHKA_cjs.preflightCreate; }
+  get: function () { return chunkVHKMWWBA_cjs.preflightCreate; }
 });
 Object.defineProperty(exports, "ERC7984_OPERATOR_MAX_DEADLINE", {
   enumerable: true,

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

@@ -2,9 +2,10 @@
  * `@tokenops/sdk/fhe-airdrop` - confidential airdrop campaigns on the
  * TokenOps airdrop v2 contracts.
  *
- * **Unaudited contracts. Alpha software. No stability promise.** This module
- * targets `tokenops-fhe-airdrop-v2`, which has not been audited. It is
- * intended for the `alpha` npm dist-tag only, and must not be published to
+ * **Alpha software. No stability promise.**
+ * This module targets `tokenops-fhe-airdrop-v2` at `AIRDROP_CONTRACTS_COMMIT`, through
+ * the Sepolia deployment in `DEPLOYED_ADDRESSES`. It is intended for the `alpha` npm
+ * dist-tag only, and must not be published to
  * `latest`: the release that first ships this module is the one that sets
  * that tag. Two contract
  * behaviours would otherwise produce a wrong result rather than a revert,
@@ -27,22 +28,23 @@
  * Address prediction and its integrity guards live on the
  * `@tokenops/sdk/fhe-airdrop/advanced` subpath.
  */
-export { AIRDROP_CONTRACTS_COMMIT, DEDUP_MODE, DEPLOYMENT_MODE, type DedupMode, type DeploymentMode, } from "./constants.js";
+export { AIRDROP_CONTRACTS_COMMIT, DEDUP_MODE, DEPLOYMENT_MODE, UINT96_MAX, type DedupMode, type DeploymentMode, } from "./constants.js";
 export { ConfidentialAirdropFactoryClient, createConfidentialAirdropFactoryClient, FACTORY_ROLE_CONCENTRATION_NOTE, type CompliancePolicy, type ConfidentialAirdropFactoryClientConfig, type CustomFee, type FundInput, type UpgradeabilityPolicy, } from "./factory.js";
-export { AirdropBaseClient, createAirdropBaseClient, type AirdropBaseClientConfig, type WriteAccountOverride, } from "./airdrop-base.js";
+export { AirdropBaseClient, createAirdropBaseClient, type AirdropBaseClientConfig, type UnwrapRequest, type UnwrapRequestSource, type WriteAccountOverride, } from "./airdrop-base.js";
 export { CLAIM_TYPEHASH, CLAIM_TYPES, createEcdsaAirdropClient, EcdsaAirdropClient, EIP712_DOMAIN_NAME, EIP712_DOMAIN_VERSION, type Eip712Domain, type EcdsaAirdropClientConfig, type EcdsaClaimArgs, type GetClaimAmountArgs as EcdsaGetClaimAmountArgs, type IsSignatureValidArgs, } from "./ecdsa.js";
 export { createMerkleAirdropClient, MerkleAirdropClient, type GetClaimAmountArgs as MerkleGetClaimAmountArgs, type MerkleClaimArgs, } from "./merkle.js";
 export { buildMerkleTree, leafOf, type BuildMerkleTreeArgs, type BuiltMerkleTree, type LeafOfArgs, type MerkleLeafInput, } from "./merkle-tree.js";
 export { ComplianceManagerClient, createComplianceManagerClient, isAclPropagationError, type ComplianceManagerClientConfig, } from "./compliance.js";
-export type { BuiltCampaign, CampaignEntry, CampaignRecipient, CommonAirdropParams, CreateAirdropArgs, CreateAirdropResult, EcdsaAirdropParams, MerkleAirdropParams, } from "./types.js";
+export type { AirdropVariantParams, BuiltCampaign, CampaignEntry, CampaignRecipient, CommonAirdropParams, CreateAirdropArgs, CreateAirdropResult, CreateCommitments, CreateMerkleAirdropArgs, EcdsaAirdropParams, MerkleAirdropParams, PendingCreateAirdropResult, } from "./types.js";
+export type { MinedWrite, PendingWrite, ReceiptMode } from "../core/pending.js";
 export type { EncryptedInput, EncryptedInputs, EncryptedViewResult } from "../fhe/types.js";
-export { buildMerkleCampaign, encryptCampaignAmounts, planMerkleCampaign, rotateMerkleRoot, validateCampaignRecipients, type BuildMerkleCampaignArgs, type CampaignSubmitterOption, type EncryptCampaignAmountsArgs, type EncryptedCampaignLeaf, type PlanMerkleCampaignArgs, type PlannedCampaign, type RotatedCampaign, type RotateMerkleRootArgs, } from "./campaign.js";
-export { grantInstanceRoles, planInstanceRoleSplit, type InstanceRoleAssignment, type RoleGrantOutcome, type RoleGrantStep, type RoleName, } from "./roles.js";
+export { buildMerkleCampaign, encryptCampaignAmounts, MERKLE_BATCH_LIMIT, planMerkleCampaign, rotateMerkleRoot, validateCampaignRecipients, type BuildMerkleCampaignArgs, type EncryptCampaignAmountsArgs, type EncryptedCampaignLeaf, type PlanMerkleCampaignArgs, type PlannedCampaign, type RotatedCampaign, type RotateMerkleRootArgs, } from "./campaign.js";
+export { encodeInstanceRoleSplit, grantInstanceRoles, planInstanceRoleSplit, type InstanceRoleAssignment, type InstanceRoleCall, type InstanceRoleConstants, type RoleGrantOutcome, type RoleGrantStep, type RoleName, } from "./roles.js";
 export { encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization, type Encryptor, type EncryptorSource, type EncryptUint64Args, type EncryptUint64BatchArgs, type FheValueInput, } from "./encryption.js";
-export { preflightClaim, preflightCreate, type ClaimPreflightTarget, type EcdsaClaimPreflightSignature, type PreflightClaimArgs, type PreflightCreateArgs, } from "./guards.js";
+export { preflightClaim, preflightCreate, type AirdropRegistry, type ClaimPreflightTarget, type EcdsaClaimPreflightSignature, type PreflightClaimArgs, type PreflightCreateArgs, type PreflightCreateResult, } from "./guards.js";
 export { type PreflightResult } from "../core/preflight.js";
 export { airdropFactoryAbi, complianceRoleManagerAbi, confidentialAirdropBaseAbi, ecdsaConfidentialAirdropAbi, merkleConfidentialAirdropAbi, } from "./abis/index.js";
-export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError, DedupIdConsumedError, FeeCollectorSelfAdministeredError, MerkleUupsUnsupportedError, NonStockWrapperError, PredictionDriftError, SaltCollisionError, SignatureExpiredError, UnauthorizedRedirectError, UpgradeabilityNotAllowedError, type AirdropVariant, } from "./errors.js";
+export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError, ClawbackRequiresPauseError, CreateCommitmentMismatchError, DedupIdConsumedError, FeeCollectorSelfAdministeredError, GasFeeNotAcceptedError, MerkleUupsUnsupportedError, NativeRescueRequiresZeroFeeError, NonStockWrapperError, PredictionDriftError, SaltCollisionError, SignatureExpiredError, UnauthorizedRedirectError, UnrecognisedAirdropError, UpgradeabilityNotAllowedError, type AirdropVariant, } from "./errors.js";
 export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, PausedError, AccessDeniedError, OperatorNotApprovedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../core/errors.js";
 export { ERC7984_OPERATOR_MAX_DEADLINE, revokeOperator, setOperator, type RevokeOperatorArgs, type SetOperatorArgs, } from "../fhe/operators.js";
 export { erc7984OperatorAbi } from "../fhe/erc7984-abi.js";