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

  1. Currently, you will have to enable Developer mode by going to Settings → Experimental features → enable Developer mode toggle, to be able to find the Oasis app in Ledger Live's Manager.

Ledger Live -> Experimental features -> Developer Mode

caution

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

  • At least version 2.1.0 released on Nov 30, 2021 on a Nano S device.
  • At least version 2.0.0 released on Oct 21, 2021 on a Nano X 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

info

You may see both the Oasis app and the OasisVal app come up in the search results. You need to use the standard Oasis app.

  1. After the installation is completed, take your Ledger device, navigate to Oasis app and use both buttons to open the app. A message "Pending Ledger review" will appear which you confirm by holding both buttons. Your Ledger device is ready when you will see "Oasis Ready" message. Oasis Ready
caution

Make sure you install at least version 2.3.2 of the Oasis app.

The Oasis app will use the BIP 39 mnemonic seed stored on your Ledger wallet to generate the private & public key pairs for your accounts.

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.oasisprotocol.org 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

Using Oasis CLI Tools​

This is the most 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 and so on.

Follow the instructions in the Oasis CLI Tools doc.