# Getting Started on QRL 2.0

> Run a QRL 2.0 Testnet V2 node, create and fund a wallet, deploy a smart contract, and connect a dApp.

- Canonical page: [Getting Started on QRL 2.0](https://www.qrlecosystem.com/getting-started/)

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.

## What you will finish with

- A synchronized local node
- A funded Testnet V2 wallet
- A deployed smart contract
- A wallet-connected dApp interaction

## 01. 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.


### Platform guides
- **Linux:** [Install](https://test-zond.theqrl.org/testnet/install/linux) · [Run](https://test-zond.theqrl.org/testnet/running/linux)
- **macOS:** [Install](https://test-zond.theqrl.org/testnet/install/mac) · [Run](https://test-zond.theqrl.org/testnet/running/mac)
- **Windows:** [Install](https://test-zond.theqrl.org/testnet/install/windows) · [Run](https://test-zond.theqrl.org/testnet/running/windows)

### Node and RPC infrastructure

Community-listed infrastructure that supports the QRL 2.0 testnet. Shown alphabetically from active listings; no ranking or recommendation is implied.
- [Go QRL Execution Client](https://www.qrlecosystem.com/projects/go-qrl/index.html.md): 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. Status: Beta · Testnet + Local/Private; environments or capabilities: testnet, local-private.
- [Qrysm](https://www.qrlecosystem.com/projects/qrysm/index.html.md): 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. Status: Beta · Testnet + Local/Private; environments or capabilities: testnet, local-private.

**Ready for the next step when:** Both clients remain running and the local JSON-RPC endpoint responds.

## 02. 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.


### Official guide
- [Check node status](https://test-zond.theqrl.org/testnet/usage/checking-status): Run the maintained JSON-RPC health checks.

**Ready for the next step when:** The block height advances, `qrl_syncing` returns `false`, and the peer count is greater than zero.

## 03. 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.


### Official guide
- [Official Web3 wallet guide](https://test-zond.theqrl.org/testnet/usage/web3-wallet): Follow the QRL-maintained browser-extension setup.

> **Keep in mind:** Wallets are independent ecosystem projects. Check each listing's status, platform, source, and documentation before use.

### Choose a testnet wallet

Active wallet projects in the index that declare QRL 2.0 testnet support. Shown alphabetically from active listings; no ranking or recommendation is implied.
- [MyQRLWallet](https://www.qrlecosystem.com/projects/myqrlwallet/index.html.md): 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. Status: Beta · Testnet; environments or capabilities: testnet.
- [QRL Web3 Wallet](https://www.qrlecosystem.com/projects/qrl-web3-wallet/index.html.md): A Chromium-based browser extension wallet for creating and importing QRL accounts, sending transactions, connecting to dApps, and managing QRC-20 tokens. Status: Beta · Testnet; environments or capabilities: testnet.

**Ready for the next step when:** You have a testnet address and have verified that its recovery material is safely backed up.

## 04. 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.


### Official guide
- [Get test QRL](https://test-zond.theqrl.org/testnet/usage/getting-zond): Use the current QRL Testnet V2 acquisition instructions.

> **Keep in mind:** Test QRL exists only for network testing and has no monetary value.

**Ready for the next step when:** Your testnet wallet shows enough test QRL to pay deployment gas.

## 05. 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.


### Official guide
- [Deploy the contract example](https://test-zond.theqrl.org/testnet/usage/contract-example): Open the QRL-maintained contract walkthrough and source.

### Developer tooling

Active tools and libraries that can help with the next stage of a QRL application. Shown alphabetically from active listings; no ranking or recommendation is implied.
- [Go QRLLIB](https://www.qrlecosystem.com/projects/go-qrllib/index.html.md): 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. Status: Beta; environments or capabilities: 1.x, 2.0.
- [Hyperion](https://www.qrlecosystem.com/projects/hyperion/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRC20 Factory](https://www.qrlecosystem.com/projects/qrc20-factory/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL Contract Example](https://www.qrlecosystem.com/projects/qrl-contract-example/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL File Tools](https://www.qrlecosystem.com/projects/qrl-file-tools/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL Helpers](https://www.qrlecosystem.com/projects/qrl-helpers/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL JavaScript Cryptography](https://www.qrlecosystem.com/projects/qrl-javascript-cryptography/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL Wallet Connect](https://www.qrlecosystem.com/projects/qrlwallet-connect/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL Wallet Provider](https://www.qrlecosystem.com/projects/qrl-wallet-provider/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL Wallet.js](https://www.qrlecosystem.com/projects/qrl-wallet-js/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [QRL Web3.js](https://www.qrlecosystem.com/projects/qrl-web3-js/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [Qrypto.js](https://www.qrlecosystem.com/projects/qrypto-js/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.
- [Rust QRLLIB](https://www.qrlecosystem.com/projects/rust-qrllib/index.html.md): 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. Status: Beta; environments or capabilities: 1.x, 2.0.
- [Zond Web3 Wallet dApp Example](https://www.qrlecosystem.com/projects/zond-web3-wallet-dapp-example/index.html.md): 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. Status: Beta; environments or capabilities: 2.0.

**Ready for the next step when:** The deployment transaction succeeds and returns a contract address and receipt.

## 06. 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.


### Official guide
- [Build the dApp example](https://test-zond.theqrl.org/testnet/usage/dapp-example): Continue from the contract into a working interface.

### Check it in an explorer

Active explorers in the index that declare QRL 2.0 testnet support. Shown alphabetically from active listings; no ranking or recommendation is implied.
- [Quantascan](https://www.qrlecosystem.com/projects/quantascan/index.html.md): 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. Status: Stable · Mainnet + Testnet; environments or capabilities: mainnet, testnet.
- [ZondScan](https://www.qrlecosystem.com/projects/zondscan/index.html.md): A QRL Zond network explorer for browsing blocks, transactions, smart contracts, validators, addresses, and chain activity. Status: Beta · Testnet; environments or capabilities: testnet.

### Explore testnet dApps

Active decentralized applications with testnet deployments listed in the index. Shown alphabetically from active listings; no ranking or recommendation is implied.
- [AcornSwap](https://www.qrlecosystem.com/projects/acornswap/index.html.md): 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. Status: Beta · Testnet; environments or capabilities: testnet.
- [PQlyMarket](https://www.qrlecosystem.com/projects/pqlymarket/index.html.md): 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. Status: Beta · Testnet; environments or capabilities: testnet.
- [QuantaPool](https://www.qrlecosystem.com/projects/quantapool/index.html.md): A decentralized QRL liquid staking protocol for staking QRL, receiving stQRL, and earning validator rewards while staying liquid. Status: Beta · Testnet; environments or capabilities: testnet.
- [QuantaSwap](https://www.qrlecosystem.com/projects/quantaswap/index.html.md): 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. Status: Beta · Testnet; environments or capabilities: testnet.
- [Squirrel Game](https://www.qrlecosystem.com/projects/squirrel-game/index.html.md): 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. Status: Beta · Testnet; environments or capabilities: testnet.

**Ready for the next step when:** You can find the deployment on the testnet and complete a wallet-approved contract interaction.

## Keep building

Explore [builder ideas](https://www.qrlecosystem.com/ideas/index.html.md) and [submit your project](https://github.com/theqrl-community/qrl-ecosystem-index/blob/main/CONTRIBUTING.md) when it is ready to share.
