🔑Installation

Recommended Hardware:

4 Cores, 8GB RAM, 200GB of storage (NVME)

Installation

# install dependencies, if needed
sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc unzip -y

# install go, if needed
cd $HOME
VER="1.21.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"
[ ! -f ~/.bash_profile ] && touch ~/.bash_profile
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin
 
# set vars
echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="test"" >> $HOME/.bash_profile
echo "export JUNCTION_CHAIN_ID="junction"" >> $HOME/.bash_profile
echo "export JUNCTION_PORT="18"" >> $HOME/.bash_profile
source $HOME/.bash_profile
 
# download binary
cd $HOME
rm -rf $HOME/.junction
wget https://github.com/airchains-network/junction/releases/download/v0.1.0/junctiond
sudo chmod +x junctiond
sudo mv junctiond /usr/local/bin/
 
# config and init app
junctiond init $MONIKER
sed -i -e "s|^node *=.*|node = \"tcp://localhost:${JUNCTION_PORT}657\"|" $HOME/.junction/config/client.toml
 
# download genesis and addrbook
wget -O $HOME/.junction/config/genesis.json https://snapshot.grandiendvalidator.org/airchain-testnet/genesis.json
wget -O $HOME/.junction/config/addrbook.json https://snapshot.grandiendvalidator.org/airchain-testnet/addrbook.json
 
# set seeds and peers
SEEDS="[e-mail]:28656"
PEERS="[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:56256,[email protected]:26656,[email protected]:26656,[email protected]:26656"
sed -i -e "s/^seeds *=.*/seeds = \"$SEEDS\"/; s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.junction/config/config.toml
 
# set custom ports in app.toml
sed -i.bak -e "s|:1317|:${JUNCTION_PORT}317|g;
s|:8080|:${JUNCTION_PORT}080|g;
s|:9090|:${JUNCTION_PORT}090|g;
s|:9091|:${JUNCTION_PORT}091|g;
s|:8545|:${JUNCTION_PORT}545|g;
s|:8546|:${JUNCTION_PORT}546|g;
s|:6065|:${JUNCTION_PORT}065|g" $HOME/.junction/config/app.toml
 
# set custom ports in config.toml file
sed -i.bak -e "s|:26658|:${JUNCTION_PORT}658|g;
s|:26657|:${JUNCTION_PORT}657|g;
s|:6060|:${JUNCTION_PORT}060|g;
s|:26656|:${JUNCTION_PORT}656|g;
s|^external_address = \"\"|external_address = \"$(wget -qO- eth0.me):${JUNCTION_PORT}656\"|g;
s|:26660|:${JUNCTION_PORT}660|g" $HOME/.junction/config/config.toml
 
# config pruning
sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.junction/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.junction/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"50\"/" $HOME/.junction/config/app.toml
 
# set minimum gas price, enable prometheus and disable indexing
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.00025amf"|g' $HOME/.junction/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.junction/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.junction/config/config.toml
 
# create service file
sudo tee /etc/systemd/system/junctiond.service > /dev/null <<EOF
[Unit]
Description=Warden node
After=network-online.target
 
[Service]
User=$USER
WorkingDirectory=$HOME/.junction
ExecStart=$(which junctiond) start
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
 
[Install]
WantedBy=multi-user.target
EOF
 
# reset and download snapshot
junctiond tendermint unsafe-reset-all --home $HOME/.junction
 
# enable and start service
sudo systemctl daemon-reload
sudo systemctl enable junctiond
sudo systemctl restart junctiond && sudo journalctl -u junctiond -f

---

---

---

Wallet

Create a wallet

junctiond keys add $WALLET

To restore your keys you have created, do this

junctiond keys add $WALLET --recover

Save wallet and validator address

WALLET_ADDRESS=$(junctiond keys show $WALLET -a)
VALOPER_ADDRESS=$(junctiond keys show $WALLET --bech val -a)
echo "export WALLET_ADDRESS="$WALLET_ADDRESS >> $HOME/.bash_profile
echo "export VALOPER_ADDRESS="$VALOPER_ADDRESS >> $HOME/.bash_profile
source $HOME/.bash_profile

Check sync status, once your node is fully synced, the output from above will print "false"

junctiond status 2>&1 | jq .sync_info

After creating a validator, make sure the fund has been funded sucessfully

junctiond query bank balances $WALLET_ADDRESS

---

---

---

Validator

To create a validator at airchain node, you should import the data of your validator to the validator.json file

first of all, you have to execute this to see validator-pub-key

junctiond comet show-validator

then, you can see the result such a following output below

{"@type":"/cosmos.crypto.ed25519.PubKey","key":"xxxx"}

after getting the <validator-pub-key>, you can insert it to the validator.json file

sudo tee $HOME/.junction/validator.json > /dev/null <<EOF
{
	"pubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"xxxx"},
	"amount": "1000000amf",
	"moniker": "<validator-name>",
	"identity": "optional identity signature (ex. UPort or Keybase)",
	"website": "validator's (optional) website",
	"security": "validator's (optional) security contact email",
	"details": "validator's (optional) details",
	"commission-rate": "0.1",
	"commission-max-rate": "0.2",
	"commission-max-change-rate": "0.01",
	"min-self-delegation": "1"
}
EOF
 
# Create a validator using the JSON configuration
junctiond tx staking create-validator $HOME/.junction/validator.json \
    --from $WALLET \
    --chain-id junction \
	--gas auto \
	--gas-adjustment 1.5 \
	--fees 500amf

---

---

---

Usefull commads

Service operations

#Check Logs
sudo journalctl -f -u junctiond
 
#Start service
sudo systemnctl start junctiond
 
#Restart Service
sudo systemnctl restart junctiond

withdraw all reward

junctiond tx distribution withdraw-all-rewards --from $WALLET --chain-id junction --gas auto --gas-adjustment 1.5 --fees 500amf 

Withdraw rewards and commission from your validator

junctiond tx distribution withdraw-rewards $VALOPER_ADDRESS --from $WALLET --commission --chain-id junction --gas auto --gas-adjustment 1.5 --fees 500amf -y 

Check wallet balance

junctiond query bank balances $WALLET

Delegate to the validator itself

junctiond tx staking delegate $(junctiond keys show $WALLET --bech val -a) 1000000amf --from $WALLET --chain-id junction --gas auto --gas-adjustment 1.5 --fees 500amf -y 

Redelegate to other validators

junctiond tx staking redelegate $VALOPER_ADDRESS <TO_VALOPER_ADDRESS> 1000000amf --from $WALLET --chain-id junction --gas auto --gas-adjustment 1.5 --fees 500amf -y 

Unbond

junctiond tx staking unbond $(junctiond keys show $WALLET --bech val -a) 1000000amf --from $WALLET --chain-id junction --gas auto --gas-adjustment 1.5 --fees 500amf -y 

Transfer Funds

junctiond tx bank send $WALLET_ADDRESS <TO_WALLET_ADDRESS> 1000000amf --gas auto --gas-adjustment 1.5 --fees 500amf -y 

KEY MANAGEMENT

Create Wallet

junctiond keys add $WALLET

Recover Existing Wallet

junctiond keys add $WALLET --recover

Check All Available Wallet

junctiond keys list

Check wallet funds

junctiond q bank balances $WALLET_ADDRESS

VALIDATOR INFORMATION

create a validator

junctiond tx staking create-validator \
--amount 1000000amf \
--from $WALLET \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--security-contact ""\
--pubkey $(junctiond tendermint show-validator) \
--moniker $MONIKER \
--identity "" \
--details "a validator blockchain" \
--chain-id junction \
--gas auto \
--gas-adjustment 1.5 \
--fees 500amf

edit existing validator

junctiond tx staking edit-validator \
--commission-rate 0.1 \
--new-moniker $MONIKER \
--identity "" \
--details "a validator blockchain" \
--from $WALLET \
--chain-id junction \
--gas auto \
--gas-adjustment 1.5 \
--fees 500amf \
-y

validator status/info

junctiond status 2>&1 | jq