usePreflightDisperse

Comprehensive pre-flight report — one call gives a UI everything it needs to render a "ready to disperse" checklist: registration state, wallet approvals, fee preview, batch-limit and input-proof cap check, per-recipient validation, pre-computed wallet-mode subtotals, and a ready flag plus typed blockerErrors.

Hook is disabled until user, token, recipients, amounts, and mode are all set.

Amount units: TokenOps confidential (ERC-7984) tokens use a 6-decimals convention (1 token = 1_000_000 base units), not the 18 decimals typical of ERC-20. Amount parameters are base units of the token's actual decimals: for the CTTT test token (6 decimals) 1_000_000n = 1 CTTT, while the transparent TTT test token uses 18 decimals. Pass amounts[] in the same units you will pass to useDisperse so the report reflects the real call. The query key holds a salted keccak256 digest of amounts, never the plaintext values. The salt is drawn once per page or process by design, so a key built during SSR never matches the client's and a key from a persisted cache never matches the next session's: a preflight result is not restored through hydration or a cache persister, and always runs fresh.

For live dashboards, set refetchInterval so the report stays current as the user toggles approvals in a wallet UI:

const preflight = usePreflightDisperse({
  user, token, recipients, amounts, mode,
  query: { refetchInterval: 5_000 },
});