eta withdraw - Umbra CLI

umbra eta withdraw <mint> <amount> [options]

Transfers tokens from your encrypted balance to a public Associated Token Account (ATA). This is the reverse of eta deposit. The Arcium MPC network verifies the withdrawal authorization — the CLI waits for both the handler and the callback transactions to confirm before returning.

Arguments

Argument	Description
`<mint>`	The SPL or Token-2022 mint address
`<amount>`	Amount to withdraw in native token units

Amounts are in base units. For a token with 6 decimals, 1000000 equals 1 token.

Options

Flag	Default	Description
`--destination <address>`	Your own address	Public wallet address to receive the withdrawn tokens.
`--user <name>`	Active user	Run as a specific configured user without changing the global active user.
`--no-await-callback`	`false`	Return immediately after the queue transaction confirms, without waiting for the Arcium MPC callback.

Examples

# Withdraw 50 USDC back to your own wallet
umbra eta withdraw EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 50000000

# Withdraw to a different address
umbra eta withdraw EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 50000000 \
  --destination 9xQe...fK2p

# Return as soon as the queue transaction lands (no callback wait)
umbra eta withdraw EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 50000000 --no-await-callback

Output

✓ Withdrawal complete
  Queue:    3mNr...hJ8k
  Callback: 7pQs...aW4x

Queue is the handler transaction. Callback is the on-chain transaction that finalizes the transfer to your public ATA after MPC processing. When --no-await-callback is passed, only Queue is printed.

Use --no-await-callback in automated pipelines or if the CLI hangs after the on-chain transaction has already landed. The tokens are transferred once the queue transaction confirms — the Arcium callback is processed independently and does not need to be observed by the CLI.

Prerequisites

A user must be added and active (umbra user add), and umbra register must have been run.
An encrypted balance must exist for the specified mint.
The destination ATA must already exist. Create it with standard Solana token tooling if needed.
The withdrawal amount must not exceed your current encrypted balance.

​Arguments

​Options

​Examples

​Output

​Prerequisites

Arguments

Options

Examples

Output

Prerequisites