lumera lumera - Testnet
Chain ID: lumera-testnet-1 Block Height: Loading...
RPC Status:

Network Overview

Lumera Protocol is a fully decentralized, developer-friendly layer-1 blockchain serving as the preeminent protocol standard for non-fungible tokens ("NFTs") and Web3 technology.

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

https://api-lumera-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 -LO https://github.com/LumeraProtocol/lumera/releases/download/v0.4.1/lumera_v0.4.1_linux_amd64.tar.gz
tar -xvf lumera_v0.4.1_linux_amd64.tar.gz
rm lumera_v0.4.1_linux_amd64.tar.gz
rm install.sh
mv libwasmvm.x86_64.so /usr/lib/
chmod +x lumerad
mv lumerad $HOME/go/bin/
  • Initialize The Node
lumerad init $MONIKER --chain-id lumera-testnet-1
sed -i -e "s|^node *=.*|node = \"tcp://localhost:11457\"|" $HOME/.lumera/config/client.toml
sed -i -e "s|^keyring-backend *=.*|keyring-backend = \"os\"|" $HOME/.lumera/config/client.toml
sed -i -e "s|^chain-id *=.*|chain-id = \"lumera-testnet-1\"|" $HOME/.lumera/config/client.toml
  • Download Genesis & Addrbook
curl -L https://snapshot.sychonix.com/testnet/lumera/genesis.json > $HOME/.lumera/config/genesis.json
curl -L https://snapshot.sychonix.com/testnet/lumera/addrbook.json > $HOME/.lumera/config/addrbook.json
  • Configure Seeds and Peers
SEEDS="7554830c281f5a6cefd0355d71d828ef49a8f987@lumera-testnet.sychonix.com:11456"
PEERS="$(curl -sS https://rpc-lumera-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/.lumera/config/config.toml
  • Update Port Configuration
sed -i -e "s%:1317%:11417%; s%:8080%:11480%; s%:9090%:11490%; s%:9091%:11491%; s%:8545%:11445%; s%:8546%:11446%; s%:6065%:11465%" $HOME/.lumera/config/app.toml
sed -i -e "s%:26658%:11458%; s%:26657%:11457%; s%:6060%:11460%; s%:26656%:11456%; s%:26660%:11461%" $HOME/.lumera/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/.lumera/config/app.toml
  • Set Minimum Gas Price, Enable Prometheus, and Disable the Indexer
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.025ulume\"|" $HOME/.lumera/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.lumera/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.lumera/config/config.toml
  • Create Service File
sudo tee /etc/systemd/system/lumerad.service > /dev/null <<EOF
[Unit]
Description=lumerad node service
After=network-online.target
[Service]
User=$USER
ExecStart=$(which lumerad) start
Restart=always
RestartSec=3
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
  • Download Current Snapshot
curl "https://snapshot.sychonix.com/testnet/lumera/lumera-snapshot.tar.lz4" | lz4 -dc - | tar -xf - -C "$HOME/.lumera"
  • Enable the Service and Start the Node
sudo systemctl daemon-reload
sudo systemctl enable lumerad.service
sudo systemctl restart lumerad.service && sudo journalctl -u lumerad.service -f --no-hostname -o cat
  • Create Validator
lumerad tendermint show-validator
  • Create validator.json file
sudo nano $HOME/.lumera/validator.json
{
  "pubkey": ,
  "amount": "100000000ulume",
  "moniker": "",
  "identity": "",
  "website": "",
  "security": "",
  "details": "",
  "commission-rate": "0.05",
  "commission-max-rate": "0.2",
  "commission-max-change-rate": "0.05",
  "min-self-delegation": "1"
}
lumerad tx staking create-validator $HOME/.lumera/validator.json \
--from wallet \
--chain-id lumera-testnet-1 \
--gas-prices=0.025ulume \
--gas-adjustment=1.5 \
--gas=auto

Upgrade

No chain upgrades scheduled yet.

Peers

PEERS="$(curl -sS https://rpc-lumera-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/.lumera/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 lumerad
  • Back up priv_validator_state.json
cp $HOME/.lumera/data/priv_validator_state.json $HOME/.lumera/priv_validator_state.json.backup
  • Reset the data
lumerad tendermint unsafe-reset-all --home $HOME/.lumera --keep-addr-book
  • Download Snapshot
aria2c -x 16 -s 16 -o lumera-snapshot.tar.lz4 https://snapshot.sychonix.com/testnet/lumera/lumera-snapshot.tar.lz4
lz4 -dc lumera-snapshot.tar.lz4 | tar -xf - -C $HOME/.lumera
rm -v lumera-snapshot.tar.lz4
  • Restore Backup and Restart Service
mv $HOME/.lumera/priv_validator_state.json.backup $HOME/.lumera/data/priv_validator_state.json
sudo systemctl restart lumerad && sudo journalctl -u lumerad -f -o cat

Addrbook

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

Genesis

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

API

api-lumera-t.sychonix.com

RPC

rpc-lumera-t.sychonix.com

CLI Cheatsheet

Wallet Management

lumerad keys add 

lumerad keys add  --recover

lumerad keys list 

lumerad keys delete 

lumerad keys export 

lumerad keys import .backup

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

Validator Management

Moniker

Identity

Details

Website

Security Contact

Amount

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

lumerad tx staking edit-validator \
--new-moniker="" \
--identity="" \
--details="" \
--website="" \
--chain-id=lumera-testnet-1 \
--commission-rate=0.07 \
--from wallet \
--gas=auto \
--gas-prices 0.025ulume \
-y

lumerad tx slashing unjail --from wallet --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5  

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

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

lumerad q bank denom-metadata -oj | jq

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

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

Token Management

lumerad tx distribution withdraw-all-rewards --from wallet --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.025ulume -y 

lumerad tx distribution withdraw-rewards $(lumerad keys show wallet --bech val -a) --commission --from wallet --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.025ulume -y 

lumerad tx staking delegate $(lumerad keys show wallet --bech val -a) 1000000ulume --from wallet --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.025ulume -y 

lumerad tx staking redelegate $(lumerad keys show wallet --bech val -a)  1000000ulume --from wallet --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.025ulume -y

lumerad tx staking delegate  1000000ulume --from  --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.025ulume -y 

lumerad tx staking unbond $(lumerad keys show wallet --bech val -a) 1000000ulume --from wallet --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.025ulume -y

lumerad tx bank send wallet  1000000ulume --from wallet --chain-id lumera-testnet-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.025ulume -y

Service Management

sudo systemctl daemon-reload

sudo systemctl enable lumerad 

sudo systemctl disable lumerad 

sudo systemctl start lumerad 

sudo systemctl stop lumerad 

sudo systemctl restart lumerad 

sudo systemctl status lumerad 

sudo journalctl -u lumerad -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/.lumera/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/.lumera/config/app.toml

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