Gravity: Installing and working with a node

Main
Knowledge base
Gravity: Installing and working with a node

07.10.2024, 14:09

Description:

Gravity is a Tier 1 blockchain designed for mass adoption and the future of omnichannel. Its approach abstracts away the technical complexities of multi-chain interactions by integrating advanced technologies such as zero-knowledge proofs, state-of-the-art consensus mechanisms, and restyled-based architecture to deliver high performance, enhanced security, and cost-effectiveness. Gravity serves the 20 million users of the Galxe ecosystem, ensuring a seamless and engaging experience on Web3's largest onchain distribution network.

Minimum System Requirements:

Node type: Mainnet

CPU: 8

RAM: 16GB

Storage: 250GB

Node Setup:

1) Auto-installation

wget -O gravitym https://raw.githubusercontent.com/111STAVR111/props/main/Gravity/gravitym && chmod +x gravitym && ./gravitym

2) Manual installation

Server preparation

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 1.21.6

ver="1.21.6"
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
go version

Version 01.10.24.

cd $HOME && mkdir -p go/bin/
mkdir gravity-bin && cd gravity-bin
wget -O gravity https://github.com/Gravity-Bridge/Gravity-Bridge/releases/download/v1.12.0/gravity-linux-amd64
mv gravity-linux-amd64 gravity
wget https://github.com/Gravity-Bridge/Gravity-Bridge/releases/download/v1.12.0/gbt
chmod +x *
mv $HOME/gravity /usr/bin/
mv $HOME/gbt /usr/bin/

Installation

gravity init STAVR_guide --chain-id gravity-bridge-3
gravity config chain-id gravity-bridge-3
gbt init

Creating a wallet

gravity keys add <wallet_name> --algo secp256k1 --coin-type 118
gravity keys add <wallet_orchestrator_name>
gravity eth_keys add <wallet_eth_name>

A set of keys for the orchestrator

gbt keys set-ethereum-key --key <your Ethereum PRIVATE key>
gbt keys set-orchestrator-key --phrase "<your mnemonic from orchestrator wallet>"

Genesis Installation

wget -O $HOME/.gravity/config/genesis.json "https://raw.githubusercontent.com/111STAVR111/props/main/Gravity/genesis.json"

Setting the Minimum Gas Price and Peers/Seeds

sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.001ugraviton\"/;" ~/.gravity/config/app.toml
external_address=$(wget -qO- eth0.me)
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.gravity/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.gravity/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.gravity/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.gravity/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 50/g' $HOME/.gravity/config/config.toml

Pruning (optional)

pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="10"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.gravity/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.gravity/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.gravity/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.gravity/config/app.toml

Indexer (optional)

indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.gravity/config/config.toml

Installing addrbook

wget -O $HOME/.gravity/config/addrbook.json "https://raw.githubusercontent.com/111STAVR111/props/main/Gravity/addrbook.json"

Creating a service file

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

[Service]
User=$USER
ExecStart=$(which gravity) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Launch

sudo systemctl daemon-reload
sudo systemctl enable gravity
sudo systemctl restart gravity && sudo journalctl -fu gravity -o cat

Create an Orchestrator service file

sudo tee /etc/systemd/system/orchestrator.service > /dev/null <<EOF
[Unit]
Description=Gravity Bridge Orchestrator
Requires=network.target
[Service]
Type=simple
TimeoutStartSec=10s
Restart=on-failure
RestartSec=10
ExecStart=$(which gbt) orchestrator \
--fees 5000ugraviton \
--gravity-contract-address 0xa4108aA1Ec4967F8b52220a4f7e94A8201F2D906 \
--ethereum-rpc "https://eth.althea.net/"
[Install]
WantedBy=default.target
EOF

Load the service and run

sudo systemctl daemon-reload && sudo systemctl enable orchestrator
sudo systemctl restart orchestrator && journalctl -fu orchestrator -o cat

Creating a validator

gravity tx staking create-validator \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.2 \
--min-self-delegation "1" \
--amount 1000000000000000000ugraviton \
--pubkey $(gravity tendermint show-validator) \
--from <wallet> \
--moniker="STAVR_guide" \
--chain-id gravity-bridge-3 \
--fees="500ugraviton" \
--identity="" \
--website="" \
--details="" -y

Deleting a node

sudo systemctl stop gravity
sudo systemctl disable gravity
rm /etc/systemd/system/gravity.service
sudo systemctl daemon-reload
cd $HOME
rm -rf gravity-bin
rm -rf .gravity
rm -rf $(which gravity)

Useful commands

Information

gravity status 2>&1 | jq .NodeInfo
gravity status 2>&1 | jq .SyncInfo
gravity status 2>&1 | jq .ValidatorInfo

Checking node logs

sudo journalctl -fu gravity -o cat

Check service status

sudo systemctl status gravity

Service restart

sudo systemctl restart gravity

Service stop

sudo systemctl stop gravity

Service Launch

sudo systemctl start gravity

Reload/disable/enable

sudo systemctl daemon-reload
sudo systemctl disable gravity
sudo systemctl enable gravity

Your Peer

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

Working with keys

New key or Restore key

gravity keys add Wallet_Name --algo secp256k1 --coin-type 118
OR
gravity keys add Wallet_Name --recover --algo secp256k1 --coin-type 118

Checking all keys

gravity keys list

Balance check

gravity query bank balances addressjkl1yjgn7z09ua9vms259j

Key delete

gravity keys delete Wallet_Name

Key export

gravity keys export wallet

Importing a key

gravity keys import wallet wallet.backup

Working with Validator

Editing the Validator

gravity tx staking edit-validator \
--new-moniker "Your_Moniker" \
--identity "Keybase_ID" \
--details "Your_Description" \
--website "Your_Website" \
--security-contact "Your_Email" \
--chain-id gravity-bridge-3 \
--commission-rate 0.05 \
--from Wallet_Name \
--gas 350000 -y

Your Valope address

gravity keys show Wallet_Name --bech val

Your Valcon address

gravity tendermint show-address

Information about your validator

gravity query staking validator valoperaddress......

Information about Jail

gravity query slashing signing-info $(gravity tendermint show-validator)

Unjail

gravity tx slashing unjail --from Wallet_name --chain-id gravity-bridge-3 --gas 350000 -y

List of active validators

List of inactive validators

Checking keys against the validator (Win - good. Lose - bad)

VALOPER=Enter_Your_valoper_Here
[[ $(gravity q staking validator $VALOPER -oj | jq -r .consensus_pubkey.key) = $(gravity status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\nYou win\n" || echo -e "\nYou lose\n"

Output all rewards from all validators

gravity tx distribution withdraw-all-rewards --from Wallet_Name --chain-id gravity-bridge-3 --gas 350000 -y

Withdrawal of funds and commission from your Validator

gravity tx distribution withdraw-rewards valoper1amx.......g85v07t9ka2tfuhamhldgf8e --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 --commission -y

Delegate tokens to your validator

gravity tx staking delegate Your_valpoer........ "100000000"ugraviton --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y

Delegate tokens to another validator

gravity tx staking delegate valpoer........ "100000000"ugraviton --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y

Decouple tokens from your validator or another validator

gravity tx staking unbond Your_valpoer........ "100000000"ugraviton l1 --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y
gravity tx staking unbond valpoer........ "100000000"ugraviton --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y

Transfer tokens from wallet to wallet

gravity tx bank send Your_address............ address........... "1000000000000000000"ugraviton --gas 350000 --chain-id=gravity-bridge-3 -y

Management

View all proposal

gravity query gov proposals

View a specific proposal

gravity query gov proposal 1

Vote "yes."

gravity tx gov vote 1 yes --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y

Vote "no."

gravity tx gov vote 1 no --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y

Abstain

gravity tx gov vote 1 abstain --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y

Vote no with a veto

gravity tx gov vote 1 no_with_veto --from Wallet_Name --gas 350000 --chain-id=gravity-bridge-3 -y

IBC transfer

gravity tx ibc-transfer transfer transfer channel-2 Your_OSMOaddress............ "100000"ugraviton --from Your_Gravity_Wallet_Name ---gas 350000 --fees "7000"ugraviton --chain-id=gravity-bridge-3 -y