Skip to content

Quantachain Testnet Alpha V2.1.2

Choose a tag to compare

View all tags
@XD637 XD637 released this 06 Jul 07:13
v2.1.2-alpha
8315d30

QuantaChain Testnet — V2 Release (v2.1.2-alpha)

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

v2.1.2-alpha — HARD RESET (2026-07-06)
WIPE REQUIRED. To enable dynamic network scaling and facilitate a faster rollout of upgrades, the testnet has been reset to a streamlined 4-core validator set. You MUST delete your quanta_data folder before starting this version! The network magic has changed to Q2TB.

How to update and start your node:

# 1. Stop and remove the old container
docker stop quanta-validator && docker rm quanta-validator

# 2. Delete the old blockchain data (REQUIRED!)
sudo rm -rf ~/quanta_data_v2

# 3. Pull the new image and start
docker pull xd637/quanta-node:latest

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 34.87.128.33:8333

Staking is OPEN! We have set OPEN_VALIDATOR_REGISTRATION_HEIGHT = 0 so new validators can stake and join instantly!

v2.1.1-alpha — SOFT UPDATE (2026-07-06)
NO WIPE REQUIRED. A bypass was added for block 12615 to resolve the state root consensus bug. The blockchain data format and network magic (Q2T9) have not changed. DO NOT delete your quanta_data folder!

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

Genesis Block

Parameter Value
Network Testnet (QUA7)
Timestamp 1780704001 (2026-06-06 00:00:01 UTC)
Testnet Genesis Hash ae37fe2f40a7e7dbe6d2d1337f260d57185ef5fb169008e2600f245809fd1fbf
Faucet 0 (API sender) 0xec4f49553e31f22b27a83036a044aff7d697f524
Block Time Exactly 6 seconds
TPS Limit ~250 - 300 TPS (assuming 2MB block limit)

🔄 Clean Start Guide (Wipe Data & Resync from Genesis)

You MUST perform a clean start to join the V2 Testnet!
The V2 BFT consensus engine uses a different block structure and state machine. It will crash if it reads old V1 PoW blocks.

Bare Metal / VPS (no Docker)

pkill -f "quanta start"    # stop the old node
rm -rf ./quanta_testnet_data  # WIPE THE OLD POW CHAIN DATA!
cargo build --release      # compile the new V2 binary
./target/release/quanta start -c quanta.toml

Docker Validators (Safe Wipe)

If you are an existing validator using Docker, you must wipe the old chain data but KEEP your validator wallet file. Since you may have named your wallet file something other than validator.qua, you must be extremely careful.

Caution

If you run the rm -rf command below without successfully moving your wallet out first, you will delete your validator wallet forever!

Step 1: Stop your node and move your wallet out of the data folder. (Replace validator.qua with your actual wallet filename if it is different!)

docker stop quanta-validator
mv ~/quanta_data_v2/validator.qua ~/validator.qua.backup

Step 2: Verify your wallet is safe in your home directory, then wipe the old data.

ls ~/validator.qua.backup     # Verify it exists!
sudo rm -rf ~/quanta_data_v2/*

Step 3: Move your wallet back in (again, replacing validator.qua with your actual filename if different), and restart the node.

mv ~/validator.qua.backup ~/quanta_data_v2/validator.qua
docker start quanta-validator

Validator Setup (Docker)

⚠️ ATTENTION: This is currently a strictly permissioned testnet designed only for testing. Only the validators explicitly hardcoded in the Genesis set can run a node and produce blocks.
Once the network matures, we will implement full DPoS, allowing anyone to stake and participate in consensus. Until then, if you would like early access to participate, please email: contact@quantachain.org

If you have been selected as a validator, follow these exact instructions to spin up your validator node and connect to the core network using Docker:

1. Create a Wallet and Get Your Key
You must generate a raw wallet and provide the public key to the core team to be whitelisted in the Genesis block.

docker run --rm -it xd637/quanta-node:latest quanta-wallet new-raw --file /tmp/validator.qua

2. Directory Setup
Create the directory where your blockchain data will live. We recommend adding _v2 to avoid mixing it with any old testnet data:

mkdir -p ~/quanta_data_v2

3. Place Your Wallet File
Move your validator wallet file (e.g., validator.qua or whatever you named it) directly into the ~/quanta_data_v2 directory you just created.

Your folder should look exactly like this:

~/quanta_data_v2/
└── validator.qua

(Note: You do NOT need the genesis.json or quanta.toml files! The latest network configuration is securely baked directly into the V2 Docker image.)

4. Pull the Latest Image & Start the Node
Run the following Docker commands to pull the latest V2 build, launch your node, connect to the Bootstrap node, and begin proposing blocks.

Important

Before running the second command below, you MUST change two things:

  1. Change "YOUR_PASSWORD_HERE" to your actual wallet password.
  2. Change validator.qua at the very end of the command to match the exact name of your wallet file.
docker pull xd637/quanta-node:latest

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 34.87.128.33:8333

Wallet Management

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

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

# AI Headless Mode (Set env var to skip password prompts)
export QUANTA_WALLET_PASSWORD="your_password"
quanta-wallet info --file my_wallet.json

Ports

Port Service
3000 REST API
8333 P2P Network
7782 RPC
9090 Prometheus Metrics

License

QUANTACHAIN operates under an Open-Core Dual License model:

Component License
Core Protocol GNU AGPLv3
Native Templates & APIs QuantaLabs Commercial License

For commercial licensing: contact@quantachain.org

Assets 2
Loading
0 Join discussion