humans

Humans Node Setup for Testnet — testnet-1

Official documentation:

Validator setup instructions

Explorer:

https://explorer.humans.zone/humans-testnet

Hardware Requirements

Minimal Hardware Requirements

Memory: 8 GB RAM
CPU: Quad-Core
Disk: 250 GB SSD Storage
Bandwidth: 1 Gbps for Download / 100 Mbps for Upload

Set up your Humans node

Manual installation

Update packages and Install dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc -y

Replace your moniker <YOUR_MONIKER> without <>, save and import variables into system

HUMANS_PORT=17
echo "export HUMANS_WALLET="wallet"" >> $HOME/.bash_profile
echo "export HUMANS_MONIKER="<YOUR_MONIKER>"" >> $HOME/.bash_profile
echo "export HUMANS_CHAIN_ID="testnet-1"" >> $HOME/.bash_profile
echo "export HUMANS_PORT="${HUMANS_PORT}"" >> $HOME/.bash_profile
source $HOME/.bash_profile

install go

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

Download and build binaries

cd $HOME
rm -rf ~/humans
git clone https://github.com/humansdotai/humans
cd humans
git checkout v1.0.0
go build -o humansd cmd/humansd/main.go
mv humansd ~/go/bin/humansd

Config and init app

humansd config node tcp://localhost:${HUMANS_PORT}657
humansd config chain-id $HUMANS_CHAIN_ID
humansd config keyring-backend test
humansd init $HUMANS_MONIKER --chain-id $HUMANS_CHAIN_ID

Download genesis and addrbook

curl -s https://rpc-testnet.humans.zone/genesis | jq -r .result.genesis > $HOME/.humans/config/genesis.json

Set seeds and peers

SEEDS=""
PEERS="[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656"
sed -i -e "s/^seeds *=.*/seeds = \"$SEEDS\"/; s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.humans/config/config.toml

Set gustom ports in app.toml file

sed -i.bak -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${HUMANS_PORT}317\"%;
s%^address = \":8080\"%address = \":${HUMANS_PORT}080\"%;
s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${HUMANS_PORT}090\"%; 
s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${HUMANS_PORT}091\"%; 
s%^address = \"0.0.0.0:8545\"%address = \"0.0.0.0:${HUMANS_PORT}545\"%; 
s%^ws-address = \"0.0.0.0:8546\"%ws-address = \"0.0.0.0:${HUMANS_PORT}546\"%" $HOME/.humans/config/app.toml

Set gustom ports in config.toml file

sed -i.bak -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${HUMANS_PORT}658\"%; 
s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://0.0.0.0:${HUMANS_PORT}657\"%; 
s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${HUMANS_PORT}060\"%;
s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${HUMANS_PORT}656\"%;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${HUMANS_PORT}656\"%;
s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${HUMANS_PORT}660\"%" $HOME/.humans/config/config.toml

Config pruning

sed -i -e "s/^pruning *=.*/pruning = \"nothing\"/" $HOME/.humans/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.humans/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"50\"/" $HOME/.humans/config/app.toml

Set minimum gas price, enable prometheus and disable indexing

sed -i 's/minimum-gas-prices =.*/minimum-gas-prices = "0.025uheart"/g' $HOME/.humans/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.humans/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.humans/config/config.toml

Update block time parameters

CONFIG_TOML="$HOME/.humans/config/config.toml"
 sed -i 's/timeout_propose =.*/timeout_propose = "100ms"/g' $CONFIG_TOML
 sed -i 's/timeout_propose_delta =.*/timeout_propose_delta = "500ms"/g' $CONFIG_TOML
 sed -i 's/timeout_prevote =.*/timeout_prevote = "100ms"/g' $CONFIG_TOML
 sed -i 's/timeout_prevote_delta =.*/timeout_prevote_delta = "500ms"/g' $CONFIG_TOML
 sed -i 's/timeout_precommit =.*/timeout_precommit = "100ms"/g' $CONFIG_TOML
 sed -i 's/timeout_precommit_delta =.*/timeout_precommit_delta = "500ms"/g' $CONFIG_TOML
 sed -i 's/timeout_commit =.*/timeout_commit = "1s"/g' $CONFIG_TOML
 sed -i 's/skip_timeout_commit =.*/skip_timeout_commit = false/g' $CONFIG_TOML

Clean old data

humansd tendermint unsafe-reset-all --home $HOME/.humans --keep-addr-book

Create Service file

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

[Service]
User=$USER
ExecStart=$(which humansd) start --home $HOME/.humans
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Enable and start service

sudo systemctl daemon-reload
sudo systemctl enable humansd
sudo systemctl restart humansd && sudo journalctl -u humansd -f

(OPTIONAL) State Sync

In order not to wait for a long synchronization, you can use our StateSync guide:

https://github.com/itrocket-team/testnet_guides/blob/main/humans/statesync.md

Create wallet

To create a new wallet, use the following command. don’t forget to save the mnemonic

humansd keys add $HUMANS_WALLET

(optional) To restore exexuting wallet, use the following command

humansd keys add $HUMANS_WALLET --recover

Save wallet and validator address

HUMANS_WALLET_ADDRESS=$(humansd keys show $HUMANS_WALLET -a)
HUMANS_VALOPER_ADDRESS=$(humansd keys show $HUMANS_WALLET --bech val -a)
echo "export HUMANS_WALLET_ADDRESS="${HUMANS_WALLET_ADDRESS} >> $HOME/.bash_profile
echo "export HUMANS_VALOPER_ADDRESS="${HUMANS_VALOPER_ADDRESS} >> $HOME/.bash_profile
source $HOME/.bash_profile

Fund your wallet Before creating a validator, you need to fund your wallet, go to the Humans discord server and and navigate to testnet-faucet channel

$request <YOUR_WALLET_ADDRESS>

Create validator

before creating a validator, you need to check the balance and make sure that the node is synched

Check Sync status, once your node is fully synced, the output from above will say false

humansd status 2>&1 | jq .SyncInfo

Check your balance

humansd query bank balances $HUMANS_WALLET_ADDRESS

Create validator

humansd tx staking create-validator \
  --amount 9000000uheart \
  --from $HUMANS_WALLET \
  --commission-max-change-rate "0.01" \
  --commission-max-rate "0.2" \
  --commission-rate "0.05" \
  --min-self-delegation "1" \
  --pubkey  $(humansd tendermint show-validator) \
  --moniker $HUMANS_MONIKER \
  --chain-id $HUMANS_CHAIN_ID \
  --fees 5000uheart \
  -y

You can add --website --security-contact --identity --details flags in it needed

--website <YOUR_SITE_URL> \
--security-contact <YOUR_CONTACT> \
--identity <KEYBASE_IDENTITY> \
--details <YOUR_VALIDATOR_DETAILS>

Monitoring

If you want to have set up a monitoring and alert system use our cosmos nodes monitoring guide with tenderduty

Security

To protect you keys please don`t share your privkey, mnemonic and follow a basic security rules

Set up ssh keys for authentication

You can use this guide to configure ssh authentication and disable password authentication on your server

Firewall security

Set the default to allow outgoing connections, deny all incoming, allow ssh and node p2p port

sudo ufw default allow outgoing 
sudo ufw default deny incoming 
sudo ufw allow ssh/tcp 
sudo ufw allow ${HUMANS_PORT}656/tcp
sudo ufw enable

Usefull commands

Service commands

check logs

sudo journalctl -u humansd -f

restart service

sudo systemctl restart humansd

Wallet operation

check balance

humansd query bank balances $HUMANS_WALLET_ADDRESS

transfer funds

humansd tx bank send $HUMANS_WALLET_ADDRESS <TO_HUMANS_WALLET_ADDRESS> 1000000uheart --gas auto --gas-adjustment 1.3

lists of wallets

humansd keys list

delete wallet

humansd keys delete $HUMANS_WALLET

Node information

synch info

humansd status 2>&1 | jq .SyncInfo

node status && node info && validator info

curl -s localhost:${HUMANS_PORT}657/status && humansd status 2>&1 | jq .NodeInfo && humansd status 2>&1 | jq .ValidatorInfo

your node peers

echo $(humansd tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.humans/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')

get currently conected peers lis

curl -sS http://localhost:${HUMANS_PORT}657/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'

Voting

humansd tx gov vote 1 yes --from $HUMANS_WALLET --chain-id $HUMANS_CHAIN_ID

Staking, Delegation and Rewards

Withdraw all rewards

humansd tx distribution withdraw-all-rewards --from $HUMANS_WALLET --chain-id $HUMANS_CHAIN_ID --gas auto --gas-adjustment 1.3

Withdraw rewards with commision

humansd tx distribution withdraw-rewards $HUMANS_VALOPER_ADDRESS --from $HUMANS_WALLET --commission --chain-id $HUMANS_CHAIN_ID --gas auto --gas-adjustment 1.3

Check balance

humansd query bank balances $HUMANS_WALLET_ADDRESS

Delegate stake

humansd tx staking delegate $HUMANS_VALOPER_ADDRESS 1000000uheart --from $HUMANS_WALLET --chain-id $HUMANS_CHAIN_ID --gas=auto --gas-adjustment 1.3

Redelegate stake to another validator

humansd tx staking redelegate <srcValidatorAddress> <destValidatorAddress> 1000000uheart --from $HUMANS_WALLET --chain-id $HUMANS_CHAIN_ID --gas auto --gas-adjustment 1.3

Validator operation

Edit validator

humansd tx staking edit-validator \
  --moniker=$NODENAME \
  --identity=<your_keybase_id> \
  --website="<your_website>" \
  --details="<your_validator_description>" \
  --chain-id=$HUMANS_CHAIN_ID \
  --from=$HUMANS_WALLET

Jailing info

humansd q slashing signing-info $(humansd tendermint show-validator)

Unjail validator

humansd tx slashing unjail --broadcast-mode=block --from $HUMANS_WALLET --chain-id $HUMANS_CHAIN_ID --gas auto --gas-adjustment 1.5

Consensus state

curl localhost:${HUMANS_PORT}657/consensus_state

Delete node

sudo systemctl stop humansd
sudo systemctl disable humansd
sudo rm -rf /etc/systemd/system/humansd*
sudo rm $(which humansd)
sudo rm -rf $HOME/.humans
sudo rm -fr $HOME/humans
sed -i "/HUMANS_/d" $HOME/.bash_profile

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Uh oh!

Repository files navigation

humans

Humans Node Setup for Testnet — testnet-1

Hardware Requirements

Minimal Hardware Requirements

Set up your Humans node

Manual installation

(OPTIONAL) State Sync

Create wallet

Create validator

Monitoring

Security

Set up ssh keys for authentication

Firewall security

Usefull commands

Service commands

Wallet operation

Node information

Voting

Staking, Delegation and Rewards

Validator operation

Delete node

About

Uh oh!

Releases

Packages

Uh oh!

Uh oh!

Irgirival/humans

Folders and files

Latest commit

History

Repository files navigation

humans

Humans Node Setup for Testnet — testnet-1

Hardware Requirements

Minimal Hardware Requirements

Set up your Humans node

Manual installation

(OPTIONAL) State Sync

Create wallet

Create validator

Monitoring

Security

Set up ssh keys for authentication

Firewall security

Usefull commands

Service commands

Wallet operation

Node information

Voting

Staking, Delegation and Rewards

Validator operation

Delete node

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Packages