Head back to Documentation
The QRL wallet is your portal into the provably secure quantum store that makes QRL what it is. This wallet will store your QRL safely, while allowing you to mine without the risk of losing private keys.
Being Quantum Resistant comes with some inherent challenges. Before creating your new wallet, there are a few quirks worth noting about QRL.
When you create a new wallet you create an XMSS tree, which is comprised of many signatures to make a signature scheme. Every signature is referenced as your OTS index or One Time Signature key index.
The OTS key index is limited. You can only use each key once. When you’ve used your last key, you will no longer be able to sign transactions. This can not be stressed enough!
Your last key MUST EITHER empty your wallet OR activate a slave.json file that holds more keys. If you use all of your OTS Key Indexes with funds in the wallet, these funds will be lost FOREVER
By far the easiest way to generate a QRL wallet is by using the online wallet. All secure XMSS operations are run in a web assembly compiled version of qrllib locally in your browser or desktop application. Keys stay in the memory space of the XMSS object, which is destroyed the moment you close the wallet, browser window, or desktop application.
Browse over to https://wallet.theqrl.org to get started.
By default you start in the “New Wallet” option to generate a QRL address and private keys for you to interface with the QRL blockchain.
The left side of the main page shows the following options:
The pass-phrase uses AES-256 encryption to lock up your wallet.json file. This adds another layer of protection to your Quanta by requiring the recovery key “Password” every time you load the wallet.
It is recommend to save this somewhere very safe, along with your hexseed and private keys. If any of these are compromised you lose everything.
The pass-phrase must be at least 8 characters in length, and must contain at least 1 number and 1 letter.
This option allows you to create a wallet with varying tree size. In other words this controls the amount of signatures your wallet can use for transactions safely on the blockchain.
By default an XMSS Tree height of 10 provides 1024 One Time Signatures. Larger XMSS Tree heights will take longer to generate, please be patient.
You must unlock your wallet with the same tree size you used to generate when you unlock your wallet again.
Click the create wallet button and the wallet will be generated.
This will produce a sensitive screen once the wallet is created.
There are a few options to save your wallet file. Record the QRL address somewhere convenient. This is the address where you will send QRL. If you are mining with this wallet, your mined QRL will go here as well. All QRL addresses start with a “Q”.
Important: Record Your Private Keys!
You can save the private key in the form of a mnemonic phrase, hexseed, and a wallet file. The keys will not be shown again and you need them to open your wallet every time.
Do Not Lose These Keys!
It’s recommended to Save a Secure file in the AES-256 encrypted version. You will need your password to unlock this file anytime it is loaded into the wallet Don’t Forget This Password!
Also please don’t save your wallet and your password in the same place. That would be like leaving your house key in the door lock…
You now have a QRL wallet that can receive QRL, send QRL, create a slaves.json file without sending permissions, and begin securely mining QRL.
Welcome to the Quantum Resistance! Click “Open Wallet” and enter your recovery information.
By using the recovery method you have created, you can access your wallet to send or receive QRL.
Enter your information into the “Wallet Seed / File” field. Make sure the drop down on the right matches the data you chose (Mnemonic, Hexphrase, or wallet file).
With the wallet unlocked, you can now send QRL to another QRL address.
Once the wallet is opened you will be in the Send tab in your open wallet. There are four fields you need to fill in:
Once you have these details entered, click the Confirm button. You will be shown the details of the transaction before they are broadcast across the QRL network.
Make sure everything is correct and click the send button. The transaction will be propagated across the QRL network and deposited into the address you entered. Your screen will show the confirmation details as the transaction is sent.
Once the transaction has been confirmed you will get a screen similar to this:
You can verify the transaction in the QRL Explorer. Copy the transaction number in the “Transaction Status” box and enter it into the search field in the QRL Explorer.
Click the receive tab in the wallet and you will see your wallet address and QR code. Send this to whoever you are receiving coins from.
Use this address to receive QRL.
To check the balance of a wallet browse to the QRL Explorer
Enter the QRL address into the search bar in the top right of the Explorer.
You can enter QRL addresses, transaction hashes, or block indexes into this field.
This will show you the current balance and all transactions that have happened with this wallet.
At the bottom left there is a meta button. This will give fine grain details for the current wallet.
The QRL supports QRT or Quantum Resistant Ledger Tokens. These tokens share the same encryption and QC resistance as the main QRL blockchain.
Creating a new token is easy. Once you have all of the pertinent details entered and the fee paid, the network takes care of the rest.
To create a token you will need to provide the following information:
The “Initial Token Holders” field allows you to select the addresses that will receive the initial tokens. You can add as many addresses as you see fit. Below is an example showing the QRL fee for processing the transaction and the OTS key index we intend to use. Ensure this is an unused OTS Key.
Once you have filled in all of the necessary details, click the create token button at the bottom of the form. This will broadcast the creation of your token across the QRL network and send the newly minted tokens to the addresses specified.
You will get a confirmation page that shows the details of the transaction. Verify the information is correct and press “Confirm Token Creation”
The confirmation screen will print the details of the transaction.
You can check the balance of any tokens you have in your wallet by selecting the tokens tab in the top bar of the “Send and Receive” tab in the web wallet.
You can also see the recent transactions on the right of the balance screen.
You can receive tokens at your main QRL address, no need for anything special to receive.
Using the web wallet we can send tokens to another QRL address. From the “Send and Receive” screen, select the drop down to the right of the “Amount” field.
Enter the details to send the tokens, and select “Confirm”. Progress through the following screens and wait for the confirmation.