Skip to main content

Self-Custody With Ledger Hardware Wallet

This is a general documentation that will help users setup Ledger hadware wallets with Oasis Network. Ledger Live software doesn't support Oasis (ROSE) tokens natively yet. In this guide we will install Oasis app via Ledger Live to open and access wallet with one or multiple accounts via our official Oasis Wallet - Web.

Setup your Ledger device and Install Oasis App​

  1. To use your Ledger wallet to hold your ROSE tokens, you will have to install Oasis app on your Ledger wallet via Ledger Live's Manager. You need to connect your Ledger to your device and unlock it with your PIN code first.

Unlock ledger

caution

The Oasis app requires an up-to-date firmware on your Ledger wallet:

  • At least version 2.0.0 released on Oct 21, 2021 on a Nano X device.
  • At least version 2.1.0 released on Nov 30, 2021 on a Nano S device.
  • At least version 1.0.4 released on Sep 27, 2022 on a Nano S Plus device.

Follow Ledger's instructions for updating the firmware on your Ledger wallet:

  1. To find the Oasis app in the Ledger Live App catalog, you need to Allow Ledger Manager on your Ledger device first, then you will be able to click App catalog and search for Oasis:

Allow Ledger Manager Search app in catalog..

  1. Install Oasis app

Install Oasis app

  1. After the installation is completed, take your Ledger device, navigate to Oasis app and use both buttons to open the app. Your Ledger device is ready when you will see "Oasis Ready" message.

Oasis Ready

The Oasis app will use the BIP 39 mnemonic seed stored secretly on your Ledger hardware wallet to generate the private & public key pairs for your Oasis accounts. Make sure you backed up the mnemonic when you first initialized your Ledger device!

Manage Your Tokens​

Using Oasis Wallets​

This is a simpler option since it allows you to connect to your Ledger wallet via a web application or a browser extension.

In the example below we will use Oasis Wallet - Web. To learn more about other features of the Oasis Wallets, please read the Oasis Wallets doc.

  1. Navigate to wallet.oasis.io and click on the Open wallet button. Then, click on Ledger when asked how to open your wallet.

Oasis Wallet - Web -> Open wallet -> Ledger

  1. In the next step, click on the Select accounts to open button. Your browser will open a pop-up window where you will have to select your Ledger device. Finally, click on Connect.

Oasis Wallet - Web -> Select Ledger device and Connect

caution

This step requires that your Ledger shows the Oasis Ready message. After a while your device may lock for safety reasons and you will need to unlock it to perform this and subsequent steps.

  1. After connecting your Ledger to Oasis Wallet - Web another pop-up will appear where you can choose to open one or more oasis1 accounts derived from the seed stored on your Ledger.

Oasis Wallet - Web -> Select one or more accounts

  1. The account from your Ledger device is now opened. If you import multiple accounts, you can switch between them by clicking on the account address in the top-right corner. Our demo account is empty.

Oasis Wallet - Web -> Selected accounts are opened

  1. Now you can use your Ledger to receive, send or delegate ROSE. In this example, we have received 111 ROSE to our Ledger account.

Oasis Wallet - Web -> Exploring transactions

Receive ROSE​

Once you have successfully opened your Oasis account from Ledger, you can start receiving ROSE by sharing your account address.

You can simply copy your opened account address or scan QR code.

Oasis Wallet - Web -> Ledger -> Receive ROSE Account address

Send ROSE​

To send your ROSE from your Oasis Ledger account to another Oasis consensus address, you have to follow these steps:

  1. Enter destination consensus address into Recipient field, Enter amount of ROSE you want to send and Click on Send button.

Oasis Wallet - Web -> Ledger -> Send ROSE

  1. Then a pop-up window will appear where you need to Confirm transaction.

Oasis Wallet - Web -> Ledger -> Confirm TX

  1. On your Ledger device carefully review transaction details and make sure they match the ones on your computer. Navigate to the screen where you will see the APPROVE button. Use the two buttons to approve your transaction.

Oasis Wallet - Web -> Ledger -> Approve TX

  1. You can verify if ROSE were successfully sent by checking latest transactions or opening the receiving account.

Oasis Wallet - Web -> Ledger -> Verify Balance

Using Oasis CLI Tools​

This is a more powerful option that allows performing not just token-related tasks (sending, staking, ParaTime deposits and withdrawals), but also generating and/or signing raw transactions, multi-signatures, network governance operations etc.

Ledger is supported by the Oasis CLI. You can add a new Ledger account to the Oasis CLI by invoking the oasis wallet create command. For example:

oasis wallet create logan --kind ledger