privacy balance
Inspect private balances for tracked or explicit ERC20 tokens on a privacy-capable chain.
Usage
$ beam --chain payy-testnet privacy balance [token|token-address]
With no argument, prints private balances for every tracked token on the selected chain. With a token argument, prints just that token's private balance.
Examples
$ beam --chain payy-testnet privacy balance
$ beam --chain payy-testnet privacy balance USDC
$ beam --chain payy-testnet privacy balance native
$ beam --chain payy-testnet privacy balance 0x0200000000000000000000000000000000000000
native token
Built-in Payy privacy chains expose the PUSD predeploy at 0x0200000000000000000000000000000000000000 as the label native, so you can use native anywhere a token argument is accepted on those chains.
Flags
--from <wallet|address|ens>— pick a different wallet for this command.--format json— emit a structured payload (private address, balances, scan cursor).
Resume cache
Private balances rely on a local resume cache at ~/.beam/privacy-state.json for owned-note checkpoints and scan progress. The cache is a hint, not the authority — Beam revalidates cached checkpoints and live bridge state before returning a spendable balance. See privacy state for repair/reset commands.