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

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

@@ -1,10 +1,10 @@
-import { useMemoAirdropFactoryClient, airdropQueryKey, airdropKeys, airdropQueryKeyPrefix } from '../../../chunk-EYDA6Q6C.js';
-import '../../../chunk-X7WBPCEU.js';
-import '../../../chunk-VW356KR3.js';
+import { useMemoAirdropFactoryClient, airdropKeys, airdropQueryKey } from '../../../chunk-3ZSPRHR3.js';
+import '../../../chunk-67Q6KSVV.js';
+import '../../../chunk-YMWMIWBP.js';
 import '../../../chunk-ZWXJTBZO.js';
-import '../../../chunk-NWFMBLSQ.js';
+import '../../../chunk-7KY4K4PH.js';
 import '../../../chunk-4RAAATVY.js';
-import '../../../chunk-A4DCEE33.js';
+import '../../../chunk-GHGF65LN.js';
 import '../../../chunk-ZA673I3O.js';
 import '../../../chunk-KWFFIJYX.js';
 import { MissingClientError } from '../../../chunk-QBJ7O2B4.js';
@@ -16,12 +16,12 @@ function usePredictEcdsaAirdropAddress(args) {
   const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
   return useQuery({
     ...args.query,
-    queryKey: airdropQueryKey({
-      chainId,
-      address: resolvedAddress,
-      fn: "predictEcdsaAirdropAddress",
-      args: [mode, deployer, userSalt]
-    }),
+    queryKey: airdropKeys.predictEcdsaAddress(
+      { chainId, address: resolvedAddress },
+      mode,
+      deployer,
+      userSalt
+    ),
     queryFn: () => client.predictEcdsaAirdropAddress({ params, mode, deployer, userSalt }),
     enabled: Boolean(client && (args.query?.enabled ?? true))
   });
@@ -31,12 +31,12 @@ function usePredictMerkleAirdropAddress(args) {
   const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(base);
   return useQuery({
     ...args.query,
-    queryKey: airdropQueryKey({
-      chainId,
-      address: resolvedAddress,
-      fn: "predictMerkleAirdropAddress",
-      args: [mode, deployer, userSalt]
-    }),
+    queryKey: airdropKeys.predictMerkleAddress(
+      { chainId, address: resolvedAddress },
+      mode,
+      deployer,
+      userSalt
+    ),
     queryFn: () => client.predictMerkleAirdropAddress({ params, mode, deployer, userSalt }),
     enabled: Boolean(client && (args.query?.enabled ?? true))
   });
@@ -57,12 +57,9 @@ function useClearCompliancePolicy(options = {}) {
         queryKey: airdropKeys.compliancePolicy(scope, variables.creator)
       });
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKey({
-          ...scope,
-          fn: "effectiveDelegateToCompliance",
-          args: [variables.creator]
-        })
+        queryKey: airdropKeys.effectiveDelegateToCompliance(scope, variables.creator)
       });
+      void queryClient.invalidateQueries({ queryKey: airdropKeys.preflightCreateAll(scope) });
     }
   });
 }
@@ -79,11 +76,7 @@ function useClearUpgradeabilityPolicy(options = {}) {
     onSuccess: (_hash, variables) => {
       const scope = { chainId, address: resolvedAddress };
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKey({
-          ...scope,
-          fn: "effectiveUpgradeable",
-          args: [variables.creator]
-        })
+        queryKey: airdropKeys.effectiveUpgradeable(scope, variables.creator)
       });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.upgradeabilityPolicy(scope, variables.creator)
@@ -105,9 +98,15 @@ function useDisableCustomFee(options = {}) {
       return client.disableCustomFee(creator, account);
     },
     onSuccess: (_hash, variables) => {
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.resolvedGasFeeAll({ chainId, address: resolvedAddress })
+      });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.customFee({ chainId, address: resolvedAddress }, variables.creator)
       });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.preflightCreateAll({ chainId, address: resolvedAddress })
+      });
     }
   });
 }
@@ -121,12 +120,7 @@ function useEcdsaInitCodeHash(args) {
     // implementation pointer, which is what this read reports) moves the
     // result. If a future factory version makes params hash-affecting, this
     // key has to grow with it.
-    queryKey: airdropQueryKey({
-      chainId,
-      address: resolvedAddress,
-      fn: "getEcdsaInitCodeHash",
-      args: [mode]
-    }),
+    queryKey: airdropKeys.ecdsaInitCodeHash({ chainId, address: resolvedAddress }, mode),
     queryFn: () => client.getEcdsaInitCodeHash({ params, mode }),
     enabled: Boolean(client && (args.query?.enabled ?? true))
   });
@@ -135,12 +129,7 @@ function useFactoryComplianceDelegate(args = {}) {
   const { client, chainId, resolvedAddress } = useMemoAirdropFactoryClient(args);
   return useQuery({
     ...args.query,
-    queryKey: airdropQueryKey({
-      chainId,
-      address: resolvedAddress,
-      fn: "complianceDelegate",
-      args: []
-    }),
+    queryKey: airdropKeys.complianceDelegate({ chainId, address: resolvedAddress }),
     queryFn: () => client.complianceDelegate(),
     enabled: Boolean(client && (args.query?.enabled ?? true))
   });
@@ -344,12 +333,7 @@ function useMerkleInitCodeHash(args) {
   return useQuery({
     ...args.query,
     // `params` omitted deliberately — see useEcdsaInitCodeHash for why.
-    queryKey: airdropQueryKey({
-      chainId,
-      address: resolvedAddress,
-      fn: "getMerkleInitCodeHash",
-      args: [mode]
-    }),
+    queryKey: airdropKeys.merkleInitCodeHash({ chainId, address: resolvedAddress }, mode),
     queryFn: () => client.getMerkleInitCodeHash({ params, mode }),
     enabled: Boolean(client && (args.query?.enabled ?? true))
   });
@@ -366,12 +350,10 @@ function useSetComplianceDelegate(options = {}) {
     },
     onSuccess: () => {
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKey({
-          chainId,
-          address: resolvedAddress,
-          fn: "complianceDelegate",
-          args: []
-        })
+        queryKey: airdropKeys.complianceDelegate({ chainId, address: resolvedAddress })
+      });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.preflightCreateAll({ chainId, address: resolvedAddress })
       });
     }
   });
@@ -390,6 +372,9 @@ function useSetComplianceManagerImpl(options = {}) {
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.implementations({ chainId, address: resolvedAddress })
       });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.preflightCreateAll({ chainId, address: resolvedAddress })
+      });
     }
   });
 }
@@ -409,12 +394,9 @@ function useSetCompliancePolicy(options = {}) {
         queryKey: airdropKeys.compliancePolicy(scope, variables.creator)
       });
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKey({
-          ...scope,
-          fn: "effectiveDelegateToCompliance",
-          args: [variables.creator]
-        })
+        queryKey: airdropKeys.effectiveDelegateToCompliance(scope, variables.creator)
       });
+      void queryClient.invalidateQueries({ queryKey: airdropKeys.preflightCreateAll(scope) });
     }
   });
 }
@@ -429,9 +411,15 @@ function useSetCustomFee(options = {}) {
       return client.setCustomFee(creator, gasFee, account);
     },
     onSuccess: (_hash, variables) => {
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.resolvedGasFeeAll({ chainId, address: resolvedAddress })
+      });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.customFee({ chainId, address: resolvedAddress }, variables.creator)
       });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.preflightCreateAll({ chainId, address: resolvedAddress })
+      });
     }
   });
 }
@@ -447,15 +435,17 @@ function useSetDefaultDelegateToCompliance(options = {}) {
     },
     onSuccess: () => {
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({
+        queryKey: airdropKeys.effectiveDelegateToComplianceAll({
           chainId,
-          address: resolvedAddress,
-          fn: "effectiveDelegateToCompliance"
+          address: resolvedAddress
         })
       });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.compliancePolicyAll({ chainId, address: resolvedAddress })
       });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.preflightCreateAll({ chainId, address: resolvedAddress })
+      });
     }
   });
 }
@@ -470,9 +460,38 @@ function useSetDefaultGasFee(options = {}) {
       return client.setDefaultGasFee(gasFee, account);
     },
     onSuccess: () => {
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.resolvedGasFeeAll({ chainId, address: resolvedAddress })
+      });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.fees({ chainId, address: resolvedAddress })
       });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.preflightCreateAll({ chainId, address: resolvedAddress })
+      });
+    }
+  });
+}
+function useSetMaxGasFee(options = {}) {
+  const { client, resolutionError, chainId, resolvedAddress } = useMemoAirdropFactoryClient(options);
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async ({ maxGasFee, account }) => {
+      if (!client) {
+        throw resolutionError ?? new MissingClientError("useSetMaxGasFee", "factory");
+      }
+      return client.setMaxGasFee(maxGasFee, account);
+    },
+    onSuccess: () => {
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.fees({ chainId, address: resolvedAddress })
+      });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.resolvedGasFeeAll({ chainId, address: resolvedAddress })
+      });
+      void queryClient.invalidateQueries({
+        queryKey: airdropKeys.preflightCreateAll({ chainId, address: resolvedAddress })
+      });
     }
   });
 }
@@ -489,7 +508,7 @@ function useSetDefaultUpgradeable(options = {}) {
     onSuccess: () => {
       const scope = { chainId, address: resolvedAddress };
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({ ...scope, fn: "effectiveUpgradeable" })
+        queryKey: airdropKeys.effectiveUpgradeableAll(scope)
       });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.upgradeabilityPolicyAll(scope)
@@ -513,12 +532,8 @@ function useSetEcdsaImplementation(options = {}) {
     onSuccess: () => {
       const scope = { chainId, address: resolvedAddress };
       void queryClient.invalidateQueries({ queryKey: airdropKeys.implementations(scope) });
-      void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({ ...scope, fn: "getEcdsaInitCodeHash" })
-      });
-      void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({ ...scope, fn: "predictEcdsaAirdropAddress" })
-      });
+      void queryClient.invalidateQueries({ queryKey: airdropKeys.ecdsaInitCodeHashAll(scope) });
+      void queryClient.invalidateQueries({ queryKey: airdropKeys.predictEcdsaAddressAll(scope) });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.preflightCreateAll(scope)
       });
@@ -555,12 +570,8 @@ function useSetMerkleImplementation(options = {}) {
     onSuccess: () => {
       const scope = { chainId, address: resolvedAddress };
       void queryClient.invalidateQueries({ queryKey: airdropKeys.implementations(scope) });
-      void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({ ...scope, fn: "getMerkleInitCodeHash" })
-      });
-      void queryClient.invalidateQueries({
-        queryKey: airdropQueryKeyPrefix({ ...scope, fn: "predictMerkleAirdropAddress" })
-      });
+      void queryClient.invalidateQueries({ queryKey: airdropKeys.merkleInitCodeHashAll(scope) });
+      void queryClient.invalidateQueries({ queryKey: airdropKeys.predictMerkleAddressAll(scope) });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.preflightCreateAll(scope)
       });
@@ -580,11 +591,7 @@ function useSetUpgradeabilityPolicy(options = {}) {
     onSuccess: (_hash, variables) => {
       const scope = { chainId, address: resolvedAddress };
       void queryClient.invalidateQueries({
-        queryKey: airdropQueryKey({
-          ...scope,
-          fn: "effectiveUpgradeable",
-          args: [variables.creator]
-        })
+        queryKey: airdropKeys.effectiveUpgradeable(scope, variables.creator)
       });
       void queryClient.invalidateQueries({
         queryKey: airdropKeys.upgradeabilityPolicy(scope, variables.creator)
@@ -596,4 +603,4 @@ function useSetUpgradeabilityPolicy(options = {}) {
   });
 }
 
-export { useClearCompliancePolicy, useClearUpgradeabilityPolicy, useDisableCustomFee, useEcdsaInitCodeHash, useFactoryComplianceDelegate, useFactoryCompliancePolicy, useFactoryCustomFee, useFactoryGrantRole, useFactoryHasRole, useFactoryImplementations, useFactoryRenounceRole, useFactoryRevokeRole, useFactoryRoleConstants, useFactoryRoleMembers, useFactoryUpgradeabilityPolicy, useMerkleInitCodeHash, usePredictEcdsaAirdropAddress, usePredictMerkleAirdropAddress, useSetComplianceDelegate, useSetComplianceManagerImpl, useSetCompliancePolicy, useSetCustomFee, useSetDefaultDelegateToCompliance, useSetDefaultGasFee, useSetDefaultUpgradeable, useSetEcdsaImplementation, useSetFeeCollector, useSetMerkleImplementation, useSetUpgradeabilityPolicy };
+export { useClearCompliancePolicy, useClearUpgradeabilityPolicy, useDisableCustomFee, useEcdsaInitCodeHash, useFactoryComplianceDelegate, useFactoryCompliancePolicy, useFactoryCustomFee, useFactoryGrantRole, useFactoryHasRole, useFactoryImplementations, useFactoryRenounceRole, useFactoryRevokeRole, useFactoryRoleConstants, useFactoryRoleMembers, useFactoryUpgradeabilityPolicy, useMerkleInitCodeHash, usePredictEcdsaAirdropAddress, usePredictMerkleAirdropAddress, useSetComplianceDelegate, useSetComplianceManagerImpl, useSetCompliancePolicy, useSetCustomFee, useSetDefaultDelegateToCompliance, useSetDefaultGasFee, useSetDefaultUpgradeable, useSetEcdsaImplementation, useSetFeeCollector, useSetMaxGasFee, useSetMerkleImplementation, useSetUpgradeabilityPolicy };

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

@@ -17,7 +17,9 @@ export interface ClearCompliancePolicyArgs extends WriteAccountOverride {
  * the override had been.
  *
  * **Invalidates:** `fn "compliancePolicy"` and
- * `fn "effectiveDelegateToCompliance"`, both keyed on `args.creator`.
+ * `fn "effectiveDelegateToCompliance"`, both keyed on `args.creator`, and every
+ * cached {@link usePreflightCreateAirdrop} report on this factory, whose
+ * `commitments.complianceDelegate` this write moves.
  *
  * @example
  * const clearPolicy = useClearCompliancePolicy();

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

@@ -14,7 +14,10 @@ export interface DisableCustomFeeArgs extends WriteAccountOverride {
  * Requires `FEE_MANAGER_ROLE`.
  *
  * **Invalidates:** `useFactoryCustomFee({ creator })` for the TARGET creator -
- * `variables.creator`, never the sending admin.
+ * `variables.creator`, never the sending admin. Also every `useResolveGasFee`
+ * entry: dropping the override sends this creator back to the default. Also every
+ * cached {@link usePreflightCreateAirdrop} report on this factory, whose
+ * fee blockers (the `maxGasFee` ceiling and `GasFeeNotAcceptedError`) this write moves.
  *
  * @example
  * const disableCustomFee = useDisableCustomFee();

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

@@ -7,10 +7,8 @@ export type UseFactoryComplianceDelegateArgs = AirdropHookOptions<Address>;
  * The platform-designated compliance delegate the FACTORY wires into every
  * new compliance-manager clone.
  *
- * Deliberately unbundled: its being set is what gates
- * {@link useSetDefaultDelegateToCompliance} with `on: true` (that write
- * reverts `ZeroComplianceDelegate` against the zero address), so an admin
- * panel reads it alone to decide whether to enable the toggle at all.
+ * Never zero: the constructor seeds it and `setComplianceDelegate` rejects zero. Read it
+ * to show which platform delegate policy-ON creates will wire.
  *
  * **Not** `ComplianceManagerClient.complianceDelegate()`. That method has the
  * same name on a different contract and returns the delegate one already-

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

@@ -16,9 +16,10 @@ export interface FactoryRenounceRoleArgs extends WriteAccountOverride {
  * resolved sending account. To remove a role from somebody else use
  * {@link useFactoryRevokeRole}.
  *
- * **No floor stops a sole admin renouncing here**, unlike an airdrop instance's
- * `LastAdmin` guard. A sole `DEFAULT_ADMIN_ROLE` holder renouncing freezes role
- * administration permanently; grant a successor first.
+ * **A sole `DEFAULT_ADMIN_ROLE` holder cannot renounce** (audit-14): the factory
+ * carries the same `LastAdmin` floor the instances do, so the call reverts
+ * instead of freezing role administration permanently. Grant the successor
+ * first, then renounce.
  *
  * **Invalidates:** every {@link useFactoryHasRole} entry for this factory
  * (prefix, all role/holder pairs), plus its {@link useFactoryRoleMembers} entry

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

@@ -14,13 +14,15 @@ export interface FactoryRevokeRoleArgs extends WriteAccountOverride {
  *
  * Requires `DEFAULT_ADMIN_ROLE`, which administers all five factory roles.
  *
- * **The factory declares no "never empty" floor.** Revoking the last
- * `DEFAULT_ADMIN_ROLE` holder succeeds and permanently freezes role
- * administration - no role can ever be granted or revoked again, including
- * putting an admin back. The four operational roles keep working for whoever
- * already holds them, with no way to rotate them. On the live deployment all
- * five roles sit on one key, so show {@link useFactoryRoleMembers}'s `count`
- * next to the button and grant the successor first.
+ * **`DEFAULT_ADMIN_ROLE` is floored at one live member** (audit-14). Revoking
+ * the last holder reverts `LastAdmin` rather than succeeding and freezing role
+ * administration, which is what it used to do. Granting the role to the zero
+ * address reverts `ZeroAdminGrant`, so the floor cannot be satisfied with a
+ * member nobody controls either.
+ *
+ * On the live deployment all five roles sit on one key, so a handover is two
+ * steps: grant the successor, then revoke. Show {@link useFactoryRoleMembers}'s
+ * `count` next to the button and disable it at `1n`.
  *
  * **Invalidates:** this factory's {@link useFactoryHasRole} entry for exactly
  * `(role, holder)` and its {@link useFactoryRoleMembers} entry for `role`.

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

@@ -26,10 +26,11 @@ export interface UseFactoryRoleMembersArgs extends AirdropHookOptions<FactoryRol
  * trusting a fixed string that describes one deployment at one moment.
  *
  * `count` is bundled with the list rather than split into its own hook because
- * it is what a UI needs in the same render to decide whether a revoke is safe -
- * the factory declares no "never empty" floor, so revoking the last
- * `DEFAULT_ADMIN_ROLE` holder succeeds and permanently freezes all role
- * administration.
+ * it is what a UI needs in the same render to decide whether a revoke will be
+ * accepted: since audit-14 the factory floors `DEFAULT_ADMIN_ROLE` at one live
+ * member, so revoking or renouncing the last holder reverts `LastAdmin`.
+ * Disable the button at `count === 1n` rather than letting the user burn gas
+ * discovering it.
  *
  * Unpaginated: factory role sets are operator-sized, not user-sized.
  *
@@ -40,7 +41,7 @@ export interface UseFactoryRoleMembersArgs extends AirdropHookOptions<FactoryRol
  *
  * @example
  * const { data } = useFactoryRoleMembers({ role: roles?.DEFAULT_ADMIN_ROLE });
- * const lastAdmin = data?.count === 1n;
+ * const lastAdmin = data?.count === 1n; // revoke/renounce would revert LastAdmin
  *
  * @alpha
  */

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

@@ -11,18 +11,18 @@ export interface SetComplianceDelegateArgs extends WriteAccountOverride {
  * Set the platform-designated compliance delegate that every new
  * compliance-manager clone wires in. Requires `COMPLIANCE_WIRING_ROLE`.
  *
- * **Ordering is load-bearing.** Call this before
- * {@link useSetDefaultDelegateToCompliance} with `on: true` - turning
- * delegation on while no delegate is set reverts `ZeroComplianceDelegate`. An
- * admin panel must sequence the two writes, and read
- * {@link useFactoryComplianceDelegate} to decide whether the toggle is even
- * offerable.
+ * The factory's constructor seeded a non-zero delegate with delegation ON, so this only
+ * rotates it: it can never be cleared, and the zero address always reverts
+ * `ZeroComplianceDelegate`. There is no ordering against
+ * {@link useSetDefaultDelegateToCompliance}.
  *
  * Applies to FUTURE clones only; it cannot retro-wire managers that already
  * exist.
  *
  * **Invalidates:** the factory's `fn "complianceDelegate"` entry
- * ({@link useFactoryComplianceDelegate}).
+ * ({@link useFactoryComplianceDelegate}), and every cached
+ * {@link usePreflightCreateAirdrop} report on this factory, whose
+ * `commitments.complianceDelegate` this write moves.
  *
  * @example
  * const setDelegate = useSetComplianceDelegate();

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

@@ -16,7 +16,9 @@ export interface SetComplianceManagerImplArgs extends WriteAccountOverride {
  * fleet-wide upgrade.
  *
  * **Invalidates:** the factory's `fn "implementations"` entry, which carries
- * `complianceManagerImpl` alongside the ECDSA/Merkle pointers.
+ * `complianceManagerImpl` alongside the ECDSA/Merkle pointers, and every cached
+ * {@link usePreflightCreateAirdrop} report on this factory, whose
+ * `commitments.complianceManagerImpl` this write moves.
  *
  * @example
  * const setImpl = useSetComplianceManagerImpl();

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

@@ -17,7 +17,8 @@ export interface SetCompliancePolicyArgs extends WriteAccountOverride {
  * `fn "effectiveDelegateToCompliance"`, both keyed on `args.creator` - the
  * TARGET creator, never the sending admin. Keying on the sender would leave
  * the panel's view of the creator it just edited stale while invalidating an
- * entry nobody rendered.
+ * entry nobody rendered. Also every cached {@link usePreflightCreateAirdrop}
+ * report on this factory, whose `commitments.complianceDelegate` this write moves.
  *
  * @example
  * const setPolicy = useSetCompliancePolicy();

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

@@ -17,7 +17,10 @@ export interface SetCustomFeeArgs extends WriteAccountOverride {
  * **Invalidates:** `useFactoryCustomFee({ creator })` for the TARGET creator -
  * `variables.creator`, never the sending admin. `account` is the submitter and
  * has no cache entry of its own here, so keying the invalidation off it would
- * refresh the wrong row and leave the edited one stale.
+ * refresh the wrong row and leave the edited one stale. Also every
+ * `useResolveGasFee` entry, since an override is what that hook resolves, and every
+ * cached {@link usePreflightCreateAirdrop} report on this factory, whose
+ * fee blockers (the `maxGasFee` ceiling and `GasFeeNotAcceptedError`) this write moves.
  *
  * @example
  * const setCustomFee = useSetCustomFee();

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

@@ -11,16 +11,17 @@ export interface SetDefaultDelegateToComplianceArgs extends WriteAccountOverride
  * Set the factory-wide default for whether new instances delegate compliance
  * disclosure to the platform delegate. Requires `COMPLIANCE_WIRING_ROLE`.
  *
- * **Ordering is load-bearing.** `on: true` reverts `ZeroComplianceDelegate`
- * unless {@link useSetComplianceDelegate} has already set a delegate - read
- * {@link useFactoryComplianceDelegate} first and sequence the two writes.
+ * The default starts ON at factory construction; `on: false` is the deliberate
+ * global opt-out. A per-creator {@link useSetCompliancePolicy} override still wins.
  *
  * **Invalidates:** the `fn "effectiveDelegateToCompliance"` PREFIX and the
  * `fn "compliancePolicy"` PREFIX - every cached creator at once, because this
  * write is chain-wide: any creator without an override moves with the
  * default, and {@link useFactoryCompliancePolicy}'s bundle carries the
  * resolved `effective` field. Contrast {@link useSetCompliancePolicy}, which
- * stays keyed on the one creator it targets.
+ * stays keyed on the one creator it targets. Also every cached
+ * {@link usePreflightCreateAirdrop} report on this factory, whose
+ * `commitments.complianceDelegate` this write moves.
  *
  * @example
  * const setDefault = useSetDefaultDelegateToCompliance();

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

@@ -15,9 +15,13 @@ export interface SetDefaultGasFeeArgs extends WriteAccountOverride {
  * instance's `gasFee()` is baked in at create time, so no deployed campaign's
  * fee changes.
  *
- * **Invalidates:** this factory's `useFactoryFees` entry (fn `"fees"`) only.
- * Deliberately NOT any instance's fn `"gasFee"` key - those are immutable
- * per instance and invalidating them would refetch unchanged values.
+ * **Invalidates:** this factory's `useFactoryFees` entry (fn `"fees"`) and every
+ * `useResolveGasFee` entry - the default is what resolves for every creator
+ * without an override, so all of them move at once. Deliberately NOT any
+ * instance's fn `"gasFee"` key: those are frozen at create and invalidating
+ * them would refetch unchanged values. Also every cached
+ * {@link usePreflightCreateAirdrop} report on this factory, whose
+ * fee blockers (the `maxGasFee` ceiling and `GasFeeNotAcceptedError`) this write moves.
  *
  * @example
  * const setDefaultFee = useSetDefaultGasFee();

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

@@ -0,0 +1,37 @@
+import { type UseMutationResult } from "@tanstack/react-query";
+import type { Hex } from "viem";
+import type { WriteAccountOverride } from "../../airdrop-base.js";
+import { type AirdropClientOptions } from "../../react/_shared.js";
+/** @alpha */
+export interface SetMaxGasFeeArgs extends WriteAccountOverride {
+    /** The factory-wide ceiling in wei, `uint96` on-chain. `0n` admits only a zero fee. */
+    maxGasFee: bigint;
+}
+/**
+ * Set the factory's ceiling on every fee `setDefaultGasFee` / `setCustomFee` may
+ * configure, and on the fee resolved at create.
+ *
+ * Requires `DEFAULT_ADMIN_ROLE`, deliberately not `FEE_MANAGER_ROLE` (audit-09):
+ * the fee manager moves fees only within a bound the admin owns. This is the
+ * one fee control that is not a fee-manager operation.
+ *
+ * **Lowering it does not rewrite an already-configured fee.** The stale value
+ * stays in storage and reverts `GasFeeExceedsMaximum` at the next create until
+ * it is lowered too, so a reduction is two steps, not one.
+ *
+ * **Invalidates:** this factory's `useFactoryFees` entry (fn `"fees"`, which
+ * carries `maxGasFee`) and every `useResolveGasFee` entry. The ceiling is checked
+ * at create time, and lowering it below existing fees is allowed: a create whose
+ * resolved fee is above it then reverts `GasFeeExceedsMaximum`. Deliberately NOT
+ * any instance's fn `"gasFee"` key - an instance's fee is frozen at create and
+ * cannot move. Also every cached {@link usePreflightCreateAirdrop} report on this
+ * factory: the preflight reports a resolved fee above the ceiling as a blocker,
+ * so the new ceiling must reach it.
+ *
+ * @example
+ * const setCeiling = useSetMaxGasFee();
+ * await setCeiling.mutateAsync({ maxGasFee: parseEther("0.5") });
+ *
+ * @alpha
+ */
+export declare function useSetMaxGasFee(options?: AirdropClientOptions): UseMutationResult<Hex, Error, SetMaxGasFeeArgs>;