Permalink
Fetching contributors…
Cannot retrieve contributors at this time
81 lines (64 sloc) 4.73 KB

ZENCash Desktop GUI Wallet APT repository for Debian/Ubuntu Linux

This is a ZENCash Desktop GUI Wallet made available through a package repository for Debian/Ubuntu (and similar) Linux systems.

Screenshot

This wallet is targeted at advanced users who understand the implications of running a full Zen node on the local machine, maintaining a full local copy of the blockchain, maintaining and backing up the Zen nodes's wallet.dat file etc! The wallet is not suitable for novice crypto-currency users!

SECURITY WARNING: Encryption of the wallet.dat file is not yet supported for ZENCash. Using the wallet on a system infected with malware may result in wallet data/funds being stolen. The wallet.dat needs to be backed up regularly (not just once - e.g. after every 30-40 outgoing transactions) and it must also be backed up after creating a new Z address.

STABILITY WARNING: The GUI wallet is as yet considered experimental! It is known to exhibit occasional stability problems related to running a full Zen node. Specifically if the locally running zend cannot start properly due to issues with the local blockchain, the GUI cannot start either! Users need to be prepared to fix such problems manually as described in the troubleshooting guide. Doing so requires command line skills.

Installing the ZENCash Desktop GUI Wallet on Linux

To setup the APT repository and install packages, using a terminal run the following commands

sudo apt-get update
sudo apt-get install apt-transport-https lsb-release

echo 'deb https://zencashofficial.github.io/repo/ '$(lsb_release -cs)' main' | sudo tee --append /etc/apt/sources.list.d/zen.list
gpg --keyserver ha.pool.sks-keyservers.net --recv 219F55740BBF7A1CE368BA45FB7053CE4991B669
gpg --export 219F55740BBF7A1CE368BA45FB7053CE4991B669 | sudo apt-key add -

sudo apt-get update
sudo apt-get install zen zencash-desktop-gui-wallet

Then you need to set up the zen.conf configuration file:

mkdir -p ~/.zen
echo "rpcuser=username" >> ~/.zen/zen.conf
echo "rpcpassword=$(head -c 32 /dev/urandom | base64)" >> ~/.zen/zen.conf

Finally you need to download the Z cryptographic keys (takes a while):

zen-fetch-params

Running the ZENCash Desktop GUI Wallet on Linux

To launch the ZENCash Desktop GUI Wallet you can just search and click on it in the Ubuntu unity menu: UnityLauncher

...or alternatively, run the command zencash-desktop-gui-wallet from a terminal:

zencash-desktop-gui-wallet

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Known issues and limitations

  1. Limitation: if two users exchange text messages via the messaging UI TAB and one of them has a system clock, substantially running slow or fast by more than 1 minute, it is possible that this user will see text messages appearing out of order.
  2. Limitation: if a messaging identity has been created (happens on first click on the messaging UI tab), then replacing the wallet.dat or changing the node configuration between mainnet and testnet will make the identity invalid. This will result in a wallet update error. To remove the error the directory ~/.ZENCashSwingWalletUI/messaging may be manually renamed or deleted (when the wallet is stopped). CAUTION: all messaging history will be lost in this case!
  3. Limitation: Wallet encryption has been temporarily disabled in ZENCash due to stability problems. A corresponding issue #1552 has been opened by the ZCash developers. Correspondingly wallet encryption has been temporarily disabled in the ZENCash Desktop GUI Wallet.
  4. Issue: GUI data tables (transactions/addresses etc.) allow copying of data via double click but also allow editing. The latter needs to be disabled.
  5. Limitation: The list of transactions does not show all outgoing ones (specifically outgoing Z address transactions). A corresponding issue #1438 has been opened for the ZCash developers.
  6. Limitation: The CPU percentage shown to be taken by zend on Linux is the average for the entire lifetime of the process. This is not very useful. This will be improved in future versions.