Original HUSH source code based on ZEC 1.0.8 . For historical purposes only! https://hush.is
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

102 lines
3.1 KiB

HUSH 1.0.9
=============
What is HUSH?
--------------
![Logo](doc/hush/hush.png "Logo")
HUSH (formerly Zdash) is a private implementation of the "Zerocash" protocol forked from [ZCash](https://z.cash/).
Based on Bitcoin's code, it intends to offer a far higher standard of privacy
8 years ago
through a sophisticated zero-knowledge proving scheme that preserves
8 years ago
confidentiality of transaction metadata.
This software is the HUSH node and command-line client. It downloads and stores the entire history
of HUSH transactions; depending on the speed of your computer and network
connection, the synchronization process could take a day or more once the
blockchain has reached a significant size.
**HUSH is unfinished and highly experimental.** Use at your own risk!
8 years ago
8 years ago
TEAM
----
* Axel Karlsson: [@sparkit] Community manager, general communications.
* Iolar Demartini Junior: [@demartini] Web Developer (Front End).
* Joseph Stuhlman: [@joseph] Dev, general communications.
* David Mercer: [@radix42] Lead Developer
8 years ago
* You can join our team too and make contributions
8 years ago
Slack
-----
https://zdash-slack.herokuapp.com/ //invite
8 years ago
Building
--------
The following build process generally applies to Ubuntu (and similar) Linux
distributions. For best results it is recommended to use Ubuntu Linux 16.04
or later.
Build HUSH along with most dependencies from source by running
8 years ago
Get dependencies:
```{r, engine='bash'}
sudo apt-get install \
build-essential pkg-config libc6-dev m4 g++-multilib \
autoconf libtool ncurses-dev unzip git python \
zlib1g-dev wget bsdmainutils automake
```
Create a HUSH configuration file (*important*):
```
mkdir -p ~/.hush
echo "rpcuser=username" >> ~/.hush/hush.conf
echo "rpcpassword=`head -c 32 /dev/urandom | base64`" >>~/.hush/hush.conf
```
Install HUSH
8 years ago
```{r, engine='bash'}
# pull
git clone https://github.com/MyHush/hush.git
cd hush
8 years ago
# fetch key
./zcutil/fetch-params.sh
8 years ago
# Build
./zcutil/build.sh -j$(nproc)
# Run a HUSH node
./src/hushd
8 years ago
```
Currently only Linux is officially supported. Windows/Mac OS X versions are in the works...
Deprecation Policy
------------------
This release is considered deprecated 16 weeks after the release day. There
is an automatic deprecation shutdown feature which will halt the node some
time after this 16 week time period. The automatic feature is based on block
height and can be explicitly disabled.
Where do I begin?
-----------------
As a reference a guide for joining the main Zcash network may be used:
https://github.com/zcash/zcash/wiki/1.0-User-Guide#using-zcash
Users should *not* follow this guide blindly since it applies to ZCash instead of HUSH!
The section of using the command line is relevant to HUSH.
### Need Help?
* See the documentation at the [Zcash Wiki](https://github.com/zcash/zcash/wiki)
for help and more general information.
### Not content with command line use of HUSH?
A [HUSH GUI Wallet](https://github.com/vaklinov/hush-swing-wallet-ui) exists and is maintained by an independent developer as a separate project. Please read about the known issues and limitations before using the wallet.
License
-------
For license information see the file [COPYING](COPYING).