Lumera

Active

Lumera Protocol is a layer-1 blockchain designed to support decentralized AI services.

Lumera Cheat Sheet and Key Management

This guide provides essential commands for managing wallets, nodes, and validators on the Lumera network. Make sure the environment variables mentioned at the end are correctly configured before using these commands.

1. Key Management

Create a New Wallet

lumerad keys add $WALLET

Keep the generated seed phrase safe. It is the only way to recover your wallet.

Recover Wallet from Seed Phrase

lumerad keys add $WALLET --recover

You will be prompted to enter your seed phrase.

List Wallets

lumerad keys list

Show Wallet Details

lumerad keys show $WALLET

Delete Wallet

lumerad keys delete $WALLET

2. Wallet Operations

Check Balance

lumerad query bank balances $(lumerad keys show $WALLET -a)

Send Tokens

lumerad tx bank send $(lumerad keys show $WALLET -a) <receiver_wallet_address> <amount><denom> --chain-id $LUMERA_CHAIN_ID --gas-prices 0.025ulume --gas-adjustment 1.5 --gas auto -y

Example:

lumerad tx bank send $(lumerad keys show $WALLET -a) lumera1...yyy 1000000ulume --chain-id $LUMERA_CHAIN_ID --gas-prices 0.025ulume --gas-adjustment 1.5 --gas auto -y

Replace <amount> with the number of tokens and <denom> with the token denomination (e.g., ulume).

3. Validator Management

Ensure you have enough ulume tokens for self-delegation and transaction fees before creating a validator.

Create Validator

Configuration

Amount

Moniker

Identity

Website

Contact

Details

Commission

Generated Command

cat <<EOF > $HOME/.lumera/validator.json
{
  "pubkey": {
    "@type": "/cosmos.crypto.ed25519.PubKey",
    "key": "$(lumerad tendermint show-validator | grep -Po '"key":s*"K[^"]*')"
  },
  "amount": "1000000ulume",
  "moniker": "",
  "identity": "",
  "website": "",
  "security": "",
  "details": "🚀 Built by node runners.",
  "commission-rate": "0.1",
  "commission-max-rate": "0.20",
  "commission-max-change-rate": "0.01",
  "min-self-delegation": "1"
}
EOF
lumerad tx staking create-validator $HOME/.lumera/validator.json \
  --from=$WALLET \
  --chain-id=lumera-mainnet-1 \
  --gas=auto \
  --gas-adjustment=1.4 \
  --fees 300ulume \
  --home ~/.lumera \
  -y

Parameter Explanation:

Parameter	Details
`--amount`	Tokens self-delegated to the validator. 1000000ulume = 1 LUME
`--from`	Wallet used for the transaction.
`--commission-rate`	Initial commission rate.
`--commission-max-rate`	Maximum allowed commission rate.
`--commission-max-change-rate`	Max daily commission change.
`--min-self-delegation`	Minimum tokens for self-delegation.
`--pubkey`	Validator's public key.
`--moniker`	Validator nickname.
`--identity`	Keybase ID for identity verification.
`--website`	Validator's website URL.
`--details`	Validator description.
`--security-contact`	Email for security-related contact.

Edit Validator

lumerad tx staking edit-validator \
--moniker "$MONIKER" \
--identity "<new_keybase_id>" \
--website "<new_website>" \
--security-contact "<new_contact_email>" \
--details "<new_description>" \
--commission-rate "0.07" \
--chain-id $LUMERA_CHAIN_ID \
--gas-prices 0.025ulume \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Delegate Tokens

lumerad tx staking delegate $(lumerad keys show $WALLET --bech val -a) <amount>ulume \
--chain-id $LUMERA_CHAIN_ID \
--gas-prices 0.025ulume \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Delegator)

lumerad tx distribution withdraw-rewards $(lumerad keys show $WALLET --bech val -a) \
--chain-id $LUMERA_CHAIN_ID \
--gas-prices 0.025ulume \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Validator Commission)

lumerad tx distribution withdraw-rewards $(lumerad keys show $WALLET --bech val -a) --commission \
--chain-id $LUMERA_CHAIN_ID \
--gas-prices 0.025ulume \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Unbond Tokens

lumerad tx staking unbond $(lumerad keys show $WALLET --bech val -a) <amount>ulume \
--chain-id $LUMERA_CHAIN_ID \
--gas-prices 0.025ulume \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Redelegate Tokens

lumerad tx staking redelegate $(lumerad keys show $WALLET --bech val -a) <destination_validator_address> <amount>ulume \
--chain-id $LUMERA_CHAIN_ID \
--gas-prices 0.025ulume \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

4. Node Status & Info

Check Sync Status

lumerad status 2>&1 | jq .result.sync_info

Check Peer Info

lumerad status 2>&1 | jq .result.sync_info.catching_up
lumerad status 2>&1 | jq .result.node_info.listen_addr

Show Node ID

lumerad tendermint show-node-id

Restart Node

sudo systemctl restart lumerad

View Node Logs

sudo journalctl -u lumerad -fo cat

5. Governance

List Proposals

lumerad query gov proposals

View Proposal Details

lumerad query gov proposal <proposal_id>

Vote on Proposal

lumerad tx gov vote <proposal_id> <yes|no|no_with_veto|abstain> \
--chain-id $LUMERA_CHAIN_ID \
--gas-prices 0.025ulume \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

6. Environment Variables

Make sure to set these in your ~/.bash_profile or equivalent shell config:

export WALLET="wallet"
export MONIKER="YourMoniker"
export LUMERA_CHAIN_ID="lumera-mainnet-1"
export LUMERA_PORT="10"

Apply the changes with:

source ~/.bash_profile

This cheat sheet is provided to streamline Lumera validator and wallet management.