Manage XNS via your Ledger Nano hardware wallet

Ledger Nano S and Nano X are hardware wallets built by Ledger.

A hardware wallet is a separate device that stores the private keys for your crypto assets. The keys never leave the device and remain secure even if the device is connected to a compromised computer.

The Insolar application for Ledger Nano S and X keeps your Insolar private key on the device and lets you manage XNS coins via Insolar Wallet.

The application is developed by the Insolar team. To request technical support, send an email to support@insolar.io.

Set up your Ledger Nano

To use the Insolar application on your Ledger Nano S or X hardware wallet, make sure you install and set up the following:

  1. Install Google Chrome. For the moment, it’s the only supported browser.

  2. Install the Ledger Live application. It allows you to manage applications on your device.

  3. Initialize your Ledger Nano in one of two ways depending on whether or not you already have an Insolar Wallet.

    Set up your Nano S or Nano X as described in the official Ledger documentation (click the links).

    Caution

    During the setup, you are required to choose a PIN and write down the recovery phrase for the device. Without the PIN you won’t be able to unlock the device and without the recovery phrase you will be unable to restore access to your wallet.

    Tip

    You can hold several private keys for several Insolar Wallets on your Ledger Nano. Every key stored in the device has a number. By default, the number of the first key is 0.

    Initialize your device with the existing secret backup phrase:

    1. Follow the official instructions for Nano S or Nano X to initialize the wallet with the phrase.

    2. At step 3 of the official instruction, choose the 18-word phrase length and enter your wallet’s secret backup phrase.

    Tip

    • You can initialize only a new, “clean” Ledger Nano device with the Insolar secret backup phrase. A device can only have one phrase. Devices that already store other crypto assets are “occupied” with other phrases.

    • You can “migrate” only one existing Insolar Wallet to a clean device. Every private key stored on the device has a number. The number of “migrated” private key is 0.

    • In addition to the “migrated” wallet, you can create new Insolar Wallets and store their private keys on the device under different numbers, for example, 1, 2, etc.

  4. Next, install the latest firmware on your Nano S or Nano X.

Then proceed to installing the Insolar application on your device.

Install the Insolar application on Ledger Nano

To install the Insolar application on Ledger Nano:

  1. Open Ledger Live, go to Settings (cog-icon) > Experimental features, and enable Developer mode.

    _images/ledger-dev-mode-z.png
  2. Open the Manager tab and connect and unlock your Ledger Nano.

    _images/ledger-live-connect.png

    Caution

    If it’s a charge-only cable, your computer won’t recognize the device and you won’t be able to perform any action.

  3. If prompted, press both the left and right buttons simultaneously on the device to allow the manager connection.

    _images/allow-ledger-live.png
  4. Find Insolar in the application catalog and click Install next to it.

    This displays an installation window with a progress bar. Wait for the installation to complete.

    _images/install-insolar-app.png
  5. On the dashboard of the Ledger Nano device, press the left or right button to find the Insolar application.

  6. Once found, press both the left and right buttons simultaneously to launch the application.

  7. The application may notify you that it’s pending the Ledger review. This is temporary.

    Caution

    Wait for a couple of seconds before pressing any buttons.

    If you press both buttons too early (approximately within 300 milliseconds), your Ledger device may “freeze” on the Pending Ledger review screen due to a known bug that will be fixed soon.

    If this happens, reboot the device by unplugging it from the USB port. In case your device is the Nano X, the only way to reboot the device is wait for its battery to run out.

    Then, short-press both the left and right buttons again. A “short-press” should not last longer than 100 milliseconds.

Once the Insolar application is launched, proceed to creating an Insolar Wallet if you don’t have one. Otherwise, log in to your wallet.

Create a connected Insolar Wallet

To create an Insolar Wallet using the Insolar application on Ledger Nano, complete the following steps:

  1. In Google Chrome, open the Insolar Wallet website and click CREATE A NEW WALLET.

    _images/create-ins-wlt.png
  2. On the Create a new wallet screen, click USE LEDGER NANO.

    _images/use-ledger-n.png
  3. Make sure your Ledger Nano is connected, unlocked, and the Insolar application is launched on it.

  4. If required, enter the key number. You can hold several private keys for several Insolar Wallets on your Ledger Nano. Every key stored on the device has a number. By default, the number of the first key is 0.

    Important

    Remember the number of this private key. You are required to specify it upon every login to use a particular Insolar Wallet.

    _images/key-number.png
  5. Check the boxes to allow anonymous data collection and agree to the terms of use. Then click CONNECT TO LEDGER NANO.

    _images/connect-n.png
  6. In the browser’s prompt window, select the Nano S or Nano X device and click Connect.

    _images/select-n.png
  7. On the dashboard of your Ledger Nano, the Insolar application prompts you to confirm the Create Account command.

    _images/ledger-s-create-account.png

    Press the right button to cycle though the command details.

  8. On the Sign transaction or Sign command screen, press both left and right buttons to sign the command.

    _images/ledger-s-create-account-sign.png

    This securely stores the private key on your Ledger Nano.

  9. Once signed, the Insolar Wallet displays a wallet validation window.

    _images/one-more-thing.png
  10. Wait for the validation to complete and see the congratulation message.

    _images/ledger-n-congrats.png

Once the wallet is created, you can manage your XNS with it. Every login and XNS transfer operation requires the associated private key stored on the Ledger Nano, so the device must be connected to confirm these actions.

Log in to the connected Wallet and view your balance

To log in to the Insolar Wallet connected to your Ledger Nano, complete the following steps:

  1. In Google Chrome, open the Insolar Wallet and click LOG IN.

  2. In the Log in panel, click the Hardware tab.

    _images/login-hw.png
  3. Make sure your Ledger Nano is connected, unlocked, and the Insolar application is launched on it.

  4. Specify the key number you chose upon wallet creation and click CONNECT TO LEDGER NANO.

    _images/enter-key-number.png

Insolar Wallet recognizes the launched application on the device and automatically logs in to the wallet. Once logged in, you can see your balance on the Dashboard tab.

Receive XNS

To receive XNS, do the following:

  1. On the dashboard of your wallet, click the copy button below XNS account. This copies your XNS account address to the clipboard.

    _images/copy-xns-account-address.png
  2. Reveal the address to anyone who wishes to transfer XNS to you and wait for the incoming transaction.

  3. View the incoming transactions: in the navigation panel, click History.

    _images/click-history.png
  4. On the Transaction history screen, open the RECEIVED tab.

    _images/click-received.png

Once you receive the XNS, the balance on the Dashboard tab increases.

Send XNS

To send XNS, do the following:

  1. Open the Dashboard tab in the Insolar Wallet and click SEND.

    _images/click-send.png
  2. On the Send XNS screen, fill in the recipient address, amount of XNS to send, and click NEXT.

    _images/send-xns.png
  3. Make sure your Ledger Nano is connected, unlocked, and the Insolar application is launched on it.

  4. On the Send XNS screen, check the following transaction details and click SEND:

    • recipient address,

    • amount of XNS to send,

    • transaction fee,

    • total amount—including the fee.

    _images/check-details.png
  5. In the dashboard of the Ledger Nano device, the application prompts you to verify the transfer details and sign the Send XNS command.

    Press the right button to cycle through the details and check that they are the same as in the web wallet.

  6. On the Sign transaction or Sign command screen, press both left and right buttons to sign the Send XNS command.

    _images/ledger-s-create-account-sign.png
  7. View the outgoing transactions: in the navigation panel, click History.

    _images/click-history.png
  8. On the Transaction history screen, open the SENT tab.

    _images/click-sent.png

Once you send XNS, the balance in the Dashboard tab decreases.

Transfer swapped XNS from deposit to your main account

Once you’ve swapped your INS into XNS, your XNS are stored in your Insolar Wallet on a deposit account. Each swap operation creates a separate deposit account that goes from the status ON HOLD to RELEASED upon a successful swap.

You can transfer your released XNS from deposit to your main account to perform further operations with them.

  1. In the Insolar Wallet, open the SWAP tab, choose the deposit account, and click TRANSFER.

    _images/transfer-xns-deposit-to-main-account.png
  2. On the Transfer XNS screen, choose the amount of XNS you want to transfer or click Use all to transfer all XNS from this deposit account. Click TRANSFER again.

    _images/transfer-xns-deposit-to-main-account-use-all.png
  3. In the dashboard of your Ledger Nano device, the Insolar application prompts you to verify the transfer details and sign the Transfer command. Press the right button to cycle through the details.

  4. On the Sign transaction or Sign command screen, press both left and right buttons to sign the command.

    _images/ledger-s-create-account-sign.png
  5. View the incoming transactions: in the Your Wallet panel, click Transaction history.

    _images/transfer-xns-deposit-to-main-transaction-history.png

Once the transfer operation finishes, the balance in the Dashboard tab increases.