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

ArgumentDescription
<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

FlagDefaultDescription
--destination <address>Your own addressPublic wallet address to receive the withdrawn tokens.
--user <name>Active userRun as a specific configured user without changing the global active user.
--no-await-callbackfalseReturn 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.