Zephyr Protocol — Wallet Guide (v0.2.2)
Guide for using the Zephyr Wallet!
We are hard at work on a new wallet! When it is available this article will be deprecated/updated.
This Guide has been available on our Discord, but due to Txbits shutdown an influx of users are looking to use the Zephyr Wallet for the first time — which is great!
Always remember not your keys not your coins!
It is best practice to not store your coins on any exchange.
Instructions (Windows GUI)
Download
Download the wallet relevant for your system from:
https://github.com/ZephyrProtocol/zephyr/releases/tag/v0.2.2
Extract!
Start zephyrd.exe
zephyrd is the Zephyr Daemon. This is what syncs with the blockchain and connects to the network.
Starting zephyrd.exe manually first a required step!!!
Lots of users have had issues with the background zephyrd process running correctly.
- Make sure you allow connections if prompted
- You must continue to run zephyrd to operate the wallet.
Wait for sync
Before you proceed, ensure that your zephyrd is fully synced!
Above is what a synced zephyrd looks like!
You can type in “status” to ensure you are at 100% synced
Open zephyr-wallet-gui.exe
Create a new wallet:
Give your wallet a name:
Save your seed!
Best practice is to write it down on paper!
Remember — if you have your seed you will always be able to recover your funds!
Add a password (optional)
Select “start a node automatically in the background”
Since you already have zephyrd running, the wallet should automatically point to it once you open it!
You’re all set!
If your wallet does not look like this:
i.e.
- ”Wallet is synchronized”
- “Connected”
You have an issue with synchronization (zephyrd). Have a read below:
TROUBLESHOOTING
Synchronization
Almost all user issues are synchronization issues.
E.G. If the bottom left of your wallet looks like so:
Step 1
Close all instances of the wallet from Task Manager:
Step 2
Open zephyrd.exe manually
Step 3
Wait for sync:
Look for:
You are now synchronized with the network.
If you don’t get this, its likely a firewall issue.
Open ports 17766 and 17767 and/or allow zephyrd in your firewall settings.
- Keep this window running!
Step 4
Open zephyr-wallet-gui.exe
Ensure your wallet shows that you are connected:
That’s all there is to it!
If you still have issues, and you are absolutely sure have your zephyrd running you can try connecting to it as if it is a remote node as below.
Synchronization — Connect to your local node as if it a remote node:
A rare issue, but this has been a fix for a few people!
- 1- Click Settings
- 2- Click the Node tab
- 3- Click “Remote node”
Click “Keep it running”
Click “Add remote node”
Address: 127.0.0.1
Port: 17767
Check “Mark as Trusted Daemon” ✅
127.0.0.1 is your localhost ip address — same for everyone.
You may need to select the node from the list but this should be it!
Note the bottom left — if it looks like this then you are good to go!
Incorrect Balances
If you feel like your balances are not correct, there are a few things you can try!
Step 1
Ensure your wallet is synchronized!
Refer above if this is not the case.
I.e. if it does not look like this:
Step 2
- Navigate to Settings -> Wallet.
- Click “rescan wallet balance”
Your wallet will rescan the blockchain!
Your wallet should now display the correct balance. if it still doesn’t ensure your zephyr daemon is working correctly as outlined above
IF YOU DON’T SEE RESCAN WALLET BALANCE
This is usually due to your wallet not being synchronized.
If it is and you still don’t see it, change wallet mode to advanced
Click “Change wallet mode”
Click “Advanced mode”
Open your wallet back up:
ITS STILL NOT WORKING/OTHER ISSUES!
RCT ISSUES/DOUBLE SPEND ETC
- Ensure your version is upto date (v0.2.2 at time of writing)
- Backup your seed! — very important to not lose this!
- Delete blockchain and/or wallet files (either in C:\ProgramData\zephyr on windows or .zephyr in your home directory on linux)
- Follow along with instructions above again ^ but restore from seed this time
- open zephyrd and wait until it is synced before opening gui or cli wallet
- ensure your wallet creation height is 0 and you have rescanned
Set “Wallet creation” as 0:
CLI (Migration)
If you use the cli, or still have too much trouble with the gui you can opt to use the cli.
Ensure you run zephyrd first (you need to run both zephyrd and zephyr-wallet-cli at the same time).
if you are migrating from GUI:
parse in the wallet locations or simply copy over the wallet files to the same directory as zephyr-wallet-cli — file path is stated in Settings -> info.
Default path is <User>\Documents\Zephyr\wallets\<wallet_name>
you may have wallet creation height issues, you can set it to 0 with this command:
set refresh-from-block-height 0
rescan_bc will rescan the blockchain.
RESTORE FROM SEED
./zephyr-wallet-cli — restore-from-seed