Connect Ledger Nano S or Nano X to your Ardor Wallet

From ArdorDocs
Jump to: navigation, search

The Ardor blockchain platform has released an application for the Ledger Nano S/X connection. It is directly supported in the desktop wallet or can be connected through all browsers that support WebUSB.

Install the Ardor app on your Ledger device to manage Ardor and child chain tokens with the Ardor desktop wallet. The Ardor app is developed and supported by the Ardor core team.

Ledger ArdorLogo.png

Requirements

The desktop wallet connects natively to the Ledger device using USB. It is supported on Linux, macOS and Windows.

The browser wallet talks to the Ledger device using WebUSB. The supported browsers are Chrome, Brave, Edge and Opera. We have also been able to connect from Chrome Mobile on Android using an OTG cable.

WebUSB only works under HTTPs, so if you plan to use it HTTPs connection support is required.

Steps

Before you start

Install the Ardor app

  1. Open the Manager in Ledger Live.
  2. Connect and unlock your Ledger Nano S or Nano X
  3. If asked, allow the manager on your device by pressing the right button.
  4. Find Ardor in the app catalog. You may need to activate the Experimental features by clicking on settings and enabling the developer mode
  5. Press the Install button of the app.
    1. An installation window appears.
    2. Your device will display Processing…
    3. The app installation is confirmed.


NanoS ArdorApp.JPG

Connect the device to your Ardor wallet

  • Open the Ardor application on your Ledger device, it will show the message "Pending Ledger Review" as follows:
Ledger AppPendingReview.JPG


Press both buttons and the screen will display "Application is ready".

Ledger AppReady.jpg


  • Install the Ardor desktop wallet by opening the file you just downloaded. Follow the instructions described in the guide Ardor wallet installation
  • Launch the Ardor desktop wallet.
  • Select the "Hardware" tab in the login page.
  • Clicking the "Load" button will query the available accounts on the Ledger and populate the account dropdown selector found beneath.
Login tutorial - Hardware wallet clean basic.png

Select the account you want to access, the addresses that are shown with the "New" attribute means that the account is not published yet. Each time you announce a public key of an account, you will be able to create a new one.

Login page - Hardware account list.png

The advanced toggle shows more options for showing the derived accounts. By default, the wallet queries from the first account (index 0) until it finds the first unused account or reaches the sixth account (index 5). You can use the index bound fields, and the "Stop at new account" checkbox to control this behaviour and load any possible account from your hardware device.

Login tutorial - Hardware wallet Higlighted.png

You can now access the Ardor wallet.

Ledger dashboard v1.1.png

Use the Ardor wallet

Verify your address

Your address is displayed on the Ardor wallet. You can use it to receive ARDR, crypto assets, and any other child chain tokens of the platform (i.e.: IGNIS). It can be used for any other transaction in the Ardor platform such as sending messages, approvals, asset issuance and buy and sell orders

For checking your address with the ledger wallet, click on the following link in the wallet (in green):

Ledger verify1a.png


A modal pop-up will appear with the box "Verify", click on it:

Ledger verify2 a.png


A "Verify Address" will open:

Ledger verify3a.png


The account address will be displayed on the ledger, click on the right button to navigate through the different pages:

Ledger verify4a.png
Ledger verify4b.jpg

Sending tokens

To send tokens, press Send, then enter the amount, the receiving address, click on calculate fee and finally click on the Submit button:

Ledger sendTokens v11.png


  • Verify and confirm all transaction details:
NanoS AuthorizeTx v11.jpg


  • Use the buttons on your device to navigate through the transaction details (ie: Chain&TxnType, Amount, Destination Fee, Apendages). For instance as shown in the following images:
NanoS ChainAndTxType v11.JPG
NanoS ChainAndTxType b.JPG


  • The last two options ("Accept and send" and "Reject") allow you to accept or reject the transaction. Press both buttons at the same time to confirm the desired action.
NanoS ConfirmTx v1a.jpg

In case the transaction has apendages, each one has a number that is power of 2. The list is the following:

MessageAppendix = 1
EncryptedMessageAppendix = 2
EncryptToSelfMessageAppendix = 4
PrunablePlainMessageAppendix = 8
PrunableEncryptedMessageAppendix = 16
PublicKeyAnnouncementAppendix = 32
PhasingAppendix = 64

The value displayed by ledger is a combination of these appendages in hexadecimal format. For instance:

If a transaction has a PrunableEncryptedMessageAppendix and PhasingAppendix the value displayed by ledger will be 16 + 64 = 80 (0x00000050 in hex).
If the transaction has a PrunableEncryptedMessageAppendix the value displayed by the ledger will be 16 (0x00000010 in hex) as shown in the following image:
NanoS Apendages.JPG

Canceling a transaction in the Ledger Nano S/X

Using the device buttons navigate to the rightmost screen that says "Reject". Press both buttons on the device at the same time.

NanoS CancelTx v11.JPG


The Ardor wallet will show the following:

Ledger tx cancelled.png

Limitations

When using the ledger wallet, your Ardor wallet does not have access to the account private key; therefore, you cannot perform any operation which requires submitting your private key from your wallet to your node. This includes forging, bundling, shuffling, running and account monitor, contract runner and any other component which requires using the account private key on the node itself.

The rest of transactions that can be executed in the Ardor wallet can be performed in the same as sending tokens.

Under the Hood

See HD Wallet in Ardor

Contact info

  • Support: Go to the #helpdesk channel in our slack helpdesk channel or support system:
  • Name: Kristina
  • Surname: Kalcheva
  • Legal Entity: Jelurida Swiss SA.
  • URL: jelurida.com