Skip to content

QuantaChain Katenet Release (v3.2.7-alpha)

Choose a tag to compare

View all tags
@XD637 XD637 released this 05 Sep 16:56
· 9 commits to main since this release
v3.2.7-alpha
c53fa86

Quanta Alpha Release Notes

Current Version: v3.2.7-alpha — Fix Yamux Capacity Crash

This release patches a critical network leak that was causing the node's Yamux stream capacity to max out, leading to consensus stalling (0 valid sigs, need 1) during heavy AlephBFT synchronization.

🔴 Mandatory Upgrade — Protocol v63

This is a mandatory upgrade. Nodes running older protocols will be rejected. The network magic has also been bumped to QT63.
To rejoin: docker-compose pull && docker-compose up -d.

What's New

Fixed: RequestResponse Stream Exhaustion

  • The Bug: Quanta uses the libp2p RequestResponse protocol for point-to-point messaging (such as AlephBFT signatures and fetches). Previously, the node handled incoming requests but silently dropped the response channel. Since no response was ever sent, the Yamux streams remained half-open until they timed out 20 seconds later. During intense BFT synchronization, this caused the node to rapidly exhaust Yamux's 256-stream limit, logging WARN Dropping inbound stream because we are at capacity and stalling consensus completely.
  • The Fix: The node now explicitly sends a dummy VerAck response back through the channel when a request is received. This cleanly and immediately closes the underlying Yamux stream, preventing any leaks.
  • Buffer Increase: As a secondary safety measure, the Yamux max_num_streams has been significantly increased from the default 256 to 8192 to handle massive bursts of concurrent network traffic in production.
  • Protocol Bump: Bumped PROTOCOL_VERSION to 63 and TESTNET_MAGIC to QT63 to enforce a clean reset of the consensus participants.

Previous Releases (Summary)

Version Date Summary
v3.2.5-alpha 2026-09-05 BFT peer resolution fix — unicast messages were silently dropped due to missing node_id resolution in handshake handler
v3.2.4-alpha 2026-09-04 Connection tracking fix — libp2p ghost connections leaked on reconnect, causing capacity errors. Protocol bumped to v60
v3.2.3-alpha 2026-09-02 Strict v58 handshake rejection + log noise reduction
v3.2.2-alpha 2026-09-02 Sync & stability — O(1) cumulative work calc, egress spam disabled, peer liveness fix. Protocol bumped to v59
v3.2.0-alpha 2026-09-01 Swarm release — replaced raw TCP with libp2p Gossipsub + Kademlia DHT
v3.1.5-alpha 2026-09-01 State actor refactoring + sync deadlock fix. Protocol bumped to v56

For full history see CHANGELOG.md.

🛠️ 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
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.

Staking & Delegation

Minimum stake to become a validator: 100,000 QUA. Your wallet's Falcon-512 public key is automatically used for BFT signing.

Become a Validator (Stake)

# Register as a BFT validator by staking QUA
quanta-wallet stake \
  --wallet /home/quanta/quanta_data/validator.qua \
  --amount 100000 \
  --fee 0.01 \
  --node http://localhost:3000

Stop Validating (Unstake)

# Deregister and begin the 2-epoch unbonding period
quanta-wallet unstake \
  --wallet /home/quanta/quanta_data/validator.qua \
  --fee 0.01 \
  --node http://localhost:3000

Delegate to a Validator (Non-validators)

Don't want to run a node? Delegate your QUA to an active validator and earn a share of rewards.

# Delegate QUA to an existing validator
quanta-wallet delegate \
  --wallet /home/quanta/quanta_data/my_wallet.qua \
  --validator 0x0217a3fcbadd38e31761f9f949954e9f2ac2503d \
  --amount 10000 \
  --fee 0.01 \
  --node http://localhost:3000

# Undelegate (locks for unbonding period before becoming spendable)
quanta-wallet undelegate \
  --wallet /home/quanta/quanta_data/my_wallet.qua \
  --validator 0x0217a3fcbadd38e31761f9f949954e9f2ac2503d \
  --fee 0.01 \
  --node http://localhost:3000

License

QUANTACHAIN operates under an Open-Core Dual License model:

For commercial licensing: contact@quantachain.org

Assets 2
Loading