Run a POA node on Windows

How to run a POA node on Windows

1. Install .Net

Catalyst.Node works with .Net Core v3.0. You'll need to have the .Net SDK installed.

If you don't have .Net Core installed you can follow the instructions for your platform bellow.

• Windows

2. Install the Rust Toolchain

Catalyst.Core uses our native Rust BulletProof library. In order to be able to build the solution, you will need to ensure that the Rust toolchain is correctly installed on you machine.

Windows environments

If you have not done so before, download and install the Microsoft Visual C++ Build Tools 2019 from https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019. Alternatively, if you are using Visual Studio, you should be able to modify your existing installation to add this feature.

Go to https://www.rust-lang.org/tools/install, then download and execute rustup-init.exe

Then

Nightly mode must now be installed and enabled by:

rustup toolchain install nightly

and then:

rustup default nightly

3. Create a self signed certificate (Linux only)

If you're on Linux, you need to create a Self Signed Certificate the instructions for which are found here:

Create a Self Signed Certificate

4. Install MongoDB

Instructions to install MongoDB can be found here for each operating system.

5. Clone the repository

To clone the repository it is assumed you have Git installed. If you do not, then follow the Git install instructions.

Prerequisite - Enable long paths

make sure that long paths are allowed in both windows and git

• for windows follow the instructions at https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file#enable-long-paths-in-windows-10-version-1607-and-later
• for git : start a git terminal as administrator run the following command : git config --system core.longpaths true

To clone the Catalyst repository use the command:

git clone https://github.com/catalyst-network/Catalyst.git

Then navigate into the repository:

cd Catalyst

Install the dependencies using the command:

git submodule update --init --recursive --force

6. Build the solution

Navigate to the src folder:

cd src

In the src folder build the solution:

dotnet build Catalyst.sln

7. Run the node

To run the node change to:

cd Catalyst.Node.POA.CE

Then use the command

dotnet run

Configuring a Catalyst POA node

Currently on the POA network the catalyst peer ID and DFS peer ID are seperate. This will be changed soon however currently the node must be configured as follows:

1. Start the node and enter your node password, ipfs password, and cert password. Stop the node.

2. Find and copy your public key for later use, it should show in the console output or in the Catalyst logs like the following:

using PublicKey: 3edzejbuvme3ed4wqr5pp23if7rguoy7yddlcy3whijywzvo7lfq

3. Find your external ip address and copy it for later use: Whats My IP Address

4. Go to your home profile directory:

WINDOWS(cd %userprofile%/.catalyst) or LINUX / MacOS(cd ~/.catalyst)

5. Edit devnet.json and replace the Peer BindAddress and the RCP BindAddress with your internal IP address found using the command ipcconfig on Windows and ifconfig on Unix (MacOS / Linux) using IPV4. Then replace the Peer PublicIpAddress with your external ip address from Step 3 and replace the public key with your public key from Step 2.

6. Port forward if you are behind NAT. If your internal and external IP Addresses in step 5 were different then you are behind NAT. To port forward you will have to log into your router with administrator passwords found generally on the router. The port forwards that will need to be set up are as follows : 42076(udp) 42066(tcp) 4001(tcp) / API: 5005(tcp). Here is a guide on how to port forward Port Forward.

7. If not currently in 'Catalyst.Node.POA.CE' move to this directory. Re-run your node, enter your credentials again and the node should now be running.