Litecoin Core

From Whonix
Jump to navigation Jump to search

Using Litecoin Core in Whonix. Fully verifying a Litecoin wallet.

Introduction[edit]

Documentation for this is incomplete. Contributions are happily considered! See this for potential alternatives.

Info COMMUNITY SUPPORT ONLY : THIS WHOLE WIKI PAGE is only supported by the community. Whonix developers are very unlikely to provide free support for this content. See Community Support for further information, including implications and possible alternatives.

warning Security warning: Installing third party software allows the vendor to potentially compromise your system. Proceed at your own risk! See Foreign Sources for further information.

Whonix default admin password is: changeme Documentation in the Whonix wiki provides guidance on installing third-party software from different upstream sources. This is especially useful as upstream often includes generic instructions for various Linux distributions, which may be complex for users to follow. Additionally, documentation Whonix usually has a higher focus on security, digital software signatures verification.

The instructions provided here serve as a "translation layer" from upstream documentation to Whonix, offering assistance in most scenarios. Nevertheless, it's important to acknowledge that upstream software may undergo changes over time. Consequently, the documentation on this wiki might need occasional updates, such as revised signing key fingerprints, to stay current and accurate.

Please note, this is a general wiki template and may not apply to all upstream documentation scenarios.

Users encountering issues, such as connectivity issues, are advised to adhere to the Self Support First Policy and engage in Generic Bug Reproduction. This involves attempting to replicate the issue on Debian bookworm (over Tor), contacting upstream directly if the issue can be reproduced as such problems are likely unspecific to Whonix. In most cases, Whonix is not responsible for, nor capable of resolving, issues stemming from third-party software.

For further information, refer to Introduction, User Expectations - What Documentation Is and What It Is Not.

Should the user encounter bugs related to third-party software, it is advisable to report these issues to the respective upstream projects. Additionally, users are encouraged to share links to upstream bug reports in the Whonix forums and/or make edits to this wiki page. For instance, if there are outdated links or key fingerprints in need of updating, please feel free to make the necessary changes. Contributions aimed at maintaining the currentness and accuracy of information are highly valued. These updates not only improve the quality of the wiki but also serve as a useful resource for other users.

The Whonix wiki is an open platform where everyone is welcome to contribute improvements and edits, with or without an account. Edits to this wiki are subject to moderation, so contributors should not worry about making mistakes. Your edits will be reviewed before being made public, ensuring the integrity and accuracy of the information provided.

Litecoin Core Setup[edit]

Installation[edit]

Perform these steps inside Whonix-Workstation (Qubes-Whonix: anon-whonix App Qube).

1. Retrieve, verify and add the signing key. [1]

Whonix first time users warning Warning:

The following command using gpg with --recv-keys is not recommended for security reasons and is often non-functional. [2] This is not a Whonix-specific issue. The OpenPGP public key should be downloaded from the web instead; see also Secure Downloads. This procedure is currently undocumented and can be resolved as per the Self Support First Policy. Documentation contributions will be happily considered.

gpg --keyserver keyserver.ubuntu.com --recv-keys 0xD35621D53A1CC6A3456758D03620E9D387E55666

Verify the key fingerprint.

gpg --fingerprint 0xD35621D53A1CC6A3456758D03620E9D387E55666

Expected output:

Key fingerprint = D356 21D5 3A1C C6A3 4567  58D0 3620 E9D3 87E5 5666

2. Download the signed hash sum verification file.

scurl-download https://web.archive.org/https://download.litecoin.org/litecoin-0.21.2.1/linux/litecoin-0.21.2.1-x86_64-linux-gnu.tar.gz.asc

3. Download Litecoin.

scurl-download https://web.archive.org/https://download.litecoin.org/litecoin-0.21.2.1/linux/litecoin-0.21.2.1-x86_64-linux-gnu.tar.gz

4. Verify the hash sum digital signature file.

gpg --verify litecoin-0.21.2.1-x86_64-linux-gnu.tar.gz.asc

If the file is correctly verified, the output will include a statement the signature is good:

Good signature

This output might be followed by a warning as follows.

gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.

This message does not alter the validity of the signature related to the downloaded key. Rather, this warning refers to the level of trust placed in the Whonix signing key and the web of trust. To remove this warning, the Whonix signing key must be personally signed with your own key.

5. Extract the tar file.

tar xzf litecoin-0.21.2.1-x86_64-linux-gnu.tar.gz

6. Done.

Download, digital signature verification and extraction of Litecoin Core is complete.

Enable Stream Isolation[edit]

1. Optional: Disable networking for the virtual machine.

This step is optional but recommended to ensure stream isolation is always used from the first connection. This step can be omitted if:

  • A) The Whonix transparent proxy feature has been disabled; [3] and/or
  • B) Proxy settings are configured using the Litecoin Core configuration file ~/.litecoin/litecoin.conf before the first start. [4]

2. Start Litecoin-Qt as documented further below.

3. Enable Stream Isolation in the client.

  • A) navigate to the client settings
  • B) locate the Network tab
  • C) enable the SOCKS proxy as follows:
    • Host: 10.152.152.10
    • Port: 9111
    • Proxy: SOCKS5

4. Re-enable networking for the virtual machine.

Add a Litecoin-Qt Start Menu Entry[edit]

Perform the following steps to create a litecoin-qt start menu entry; this procedure is optional.

Inside Whonix-Workstation (Qubes-Whonix: anon-whonix App Qube).

1. Create folder ~/.local/share/applications.

mkdir -p ~/.local/share/applications

2. Open file ~/.local/share/applications/litecoin.desktop in an editor as a regular, non-root user.

mousepad ~/.local/share/applications/litecoin.desktop

3. Paste the following contents.

[Desktop Entry] Name=Litecoin-Qt Comment=litecoin-qt Exec=bash -c '~/litecoin-*/bin/litecoin-qt' Terminal=false Type=Application Icon=money-manager-ex StartupWMClass=litecoin MimeType=x-scheme-handler/litecoin; Categories=Finance;

4. Save.

5. Qubes-Whonix: perform platform-specific steps.

In dom0, refresh Qubes' appmenu: VM settingsApplicationsRefresh ApplicationsAdd desktop shortcut.

6. Done.

The Litecoin-Qt start menu entry should now be available.

Autostart Litecoin-Qt[edit]

Perform these steps to automatically start Litecoin-Qt; this step is optional.

Inside Whonix-Workstation (Qubes-Whonix: anon-whonix App Qube).

1. Apply the Add a Litecoin-Qt Start Menu Entry instructions first.

2. Create folder ~/.config/autostart.

mkdir -p ~/.config/autostart

3. Create a symlink from ~/.local/share/applications/litecoin.desktop to ~/.config/autostart/litecoin.desktop.

ln -s ~/.local/share/applications/litecoin.desktop ~/.config/autostart/litecoin.desktop

4. Done.

Litecoin-Qt will now automatically start the next time the VM is booted.

Start from Command Line[edit]

To start Litecoin-Qt (part of Litecoin Core) from the command line, run.

~/litecoin-*/bin/litecoin-qt

Creating a Watch-Only Wallet[edit]

  1. Start Litecoin-Qt.
  2. WindowConsole
  3. Import address.

Note: replace address with the actual address to be watched.

importaddress address

Footnotes[edit]

We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 12 year success story and maybe DONATE!