Skip to main content
ZondScan home
Hands-on tutorials

Create a QRL wallet with MyQRLWallet

Updated 6 min read

Everything you do on QRL 2.0 starts with a wallet: an address that can hold Quanta, sign transactions, and talk to smart contracts. This guide walks you through creating one with MyQRLWallet, the web wallet at qrlwallet.com, and backing it up so you can open the same account later on desktop or mobile.

You will learn what the wallet actually generates behind the scenes, why the mnemonic phrase deserves more care than anything else on the screen, and how the password-encrypted wallet file fits in. The whole process takes about five minutes.

QRL 2.0 currently runs as a public testnet. Mainnet arrives after the migration from the legacy chain, so the coins you manage with this wallet today have no monetary value. That makes right now the ideal time to practice: mistakes are free.

One secret, three ways to back it up

When you create an account, the wallet generates a random 48 byte seed and attaches a 3 byte descriptor that records the signature scheme. Together they form the extended seed, and every key plus the Q-prefixed address derive deterministically from it. The wallet presents this one secret in three interchangeable formats:

  • Mnemonic phrase. 34 words, shown as a numbered grid. This is the human-friendly encoding of the extended seed and the backup to treat as the master copy.
  • Hex seed. The same bytes as a single hexadecimal string: 0x followed by 102 characters. The wallet labels it an alternative method to recover your account.
  • Encrypted wallet file. A JSON file named encrypted-wallet-<address>.json, protected by the password you set during creation.

Any one of the three restores the full account. Lose all three and the account is gone permanently: there is no reset flow, no support override, and no on-chain recovery.

Create the wallet in your browser

  1. Open the web wallet

    Go to https://qrlwallet.com. Once the app connects to the network, the "Let's start" card offers to create, import, or connect a wallet. Choose Create a new account.

  2. Set a strong password

    This password encrypts your wallet backup files. It must be at least 8 characters and include an uppercase letter, a lowercase letter, a number, and a special character. A password manager entry is a good home for it.

  3. Choose a transaction PIN

    The 4 to 6 digit PIN authorizes day to day transactions, so you never retype the seed phrase to send funds. In the browser the encrypted seed is erased after 15 minutes of inactivity by default, adjustable in Settings. Press Create account when both fields validate.

  4. Write down the mnemonic offline

    The next screen, titled Your Recovery Information, shows your new Q address and the 34 word mnemonic. Copy the words onto paper in order and store the paper offline. A screenshot or a cloud note defeats the purpose of the exercise.

  5. Download the encrypted wallet file

    Press Download Encrypted Wallet File to save encrypted-wallet-<address>.json. An unencrypted variant exists behind an extra warning dialog; skip it unless you have a specific reason and a secure destination for it.

  6. Finish and test the backup

    The Done button warns that there is no going back once you continue, so confirm your backups first. To prove the file works, open Import an existing account, pick Import Encrypted Wallet, select the .json file, and enter your password. If the address matches, your backup is good.

Desktop, mobile, and the extension

MyQRLWallet runs the same wallet on several platforms:

  • Web. qrlwallet.com works in any modern browser.
  • Desktop. A hardened desktop app for Windows and Linux, with releases published at github.com/DigitalGuards/myqrlwallet-desktop. It keeps keys inside an isolated signer process, so during creation it shows the mnemonic once and keeps the raw seed out of the interface entirely.
  • Android. MyQRLWallet is available on Google Play.
  • iOS. The iOS app is in beta.
  • Browser extension. An extension is in preparation.

The encrypted wallet file is portable. A file downloaded from the web wallet opens in the desktop and mobile apps through the same Import Encrypted Wallet screen, so one backup covers every device you use.

Fund the wallet and watch it on ZondScan

A fresh wallet holds 0 Quanta. Request free testnet Quanta from the ZondScan faucet; the short guide get testnet Quanta walks through it. Once the faucet transaction confirms, paste your Q address into the ZondScan search bar to see the balance and history, or browse recent activity on the transactions page.

With a funded wallet you can try the rest of the ecosystem. Start with connecting your wallet to a dApp, and keep Quanta, Shor and Planck handy for reading amounts along the way.

FAQ

How many words does the mnemonic have?

34. They encode the 51 byte extended seed: a 3 byte descriptor plus the 48 byte seed itself. All 34 words in the correct order are required to restore the account.

I lost my password but still have the mnemonic. Am I locked out?

No. The password only protects the wallet file. Import the account from the mnemonic, set a new password, and download a fresh encrypted wallet file. The old file simply becomes undecryptable junk.

Is the encrypted wallet file safe to keep in cloud storage?

The file is encrypted with AES-256-GCM, and the key is derived from your password with PBKDF2-SHA256 at 600,000 iterations. That is strong protection, and it is only as good as the password behind it. Keep the file where you would keep other sensitive documents, and never upload the unencrypted variant anywhere.

Can I import my legacy QRL wallet?

No. The legacy QRL chain signs with XMSS, a hash based scheme. QRL 2.0 uses ML-DSA-87 with a different seed and address format, so a legacy mnemonic cannot be imported. Create a new QRL 2.0 wallet for the testnet. The migration of legacy balances is part of the mainnet plan; see what is QRL 2.0 for how the two chains relate.

What is the difference between the password and the PIN?

The password encrypts wallet backup files and is what you enter when importing a file on a new device. The PIN is a short 4 to 6 digit code that authorizes transactions during everyday use in the web and mobile apps. Both matter; only the mnemonic is irreplaceable.