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.

IntrospectionuseMutation

useSetEcdsaImplementation

Point future createEcdsaAirdrop* calls at a new ECDSA implementation.

Import

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

Return

{ mutate, mutateAsync, isPending, error, data }

Lifecycle

Introspection

Description

Point future createEcdsaAirdrop* calls at a new ECDSA implementation.

Requires IMPL_MANAGER_ROLE. Deployed instances are untouched - a clone stays bound to the implementation live when it was created.

Moving this pointer moves every future predicted address. Any campaign plan built before this write is stale, and on an immutable-root instance its entries would be unclaimable; that is what PredictionDriftError exists to catch.

Invalidates: useFactoryImplementations (fn "implementations"), plus the fn "getEcdsaInitCodeHash", "predictEcdsaAirdropAddress" and `preflightCreate` PREFIXES - every cached args combination of each, because the init-code hash, the predicted address and the create preflight all shift together with the pointer. Invalidating the predictions is what stops a mounted UI offering a dead address.

Signature

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

function useSetEcdsaImplementation(options?: AirdropClientOptions): UseMutationResult<Hex, Error, SetEcdsaImplementationArgs>;

Parameters

Shape of the object you pass to .mutate(args) is the SDK type SetEcdsaImplementationArgs. 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 useSetEcdsaImplementation; pick another from the dropdown if you'd rather start there.

Example

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

tsx

const setEcdsaImpl = useSetEcdsaImplementation();
await setEcdsaImpl.mutateAsync({ implementation: newEcdsaImpl });

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 setEcdsaImplementation = useSetEcdsaImplementation(/* options */);

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