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

useUnderlyingBalance

Read the plaintext underlying TokenopsTestToken (TTT) balance for account (defaults to the connected wallet), in TTT 18-decimal base units.

Import

@tokenops/sdk/testnet-faucet/react

Return

{ data, isLoading, error, refetch }

Lifecycle

Read

Query Key

Faucet read hooks use the public constants TESTNET_FAUCET_KEY and TESTNET_FAUCET_NAMESPACE. The method segment for this hook is underlyingBalanceOf.

@tokenops/sdk/testnet-faucet/react

queryKey: [
  "tokenops-sdk", // TESTNET_FAUCET_KEY
  "testnet-faucet", // TESTNET_FAUCET_NAMESPACE
  "underlyingBalanceOf",
  chainId ?? null,
  address ? address.toLowerCase() : null,
  // hook-specific args normalized: bigint -> decimal string, 0x strings -> lowercase
];

Description

Read the plaintext underlying TokenopsTestToken (TTT) balance for account (defaults to the connected wallet), in TTT 18-decimal base units.

Signature

@tokenops/sdk/testnet-faucet/react

function useUnderlyingBalance(args?: UseUnderlyingBalanceArgs): UseQueryResult<bigint, Error>;

Parameters

Shape of the options object passed to the hook itself.

Property	Type	Description
account	Address	Account whose underlying TTT balance to read. Defaults to the connected wallet (wagmi v2 `useAccount().address` / v3 `useConnection().address`). The hook stays disabled until an account is available.

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 useUnderlyingBalance; pick another from the dropdown if you'd rather start there.

Example

@tokenops/sdk/testnet-faucet/react · @example

tsx

const { data: balance } = useUnderlyingBalance(); // my own TTT balance

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