2.0 RC docsView 1.x docs
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.
ReaduseQuery

usePreflightCreateVesting

Read-only preflight for useCreateVesting / useBatchCreateVesting — wraps ConfidentialVestingManagerClient.preflightCreateVesting as a TanStack query.

Import
@tokenops/sdk/fhe-vesting/react
Return
{ data, isLoading, error, refetch }
Lifecycle
Read

Description

Read-only preflight for useCreateVesting / useBatchCreateVesting — wraps ConfidentialVestingManagerClient.preflightCreateVesting as a TanStack query.

The report carries token, hasCreatorRole, isOperatorSet, ready and blockerErrors (typed TokenOpsSdkErrors; branch on error.code).

Checks: structural params validation, VESTING_CREATOR_ROLE membership, and ERC-7984 operator approval of the manager on the distribution token. The creator's confidential token balance is NOT checked (encrypted; an underfunded create silently zeroes amounts instead of reverting) — see the headless method's TSDoc.

Hook is disabled until params and creator are both set. Refetch after the user grants the role or calls setOperator (e.g. via queryClient.invalidateQueries or query: { refetchInterval: 5_000 }).

Signature

@tokenops/sdk/fhe-vesting/react
ts
function usePreflightCreateVesting(args: UsePreflightCreateVestingArgs): UseQueryResult<CreateVestingPreflightReport, Error>;

Parameters

Shape of the options object passed to the hook itself.

PropertyTypeDescription
paramsVestingParamsThe vesting schedule parameters to validate.
creatorAddressThe address that will send the create transaction.
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 usePreflightCreateVesting; pick another from the dropdown if you'd rather start there.

Example

@tokenops/sdk/fhe-vesting/react · @example
tsx
const { data: report } = usePreflightCreateVesting({
  address: managerAddress, params, creator,
});
if (report?.ready) { /* enable submit *\/ }

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

See also

Other Read hooks in vesting 2.0: