Getting Started

System Requirements

OS: Linux (Ubuntu 20.04+), macOS 12+, Windows 10+
CPU: 4+ cores, 2.0 GHz or faster
RAM: 8 GB minimum, 16 GB recommended
Storage: 50 GB SSD (blockchain grows over time)
Network: 10 Mbps stable connection

Installation

Option 1: Pre-built Binaries

Download and Install bash
# Download latest release
wget https://github.com/qubitum-org/qubitum-native/releases/latest/download/qubitum-linux-amd64.tar.gz

# Extract
tar -xzf qubitum-linux-amd64.tar.gz

# Move to PATH
sudo mv qubitum /usr/local/bin/

# Verify installation
qubitum --version

Option 2: Build from Source

Build from Source bash
# Install Rust (if not installed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone repository
git clone https://github.com/qubitum-org/qubitum-native.git
cd qubitum-native

# Build release
cargo build --release

# Binary will be at target/release/qubitum

Running a Node

Start Node bash
# Start a full node
qubitum node --network mainnet

# Start with RPC enabled
qubitum node --network mainnet --rpc-bind 127.0.0.1:18443

# Start testnet node
qubitum node --network testnet

Mining Guide

QubitumHash Algorithm

QUBITUM uses QubitumHash, a memory-hard proof-of-work algorithm designed to be ASIC-resistant while remaining efficient for CPU/GPU mining. It requires approximately 4 GB of memory per thread.

Mining Requirements

  • Memory: 4 GB RAM per mining thread
  • CPU: Modern CPU with AES-NI support
  • GPU: (Optional) NVIDIA/AMD with 6+ GB VRAM

Solo Mining

Solo Mining Setup bash
# Start node with mining enabled
qubitum node --network mainnet --mine --miner-address QBT1...your_address

# Specify number of mining threads
qubitum node --network mainnet --mine --miner-address QBT1... --threads 4

Pool Mining

Pool Mining Setup bash
# Connect to mining pool
qubitum-miner -o stratum+tcp://pool.example.com:3333 -u QBT1...address -p x

# With intensity setting
qubitum-miner -o stratum+tcp://pool.example.com:3333 -u QBT1...address -p x -i 20

Mining Profitability

Mining profitability depends on:

  • Your hardware's hashrate
  • Current network difficulty
  • Electricity costs
  • Current QBT market value

Staking Guide

Understanding Tickets

QUBITUM uses a ticket-based staking system. You lock QBT to purchase tickets, which are then eligible to vote on blocks and earn rewards.

Buying Tickets

Purchase Staking Tickets bash
# Check current ticket price
qubitum-cli getticketprice

# Purchase a ticket
qubitum-cli purchaseticket --account default --spend-limit 100

# Purchase multiple tickets
qubitum-cli purchaseticket --account default --num-tickets 5 --spend-limit 500

Voting Configuration

Configure Voting bash
# Check voting wallet status
qubitum-cli getvotechoices

# Set voting preferences (for governance)
qubitum-cli setvotechoice --agenda agendaid --choice yes

# View ticket status
qubitum-cli gettickets --include-immature

Using a Vote Service Provider (VSP)

If you can't run your wallet 24/7, use a VSP to vote on your behalf. VSPs charge a small fee (1-5%) but ensure you never miss a vote.

Configure VSP bash
# Set VSP
qubitum-cli setvsp --url https://vsp.example.com

# Purchase ticket through VSP
qubitum-cli purchaseticket --vsp https://vsp.example.com --account default

Wallet Setup

Creating a New Wallet

Create Wallet bash
# Create new wallet
qubitum-wallet create

# The wallet will display a 24-word seed phrase
# IMPORTANT: Write this down and store securely!
# Example:
# abandon ability able about above absent absorb abstract absurd abuse access accident

Seed Phrase Security

Your seed phrase is the ONLY way to recover your wallet. Never share it with anyone, never store it digitally, and keep multiple physical copies in secure locations.

Receiving QBT

Get Receiving Address bash
# Generate new receiving address
qubitum-cli getnewaddress

# Result: QBT1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx

Sending QBT

Send Transaction bash
# Send QBT
qubitum-cli sendtoaddress QBT1destination... 10.5

# Send with comment
qubitum-cli sendtoaddress QBT1destination... 10.5 "Payment for services"

Backup & Recovery

Backup and Restore bash
# Backup wallet
qubitum-wallet backup --output wallet-backup.dat

# Restore from seed
qubitum-wallet restore --seed "your 24 word seed phrase here"

# Restore from backup file
qubitum-wallet restore --file wallet-backup.dat

RPC Reference

Enabling RPC

Start with RPC bash
# Enable RPC on localhost
qubitum node --rpc-bind 127.0.0.1:18443 --rpc-user myuser --rpc-password mypassword

Common RPC Methods

getblockchaininfo

Returns information about the blockchain.

curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getblockchaininfo","params":[]}' \
  http://user:pass@127.0.0.1:18443

getblock

Returns block data for a given block hash.

curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getblock","params":["blockhash"]}' \
  http://user:pass@127.0.0.1:18443

sendrawtransaction

Submits a raw transaction to the network.

curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"sendrawtransaction","params":["hexstring"]}' \
  http://user:pass@127.0.0.1:18443

getticketpoolvalue

Returns the total value locked in the ticket pool.

curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getticketpoolvalue","params":[]}' \
  http://user:pass@127.0.0.1:18443

View full RPC documentation on GitHub Wiki

Frequently Asked Questions

Everything you need to know about QUBITUM

What makes QUBITUM quantum-resistant?

QUBITUM uses CRYSTALS-Dilithium for digital signatures, a lattice-based cryptographic algorithm standardized by NIST (FIPS 204). It cannot be broken by Shor's algorithm because it's based on lattice problems, not elliptic curve mathematics.

How long does it take for a ticket to vote?

On average, a ticket will be selected to vote after approximately 28 days. The maximum ticket lifetime is 40,960 blocks (~71 days). If not selected before expiry, the original stake is returned without reward.

Can I mine with a regular computer?

Yes! QubitumHash is designed to be ASIC-resistant and CPU/GPU friendly. You can mine with any modern computer with at least 4 GB RAM per thread. GPU mining with 6+ GB VRAM is more efficient, but CPU mining is also viable.

Is there a minimum amount to stake?

The ticket price is dynamic and adjusts based on demand. You need at least enough QBT to purchase one ticket at the current price. The algorithm targets 8,192 active tickets - prices adjust accordingly.

What if my wallet is offline when called?

If your wallet is offline and cannot vote, you'll miss the voting reward. To avoid this, either keep your wallet running 24/7 or use a Vote Service Provider (VSP) that votes on your behalf for a small fee.

How can I contribute to development?

QUBITUM is open source! Contribute via pull requests on GitHub, report bugs, write documentation, join the Discord community to help other users, or submit treasury proposals for funded development.

Need More Help?

Join our community or reach out to the team directly