QuantaChain Katenet Alpha V3.0.0

QuantaChain Testnet — V3 Katenet (v3.0.0-alpha)

Post-quantum secure blockchain using Falcon-512 signatures and Asynchronous Byzantine Fault Tolerance (AlephBFT).

v3.0.0-alpha (hotfix 2) — DATABASE MIGRATION FIX (2026-08-05)

• No wipe required. The node now seamlessly migrates your existing V2 database to the V3 format on first boot. Old blocks and account state are fully preserved.

v3.0.0-alpha — KATENET LAUNCH: MANDATORY UPDATE (2026-08-05)

• Delegated Proof of Stake (DPoS): Consensus is no longer just for whales. Native delegation allows any QUA holder to lock their tokens behind a trusted BFT validator to secure the network and earn a share of block rewards.
• Network Isolation: Bumped PROTOCOL_VERSION to 35 and TESTNET_MAGIC to QT35 to cleanly evict all V2 nodes.

This is a pre-release testnet build. Do not use real funds. APIs and chain parameters may change between alpha releases.

---

🛠️ How to Run a Validator Node

🟢 STAKING IS OPEN! The network is fully transitioned to DPoS mechanics. Anyone who stakes at least 100,000 QUA can run a validator node, propose blocks, and earn rewards!

To join the network, you need to point your node to the bootstrap VPS. Below are the three ways to run the node, ordered by recommendation.

Option 1: Native Docker Run (Recommended)

This is the easiest and most direct way to run your validator. Just ensure you pass the --bootstrap flag to connect to the network.

1. Pull the Latest Image

docker pull xd637/quanta-node:latest

2. Start the Node

Important

Change "YOUR_PASSWORD_HERE" to your actual wallet password, and ensure validator.qua matches your wallet filename!

docker run -d \
  --name quanta-validator \
  --restart always \
  --network host \
  -v ~/quanta_data_v2:/home/quanta/quanta_data \
  -e QUANTA_WALLET_PASSWORD="YOUR_PASSWORD_HERE" \
  xd637/quanta-node:latest \
  quanta start --validator-wallet /home/quanta/quanta_data/validator.qua --bootstrap node1.quantachain.org:8333

---

Option 2: Docker Compose

If you prefer managing your containers via Docker Compose, create a docker-compose.yml file with the following configuration:

version: '3.8'
services:
  quanta-node:
    image: xd637/quanta-node:latest
    container_name: quanta_validator
    restart: unless-stopped
    network_mode: "host"
    volumes:
      - ~/quanta_data_v2:/home/quanta/quanta_data
    environment:
      - QUANTA_WALLET_PASSWORD=YOUR_PASSWORD_HERE
    command: >
      quanta start
      --validator-wallet /home/quanta/quanta_data/validator.qua
      --bootstrap node1.quantachain.org:8333

Start the Node:

docker compose up -d

---

Option 3: Native Source Build

For developers or those who prefer running natively without Docker:

1. Clone and Build

git clone https://github.com/quantachain/quanta.git
cd quanta
git checkout v2.4.0
cargo build --release

2. Run the Node

./target/release/quanta start -c quanta.toml --validator-wallet ./quanta_data/validator.qua --bootstrap node1.quantachain.org:8333

---

Option 4: Advanced Configuration (quanta.toml Override)

If you want full control over your node's configuration instead of relying on CLI arguments like --bootstrap, you can provide your own quanta.toml file. This is useful for customizing port bindings, max peers, or API rate limits.

When using Docker, you can mount your local quanta.toml to override the default one baked into the image. Just add a -v flag to your docker run command:

docker run -d \
  --name quanta-validator \
  --restart always \
  --network host \
  -v ~/quanta_data_v2:/home/quanta/quanta_data \
  -v ~/my-local-quanta.toml:/home/quanta/quanta.toml \
  -e QUANTA_WALLET_PASSWORD="YOUR_PASSWORD_HERE" \
  xd637/quanta-node:latest \
  quanta start --validator-wallet /home/quanta/quanta_data/validator.qua

This completely overrides the baked configuration with your own file.

---

Wallet Management

If you need to generate a wallet before starting your node:

# New HD Wallet (Recommended)
quanta-wallet new --file my_wallet.json

# New Raw Wallet
quanta-wallet new-raw --file my_raw.qua

---

License

QUANTACHAIN operates under an Open-Core Dual License model:

• Core Protocol: GNU AGPLv3
• Native Templates & APIs: QuantaLabs Commercial License

For commercial licensing: contact@quantachain.org