Linux
QRL 2.0 / Testnet V2
From zero to deployed on QRL 2.0.
Run a node, secure a wallet, acquire test QRL, deploy a contract, and connect a working interface.
Before you begin
Use this guide to find your way.
This guide currently covers QRL 2.0 through Testnet V2. Follow the journey from running a node to connecting a dApp, and refer to the official documentation for the latest commands and network configuration.
Ecosystem listings are community-maintained and provided for information only. Inclusion does not imply endorsement, security review, or compatibility.
Node
Run a QRL 2.0 Testnet V2 node.
Build and start the
gqrl execution client and the Qrysm consensus client. Use the maintained guide for your operating system so network files, bootstrap nodes, and launch flags stay current.From the ecosystem index
Node and RPC infrastructure
Community-listed infrastructure that supports the QRL 2.0 testnet.
Network operations
Go QRL Execution Client
The official Go execution-layer client for QRL 2.0, providing full, archive, and light node modes, QRVM smart-contract execution, HTTP, WebSocket, and IPC JSON-RPC interfaces, and contract developer utilities.
Network operations
Qrysm
The official Go consensus-layer client for QRL 2.0, coordinating proof-of-stake beacon nodes and validators with the Go QRL execution client as part of a complete QRL 2.0 node.
Shown alphabetically from active index listings. Status is displayed for context; no ranking or recommendation is implied.
Ready for the next step whenBoth clients remain running and the local JSON-RPC endpoint responds.
Sync
Verify the node is ready.
Query the execution client before relying on it. The official checks cover the current block height, synchronization progress, and connected peers.
Ready for the next step whenThe block height advances,
qrl_syncing returns false, and the peer count is greater than zero.Wallet
Create and secure a wallet.
Create a fresh Testnet V2 account using a compatible wallet. Record the recovery material offline, verify it before receiving funds, and never paste it into a website or support conversation.
From the ecosystem index
Choose a testnet wallet
Active wallet projects in the index that declare QRL 2.0 testnet support.
Security, custody & account management
MyQRLWallet
A family of wallet applications for QRL 2.0: web wallet, Android app, desktop wallet, and browser extension, with post-quantum dApp connectivity over the QRL Connect relay protocol.
Security, custody & account management
QRL Web3 Wallet
A Chromium-based browser extension wallet for creating and importing QRL accounts, sending transactions, connecting to dApps, and managing QRC-20 tokens.
Shown alphabetically from active index listings. Status is displayed for context; no ranking or recommendation is implied.
Ready for the next step whenYou have a testnet address and have verified that its recovery material is safely backed up.
Test funds
Fund the wallet with test QRL.
Request test QRL through the current community channel, then confirm the balance in your wallet or against your node before attempting a deployment.
Ready for the next step whenYour testnet wallet shows enough test QRL to pay deployment gas.
Contract
Compile and deploy a smart contract.
Follow the maintained example repository to compile a simple contract and deploy it through your funded wallet. Confirm the example’s current prerequisites and network endpoint before signing.
From the ecosystem index
Developer tooling
Active tools and libraries that can help with the next stage of a QRL application.
Developer experience
Go QRLLIB
A Go post-quantum cryptography and wallet library for QRL, providing ML-DSA-87, ML-KEM-1024, SPHINCS+, QRL 2.0 wallet and address helpers, and legacy XMSS compatibility for QRL 1.x migration.
Developer experience
Hyperion
QRL's contract-oriented smart-contract language and compiler for the Quantum Resistant Virtual Machine, designed as a Solidity-derived toolchain for building tokens, applications, voting systems, and other QRL 2.0 contracts.
Assets & tokenization
QRC20 Factory
An open-source QRL 2.0 reference implementation for deploying a QRC20 token factory, creating configurable tokens, and reading token details through QRL Web3.js on the public testnet or a local node.
Developer experience
QRL Contract Example
A JavaScript reference project for compiling, deploying, and interacting with a Hyperion token contract on QRL 2.0 using @theqrl/web3, including on-chain transfers and off-chain balance queries.
Security, custody & account management
QRL File Tools
Command-line tools for post-quantum file signing, signature verification, public-key extraction, hashing, and salt generation using FIPS 204 ML-DSA-87 or legacy Dilithium signatures.
Network operations
QRL Helpers
A community-maintained collection of scripts and helper tools for QRL 2.0 development and operations, currently centered on installing a complete node stack on Ubuntu 24.04.
Developer experience
QRL JavaScript Cryptography
A pure-JavaScript cryptography toolkit for QRL applications with ML-DSA-87, Argon2id, AES encryption, secure random generation, Keccak and SHAKE hashing, and modular browser or Node.js imports.
Developer experience
QRL Wallet Connect
A TypeScript SDK (@qrlwallet/connect) for connecting dApps to MyQRLWallet over a post-quantum encrypted relay, with QR code and deep-link pairing, an EIP-1193 style provider, and persistent sessions.
Developer experience
QRL Wallet Provider
An EIP-6963-based provider package that lets QRL 2.0 dApps discover and communicate with the QRL Web3 Wallet extension through an Ethereum-style request, event, and JSON-RPC interface.
Developer experience
QRL Wallet.js
A JavaScript wallet library for QRL 2.0 using FIPS 204 ML-DSA-87 signatures, with deterministic account recovery, 34-word mnemonics, address generation and checksums, message signing, and browser or Node.js support.
Developer experience
QRL Web3.js
A TypeScript Web3 client suite for QRL 2.0 with JSON-RPC providers, accounts, contract wrappers, ABI tooling, subscriptions, address utilities, QRNS helpers, and browser or Node.js application support.
Developer experience
Qrypto.js
A JavaScript and TypeScript post-quantum signature library for QRL 2.0, providing FIPS 204 ML-DSA-87 and legacy Dilithium5 packages for browsers and Node.js with combined and detached signing APIs.
Developer experience
Rust QRLLIB
A native Rust and WebAssembly implementation of QRL cryptography with ML-DSA-87, ML-KEM-1024, SPHINCS+, legacy XMSS, QRL wallet and address helpers, mnemonic recovery, and descriptor-bound signing.
Developer experience
Zond Web3 Wallet dApp Example
A React and TypeScript example dApp for discovering and connecting to the Zond Web3 Wallet and other EIP-6963 browser wallets, exercising wallet and Zond JSON-RPC methods, and inspecting responses or errors.
Shown alphabetically from active index listings. Status is displayed for context; no ranking or recommendation is implied.
Ready for the next step whenThe deployment transaction succeeds and returns a contract address and receipt.
dApp
Verify the deployment and connect an interface.
Look up the transaction and contract, then use the maintained dApp example to connect a wallet, read contract state, and submit a signed interaction.
From the ecosystem index
Check it in an explorer
Active explorers in the index that declare QRL 2.0 testnet support.
Network operations
Quantascan
Analytics-first block explorer for QRL and QRL 2.0: aggregated time-series, cross-chain charts, rich lists, wallet classification, and validator and mining dashboards — built around network-wide data, not just single block and transaction lookups.
Network operations
ZondScan
A QRL Zond network explorer for browsing blocks, transactions, smart contracts, validators, addresses, and chain activity.
Shown alphabetically from active index listings. Status is displayed for context; no ranking or recommendation is implied.
From the ecosystem index
Explore testnet dApps
Active decentralized applications with testnet deployments listed in the index.
Finance
AcornSwap
A Hyperion port of Uniswap V2 and V3 for the QRL 2.0 testnet. Its deployed V2 contracts provide constant-product pairs and routing, while the concentrated- liquidity V3 contracts are built and tested but not yet deployed.
Finance
PQlyMarket
An open-source prediction-market dApp for the QRL 2.0 testnet with market creation, YES/NO conditional-token trading, constant-product automated market makers, liquidity provision, oracle resolution, and a testnet faucet.
Finance
QuantaPool
A decentralized QRL liquid staking protocol for staking QRL, receiving stQRL, and earning validator rewards while staying liquid.
Interoperability, messaging & data
QuantaSwap
Cross-chain atomic swaps between native QRL and native ETH using hashed timelock contracts on both chains. No bridge, no wrapped assets, no custodian: each leg settles natively and the swap secret never leaves the client.
Gaming & virtual worlds
Squirrel Game
An on-chain strategy game on the QRL 2.0 testnet where Quantum Computer NFTs mine qBTC and Squirrel NFTs tax or steal it, with Hyperion contracts for minting, staking, traits, yield accounting, and commit-reveal randomness.
Shown alphabetically from active index listings. Status is displayed for context; no ranking or recommendation is implied.
Ready for the next step whenYou can find the deployment on the testnet and complete a wallet-approved contract interaction.
Keep building
Turn the first deployment into an ecosystem project.
Explore current projects for patterns, check the ideas page for gaps, and add your work to the community-maintained index when it is ready to share.