force-setup.md

# Masternode Guide

Steps below setup a cold storage node, this means the collateral remains in your main wallet that you can take offline to keep the funds secure.

## Required

* 500.000 force as collateral for the masternode.
* Remote computer to run the masternode, this is usaly a vps.
* A secure computer to run the cold wallet that holds collateral.

## Setup

### Stage 01

On the cold wallet

1) Generate a masternode key

In the wallet menu go to:
Help > Debug Window > Console

A new window opens up with the console in here type:
~~~
masternode genkey
~~~

The return value of this command is your masternodes key, this key is used to prove you own the collateral for the node without having to share the private key that is able to spend the coins.

2) Create a collateral address

In the wallet menu go to:
Help > Debug Window > Console

A new window opens up with the console in here type:
~~~
getaccountaddress masternode
~~~

This command will return an address you send the fund to. Note: 'masternode' is the label of the address in the wallet, if you have multiple masternodes it is best to create a unique address and label per node.

3) Setup the collateral

Send 500k force to the address generated in the previous step.

To use the collateral one needs to get the transaction id (txid) and the index of the output index (vin) in that transaction.

a) Use the debug console

Type in command:
~~~
masternode outputs
~~~

This returns a list of key value pairs (or just one value pair) that holds the info needed. One of the key value pair is new txid and vin for the node.

~~~
{
    "<letters and numbers>":"<0 or 1>",
    "<letters and numbers>":"<0 or 1>",
    ...
}
~~~

b) Use the explorer

Look up the address on the explorer http://for.explorerz.top:3027, sins it is a new address and only one transaction should be send to it you can see the transaction id.

By clicking on the transaction id you can see the outputs, assuming that the transaction has a remainder you will see two Recipients. One is the collateral the other is the change; if the collateral is above the change or there is no change your vin is 0 else it is 1.

### Stage 02

On the remote server.

Note: Setting up a secure and stable server is a whole topic of it's own. Sins this guide only looks at a cold wallet setup your funds are never at risk sins they remain on the cold wallet and the server has no info to spend them.

Note: I assume you are able to rent a vps and connect to it using putty or some other secure shell. Second assumption is that you are using Ubuntu 16.04 as OS.

Providers:
https://www.vultr.com/
https://www.digitalocean.com/

a) Using setup script

~~~
wget https://raw.githubusercontent.com/forceunited/force-masternode-setup-ubuntu/master/16-04-setup.sh
~~~

Next make the script executable and then execute it.
~~~
chmod +x 16-04-setup.sh
./16-04-setup.sh
~~~

b) Manual setup

Update and install deps:
~~~
sudo apt-get update -y
sudo apt-get dist-upgrade -y
sudo apt-get -y update
sudo apt-get -y install build-essential libssl-dev libdb+-dev libboost-all-dev libcrypto++-dev libqrencode-dev libminiupnpc-dev libgmp-dev libgmp3-dev autoconf autogen automake libtool unzip
~~~

Get source (adjust for last version)
~~~
wget https://github.com/forceunited/force/archive/v3.6.0.0.tar.gz
tar xvf v3.6.0.0.tar.gz
rm v3.6.0.0.tar.gz
cd force-3.6.0.0/
~~~

Build and copy the executable
(the make command will take a while)
~~~
cd src
make -f makefile.unix
cp ./Forced ~/Forced
cd ~/
~~~

Setup the configuration
~~~
mkdir ~/.Force
nano ~/.Force/Force.conf
~~~

Put the info below in the configuration file and replace '<...>' with your info.
~~~
rpcuser=<my-random-unused-name>
rpcpassword=<my-random-unused-pass>
rpcallowip=127.0.0.1
listen=1
server=1
daemon=1
staking=0
masternodeaddr=<vps ip>:37246
masternode=1
masternodeprivkey=<masternode key>
~~~

Start the node (enter to go back)
~~~
./Forced -daemon
~~~

Make sure it is running
~~~
./Forced getinfo
~~~

At this point your node is ready for the start command to be send from the cold wallet. Log out of the vps and make sure it keeps running.

### Stage 03

Back on the cold wallet.

In the wallet go to:
Supernodes > My Master Nodes > Create ...

A new window pops up asking you for node info.

~~~
Alias: <a name for the node>
Address: <vps ip>:37246
PrivKey: <masternode key>
TxHash: <txid>
Output Index: <vin>
Reward Address: <optional other address to recieve rewards>
Reward %: <optional percentage of coins to send to other address>
~~~

Press 'ok' and then 'update' in the main window. The node should now be visable in the list and you can select it followed by the start command to get it running. Leave the
cold wallet open for a while so it can send the command and shortly after you should see rewards comming in.

## Done

That is all there is to it, enjoy the returns and hodl.