How to

IMPORTANT INFORMATION

1. Always encrypt your wallet.dat file with a strong passphrase. Remember, backup and store it in a safe (preferably offline) location. The passphrase will protect (depending on its complexity) your ZNN in case someone steals your wallet.dat file physically or digitally.
2. Always back up your wallet.dat file. It is automatically and periodically backed up by the wallet itself inside the backups folder (see Wallet data locations), but for extra caution you can also do it manually. Replicate all new backups to all backup locations. Only add to them, do not overwrite old backups.
3. Never ever delete/overwrite a wallet.dat file or your backups folder. Instead, rename the existing file and add it to your backups.
4. Do not forget your encrypted wallet passphrase from step 1. If you do, your funds are lost forever. If you want to record the passphrase somewhere, make sure you use an offline, secure method that you will not lose access to and nobody else can access.
5. Do not run the same wallet in multiple locations at the same time. This can corrupt your wallet and you can lose all ZNN.
6. Do not back up your wallet.dat file to a cloud provider or shared storage. Also consider extreme events like floods, tornados, hardware failures, fires, or hackers when you store your backups.
7. Do not ever send your wallet.dat file to anyone for any reason. There is no support reason to request your wallet file, so if anyone asks you for this report the scammers to the community.
8. Do not ever share the information from dumpprivkey, masternodeprivkey or any sensitive commands with anyone. This would give them access to your funds. If anyone asks you for this information report the scammers to the community.
9. Do not accept or solicit support over private messages/channels, this is where scammers usually operate. Share any suspicious activity with the community.

Welcome to Zenon! Below is a quick tutorial to get started with Zenon Wallet

1. Carefully read the "Important information" section before downloading the wallet
1. Download the latest Zenon wallet for desktop from here or from the Zenon Github repository. Verify the SHA-256 checksum to match with the one on the website
3. Start the wallet and after the intro screen wait for it to fully sync
4. Encrypt your wallet from Settings -> Encrypt Wallet
5. Backup your wallet.dat in a secure location
6. Now you can use the wallet to interact with Zenon Pillars Generation Phase.

How to verify the SHA-256 checksum of the wallet?

How to hash a file to confirm its integrity:
1) On Windows, you can open up a command prompt and use the certUtil command.
Usage: certUtil -hashfile SHA256
Example: C:\Users\yourusername>certUtil -hashfile "C:\Users\yourusername\Downloads\Zenon-installer.zip" SHA256
SHA256 hash of C:\Users\yourusername\Downloads\Zenon-installer.exe:
*hash*
CertUtil: -hashfile command completed successfully.
2) On Mac, you can open a terminal window and use the openssl command.
Usage: openssl sha -sha256 filepath
Example: openssl sha -sha256 /Users/yourusername/Downloads/zenon-macos64.dmg
3) On Linux, you can open a terminal window and use the sha256sum command.
Usage: sha256sum filepath
Example: root@linux:~$ sha256sum /root/zenon-linux64.zip
*hash* zenon-linux64.zip
Compare the hash obtained with the hash of the corresponding wallet version found at https://zenon.network/wallet/

How to enable staking?

The following conditions must be simultaneously true:
1) Blockchain must be fully synced, NOT importing or reindexing.
2) Chain tip's timestamp must be past a certain time (was many many months ago).
3) Wallet must have active connections (Tools -> Peers list -> check that there are more than 3 active peers).
4) Wallet must be unlocked. Read Important information section first and after that proceed to carefully encrypt the wallet (Settings -> Encrypt wallet). After the encryption process ends, the wallet will close. Reopen the wallet and wait for it to fully sync before unlocking. To unlock it, enter your passphrase and check For staking only box situated below.
5) Must have mintable coins. Mintable coins (maturated coins) have 101 confirmations or more.
6) Must have more coins than reserve balance (reservebalance default is 0).
7) Nodes additional data must be synced (after the progress bar reaches 100%, it should dissappear).
8) Double check the status of these conditions by going into Tools -> Debug Console -> type getstakingstatus. All the outputs should be true in order for successful staking.

The staking icon indicator (right bottom icons) should be green if all conditions from point 8 are true. Staking is a probabilistic type selection, proportional to your ZNN balance. The more ZNN you have, the higher the probability to get staking rewards.
The wallet must be always opened and connected to the network for staking to be enabled at any time, so make sure your machine doesn't enter sleep mode.

How to disable staking?

Stop the wallet, navigate to Zenon.conf file and put staking=0 inside it. After that start the wallet again.

Wallet is crashing and cannot launch. It fails every time. What should I do?

An abnormal exit of the wallet can result in a blockchain inconsistency and corrupt it and includes assertion and block failures.
This can happen due to an unexpected reboot without first closing the wallet gracefully or if the existing locally downloaded blockchain somehow got corrupt and cause the wallet to crash.

*Please note that during sync, your balance will show as 0 until near the end, this is normal and nothing is lost.

1) Easy Method
GUI Wallet users:
Tools -> Wallet Repair -> Delete Local Blockchain Folders (-resync) to initiate a full resync.

CLI Wallet users:
You can initiate the full resync during daemon startup with the command switch "Zenond -resync".

2) Advanced Method
a) Navigate to your Wallet data location and delete all files/folder EXCEPT for the following files/folders: wallet.dat, backups, masternode.conf, Zenon.conf.
b) Now launch again the wallet and wait for it to fully sync.

How to setup a Node?

A complete guide is available here

How to verify if the wallet is fully synced?

Desktop Wallet: Toolbar -> Tools -> Debug Console -> Input getstakingstatus
Node Wallet: /usr/local/bin/Zenon-cli getstakingstatus
The field mnsync must be true

How to update the wallet?

Before beginning the update process, please make a backup of the wallet.dat file or the private keys and store them in a safe location.

In case you have ZNN Nodes, you will need to first update the wallet and after that the Nodes.

If you are running an older version, shut it down. Wait until it has completely shut down (i.e. Zenon wallet process is no longer alive - it can take several minutes on older systems).
You can check what version you are currently running: Toolbar -> Help -> About Zenon Core or going into Debug Console and issuing getinfo command. It is also recommended to disable staking before proceeding to the next steps.

Wallet Update
Windows: Run the Zenon-installer.exe or manually replace Zenon-cli.exe, Zenond.exe, Zenon-tx.exe / Zenon-qt.exe and start the wallet.
MacOS: Open the dmg, replace the Zenon-qt application and start the wallet.
Linux: Replace Zenond, Zenon-cli, Zenon-tx / Zenon-qt and start the wallet.

Node Update
Login in the VPS terminal and follow the steps from here
After the script finishes, you need to wait for both wallets to fully sync and start the updated Node(s) from the updated desktop wallet.

In order to verify if a wallet is fully synced:
Desktop Wallet: Toolbar -> Tools -> Debug Console -> Input getstakingstatus
Node Wallet: /usr/local/bin/Zenon-cli getstakingstatus
The field mnsync must be true

How to enable Coin Control?

Windows: Toolbar -> Settings -> Options Menu -> Wallet tab -> Check the Enable coin control features

MacOS: Toolbar -> Zenon -> Preferences -> Wallet tab -> Check the Enable coin control features

Linux: Toolbar -> Settings -> Options Menu -> Wallet tab -> Check the Enable coin control features

How to enable Pillars tab?

Windows: Toolbar -> Settings -> Options Menu -> Wallet tab -> Check the Enable Pillars tab

MacOS: Toolbar -> Zenon -> Preferences -> Wallet tab -> Check the Enable Pillars tab

Linux: Toolbar -> Settings -> Options Menu -> Wallet tab -> Check the Enable Pillars tab

Zenon client or daemon crashes on startup or randomly force quits. How to fix this?

Please make sure the machine you are running Zenon client has minimum 2GB RAM on Linux, 4GB for Windows or MacOS.

APPENDIX

Immature (ZNN) = The maturity of coins refers to their staking eligibility, which is controlled by their amount of confirmations. ZNN are considered mature once they have 101 confirmations, which takes about 101 blocks (~101 minutes).
Unconfirmed (ZNN) = A ZNN transaction that has not yet been included in a block.
Orphan block = A block that is no longer part of the current blockchain.
Chain fork = A divergence of the blockchain that usually happens due to different protocol rules.
Code fork = A clone of existing code to be developed and implemented in a different way (from existing protocol rules).
Wrong chain = Incorrect blockchain, usually by not updating your software with a mandatory version in time.
GUI Wallet = Graphical User Interface Wallet (Zenon-qt)
CLI Wallet = Command Line Interface (Zenond - the daemon; Zenon-cli - connects to the daemon via RPC)
Staking = The process of mining valid blocks and include them into the blockchain following the protocol rules.

WALLET DATA LOCATIONS

Windows: C:\Users\yourusername\AppData\Roaming\Zenon
MacOS: /User/yourusername/Library/Application\ Support/Zenon
Linux: /root/.Zenon