Connect Ledger Nano S to your Ardor Wallet

From ArdorDocs
Jump to: navigation, search
This page contains changes which are not marked for translation.

The Ardor blockchain platform has released an application for the Ledger Nano S connection. It is directly supported in the desktop wallet or can be connected through all browsers that supports 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


Steps

Before you start


Install the Ardor app

  1. Open the Manager in Ledger Live.
  2. Connect and unlock your Ledger Nano S.
  3. If asked, allow the manager on your device by pressing the right button.
  4. Find Ardor in the app catalog.
  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 device to your Ardor wallet

  • Open the Ardor application on your Ledger device, the screen will display "Waiting for commands...".
NanoS Waiting.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.
  • Click on either "Returning user"
  • Choose the icon '"Ledger Wallet" and Press on "Select an Account to Login with" as shows in the following image
Ledger login 2.png


  • Select the account you want to access, the address that has "+" 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..
Ledger Select account 2.png


  • You can now access the Ardor wallet.
Ledger dashboard.png


Supported environment

The desktop wallet is natively supported. If you connect to the Ardor UI with a browser the following sub-sections explain the requirements.

Browsers

The supported browsers are:

  • Chrome
  • Brave
  • Opera

If you want to connect to the wallet from an external machine to the Ardor node, HTTPs connection is required

Operating Systems

The supported operating systems are:

Out of the box
  • MacOS
  • Linux
Required additional software
  • Windows

It requires WebUSB. You can install the Zadig software. Zadig is a Windows application that installs generic USB drivers, such as WinUSB, libusb-win32/libusb0.sys or libusbK, to help you access USB devices.


In order to install Zadig, download the lastest Zadig application. Connect your Ledger Nano S already initialized and begin with the installation:

  • A warning is prompted to check wether we want allow Zadig to check application updates
Ledger Zadig Warning.png


  • If the Ledger Nano S is connected and unlock, the interface is detected and we can click on "Install Driver":
Ledger Zadig 1.png


  • The installation starts as shows the following image
Ledger Zadig 2.png


  • Once succesfully installed, a "The driver was installed successfully" appears
Ledger Zadig 2.png


Once installed, you can use the browsers supported to use the Ledger Nano S


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 (ie: 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 verify1.png


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

Ledger verify2.png


A "Verify Address" will open:

Ledger verify3.png


When we click on "Verify", our address will be displayed on the ledger:

Ledger verify4 2.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.png


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


  • Press the right button on your device to navigate to display the transaction details (ie: Chain&TxnType, Amount, Destination Fee, Apendages). For instance as shown in the following images:
NanoS ChainAndTxType.JPG
NanoS Fee.JPG


  • In the last transaction detail, you can click on the right button to sign the transaction.
NanoS ConfirmTx.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

Once a transaction has been submitted with the Ardor wallet, press either the left or the right button to navigate to "Authorize transaction" image in the Ledger Nano S and click on the left button just below the "x" symbol:

NanoS CancelTx.JPG


The Ardor wallet will show the following:

Ledger tx cancelled.png


Sending other transactions

There are some transactions that are not possible to be executed with the Ledger Nano S. These operations are:

  • Generate token
  • Setting Account Monitor
  • Shuffling
  • The accounts used by the Ledger Nano S cannot be used for Forging, Bundling or any other process that requires storing the passphrase in the node configuration.
  • Encrypted messages are limited

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


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