v2.0.0-rc.1 release candidate

The API is frozen and later candidates carry fixes only, except the receipt-free and Safe create surface of /fhe-airdrop, which is @beta. Published on the next dist-tag; latest stays on 1.6.0 until 2.0.0.

ConfigureuseMutation

useSetDefaultGasFee

Set the per-claim gas fee that new instances default to when their creator has no setCustomFee override.

Import

@tokenops/sdk/fhe-airdrop/advanced/react

Return

{ mutate, mutateAsync, isPending, error, data }

Lifecycle

Configure

Description

Set the per-claim gas fee that new instances default to when their creator has no setCustomFee override.

Requires FEE_MANAGER_ROLE. Affects only instances created afterwards: an instance's gasFee() is baked in at create time, so no deployed campaign's fee changes.

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 usePreflightCreateAirdrop report on this factory, whose fee blockers (the maxGasFee ceiling and GasFeeNotAcceptedError) this write moves.

Signature

@tokenops/sdk/fhe-airdrop/advanced/react

function useSetDefaultGasFee(options?: AirdropClientOptions): UseMutationResult<Hex, Error, SetDefaultGasFeeArgs>;

Parameters

Shape of the object you pass to .mutate(args) is the SDK type SetDefaultGasFeeArgs. Inspect the type for the full shape (discriminated unions collapse to a tagged variant at call time).

Want to run a similar shape interactively? The Playground ships 12 ready presets across vesting / airdrop / disperse / faucet — deploy a manager, create a vesting, claim, and run the product equivalents. The deep-link above auto-selects the closest preset to useSetDefaultGasFee; pick another from the dropdown if you'd rather start there.

Example

@tokenops/sdk/fhe-airdrop/advanced/react · @example

tsx

const setDefaultFee = useSetDefaultGasFee();
await setDefaultFee.mutateAsync({ gasFee: parseEther("0.0001") });

Pulled directly from the hook's TSDoc block — the same snippet your IDE shows on hover.

Errors

This mutation can reject with SDK-level, product-level, or generic-fallback errors. Product classes carry the offending value as fields — render them inline instead of a generic "transaction failed." See Airdrop v2 › Errors for the per-class recovery table.

Invalidation recipe

After this mutation succeeds, invalidate the queries it affects so consumer UI re-fetches fresh state. The SDK never auto-invalidates — that's a consumer decision (different apps cache different shapes).

patterns/invalidation.ts

import { useQueryClient } from "@tanstack/react-query";

const queryClient = useQueryClient();
const setDefaultGasFee = useSetDefaultGasFee(/* options */);

setDefaultGasFee.mutate(args, {
  onSuccess() {
    // Coarse invalidation: refresh every cached read on this product surface.
    queryClient.invalidateQueries({
      queryKey: ["tokenops-sdk", "fhe-airdrop"],
    });
  },
});