Lava

Archived

A decentralized RPC routing protocol for scalable and reliable blockchain access.

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

lavad keys add $WALLET

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

Recover Wallet from Seed Phrase

lavad keys add $WALLET --recover

You will be prompted to enter your seed phrase.

List Wallets

lavad keys list

Show Wallet Details

lavad keys show $WALLET

Delete Wallet

lavad keys delete $WALLET

2. Wallet Operations

Check Balance

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

Send Tokens

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:

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

Amount

Commission

Moniker

Identity

Website

Contact

Details

Chain

Generated Command

lavad tx staking create-validator \
--amount 1000000ulava \
--from $WALLET \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--pubkey $(lavad tendermint show-validator) \
--moniker "" \
--identity "" \
--website "" \
--security " \
--details "🚀 Built by node runners." \
--chain-id lava-mainnet-1 \
--gas auto --gas-adjustment 1.5 --fees 1ulava \
-y

Parameter Explanation:

Parameter	Details
`--amount`	Tokens self-delegated to the validator. 1000000ulava = 1 LAVA
`--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

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

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)

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)

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

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

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

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

Check Peer Info

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

Show Node ID

lavad tendermint show-node-id

Restart Node

sudo systemctl restart lavad

View Node Logs

sudo journalctl -u lavad -fo cat

5. Governance

List Proposals

lavad query gov proposals

View Proposal Details

lavad query gov proposal <proposal_id>

Vote on Proposal

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:

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

Apply the changes with:

source ~/.bash_profile

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