105 lines
4.7 KiB
Markdown
105 lines
4.7 KiB
Markdown
# SilentDragonLite
|
|
|
|
SilentDragonLite is a lightwallet for HUSH ($HUSH) runs on Linux and Windows which does not require you to download the full blockchain. This is experimental software under active development!
|
|
|
|
<img src="res/images/silentdragonlite.png" width="750">
|
|
|
|
## PRIVACY NOTICE
|
|
|
|
SilentDragonLite contacts a few different external websites to get various bits of data.
|
|
The first two are option features, to get real-time price data feeds and if you want
|
|
to look at explorer details. Price feed can be turned off in Settings and you can set
|
|
a custom block explorer URL as well.
|
|
|
|
* coingecko.com for price data API (optional)
|
|
* explorer.hush.is for explorer links (optional)
|
|
* various community-run lite wallet servers to provide basic functionality (required)
|
|
|
|
This means your IP address is known to these servers. Enable Tor setting in your wallet to prevent this, or better yet, use TAILS: https://tails.boum.org/
|
|
or https://qubes-os.org
|
|
|
|
## Installation
|
|
|
|
Choose to install a binary release or compile it yourself.
|
|
For Arch Linux users, we have a silentdragonlite package on [AUR](https://aur.archlinux.org/).
|
|
|
|
### Option 1: Binary Release
|
|
Go to the [releases page](https://git.hush.is/hush/SilentDragonLite/releases) and grab the latest binary.
|
|
|
|
### Option 2: Compile Release Yourself
|
|
|
|
* SilentDragonLite is written in C++ 14, and can be compiled with g++/clang++/visual c++.
|
|
* It also depends on Qt5, which you can get from [here](https://www.qt.io/download) or we recommend installing using your Linux version's package manager (if available).
|
|
* **You'll need Rust v1.49**, so install it via [Rustup in Linux](https://rustup.rs/). **If you use a version greater then 1.63, then it will not currently build** as seen in [Issue #89](https://git.hush.is/hush/SilentDragonLite/issues/89).
|
|
|
|
#### Building on Linux
|
|
|
|
**Nothing below will work without rust. Check that your system has rustc 1.49. If not then you need to use [Rustup in Linux](https://rustup.rs/).**
|
|
|
|
An example of how to install Rust 1.49 with rustup is below:
|
|
|
|
```
|
|
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|
Choose: 1) Proceed with installation (default)
|
|
source $HOME/.cargo/env
|
|
rustup install 1.49
|
|
rustup default 1.49
|
|
rustup -V
|
|
```
|
|
|
|
**Nothing below will work without the Linux "build-essential" package. Check that your system has it installed. If not, and you're using a Ubuntu/Debian distro, then you can install with `apt install build-essential`.**
|
|
|
|
Compiling can take some time, so be patient and wait for it to finish. It will take potentially a long time for slower systems. Be Patient and please report compiler problems!
|
|
|
|
##### Ubuntu 18.04 and 20.04:
|
|
```shell script
|
|
sudo apt-get -y install build-essential qt5-default qt5-qmake qtcreator qttools5-dev-tools
|
|
git clone https://git.hush.is/hush/SilentDragonLite
|
|
cd SilentDragonLite
|
|
./build.sh linguist
|
|
./build.sh
|
|
./SilentDragonLite
|
|
```
|
|
|
|
### Other notes
|
|
|
|
#### Install Torsocks (or any other Socks service for TOR) on Ubuntu 18.04
|
|
```shell script
|
|
sudo apt update
|
|
sudo apt install torsocks
|
|
```
|
|
#### Connection to our TOR onion service Server
|
|
|
|
NOTE: Tor server is currently under maintenance.
|
|
|
|
```
|
|
* Open SDL Edit->Settings->LightwalletServer->nope.onion:80
|
|
* Open the folder of SDL in a Terminal -> Enter: TORSOCKS_LOG_LEVEL=1 torsocks -i ./SilentDragonLite
|
|
```
|
|
### Note Management
|
|
SilentDragonLite does automatic note and utxo management, which means it doesn't allow you to manually select which address to send outgoing transactions from. It follows these principles:
|
|
|
|
* Defaults to sending shielded transactions, which are now enforced via consensus rules
|
|
* Sapling funds need at least 2 confirmations before they can be spent (150 seconds on average for HUSH mainnet)
|
|
* Can select funds from multiple shielded addresses in the same transaction (via raw transactions)
|
|
* Will automatically shield your transparent funds at the first opportunity
|
|
* When sending an outgoing transaction to a shielded address, SilentDragonLite can decide to use the transaction to additionally shield your transparent funds (i.e., send your transparent funds to your own shielded address in the same transaction)
|
|
|
|
## Where is my wallet stored?
|
|
|
|
Linux: `~/.silentdragonlite`
|
|
|
|
Windows 10: `C:\Users\%user\AppData\Roaming\silentdragonlite`
|
|
|
|
Mac: `~/Library/Application Support/silentdragonlite`
|
|
|
|
## Support
|
|
|
|
For support join us on [Telegram Support](https://hush.is/telegram_support), or our [Main Telegram](https://hush.is/telegram), or toot at our [Mastodon](https://fosstodon.org/@myhushteam), or [file an issue](https://git.hush.is/hush/SilentDragonLite/issues).
|
|
|
|
You can also subscribe to our channels on [PeerTube](https://videos.hush.is), on [YouTube](https://hush.is/yt), or on [Odyssee/LBRY](https://odysee.com/@MyHushTeam:3).
|
|
|
|
## License
|
|
|
|
GPLv3 or later
|