Introduction

xelis_wallet is the application that allows you to securely store, send, and receive XEL and any other asset available on the XELIS blockchain.

It connects to the blockchain through the daemon or a remote node, enabling you to manage your funds while maintaining full control of your private keys.

By default, the wallet operates in a non-custodial way only: you hold the keys to your coins, ensuring that no third party can access or move your funds.

Beyond basic transfers, the XELIS wallet also supports advanced features such as interacting with multisig, smart contracts, managing custom assets, and monitoring your transaction history.

For the highest level of privacy and security, it is highly recommended to connect your wallet to a daemon you manage, making your setup fully trustless and independent while contributing to the health of the XELIS network.

Configuration

Command-line wallet for XELIS. Create, open, recover, sync, and manage encrypted wallets, balances, and transactions.

rpc_bind_address

Address the RPC server listens on

rpc_username

Username required for RPC authentication

rpc_password

Password required for RPC authentication

rpc_threads

Number of worker threads used by the RPC server

daemon_address

Daemon RPC endpoint used to sync the wallet

offline_mode

Start without connecting to a daemon

precomputed_tables_l1

L1 size used for precomputed tables.

The default is 26, which uses about 330 MB. At each increment of 1, the size of the table is doubled.

precomputed_tables_path

Directory used to read or generate precomputed tables.

Defaults to the current directory.

log_level

Minimum log level printed to the terminal

file_log_level

Minimum log level written to the log file.

Defaults to the terminal log level.

disable_file_logging

Disable writing logs to a file

disable_file_log_date_based

Disable date-based log filenames.

When enabled, the log file is named xelis-wallet.log instead of YYYY-MM-DD.xelis-wallet.log.

auto_compress_logs

Compress rotated log files automatically.

This only applies when file logging is enabled.

disable_log_color

Disable colors in terminal logs

disable_interactive_mode

Disable the interactive terminal prompt.

CLI commands and live prompt updates are unavailable in this mode.

filename_log

Log filename stored inside logs_path.

Defaults to xelis-wallet.log. Unless date-based filenames are disabled, daily log files are named YYYY-MM-DD.xelis-wallet.log.

logs_path

Directory where log files are written.

Defaults to logs/. The path must end with / or \.

logs_modules

Per-module log filters

disable_ascii_art

Disable the ASCII art shown at startup

datetime_format

Datetime format used in log entries

wallet_path

Wallet directory to open or create

password

Password used to open the wallet

seed

Recover the wallet from a seed phrase

n_decryption_threads

Number of threads used for ciphertext decryption

network_concurrency

Maximum number of concurrent network handler tasks

network

Network to use for addresses, sync, and transactions

enable_xswd

Enable the XSWD server

history_scan_mode

History scan mode used during wallet synchronization.

Modes that skip history only store blocks and transactions received after the wallet starts.

force_stable_balance

Use only stable balance when building transactions.

This avoids spending funds that may be affected by a DAG reorg and only applies while the wallet is online.

config_file

JSON configuration file to load

generate_config_template

Generate a configuration template at config_file