Ledger Sideloading Instructions - Windows10

Sideloading is no longer necesasry to load the Radix app onto your Ledger hardware wallet device. Please see these instructions on installing Radix on Ledger Nano S or X via the Ledger Live application.

Before you start these instructions, make sure you have read and done everything on the introduction and prerequisites first.

This process has been tested on Windows10; it may work on other versions of Windows, but it this has not been verified.

These instructions assume that the Mac you use to do the sideload does not already have the developer’s tool Python installed. If it does, then things may not precisely follow the flow described below and may require you to update Python and ensure it is added to your path.

Install the Radix Ledger App

Have your Ledger Nano S device ready, with its USB cable to allow it to connect to the Windows 10 computer where you will perform the sideload install using the steps below.

If Ledger Live is installed on this computer, make sure you quit the Ledger Live desktop application before starting the sideload installation, as it takes exclusive control of the connection to the Ledger device and you will not be able to connect from the command line when it is open.

For those of you inclined to check hashes, this link provides the md5. If you don’t know what this is, you can safely skip it and move on.)

Unzip the downloaded zip file directly inside your Downloads directory. To do this, right-click the zip file and select "Extract All…​" in the menu, like this:

windows extract ledger zip

This done, you should now have the following directories: Downloads\radix-ledger-app-1.0.0\app-radix.

Check that you do indeed have these directories in the location shown – that is, in your Downloads directory you have a radix-ledger-app-1.0.0 directory with an app-radix directory inside. The rest of these instructions rely on these names and locations.

Now we need to install a developer tool called "Python". Follow this link, and run the downloaded installer: https://www.python.org/ftp/python/3.9.6/python-3.9.6-amd64.exe

You should first see a screen like this:

windows python installer

Make sure you check the box for "Add Python 3.9 to PATH" at the bottom. Then click "Install Now" and complete the installation as normal.

Now open the Windows "Command Prompt" application by typing cmd in the Windows 10 Taskbar and pressing return. It will look like a mostly-blank window with a prompt where you can type commands, likely starting with C:\

Seeing the prompt means that the Command Prompt application is waiting for your input.

Now we’re ready to get down to business. To do the Ledger app sideload, we’re going to be running a few commands in Command Prompt. We’ll put these commands in boxes, as you’ll see below.

To run each command, first put your mouse over the box above and you should see a small clipboard icon in its upper right. Click this icon to copy the full text of the box (you should see "copied!"). You can then go to your Command Prompt application and paste the text using the control-V keyboard shortcut. You should see the text appear at the prompt.

Before you press return to run any command, double check that what you see in Terminal includes everything you see in the box you copied it from.

Okay, here’s the first command. Copy it using the clipboard icon, paste it into Command Prompt, double-check it, and press return:

pip3 install ledgerblue

That command installs the sideloading tool provided by Ledger. It might take a moment to do, so be patient and wait until you get back to your C:\ prompt.

Great, now do this one:

cd Downloads\radix-ledger-app-1.0.0\app-radix

We just need to run one more command. But first, now it is time to connect your Ledger Nano S with its USB cable, and unlock it with your PIN. You should see the Ledger’s menu on the device screen, where you might have a Bitcoin or Ethereum app if you installed one of these already.

Once again – do not open the Ledger Live application on the computer! You only need to connect the Ledger device itself.

Also, make sure that you don’t launch any Ledger apps on the Ledger device (such as a Bitcoin or Ethereum app. You simply need to enter your PIN and wait at the main menu.

Once the Ledger device is connected and ready, we’re going to do one more scary-looking Command Prompt command that will perform the sideload install:

python -m ledgerblue.loadApp --path "44'/1022'" --curve secp256k1 --tlv --targetId 0x31100004 --delete --fileName bin/app.hex --appName Radix --dataSize 0 --icon 0100000000ffffff00ffffffffffffffffffe1fffdfffce7fe4ffe1fffbfffffffffffffffffffffff --rootPrivateKey b5b2eacb2debcf4903060e0fa2a139354fe29be9e4ac7c433f694a3d93297eaa

As before, click the copy button at upper right of the box and paste the whole thing into your Command Prompt application at once. Once you make sure it matches what you see above, press return.

You’ll now start seeing lots of strange text, and you will be asked to confirm some things on your Ledger Nano S device itself using its buttons.

From here on, we’ll show messages shown on the Ledger device’s screen marked with a Ledger icon like this:

ledger 20x20 Ledger screen text

First, you should see:

ledger 20x20 Deny unsafe manager

Don’t panic about this being an “unsafe manager”! This is just your Ledger device being suitably cautious about sideloaded apps. In this case we trust what we are loading and so we can safely ignore this warning.

Here you will need to use the device’s right button to advance through some screens before you get to a screen where you can use both buttons to confirm that you want to allow the “unsafe manager”, like this:

ledger 20x20 > public key (9 screens) > Allow unsafe manager

You may see a warning about a “broken certificate chain” in Terminal here. You can safely ignore this.

Shortly, you should see on your Ledger screen:

ledger 20x20 Loading, please wait

Once the progress bar fills, this will be followed by:

ledger 20x20 Install app Radix

Here again you will have to use the device’s right button to advance through some screens before you get to a screen where you can use both buttons to confirm like this:

ledger 20x20 > Version > Identifier (5 screens) > Code Identifier (5 screens) > Perform Installation

Note: The “Version” screen may not actually show any version information. Again, this is normal and expected for this sideloading process.

Then you’ll be asked to enter your Ledger’s PIN again. Once you do so, momentarily you should be returned to your prompt in Terminal.

You’ve just completed the sideload!

If this last command failed, check that you are indeed on the latest Ledger firmware, that your Ledger is connected with the PIN entered, and that you have enough space remaining on your Ledger. You may have to remove one or two other Ledger apps if you do not have enough space.

Loading the Radix Ledger App

You’ll now see the Radix app listed as one of the options on your Ledger Nano S. If you have other apps like Bitcoin or Ethereum installed, you may have to press the buttons to scroll to the Radix app.

Go ahead and try launching it by pushing both buttons.

Because we did the installation by sideload, rather than using Ledger’s own Manager, the Ledger shows a warning that This app is not genuine. This is nothing to worry about; just click through the screens and confirm like this:

ledger 20x20 > Identifier (5 screens) > Open application

You should now see Radix is ready on the Ledger’s screen, which means that you’re ready to go to use the Radix Desktop Wallet. You’ll have to do this last step each time you want to use your Ledger device with the Radix Desktop Wallet.

From here, you can learn how to connect your Ledger to the Radix Desktop Wallet and start doing transactions.

Uninstalling the Radix Ledger App

If you no longer want the Radix Ledger app on your device, you can easily uninstall it with the sideloading tools.

When the Radix Ledger app becomes listed on the Ledger Live Manager, you will want to do this before switching to the Manager version of the app.

To do the uninstallation, the easiest option is to the same computer that you originally used to do the sideloading above, as it will already have all of the tools required installed.

If you no longer have access to that computer, then simply repeat the installation instructions above, but skip downloading the radix-ledger-app zip file and stop before you run the long python -m …​ command. Then come back here and proceed.

First connect your Ledger Nano S and enter your PIN. Do not open the Radix app, or any other app on the Ledger device.

Then run this command:

python -m ledgerblue.deleteApp --targetId 0x31100004 --appName Radix --rootPrivateKey b5b2eacb2debcf4903060e0fa2a139354fe29be9e4ac7c433f694a3d93297eaa

This will begin the uninstall, and you will need to confirm some things on your Ledger device’s screen.

Just like when you did the install, first you should see:

ledger 20x20 Deny unsafe manager

Again you will need to use the device’s right button to advance through some screens before you get to a screen where you can use both buttons to confirm that you want to allow the “unsafe manager”, like this:

ledger 20x20 > public key (9 screens) > Allow unsafe manager

Then you should see:

ledger 20x20 Uninstall Radix

Use the Ledger’s buttons to scroll to the right and confirm like this:

ledger 20x20 > Identifier (5 screens) Confirm action

And that’s it! The Radix Ledger app should now be uninstalled.