Skip to content

ZION v3.0.5-beta — Simplified Community CLI

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Yose144 Yose144 released this 10 Jul 00:15
v3.0.5-beta
12357fb

ZION v3.0.5-beta — Simplified Community CLI

One binary. Everything you need.

This release simplifies the ZION experience: instead of 8 separate binaries, you get one zion binary with an interactive menu that guides you through wallet creation, mining, and node operation.

⚠️ Mainnet Beta — mine and transact at your own risk
The network is live and producing blocks. Genesis chain is permanent. Official public launch: 31 December 2026.

What's new in v3.0.5?

  • Single binary — no more choosing between 8 different packages
  • Interactive menu — arrow-key navigation, no need to memorize commands
  • Guided setup — wallet → node → pool → miner, step by step
  • Live dashboard — see node status, miner status, wallet balance at a glance
  • Auto-download — node, pool, and miner binaries are downloaded automatically from GitHub Releases on first use (Linux & macOS). Windows has them embedded.
  • GPU mining support — Metal (macOS), OpenCL/CUDA (Linux), CPU fallback
  • Pool health check — TCP connect to stratum port (not HTTP)
  • AI (Hiran) optional — graceful handling when not configured

Download

Which file should I download?

Your system CLI file Size
Linux (Ubuntu, Debian, etc.) zion-cli-linux-x86_64.tar.gz 2.3 MB
macOS Apple Silicon (M1/M2/M3/M4) zion-cli-macos-aarch64.tar.gz 2.1 MB
macOS Intel zion-cli-macos-x86_64.tar.gz 2.3 MB
Windows 10/11 zion-cli-windows-x86_64.zip 4.8 MB

Not sure which macOS you have? Click Apple menu → "About This Mac". "Apple M1/M2/M3" = aarch64. "Intel" = x86_64.

Windows users: The Windows CLI is larger (4.8 MB) because it has the node, pool, and miner embedded inside — you only need one file.

Linux & macOS users: The CLI will automatically download the node, pool, and miner binaries from this release page on first use. No separate download needed.

Standalone binaries (optional)

If you prefer to download binaries separately:

Binary Linux macOS ARM macOS Intel Windows
node zion-node-linux-x86_64.tar.gz zion-node-macos-aarch64.tar.gz zion-node-macos-x86_64.tar.gz zion-node-windows-x86_64.zip
pool zion-pool-linux-x86_64.tar.gz zion-pool-macos-aarch64.tar.gz zion-pool-macos-x86_64.tar.gz zion-pool-windows-x86_64.zip
miner zion-miner-linux-x86_64.tar.gz zion-miner-macos-aarch64.tar.gz zion-miner-macos-x86_64.tar.gz zion-miner-windows-x86_64.zip

Quick Start — 3 steps to mining

Step 1: Download and extract

Linux / macOS:

# Extract
tar xzf zion-cli-macos-aarch64.tar.gz   # or your platform file

# Make executable (if needed)
chmod +x zion

# Run the interactive menu
./zion menu

Windows:

# Extract the zip (right-click → Extract All)
# Open PowerShell in the extracted folder
.\zion.exe menu

Step 2: Create your wallet

When you run ./zion menu, select "🚀 Guided Setup" — it will walk you through everything.

Or do it manually:

# Create a new wallet with 24-word recovery phrase
# ⚠️ WRITE DOWN the 24 words on paper — they are your only backup!
./zion wallet new --mnemonic --out my-wallet.json

# View your wallet address (starts with "zion1...")
./zion wallet info --wallet my-wallet.json

What is a wallet? A file that holds your private keys. Share your address (starts with zion1...) to receive ZION. The 24-word mnemonic is your private backup — never share it, never put it online.

Step 3: Start mining

# Start mining to the official pool
./zion mine start --wallet my-wallet.json

# Check status
./zion mine status

# Stop
./zion mine stop

Or just use the menu: ./zion menu → "Mine" → "Start"

Pool vs Solo: By default, the CLI mines to the official pool (pool.zionterranova.com:8444). In pool mode, you earn a share of every block. Solo mode only pays when you find a block — which is rare. Pool mode is recommended.

GPU mining: The CLI auto-detects your GPU. On macOS it uses Metal, on Linux it uses OpenCL or CUDA. You can force a backend with --backend cpu|opencl|cuda|metal.

All Commands

./zion menu              # Interactive arrow-key menu (easiest)
./zion wallet new        # Create wallet
./zion wallet balance    # Check balance
./zion wallet send --to zion1... --amount 1.5  # Send ZION
./zion mine start        # Start mining
./zion mine stop         # Stop mining
./zion mine status       # Mining status
./zion node info         # Node info (chain height, peers)
./zion node peers        # List connected peers
./zion status            # Network health check
./zion doctor            # Diagnostics
./zion monitor           # Live TUI monitor
./zion version           # Version info

Run a Full Node (optional)

A full node downloads the entire blockchain and verifies all transactions. Running one helps decentralize the network.

Linux / macOS:

./zion node start        # Starts a local node (auto-downloaded if needed)
./zion node status       # Check if it's running

Windows:
The Windows CLI has the node embedded — just run:

.\zion.exe node start

Network Parameters

Parameter Value What it means
Genesis hash 4f75a0df... Fingerprint of the first block — proves you are on the right chain
Consensus PoW (Ekam Deeksha) Proof-of-work: BLAKE3 + RandomNPU dual-algo
Block target 60 seconds New block every ~60 seconds
Total supply 144 billion ZION Maximum ZION that will ever exist
Decimals 6 (1 ZION = 1,000,000 flowers) Smallest unit: 0.000001 ZION (a "flower")
Pool pool.zionterranova.com:8444 Official mining pool
RPC (localhost) 127.0.0.1:8443 Local node RPC port

Verification

SHA256 checksums in SHA256SUMS.txt:

# Linux / macOS
shasum -a 256 zion-cli-macos-aarch64.tar.gz
# Compare with SHA256SUMS.txt

# Windows
Get-FileHash zion-cli-windows-x86_64.zip -Algorithm SHA256

Build from Source

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

# Clone and build
git clone https://github.com/Zion-TerraNova/v3-Mainnet.git
cd v3-Mainnet/V3
cargo build --release -p zion-public

# Binary: target/release/zion

Documentation

Resource Link
README README.md
CLI Guide V3/docs/CLI_GUIDE.md
CLI Reference V3/docs/CLI_REFERENCE.md
Whitepaper docs/whitepaper.md
Website zionterranova.com

License

MIT — see LICENSE.

ZION — Multichain Dharma Ecosystem

Built with care, secured by consensus.

Gate, Gate, Paragate, Parasamgate, Bodhi Svaha.

Peace & One Love 4ever.

Assets 19
Loading