Why you should care about Neutaro

Neutaro is closely working with Timpi to help them create the first truly decentralized search engine! On Neutaro you can claim your rewards for contributing to Timpi and you can vote on different proposals affecting Timpi. These proposals will for example be about the ethical standpoint of the Timpi search engine.

Introduction

You can be a part of Neutaro by having tokens and delegating those, running a node or by becoming a validator.

Delegating

By delegating your tokens to a validator you increase the amount of staked tokens they have and by that their voting power. In return you get a cut of their rewards based on the amount you have delegated. You can delegate to a Validator using the command. 1.000.000 uneutaro is 1 NTMPI. if you want to stake 100 NTMPI tokens you put 100000000uneutaro into the command. The example is 1 token.

Neutaro tx staking delegate ValidatorAddress 1000000uneutaro --from YOURWALLET --chain-id Neutaro-1

Running a node

Running a node means that you run the chains binary. Follow these steps to create a Validator that runs as a service on linux.

Preperation

We suggest using Ubuntu 22.04.03, 4 cores, 8gb RAM and 100gb of free storage. The storage will increase overtime, but with the suggested pruning and current state of the chain it's fine and it will be fine for a few more months.

Make sure your system is up to date.

sudo apt update && sudo apt upgrade -y && sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc git jq chrony liblz4-tool -y

Installing Go v1.22.2

ver="1.22.2"
cd $HOME
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz"
rm "go$ver.linux-amd64.tar.gz"
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile

Make sure version 1.22.2 is installed (if not, the make command will stop you):

go version

Installing the Neutaro Binary

cd $HOME
git clone https://github.com/Neutaro/Neutaro
cd Neutaro
make build

Installing cosmovisor

mkdir -p $HOME/.Neutaro/cosmovisor/genesis/bin
mv $HOME/Neutaro/build/Neutaro $HOME/.Neutaro/cosmovisor/genesis/bin/
sudo ln -s $HOME/.Neutaro/cosmovisor/genesis $HOME/.Neutaro/cosmovisor/current
sudo ln -s $HOME/.Neutaro/cosmovisor/current/bin/Neutaro /usr/local/bin/Neutaro
cd $HOME/Neutaro/
go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]

Now we configure the node

Make sure to replace "YOURMONIKER" with your actual one.

MONIKER=YOURMONIKER

Neutaro init $MONIKER --chain-id Neutaro-1
Neutaro config chain-id Neutaro-1
Neutaro config keyring-backend os
curl http://154.26.153.186/genesis.json > $HOME/.Neutaro/config/genesis.json

Editing the app.toml file

You can edit the file $HOME/.Neutaro/config/app.toml to change the minimum-gas-prices ( Currently most use 0 ) and the pruning.
minimum-gas-prices = "0uneutaro"

For pruning you could add whatever you like. These options mainly decide how much storage the Node will use. An example would be using
pruning="custom"
pruning-keep-recent="100"
pruning-interval="19"

Configuring the config.toml

The file is in $HOME/.Neutaro/config/config.toml. Here you edit the "seeds" to seeds = "[email protected]:26656".

Downloading the snapshot

cd $HOME/.Neutaro/
mv data data-old
mv wasm wasm-old
wget http://poker.neutaro.tech/snapshot2.tar.lz4
lz4 -d snapshot2.tar.lz4
tar -xf snapshot2.tar

Once the node is running you can delete unnecessary files using

rm -r snapshot2.tar
rm -r snapshot2.tar.lz4
rm -r data-old

Create Neutaro service.

sudo tee /etc/systemd/system/Neutaro.service > /dev/null << EOF
[Unit]
Description=Neutaro Node Service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.Neutaro"
Environment="DAEMON_NAME=Neutaro"
Environment="UNSAFE_SKIP_BACKUP=true"

[Install]
WantedBy=multi-user.target
EOF

Enabling the Service

sudo systemctl daemon-reload

sudo systemctl enable Neutaro

Starting the Service/ the Node

sudo systemctl restart Neutaro

To view the service use

sudo journalctl -fu Neutaro -o cat

use ctrl + c to exit the log

Check the sync status

Neutaro status 2>&1 | jq .SyncInfo

Proceed once it's synced

you will be asked for your memonic on this step. You can also remove the --recover flag and create a new wallet and send funds to this new wallet from your main wallet. You can now delete the files using the commands from the snapshot section.

Neutaro keys add WALLET --keyring-backend os --recover

Sending the becomming a validator transaction

once you have a funded wallet on the node send this, but make sure to check all the parameters to see if they are fine for you!

Neutaro tx staking create-validator --amount=1000000uneutaro --pubkey=$(Neutaro tendermint show-validator) --moniker=$MONIKER --chain-id=Neutaro-1 --from WALLET --keyring-backend os --commission-rate="0.10" --commission-max-rate="0.20" --commission-max-change-rate="0.01" --min-self-delegation="1000000" --gas="auto" --gas-prices="0.0025uneutaro" --gas-adjustment="1.5"

Preparing for an upgrade

When there is a planned upgrade that has passed through governance there will be a certain height where the upgrade is supposed to happen.

To find out approximately when the height will be reached, change the end of the URL here with the actual block height from the proposal: https://nms1.neutaro.tech/Neutaro/block/100000000 (make sure to check this when the time is approaching as the block time is not constant and the time might shift quite a bit).

At that height, the blockchain will automatically stop and requires a new binary with the correct upgrade programmed in.

It is always advised to be present during an upgrade as it sometimes fails and needs coordinated efforts to get back up again.

If you are not able to be present you can prepare the new binary for Cosmovisor so that it automatically switches out the new binary when the time comes.

Make sure you have the correct version of Neutaro repo: git checkout LATEST_TAG (the exact tag to check out will be given to you as part of the upgrade information, most likely it will be something like git checkout v2.0.0. See the latest tag in GitHub.)
Build a new version of the binary: make build
Create an upgrade folder for Cosmovisor: mkdir -p $HOME/.Neutaro/cosmovisor/upgrade/v2/bin (the upgrade name must match the upgrade name set in the governance proposal)
Copy the new binary into the new folder: cp build/Neutaro $HOME/.Neutaro/cosmovisor/upgrade/v2/bin
Make sure the binary is correct by running $HOME/.Neutaro/cosmovisor/upgrade/v2/bin/Neutaro version (it should output the )

If you are not running Cosmovisor

The process for upgrading without Cosmovisor is very simple, you just need to wait for the halt height to happen and then stop the node, switch out the old binary with the new one and restart the service.

Development

To get started you mostly need go installed (see the part about install go in the validator guide if you are unsure)

Other than that you will use make commands for most of the work you need to do.

Build

$ make build

Serve locally

There is a simple script that spins up Neutaro locally, so you can test and interact with it directly. See scripts/serve_env.sh for details on wallets that are set up during the serve command.

To serve:

$ make serve

To kill it, you can run:

$ make kill-all

Test

There are not many (any?) tests in the regular code because currently there are no custom modules. If you add any, the following command will run them:

$ make test

Instead there are e2e tests under the interchaintest which you can read more about there, but also run all of them (they are slow):

$ make interchaintest

Linting and formatting

Before committing new code, make sure to run the linters and formatters first:

$ make lint
$ make format

# Packages

# README