<html>
<p>Overview</p>
<p>This guide gives much of the inside info and technical nitty-gritty that you will need to make a respectable attempt at being a witness for Steem.</p>
<h1>Within the witness node config.ini file</h1>
<ul>
<li>Comment or delete all of the <strong>miners</strong>.</li>
<li>Comment or delete the <strong>mining-threads</strong> setting.</li>
<li>Have one <strong>witness</strong> (your witness, of course).</li>
<li>Assign the signing key for the witness to the <strong>private-key</strong> setting.</li>
</ul>
<p>The signing key is the <em>private key</em> for the signing <em>public key</em> that is reported for the<strong>get_witness</strong> command. Example:<code>get_witness mywitness</code>An example of select parts of the witness node config.ini file is:</p>
<pre><code># name of witness controlled by this node (e.g. initwitness)<br>
witness = "mywitness"<br>
<br>
# name of miner and its private key (e.g. ["account","WIF PRIVATE KEY"] )<br>
# miner = COMMENTED OUT<br>
<br>
# Number of threads to use for proof of work mining<br>
# mining-threads = COMMENTED OUT<br>
<br>
# WIF PRIVATE KEY to be used by one or more witnesses or miners<br>
private-key = 5PRIVATESIGNINGKEY<br>
</code></pre>
<p>Notice that there are no quotes around the private key.</p>
<h1>For the witness server in general</h1>
<ul>
<li>Close all <em>incoming</em> ports except SSH (port 22) and only open SSH for the IPs you know you'll use to control the witness server.</li>
<li>Be extra sure your blockchain is functioning by starting with the <strong>--replay-blockchain</strong> flag.</li>
<li>Redirect your <em>stderr</em> (and <em>stdout</em>) on start-up so your witness doesn't go down when you disconnect from SSH. See the example start command below for how this is done.</li>
</ul>
<p>It is best to close ports using your hosting provider's firewall. Otherwise you should configure<a href="http://ipset.netfilter.org/iptables.man.html">iptables</a> or similar.The start command for the witness node should look like this:</p>
<pre><code>./steemd --replay-blockchain --rpc-endpoint 2>debug.log 1>>info.log &<br>
</code></pre>
<p>Replay will take a while and is <em>optional</em>. Do it upon first start if, for example, you sync using a copy of a witness directory from elsewhere. If you need to boot in a hurry, say if your primary witness node goes down, leave out <strong>--replay-blockchain</strong>.</p>
<h1>Set up a separate seed node</h1>
<p>The seed node is a <em>completely different</em> server from your witness node. It is a requirement for those who want to credibly offer themselves as witnesses.If the seed node is going to be on a dynamic IP address, use a dynamic DNS service like ZoneEdit, and register a domain name to point at it.</p>
<ul>
<li>Open port 2001 in your firewall. You can actually use any port, but 2001 is a <em>de facto</em>standard established by Dan Larimer. Unless you have a fairly good reason to use another port, just use 2001.</li>
<li>With port 2001 open in your firewall, start the seed node with the flag <strong>--p2p-endpoint=0.0.0.0:2001</strong>.</li>
<li>Ensure your seednode daemon stays live like you did with the witness node by redirecting output. See the start command above.</li>
<li>Check your seed node connectivity with the shell command <strong>telnet SEED_IP 2001</strong> from a second computer. A <em>successful</em> connection will spit out a line starting with "Trying SEED_IP...", then "Connected to ..." then "Escape character ..." and then some garbage. After a few seconds it will disconnect automatically due to a non-response time out.</li>
</ul>
<h1>Advertising your intent to be a witness</h1>
<ul>
<li>Put up a post at <a href="https://steemit.com/">steemit's</a> "witness-category" explaining your credentials as a witness operator and how perfectly awesome your hosting service is for your witness node. Provide the IP address (if static) or domain mame for your seed node. Also provide the port (e.g. 2001). <em>Do not</em> provide the IP address or domain name of your witness node. This latter information should be kept secret, for security.</li>
<li>Cross-post your witness post to <a href="https://bitcointalk.org/index.php?topic=1410943">the Steem thread at bitcointalk</a></li>
<li>Let everyone at the <a href="https://steem.slack.com/">Steem Slack</a> know your intentions, especially in the "#witness" channel.</li>
<li>Be helpful to the community as much as possible. Try not to use profanity. Genuinely enjoy the outdoors, children, and small animals. Respect your elders. Be attentive to your civic duties. Go to bed early. Get up early. Drink plenty of water. Lay off the carbs and avoid trans fats. Exercise.</li>
</ul>
<h1>Testing your witness node</h1>
<p>You can test your witness node during the mining period (which may be over by the time you see this).In addition to a witness server and a seed node, you need a mining machine.Testing your witness node is for experts only. However, if you lack the confidence in your expertise to try this, then you may want to reconsider being a witness.First <strong>WHATEVER YOU DO, DO NOT ADD YOUR WITNESS TO THE MINER</strong>!!!Yeah, that's shouting and potentially obnoxious, but it's for your own good. If a witness tries to mint blocks on two different machines, it runs the risk of being caught for producing double work on a block, which will be interpreted as a malicious attempt to fork the chain. When this happens, the witness will likely be reported by an observer, and the totality of the witness's VESTS will be transferred to the reporter. The witness will cease to be a witness and it will be a dark day for the witness's owner.You have been warned.With this setup, when your miner broadcasts PoW, your witness will enter the queue. When it gets into the top 21 of the queue, it will begin to mint blocks as a witness, which your witness node should handle. It may miss some blocks depending on the competition at the top of the queue. However, if it hits its fair share, then the witness node is operating correctly.Following are example relevant sections of configuration files for the miner and witness nodes.</p>
<h2>Miner Node</h2>
<pre><code># config.ini for miner machine<br>
witness = "otherminer"<br>
<br>
miner = ["mywitness", "5MYWITNESSOWNERKEY"]<br>
miner = ["otherminer", "5OTHERMINEROWNERKEY"]<br>
...<br>
</code></pre>
<p>Notice how the <strong>witness</strong> setting for "mywitness" is missing. That's <strong>real important</strong>!</p>
<h2>Witness Node</h2>
<pre><code># config.ini for witness machine<br>
witness = "mywitness"<br>
<br>
# 5MYWITNESSSIGNINGKEY does not necessarily need to be 5MYWITNESSOWNERKEY<br>
private-key = 5MYWITNESSSIGNINGKEY<br>
<br>
# miners = DON'T PUT ANY MINERS IN<br>
<br>
# mining-threads = COMMENT THIS OUT</code></pre>
</html>
hiveblocks