Union Union - Testnet
Chain ID: union-testnet-9 Block Height: Loading...
RPC Status:

Network Overview

Union network is a hyper-efficient zero-knowledge infrastructure layer for general message passing, asset transfers, NFTs, and DeFi. It's based on consensus verification and has no dependencies on trusted third parties, oracles, multi-signatures, or MPC.

https://rpc-union-t.sychonix.com

https://api-union-t.sychonix.com

Installation

  • Install Dependencies
sudo apt update && sudo apt upgrade -y
sudo 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 aria2 -y
  • Install Go
sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.21.13.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
eval $(echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/golang.sh)
eval $(echo 'export PATH=$PATH:$HOME/go/bin' | tee -a $HOME/.profile)
  • Install binary
cd $HOME
curl -L https://snapshot.sychonix.com/testnet/union/uniond.tar.gz | tar -xvzf - -C $HOME
sudo mv uniond /usr/local/bin/
  • Initialize The Node
alias uniond='uniond --home=$HOME/.union/'
uniond init $MONIKER --chain-id union-testnet-9
sed -i -e "s|^node *=.*|node = \"tcp://localhost:13157\"|" $HOME/.union/config/client.toml
sed -i -e "s|^keyring-backend *=.*|keyring-backend = \"os\"|" $HOME/.union/config/client.toml
sed -i -e "s|^chain-id *=.*|chain-id = \"union-testnet-9\"|" $HOME/.union/config/client.toml
  • Download Genesis & Addrbook
curl -L https://snapshot.sychonix.com/testnet/union/genesis.json > $HOME/.union/config/genesis.json
curl -L https://snapshot.sychonix.com/testnet/union/addrbook.json > $HOME/.union/config/addrbook.json
  • Configure Seeds and Peers
SEEDS="d603ec240859a2d67e87118d0faff5abeb82d263@union-testnet.sychonix.com:13156"
PEERS="$(curl -sS https://rpc-union-t.sychonix.com/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}' | sed -z 's|\n|,|g;s|.$||')"
sed -i -e "s|^seeds *=.*|seeds = '"$SEEDS"'|; s|^persistent_peers *=.*|persistent_peers = '"$PEERS"'|" $HOME/.union/config/config.toml
  • Update Port Configuration
sed -i -e "s%:1317%:13117%; s%:8080%:13180%; s%:9090%:13190%; s%:9091%:13191%; s%:8545%:13145%; s%:8546%:13146%; s%:6065%:13165%" $HOME/.union/config/app.toml
sed -i -e "s%:26658%:13158%; s%:26657%:13157%; s%:6060%:13160%; s%:26656%:13156%; s%:26660%:13161%" $HOME/.union/config/config.toml
  • Customize Pruning
sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "17"|' \
  $HOME/.union/config/app.toml
  • Set Minimum Gas Price, Enable Prometheus, and Disable the Indexer
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0muno\"|" $HOME/.union/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.union/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.union/config/config.toml
  • Create Service File
sudo tee /etc/systemd/system/uniond.service > /dev/null <<EOF
[Unit]
Description=uniond node service
After=network-online.target
[Service]
User=$USER
ExecStart=$(which uniond) start
Restart=always
RestartSec=3
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
  • Download Current Snapshot
curl "https://snapshot.sychonix.com/testnet/union/union-snapshot.tar.lz4" | lz4 -dc - | tar -xf - -C "$HOME/.union"
  • Enable the Service and Start the Node
sudo systemctl daemon-reload
sudo systemctl enable uniond.service
sudo systemctl restart uniond.service && sudo journalctl -u uniond.service -f --no-hostname -o cat

Upgrade

No chain upgrades scheduled yet.

Peers

PEERS="$(curl -sS https://rpc-union-t.sychonix.com/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}' | sed -z 's|\n|,|g;s|.$||')"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.union/config/config.toml

Snapshot

Height: Loading... | Last updated: Loading... | Size: Loading...
  • Install dependencies, if needed
sudo apt update && sudo apt install aria2
  • Stop Service
sudo systemctl stop uniond
  • Back up priv_validator_state.json
cp $HOME/.union/data/priv_validator_state.json $HOME/.union/priv_validator_state.json.backup
  • Reset the data
uniond tendermint unsafe-reset-all --home $HOME/.union --keep-addr-book
  • Download Snapshot
aria2c -x 16 -s 16 -o union-snapshot.tar.lz4 https://snapshot.sychonix.com/testnet/union/union-snapshot.tar.lz4
lz4 -dc union-snapshot.tar.lz4 | tar -xf - -C $HOME/.union
rm -v union-snapshot.tar.lz4
  • Restore Backup and Restart Service
mv $HOME/.union/priv_validator_state.json.backup $HOME/.union/data/priv_validator_state.json
sudo systemctl restart uniond && sudo journalctl -u uniond -f -o cat

Addrbook

curl -L https://snapshot.sychonix.com/testnet/union/addrbook.json > $HOME/.union/config/addrbook.json

Genesis

curl -L https://snapshot.sychonix.com/testnet/union/genesis.json > $HOME/.union/config/genesis.json

API

api-union-t.sychonix.com

RPC

rpc-union-t.sychonix.com

CLI Cheatsheet

Wallet Management

uniond keys add 

uniond keys add  --recover

uniond keys list 

uniond keys delete 

uniond keys export 

uniond keys import .backup

uniond q bank balances $(uniond keys show  -a)

Validator Management

Moniker

Identity

Details

Website

Security Contact

Amount

uniond tx staking create-validator \
--amount=1000000muno \
--pubkey=$(uniond tendermint show-validator) \
--moniker="" \
--identity="" \
--details="" \
--website="" \
--security-contact= \
--chain-id=union-testnet-9 \
--commission-rate=0.05 \
--commission-max-rate=0.20 \
--commission-max-change-rate=0.01 \
--min-self-delegation=1 \
--gas-prices 0muno \
--gas "auto" \
--gas-adjustment "1.5" \
--from wallet \
-y

uniond tx staking edit-validator \
--new-moniker="" \
--identity="" \
--details="" \
--website="" \
--chain-id=union-testnet-9 \
--commission-rate=0.07 \
--from wallet \
--gas=auto \
--gas-prices 0muno \
-y

uniond tx slashing unjail --from wallet --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5  

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

uniond q staking validator $(uniond keys show wallet --bech val -a)

uniond q bank denom-metadata -oj | jq

uniond status 2>&1 | jq -r '.SyncInfo.catching_up // .sync_info.catching_up'

uniond status 2>&1 | jq -r '.SyncInfo.latest_block_height // .sync_info.latest_block_height'

Token Management

uniond tx distribution withdraw-all-rewards --from wallet --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5 --gas-prices 0muno -y 

uniond tx distribution withdraw-rewards $(uniond keys show wallet --bech val -a) --commission --from wallet --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5 --gas-prices 0muno -y 

uniond tx staking delegate $(uniond keys show wallet --bech val -a) 1000000muno --from wallet --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5 --gas-prices 0muno -y 

uniond tx staking redelegate $(uniond keys show wallet --bech val -a)  1000000muno --from wallet --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5 --gas-prices 0muno -y

uniond tx staking delegate  1000000muno --from  --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5 --gas-prices 0muno -y 

uniond tx staking unbond $(uniond keys show wallet --bech val -a) 1000000muno --from wallet --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5 --gas-prices 0muno -y

uniond tx bank send wallet  1000000muno --from wallet --chain-id union-testnet-9 --gas auto --gas-adjustment 1.5 --gas-prices 0muno -y

Service Management

sudo systemctl daemon-reload

sudo systemctl enable uniond 

sudo systemctl disable uniond 

sudo systemctl start uniond 

sudo systemctl stop uniond 

sudo systemctl restart uniond 

sudo systemctl status uniond 

sudo journalctl -u uniond -f --no-hostname -o cat

CUSTOM_PORT=
sed -i.bak -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${CUSTOM_PORT}658\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:${CUSTOM_PORT}657\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${CUSTOM_PORT}060\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${CUSTOM_PORT}656\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${CUSTOM_PORT}660\"%" $HOME/.union/config/config.toml
sed -i.bak -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${CUSTOM_PORT}317\"%; s%^address = \":8080\"%address = \":${CUSTOM_PORT}080\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${CUSTOM_PORT}090\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${CUSTOM_PORT}091\"%" $HOME/.union/config/app.toml

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