fa-info-circle Info
UNUNIFI
NFT-Fi Platform with DeFi tools built on Cosmos
Chain Explorer:
https://exp.nodeist.net/Ununifi
Public Endpoints:
# API ENDPOINT
https://api-ununifi.nodeist.net
# RPC ENDPOINT
https://rpc-ununifi.nodeist.net
# GRPC ENDPOINT
https://grpc-ununifi.nodeist.net
Peering:
addrbook:
curl -Ls https://ss.nodeist.net/ununifi/addrbook.json > $HOME/.ununifi/config/addrbook.json
live-peers:
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
fa-spinner fa-spin Install
Manual Installation
This section contains a list of commands to install the node in manual mode.
Server Preparation
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
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
Replace Nodeist_Guide in the first line with your moniker name.
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
fa-camera-alt Snapshot
ununifi
Instructions
Stop the service and reset the data
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
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
sudo systemctl restart ununifid && sudo journalctl -fu ununifid -o cat
fa-sync fa-spin State Sync
Instructions
Stop the service and reset the data
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
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
sudo systemctl restart ununifid && sudo journalctl -fu ununifid -o cat
fa-terminal CLI Cheatsheets
🔑 Key management
Add new key
ununifid keys add wallet
Recover existing key
ununifid keys add wallet --recover
List all keys
ununifid keys list
Delete key
ununifid keys delete wallet
Export key to the file
ununifid keys export wallet
Import key from the file
ununifid keys import wallet wallet.backup
Query wallet balance
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
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
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
ununifid tx slashing unjail --from wallet --chain-id ununifi-beta-v1 --gas-adjustment 1.4 --gas auto --gas-prices 0.025uguu -y
Jail reason
ununifid query slashing signing-info $(ununifid tendermint show-validator)
List all active validators
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
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
ununifid q staking validator $(ununifid keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
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
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
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
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
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
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
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
ununifid query gov proposals
View proposal by id
ununifid query gov proposal 1
Vote 'Yes'
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'
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'
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'
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
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.ununifi/config/config.toml
Update pruning
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
ununifid status 2>&1 | jq .ValidatorInfo
Get sync info
ununifid status 2>&1 | jq .SyncInfo
Get node peer
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
[[ $(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
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
sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.025uguu\"/" $HOME/.ununifi/config/app.toml
Enable prometheus
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.ununifi/config/config.toml
Reset chain data
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!
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
sudo systemctl daemon-reload
Enable service
sudo systemctl enable ununifid
Disable service
sudo systemctl disable ununifid
Start service
sudo systemctl start ununifid
Stop service
sudo systemctl stop ununifid
Restart service
sudo systemctl restart ununifid
Check service status
sudo systemctl status ununifid
Check service logs
sudo journalctl -u ununifid -f --no-hostname -o cat
- Sticky