nik/liana
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update TRY.md

Browse Source 
work in progress
This commit is contained in:
Kevin Loaec 2023-09-12 13:10:43 +00:00 committed by GitHub
parent 38d0fafac2
commit e1451fc2af
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

69
doc/TRY.md
View File

@ -1,13 +1,14 @@
# Quickly try out Liana # Quickly try out Liana in a test environment
> *Just give me the TL;DR!*
*(Updated on February the 28th of 2023)* *(Updated on of 2023)*
This document is a short set of instructions for trying out Liana on Bitcoin signet. It does not attempt to This document is a short set of instructions for trying out Liana on Bitcoin signet, a test network using value-less bitcoins. It does not attempt to
give any nuance, details or describe alternative configurations. give any nuance, details or describe alternative configurations.
This guide will make use Liana as a "hot wallet". If you'd like to try out Liana using dummy This guide will make use Liana as a "hot wallet".
You can also connect your Ledger or SpecterDIY hardware signer, (and maybe by the time you read this guide, Bitbox, Coldcard and Jade - integration is coming soon).
If you'd like to try out Liana using emulators of
hardware signing device you can use the [Specter hardware signing device you can use the [Specter
simulator](https://github.com/cryptoadvance/specter-diy/blob/master/docs/simulator.md) or the simulator](https://github.com/cryptoadvance/specter-diy/blob/master/docs/simulator.md) or the
[Ledger "Speculos" emulator](https://github.com/LedgerHQ/speculos). [Ledger "Speculos" emulator](https://github.com/LedgerHQ/speculos).
@ -17,14 +18,17 @@ simulator](https://github.com/cryptoadvance/specter-diy/blob/master/docs/simulat
### System dependencies ### System dependencies
*If you are using Windows or MacOS, you can skip this step.*
Here is a list of the system dependencies: the tools and libraries you need to have installed on Here is a list of the system dependencies: the tools and libraries you need to have installed on
your system to follow the guide if you are running Linux. your system to follow the guide if you are running Linux.
TL;DR: - Debian/Ubuntu: dependencies are handled by the .deb package, you can skip this step
- Debian/Ubuntu: `apt install curl gpg udev libfontconfig1-dev libudev-dev` - Arch Linux/Manjaro/Endeavor: The [AUR package](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=liana-bin) handles the dependencies, you can skip this step.
- Arch Linux: check if you have all the required packages: `pacman -Q coreutils tar curl gnupg fontconfig systemd-libs`. - NixOS: The Liana package handles the dependencies, you can skip this step.
If any is listed as "was not found", get it with `pacman -S [missing package name]` - Other distribution: see the link to projects below to search for the name of your distribution's packages.
- Other distribution: see the link to projects below to search for the name of your distribution's packages. - [`fontconfig`](https://www.freedesktop.org/wiki/Software/fontconfig/)
- [Libudev](https://www.freedesktop.org/software/systemd/man/libudev.html)
- Running binaries requires GLIBC >= 2.33 (Ubuntu >= 22.04 or Debian >= 12) - Running binaries requires GLIBC >= 2.33 (Ubuntu >= 22.04 or Debian >= 12)
We'll use basic tools which should already be present on your system, such as: We'll use basic tools which should already be present on your system, such as:
@ -36,13 +40,13 @@ To download and verify binaries you will also need:
- `gpg` (On Debian/Ubuntu `apt install gpg`) - `gpg` (On Debian/Ubuntu `apt install gpg`)
To run the GUI you will need some additional libraries: To run the GUI you will need some additional libraries:
- [`fontconfig`](https://www.freedesktop.org/wiki/Software/fontconfig/) (On Debian/Ubuntu `apt install libfontconfig1-dev`)
- [Libudev](https://www.freedesktop.org/software/systemd/man/libudev.html) (On Debian/Ubuntu `apt install udev libudev-dev`)
### Throwaway folder ### Throwaway folder
You can follow the guide from any folder of your choice. We recommend using a dedicated folder you You can follow the guide from any folder of your choice. We recommend creating a new dedicated folder you
can wipe easily. On Linux: can wipe easily after testing.
If you are using a Linux terminal:
``` ```
mkdir liana_quicktry mkdir liana_quicktry
cd liana_quicktry cd liana_quicktry
@ -53,42 +57,7 @@ cd liana_quicktry
Liana needs `bitcoind` to communicate with the Bitcoin network. Minimum supported version is 24.0.1. Liana needs `bitcoind` to communicate with the Bitcoin network. Minimum supported version is 24.0.1.
### Download
The following instructions are specific to Linux (they may work on MacOS but i'm not sure). For
other platforms refer to
[https://bitcoincore.org/en/download/#verify-your-download](https://bitcoincore.org/en/download).
1. Download the `bitcoind` binary from [the official website of the Bitcoin Core
project](https://bitcoincore.org/bin/bitcoin-core-25.0/) according to your platform (in the context
of this guide, it is most likely `bitcoin-25.0-x86_64-linux-gnu.tar.gz`), and associated SHA256SUMS and SHA256SUMS.asc verification files.
```
curl -O https://bitcoincore.org/bin/bitcoin-core-25.0/bitcoin-25.0-x86_64-linux-gnu.tar.gz -O https://bitcoincore.org/bin/bitcoin-core-25.0/SHA256SUMS -O https://bitcoincore.org/bin/bitcoin-core-25.0/SHA256SUMS.asc
```
2. Verify the hash of the downloaded archive.
```
sha256sum --ignore-missing --check SHA256SUMS
```
3. Verify the signature against a key you trust. The Bitcoin Core Guix Attestations Github repo contains [a
folder](https://github.com/bitcoin-core/guix.sigs) of signers for each release and a folder of their keys.
Mine is `590B7292695AFFA5B672CBB2E13FC145CD3F4304`.
```
gpg --keyserver hkps://keys.openpgp.org --receive 590B7292695AFFA5B672CBB2E13FC145CD3F4304
gpg --verify SHA256SUMS.asc
```
4. Finally, uncompress the archive to get access to the `bitcoind` binary.
```
tar -xzf bitcoin-25.0-x86_64-linux-gnu.tar.gz
```
### Start `bitcoind` on signet
Run `bitcoind` in the background on the public signet network. On Linux:
```
./bitcoin-25.0/bin/bitcoind -signet -daemon
``` ```
If it is the first time you start a signet Bitcoin on this machine it will take a few minutes to If it is the first time you start a signet Bitcoin on this machine it will take a few minutes to
@ -198,4 +167,4 @@ You can simulate multiple wallets by using different data directories. For insta
./liana-gui --datadir test_bob ./liana-gui --datadir test_bob
./liana-gui --datadir test_charlie ./liana-gui --datadir test_charlie
``` ```
The directory will be created if it doesn't exist. The directory will be created if it doesn't exist.