Instantly share code, notes, and snippets.

@mikeytown2 /venox.md Secret
Last active Oct 2, 2018

Embed
What would you like to do?

Table of Contents

  1. Quick Guide
  2. Masternode Guide
  3. Quick and easy VPS guide
  4. Troubleshooting / FAQ
  5. Appendix
  6. Venox Tip Address


Quick Guide

On your VPS run this to get the full line for masternode.conf on your desktop.

bash -c "$(wget -4 -qO- -o- goo.gl/ncErX1)" ; source ~/.bashrc

O is the letter not the number if you are typing this out.
PuTTY is highly recommended in order to use copy/paste.
You can view the script here https://goo.gl/ncErX1
At the prompts press enter to use the defaults (recommended). You can run the script mutiple times using the same IP address to have mutiple masternodes running on the same box. Each masternode should have 96mb of ram allocated for it.



Masternode Guide

What you need:

Info needed from VPS masternode:

bash -ic "$(wget -4 -qO- -o- goo.gl/ncErX1)" ; source ~/.bashrc
Run this on a VPS to generate the following values.
Or if you already ran the script run this to get the values and you forgot to copy the values.
vnx_mn1 masternode.conf

  • alias
  • IP:port
  • masternodeprivkey
Info needed from Venox wallet:

Help -> Debug Window -> Console from the toolbar and type in masternode outputs at the bottom

  • txhash
  • outputidx

Open up a text editor like notepad; this will be used to copy various bits of text to.

Turn on coin control. In the desktop wallet go to Settings -> Options -> Wallet (Venox -> Preferences -> Wallet on Mac) and make sure Enable coin control features is checked and click OK.

Transfer all your coins from the exchange or swap bot to your wallet. In your wallet go Settings -> Unlock Wallet (if you haven't encrypted you wallet you can skip this step). Create a new Address called mn1 by going to File -> Receiving addresses -> + New -> Type in mn1. Copy the mn1 address and go to send tab. In "Pay To:" paste in the address and send exactly the 10000 in a single transaction; no more, no less; exactly 10000; accpet any fees assocated with the transaction. Once the transaction of the collateral has hit the blockchain (1 block/~1 minutes) from the menubar select Tools -> Debug console. Type in masternode outputs at the bottom. The long string is the txhash and the short string (usually a 0 or 1) is the outputidx Copy these values to the top of notepad one per line. At this stage notepad should look like this; remember outputidx can be a 0 or 1.

x64xcharxlongxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
1

Once you have the VPS running (see Quick and easy guide below) the script will output the full string to paste into the masternode.conf file. Go to Tools -> Open Masternode Configuration File and paste in the big string. This is an example

vnx_mn1_vultr.guest 1.2.3.4:56789 X52xCHARSxLONGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX x64xcharxlongxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 0

Save and close masternode.conf. Restart the desktop wallet. Go to Masternodes tab. Unlock wallet if it is locked. Select the new masternode and press the start alias button.

You can also run startmasternode alias false mymnalias in the desktop console to start the masternode; replace the ending alias with the name of the masternode like this startmasternode alias false vnx_mn2_vultr.guest. Get the list of aliases by running masternode list-conf.

Make sure the status says "Enabled"; on the vps you should see Masternode vnx_mn1 successfully started!. If you just transferred to the mn1 address you'll need to wait for it to be confirmed before you can start the Masternode; this is 15 blocks. If you get a minus uptime restart the daemon on the VPS by typing in vnx_mn1 restart, and then start the masternode alias again. If the negative uptime continues try restarting the vps; note that minus time will happen if 15 blocks have not passed. The masternode active timer in the wallet will start after 15 minutes.

Rewards are queue based. The first scheduled reward after starting the masternode will be skipped (need to run through the queue 2 times before you get a payout). After that expect regular payouts.

Click here for an explanation of the values used to create a masternode

The first 3 values come directly from the Virtual Private Server. The Alias is a value used to let you know what this masternode should be called in your wallet; this can be set to anything as long as there are no spaces in it. The Address is the IP and Port of the VPS. masternodeprivkey is how the masternode running on the VPS knows instructions given to it are valid; it's like a password for the masternode software running on the VPS. The txhash & outputidx come from the blockchain. It's the transaction ID from the transfer of required collateral to the mn1 address.

Quick and easy VPS guide

Get a VPS from here

https://www.vultr.com/?ref=7333199

Once signed up go here https://my.vultr.com/deploy/

  1. Select a location
  2. Select Ubuntu 18.04
  3. Select $3.5
  4. Click deploy now button

Once deployed (wait 2 minutes) click the Manage button on the right

Under IP click the copy icon copy icon

Windows

Click here to read Windows SSH instructions

Open up PuTTY and on the left hand side select Session

Paste in the IP of your VPS into the Host Name (or IP address) field. Now is a good time to save the session. Now click open. Click Yes on the PuTTY Security Alert popup.
Security Alert
login as: root
Go back to the vultr manage webpage and under password click the copy icon copy icon
Back on the PuTTY screen right click (right click is paste) and press enter to fill in the password. root@x.x.x.x's password:


Mac

Click here to read Mac SSH instructions

Finder -> Menubar (top of screen) -> Go -> Utilities. Open Terminal. Type in
ssh root@ and then go to the menu bar and select edit -> paste (the IP address).
The authenticity of host 'x.x.x.x (x.x.x.x)' can't be established. ECDSA key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxxxxxxx. Are you sure you want to continue connecting (yes/no)? yes Type in yes here
root@x.x.x.x's password:
Go back to the vultr manage webpage and under password click the copy icon copy icon
Back on the Terminal screen paste in the password and press enter.


Run this and you'll have a master node ready to use in under an hour. Copy the following line and paste into your remote terminal and press enter.

bash -ic "$(wget -4 -qO- -o- goo.gl/ncErX1)" ; source ~/.bashrc

O is the letter not the number if you are typing this out.
PuTTY is highly recommended in order to use copy/paste.
Press Enter at the prompts to use the defaults. If setting up more than one master node, simply re-run the script.

You can view the script here https://goo.gl/ncErX1

Script will end with

  • Auto starting venoxd daemon running under the newly created user
  • The long string to paste into your masternode.conf file.

Go back to the start of this guide to see what to do with the long string.

If you messed up and want to start over with a fresh VPS instance go to https://my.vultr.com/ click on the three dots to the right ... and select Server Reinstall.



Troubleshooting / FAQ

Do I need multiple IPs to run multiple masternodes on a single VPS?

You do not need multiple IPs; rerun the script to setup a another masternode on your VPS.

Staking Reward Time

Staking rewards are by chance. You have to have your computer with the wallet running 24/7 for this to work. Staking does not work if your computer is in Sleep mode. Coins need to be untouch for 2 hours before they will start to stake.

Staking tips and tricks

Make sure your system clock is in sync https://time.is/
If it is out of sync use a 3rd party program to keep it in sync like http://www.timesynctool.com/
Have a low ping time http://ping-test.net/

Leave computer on 24/7. Unlock for staking only if your wallet if password protected. Coins are not mature until they have been untouched for 2 hours.

How long will it take for my first mn reward?

Your masternode needs to run through the queue 2 times and on the 3rd time you'll get a reward. So take the total masternode count * 0.05 = number of hours before first payout. Quick example with 240 masternodes running:
240 * 0.05 = 12 hours.

Can I run a masternode on my home computer?

Technically yes. You need a static IP from your ISP as well as a way to open up the port that your masternode is running on in your router. A VPS is easier to setup and run.

How do I backup my wallet?

Make sure it's been encrypted with a password and then store the wallet.dat file on Dropbox or Google Drive. Make sure the cloud backup provider has 2 factor authentication enabled (Google, Dropbox). On windows the wallet can be found in the %appdata%/venox directory (windows key + r %appdata%/venox and if that doesn't work try %userprofile%\AppData\Roaming\venox). On Mac it can be found in the ~/Library/Application Support/venox directory; Finder -> Menubar (top of screen) -> Go -> Utilities, open Terminal, type in open ~/Library/Application\ Support/Venox.

You can also backup via dumpprivkey. Go to tools -> debug console and type in listaccounts; then for each address name type in getaddressesbyaccount ""; then do dumpprivkey on that address like so dumpprivkey pxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. The output from this can be used to steal your coins, and also used for backup purposes. Be careful!

You can also backup via dumpwallet. Go to tools -> debug console and type in dumpwallet vnx.out. vnx.out is usually put in the same folder as the Venox wallet executable.

My VPS got restarted and now my masternode is not running.

You need to start the Masternode again. Unlock the Wallet. Venox - Wallet -> Masternodes -> Start MISSING. It should be running again.

Wrong amout is shown in coin control features.

Send all coins from addreses that have a wrong amount so that the value in thoese are zero. Restart wallet.

Edit masternode.conf

Tools -> Open masternode configuration file.

If the above doesn't work you can do this:
windows key + r
nodepad %appdata%/venox/masternode.conf
Copy Paste the above line into the run dialog box.

Edit venox.conf

Tools -> Open wallet configuration file.

If the above doesn't work you can do this:
windows key + r
nodepad %appdata%/venox/venox.conf
Copy Paste the above line into the run dialog box.

How to double check all details of the masternode

Close and open your desktop wallet. Tools -> Debug Console and type in masternode outputs at the bottom. Also go to Tools -> Open Masternode Configuration File. Connect to your VPS and run these commands as the root user. Replace vnx_mn1 with the username used for the masternode if needed.
vnx_mn1 conf | grep -E "privkey|bind|external"

Carefully comapre the IP, the masternodeprivkey, as well as the transaction id and output index.

Remove user from VSP

The following example uses the username vnx_mn9.

vnx_mn9 remove_daemon

I've been locked out of the VPS

You get one of these errors when trying to login via putty:
"Network error: Connection timed out"
"Network error: Software caused a connection abort"

Go here to get your IP address: http://ipinfo.io/ip. Then you'll need to login to the box via the "view console" button on the vultr manage page. once logged in type this in

denyhosts_unblock YOUR.DESKTOP.IP.ADDRESS

Replace "YOUR.DESKTOP.IP.ADDRESS" with the nubers found on http://ipinfo.io/ip

Venox Website

https://www.venox.info/

Wallet

Release Notes
Windows
Mac
Linux

WorldCoinIndex

https://www.worldcoinindex.com/coin/venox

Block Explorer

http://explorer.venox.info/

3rd party Monitoring service

https://masternodes.online/monitoring/

List of very cheap VPS - Use at your own risk!

http://subnetlabs.com/billing/aff.php?aff=455&pid=37 - $12 a year, takes hours to provision.
https://www.arubacloud.com/vps/virtual-private-server-range.aspx - €1 a month.
https://vrtz.net/type/yearly/ - List of cheap providers.
https://aws.amazon.com/free/ - 1 year of free hosting; EC2 is hard to setup.



Appendix

Useful commands to run as root on your VPS:

Switch user to root (do this first if not root):
sudo su

View config file:
vnx_mn1 conf

Get string to put into masternode.conf:
vnx_mn1 masternode.conf

Check version:
vnx_mn1 getinfo

Check if mn has been started remotely:
vnx_mn1 masternode debug

Check mn status (4 is up and running):
vnx_mn1 masternode status

Start daemon:
vnx_mn1 start

Reindex daemon block db:
vnx_mn1 reindex

Stop daemon:
vnx_mn1 stop

Daemon status:
vnx_mn1 status

Get connection count:
vnx_mn1 getconnectioncount

Get block count:
vnx_mn1 getblockcount

Get blockchain info:
vnx_mn1 getblockchaininfo

Verify the block count of your masternode and the explorer are the same:
vnx_mn1 checkblock

Rename the daemon on the VPS:
vnx_mn1 rename vnx_mn3

Check system log of the daemon on the VPS:
vnx_mn1 system_log

Check daemon log on the VPS:
vnx_mn1 daemon_log

Run the same command on all masternodes:
all_mn_run masternode debug

Get all the pubkey's for https://masternodes.online/monitoring/
all_mn_run masternode status | grep '"addr"' | awk '{print $2'} | tr -d '",'

How to watch a command:
watch -x bash -c 'PS1="\\";. /root/.bashrc; vnx_mn1 getinfo '
watch -x bash -c 'PS1="\\";. /root/.bashrc; vnx_mn1 daemon_log | tail '
watch -n 0.4 -x bash -c 'PS1="\\";. /root/.bashrc; vnx_mn1 getblockchaininfo '



VNX Tip Address

VKizdNCrnAfKHFv3sEfxxCDZ3gzf35LsNW



Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment