Skip to content

Lava Cheat Sheet and Key Management ​

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

1. Key Management ​

Create a New Wallet ​

bash
lavad keys add $WALLET

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

Recover Wallet from Seed Phrase ​

bash
lavad keys add $WALLET --recover

You will be prompted to enter your seed phrase.

List Wallets ​

bash
lavad keys list

Show Wallet Details ​

bash
lavad keys show $WALLET

Delete Wallet ​

bash
lavad keys delete $WALLET

2. Wallet Operations ​

Check Balance ​

bash
lavad query bank balances $(lavad keys show $WALLET -a)

Send Tokens ​

bash
lavad tx bank send $(lavad keys show $WALLET -a) <receiver_wallet_address> <amount><denom> --chain-id $LAVA_CHAIN_ID --gas-prices 0.0001ulava --gas-adjustment 1.5 --gas auto -y

Example:

bash
lavad tx bank send $(lavad keys show $WALLET -a) lava@1...yyy 1000000ulava --chain-id $LAVA_CHAIN_ID --gas-prices 0.0001ulava --gas-adjustment 1.5 --gas auto -y

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

3. Validator Management ​

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

Create Validator ​

Configuration:

Generated Code:

Loading...
Parameter Explanation:
ParameterDetails
--amountTokens self-delegated to the validator. 1000000ulava = 1 LAVA
--fromWallet used for the transaction.
--commission-rateInitial commission rate.
--commission-max-rateMaximum allowed commission rate.
--commission-max-change-rateMax daily commission change.
--min-self-delegationMinimum tokens for self-delegation.
--pubkeyValidator's public key.
--monikerValidator nickname.
--identityKeybase ID for identity verification.
--websiteValidator's website URL.
--detailsValidator description.
--security-contactEmail for security-related contact.

Edit Validator ​

bash
lavad 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 $LAVA_CHAIN_ID \
--gas-prices 0.0001ulava \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Delegate Tokens ​

bash
lavad tx staking delegate $(lavad keys show $WALLET --bech val -a) <amount>ulava \
--chain-id $LAVA_CHAIN_ID \
--gas-prices 0.0001ulava \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Delegator) ​

bash
lavad tx distribution withdraw-rewards $(lavad keys show $WALLET --bech val -a) \
--chain-id $LAVA_CHAIN_ID \
--gas-prices 0.0001ulava \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Validator Commission) ​

bash
lavad tx distribution withdraw-rewards $(lavad keys show $WALLET --bech val -a) --commission \
--chain-id $LAVA_CHAIN_ID \
--gas-prices 0.0001ulava \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Unbond Tokens ​

bash
lavad tx staking unbond $(lavad keys show $WALLET --bech val -a) <amount>ulava \
--chain-id $LAVA_CHAIN_ID \
--gas-prices 0.0001ulava \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Redelegate Tokens ​

bash
lavad tx staking redelegate $(lavad keys show $WALLET --bech val -a) <destination_validator_address> <amount>ulava \
--chain-id $LAVA_CHAIN_ID \
--gas-prices 0.0001ulava \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

4. Node Status & Info ​

Check Sync Status ​

bash
lavad status 2>&1 | jq .result.sync_info

Check Peer Info ​

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

Show Node ID ​

bash
lavad tendermint show-node-id

Restart Node ​

bash
sudo systemctl restart lavad

View Node Logs ​

bash
sudo journalctl -u lavad -fo cat

5. Governance ​

List Proposals ​

bash
lavad query gov proposals

View Proposal Details ​

bash
lavad query gov proposal <proposal_id>

Vote on Proposal ​

bash
lavad tx gov vote <proposal_id> <yes|no|no_with_veto|abstain> \
--chain-id $LAVA_CHAIN_ID \
--gas-prices 0.0001ulava \
--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:

bash
export WALLET="wallet"
export MONIKER="YourMoniker"
export LAVA_CHAIN_ID="lava-mainnet-1"
export LAVA_PORT="29"

Apply the changes with:

bash
source ~/.bash_profile

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