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 utxo create <mint> <amount> [options]
Creates a stealth UTXO in the Umbra mixer. UTXOs are anonymous token commitments — they can be claimed later by you or by a recipient you specify. Tokens can be sourced from your public ATA (--from public, the default) or from your encrypted balance (--from encrypted). The created UTXO can be self-claimable (you can claim it yourself) or receiver-claimable (only the specified recipient can claim it).

​
Arguments

ArgumentDescription
<mint>The SPL or Token-2022 mint address
<amount>Amount in native token units
Amounts are in base units. For a token with 6 decimals, 1000000 equals 1 token.

​
Options

FlagDefaultDescription
--from <source>publicToken source: public (your ATA) or encrypted (your encrypted balance)
--receiver <address>Your own addressRecipient wallet address. Omit to create a self-claimable UTXO.

​
Modes

--from--receiverResult
public(omitted)Self-claimable UTXO funded from your public ATA
public<address>Receiver-claimable UTXO funded from your public ATA
encrypted(omitted)Self-claimable UTXO funded from your encrypted balance
encrypted<address>Receiver-claimable UTXO funded from your encrypted balance

​
Examples

# Self-claimable UTXO from your public ATA
umbra utxo create EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 1000000

# Send a UTXO to another user (they claim it, you pay from your ATA)
umbra utxo create EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 1000000 \
  --receiver GsbwXfJraMomNxBcpR3DBFyKCCmN9SKGzKFJBNKxRFkT

# Self-claimable UTXO from your encrypted balance
umbra utxo create EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 1000000 \
  --from encrypted

# Send from your encrypted balance to another user
umbra utxo create EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 1000000 \
  --from encrypted \
  --receiver GsbwXfJraMomNxBcpR3DBFyKCCmN9SKGzKFJBNKxRFkT

​
Output

From public ATA: 
✓ UTXO created
  Proof account: 4hKr...mP3n
  Create:        7xWq...aB9c
From encrypted balance: 
✓ UTXO created
  Proof account: 4hKr...mP3n
  Queue:         2nFp...jK7m
  Callback:      9aLr...tQ4w
When sourcing from an encrypted balance, the dual-instruction MPC pattern applies: a queue transaction is submitted first, then the Arcium network processes it and fires a callback. Both signatures are shown.

​
Prerequisites

  • A user must be added and active (umbra user add).
  • umbra register must have been run.
  • For --from encrypted: you must have an encrypted balance for the specified mint.
  • The recipient (your own or --receiver) must be a registered Umbra user.