Mining & Node Guide

v2.9.8 "Deeksha Patch & Code Freeze" · Cosmic Harmony v3 · CPU / GPU / Pool / Solo

Everything you need — from first wallet to running a full node. Native Rust binaries for Windows, Linux & macOS. No dependencies.

Quick Start Algorithms Mining Guides Hardware Node Setup FAQ

Download Binaries Full Guide on GitHub Pool Dashboard

Quick Start — 3 Steps

From zero to mining in under 5 minutes.

Create Wallet

Download zion-wallet for your OS
Run: zion-wallet gen-mnemonic --out my-wallet.json --print
Write down 24 words on paper — your backup!

Start Mining

Download zion-miner for your OS
Run: zion-miner --pool stratum+tcp://pool.zionterranova.com:3333 --wallet YOUR_ADDRESS
Watch hashrate & accepted shares

Check Balance

Run: zion-wallet balance --address YOUR_ADDRESS
Visit Explorer at zionterranova.com/explorer
Send: zion-wallet send --to RECIPIENT --amount 100

One-line install (Linux / macOS)

$ curl -fsSL https://raw.githubusercontent.com/Zion-TerraNova/2.9.5-NativeAwakening/main/install.sh | bash

Supported Algorithms

Cosmic Harmony v3 rotates RandomX + Yescrypt + Blake3 for ASIC resistance. Connect on port 3333 for auto-algo or pick a dedicated port.

AlgorithmTypeMemoryBest For

Cosmic Harmony v3stratum+tcp://pool.zionterranova.com:3333

CPU + GPU256 KBBalanced mining, anti-ASIC

RandomXstratum+tcp://pool.zionterranova.com:3334

CPU2 GBCPU-optimized, Monero-proven

Yescryptstratum+tcp://pool.zionterranova.com:3335

CPU4 KBLow-memory devices, RPi

Autolykos v2stratum+tcp://pool.zionterranova.com:3336

GPU2.5 GBGPU mining, Ergo-proven

Mining Guides

Step-by-step for any hardware — from Raspberry Pi to a GPU rig.

CPU Mining with ZION Native Miner

Works on any x86_64 or ARM64 CPU. Best algos: Cosmic Harmony v3, RandomX, Yescrypt (low-memory).

Option A — Pre-compiled binary (recommended)

# Download from GitHub Release
# → https://github.com/Zion-TerraNova/2.9.5-NativeAwakening/releases/tag/v2.9.6

# Linux/macOS — one-line install:
curl -fsSL https://raw.githubusercontent.com/Zion-TerraNova/2.9.5-NativeAwakening/main/install.sh | bash

# Or download manually and make executable:
chmod +x zion-miner-linux-x86_64
./zion-miner-linux-x86_64 --version

Option B — Build from source

git clone https://github.com/Zion-TerraNova/Zion-2.9.5.git
cd Zion-2.9.5
cargo build --release -p zion-miner
ls -la target/release/zion-miner

Start mining (pool)

zion-miner \
  --algo cosmic-harmony-v3 \
  --pool stratum+tcp://pool.zionterranova.com:3333 \
  --wallet YOUR_ZION_ADDRESS \
  --threads $(nproc)

Alternative: XMRig for RandomX

./xmrig \
  -o stratum+tcp://pool.zionterranova.com:3334 \
  -u YOUR_ZION_ADDRESS \
  -p x \
  -a rx/0 \
  --threads=$(nproc)

💡 CPU Tips

• Enable huge pages for RandomX: sudo sysctl -w vm.nr_hugepages=1280
• Leave 1–2 cores free for system if mining 24/7
• Monitor temperature: keep below 85°C
• ARM64 (Raspberry Pi 4/5): use Yescrypt for best perf/watt

Hardware Comparison

Approximate values for Cosmic Harmony v3 / RandomX / Autolykos v2.

HardwareHashratePowerEfficiency

Raspberry Pi 5~200 H/s · 10W

~200 H/s10W20 H/W

Intel i7-12700K~8 KH/s · 125W

~8 KH/s125W64 H/W

AMD Ryzen 9 7950X~15 KH/s · 170W

~15 KH/s170W88 H/W

Apple M3 Pro~12 KH/s · 30W

~12 KH/s30W400 H/W

Apple M4 Max~22 KH/s · 40W

~22 KH/s40W550 H/W

NVIDIA RTX 4070~85 MH/s · 200W

~85 MH/s200W425 KH/W

NVIDIA RTX 4090~160 MH/s · 350W

~160 MH/s350W457 KH/W

AMD RX 7900 XTX~130 MH/s · 300W

~130 MH/s300W433 KH/W

Run a Full Node

Strengthen the network by validating transactions and relaying blocks. 10 minutes from zero to synced — no special hardware required.

System Requirements

CPU

2+ cores (ARM64 or x86_64)

RAM

4 GB minimum (8 GB rec.)

Disk

20 GB SSD (grows ~2 GB/yr)

Network

Stable broadband, 10 Mbps+

Linux, macOS, Windows (WSL2)

Installation

Pre-compiled Binary (recommended)

# Download from GitHub Release
# → https://github.com/Zion-TerraNova/2.9.5-NativeAwakening/releases/tag/v2.9.6

# Or use one-line install:
curl -fsSL https://raw.githubusercontent.com/Zion-TerraNova/2.9.5-NativeAwakening/main/install.sh | bash

# Manual:
chmod +x zion-node-linux-x86_64
./zion-node-linux-x86_64 --version

Build from Source

git clone https://github.com/Zion-TerraNova/Zion-2.9.5.git
cd Zion-2.9.5
cargo build --release -p zion-node
# Binary → target/release/zion-node

Docker

docker pull ghcr.io/zion-terranova/zion-node:2.9.5

docker run -d \
  --name zion-node \
  -p 8334:8334 -p 8444:8444 \
  -v zion-data:/data \
  ghcr.io/zion-terranova/zion-node:2.9.5 \
  --config /etc/zion/mainnet.toml

Network Configuration

Production network — real ZION — config: config/mainnet.toml

mainnet.toml

[network]
name = "mainnet"
p2p_port = 8334
rpc_port = 8444
max_peers = 128

[consensus]
algorithm = "cosmic-harmony-v3"
block_time = 60
difficulty_adjustment = "per-block"

[mining]
stratum_port = 3333
reward_address = "YOUR_ZION_ADDRESS"

[storage]
data_dir = "~/.zion/mainnet"

[peers]
bootstrap = [
  "pool.zionterranova.com:8334"
]

Ports & Firewall

PortProtocolPurposeRequired

8334TCPP2P peer-to-peerRequired

8444TCPJSON-RPC APIOptional

3333TCPStratum miningOptional

8080TCPPool APIOptional

UFW Firewall (Ubuntu/Debian)

sudo ufw allow 8334/tcp comment "ZION P2P"
sudo ufw allow from 127.0.0.1 to any port 8444 proto tcp comment "ZION RPC"
sudo ufw status

Node CLI Reference

zion-node --versionCheck installed version

zion-node --config mainnet.tomlStart with config file

zion-node --network mainnet --rpc-port 8444Override RPC port

zion-node --peers pool.zionterranova.com:8334Manual peer list

zion-node --log-level debugVerbose logging

zion-node --data-dir /custom/pathCustom data directory

Verify Your Node

Check sync status

curl -s http://localhost:8444 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getBlockchainInfo"}' | jq .

Check peers

curl -s http://localhost:8444 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getPeerCount"}' | jq .

Success criteria

• Block height matches Explorer
• 2+ peers connected
• New blocks every ~60 seconds
• RPC responds to queries

FAQ & Troubleshooting

Ready to mine ZION?

Join the community. Every hash strengthens the network.

Download Binaries Pool Dashboard Full Guide on GitHub Explorer

Quick Start — 3 Steps

From zero to mining in under 5 minutes.

Create Wallet

Download zion-wallet for your OS
Run: zion-wallet gen-mnemonic --out my-wallet.json --print
Write down 24 words on paper — your backup!

Start Mining

Download zion-miner for your OS
Run: zion-miner --pool stratum+tcp://pool.zionterranova.com:3333 --wallet YOUR_ADDRESS
Watch hashrate & accepted shares

Check Balance

Run: zion-wallet balance --address YOUR_ADDRESS
Visit Explorer at zionterranova.com/explorer
Send: zion-wallet send --to RECIPIENT --amount 100

One-line install (Linux / macOS)

$ curl -fsSL https://raw.githubusercontent.com/Zion-TerraNova/2.9.5-NativeAwakening/main/install.sh | bash

Supported Algorithms

Cosmic Harmony v3 rotates RandomX + Yescrypt + Blake3 for ASIC resistance. Connect on port 3333 for auto-algo or pick a dedicated port.

AlgorithmTypeMemoryBest For

Cosmic Harmony v3stratum+tcp://pool.zionterranova.com:3333

CPU + GPU256 KBBalanced mining, anti-ASIC

RandomXstratum+tcp://pool.zionterranova.com:3334

CPU2 GBCPU-optimized, Monero-proven

Yescryptstratum+tcp://pool.zionterranova.com:3335

CPU4 KBLow-memory devices, RPi

Autolykos v2stratum+tcp://pool.zionterranova.com:3336

GPU2.5 GBGPU mining, Ergo-proven

Mining Guides

Step-by-step for any hardware — from Raspberry Pi to a GPU rig.

CPU Mining with ZION Native Miner

Works on any x86_64 or ARM64 CPU. Best algos: Cosmic Harmony v3, RandomX, Yescrypt (low-memory).

Option A — Pre-compiled binary (recommended)

# Download from GitHub Release
# → https://github.com/Zion-TerraNova/2.9.5-NativeAwakening/releases/tag/v2.9.6

# Linux/macOS — one-line install:
curl -fsSL https://raw.githubusercontent.com/Zion-TerraNova/2.9.5-NativeAwakening/main/install.sh | bash

# Or download manually and make executable:
chmod +x zion-miner-linux-x86_64
./zion-miner-linux-x86_64 --version

Option B — Build from source

git clone https://github.com/Zion-TerraNova/Zion-2.9.5.git
cd Zion-2.9.5
cargo build --release -p zion-miner
ls -la target/release/zion-miner

Start mining (pool)

zion-miner \
  --algo cosmic-harmony-v3 \
  --pool stratum+tcp://pool.zionterranova.com:3333 \
  --wallet YOUR_ZION_ADDRESS \
  --threads $(nproc)

Alternative: XMRig for RandomX

./xmrig \
  -o stratum+tcp://pool.zionterranova.com:3334 \
  -u YOUR_ZION_ADDRESS \
  -p x \
  -a rx/0 \
  --threads=$(nproc)

💡 CPU Tips

• Enable huge pages for RandomX: sudo sysctl -w vm.nr_hugepages=1280
• Leave 1–2 cores free for system if mining 24/7
• Monitor temperature: keep below 85°C
• ARM64 (Raspberry Pi 4/5): use Yescrypt for best perf/watt

Hardware Comparison

Approximate values for Cosmic Harmony v3 / RandomX / Autolykos v2.

HardwareHashratePowerEfficiency

Raspberry Pi 5~200 H/s · 10W

~200 H/s10W20 H/W

Intel i7-12700K~8 KH/s · 125W

~8 KH/s125W64 H/W

AMD Ryzen 9 7950X~15 KH/s · 170W

~15 KH/s170W88 H/W

Apple M3 Pro~12 KH/s · 30W

~12 KH/s30W400 H/W

Apple M4 Max~22 KH/s · 40W

~22 KH/s40W550 H/W

NVIDIA RTX 4070~85 MH/s · 200W

~85 MH/s200W425 KH/W

NVIDIA RTX 4090~160 MH/s · 350W

~160 MH/s350W457 KH/W

AMD RX 7900 XTX~130 MH/s · 300W

~130 MH/s300W433 KH/W

# Download from GitHub Release # → https://github.com/Zion-TerraNova/2.9.5-NativeAwakening/releases/tag/v2.9.6 # Or use one-line install: curl -fsSL https://raw.githubusercontent.com/Zion-TerraNova/2.9.5-NativeAwakening/main/install.sh | bash # Manual: chmod +x zion-node-linux-x86_64 ./zion-node-linux-x86_64 --version

docker pull ghcr.io/zion-terranova/zion-node:2.9.5 docker run -d \ --name zion-node \ -p 8334:8334 -p 8444:8444 \ -v zion-data:/data \ ghcr.io/zion-terranova/zion-node:2.9.5 \ --config /etc/zion/mainnet.toml

[network] name = "mainnet" p2p_port = 8334 rpc_port = 8444 max_peers = 128 [consensus] algorithm = "cosmic-harmony-v3" block_time = 60 difficulty_adjustment = "per-block" [mining] stratum_port = 3333 reward_address = "YOUR_ZION_ADDRESS" [storage] data_dir = "~/.zion/mainnet" [peers] bootstrap = [ "pool.zionterranova.com:8334" ]