Skip to content

Latest commit

 

History

History
102 lines (82 loc) · 5.56 KB

Release_0.29-beta.md

File metadata and controls

102 lines (82 loc) · 5.56 KB
Raw

ZCash Desktop GUI Wallet - binary release v0.29-beta

This document describes how to install binary release v0.29-beta of the ZCash Desktop GUI Wallet. This release of the ZCash Desktop GUI Wallet is tested with ZCash version v1.0.0. Users who encounter issues not listed in the list of known issues and limitations, are welcome to report them in the issues section.

Screenshot

Installing and running the Wallet GUI

  1. Downloading the wallet

    Download file ZCashSwingWalletUI.jar and place it in a folder like ~/Downloads. Then please make the JAR executable with a command like:

    user@ubuntu:~/Downloads$ chmod u+x ./ZCashSwingWalletUI.jar

  2. Verifying the download

    This step is very important! To verify that the file ZCashSwingWalletUI.jar is an authentic release, you need to compute its SHA256 checksum, like this:

    user@ubuntu:~/Downloads$ sha256sum ZCashSwingWalletUI.jar 
410ef840e5838e41250706d870135b4d00a3a1c940583392f8c8ff8cb96ba9cb  ZCashSwingWalletUI.jar

    If the resulting checksum is not 410ef840e5838e41250706d870135b4d00a3a1c940583392f8c8ff8cb96ba9cb then something is wrong and you should discard the downloaded wallet!

  3. Installing the downloaded ZCash GUI wallet

3.1. If you have built ZCash from source code:

Assuming you have already built from source code ZCash in directory /home/user/zcash/src (for example - this is the typical build dir. for ZCash v1.0.0) which contains the command line tools zcash-cli and zcashd you need to take the file ZCashSwingWalletUI.jar and copy it to diretcory /home/user/zcash/src (the same dir. that contains zcash-cli and zcashd). Example copy command:

user@ubuntu:~/Downloads$ cp ./ZCashSwingWalletUI.jar /home/user/zcash/src

3.2. If you have installed the ZCash binary packages

The command line tools zcash-cli and zcashd are placed by the package installer in:

/usr/bin/zcash-cli
/usr/bin/zcashd

The ZCash GUI wallet knows how to find them there. You may place the file ZCashSwingWalletUI.jar anywhere in your /home directory that you find convenient and start it from there.

  1. Running the installed ZCash GUI wallet

    Before running the GUI you need to start zcashd (e.g. zcashd --daemon). The wallet GUI is a Java program packaged as an executable JAR file. It may be run from command line or started from another GUI tool (e.g. file manager). Assuming you have already installed ZCash and the GUI Wallet ZCashSwingWalletUI.jar in directory /home/user/zcash/src one way to run it from command line is:

    user@ubuntu:~$ java -jar /home/user/zcash/src/ZCashSwingWalletUI.jar

    If you are using Ubuntu (or similar ;) Linux you may instead just use the file manager and right-click on the ZCashSwingWalletUI.jar file and choose the option "Open with OpenJDK 8 Runtime". This will start the ZCash GUI wallet.

Donations accepted

At the present time this project is non-commercial in nature and developed by volunteers. If you find the GUI Wallet useful, please consider making a donation for its further development. Your contribution matters! Donations are accepted at ZCash address:

t1VAggo7RusLVBzHSeYbGkxDQQhLZyigxty

License

This program is distributed under an MIT License.

Disclaimer

This program is not officially endorsed by or associated with the ZCash project and the ZCash company.

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: Wallet encryption has been temporarily disabled in ZCash due to stability problems. A corresponding issue #1552 has been opened by the ZCash developers. Correspondingly wallet encryption has been temporarily disabled in the ZCash Desktop GUI Wallet.
  2. Issue: the GUI wallet does not work correctly if zcashd is started with a custom data directory, like: zcashd -datadir=/home/data/whatever This will be fixed in later versions.
  3. Issue: GUI data tables (transactions/addresses etc.) allow copying of data via double click but also allow editing. The latter needs to be disabled.
  4. 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 - soon to be fixed. A fix for the GUI wallet may be expected within 1-2 weeks.
  5. Limitation: The CPU percentage shown to be taken by zcashd is the average for the entire lifetime of the process. This is not very useful. This will be improved in future versions.