Difference between revisions of "Electrum"

From Ravencoin Wiki
Jump to navigationJump to search
 
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
 +
{| class="wikitable"
 +
! Important Notice
 +
|-
 +
| Ledger has now added support for directly installing and managing the Ravencoin app from within the Ledger Live Manager. The instructions below are no longer necessary.
 +
 +
New instructions for installing and using the Ravencoin app on a Ledger Nano S or Nano X can be found at https://ravencoin.org/ledger.
 +
|}
 +
  
 
= Introduction: Electrum and Ledger support for Ravencoin  =
 
= Introduction: Electrum and Ledger support for Ravencoin  =
This guide takes you through the steps to get Electrum and Ledger support for Ravencoin. You will need to install the necessary software dependencies, download the Ravencoin Ledger software, and set up your Ledger to make it accept Ravencoin.
+
This guide takes you through the steps to get Electrum and Ledger support for Ravencoin. You will need to download and install the Ravencoin sofware for Electrum and Ledger, and install Python software dependencies to make your Ledger accept Ravencoin. Ravencoin Electrum and Ledger support is developed by [https://github.com/traysi/ Traysi] in collaboration with [https://github.com/standard-error/ Standard-error], and funded by [https://github.com/brian112358 brian112358 / brianmct].
= Instruction for Windows =
+
 
== Installing Dependencies ==
+
= Instructions for Windows =
'''Step 1:''' Download and install the [https://github.com/traysi/electrum-raven/releases/ Electrum binaries for Ravencoin]. Choose the "-setup.exe" version. Windows Defender may complain. You'll have to add an exception and tell it to run anyway.
+
 
 +
'''Step 0:''' It is a requirement that you have the Bitcoin app installed on your ledger. The Ravencoin app requires the Bitcoin app to also be present. Use Ledger Live to install Bitcoin to your hardware before proceeding.
 +
 
 +
== Installing Ravencoin Electrum ==
 +
'''Step 1:''' Download and install the [https://github.com/standard-error/electrum-raven/releases/ Electrum binary for Ravencoin]. For Windows, choose the "-setup.exe" version. Windows Defender may complain. You'll have to add an exception and tell it to run anyway.
  
'''Step 2:''' Download and install [https://sourceforge.net/projects/winpython/files/WinPython_3.6/3.6.6.2/ WinPython]. Save the file to your <code>\Users\USERNAME\Downloads\</code> folder
+
== Installing Ravencoin Ledger software ==
 +
'''Step 2:''' Download and install [https://sourceforge.net/projects/winpython/files/WinPython_3.6/3.6.6.2/ WinPython].  
  
'''Step 3:''' Download the [https://raw.githubusercontent.com/traysi/ledger-app-rvn/master/bin/app.hex Ledger app.hex file for Ravencoin]. Right click the file and choose to save. Save the file to: <code>\Users\USERNAME\Downloads\WPy-3670\scripts</code>
+
'''Step 3:''' Download the [https://github.com/Kryptoxic/ledger-app-rvn/releases/download/1.3.17/app.hex file for Ravencoin]. Right click the file and choose to save. If you can't do that, download it, and rename it as app.hex (your PC might try to call it something like app.hex.txt)
 +
 
 +
Save the file to: <code>\Users\USERNAME\Downloads\WPy-3662\scripts</code> That folder was created by the WinPython installation that happened in the previous step. If it's not there, please find it on your system. If you installed a version other than 3.6.6.2 the folder name will be slightly changed.
  
== Setting up the scripts ==
 
 
'''Step 4:''' Open a command prompt (type <code>cmd</code> in the Windows search bar and press enter)
 
'''Step 4:''' Open a command prompt (type <code>cmd</code> in the Windows search bar and press enter)
  
'''Step 5:''' In the command prompt type in: <code>cd \Users\USERNAME\Downloads\WPy-3670\scripts</code> to move to the WinPython download directory.
+
'''Step 5:''' In the command prompt type in: <code>cd \Users\USERNAME\Downloads\WPy-3662\scripts</code> to move to the WinPython download directory.
  
'''Step 6:''' In the command prompt type in: <code>pip install ledgerblue</code> to install the Ledger Python libraries.
+
'''Step 6:''' In the command prompt type in: <code>env.bat</code> and then <code>pip install ledgerblue</code> to install the Ledger Python libraries. This should get you to version 0.1.23 or better of ledgerblue. That version is required.
== Setting up your Ledger ==
 
'''Step 7:''' Plug in and unlock your Ledger.
 
  
'''Step 8:''' In the command prompt type in (make sure you are still in <code>\Users\USERNAME\Downloads\WPy-3670\scripts</code>):
+
== Setting up your Ledger to accept Ravencoin ==
  python -m ledgerblue.loadApp --appFlags 0x40 --apdu --tlv --targetId 0x31100003 --delete --fileName app.hex --appName "Ravencoin" --appVersion 1.3.2 --dataSize 0x00000000 --icon 0100000000ffffff00ffffffffffff1ffc0ff80fe107c0078003f003f807f81ffc3ffcfffcffffffff
+
'''Step 7:''' Plug in and unlock your Ledger. You must be running the latest 1.6.0 firmware.
 +
 
 +
'''Step 8:''' In the command prompt, make sure you are still in <code>\Users\USERNAME\Downloads\WPy-3670\scripts</code>, and type in:
 +
  python -m ledgerblue.loadApp --curve secp256k1 --tlv --targetId 0x31100004 --targetVersion="1.6.0" --delete --fileName app.hex --appName "Ravencoin" --appVersion 1.3.17 --icon 010000000000ffffffffffffffffff1ffc0ff80fe107c0078003f003f807f81ffc3ffcfffcffffffff --appFlags 0x250 --dep Bitcoin:1.3.17
  
 
'''Step 9:''' Follow the prompts on your hardware Ledger to allow the installation. Once it's done, you should see a Ravencoin app in the list of apps on the Ledger.  
 
'''Step 9:''' Follow the prompts on your hardware Ledger to allow the installation. Once it's done, you should see a Ravencoin app in the list of apps on the Ledger.  
Line 30: Line 46:
 
== Final steps ==
 
== Final steps ==
 
Your coins are now safe on your Ledger. You can always recover them from another Electrum instance or any other BIP39 wallet by simply using the seed words from your Ledger.
 
Your coins are now safe on your Ledger. You can always recover them from another Electrum instance or any other BIP39 wallet by simply using the seed words from your Ledger.
 +
 +
If you ever want to remove the Ravencoin app from your Ledger, do it with:
 +
python -m ledgerblue.deleteApp --appName "Ravencoin" --targetId 0x31100004
 +
 +
== A word about derivation paths ==
 +
When you access Electrum with your Ledger, it may ask you for a path. m/44'/175'/0' is correct, but m/44'/175'/175' was the path from the original codebase. If you ever have a situation where you can't see your coins, try this path.

Latest revision as of 19:28, 6 March 2020

Important Notice
Ledger has now added support for directly installing and managing the Ravencoin app from within the Ledger Live Manager. The instructions below are no longer necessary.

New instructions for installing and using the Ravencoin app on a Ledger Nano S or Nano X can be found at https://ravencoin.org/ledger.


Introduction: Electrum and Ledger support for Ravencoin

This guide takes you through the steps to get Electrum and Ledger support for Ravencoin. You will need to download and install the Ravencoin sofware for Electrum and Ledger, and install Python software dependencies to make your Ledger accept Ravencoin. Ravencoin Electrum and Ledger support is developed by Traysi in collaboration with Standard-error, and funded by brian112358 / brianmct.

Instructions for Windows

Step 0: It is a requirement that you have the Bitcoin app installed on your ledger. The Ravencoin app requires the Bitcoin app to also be present. Use Ledger Live to install Bitcoin to your hardware before proceeding.

Installing Ravencoin Electrum

Step 1: Download and install the Electrum binary for Ravencoin. For Windows, choose the "-setup.exe" version. Windows Defender may complain. You'll have to add an exception and tell it to run anyway.

Installing Ravencoin Ledger software

Step 2: Download and install WinPython.

Step 3: Download the file for Ravencoin. Right click the file and choose to save. If you can't do that, download it, and rename it as app.hex (your PC might try to call it something like app.hex.txt)

Save the file to: \Users\USERNAME\Downloads\WPy-3662\scripts That folder was created by the WinPython installation that happened in the previous step. If it's not there, please find it on your system. If you installed a version other than 3.6.6.2 the folder name will be slightly changed.

Step 4: Open a command prompt (type cmd in the Windows search bar and press enter)

Step 5: In the command prompt type in: cd \Users\USERNAME\Downloads\WPy-3662\scripts to move to the WinPython download directory.

Step 6: In the command prompt type in: env.bat and then pip install ledgerblue to install the Ledger Python libraries. This should get you to version 0.1.23 or better of ledgerblue. That version is required.

Setting up your Ledger to accept Ravencoin

Step 7: Plug in and unlock your Ledger. You must be running the latest 1.6.0 firmware.

Step 8: In the command prompt, make sure you are still in \Users\USERNAME\Downloads\WPy-3670\scripts, and type in:

python -m ledgerblue.loadApp --curve secp256k1 --tlv --targetId 0x31100004 --targetVersion="1.6.0" --delete --fileName app.hex --appName "Ravencoin" --appVersion 1.3.17 --icon 010000000000ffffffffffffffffff1ffc0ff80fe107c0078003f003f807f81ffc3ffcfffcffffffff --appFlags 0x250 --dep Bitcoin:1.3.17

Step 9: Follow the prompts on your hardware Ledger to allow the installation. Once it's done, you should see a Ravencoin app in the list of apps on the Ledger.

Step 10: Open Ravencoin on your hardware Ledger.

Step 11: On your Windows desktop you will see that an Electrum-RVN icon has appeared. Open the program and go through the initial setup steps. When you get to the part where you can "Choose a hardware wallet" pick that option and go from there. If it can't see the Ledger, make sure you have your Ravencoin app running on it. You can accept the defaults for everything else, once it sees the Ledger.

Final steps

Your coins are now safe on your Ledger. You can always recover them from another Electrum instance or any other BIP39 wallet by simply using the seed words from your Ledger.

If you ever want to remove the Ravencoin app from your Ledger, do it with:

python -m ledgerblue.deleteApp --appName "Ravencoin" --targetId 0x31100004

A word about derivation paths

When you access Electrum with your Ledger, it may ask you for a path. m/44'/175'/0' is correct, but m/44'/175'/175' was the path from the original codebase. If you ever have a situation where you can't see your coins, try this path.