🚨 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.
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:
- Python (how to for Windows, how to for Mac, how to for Linux)
- PIP (how to for Windows, how to for Mac, how to for Linux)
3 — Install the Ledger Python Library
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.
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.”
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:
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:
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.
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.
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.
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
Choose the token you want to send:
Select the recipient’s address:
Review the transaction details and click on “Sign with Ledger.”
Sign the transaction in your Ledger Device, and follow its completion in “Activity” section:
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.
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.
If you have questions or suggestions, please come to Alephium’s Discord, Telegram, or reach out on Twitter!
