Skip to main content

Ledger

IMG_8932-2

This is a tutorial on how to install the Alephium App in your ledger and use it to sign transactions​

🚨 Important information: The Alephium App for Ledger Devices is a custom/community App developed by Alephium. It is not available on Ledger Live (yet!). It requires you to download other software on your computer and has several manual technical steps. Proceed only if you are sure that you understand how to perform this operation!

🚨 Since this is an early Alpha version, it is advisable to use a new/fresh ledger with no other coins managed on it.

🚨 The Ledger app only works with the latest version (v0.7.0) of the extension wallet for now.

Video Tutorial​

A tutorial in a video format can be found here: https://www.youtube.com/watch?v=YBQy_siZh6w

Written Tutorial​

1 — Download the new wallet release from: Chrome — Extension Wallet / Firefox — Extension Wallet

2 — Install the necessary software (if you already have PIP & Python installed, jump to step 3)

You will need Python and PIP installed on your computer to get the Alephium App on your Ledger:

3 — Install the Ledger Python Library

image

We are going to use the Ledger Python Library (you can find it here). It is necessary because you are going to install a custom App onto your Ledger Device.

To install the Ledger Python Library just open a terminal window and type the following:

pip3 install — upgrade protobuf setuptools ecdsa

pip3 install ledgerwallet

This will make all upgrades and install the Ledger Wallet Library that will be needed for the next step.

Install Ledger App

4 — Download the Alephium Ledger App to your computer

Go to the following GitHub repository: https://github.com/alephium/ledger-alephium and download it.

🚨To download the repository, click on the “Code” green button and choose “Download Zip.”

image

Download and unzip it in a folder you have easy access to and all read/write permissions.

5 — Install the Alephium App on your Ledger Device

Your Ledger now needs to be connected to your computer and unlocked.

Go to the GitHub repository (https://github.com/alephium/ledger-alephium/tree/master) and scroll down to find the command that applies to your Ledger version:

image

With this information, go to the console terminal and run the command to install the Alephium App:

🚨 Important information: You need to run the command inside the folder you downloaded the files from GitHub.

In this example, the Ledger Nano S is being used:

image

After running this command you will need to validate the installation of the Alephium App in your Ledger Device. Go through all approvals and add your pin to validate the installation.

When successful, the Alephium icon will appear on your device.

image

Now you are ready to use your Ledger to sign transactions on Alephium! 🎉

6 — Use your Ledger with the Extension Wallet

Go to the browser where you installed the browser extension wallet, and open it.

🚨 The Ledger app only works with the latest version (v0.7.0) of the extension wallet for now. If you don’t have it, you can install it from here (Chrome) or here (Firefox).

Create a new address in your extension wallet: Click on the current address name, and then in the “+” icon. That will lead you to Ledger Connection page:

  • Plug in your Ledger and unlocked it;
  • Open the Alephium App (make sure you validated all steps!)
  • Select your Ledger device from the list;
  • Finish the configuration.

install new wallet

7 — Use the Ledger Device to send a transaction!

All the steps here are the usual ones we have seen before using the extension wallet:

  • Click on the “Send” button

image

  • Choose the token you want to send:

image

  • Select the recipient’s address:

image

  • Review the transaction details and click on “Sign with Ledger.”

image

  • Sign the transaction in your Ledger Device, and follow its completion in “Activity” section:

image

8 — Use the Ledger Device to interact with dApps in Alephium

Now that you have a already sign a transaction with yout Ledger Device, it is time to connect it to a dApp. This process is also straightforward.

Access the Alephium DEX on Testnet. Click in the “Connect Alephium” button on the top right. Select the extension wallet in the prompt and the Ledger account.

connect with dex

Now you are connected to the Alephium DEX. Make a swap transaction and use your Ledger to sign it. The process is similar to a transfer.

unnamed

If you have questions or suggestions, please come to Alephium’s Discord, Telegram, or reach out on Twitter!