DocsGetting Started
Getting Started

Quick start

Connect to the QuanChain testnet, fund a wallet, and broadcast a transaction. Five minutes, end to end.

Beginner6 min read
What you get

What QuanChain is, in one paragraph

QuanChain is a three-channel layer-one designed for the quantum-adaptive era. Channel 1 settles micro-transactions in roughly 200 ms. Channel 2 finalises smart-contract calls in about 2 seconds. Channel 3 stores larger payloads with a 10-second commitment window. Every wallet on the network uses TADEQS, a 20-level security ladder that rotates keys atomically on each spend so no public key sits exposed between transactions.

Three channels

Pick the channel that fits the payload — 200 ms, 2 s, or 10 s finality.

Quantum-adaptive

Composite Level 20 wallets sign with ML-DSA-87 + SLH-DSA-SHA2-256f.

SpendAndRotate

Every transaction derives a fresh child wallet inside the same block.

Endpoints

Network details

The testnet runs continuously and is funded by a faucet. Production endpoints are published separately after mainnet launch.

json
{
  "name": "QuanChain Testnet",
  "chainId": 8453021,
  "rpc": "https://rpc-testnet.quanchain.ai",
  "ws":  "wss://ws-testnet.quanchain.ai",
  "explorer": "https://quanchain.ai/testnet",
  "currency": { "symbol": "QCH", "decimals": 18 },
  "channels": {
    "1": { "name": "Transaction Highway", "finality": "200ms" },
    "2": { "name": "Smart Contracts",     "finality": "2s"    },
    "3": { "name": "Data Storage",        "finality": "10s"   }
  }
}
Note
The RPC routes qc_* namespace methods natively. Standard eth_* equivalents are emulated for compatibility with existing tooling.
Step 1

Install the QuanChain wallet

The QuanChain browser wallet ships with native TADEQS support and signs composite Level 20 transactions directly. Third-party wallets can be used through the Web3-compatible bridge, but they cannot generate parent identities.

Chrome extension

Download from /resources/wallets. Manifest V3, hardware-key compatible.

Mobile (beta)

iOS and Android builds available to early-access testers via TestFlight.

After install, open the wallet, choose Create new identity, and write the 24-word seed phrase down. The seed phrase derives the Level 20 parent — losing it means losing recovery authority over every child wallet.

Step 2

Fund the wallet from the faucet

The testnet faucet dispenses 100 QCH per request, rate-limited to one request per address every 24 hours. Visit the faucet page or call the API directly:

bash
curl -X POST https://quanchain.ai/api/faucet \
  -H "Content-Type: application/json" \
  -d '{ "address": "QC20_<your-parent-address>" }'

The faucet routes through Channel 1, so the funds appear in the wallet within a few hundred milliseconds.

Step 3

Send the first transaction

A transfer on Channel 1 uses the active child wallet. The signing keys are rotated atomically — the moment the transaction is included, a fresh child takes over.

typescript
import { QuanChain } from '@quanchain/sdk';

const chain = new QuanChain({ network: 'testnet' });
const wallet = await chain.wallet.fromSeed(process.env.SEED!);

const receipt = await wallet.transfer({
  to: 'QC10_2k9...f81a',
  amount: '5.0',          // QCH
  channel: 1,
});

console.log('Block:', receipt.blockHeight);
console.log('Rotated to:', receipt.newChildAddress);
That is the rotation
The newChildAddress field is the freshly derived child wallet. The previous child is now retired and its public key will never be re-used. The parent identity stays the same.
Step 4

Connect over RPC

The JSON-RPC endpoint accepts both QuanChain-native methods and emulated eth_* calls. A quick health check:

bash
curl https://rpc-testnet.quanchain.ai \
  -X POST -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method":  "qc_chainHead",
    "params":  [1],
    "id":      1
  }'

Reach the full method list in the API reference.

Next

Where to go from here

TADEQS deep-dive

How the 20-level ladder and SpendAndRotate work under the hood.

Smart contracts

Deploy a contract on Channel 2 with the QuanChain Solidity dialect.

API reference

Full JSON-RPC method list, websocket subscriptions, and examples.

Run a validator

Hardware requirements, stake mechanics, and node operation guide.

Want help?

Join the developer Discord, open a GitHub issue, or read the whitepaper.