According to the release notes v0.12.2.0 includes Ledger support. How do I, on Linux, generate a Ledger Monero wallet with the CLI and subsequently use it in the GUI?
How do I, on Linux, generate a Ledger Monero wallet with the CLI and subsequently use it in the GUI?
3 Answers
The GUI is now able to directly generate a Ledger Monero wallet. Thus, please see this Q&A:
How do I generate a Ledger Monero wallet with the GUI (monero-wallet-gui)?
We first have to ensure that we're sufficiently prepared. This entails the following:
This guide assumes you have already initialized your Ledger wallet and thus generated a 24 word mnemonic seed.
You need to run / use GUI v0.12.2.0, which can be found here. You can, if you're still running an older version, use the instructions in aforementioned Reddit post to upgrade.
You need to install the Ledger Monero app. Instructions can be found here.
All Monero related processes need to be closed.
Your Ledger needs to be plugged in and the Ledger Monero app should be running.
Now that we're sufficiently prepared, let's start!
Go to the directory / folder
monero-wallet-gui
(GUI v0.12.2.0) is located (note thatmonero-wallet-cli
will be in the same directory / folder asmonero-wallet-gui
).Open a new terminal
Now type:
./monero-wallet-cli --generate-from-device <new-wallet-name> --restore-height 1585000 --subaddress-lookahead 3:200
Note that is simply a placeholder for the actual wallet name. If you, for instance, want to name your wallet MoneroWallet
, the command would be as follows:
./monero-wallet-cli --generate-from-device MoneroWallet --restore-height 1585000 --subaddress-lookahead 3:200
The CLI will, after executing aforementioned command, prompt your for a password. Make sure to set a strong password and confirm it thereafter.
The Ledger will ask whether you want to export the private view key or not. First and foremost, your funds cannot be compromised with merely the private view key. Exporting the private view key enables the client (on the computer - Monero v0.12.2.0) to scan blocks looking for transactions that belong to your wallet / address. If this option is not utilized, the device (Ledger) will scan blocks, which will be significantly slower. There is, however, one cavaet. That is, if your system gets compromised, the adversary will potentially be able to compromise your private view key as well, which is detrimental to privacy. This is virtually impossible when the private view key is not exported.
You may have to hit confirm twice before it proceeds.
Your Ledger Monero wallet will now be generated. Note that this may take up to 5-10 minutes. Furthermore, there will be no immediate feedback in the CLI nor on the Ledger.
You may, after the CLI has generated your wallet, get an error about the wallet not being connected to the daemon. You can ignore that for now.
Type
exit
intomonero-wallet-cli
to close the CLI.Note that your wallet files will be stored in the same directory / folder as
monero-wallet-gui
&monero-wallet-cli
. This may be a bit inconvenient. Fortunately, however, you can simply copy the wallet files to a different preferred directory / folder.Open GUI v0.12.2.0. If you have already created a wallet in the GUI, click
Cancel
when it prompts you for the password of your current wallet. This should bring you back to the wizard. If you haven't already created a wallet, you should automatically start in the wizard.The first page of the wizard is language selection, which looks like this. Select your desired language to proceed.
On the second page of the wizard, which looks like this, select
Open a wallet from file
.Select the wallet file (which, to reiterate, is stored in the same directory / folder as
monero-wallet-gui
) you just created with the CLI.Congratulations, you can now use your Ledger Monero wallet with the GUI! If you need any general assistance with the GUI, please see this guide.
A few final notes:
I'd strongly advise to test the full process first. That is, send a small amount to the wallet and subsequently restore it (using aforementioned guide) to verify that you can recover the wallet.
If desired, you can manually tweak the
--subaddress-lookahead
value. The first value is the number of accounts and the second value is the number of subaddresses per account. Thus, if you, for instance, want to pregenerate 5 accounts with 100 subaddresses each, use--subaddress-lookahead 5:100
. Bear in mind that, the more subaddresses you pregenerate, the longer it takes for the Ledger to create your wallet.You only have to use the
--generate-from-device
flag once (i.e. upon wallet creation). Thereafter, you'd basically use it similar to how you normally use the GUI. That is:
[1] Make sure your Ledger is plugged in and the Monero app is running.
[2] Open monero-wallet-gui
[3] Enter the password to open the wallet.
- If you have any further questions or need assistance, please leave a comment in this thread.
On Ubuntu make sure you have the following dependencies installed
apt-get install pcsc-tools libpcsclite1 pcscd
otherwise you get an error similar to this:
Error: failed to generate new wallet: Fail SCard API : (2148532253) Service not available. Device=0, hCard=0, hContext=0
On Fedora, to avoid errors like:
Fail SCard API : (2148532270) Service not available. Device=0, hCard=0, hContext=0
Fail SCard API : (2148532227) Invalid handle. Device=0, hCard=0, hContext=0
Fail SCard API : (2148532270) Cannot find a smart card reader. Device=0, hCard=0, hContext=1656470265
Install pcsc packages. I'm not sure which ones are really essential, I've installed all of them (dnf install *pcsc*
). Then edit the /usr/lib64/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
, which is the equivalent of Ubuntu's /etc/libccid_Info.plist
, as follows:
- add
<string>0x2C97</string>
under<key>ifdVendorID</key>
- add
<string>0x0001</string>
under<key>ifdProductID</key
- add
<string>Ledger Token</string>
under<key>ifdFriendlyName</key>
If you're using Monero GUI, make sure you open the Monero App on Ledger before starting the Monero GUI.