DragonX Wallet - ImGui Edition

A lightweight, portable cryptocurrency wallet for DragonX (DRGX), built with Dear ImGui.

Features

• Full Node Support: Connects to dragonxd for complete blockchain verification
• Shielded Transactions: Full z-address support with encrypted memos
• Integrated Mining: CPU mining controls with hashrate monitoring
• Market Data: Real-time price charts from CoinGecko
• QR Codes: Generate and display QR codes for receiving addresses
• Multi-language: i18n support (English, Spanish, more coming)
• Lightweight: ~5-10MB binary vs ~50MB+ for Qt version
• Fast Builds: Compiles in seconds, not minutes

Screenshots

Building

Quick Setup

The setup script detects your OS, installs all build dependencies, and validates your environment:

./setup.sh              # Install core build deps (interactive)
./setup.sh --check      # Just report what's missing
./setup.sh --all        # Core + Windows/macOS cross-compile + Sapling params
./setup.sh --win        # Also install mingw-w64 + libsodium-win

Manual Prerequisites

Click to expand manual install commands

Linux (Ubuntu/Debian):

sudo apt install build-essential cmake git pkg-config
sudo apt install libgl1-mesa-dev libx11-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev
sudo apt install libsodium-dev libcurl4-openssl-dev

Linux (Arch):

sudo pacman -S base-devel cmake git pkg-config mesa libx11 libxcursor libxrandr libxinerama libxi libsodium curl

macOS:

xcode-select --install
brew install cmake

Windows:

• Visual Studio 2019+ with C++ workload
• CMake 3.20+

Binaries

Download linux and windows binaries of latest releases and place in binary directories:

DragonX daemon (https://git.dragonx.is/DragonX/dragonx):

• prebuilt-binaries/dragonxd-linux/
• prebuilt-binaries/dragonxd-win/
• prebuilt-binaries/dragonxd-mac/

xmrig HAC fork (https://git.dragonx.is/dragonx/xmrig-hac):

• prebuilt-binaries/xmrig-hac/

Build Steps

### Clone repository (if not already)
git clone https://git.dragonx.is/dragonx/ObsidianDragon.git
cd ObsidianDragon/

Windows Build

./build.sh --win-release

Release Build

./build.sh --linux-release    # Linux release + AppImage
./build.sh --win-release      # Windows cross-compile
./build.sh --mac-release      # macOS .app bundle + DMG
./build.sh --clean --linux-release  # Clean + Release

Running

1. Start dragonxd (if not using embedded daemon):

   dragonxd -daemon
   

2. Run the wallet:

   cd build/bin
   ./ObsidianDragon
   

The wallet will automatically connect to the daemon using credentials from `~/.hush/DRAGONX/DRAGONX.conf`.

Using Custom Node Binaries

The wallet checks its own directory first when looking for DragonX node binaries. This means you can test new or different branch builds of hush-arrakis-chain/hushd without waiting for a new wallet release:

1. Build or download the node binaries you want to test
2. Place them in the same directory as the wallet executable (e.g. build/bin/)
3. Launch the wallet — it will use the local binaries instead of the bundled ones

Search order:

1. Wallet executable directory (highest priority)
2. Embedded/extracted daemon (app data directory)
3. System-wide locations (/usr/local/bin, ~/dragonx/src, etc.)

This is useful for testing new branches or hotfixes to the node software before they are bundled into a wallet release.

Configuration

Configuration is stored in `~/.hush/DRAGONX/DRAGONX.conf`:

rpcuser=your_rpc_user
rpcpassword=your_rpc_password
rpcport=21769

Project Structure

ObsidianDragon/
├── src/
│   ├── main.cpp           # Entry point, SDL/ImGui setup
│   ├── app.cpp/h          # Main application class
│   ├── wallet_state.h     # Wallet data structures
│   ├── version.h          # Version definitions
│   ├── ui/
│   │   ├── theme.cpp/h    # DragonX theme
│   │   └── windows/       # UI tabs and dialogs
│   ├── rpc/
│   │   ├── rpc_client.cpp # JSON-RPC client
│   │   └── connection.cpp # Daemon connection
│   ├── config/
│   │   └── settings.cpp   # Settings persistence
│   ├── util/
│   │   ├── i18n.cpp       # Internationalization
│   │   └── ...
│   └── daemon/
│       └── embedded_daemon.cpp
├── res/
│   ├── fonts/             # Ubuntu font
│   └── lang/              # Translation files
├── libs/
│   └── qrcode/            # QR code generation
├── CMakeLists.txt
├── build-release.sh       # Build script
└── create-appimage.sh     # AppImage packaging

Dependencies

Fetched automatically by CMake (no manual install needed):

• SDL3 — Cross-platform windowing/input
• nlohmann/json — JSON parsing
• toml++ — TOML parsing (UI schema/themes)
• libcurl — HTTPS RPC transport (system on Linux, fetched on Windows)

Bundled in libs/:

• Dear ImGui — Immediate mode GUI
• libsodium — Cryptographic operations (fetched by scripts/fetch-libsodium.sh)
• QR-Code-generator — QR code rendering
• miniz — ZIP compression
• GLAD — OpenGL loader (Linux/macOS)
• stb_image — Image loading
• incbin — Binary resource embedding (Windows builds)

Keyboard Shortcuts

Shortcut	Action
Ctrl+,	Settings
F5	Refresh
Alt+F4	Exit

Translation

To add a new language:

1. Copy `res/lang/es.json` to `res/lang/.json`
2. Translate all strings
3. The language will appear in Settings automatically

License

This project is licensed under the GNU General Public License v3 (GPLv3).

Credits

• The Hush Developers
• DragonX Community
• Dear ImGui by Omar Cornut
• SDL by Sam Lantinga

Links

• Website: https://dragonx.is
• Explorer: https://explorer.dragonx.is
• Source: https://git.dragonx.is/dragonx/ObsidianDragon