What is this?

This is the Quantum Matrix Chain — a real blockchain with a built-in quantum layer that makes new blocks every 30 seconds. Signatures are Dilithium. The live block label is quantum-sim, which means a simulator, not a quantum computer.

The token on this chain is called QWD (Quantum WeAD). You can send it, receive it, and even create your own tokens on top of it.

Step 1: Create a Wallet

A wallet is like your own personal bank account on the blockchain.

1. Look at the Wallet section on the right side.
2. Click Create Wallet.
3. Your keys are generated entirely in your browser using Dilithium (ML-DSA-44) cryptography. Your secret key never touches the server.
4. You will get 3 things:
   • Address — this is your account number. You can share it with anyone.
   • Public Key — used to verify you are who you say you are.
   • Secret Key — this is your password. Never share this with anyone!

Step 2: Get Free QWD (Faucet)

You start with 0 QWD. To get some for free:

1. Your address is already filled in after creating a wallet.
2. Click Get Free QWD in the Faucet section.
3. You will get 1,000 QWD for free! You can do this once per hour.

Step 3: Send QWD to Someone

Want to send some QWD to a friend?

1. Go to the Send Transaction section on the left.
2. Your address and keys are already filled in.
3. Type the Recipient Address (your friend's wallet address).
4. Type the Amount you want to send.
5. Click Send.
6. Your transaction goes into the "waiting room" (mempool) and gets added to the next block!

Step 4: Check Your Balance

1. Go to the Balance section.
2. Your address should already be there.
3. Click Check Balance to see how much QWD you have.

Step 5: Search for Things

You can look up any transaction or address:

1. Go to Search Transaction or Address.
2. Paste a transaction ID or a wallet address.
3. Click Search to see the details.

What are Blocks?

A block is like a page in the notebook. Every 30 seconds, a new page is added. Each page contains all the transactions that happened during that time.

Click on any block in the Live Blocks table to see what's inside it.

What is Staking?

The live set is four WeAD validators. Staking at least 10,000 QWD records a request. It does not add you to the block-producing set. Applications do not turn on by themselves.

1. Go to the Staking section.
2. Make sure you have at least 10,000 QWD.
3. Put your address and stake amount.
4. Click Stake.

Want to stop being a validator? Click Unstake. After a waiting period (100 blocks), click Claim Unstake to get your QWD back.

What is QWD-20 Token?

You can create your own token on this chain. The standard is called QWD-20.

1. Go to the QWD-20 Token section.
2. First, create a wallet and get some QWD from the faucet.
3. Type a Token Name, Symbol, and Total Supply.
4. Click Build Deploy TX to create the transaction.

What is the Network Section?

This shows info about the blockchain network:

• Chain ID — the unique ID of this blockchain (7771 for mainnet, 7772 for testnet).
• Block Interval — how often new blocks are made (every 30 seconds).
• P2P — other computers (nodes) are connected and share blocks with each other in real-time.
• Network Badge — the green or yellow badge at the top tells you if you are on mainnet (real) or testnet (practice).

The RPC buttons let you talk directly to the blockchain using a special API that developers use.

What is the Bridge (QMC to Soneium)?

The bridge can lock QWD here and mint wrapped QWD on Soneium. The way back is not live yet.

1. Bridge Lock — you lock your QWD here. The bridge then creates matching tokens on your selected target chain.
2. Bridge Release — the return path is not live. Burning wrapped QWD on Soneium does not put native QWD back in your QMC wallet.

To use it:

1. Create a wallet and get some QWD first.
2. In the Bridge section, choose your target chain and put your wallet address (starts with 0x).
3. Set the amount you want to bridge.
4. Click Bridge Lock TX.

QMC Web Wallet

There is a separate Web Wallet page at /qmc-wallet. It lets you:

• Create or import a wallet that stays encrypted in your browser.
• Lock your wallet with a password so nobody else can use it.
• Send QWD, stake, check token balances — all from one place.
• Connect to other apps using window.qmc (like MetaMask for QMC!).

For Developers: JavaScript SDK

If you are building an app on QMC, there is a JavaScript SDK you can use:

• QMCProvider — connects to the chain (reads blocks, balances, etc.)
• QMCWallet — generates wallets locally and signs transactions in the browser.
• QWD20Contract — interacts with QWD-20 tokens (transfer, approve, etc.)

For Developers: Custom Smart Contracts

Besides QWD-20 tokens, you can deploy custom contracts with simple stack-based bytecode. The VM supports:

• Math: ADD, SUB, MUL, DIV, MOD
• Logic: EQ, LT, GT, AND, OR, NOT, IF/ELSE/ENDIF
• Storage: SLOAD, SSTORE (read/write data on-chain)
• Context: CALLER, TIMESTAMP, BLOCKHASH
• Events: LOG (emit events that show up in qwd_getLogs)

What Makes This Blockchain Special?

• Quantum-Proof Signatures — your wallet uses Dilithium, a type of math that even future quantum computers can't crack.
• Client-Side Signing — your secret key is generated and used only in your browser. It never leaves your device. Not even the server sees it.
• Random seed — the proposer seed uses ANU quantum random numbers when that pool has bytes. When it does not, the chain uses a labelled classical generator and does not call that block quantum-random. The page shows which one it was.
• Spectral receipt — every block carries a spectral receipt the other validators can recompute. The live receipt is a simulator (quantum-sim). It is not proof that a quantum computer made the block. Hardware proofs stay off until a measured hardware epoch exists.
• P2P Network — multiple nodes share blocks and transactions with each other automatically.
• Mainnet + Testnet — practice on testnet (chain ID 7772) before going live on mainnet (chain ID 7771).
• Soneium bridge — one way today. Lock QWD here to mint wrapped QWD on Soneium. You cannot bring it back yet.

Quick Reference

• Token: QWD (Quantum WeAD)
• Chain ID: 7771 (mainnet) / 7772 (testnet)
• New block every: 30 seconds
• Minimum stake: 10,000 QWD
• Faucet: 1,000 QWD per hour (mainnet) / 10,000 QWD unlimited (testnet)
• Transaction fee: 0.001 QWD
• Signature: Dilithium (post-quantum)
• RPC endpoint: POST /rpc
• Web Wallet: /qmc-wallet
• JS SDK: @wead/qmc-sdk is not published. Use /qmc-wallet or POST /rpc.
• Bridge: QMC to Soneium, one way