Home

lumera

The Lumera Protocol is a layer-1 blockchain that provides developers and users with critical tools to elevate projects to the next level

⚡ Official 🔮 Discord 🚀 Twitter
RPC API gRPC RPC-EVM WSS-RPC Addressbook Genesis Seed Peer Explorer

Minimum Hardware

NODE CPU RAM SSD OS
lumerad 4 8 100 GB Ubuntu 22.04 LTS

Install dependencies

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

cd $HOME
VER="1.23.5"
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 Var

echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="test"" >> $HOME/.bash_profile
echo "export LUMERA_CHAIN_ID="lumera-testnet-1"" >> $HOME/.bash_profile
echo "export LUMERA_PORT="21"" >> $HOME/.bash_profile
source $HOME/.bash_profile

Download Binary

cd $HOME
wget 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/
lumerad version

Config and Init App

lumerad config node tcp://localhost:${LUMERA_PORT}657
lumerad config keyring-backend os
lumerad config chain-id lumera-testnet-1
lumerad init "test" --chain-id lumera-testnet-1

Download Genesis and Addrbook

wget -O $HOME/.lumera/config/genesis.json https://testnet-files.bonynode.online/lumera/genesis.json
wget -O $HOME/.lumera/config/addrbook.json https://testnet-files.bonynode.online/lumera/addrbook.json

Seeds and Peers

SEEDS=
PEERS="0f85ddad45882ba2f770de01308dafcc833abe81@94.130.23.254:30756,1edeedc5f5c3d08a1999a7c334e11ad10d252039@88.99.136.168:26656,d1c934296c3e3f6379677a94a06e944e3dec17f3@94.130.143.184:17656,ad0b77cb312cd848b3debe7fbef677ef480beb75@116.202.210.177:22656,a2cac656019665fcd03d3039fee5940e77a035c4@37.27.239.10:26656,cd26df61f5d469d574fd89e3c8a08a323187090f@18.191.254.213:26656,2fe5e18e23c24accacfa9fada0f2683b9721cb0c@95.217.77.229:30756,54bb17ce612313b941ec6aee00413d6a08032e69@64.203.83.66:26656,d5519e378247dfb61dfe90652d1fe3e2b3005a5b@213.239.207.162:16956,9ed3e540ca5ff2d57a58cd9b62128a48f0fe01c3@65.109.59.22:30756"
sed -i -e "s/^seeds *=.*/seeds = \"$SEEDS\"/; s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.lumera/config/config.toml

Custom Ports

sed -i.bak -e "s%:1317%:${LUMERA_PORT}317%g;
s%:8080%:${LUMERA_PORT}080%g;
s%:9090%:${LUMERA_PORT}090%g;
s%:9091%:${LUMERA_PORT}091%g;
s%:8545%:${LUMERA_PORT}545%g;
s%:8546%:${LUMERA_PORT}546%g;
s%:6065%:${LUMERA_PORT}065%g" $HOME/.lumera/config/app.toml

sed -i.bak -e "s%:26658%:${LUMERA_PORT}658%g;
s%:26657%:${LUMERA_PORT}657%g;
s%:6060%:${LUMERA_PORT}060%g;
s%:26656%:${LUMERA_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${LUMERA_PORT}656\"%;
s%:26660%:${LUMERA_PORT}660%g" $HOME/.lumera/config/config.toml

Pruning, Gas and Prometheus

sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.lumera/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.lumera/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"50\"/" $HOME/.lumera/config/app.toml

sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "4000ulume"|g' $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=lumera
After=network-online.target

[Service]
User=root
ExecStart=/root/go/bin/lumerad start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Start

sudo systemctl daemon-reload
sudo systemctl enable lumerad
sudo systemctl restart lumerad

Snapshot

lumerad tendermint unsafe-reset-all --home $HOME/.lumera
if curl -s --head curl https://testnet-files.bonynode.online/lumera/snap_lumera.tar.lz4 | head -n 1 | grep "200" > /dev/null; then
 curl https://testnet-files.bonynode.online/lumera/snap_lumera.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.lumera
 else
 echo no have snap
fi
sudo systemctl restart lumerad && sudo journalctl -u lumerad -f

Create and Restore Address

lumerad keys add wallet 
# Restore wallet
lumerad keys add wallet --recover
# List
lumerad keys list

Check Balance

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

Create Validator

lumerad tendermint show-validator

nano $HOME/.lumera/validator.json

{
 "pubkey": ,
 "amount": "1000000ulume",
 "moniker": "",
 "identity": "",
 "website": "",
 "security": "",
 "details": "catsmile",
 "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

Delegate to own

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

Unjail Validator

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

Vote

lumerad tx gov vote

Upgrade

sudo systemctl stop lumerad
lumerad tendermint unsafe-reset-all
rm -rf ~/.lumera/wasm
curl -o ~/.lumera/config/genesis.json https://raw.githubusercontent.com/LumeraProtocol/lumera-networks/refs/heads/master/testnet-2/genesis.json
curl -o ~/.lumera/config/claims.csv https://raw.githubusercontent.com/LumeraProtocol/lumera-networks/refs/heads/master/testnet-2/claims.csv
cd $HOME
curl -LO https://github.com/LumeraProtocol/lumera/releases/download/v1.6.0/lumera_v1.6.0_linux_amd64.tar.gz
tar -xvf lumera_v1.6.0_linux_amd64.tar.gz
sudo ./install.sh
sudo cp lumerad /root/go/bin/lumerad
/root/go/bin/lumerad version --long | grep version
sudo systemctl restart lumerad && sudo journalctl -u lumerad -f -o cat

Delete node

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