Skip to main content

Documentation Index

Fetch the complete documentation index at: https://umbra.0xcreator.dev/llms.txt

Use this file to discover all available pages before exploring further.

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

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

​
Options

FlagDefaultDescription
--allfalseQuery every token supported by the relayer in one call.
--user <name>Active userRun 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:
StateMeaning
A numberYour 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
uninitializedAn encrypted account exists for this mint but has never received a deposit
no balance — deposit firstNo 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).