-
UNUNIFI
Chain Explorer:
Nodeist Explorer
Cosmos explorer based on Ping Pub supported by Nodeist - is the best solution!exp.nodeist.net
Public Endpoints:
Bash:# API ENDPOINT https://api-ununifi.nodeist.net # RPC ENDPOINT https://rpc-ununifi.nodeist.net # GRPC ENDPOINT https://grpc-ununifi.nodeist.net
Peering:
addrbook:
Bash:curl -Ls https://ss.nodeist.net/ununifi/addrbook.json > $HOME/.ununifi/config/addrbook.json
live-peers:
Bash:peers="[email protected]:26676,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,796c62bb2af411c140cf24ddc409dff76d9d61cf@[2600:1f1c:534:8f02:ca0e:14e9:8e60:989e]:26656,[email protected]:23256" sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"$peers\"|" $HOME/.ununifi/config/config.toml
-
Manual Installation
This section contains a list of commands to install the node in manual mode.
Server Preparation
Bash:apt update && apt upgrade -y apt install curl iptables build-essential git wget jq make gcc nano tmux htop nvme-cli pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev -y
Install GO
Bash:ver="1.20.3" 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
Node Installation
ReplaceNodeist_Guide
in the first line with your moniker name.
Bash:NODE_MONIKER="Nodeist_Guide" cd || return rm -rf ununifi git clone https://github.com/UnUniFi/chain ununifi cd ununifi || return git checkout v3.1.0 make install ununifid version ununifid config chain-id ununifi-beta-v1 ununifid init "$NODE_MONIKER" --chain-id ununifi-beta-v1 curl -s https://ss.nodeist.net/ununifi/genesis.json > $HOME/.ununifi/config/genesis.json curl -s https://ss.nodeist.net/ununifi/addrbook.json > $HOME/.ununifi/config/addrbook.json SEEDS="" PEERS="" sed -i 's|^seeds *=.*|seeds = "'$SEEDS'"|; s|^persistent_peers *=.*|persistent_peers = "'$PEERS'"|' $HOME/.ununifi/config/config.toml sed -i 's|^pruning *=.*|pruning = "custom"|g' $HOME/.ununifi/config/app.toml sed -i 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|g' $HOME/.ununifi/config/app.toml sed -i 's|^pruning-interval *=.*|pruning-interval = "10"|g' $HOME/.ununifi/config/app.toml sed -i 's|^snapshot-interval *=.*|snapshot-interval = 0|g' $HOME/.ununifi/config/app.toml sed -i 's|^minimum-gas-prices *=.*|minimum-gas-prices = "0.025uguu"|g' $HOME/.ununifi/config/app.toml sed -i 's|^prometheus *=.*|prometheus = true|' $HOME/.ununifi/config/config.toml sudo tee /etc/systemd/system/ununifid.service > /dev/null << EOF [Unit] Description=Ununifi Node After=network-online.target [Service] User=$USER ExecStart=$(which ununifid) start Restart=on-failure RestartSec=10 LimitNOFILE=10000 [Install] WantedBy=multi-user.target EOF ununifid tendermint unsafe-reset-all --home $HOME/.ununifi --keep-addr-book curl -L https://ss.nodeist.net/ununifi/snapshot_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.ununifi --strip-components 2 sudo systemctl daemon-reload sudo systemctl enable ununifid sudo systemctl start ununifid sudo journalctl -fu ununifid -o cat
-
HEIGHT SIZE TIMESTAMP DOWNLOAD
Instructions
Stop the service and reset the data
Bash:sudo systemctl stop ununifid cp $HOME/.ununifi/data/priv_validator_state.json $HOME/.ununifi/priv_validator_state.json.backup rm -rf $HOME/.ununifi/data
Download latest snapshot
Bash:curl -L https://ss.nodeist.net/ununifi/snapshot_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.ununifi --strip-components 2 mv $HOME/.ununifi/priv_validator_state.json.backup $HOME/.ununifi/data/priv_validator_state.json
Restart the service and check the log
Bash:sudo systemctl restart ununifid && sudo journalctl -fu ununifid -o cat
-
Instructions
Stop the service and reset the data
Bash:sudo systemctl stop ununifid cp $HOME/.ununifi/data/priv_validator_state.json $HOME/.ununifi/priv_validator_state.json.backup ununifid tendermint unsafe-reset-all --home $HOME/.ununifi
Get and configure the state sync information
Bash:SNAP_RPC="https://rpc-ununifi.nodeist.net:443" LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \ BLOCK_HEIGHT=$((LATEST_HEIGHT - 2000)); \ TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash) sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \ s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \ s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \ s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"|" $HOME/.ununifi/config/config.toml mv $HOME/.ununifi/priv_validator_state.json.backup $HOME/.ununifi/data/priv_validator_state.json
Restart the service and check the log
Bash:sudo systemctl restart ununifid && sudo journalctl -fu ununifid -o cat
-
🔑 Key management
Add new key
Bash:ununifid keys add wallet
Recover existing key
Bash:ununifid keys add wallet --recover
List all keys
Bash:ununifid keys list
Delete key
Bash:ununifid keys delete wallet
Export key to the file
Bash:ununifid keys export wallet
Import key from the file
Bash:ununifid keys import wallet wallet.backup
Query wallet balance
Bash:ununifid q bank balances $(ununifid keys show wallet -a)
👷 Validator management
- Please make sure you have adjusted moniker, identity, details and website to match your values.
Create new validator
Bash:ununifid tx staking create-validator \ --amount 1000000uguu \ --pubkey $(ununifid tendermint show-validator) \ --moniker "YOUR_MONIKER_NAME" \ --identity "YOUR_KEYBASE_ID" \ --details "YOUR_DETAILS" \ --website "YOUR_WEBSITE_URL" \ --chain-id ununifi-beta-v1 \ --commission-rate 0.05 \ --commission-max-rate 0.20 \ --commission-max-change-rate 0.01 \ --min-self-delegation 1 \ --from wallet \ --gas-adjustment 1.4 \ --gas auto \ --gas-prices 0.025uguu \ -y
Edit existing validator
Bash:ununifid tx staking edit-validator \ --new-moniker "YOUR_MONIKER_NAME" \ --identity "YOUR_KEYBASE_ID" \ --details "YOUR_DETAILS" \ --website "YOUR_WEBSITE_URL" \ --chain-id ununifi-beta-v1 \ --commission-rate 0.05 \ --from wallet \ --gas-adjustment 1.4 \ --gas auto \ --gas-prices 0.025uguu \ -y
Unjail validator
Bash:ununifid tx slashing unjail --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Jail reason
Bash:ununifid query slashing signing-info $(ununifid tendermint show-validator)
List all active validators
Bash:ununifid q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
List all inactive validators
Bash:ununifid q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
View validator details
Bash:ununifid q staking validator $(ununifid keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
Bash:ununifid tx distribution withdraw-all-rewards --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Withdraw commission and rewards from your validator
Bash:ununifid tx distribution withdraw-rewards $(ununifid keys show wallet --bech val -a) --commission --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Delegate tokens to yourself
Bash:ununifid tx staking delegate $(ununifid keys show wallet --bech val -a) 1000000uguu --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Delegate tokens to validator
Bash:ununifid tx staking delegate <TO_VALOPER_ADDRESS> 1000000uguu --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Redelegate tokens to another validator
Bash:ununifid tx staking redelegate $(ununifid keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000uguu --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Unbond tokens from your validator
Bash:ununifid tx staking unbond $(ununifid keys show wallet --bech val -a) 1000000uguu --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Send tokens to the wallet
Bash:ununifid tx bank send wallet <TO_WALLET_ADDRESS> 1000000uguu --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
🗳 Governance
List all proposals
Bash:ununifid query gov proposals
View proposal by id
Bash:ununifid query gov proposal 1
Vote 'Yes'
Bash:ununifid tx gov vote 1 yes --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Vote 'No'
Bash:ununifid tx gov vote 1 no --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Vote 'Abstain'
Bash:ununifid tx gov vote 1 abstain --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Vote 'NoWithVeto'
Bash:ununifid tx gov vote 1 NoWithVeto --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
⚡️ Utility
Update Indexer
Bash:sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.ununifi/config/config.toml
Update pruning
Bash:sed -i \ -e 's|^pruning *=.*|pruning = "custom"|' \ -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \ -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \ -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \ $HOME/.ununifi/config/app.toml
🚨 Maintenance
Get validator info
Bash:ununifid status 2>&1 | jq .ValidatorInfo
Get sync info
Bash:ununifid status 2>&1 | jq .SyncInfo
Get node peer
Bash:echo $(ununifid tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.ununifi/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
Bash:[[ $(ununifid q staking validator $(ununifid keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(ununifid status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\n\e[1m\e[32mTrue\e[0m\n" || echo -e "\n\e[1m\e[31mFalse\e[0m\n"
Get live peers
Bash:curl -sS http://localhost:27657/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Set minimum gas price
Bash:sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.025uguu\"/" $HOME/.ununifi/config/app.toml
Enable prometheus
Bash:sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.ununifi/config/config.toml
Reset chain data
Bash:ununifid tendermint unsafe-reset-all --home $HOME/.ununifi --keep-addr-book
Remove node
- Please, before proceeding with the next step! All chain data will be lost! Make sure you have backed up your priv_validator_key.json!
Bash:cd $HOME sudo systemctl stop ununifid sudo systemctl disable ununifid sudo rm /etc/systemd/system/ununifid.service sudo systemctl daemon-reload rm -f $(which ununifid) rm -rf $HOME/.ununifi rm -rf $HOME/ununifi
⚙️ Service Management
Reload service configuration
Bash:sudo systemctl daemon-reload
Enable service
Bash:sudo systemctl enable ununifid
Disable service
Bash:sudo systemctl disable ununifid
Start service
Bash:sudo systemctl start ununifid
Stop service
Bash:sudo systemctl stop ununifid
Restart service
Bash:sudo systemctl restart ununifid
Check service status
Bash:sudo systemctl status ununifid
Check service logs
Bash:sudo journalctl -u ununifid -f --no-hostname -o cat
Last edited: