THORNode Overview

Overview of THORNodes

Overview

THORNodes service the THORChain network. Each THORNode is comprised of several independent servers in a cluster. All THORNodes communicate and operate in cooperation to create a cross-chain swapping network. Running a node is a serious undertaking. While Node Operators are well compensated for running a node, there are also risks, skills required and costs.

See the Node Operator 101 Video to learn more before running a node.

To understand more about running a THORNode, see the below links:

Risks, Costs and RewardsTHORNode StackNode Operations

THORNode Dashboards

THORNode information can be viewed at the following dashboards:

  1. thorchain.network - Comprehensive THORNode dashboard

  2. thorchain.net - THORNode information and network statistics

  3. runescan.io - THORNode information within the block explorer

  4. thorcharts.org - Earning distribution and other historical data

Skillsets

Running a THORNode is no simple task. As an operator, you will need to run/maintain multiple linux servers with extremely high uptime. It is encouraged that only professional systems engineers run nodes to maintain the highest quality reliability and security of the network. The simple question to know if you have the skillsets to run a THORNode is:

Have you used pagerduty before?

If the answer is no, it’s probably best that you do not run a node and participate in the network in other ways, such as a RUNEPool participant or a bond provider. The following skill sets are required to be an effective node operator.

  • Advanced knowledge of Linux server administration and security

  • Advanced knowledge of Kubernetes

  • Advanced experience running a host of nodes on a hosted platform such as AWS, Google Cloud, Digital Ocean, etc

  • Knowledge of running full nodes for other chains such as Bitcoin, Ethereum, and Binance.

  • Willingness to be “on call” at all times to respond to issues when/if your node becomes unavailable

Creating a Node

To set up a node, you have two choices:

  1. Set up manually (not recommended unless you are an expert)

  2. Set up via Kubernetes (recommended)

You can create a bare metal node with your own hardware or use the the cluster launcher section for step by step guides using a host provider:

Cluster Launcher

Once created, follow the Deploying, Joining and Managing pages.

Node Voting

THORNodes have the ability to vote on Mimir settings. This is important when voting for ADRs and important network changes.

Mimir settings have specific abilities. The process for voting from a node is:

Make mimir
=> Enter THORNode Mimir key: <key>
=> Enter THORNode Mimir value: <value>
  1. Mimir keys and values are listed in the Mimir endpoint.

  2. A node can vote at any time on any key value.

  3. A node's vote is valid as long as they are active (and removed if they are not).

  4. 2/3rds of active nodes need to agree for the change to happen

  5. If 2/3rds consensus is not reached, Mimir admin takes priority, or a constant if present.

  6. A node can change their vote anytime.

  7. A node can delete their vote by using -1 value

  8. Voting costs one native transaction fee, which is deducted from their bond.

Last updated