HorizenWallet (Swing Wallet) - Backup, Upgrade and Troubleshooting

Anytime you download software see if a checksum is available. Please review this document:
Checksums and Software

Languages

As of block 920000 (April 22nd, 2021) Swing/HorizenGUIWallet must be upgraded to version 1.0.0 which includes zend binaries (2.0.23)

https://github.com/HorizenOfficial/zencash-swing-wallet-ui/releases/latest

  • Wallet Backup
  • Wallet Upgrade
  • Wallet Troubleshooting

Wallet Backup - Every time a "New Z (Private) address" is generated, more than 100 T (Transparent) addresses are generated or if a key is imported, the wallet.dat file should be backed up.
1


  1. Close the wallet application if it is running
  2. Open the Finder application
    1. Click on the Go menu item at the top, click on "Go to Folder..." or press Shift+Command+G
  3. Enter the following:

    ~/Library/Application Support/Zen/

  4. Copy the wallet.dat file to a secure location, such as an encrypted thumb drive
    1. How to create an encrypted thumb drive in Mac OS using Disk Utility




  1. Close the wallet application if it is running
  2. Open the Files application
    1. Click the Files icon in the Favorites menu

  3. Press Ctrl + L keys and enter the following:

    ~/.zen/

  4. Copy the wallet.dat file to a secure location, such as an encrypted thumb drive
    1. How to create an encrypted thumb drive in Linux using Disks Utility



  1. Close the wallet application if it is running
  2. Open the Run application
    1. Click start and type run (Windows 10) or press Windows Key + R
  3. Enter the following:

    %AppData%\Zen

  4. Copy the wallet.dat file to a secure location, such as an encrypted thumb drive

    1. How to create an encrypted thumb drive on Windows 10 Pro with BitLocker
    2. How to create an encrypted thumb drive using VeraCrypt



Wallet Upgrade
2

This column does not apply for MacOS: El Capitan

Support for El Capitan has been deprecated


  1. Close the wallet application if it is running
  2. Go to github repository https://github.com/HorizenOfficial/zencash-swing-wallet-ui/releases/latest
  3. Find 

    Installing the Horizen Desktop GUI Wallet on Mac OS

  4. Download the .dmg installer file:
  5. Double-click .dmg file and acknowledge MIT license:
  6. Drag HorizenDesktopGUIWallet app to /Applications

    Allow replacement.
  7. You may receive this message:

    Click Show in Finder
  8. Control-click on the HorizenDesktopGUIWallet app (right0click if you have two-button mouse) and Open


  1. Close the wallet application if it is running
  2. Launch Terminal
  3. Update the apt cache

    sudo apt-get update -y
  4. Install zen, this will upgrade the zend daemon if a new version is available

    sudo apt-get install zen -y
  5. Install GUI Wallet

    sudo apt-get install zencash-desktop-gui-wallet -y
  6. Launch HorizenWallet


  1. Close the wallet application if it is running
  2. Remove any existing shortcuts
    1. Desktop shortcuts
      1. Right click the existing desktop shortcut
      2. Select `Delete`
    2. Start menu shortcuts
      1. Open the start menu
      2. Right click the shortcut
      3. Select `Unpin from Start`


  3. Go to github repository https://github.com/HorizenOfficial/zencash-swing-wallet-ui/releases/latest
  4. Follow instructions per 

    Installing the Horizen Desktop GUI Wallet on Windows


Wallet Troubleshooting - Common Errors & Solutions
3

Error:

A general unexpected critical error has occurred:
error: couldn't connect to server: unknown (code -1)
(make sure server is running and you are connecting to the correct RPC port)
See the console output for more detailed information! 

Error:

A general unexpected critical error has occurred:
error: couldn't connect to server: EOF reached (code 1)
(make sure server is running and you are connecting to the correct RPC port)
See the console output for more detailed information! 

Symptom:

Balances are shown incorrectly with 100% synced blockchain.
4

  1. Backup the wallet.dat, using the instructions in the Wallet Backup instructions above
  2. Launch Terminal
    1. From the Finder Open the Utilities Folder
    2. Open Terminal
  3. Re-Scan your blockchain
    1. Paste/Enter the following into your terminal

      /Applications/HorizenDesktopGUIWallet.app/Contents/app/zend --rescan
    2. Press 'Ctrl + C' to exit the zend daemon after re-scanning is complete
  4. Open your HorizenWallet and it should load
    1. Note the progress of the Blockchain synchronization in the lower right hand corner
      1. If this does not solve your error, continue to the next step
  5. Obtain a copy of the debug.log and attach it to a ticket on support.horizen.io
    1. debug.log - Full Client Swing Wallet - Troubleshoot

  1. Backup the wallet.dat, using the instructions in the Wallet Backup instructions above
  2. Launch Terminal
  3. Re-Scan your blockchain
    1. Paste/Enter the following into your terminal

      zend --rescan
    2. Press 'Ctrl + C' to exit the zend daemon after re-scanning is complete
  4. Open your HorizenWallet and it should load
    1. Note the progress of the Blockchain synchronization in the lower right hand corner
      1. If this does not solve your error, continue to the next step
  5. Obtain a copy of the debug.log and attach it to a ticket on support.horizen.io
    1. debug.log - Full Client Swing Wallet - Troubleshoot

  1. Backup the wallet.dat, using the instructions in the Wallet Backup instructions above
  2. Launch command prompt
    1. Hit 'Windows Key + R', type 'cmd' and hit <enter>
  3. Change directories to the location noted earlier using the 'cd' command

    Example Output

    cd C:\Program Files\HorizenDesktopGUIWallet\app

  4. Re-Scan your blockchain
    1. Paste/Enter the following into your terminal

      zend --rescan
    2. Press 'Ctrl + C' to exit the zend daemon after re-scanning is complete
  5. Open your HorizenDesktopGUIWallet and it should load
    1. Note the progress of the Blockchain synchronization in the lower right hand corner
      1. If this does not solve your error, continue to the next step
  6. Obtain a copy of the debug.log and attach it to a ticket on support.horizen.io
    1. debug.log - Full Client Swing Wallet - Troubleshoot

HorizenWallet (Swing Wallet) - Backup, Upgrade and Troubleshooting



© 2020 Horizen. All rights reserved.