# Node Setup Pre requisites:- ### System requirements The system requirements listed in this section are both for the Sentry node and the Validator node.The **minimum** system requirements mean you can run the nodes but the setup is not future-proof.The **recommended** system requirements mean the nodes are future-proof. There is, however, no upper limit to future-proofing your nodes.You must always run the sentry node and the validator node on separate machines. #### Minimum system requirements * RAM: 32 GB * CPU: 8-core * Storage: 2.5 TB SSD InfoFor Amazon Web Services (AWS), the equivalent of the minimum requirements instances are, **with unlimited credits selected**: * For Sentry: **c5.2xlarge** * For Validator node: **c5.4xlarge** #### Recommended system requirements * RAM: 64 GB * CPU: 16-core * Storage: 5 TB SSD * Bandwidth: 1 Gbit/s InfoFor Amazon Web Services (AWS), the equivalent of the recommended requirements instance is **m5d.4xlarge**.For OVH, the equivalent of the recommended requirements instance is **infra-3**.For network, expect 3-5 TB of data transferred per month. # Sentry Node # Mainnet ## Run a Sentry Node from Binaries ### Prerequisites: `build-essential` installed on both the sentry and the validator machines. To install: ``` sudo apt-get install build-essential ``` Go 1.18 installed on validator machine. To install: ``` wget https://raw.githubusercontent.com/Ramestta-Blockchain/launch/master/go-install.sh bash go-install.sh sudo ln -nfs ~/.go/bin/go /usr/bin/go ``` Docker and RabbitMQ to install on validator machines. ``` sudo apt-get update sudo apt install rabbitmq-server ``` To install sublime-text: ``` sudo snap install sublime-text --classic ``` #### Installing Heimdall: Heimdall is the proof-of-stake verifier layer responsible for checkpointing the representation of the Plasma blocks to the Ramestta mainnet. Clone the [Heimdall repository](https://github.com/Ramestta-Blockchain/heimdall):thumbsup: ``` git clone https://github.com/Ramestta-Blockchain/heimdall ``` ``` cd heimdall ``` ``` make build make install ``` ``` cd ~ source ~/.bashrc ``` Check the Heimdall installation: ``` heimdalld version --long ``` note Before proceeding, Heimdall should be installed on both the sentry and validator machines. #### Installing Bor Bor is the sidechain operator that acts as the block production layer, which syncs with Heimdall to select block producers and verifiers for each span and sprint. Clone the [Bor repository](https://github.com/Ramestta-Blockchain/bor):thumbsup: ``` git clone https://github.com/Ramestta-Blockchain/bor ``` ``` cd bor ``` **Install Bor:** ``` make bor-all ``` **Create symlinks:** ``` sudo ln -nfs ~/bor/build/bin/bor /usr/bin/bor sudo ln -nfs ~/bor/build/bin/bootnode /usr/bin/bootnode ``` **Check the Bor installation:** ``` bor version ``` note Before proceeding, Bor should be installed on both the sentry and validator machines. ### Setting Up Node Files: Node files need to be set up on both the sentry and validator machines. #### Fetching the launch repository Clone the[ launch repository](https://github.com/Ramestta-Blockchain/launch): ``` git clone https://github.com/Ramestta-Blockchain/launch ``` #### Setting up the launch directory **On the validator machine** Create a `node` directory: ``` mkdir -p node ``` Copy the files and scripts from the `launch` directory to the `node` directory: ``` cp -rf launch/mainnet-v1/sentry/sentry/* ~/node cp launch/mainnet-v1/sentry-service.sh ~/node ``` #### Setting up the network directories: **Setting up Heimdall** Change to the `node` directory: ``` cd ~/node/heimdall ``` Run the setup script: ``` bash setup.sh ``` **Setting up Bor** Change to the `node` directory: ``` cd ~/node/bor ``` Run the setup script: ``` bash setup.sh ``` ### show enode: ``` bootnode -nodekey ~/.bor/data/bor/nodekey -writeaddress ``` Run the setup script: ``` bash setup.sh ``` ### Setting Up the Services: Run this section both on the sentry and validator machines. Navigate to the `node` directory: ``` cd ~/node ``` Run the setup script: ``` bash sentry-service.sh ``` Copy the service file to the system directory: ``` sudo cp *.service /etc/systemd/system/ ``` #### Starting the Heimdall service You will now start the Heimdall service on the validator machine. Once the Heimdall service syncs, you will start the Bor service on the validator machine. **Start the Heimdall service:** ``` sudo service heimdalld start ``` **Start the Heimdall rest-server:** ``` sudo service heimdalld-rest-server start ``` **Check the Heimdall service logs:** ``` journalctl -u heimdalld.service -f ``` **Check the Heimdall rest-server logs:** ``` journalctl -u heimdalld-rest-server.service -f ``` **Check the sync status of Heimdall:** ``` curl localhost:26657/status ``` In the output, the `catching_up` value is: * `true` — the Heimdall service is syncing. * `false` — the Heimdall service is synced. Wait for the Heimdall service to fully sync. #### Starting the Bor service Once the Heimdall service on the validator machine syncs, start the Bor service on the validator machine. **Start the Bor service:** ``` sudo service bor start ``` **Check the Bor service logs:** ``` journalctl -u bor.service -f ``` ### Service to Auto Start After Server Crash/Reboot ``` sudo systemctl enable heimdalld sudo systemctl enable heimdalld-rest-server sudo systemctl enable bor ``` # Testnet ## Run a Sentry Node from Binaries ### Prerequisites: `build-essential` installed on both the sentry and the validator machines. To install: ``` sudo apt-get install build-essential ``` Go 1.18 installed on validator machine. To install: ``` wget https://raw.githubusercontent.com/Ramestta-Blockchain/launch/master/go-install.sh bash go-install.sh sudo ln -nfs ~/.go/bin/go /usr/bin/go ``` Docker and RabbitMQ to install on validator machines. ``` sudo apt-get update sudo apt install rabbitmq-server ``` To install sublime-text: ``` sudo snap install sublime-text --classic ``` #### Installing Heimdall: Heimdall is the proof-of-stake verifier layer responsible for checkpointing the representation of the Plasma blocks to the Ramestta mainnet. Clone the [Heimdall repository](https://github.com/Ramestta-Blockchain/heimdall):thumbsup: ``` git clone https://github.com/Ramestta-Blockchain/heimdall ``` ``` cd heimdall ``` ``` make build make install ``` ``` cd ~ source ~/.bashrc ``` Check the Heimdall installation: ``` heimdalld version --long ``` note Before proceeding, Heimdall should be installed on both the sentry and validator machines. #### Installing Bor Bor is the sidechain operator that acts as the block production layer, which syncs with Heimdall to select block producers and verifiers for each span and sprint. Clone the [Bor repository](https://github.com/Ramestta-Blockchain/bor):thumbsup: ``` git clone https://github.com/Ramestta-Blockchain/bor ``` ``` cd bor ``` **Install Bor:** ``` make bor-all ``` **Create symlinks:** ``` sudo ln -nfs ~/bor/build/bin/bor /usr/bin/bor sudo ln -nfs ~/bor/build/bin/bootnode /usr/bin/bootnode ``` **Check the Bor installation:** ``` bor version ``` note Before proceeding, Bor should be installed on both the sentry and validator machines. ### Setting Up Node Files: Node files need to be set up on both the sentry and validator machines. #### Fetching the launch repository Clone the[ launch repository](https://github.com/Ramestta-Blockchain/launch): ``` git clone https://github.com/Ramestta-Blockchain/launch ``` #### Setting up the launch directory **On the validator machine** Create a `node` directory: ``` mkdir -p node ``` Copy the files and scripts from the `launch` directory to the `node` directory: ``` cp -rf launch/testnet-v1/sentry/sentry/* ~/node cp launch/testnet-v1/sentry-service.sh ~/node ``` #### Setting up the network directories: **Setting up Heimdall** Change to the `node` directory: ``` cd ~/node/heimdall ``` Run the setup script: ``` bash setup.sh ``` **Setting up Bor** Change to the `node` directory: ``` cd ~/node/bor ``` Run the setup script: ``` bash setup.sh ``` ### show enode: ``` bootnode -nodekey ~/.bor/data/bor/nodekey -writeaddress ``` Run the setup script: ``` bash setup.sh ``` ### Setting Up the Services: Run this section both on the sentry and validator machines. Navigate to the `node` directory: ``` cd ~/node ``` Run the setup script: ``` bash sentry-service.sh ``` Copy the service file to the system directory: ``` sudo cp *.service /etc/systemd/system/ ``` #### Starting the Heimdall service You will now start the Heimdall service on the validator machine. Once the Heimdall service syncs, you will start the Bor service on the validator machine. **Start the Heimdall service:** ``` sudo service heimdalld start ``` **Start the Heimdall rest-server:** ``` sudo service heimdalld-rest-server start ``` **Check the Heimdall service logs:** ``` journalctl -u heimdalld.service -f ``` **Check the Heimdall rest-server logs:** ``` journalctl -u heimdalld-rest-server.service -f ``` **Check the sync status of Heimdall:** ``` curl localhost:26657/status ``` In the output, the `catching_up` value is: * `true` — the Heimdall service is syncing. * `false` — the Heimdall service is synced. Wait for the Heimdall service to fully sync. #### Starting the Bor service Once the Heimdall service on the validator machine syncs, start the Bor service on the validator machine. **Start the Bor service:** ``` sudo service bor start ``` **Check the Bor service logs:** ``` journalctl -u bor.service -f ``` ### Service to Auto Start After Server Crash/Reboot ``` sudo systemctl enable heimdalld sudo systemctl enable heimdalld-rest-server sudo systemctl enable bor ``` # Validator Node # Mainnet ## Run a Validator Node from Binaries: ### Prerequisites: `build-essential` installed on both the sentry and the validator machines. To install: ``` sudo apt-get install build-essential ``` Go 1.18 installed on validator machine. To install: ``` wget https://raw.githubusercontent.com/Ramestta-Blockchain/launch/master/go-install.sh bash go-install.sh sudo ln -nfs ~/.go/bin/go /usr/bin/go ``` Docker and RabbitMQ to install on validator machines. ``` sudo apt-get update sudo apt install rabbitmq-server ``` To install sublime-text: ``` sudo snap install sublime-text --classic ``` #### Installing Heimdall: Heimdall is the proof-of-stake verifier layer responsible for checkpointing the representation of the Plasma blocks to the Ramestta mainnet. Clone the [Heimdall repository](https://github.com/Ramestta-Blockchain/heimdall):thumbsup: ``` git clone https://github.com/Ramestta-Blockchain/heimdall ``` ``` cd heimdall ``` ``` make build make install ``` ``` cd ~ source ~/.bashrc ``` Check the Heimdall installation: ``` heimdalld version --long ``` note Before proceeding, Heimdall should be installed on both the sentry and validator machines. #### Installing Bor Bor is the sidechain operator that acts as the block production layer, which syncs with Heimdall to select block producers and verifiers for each span and sprint. Clone the [Bor repository](https://github.com/Ramestta-Blockchain/bor):thumbsup: ``` git clone https://github.com/Ramestta-Blockchain/bor ``` ``` cd bor ``` **Install Bor:** ``` make bor-all ``` **Create symlinks:** ``` sudo ln -nfs ~/bor/build/bin/bor /usr/bin/bor sudo ln -nfs ~/bor/build/bin/bootnode /usr/bin/bootnode ``` **Check the Bor installation:** ``` bor version ``` Change directory ``` cd ~ ``` Before proceeding, Bor should be installed on both the sentry and validator machines. ### Setting Up Node Files: Node files need to be set up on both the sentry and validator machines. #### Fetching the launch repository Clone the [launch repository](https://github.com/Ramestta-Blockchain/launch):thumbsup: ``` git clone https://github.com/Ramestta-Blockchain/launch ``` #### Setting up the launch directory **On the validator machine** Create a `node` directory: ``` mkdir -p node ``` Copy the files and scripts from the `launch` directory to the `node` directory: ``` cp -rf launch/mainnet-v1/sentry/validator/* ~/node cp launch/mainnet-v1/service.sh ~/node ``` #### Setting up the network directories: Run this section both on the sentry and validator machines. **Setting up Heimdall** Change to the `node` directory: ``` cd ~/node/heimdall ``` Run the setup script: ``` bash setup.sh ``` **Setting up Bor** Change to the `node` directory: ``` cd ~/node/bor ``` Run the setup script: ``` bash setup.sh ``` ### Setting Up the Services: Run this section both on the sentry and validator machines. **Navigate to the `node` directory:** ``` cd ~/node ``` **Run the setup script:** ``` bash service.sh ``` **Copy the service file to the system directory:** ``` sudo cp *.service /etc/systemd/system/ ``` ### Configuring the Validator Node ### Set the owner and signer key On Ramestta, you should keep the owner and signer keys different. Generate New wallet, and use its private key in next step as POLYGON`_PRIVATE_KEY` * Signer — the address that signs the checkpoint transactions. The recommendation is to keep at least 1 MATIC on the signer address. * Owner — the address that does the staking transactions. The recommendation is to keep the RAMA tokens on the owner address. #### Generating a Heimdall private key You must generate a Heimdall private key only on the validator machine. Do not generate a Heimdall private key on the sentry machine. To generate the private key, run: ``` heimdallcli generate-validatorkey POLYGON_PRIVATE_KEY[0x prefix] ``` where * POLYGON`_PRIVATE_KEY` — your Polygon wallet’s private key. This will generate `priv_validator_key.json`. Move the generated JSON file to the Heimdall configuration directory: ``` mv ./priv_validator_key.json ~/.heimdalld/config ``` #### Generating a Bor keystore file You must generate a Bor keystore file only on the validator machine. Do not generate a Bor keystore file on the sentry machine. To generate the private key, run: ``` heimdallcli generate-keystore POLYGON_PRIVATE_KEY[0x prefix] ``` where * POLYGON`_PRIVATE_KEY` — your Polygon wallet’s private key. When prompted, set up a password to the keystore file. This will generate a `UTC-