QRX Docs · Wiki Mouse Ask on Discord
Documentation Hub · Pre-Genesis · Work in Progress

Wiki Mouse keeps the QRX docs moving.

A premium documentation hub for QRX / QubitCoin: architecture notes, node setup direction, wallet concepts, terminology and contributor onboarding.

Start Reading Join Crew GitHub

Docs are living notes. Protocol details, tokenomics, network parameters and wallet behavior can evolve before genesis.

Wiki Mouse is steering the QRX crew.
Overview

What QRX is

QRX is an experimental blockchain project in pre-genesis phase. QubitCoin is planned as the native economic unit of the network, while QRX remains the network and ecosystem brand.

The project is built from scratch and does not share a codebase with BTC forks, ETH clients or other existing coin projects.

Documentation status

  • Pre-genesis documentation is informational and subject to change.
  • Implementation details may change after audits, tests and community feedback.
  • Discord is the main place for early decisions and contributor discussion.
Architecture

Built from scratch, designed to evolve.

The QRX architecture is intended to avoid legacy constraints where possible and leave room for future protocol upgrades, fork-based evolution and validator-focused participation.

Core

The core is the network engine and remains WIP while validation, bug searching and implementation review continue.

Network

The network path focuses on community-run nodes, staking-related flows and lower-cost participation instead of Proof-of-Work mining.

Governance

Pre-genesis is the right phase to discuss tokenomics, network rules, fork policies and contributor recognition models.

Cryptography

Quantum-aware direction.

QRX is designed with hybrid cryptography and post-quantum migration in mind. The current direction includes hybrid transaction signatures such as Ed25519 + ML-DSA-65.

Documentation principle

  • Use “quantum-aware” and “post-quantum trajectory”.
  • Document assumptions clearly before genesis.
  • Keep implementation notes readable for contributors.
Wallet UX

Lightweight GUI direction.

The GUI direction avoids Qt and Electron and explores Tauri for lightweight multi-platform wallet apps.

Create / Import

Simple onboarding flows for new users and existing key material.

Send / Receive

Clear transaction flow with history, confirmation status and explorer links.

Stake / Delegate

Future UX area for validator participation, delegation and reward visibility.

Node operators

Run a QRX node.

QRX nodes are designed around a lightweight native core, QRXDB, graceful shutdown handling, snapshot support and future validator-focused participation.

Build QRX

cd qrx-0.0.5
mkdir -p build
cd build

cmake ..
make -j$(sysctl -n hw.ncpu 2>/dev/null || nproc)

Start Node

./qrxd --network alpha
./qrxd --network testnet
./qrxd --network mainnet

Graceful Shutdown

./qrx-cli --network alpha stop

QRXDB performs WAL flush, mmap sync, generation commit and clean database shutdown.

Apple Silicon (M1/M2/M3)

cmake -DCMAKE_OSX_ARCHITECTURES=arm64 ..

file qrxd

Expected output: Mach-O 64-bit executable arm64

CLI

qrx-cli node control.

qrx-cli is the primary control interface for nodes, validators, QRXDB maintenance and wallet interaction.

Node Commands

./qrx-cli --network alpha getinfo
./qrx-cli --network alpha getblockcount
./qrx-cli --network alpha listpeers
./qrx-cli --network alpha stop

Wallet Commands

./qrx-cli --network alpha getnewaddress
./qrx-cli --network alpha getbalance
./qrx-cli --network alpha getwalletinfo

Validator Commands

./qrx-cli --network alpha getstakinginfo
./qrx-cli --network alpha stake 100
./qrx-cli --network alpha validator-set

RPC ports

mainnet  -> 37660
alpha    -> 37661
testnet  -> 37662
regtest  -> 37663

Ports are selected automatically by network. Manual port configuration is usually not required.

QRXDB

Native blockchain storage engine.

QRXDB is a custom blockchain-oriented database engine developed specifically for QRX. It is designed around mmap access, WAL recovery, MVCC generations and validator-friendly storage flows.

Core Features

  • mmap-native architecture
  • append-only storage
  • MVCC generations
  • WAL recovery
  • zero-copy reads
  • Merkle-state groundwork
  • snapshot support

Consensus Hardening

  • chain_id separation
  • protocol versioning
  • snapshot versioning
  • timestamp consensus validation
  • nonce enforcement groundwork
  • replay protection groundwork

Graceful Shutdown

qrxdb_stop_compaction()
qrxdb_flush_wal()
qrxdb_mmap_sync()
qrxdb_commit_generation()
qrxdb_close()
Runtime

Graceful node handling.

qrxd supports SIGINT/SIGTERM handling to improve validator reliability, cleaner QRXDB recovery and safer restart behavior.

Runtime improvements

  • graceful Ctrl+C handling
  • listener shutdown
  • reduced dirty WAL states
  • mmap synchronization before exit
  • future validator-safe restart flows
Security

Mainnet hardening direction.

QRX is evolving toward a hardened validator-oriented architecture with hybrid cryptography, replay protection and deterministic consensus behavior.

1

Hybrid Crypto

Ed25519 + ML-DSA-65 direction.

2

Replay Protection

Nonce and chain_id based replay mitigation.

3

Consensus Time

Median-time-past and future drift validation.

4

Protocol Evolution

Versioned upgrades and snapshot compatibility groundwork.

Glossary

Key terms.

QRX

The network and ecosystem brand.

QubitCoin

The planned native economic unit of the QRX network.

Wiki Mouse

The documentation mascot steering users through the docs.