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:
0xfollowed 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
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.
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.
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.
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.
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.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.
