Difference between revisions of "Ledger"

From xx network wiki
Jump to navigation Jump to search
(Remove references to ledger live dev mode)
(Remove image showing pending review)
Line 54: Line 54:
The first thing you need to do is add your Ledger Wallet account to the xx wallet. Note that this does not store your keys in the browser, they remain secure in the Ledger device so you will need to have your Ledger available anytime you want to sign a transaction.
The first thing you need to do is add your Ledger Wallet account to the xx wallet. Note that this does not store your keys in the browser, they remain secure in the Ledger device so you will need to have your Ledger available anytime you want to sign a transaction.


First, plug your Ledger device into your computer, unlock it and open the xx network app. When a screen showing "Pending Ledger Review" shows up, click both buttons on the Ledger device to enter the app.
First, plug your Ledger device into your computer, unlock it and open the xx network app.
[[File:Ledger review screen.jpg|center|746x746px]]
 





Revision as of 17:08, 23 September 2022

Introduction

Hardware wallets like Ledger are considered some of the most secure ways to store and use cryptocurrencies as they keep your private keys off of online devices that could be compromised by malware or mismanagement. This wiki page will walk you through the process of setting up a Ledger device to use with the xx network. Please keep in mind that even if you are familiar with using Ledger devices, there are some unique key generation steps when creating xx network wallets due to the quantum-ready signature scheme that has been developed to address the looming threat of quantum computing on cryptocurrency wallets.

Functionality (Light vs XL versions)

There are two options available when downloading the xx network app onto your ledger device: a “light” version and an “XL” version. The difference between them is simply the amount of functionality they support and the amount of space they take up on your Ledger device.

XL Version

The XL version is capable of signing almost every type of transaction available in the xx network wallet with the primary exceptions being Democracy transactions (you can use a governance proxy if you’d like to secure your wallets with a Ledger but still participate in voting). If you are running a validator (node) then it is highly recommended you use the XL version. The XL version will generally require an entire Ledger device dedicated to it as it will take up the majority of memory on a standard Ledger Nano S.

Light Version

The light version will sign the majority of transactions needed for a light user of the network: balance transfers, staking, and nominating. The light version does not support some key functions needed for running a node or setting a proxy so if you want to run a node or participate in Governance then you will need to add your account directly in the xx wallet temporarily or upgrade to the XL version.

You can see the complete list of compatible functions for both versions at the bottom of the Github repository.

Account Generation

Unlike other networks, we do not recommend you generate your account directly on the Ledger device.

Instead, you should use our offline wallet generation tool to create both a standard and quantum secure recovery phrase.

You will then use the standard recovery phrase to initialize your Ledger device.

Generate recovery phrases

The offline wallet generator tool will securely generate two recovery phrases: a standard recovery phrase and a quantum secure recovery phrase. Refer to Using the Wallet Generator for a walkthrough of the steps needed to download and install the wallet generator tool.

Once you’ve generated your recovery phrases, make sure to keep them somewhere safe where they won’t be lost or stolen. These phrases will give complete access to your wallet.

Small note about Ledger accounts

The xx network blockchain is developed using Substrate, which has its own wallet derivation scheme using substrate-bip39. This scheme is used by both the xx wallet and the Wallet Generator app (which displays the generated wallet address in the last step).

However, Ledger devices use the industry standard bip39, which differs from the Substrate one. This means that the same standard recovery phrase will NOT result in the same wallet when setup on a Ledger device or the xx wallet. Please keep this in mind when proceeding in the next steps.

Setup Ledger Device

Download Ledger Live and setup your device with recovery phrase

Go to the Ledger website and download and install the Ledger Live app.

Once you’ve installed and opened Ledger Live, plug in your Ledger device. You will be using the restore function to setup the device as detailed on the Ledger support website.

During this process you will enter the standard recovery phrase (NOT THE QUANTUM RECOVERY PHRASE) directly into the Ledger device.

Download the xx network Ledger app

With your account successfully added to the Ledger device you will need to add the xx network app to your Ledger.

Make sure the Ledger is plugged in and unlocked and then open the Ledger Live app.

Go to the Manager tab and search for the xx network app. Choose the XL or light version according to your needs and click Install.

Using the Ledger Wallet

Add Account to the xx wallet

Now that you’ve set up your Ledger wallet, you’re ready to begin using it with the xx network wallet.

The first thing you need to do is add your Ledger Wallet account to the xx wallet. Note that this does not store your keys in the browser, they remain secure in the Ledger device so you will need to have your Ledger available anytime you want to sign a transaction.

First, plug your Ledger device into your computer, unlock it and open the xx network app.


Once the app is open, go to the wallet. Click on the Accounts tab and then select the Accounts menu item.

Click on Add via Ledger.

Add via ledger.png


You will be asked to name your account and presented with some options for creating derived accounts. The name of your account can be anything you want and will only be seen by you. You may change it at any time after adding it to the xx wallet. Derivations will not be covered in this wiki page.

Press the Save button to continue after choosing the name.

Screen Shot 2022-06-22 at 3.59.21 PM.png

When you click Save you may be prompted by your web browser to allow the Ledger device to connect. Select the device and click Connect.

Screen Shot 2022-06-22 at 3.59.43 PM.png

You should now see your Ledger account in the xx wallet window with the wallet address below the name. It is highly recommended that you verify this address before sending or receiving any xx coins with this wallet.

Verify Account Address

After adding your account to the xx wallet, you should always verify that the address matches the address shown on your Ledger device.

To do this, simply click on the three dots next to the send button and then select Show address on hardware device.

Ledger address.png

If your Ledger device is connected, unlocked, and you’re in the xx network Ledger app, you should now see your wallet address show up on the Ledger device.

Use the buttons to scroll through the entire address and if it matches the wallet address you see on the xx wallet then you can go ahead and click Approve on the Ledger and you’re all set to use the wallet.

Ledger address 1.jpg

Ledger address 2.jpgLedger address approve.jpg If the wallet address does not match, then make sure you followed the setup instructions correctly and if you’re still having trouble email [/cdn-cgi/l/email-protection [email protected]]

Review and Approve a Transaction

In order to use the Ledger device to sign a transaction, make sure it is plugged into your computer and that you’ve opened the xx network Ledger app on your Ledger device.

Create your transaction as you would with a non-Ledger wallet and click on the Sign and Submit button (this may be labeled something else depending on the type of transaction you’re executing).

In this example we’re showing a transaction that sends xx coins.

Send xx.png

The transaction should now show up on your Ledger device with all the transaction details. Carefully review the transaction on your Ledger by scrolling through it with the buttons and make sure it matches the transaction you’re attempting to send.

Ledger balances transfer.jpg

Ledger balances dest.jpgLedger transfer amount.jpg If it looks incorrect then click Reject on the Ledger and try the transaction again.

Otherwise click Approve and you should see a submission status icon at the top right of the xx wallet. Assuming the transaction is valid, this will turn green and your transaction has been successfully processed.

Ledger transfer approve.jpg

Tx submission.pngTx success.png

Possible Issues

If you run into any error using the xx wallet and the Ledger device, make sure the transaction you are trying to sign is supported by the xx network Ledger app version you are using (light or XL).

Also, make sure your Ledger device is connected, unlocked, and the xx network app is open, whenever you are trying to use the Ledger wallet in the xx wallet to send transactions.