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

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

@@ -42,7 +42,9 @@ export { useMerkleRoot, type UseMerkleRootArgs } from "./useMerkleRoot.js";
 export { useClaimedAmount, type UseClaimedAmountArgs } from "./useClaimedAmount.js";
 export { useComplianceManager, type UseComplianceManagerArgs } from "./useComplianceManager.js";
 export { useFactoryFees, type FactoryFees, type UseFactoryFeesArgs } from "./useFactoryFees.js";
+export { useResolveGasFee, type UseResolveGasFeeArgs } from "./useResolveGasFee.js";
 export { useFactoryRegistry, type FactoryRegistryPage, type UseFactoryRegistryArgs, } from "./useFactoryRegistry.js";
+export { useIsAirdrop, type UseIsAirdropArgs } from "./useIsAirdrop.js";
 export { useEffectiveUpgradeable, type UseEffectiveUpgradeableArgs, } from "./useEffectiveUpgradeable.js";
 export { useAirdropConfig, type AirdropConfig, type UseAirdropConfigArgs, } from "./useAirdropConfig.js";
 export { useAirdropDeploymentMode, type UseAirdropDeploymentModeArgs, } from "./useAirdropDeploymentMode.js";
@@ -97,6 +99,7 @@ export { useWithdrawGasFee, type WithdrawGasFeeArgs } from "./useWithdrawGasFee.
 export { useAdminBatchDiscloseBalanceToParties, type UseAdminBatchDiscloseBalanceToPartiesArgs, } from "./useAdminBatchDiscloseBalanceToParties.js";
 export { useAdminDiscloseBalanceToParty, type UseAdminDiscloseBalanceToPartyArgs, } from "./useAdminDiscloseBalanceToParty.js";
 export { useAdminGetCurrentBalance } from "./useAdminGetCurrentBalance.js";
+export { useRefreshComplianceBalance } from "./useRefreshComplianceBalance.js";
 export { useAccessEcdsaClaimAmount } from "./useAccessEcdsaClaimAmount.js";
 export { useAccessMerkleClaimAmount } from "./useAccessMerkleClaimAmount.js";
 export { airdropQueryKey, airdropQueryKeyPrefix, type AirdropClientOptions, type AirdropHookOptions, type AirdropInstanceClientOptions, type AirdropInstanceHookOptions, type EcdsaAirdropInstanceClientOptions, type EcdsaAirdropInstanceHookOptions, } from "./_shared.js";
@@ -110,7 +113,7 @@ export { buildMerkleTree, leafOf, type BuildMerkleTreeArgs, type BuiltMerkleTree
 export type { FundInput } from "../factory.js";
 export type { WriteAccountOverride } from "../airdrop-base.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 { 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, } from "../guards.js";
 export type { PreflightResult } from "../../core/preflight.js";
 export { grantInstanceRoles, planInstanceRoleSplit, type InstanceRoleAssignment, type RoleGrantOutcome, type RoleGrantStep, type RoleName, } from "../roles.js";
 export { type DedupMode, type DeploymentMode } from "../constants.js";

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

@@ -42,7 +42,9 @@ export { useMerkleRoot, type UseMerkleRootArgs } from "./useMerkleRoot.js";
 export { useClaimedAmount, type UseClaimedAmountArgs } from "./useClaimedAmount.js";
 export { useComplianceManager, type UseComplianceManagerArgs } from "./useComplianceManager.js";
 export { useFactoryFees, type FactoryFees, type UseFactoryFeesArgs } from "./useFactoryFees.js";
+export { useResolveGasFee, type UseResolveGasFeeArgs } from "./useResolveGasFee.js";
 export { useFactoryRegistry, type FactoryRegistryPage, type UseFactoryRegistryArgs, } from "./useFactoryRegistry.js";
+export { useIsAirdrop, type UseIsAirdropArgs } from "./useIsAirdrop.js";
 export { useEffectiveUpgradeable, type UseEffectiveUpgradeableArgs, } from "./useEffectiveUpgradeable.js";
 export { useAirdropConfig, type AirdropConfig, type UseAirdropConfigArgs, } from "./useAirdropConfig.js";
 export { useAirdropDeploymentMode, type UseAirdropDeploymentModeArgs, } from "./useAirdropDeploymentMode.js";
@@ -97,6 +99,7 @@ export { useWithdrawGasFee, type WithdrawGasFeeArgs } from "./useWithdrawGasFee.
 export { useAdminBatchDiscloseBalanceToParties, type UseAdminBatchDiscloseBalanceToPartiesArgs, } from "./useAdminBatchDiscloseBalanceToParties.js";
 export { useAdminDiscloseBalanceToParty, type UseAdminDiscloseBalanceToPartyArgs, } from "./useAdminDiscloseBalanceToParty.js";
 export { useAdminGetCurrentBalance } from "./useAdminGetCurrentBalance.js";
+export { useRefreshComplianceBalance } from "./useRefreshComplianceBalance.js";
 export { useAccessEcdsaClaimAmount } from "./useAccessEcdsaClaimAmount.js";
 export { useAccessMerkleClaimAmount } from "./useAccessMerkleClaimAmount.js";
 export { airdropQueryKey, airdropQueryKeyPrefix, type AirdropClientOptions, type AirdropHookOptions, type AirdropInstanceClientOptions, type AirdropInstanceHookOptions, type EcdsaAirdropInstanceClientOptions, type EcdsaAirdropInstanceHookOptions, } from "./_shared.js";
@@ -110,7 +113,7 @@ export { buildMerkleTree, leafOf, type BuildMerkleTreeArgs, type BuiltMerkleTree
 export type { FundInput } from "../factory.js";
 export type { WriteAccountOverride } from "../airdrop-base.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 { 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, } from "../guards.js";
 export type { PreflightResult } from "../../core/preflight.js";
 export { grantInstanceRoles, planInstanceRoleSplit, type InstanceRoleAssignment, type RoleGrantOutcome, type RoleGrantStep, type RoleName, } from "../roles.js";
 export { type DedupMode, type DeploymentMode } from "../constants.js";

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

@@ -1,15 +1,15 @@
-import { grantInstanceRoles, buildMerkleCampaign, encryptCampaignAmounts, planMerkleCampaign, rotateMerkleRoot } from '../../chunk-GADGBQJO.js';
-export { buildMerkleCampaign, buildMerkleTree, encryptCampaignAmounts, grantInstanceRoles, leafOf, planInstanceRoleSplit, planMerkleCampaign, rotateMerkleRoot, validateCampaignRecipients } from '../../chunk-GADGBQJO.js';
-import { useMemoAirdropBaseClient, airdropQueryKey, useMemoMerkleAirdropClient, useMemoAirdropFactoryClient, airdropKeys, useMemoEcdsaAirdropClient, useMemoComplianceManagerClient, AIRDROP_FN, airdropQueryKeyPrefix } from '../../chunk-EYDA6Q6C.js';
-export { airdropQueryKey, airdropQueryKeyPrefix } from '../../chunk-EYDA6Q6C.js';
-import { resolveEncryptor, signClaimAuthorization } from '../../chunk-X7WBPCEU.js';
-export { encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization } from '../../chunk-X7WBPCEU.js';
-import { preflightClaim, preflightCreate } from '../../chunk-VW356KR3.js';
-export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError, DedupIdConsumedError, FeeCollectorSelfAdministeredError, MerkleUupsUnsupportedError, NonStockWrapperError, PredictionDriftError, SaltCollisionError, SignatureExpiredError, UnauthorizedRedirectError, UpgradeabilityNotAllowedError, preflightClaim, preflightCreate } from '../../chunk-VW356KR3.js';
+import { grantInstanceRoles, buildMerkleCampaign, encryptCampaignAmounts, planMerkleCampaign, rotateMerkleRoot } from '../../chunk-GCJFAY4X.js';
+export { buildMerkleCampaign, buildMerkleTree, encryptCampaignAmounts, grantInstanceRoles, leafOf, planInstanceRoleSplit, planMerkleCampaign, rotateMerkleRoot, validateCampaignRecipients } from '../../chunk-GCJFAY4X.js';
+import { useMemoAirdropBaseClient, airdropQueryKey, useMemoMerkleAirdropClient, useMemoAirdropFactoryClient, AIRDROP_FN, airdropKeys, useMemoEcdsaAirdropClient, useMemoComplianceManagerClient } from '../../chunk-U3TBQRT7.js';
+export { airdropQueryKey, airdropQueryKeyPrefix } from '../../chunk-U3TBQRT7.js';
+import { resolveEncryptor, signClaimAuthorization } from '../../chunk-BXX5TETM.js';
+export { encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization } from '../../chunk-BXX5TETM.js';
+import { preflightClaim, preflightCreate } from '../../chunk-LEYYG4RF.js';
+export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError, DedupIdConsumedError, FeeCollectorSelfAdministeredError, MerkleUupsUnsupportedError, NonStockWrapperError, PredictionDriftError, SaltCollisionError, SignatureExpiredError, UnauthorizedRedirectError, UpgradeabilityNotAllowedError, preflightClaim, preflightCreate } from '../../chunk-LEYYG4RF.js';
 import '../../chunk-ZWXJTBZO.js';
 import '../../chunk-NWFMBLSQ.js';
 import '../../chunk-4RAAATVY.js';
-import '../../chunk-A4DCEE33.js';
+import '../../chunk-6HCT4QIX.js';
 import '../../chunk-ZA673I3O.js';
 import '../../chunk-KWFFIJYX.js';
 import { MissingClientError, MissingWalletClientError } from '../../chunk-QBJ7O2B4.js';
@@ -122,15 +122,31 @@ function useFactoryFees(args = {}) {
     ...args.query,
     queryKey: airdropQueryKey({ chainId, address: resolvedAddress, fn: "fees", args: [] }),
     queryFn: async () => {
-      const [feeCollector, defaultGasFee] = await Promise.all([
+      const [feeCollector, defaultGasFee, maxGasFee] = await Promise.all([
         client.feeCollector(),
-        client.defaultGasFee()
+        client.defaultGasFee(),
+        client.maxGasFee()
       ]);
-      return { feeCollector, defaultGasFee };
+      return { feeCollector, defaultGasFee, maxGasFee };
     },
     enabled: Boolean(client && (args.query?.enabled ?? true))
   });
 }
+function useResolveGasFee(args = {}) {
+  const { creator, ...base } = args;
+  const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
+  return useQuery({
+    ...args.query,
+    queryKey: airdropQueryKey({
+      chainId,
+      address: resolvedAddress,
+      fn: AIRDROP_FN.resolvedGasFee,
+      args: [creator]
+    }),
+    queryFn: () => client.resolveGasFee(creator),
+    enabled: Boolean(client && creator && (args.query?.enabled ?? true))
+  });
+}
 function useFactoryRegistry(args = {}) {
   const { offset = 0n, limit = 50n, ...base } = args;
   const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
@@ -152,6 +168,24 @@ function useFactoryRegistry(args = {}) {
     enabled: Boolean(client && (args.query?.enabled ?? true))
   });
 }
+function useIsAirdrop(args = {}) {
+  const { candidate, ...base } = args;
+  const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
+  return useQuery({
+    // Per-result, not blanket: `true` is immutable (append-only registry),
+    // `false` is not. See the TSDoc above.
+    staleTime: (query) => query.state.data === true ? Infinity : 0,
+    ...args.query,
+    queryKey: airdropQueryKey({
+      chainId,
+      address: resolvedAddress,
+      fn: AIRDROP_FN.isAirdrop,
+      args: [candidate]
+    }),
+    queryFn: () => client.isAirdrop(candidate),
+    enabled: Boolean(client && candidate && (args.query?.enabled ?? true))
+  });
+}
 function useEffectiveUpgradeable(args = {}) {
   const { creator, ...base } = args;
   const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
@@ -531,7 +565,10 @@ function useCreateEcdsaAirdrop(options = {}) {
     },
     onSuccess: () => {
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({ chainId, address: resolvedAddress, fn: "registry" })
+        queryKey: airdropKeys.registryAll({ chainId, address: resolvedAddress })
+      });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.isAirdropAll({ chainId, address: resolvedAddress })
       });
     }
   });
@@ -548,7 +585,10 @@ function useCreateMerkleAirdrop(options = {}) {
     },
     onSuccess: () => {
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({ chainId, address: resolvedAddress, fn: "registry" })
+        queryKey: airdropKeys.registryAll({ chainId, address: resolvedAddress })
+      });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.isAirdropAll({ chainId, address: resolvedAddress })
       });
     }
   });
@@ -885,6 +925,9 @@ function useCreateAndFundEcdsaAirdrop(options = {}) {
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.registryAll({ chainId, address: resolvedAddress })
       });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.isAirdropAll({ chainId, address: resolvedAddress })
+      });
     }
   });
 }
@@ -902,6 +945,9 @@ function useCreateAndFundMerkleAirdrop(options = {}) {
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.registryAll({ chainId, address: resolvedAddress })
       });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.isAirdropAll({ chainId, address: resolvedAddress })
+      });
     }
   });
 }
@@ -1121,6 +1167,17 @@ function useAdminGetCurrentBalance(options) {
     }
   });
 }
+function useRefreshComplianceBalance(options) {
+  const { client } = useMemoAirdropBaseClient(options);
+  return useMutation({
+    mutationFn: async (args) => {
+      if (!client) {
+        throw new MissingClientError("useRefreshComplianceBalance", "airdrop-base");
+      }
+      return client.refreshComplianceBalance(args ?? {});
+    }
+  });
+}
 function useAccessEcdsaClaimAmount(options) {
   const { client } = useMemoEcdsaAirdropClient(options);
   return useMutation({
@@ -1144,4 +1201,4 @@ function useAccessMerkleClaimAmount(options) {
   });
 }
 
-export { useAccessEcdsaClaimAmount, useAccessMerkleClaimAmount, useAddComplianceDelegate, useAdminBatchDiscloseBalanceToParties, useAdminDiscloseBalanceToParty, useAdminGetCurrentBalance, useAirdropConfig, useAirdropDeploymentMode, useAirdropGasFee, useAirdropGrantRole, useAirdropHasRole, useAirdropPause, useAirdropPaused, useAirdropRenounceRole, useAirdropRevokeRole, useAirdropRoleAdmin, useAirdropRoleConstants, useAirdropRoleMembers, useAirdropToken, useAirdropUpgradeToAndCall, useAirdropWindow, useBatchDiscloseHandlesToParty, useBuildMerkleCampaign, useClaimedAmount, useComplianceGrantRole, useComplianceHasRole, useComplianceInfo, useComplianceManager, useComplianceManagerOf, useComplianceRenounceRole, useComplianceRevokeRole, useComplianceRoleConstants, useComplianceRoleMembers, useCreateAndFundEcdsaAirdrop, useCreateAndFundMerkleAirdrop, useCreateEcdsaAirdrop, useCreateMerkleAirdrop, useDiscloseHandleToParty, useEcdsaClaim, useEcdsaClaimAndUnwrap, useEcdsaDomain, useEffectiveDelegateToCompliance, useEffectiveUpgradeable, useEncryptCampaignAmounts, useExtendClaimWindow, useFactoryFees, useFactoryRegistry, useFundAirdrop, useGrantInstanceRoles, useIsActiveDelegate, useIsMerkleRootMutable, useIsSignatureValid, useMerkleClaim, useMerkleClaimAndUnwrap, useMerkleRoot, usePlanMerkleCampaign, usePreflightClaim, usePreflightCreateAirdrop, useRescueERC20, useRescueOtherConfidentialToken, useRevokeComplianceDelegate, useRotateMerkleRoot, useSetMerkleRoot, useSignClaimAuthorization, useWithdrawConfidential, useWithdrawGasFee };
+export { useAccessEcdsaClaimAmount, useAccessMerkleClaimAmount, useAddComplianceDelegate, useAdminBatchDiscloseBalanceToParties, useAdminDiscloseBalanceToParty, useAdminGetCurrentBalance, useAirdropConfig, useAirdropDeploymentMode, useAirdropGasFee, useAirdropGrantRole, useAirdropHasRole, useAirdropPause, useAirdropPaused, useAirdropRenounceRole, useAirdropRevokeRole, useAirdropRoleAdmin, useAirdropRoleConstants, useAirdropRoleMembers, useAirdropToken, useAirdropUpgradeToAndCall, useAirdropWindow, useBatchDiscloseHandlesToParty, useBuildMerkleCampaign, useClaimedAmount, useComplianceGrantRole, useComplianceHasRole, useComplianceInfo, useComplianceManager, useComplianceManagerOf, useComplianceRenounceRole, useComplianceRevokeRole, useComplianceRoleConstants, useComplianceRoleMembers, useCreateAndFundEcdsaAirdrop, useCreateAndFundMerkleAirdrop, useCreateEcdsaAirdrop, useCreateMerkleAirdrop, useDiscloseHandleToParty, useEcdsaClaim, useEcdsaClaimAndUnwrap, useEcdsaDomain, useEffectiveDelegateToCompliance, useEffectiveUpgradeable, useEncryptCampaignAmounts, useExtendClaimWindow, useFactoryFees, useFactoryRegistry, useFundAirdrop, useGrantInstanceRoles, useIsActiveDelegate, useIsAirdrop, useIsMerkleRootMutable, useIsSignatureValid, useMerkleClaim, useMerkleClaimAndUnwrap, useMerkleRoot, usePlanMerkleCampaign, usePreflightClaim, usePreflightCreateAirdrop, useRefreshComplianceBalance, useRescueERC20, useRescueOtherConfidentialToken, useResolveGasFee, useRevokeComplianceDelegate, useRotateMerkleRoot, useSetMerkleRoot, useSignClaimAuthorization, useWithdrawConfidential, useWithdrawGasFee };

package/dist/fhe-airdrop/react/keys.d.ts

@@ -33,6 +33,8 @@ export declare const AIRDROP_FN: {
     readonly isSignatureValid: "isSignatureValid";
     readonly fees: "fees";
     readonly registry: "registry";
+    readonly isAirdrop: "isAirdrop";
+    readonly resolvedGasFee: "resolvedGasFee";
     readonly customFee: "customFee";
     readonly implementations: "implementations";
     readonly compliancePolicy: "compliancePolicy";
@@ -66,8 +68,14 @@ export declare const airdropKeys: {
     readonly fees: (s: Scope) => unknown[];
     readonly customFee: (s: Scope, creator: Address | undefined) => unknown[];
     readonly customFeeAll: (s: Scope) => unknown[];
+    readonly resolvedGasFee: (s: Scope, creator: Address | undefined) => unknown[];
+    /** Every creator's resolved fee; the default and any override both move it. */
+    readonly resolvedGasFeeAll: (s: Scope) => unknown[];
     /** Every registry page, whatever offset/limit was queried. */
     readonly registryAll: (s: Scope) => unknown[];
+    readonly isAirdrop: (s: Scope, candidate: Address | undefined) => unknown[];
+    /** Every genuineness answer from this factory; a create adds one address. */
+    readonly isAirdropAll: (s: Scope) => unknown[];
     readonly implementations: (s: Scope) => unknown[];
     readonly compliancePolicy: (s: Scope, creator: Address | undefined) => unknown[];
     readonly compliancePolicyAll: (s: Scope) => unknown[];

package/dist/fhe-airdrop/react/useFactoryFees.d.ts

@@ -11,14 +11,21 @@ export interface FactoryFees {
     feeCollector: Address;
     /** Wei charged per claim on a fee-charging campaign, absent a per-creator custom fee. */
     defaultGasFee: bigint;
+    /**
+     * The factory's own ceiling, in wei. Bounds both fee setters and the fee
+     * resolved at create, so it is the upper bound a `maxAcceptedGasFee` ever
+     * has to clear.
+     */
+    maxGasFee: bigint;
 }
 /** @alpha */
 export type UseFactoryFeesArgs = AirdropHookOptions<FactoryFees>;
 /**
- * Read the airdrop factory's default fee configuration — `feeCollector` and
- * `defaultGasFee` in one round trip. For a specific creator's override, read
- * `factory.getCustomFee(creator)` from the headless client directly (not
- * wrapped here — see the module's scope-discipline note).
+ * Read the airdrop factory's chain-wide fee configuration: `feeCollector`,
+ * `defaultGasFee` and `maxGasFee` in one round trip. For the number a specific
+ * creator's `maxAcceptedGasFee` is actually checked against, use
+ * `factory.resolveGasFee(creator)` from the headless client: it folds in that
+ * creator's `getCustomFee` override, which this hook does not read.
  *
  * @example
  * const { data: fees } = useFactoryFees();

package/dist/fhe-airdrop/react/useIsAirdrop.d.ts

@@ -0,0 +1,44 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { Address } from "viem";
+import { type AirdropHookOptions } from "./_shared.js";
+/** @alpha */
+export interface UseIsAirdropArgs extends AirdropHookOptions<boolean> {
+    /** The address to check against the factory's registry. */
+    candidate?: Address;
+}
+/**
+ * Ask the canonical factory whether it created `candidate` - the genuineness
+ * check (audit-10).
+ *
+ * **Run this before trusting an address a user pasted, a link carried, or an
+ * indexer returned.** A look-alike instance with the same ABI, the same events
+ * and a pool the attacker controls is cheap to deploy, and nothing readable at
+ * the instance tells it apart. A claim against one succeeds and delivers
+ * nothing.
+ *
+ * The factory this asks is the one resolved from `src/core/addresses.ts` for
+ * the connected chain, which is what makes the answer worth anything: an
+ * instance that names its own factory names a fake one.
+ *
+ * **Only a `true` is cached.** The registry is append-only, so a `true` can
+ * never become `false` and is safe to hold forever. A `false` is not stable:
+ * the address can be created later by another tab, another service, or the
+ * headless client, none of which reaches this hook's invalidations - so caching
+ * it would serve a stale false negative indefinitely and, for a security check,
+ * in the direction that blocks a legitimate claim. Negative answers therefore
+ * stay fresh and refetch normally. Override either with `query.staleTime`.
+ *
+ * **The `address` override is the trust root.** Like every factory hook this
+ * accepts `address`, and `useMemoAirdropFactoryClient` prefers it over
+ * `src/core/addresses.ts`. That is what makes the hook usable on a local chain,
+ * but it also means an attacker-supplied factory address would answer `true`
+ * for its own look-alike. Pass `address` only from a source you trust at least
+ * as much as the registry; when in doubt, omit it.
+ *
+ * @example
+ * const { data: genuine } = useIsAirdrop({ candidate: fromUrl });
+ * if (genuine === false) return <Warning address={fromUrl} />;
+ *
+ * @alpha
+ */
+export declare function useIsAirdrop(args?: UseIsAirdropArgs): UseQueryResult<boolean, Error>;

package/dist/fhe-airdrop/react/useRefreshComplianceBalance.d.ts

@@ -0,0 +1,36 @@
+import { type UseMutationResult } from "@tanstack/react-query";
+import type { EncryptedViewResult } from "../../fhe/types.js";
+import type { WriteAccountOverride } from "../airdrop-base.js";
+import { type AirdropInstanceClientOptions } from "./_shared.js";
+/**
+ * **Submits a transaction.** Re-grants the compliance-manager clone on the
+ * instance's current pool balance and returns the handle it was granted on.
+ *
+ * **Permissionless** (audit-04), unlike every other disclosure hook here. The
+ * token rotates the instance's balance handle on every incoming transfer,
+ * including a direct one no airdrop code observes, and the clone's existing
+ * grant does not follow. Anyone may restore it because there is no argument to
+ * abuse: the only handle read is the instance's own balance and the only
+ * grantee is the clone wired at initialization.
+ *
+ * The handle comes from the receipt's ACL `Allowed` event naming the CLONE, not
+ * the caller - so unless the connected account is the clone, it cannot decrypt
+ * what this returns. That is also why it is a mutation: the entrypoint calls
+ * `FHE.allow`, so its handle can never come from a simulation (CLAUDE.md
+ * Pitfall #1).
+ *
+ * **A snapshot, not a subscription.** The handle stays readable forever (ACL is
+ * append-only), but the next incoming transfer rotates the instance onto a new
+ * handle the clone was never granted on. Re-run this after any transfer in.
+ *
+ * **Invalidates:** nothing, and nothing invalidates it - a mutation result is
+ * not a cache entry, so no write can refresh it. Re-run it yourself after
+ * `useFundAirdrop` or `useWithdrawConfidential`.
+ *
+ * @example
+ * const refresh = useRefreshComplianceBalance({ address: airdropAddress });
+ * const { handle } = await refresh.mutateAsync();
+ *
+ * @alpha
+ */
+export declare function useRefreshComplianceBalance(options: AirdropInstanceClientOptions): UseMutationResult<EncryptedViewResult, Error, WriteAccountOverride | void>;

package/dist/fhe-airdrop/react/useResolveGasFee.d.ts

@@ -0,0 +1,30 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+import type { Address } from "viem";
+import { type AirdropHookOptions } from "./_shared.js";
+/** @alpha */
+export interface UseResolveGasFeeArgs extends AirdropHookOptions<bigint> {
+    /** The account that will send `create*`. Fee overrides are per-creator. */
+    creator?: Address;
+}
+/**
+ * The per-claim fee a `create*` from `creator` would freeze into the new
+ * instance right now: their `setCustomFee` override when enabled, else the
+ * factory default.
+ *
+ * **This is the number `common.maxAcceptedGasFee` is checked against**, so it is
+ * what a create form should show before the creator picks a bound. Composing it
+ * from `useFactoryFees` and `useFactoryCustomFee` by hand means re-implementing
+ * the override-over-default rule in every consumer, and getting it wrong reads
+ * as "no fee" on exactly the accounts that have one.
+ *
+ * **A snapshot, not a quote.** `FEE_MANAGER_ROLE` can move it between this read
+ * and the create landing, which is the case `maxAcceptedGasFee` exists to catch -
+ * so treat this as what to *show*, never as a reason to skip the bound.
+ *
+ * @example
+ * const { data: fee } = useResolveGasFee({ creator: address });
+ * // then: params.common.maxAcceptedGasFee = fee ?? 0n
+ *
+ * @alpha
+ */
+export declare function useResolveGasFee(args?: UseResolveGasFeeArgs): UseQueryResult<bigint, Error>;

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

@@ -20,6 +20,19 @@ export interface CommonAirdropParams {
     unwrappable: boolean;
     /** Client admin AND client delegate of the compliance clone. Zero means msg.sender. */
     complianceAdmin: Address;
+    /**
+     * The highest per-claim gas fee this creator accepts being frozen into the new
+     * instance, in wei. The factory resolves the creator's fee at execution time
+     * (their custom override, else the factory default) and reverts
+     * `GasFeeNotAccepted` if it lands above this bound.
+     *
+     * Required, and deliberately so: the fee is immutable once frozen, and the
+     * value that resolves is chosen by the factory admin, not the creator. A
+     * default here would hand that decision back to whoever is not making it.
+     * Pass `0n` to accept only a zero-fee campaign, or {@link UINT96_MAX} to
+     * accept whatever resolves.
+     */
+    maxAcceptedGasFee: bigint;
 }
 /** @alpha */
 export interface EcdsaAirdropParams {

package/dist/fhe-disperse/index.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunk3YHBO2DL_cjs = require('../chunk-3YHBO2DL.cjs');
+var chunkIEKTGJ4J_cjs = require('../chunk-IEKTGJ4J.cjs');
 var chunkKFRDLKMA_cjs = require('../chunk-KFRDLKMA.cjs');
 require('../chunk-TEBM66WA.cjs');
 require('../chunk-FAXIIH5R.cjs');
 var chunkFWHYQZ5E_cjs = require('../chunk-FWHYQZ5E.cjs');
 require('../chunk-UG5RKLU2.cjs');
 require('../chunk-MVDQMV25.cjs');
-require('../chunk-FT5H2Q7Y.cjs');
+require('../chunk-PG3WXT3K.cjs');
 require('../chunk-JK4XMMKM.cjs');
 require('../chunk-66IHPTOK.cjs');
 var chunk67OV5CX2_cjs = require('../chunk-67OV5CX2.cjs');
@@ -17,79 +17,79 @@ require('../chunk-VJKZWYYJ.cjs');
 
 Object.defineProperty(exports, "AlreadyRegisteredError", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.AlreadyRegisteredError; }
+  get: function () { return chunkIEKTGJ4J_cjs.AlreadyRegisteredError; }
 });
 Object.defineProperty(exports, "ConfidentialDisperseClient", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.ConfidentialDisperseClient; }
+  get: function () { return chunkIEKTGJ4J_cjs.ConfidentialDisperseClient; }
 });
 Object.defineProperty(exports, "DEFAULT_ADMIN_ROLE", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.DEFAULT_ADMIN_ROLE; }
+  get: function () { return chunkIEKTGJ4J_cjs.DEFAULT_ADMIN_ROLE; }
 });
 Object.defineProperty(exports, "DisperseEncryptedReserveNotGrantedError", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.DisperseEncryptedReserveNotGrantedError; }
+  get: function () { return chunkIEKTGJ4J_cjs.DisperseEncryptedReserveNotGrantedError; }
 });
 Object.defineProperty(exports, "DisperseSubwalletNotFoundError", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.DisperseSubwalletNotFoundError; }
+  get: function () { return chunkIEKTGJ4J_cjs.DisperseSubwalletNotFoundError; }
 });
 Object.defineProperty(exports, "FEE_COLLECTOR_ROLE", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.FEE_COLLECTOR_ROLE; }
+  get: function () { return chunkIEKTGJ4J_cjs.FEE_COLLECTOR_ROLE; }
 });
 Object.defineProperty(exports, "FEE_MANAGER_ROLE", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.FEE_MANAGER_ROLE; }
+  get: function () { return chunkIEKTGJ4J_cjs.FEE_MANAGER_ROLE; }
 });
 Object.defineProperty(exports, "NotRegisteredError", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.NotRegisteredError; }
+  get: function () { return chunkIEKTGJ4J_cjs.NotRegisteredError; }
 });
 Object.defineProperty(exports, "PAUSER_ROLE", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.PAUSER_ROLE; }
+  get: function () { return chunkIEKTGJ4J_cjs.PAUSER_ROLE; }
 });
 Object.defineProperty(exports, "SingletonNotApprovedError", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.SingletonNotApprovedError; }
+  get: function () { return chunkIEKTGJ4J_cjs.SingletonNotApprovedError; }
 });
 Object.defineProperty(exports, "SubwalletsNotApprovedError", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.SubwalletsNotApprovedError; }
+  get: function () { return chunkIEKTGJ4J_cjs.SubwalletsNotApprovedError; }
 });
 Object.defineProperty(exports, "WITHDRAWER_ROLE", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.WITHDRAWER_ROLE; }
+  get: function () { return chunkIEKTGJ4J_cjs.WITHDRAWER_ROLE; }
 });
 Object.defineProperty(exports, "computeSubtotals", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.computeSubtotals; }
+  get: function () { return chunkIEKTGJ4J_cjs.computeSubtotals; }
 });
 Object.defineProperty(exports, "createConfidentialDisperseClient", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.createConfidentialDisperseClient; }
+  get: function () { return chunkIEKTGJ4J_cjs.createConfidentialDisperseClient; }
 });
 Object.defineProperty(exports, "disperseConfidentialAbi", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.disperseConfidentialAbi; }
+  get: function () { return chunkIEKTGJ4J_cjs.disperseConfidentialAbi; }
 });
 Object.defineProperty(exports, "disperseWalletAbi", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.disperseWalletAbi; }
+  get: function () { return chunkIEKTGJ4J_cjs.disperseWalletAbi; }
 });
 Object.defineProperty(exports, "encryptUint64", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.encryptUint64; }
+  get: function () { return chunkIEKTGJ4J_cjs.encryptUint64; }
 });
 Object.defineProperty(exports, "encryptUint64Batch", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.encryptUint64Batch; }
+  get: function () { return chunkIEKTGJ4J_cjs.encryptUint64Batch; }
 });
 Object.defineProperty(exports, "resolveEncryptor", {
   enumerable: true,
-  get: function () { return chunk3YHBO2DL_cjs.resolveEncryptor; }
+  get: function () { return chunkIEKTGJ4J_cjs.resolveEncryptor; }
 });
 Object.defineProperty(exports, "ERC7984_OPERATOR_MAX_DEADLINE", {
   enumerable: true,

package/dist/fhe-disperse/index.js

@@ -1,11 +1,11 @@
-export { AlreadyRegisteredError, ConfidentialDisperseClient, DEFAULT_ADMIN_ROLE, DisperseEncryptedReserveNotGrantedError, DisperseSubwalletNotFoundError, FEE_COLLECTOR_ROLE, FEE_MANAGER_ROLE, NotRegisteredError, PAUSER_ROLE, SingletonNotApprovedError, SubwalletsNotApprovedError, WITHDRAWER_ROLE, computeSubtotals, createConfidentialDisperseClient, disperseConfidentialAbi, disperseWalletAbi, encryptUint64, encryptUint64Batch, resolveEncryptor } from '../chunk-44YJPMQC.js';
+export { AlreadyRegisteredError, ConfidentialDisperseClient, DEFAULT_ADMIN_ROLE, DisperseEncryptedReserveNotGrantedError, DisperseSubwalletNotFoundError, FEE_COLLECTOR_ROLE, FEE_MANAGER_ROLE, NotRegisteredError, PAUSER_ROLE, SingletonNotApprovedError, SubwalletsNotApprovedError, WITHDRAWER_ROLE, computeSubtotals, createConfidentialDisperseClient, disperseConfidentialAbi, disperseWalletAbi, encryptUint64, encryptUint64Batch, resolveEncryptor } from '../chunk-PK6Q6J5F.js';
 export { ERC7984_OPERATOR_MAX_DEADLINE, revokeOperator, setOperator } from '../chunk-4TSDNZQ3.js';
 import '../chunk-WMACINXO.js';
 import '../chunk-ZWXJTBZO.js';
 export { erc7984OperatorAbi } from '../chunk-7VELUOMI.js';
 import '../chunk-NWFMBLSQ.js';
 import '../chunk-4RAAATVY.js';
-import '../chunk-A4DCEE33.js';
+import '../chunk-6HCT4QIX.js';
 import '../chunk-ZA673I3O.js';
 import '../chunk-KWFFIJYX.js';
 export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, OperatorNotApprovedError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError } from '../chunk-QBJ7O2B4.js';