Onyx Wallet is the wallet infrastructure attached to your Onyx account.
It is used for:
- wallet creation
- wallet connection
- asset storage
- transfers
- swaps
- payment activity
- card funding
- FX-related flows
- wallet-backed payment actions
- private balance and transaction support where enabled
The wallet stays connected to the same account used for:
- mobile service
- identity
- verification
- renewals
- support
- connected payment features
Wallet
Wallet operations surface
Review wallet setup, recovery, receive, send, and swap states from account-linked fixture patterns.
Wallet
Native account-linked
Backup
Required before full use
State
Created, backup required, active
Wallet actions remain tied to account readiness and recovery state.
Wallet Types
Depending on account state and supported regions, Onyx can support:
- native account-linked wallets
- connected external wallets
- imported wallets where supported
- recovery-based wallet restoration
Wallet support depends on:
- supported chains
- custody model
- regional availability
- provider readiness
- verification state
- enabled payment features
Some wallet flows remain unavailable until:
- backup is confirmed
- verification completes
- recovery finishes
- account setup is complete
Wallet Setup
Your account can show:
- create wallet
- connect wallet
- recover wallet
- continue setup
- backup required
- wallet unavailable
Some wallet setups create a native Onyx-linked wallet automatically during onboarding. Other flows allow external wallet connection after account creation.
Depending on the wallet configuration, setup can require:
- recovery phrase confirmation
- secure backup confirmation
- device approval
- password or biometric setup
- linked recovery method confirmation
Wallet creation can fail if:
- chain support is unavailable
- provider services are degraded
- verification is incomplete
- wallet setup is interrupted
- the account is under review
Supported Chains And Assets
Wallet functionality depends on supported blockchain networks and supported assets.
Support can vary by:
- region
- wallet type
- payment rail
- provider support
- asset restrictions
- privacy mode compatibility
Some assets may support:
- receive only
- send and receive
- swaps
- card funding
- private mode transfers
Other assets may remain unavailable for:
- swaps
- FX conversion
- card settlement
- privacy-enabled transfers
The app should show supported actions before a transaction begins.
Receiving Assets
Your wallet can display receive addresses for supported chains and assets.
Before receiving funds, confirm:
- the correct asset
- the correct network
- the correct chain
- the supported address format
Sending unsupported assets or using the wrong network can result in:
- failed settlement
- delayed recovery
- unrecoverable transfers
Receive addresses can vary depending on:
- chain
- custody configuration
- account region
- wallet recovery state
- enabled privacy features
Some receive addresses may rotate or refresh depending on wallet configuration.
Sending Assets
Send actions require:
- an active wallet
- sufficient balance
- supported chain compatibility
- transaction signing approval
- wallet connectivity
Before confirming a transfer, review:
- destination address
- selected network
- transaction amount
- estimated fees
- transaction timing
Some transfers may require:
- additional verification
- reauthentication
- biometric approval
- wallet reconnect
- cooldown confirmation
- payment rail review
Transfers can fail if:
- balance is insufficient
- the destination chain is unsupported
- the transaction expires
- signing approval is interrupted
- the provider rejects settlement
- congestion delays confirmation
- wallet recovery remains incomplete
Swap Support
Swap functionality depends on:
- supported chains
- supported assets
- available liquidity
- provider availability
- regional restrictions
Before confirming a swap, the app can show:
- source asset
- destination asset
- quoted rate
- estimated fees
- slippage
- expiration window
Quotes can expire before confirmation depending on:
- network congestion
- liquidity movement
- provider timing
- wallet signing delays
Some swaps may temporarily lock balances until the transaction either confirms or fails.
Wallet Activity
Your wallet activity can include:
- receives
- sends
- swaps
- payment settlement
- card funding
- FX activity
- pending transactions
- failed transactions
Activity states can include:
- created
- awaiting signature
- submitted
- confirming
- syncing
- completed
- failed
- cancelled
- expired
Blockchain confirmation timing can vary depending on:
- chain congestion
- provider indexing
- validator conditions
- network synchronization
- wallet connectivity
Some transactions may appear delayed while confirmations or indexing complete.
Wallet States
Your wallet can appear as:
- setup required
- created
- backup required
- backup confirmed
- active
- suspended
- recovery required
- archived
Wallet connectivity can appear as:
- connected
- disconnected
- reconnect required
- expired
Recovery state can appear as:
- none
- ready
- pending
- in progress
- restored
- failed
Some payment actions remain blocked until:
- backup completes
- recovery completes
- verification refreshes
- wallet reconnects successfully
Backup And Recovery
Wallet recovery behavior depends on:
- custody model
- backup state
- recovery configuration
- linked authentication methods
- supported chains
Recovery can require:
- recovery phrase confirmation
- device approval
- biometric confirmation
- linked account verification
- backup restoration
If recovery is required, complete the recovery flow before:
- reconnecting payment methods
- funding cards
- sending assets
- enabling private mode
Creating a second wallet instead of completing recovery can disconnect activity history, balances, or supported payment features.
Privacy And Arcium Integration
Onyx Wallet includes privacy-enabled wallet functionality powered by Arcium.
Arcium is used to support privacy-preserving computation and protected transaction behavior for supported wallet actions.
Depending on asset support and regional availability, privacy-enabled actions can include:
- protected balance visibility
- protected transaction flows
- private settlement paths
- permissioned viewing access
Privacy-enabled actions can require:
- supported chains
- supported assets
- account eligibility
- enabled privacy mode
- additional verification
- viewing permission grants
Private mode is not available for:
- every asset
- every chain
- every region
- every payment rail
Some payment or compliance flows can temporarily disable privacy-enabled actions until verification completes.
Card And Payment Integration
Wallet balances can interact with:
- card funding
- FX conversion
- payment settlement
- supported payment rails
Some wallet actions can trigger:
- verification review
- transaction limits
- temporary holds
- additional approval requirements
Card and payment support can vary depending on:
- region
- issuer availability
- supported wallet rail
- verification state
- regulatory requirements
Sensitive Information
Never share:
- recovery phrases
- private keys
- signing approvals
- backup material
- authentication codes
The app and support flows should never ask you to expose secret wallet material publicly.
If wallet access is lost, use the recovery flow attached to your account instead of creating duplicate wallets or importing unknown recovery material.
Wallet Availability
Wallet functionality can become unavailable because of:
- unsupported region
- unsupported chain
- unsupported asset
- wallet disconnect
- expired verification
- failed backup state
- provider outage
- regulatory restrictions
- account review
- unsupported payment rail
The app should show the current restriction before a wallet action begins.