QFC Testnet

Join the QFC (Quantum-Flux Chain) public testnet.

Network Info

Item	Value
Chain ID	`9000`
RPC	`https://rpc.testnet.qfc.network`
WebSocket	`wss://rpc.testnet.qfc.network/ws`
Explorer	`https://explorer.testnet.qfc.network`
Faucet	`https://faucet.testnet.qfc.network`
Block Time	~3 seconds
Consensus	Proof of Contribution (PoC)

Quick Start (Docker)

# Download config files
curl -sLO https://raw.githubusercontent.com/qfc-network/testnet/main/docker-compose.yml
curl -sLO https://raw.githubusercontent.com/qfc-network/testnet/main/genesis.json

# Start a full node
docker compose up -d

# Check logs
docker logs -f qfc-node

That's it. Your node will connect to the bootnode and start syncing.

Mining (optional)

Contribute compute power and earn the 20% compute contribution score in PoC:

QFC_MINING_ENABLED=true QFC_MINING_THREADS=4 docker compose up -d

Validator (requires stake)

Run a validator node (requires 10,000+ QFC staked):

QFC_VALIDATOR_KEY=<your-secret-key-hex> QFC_MINING_ENABLED=true docker compose up -d

Build from Source

git clone https://github.com/qfc-network/qfc-core.git
cd qfc-core
cargo build --release

# Run full node
./target/release/qfc-node \
  --datadir ./data \
  --bootnodes "/ip4/bootnode.testnet.qfc.network/tcp/30303/p2p/<PEER_ID>"

# With mining
./target/release/qfc-node \
  --datadir ./data \
  --bootnodes "/ip4/bootnode.testnet.qfc.network/tcp/30303/p2p/<PEER_ID>" \
  --mine --threads 4

Get Test Tokens

Visit the Faucet to get 100 QFC (24h cooldown).

Add to MetaMask

Field	Value
Network Name	QFC Testnet
RPC URL	`https://rpc.testnet.qfc.network`
Chain ID	`9000`
Symbol	`QFC`
Explorer	`https://explorer.testnet.qfc.network`

Verify Your Node

# Current block height
curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

# Node info & peer count
curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qfc_nodeInfo","params":[],"id":1}'

Become a Validator

Get 10,000+ QFC from the faucet or community
Generate a validator key: ./target/release/qfc-node keygen
Stake your QFC via the staking RPC
Start with QFC_VALIDATOR_KEY=<key> QFC_MINING_ENABLED=true docker compose up -d

PoC Contribution Scores

Your validator priority is determined by 7 dimensions:

Dimension	Weight	How to Earn
Staking	30%	Stake more QFC
Compute	20%	Enable mining (`--mine`)
Uptime	15%	Keep your node online
Accuracy	15%	Don't miss assigned blocks
Network	10%	Good P2P connectivity
Storage	5%	Serve state snapshots
Reputation	5%	Long-term honest behavior

Inference Miner (Earn Rewards with AI Compute)

QFC v2.0 supports AI inference mining — provide compute power to run AI models and earn QFC rewards.

One-Click Start (macOS / Linux)

curl -sLO https://raw.githubusercontent.com/qfc-network/qfc-miner/main/scripts/start-miner.sh
chmod +x start-miner.sh
./start-miner.sh

The script automatically:

Detects your hardware (CPU / Metal / CUDA / OpenCL)
Downloads the pre-built binary for your platform
Generates a wallet
Requests faucet tokens
Starts mining

No Rust toolchain required — downloads pre-built binaries. Falls back to build-from-source if needed.

Windows (PowerShell)

iwr https://raw.githubusercontent.com/qfc-network/qfc-miner/main/scripts/install.ps1 | iex

Requires: Windows 10/11 x86_64, PowerShell 5.1+ NVIDIA GPU: Automatically used if nvidia-smi is found

Supported Platforms

Pre-built binaries live in two repos. start-miner.sh pulls from both automatically; if you download manually, use the repo marked below.

Platform	File	GPU Support	Release repo
macOS Apple Silicon	`qfc-macos-arm64.tar.gz`	Metal	qfc-miner + qfc-core
macOS Intel	`qfc-macos-intel.tar.gz`	CPU	qfc-miner + qfc-core
Linux x86_64	`qfc-linux-x86_64.tar.gz`	CPU	qfc-miner + qfc-core
Linux x86_64 CUDA	`qfc-linux-x86_64-cuda.tar.gz`	NVIDIA GPU (H100/H200/A100/RTX)	qfc-miner only
Linux x86_64 OpenCL	`qfc-linux-x86_64-opencl.tar.gz`	AMD/Intel GPU via OpenCL	qfc-miner only
Linux x86_64 ROCm	`qfc-linux-x86_64-rocm.tar.gz`	AMD GPU via ROCm	qfc-core only
Linux ARM64	`qfc-linux-arm64.tar.gz`	CPU	qfc-miner + qfc-core
Linux ARM64 CUDA	`qfc-linux-arm64-cuda.tar.gz`	NVIDIA GPU (DGX Spark / Grace Blackwell)	qfc-miner only
Windows x86_64	`qfc-windows-x86_64.zip`	CPU	qfc-miner only

GPU auto-detection priority: CUDA > Metal > ROCm > OpenCL > CPU.

If start-miner.sh reports "No pre-built binary found for <platform>", fall back is a build from source (requires Rust toolchain + any platform-specific SDK like CUDA). To override the download repos: QFC_BINARIES_REPO=qfc-network/qfc-miner QFC_SOURCE_REPO=qfc-network/qfc-core.

Manual Setup

# 1. Build (Intel Mac or Linux CPU-only)
git clone https://github.com/qfc-network/qfc-core.git
cd qfc-core
cargo build --release --features candle --bin qfc-miner

# Apple Silicon (Metal GPU):
# cargo build --release --features coreml --bin qfc-miner

# NVIDIA GPU (CUDA):
# cargo build --release --features cuda,candle --bin qfc-miner

# AMD/Intel GPU (OpenCL):
# cargo build --release --features opencl,candle --bin qfc-miner

# 2. Generate wallet
./target/release/qfc-miner --generate-wallet

# 3. Start mining
./target/release/qfc-miner \
  --wallet <YOUR_WALLET_ADDRESS> \
  --private-key <YOUR_PRIVATE_KEY> \
  --validator-rpc https://rpc.testnet.qfc.network \
  --backend auto

Windows CUDA Build (from source)

Building with CUDA on Windows requires the CUDA Toolkit and MSVC (Visual Studio Build Tools):

# Prerequisites:
#   1. Install Visual Studio 2022 Build Tools (with "Desktop development with C++")
#   2. Install CUDA Toolkit 12.x from https://developer.nvidia.com/cuda-downloads
#   3. Install Rust from https://rustup.rs

# Open "x64 Native Tools Command Prompt" or run from PowerShell:
git clone https://github.com/qfc-network/qfc-core.git
cd qfc-core

# Set CUDA_PATH if not already set by the installer
$env:CUDA_PATH = "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.6"

# Set the compute capability for your GPU (89 = RTX 40xx, 86 = RTX 30xx)
$env:CUDA_COMPUTE_CAP = "89"

cargo build --release --features cuda,candle --bin qfc-miner

If link.exe reports missing CUDA libraries, verify that %CUDA_PATH%\lib\x64 contains cudart.lib, cublas.lib, etc. The build script auto-detects CUDA_PATH and adds the library directories.

GPU Tiers & Supported Tasks

Tier	Memory	Hardware Examples	Tasks
Hot	32 GB+	M2 Ultra, M3 Max, A100, H100, H200	All models, large LLMs
Warm	16–31 GB	M1/M2/M3 Pro, RTX 4090, DGX Spark	Medium models, embeddings
Cold	< 16 GB	Intel Mac, M1/M2 base, RTX 3060	Small models, embeddings

Environment Variables

Variable	Default	Description
`QFC_MINER_RPC_URL`	`https://rpc.testnet.qfc.network`	Validator RPC endpoint
`QFC_MINER_WALLET`	—	Wallet address (hex)
`QFC_MINER_PRIVATE_KEY`	—	Private key (hex)
`QFC_MINER_BACKEND`	`auto`	`cpu`, `metal`, `cuda`, `opencl`, or `auto`
`QFC_MINER_MODEL_DIR`	`./models`	Model cache directory
`QFC_MINER_MAX_MEMORY`	`0` (auto)	Max memory in MB

Docker

docker run -e QFC_MINER_WALLET=<ADDR> \
           -e QFC_MINER_PRIVATE_KEY=<KEY> \
           -e QFC_MINER_RPC_URL=https://rpc.testnet.qfc.network \
           -e QFC_MINER_BACKEND=auto \
           ghcr.io/qfc-network/qfc-core:latest

How It Works

Miner fetches inference tasks from the network (every ~10s)
Loads the required AI model (cached after first download)
Runs inference and submits a cryptographic proof
Validators verify proofs (5% random spot-check)
Honest miners earn block rewards proportional to compute contribution
Dishonest proofs → 5% stake slash + 6h ban

Can I Use Existing Mining Hardware?

QFC inference mining requires general-purpose compute (CPU/GPU) to run AI models — not hash-specific ASICs.

Hardware	Compatible	Notes
ETH GPU rigs (NVIDIA)	Yes	RTX 3060/3070/3080/3090 → `linux-x86_64-cuda`
ETH GPU rigs (AMD)	Yes	RX 6800/6900/7900 → `linux-x86_64-opencl`
NVIDIA datacenter	Yes	A100/H100/H200/B200 → `linux-x86_64-cuda`
NVIDIA DGX Spark	Yes	Grace Blackwell ARM → `linux-arm64-cuda`
Apple Mac	Yes	M1/M2/M3/M4 → Metal GPU acceleration
BTC ASIC (Antminer S19/S21)	No	SHA-256 only, no general compute
LTC ASIC (Scrypt)	No	Fixed-function chip
FPGA miners	No	Cannot run AI models

Post-Merge Ethereum GPU rigs are a great fit — start-miner.sh auto-detects your GPU and downloads the right binary.

Hardware Requirements

Role	CPU	RAM	Disk	Network
Full node	2 cores	4 GB	50 GB SSD	10 Mbps
Mining node	4+ cores	4 GB	50 GB SSD	10 Mbps
Inference miner	2+ cores	8 GB+	20 GB SSD	10 Mbps
Validator	4 cores	8 GB	100 GB SSD	50 Mbps

Troubleshooting

Node not syncing?

Check port 30303 is open (firewall / security group)
Verify genesis.json matches (re-download if unsure)

Reset node data:

docker compose down -v
docker compose up -d

Update to latest:

docker compose pull
docker compose up -d

Update miner:

./start-miner.sh --update

Links

QFC Core — Blockchain source code
Explorer — Block explorer
Faucet — Get test tokens
Games — On-chain casino games
NFT Marketplace — NFT marketplace

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
.github/workflows		.github/workflows
scripts		scripts
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
README.md		README.md
docker-compose.yml		docker-compose.yml
genesis.json		genesis.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

QFC Testnet

Network Info

Quick Start (Docker)

Mining (optional)

Validator (requires stake)

Build from Source

Get Test Tokens

Add to MetaMask

Verify Your Node

Become a Validator

PoC Contribution Scores

Inference Miner (Earn Rewards with AI Compute)

One-Click Start (macOS / Linux)

Windows (PowerShell)

Supported Platforms

Manual Setup

Windows CUDA Build (from source)

GPU Tiers & Supported Tasks

Environment Variables

Docker

How It Works

Can I Use Existing Mining Hardware?

Hardware Requirements

Troubleshooting

Links

About

Uh oh!

Releases 5

Packages

Uh oh!

Contributors

Uh oh!

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

QFC Testnet

Network Info

Quick Start (Docker)

Mining (optional)

Validator (requires stake)

Build from Source

Get Test Tokens

Add to MetaMask

Verify Your Node

Become a Validator

PoC Contribution Scores

Inference Miner (Earn Rewards with AI Compute)

One-Click Start (macOS / Linux)

Windows (PowerShell)

Supported Platforms

Manual Setup

Windows CUDA Build (from source)

GPU Tiers & Supported Tasks

Environment Variables

Docker

How It Works

Can I Use Existing Mining Hardware?

Hardware Requirements

Troubleshooting

Links

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 5

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages