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
Miner Node
Edge Miner
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
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.
Install Extension
Download from Chrome Web Store or build from source.
Create or Import Wallet
Generate a new ML-DSA keypair or import existing seed.
Backup Recovery Phrase
Store your 24-word recovery phrase securely offline.
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.
