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

- Canonical page: [QRL Contract Example](https://www.qrlecosystem.com/projects/qrl-contract-example/)
- Status: Beta
- Type: Tooling (`tooling`)
- Primary category: Developer experience (`developer-experience`)
- Capabilities: Contract templates, Deployment tooling
- QRL relationship: Native
- QRL support: QRL 2.0
- Publisher: [The QRL](https://www.qrlecosystem.com/publishers/the-qrl/index.html.md)
- Source availability: Full
- Listed: 2026-08-17
- Data updated: 2026-08-17
- Search keywords: smart-contract, hyperion, web3, javascript, token

## Project links

- [Website](https://github.com/theQRL/qrl-contract-example)


## Repositories

- [Tooling repository](https://github.com/theQRL/qrl-contract-example) — license: MIT


## Overview

QRL Contract Example is an open-source JavaScript reference project from The
QRL for getting started with smart contracts on QRL 2.0. Its upstream README
describes it as a Zond smart contract example and walks developers through
configuring a local node provider and testnet-funded Dilithium wallet.

The included scripts compile a sample Hyperion token contract, deploy it with
@theqrl/web3, submit an on-chain token transfer, and query a token balance
without creating a transaction. The repository provides a compact starting
point for learning the QRL 2.0 contract workflow.

## Features

- Hyperion token contract built from ERC20 and IERC20 examples
- Local contract compilation with @theqrl/hypc
- Contract deployment from a Dilithium-seeded account with @theqrl/web3
- On-chain token transfers and read-only balance queries