Quick Start

Getting Started

Set up your Po8 node, wallet, and start participating in the post-quantum network.

System Requirements

Before running a Po8 node, ensure your system meets the minimum requirements for your intended role.

Validator Node

HardwareMac Studio M2/M3 Ultra
Memory128 GB+ Unified Memory
Storage1 TB+ NVMe SSD
Network100 Mbps+ symmetric
Full consensus participation + Mixnet relay + mining

Miner Node

HardwareMacBook Pro M-Series Max
Memory64 GB+ Unified Memory
Storage500 GB+ SSD
Network50 Mbps+
TensorChain mining + light node

Edge Miner

HardwareKneron KL720 USB
HostAny x86/ARM system
Memory8 GB+ host RAM
Network10 Mbps+
Sharded mining pool participation

Node Setup

1. Install Dependencies

Ensure you have Rust and the required build tools installed.

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 
# macOS: Install Xcode Command Line Tools
xcode-select --install
 
# Install liboqs dependencies
brew install cmake ninja openssl

2. Clone and Build

# Clone the repository
git clone https://github.com/po8-network/po8-core.git
cd po8-core
 
# Build all components
cargo build --release
 
# Verify installation
./target/release/po8-node --version

3. Generate Keys

Generate your ML-DSA keypair for validator identity.

# Generate validator keys
./target/release/po8-node keys generate --output ~/.po8/keys
 
# This creates:
# - validator.ml-dsa.pub (1,952 bytes public key)
# - validator.ml-dsa.sec (encrypted secret key)
# - node.ml-kem.pub (1,184 bytes for P2P encryption)

4. Configure Node

# Copy example config
cp config.example.toml ~/.po8/config.toml
 
# Edit configuration
nano ~/.po8/config.toml

Key Configuration Options

[network]

P2P settings, persistent peers, listen addresses

[consensus]

Block time (60s default), validator set

[mining]

TensorChain matrix size, NPU backend selection

[privacy]

Mixnet relay settings, cover traffic rate

Start Your Node

Start as Full Node

# Start the node
./target/release/po8-node start \
  --config ~/.po8/config.toml \
  --data-dir ~/.po8/data
 
# With logging
RUST_LOG=info ./target/release/po8-node start

Start as Validator

# Register as validator (requires stake)
./target/release/po8-node validator register \
  --stake 1000 \
  --pubkey ~/.po8/keys/validator.ml-dsa.pub
 
# Start with validator mode
./target/release/po8-node start --validator

Start Mining

# Start TensorChain miner (Apple Silicon)
./target/release/tensor-miner \
  --node http://localhost:26657 \
  --backend mlx \
  --threads auto
 
# For Kneron accelerator
./target/release/tensor-miner \
  --backend kneron \
  --device /dev/kneron0

Wallet Setup

Chrome Extension Wallet

The Po8 wallet is available as a Chrome extension with full ML-DSA signing support.

1
Install Extension

Download from Chrome Web Store or build from source.

2
Create or Import Wallet

Generate a new ML-DSA keypair or import existing seed.

3
Backup Recovery Phrase

Store your 24-word recovery phrase securely offline.

4
Connect to dApps

The wallet injects a Web3-compatible provider with PQC support.

Ledger Hardware Wallet

For maximum security, use a Ledger device with the Po8 app.

Ledger Features

The Po8 Ledger app implements memory-optimized ML-DSA signing:

  • Just-in-time key regeneration from 32-byte seed
  • Flash streaming for large public parameters
  • WYSIWYS (What You See Is What You Sign) transaction parsing
  • Blind signing protection via custom ABI decoder

Verify Your Setup

Node Syncing

Check sync status with the network

po8-node status
Peer Connections

Verify P2P connections are established

po8-node peers list
Key Verification

Confirm your keys are properly loaded

po8-node keys verify
Mining Status

Check TensorChain mining is active

tensor-miner status

Ready to Dive Deeper?

Explore the technical documentation for advanced configuration and development.