Litecoin Core

From Whonix
Jump to navigation Jump to search

Introduction[edit]

Ambox warning pn.svg.png Documentation for this entry is incomplete. Contributions are happily considered!

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.

https://github.com/litecoin-project/litecoin/issues/769

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. [1] 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 Free Support Principle. Documentation contributions will be happily considered.

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

Verify the key fingerprint.

gpg --fingerprint 0x59CAF0E96F23F53747945FD4FE3348877809386C

Expected output:

Key fingerprint = 59CA F0E9 6F23 F537 4794  5FD4 FE33 4887 7809 386C

2. Download the signed hash sum verification file. [2]

scurl-download https://web.archive.org/https://download.litecoin.org/litecoin-0.18.1/linux/litecoin-0.18.1-linux-signatures.asc

3. Download Litecoin. [3]

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

4. Verify the hash sum digital signature file.

gpg --verify litecoin-0.18.1-linux-signatures.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.

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.

The above gpg: WARNING can be ignored since it 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 developers signing key and the web of trust. To remove this warning, the developers signing key must be personally signed with your own key.

5. De-armor the hash sum file.

gpg --decrypt litecoin-0.18.1-linux-signatures.asc > sha256

6. Perform a hash sum check.

sha256sum --check --ignore-missing sha256

Expected output.

litecoin-0.18.1-x86_64-linux-gnu.tar.gz: OK

7. Extract the tar file.

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

8. 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; [4] and/or
  • B) Proxy settings are configured using the Litecoin Core configuration file ~/.litecoin/litecoin.conf before the first start. [5]

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]

  1. https://forums.whonix.org/t/gpg-recv-keys-fails-no-longer-use-keyservers-for-anything/5607
  2. cloudflare captcha broken:
    scurl-download https://web.archive.org/https://download.litecoin.org/litecoin-0.18.1/linux/litecoin-0.18.1-linux-signatures.asc
  3. cloudflare captcha broken:
    scurl-download https://download.litecoin.org/litecoin-0.18.1/linux/litecoin-0.18.1-x86_64-linux-gnu.tar.gz
  4. Because then Litecoin Core cannot connect using transparent proxying anyhow.
  5. Perhaps as part of the ElectrumX instructions.