> ## 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.

# eta balance

> Check your encrypted token balances.

```bash theme={null}
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

```bash theme={null}
# 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`).