9e1b1397ad
- Add expanded address icon picker with search, bottom-aligned actions, and improved modal sizing - Embed a pickaxe icon font subset and wire it into typography/address icon rendering - Track view-only shielded addresses and prevent sends from non-spendable z-addresses - Improve address transfer dialog sizing, max amount handling, and text clipping - Tune main header layout values in ui.toml - Update README, codebase overview, and third-party license documentation
70 lines
4.5 KiB
Markdown
70 lines
4.5 KiB
Markdown
# Codebase Overview
|
|
|
|
Current as of 2026-04-27 for ObsidianDragon `1.2.0-rc1`.
|
|
|
|
## Purpose
|
|
|
|
ObsidianDragon is a Dear ImGui full-node wallet for DragonX (DRGX). It manages an embedded or external `dragonxd`, renders a schema-driven desktop UI, and provides shielded transactions, mining, market data, address management, explorer tools, and bootstrap download support.
|
|
|
|
## Runtime Architecture
|
|
|
|
- `src/main.cpp` initializes SDL3, graphics backends, ImGui, and the main loop.
|
|
- `src/app.cpp` owns application lifecycle, navigation, rendering, dialogs, and daemon/RPC startup.
|
|
- `src/app_network.cpp` contains refresh and transaction flows, including balance, address, transaction, mining, market, peer, and address metadata updates.
|
|
- `src/app_security.cpp` covers wallet encryption, PIN unlock, auto-lock, and secure vault integration.
|
|
- `src/app_wizard.cpp` handles first-run setup and bootstrap/encryption flow.
|
|
|
|
The UI thread renders ImGui and drains callback queues. RPC work runs through `RPCWorker`, which posts worker-thread RPC calls and returns UI-thread callbacks. Console commands can use a separate fast-lane RPC client/worker so they do not queue behind regular refresh batches.
|
|
|
|
## Source Map
|
|
|
|
| Path | Role |
|
|
|------|------|
|
|
| `src/config/` | Settings JSON persistence and generated `version.h` |
|
|
| `src/data/` | Wallet state, address book, exchange info |
|
|
| `src/rpc/` | libcurl JSON-RPC client, connection config, worker queue |
|
|
| `src/daemon/` | Embedded `dragonxd` manager and xmrig pool miner manager |
|
|
| `src/ui/windows/` | Main tabs and modal dialogs |
|
|
| `src/ui/pages/` | Page-style screens such as Settings |
|
|
| `src/ui/schema/` | TOML schema loader, skin manager, color resolver |
|
|
| `src/ui/material/` | Material-style typography, layout, drawing, components |
|
|
| `src/ui/effects/` | Acrylic, blur, noise, theme effects, low-spec fallback |
|
|
| `src/resources/` | Embedded resource extraction for params, daemon assets, themes, images |
|
|
| `src/platform/` | Windows DX11 and backdrop helpers |
|
|
| `src/util/` | i18n, logging, platform paths, bootstrap, vault, URI/base64/texture utilities |
|
|
|
|
## Build And Resources
|
|
|
|
- CMake uses C++17 and outputs `build/bin/ObsidianDragon`.
|
|
- Version comes from `project(... VERSION 1.2.0)` plus `DRAGONX_VERSION_SUFFIX=-rc1`.
|
|
- SDL3 is found from the system first, then fetched by CMake if unavailable.
|
|
- nlohmann/json and toml++ are fetched with CMake FetchContent.
|
|
- libcurl is system-provided on Linux/macOS and fetched statically for Windows.
|
|
- libsodium is system-provided on Linux or local under `libs/libsodium/`, `libs/libsodium-win/`, or `libs/libsodium-mac/`.
|
|
- Fonts are embedded with INCBIN: Ubuntu, Material Icons, a one-glyph MDI pickaxe subset, and Noto CJK subset.
|
|
- `res/themes/ui.toml` is embedded as a fallback and expanded into build themes with `scripts/expand_themes.py`.
|
|
- `res/default_banlist.txt` is embedded into `build/generated/default_banlist_embedded.h`.
|
|
|
|
## RPC And Daemon Notes
|
|
|
|
- Default RPC port is `21769`.
|
|
- `RPCClient` uses local HTTP with Basic auth. TLS is not assumed for localhost daemon RPC.
|
|
- DragonX daemon config paths:
|
|
- Linux: `~/.hush/DRAGONX/DRAGONX.conf`
|
|
- Windows: `%APPDATA%/Hush/DRAGONX/DRAGONX.conf`
|
|
- macOS: `~/Library/Application Support/Hush/DRAGONX/DRAGONX.conf`
|
|
- `Connection::autoDetectConfig()` creates missing config files, appends `exportdir`, `experimentalfeatures=1`, and `developerencryptwallet=1`, and falls back to `.cookie` auth if no `rpcpassword` is configured.
|
|
- The embedded daemon detects an external daemon on the RPC port and connects to it instead of taking ownership.
|
|
- Chain args include TLS-only mode, adaptive `-dbcache`, DragonX asset parameters, node seeds `node.dragonx.is` through `node4.dragonx.is`, and optional `-maxconnections=<n>` from Settings.
|
|
|
|
## UI And Data Notes
|
|
|
|
- Sidebar navigation is driven by `NavPage`: Overview, Send, Receive, History, Mining, Market, Console, Network, Explorer, Settings.
|
|
- Explorer lives in `src/ui/windows/explorer_tab.cpp`; Settings uses `src/ui/pages/settings_page.cpp`.
|
|
- Address labels, icons, favorites, hidden state, and manual ordering are persisted in Settings, especially `address_meta`.
|
|
- `AddressInfo::has_spending_key` tracks view-only shielded addresses; send flows filter or reject non-spendable z-addresses.
|
|
- The pickaxe icon is not a normal `ICON_MD_*` glyph. Use `AddressLabelDialog::drawIconByName()` or `Typography::pickaxeFontForSize()` for that special case.
|
|
|
|
## Remaining Work
|
|
|
|
- Investigate `todo.md`: determine whether DragonX/Komodo wallet storage supports a safe compaction or consolidation workflow for wallets with too many addresses. |