eta balance - Umbra CLI

umbra eta balance <mint> [mint...] [options]

Fetches and decrypts your encrypted token balances for one or more mints. For accounts in Shared mode (X25519 key registered), the balance is decrypted locally using your key and displayed in base units.

Arguments

Argument	Description
`<mint> [mint...]`	One or more SPL or Token-2022 mint addresses. Omit to pick interactively.

Options

Flag	Default	Description
`--all`	`false`	Query every token supported by the relayer in one call.
`--user <name>`	Active user	Run as a specific configured user without changing the global active user. Useful when running concurrent balance checks across multiple users in automation.

Examples

# Check a single mint
umbra eta balance EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# Check multiple mints at once
umbra eta balance \
  EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  So11111111111111111111111111111111111111112

# Query all relayer-supported tokens
umbra eta balance --all

# Check balance for a specific user (without switching the active user)
umbra eta balance EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --user alice

Output

✓ Encrypted balances
  EPjF…Dt1v  100000000
  So11…1112  MXE mode (cannot decrypt client-side)

Each row shows a shortened mint address and either:

State	Meaning
A number	Your decrypted balance in base units (Shared mode)
`MXE mode (cannot decrypt client-side)`	Balance is encrypted for the Arcium MPC network only — run `umbra register --confidential` first to enable client-side decryption
`uninitialized`	An encrypted account exists for this mint but has never received a deposit
`no balance — deposit first`	No encrypted account exists for this mint yet

Prerequisites

A user must be added and active (umbra user add), and umbra register must have been run.
For decryptable balances, your account must have an X25519 key registered (umbra register --confidential or the default umbra register).

​Arguments

​Options

​Examples

​Output

​Prerequisites

Arguments

Options

Examples

Output

Prerequisites