Skip to main content
The Quantum Chain reference client is distributed as source. Build it with Go 1.24 or later.

​
Prerequisites

ToolVersion
Go1.24+
GNU Makeany
C compilergcc or clang (for cgo)
Gitany

​
Build from source

git clone https://github.com/Quantum-Chain-PTE-LTD/go-quantum-chain.git
cd go-quantum-chain
make geth
The geth binary lands at build/bin/geth. Confirm: 
./build/bin/geth version
To build all supporting tools: 
make all
This produces:
BinaryPurpose
build/bin/gethFull Quantum Chain node
build/bin/keygeneratorGenerate post-quantum keypairs and mnemonics
build/bin/ethkeyInspect and manage keystore files
build/bin/clefExternal signer (hot wallet)
build/bin/abigenSolidity ABI binding generator
build/bin/bootnodeDiscovery v4 bootnode
build/bin/evmStandalone QVM for testing
build/bin/rlpdumpRLP decoder
build/bin/qc-custodyQustody custody service binary

​
Verify the build

Run the unit-test suite: 
go test ./...
To run only the post-quantum signature tests: 
go test ./crypto/...

​
Container image

A multi-stage Dockerfile is provided at the repo root: 
docker build -t quantum-chain:latest .
docker run --rm -p 8545:8545 -p 30303:30303 quantum-chain:latest \
  --networkid 20803 \
  --http --http.addr 0.0.0.0 --http.port 8545
For all-in-one images including ancillary tooling, use Dockerfile.alltools.

​
System requirements

ProfileRAMDiskNotes
Light client4 GB30 GB SSDEnough for read-only RPC
Full node16 GB1 TB SSDRecommended for most operators
Archive node32 GB4 TB+ NVMeRequired only if you need historical state
Validator (Clique sealer)8 GB500 GB SSDPlus highly available networking

​
Where to go next