Empeiria Cheat Sheet and Key Management
This guide provides essential commands for managing wallets, nodes, and validators on the Empeiria 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
emped keys add $WALLET
Keep the generated seed phrase safe. It is the only way to recover your wallet.
Recover Wallet from Seed Phrase
bash
emped keys add $WALLET --recover
You will be prompted to enter your seed phrase.
List Wallets
bash
emped keys list
Show Wallet Details
bash
emped keys show $WALLET
Delete Wallet
bash
emped keys delete $WALLET
2. Wallet Operations
Check Balance
bash
emped query bank balances $(emped keys show $WALLET -a)
Send Tokens
bash
emped tx bank send $(emped keys show $WALLET -a) <receiver_wallet_address> <amount><denom> --chain-id $EMPED_CHAIN_ID --gas-prices 0.0001uempe --gas-adjustment 1.5 --gas auto -y
Example:
bash
emped tx bank send $(emped keys show $WALLET -a) empe1...yyy 1000000uempe --chain-id $EMPED_CHAIN_ID --gas-prices 0.0001uempe --gas-adjustment 1.5 --gas auto -y
Replace <amount>
with the number of tokens and <denom>
with the token denomination (e.g., uempe
).
3. Validator Management
Ensure you have enough uempe
tokens for self-delegation and transaction fees before creating a validator.
Create Validator
Configuration:
Generated Code:
Loading...
Parameter Explanation:
Parameter | Details |
---|---|
--amount | Tokens self-delegated to the validator. 1000000uempe = 1 EMPE |
--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
bash
emped 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 $EMPED_CHAIN_ID \
--gas-prices 0.0001uempe \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y
Delegate Tokens
bash
emped tx staking delegate $(emped keys show $WALLET --bech val -a) <amount>uempe \
--chain-id $EMPED_CHAIN_ID \
--gas-prices 0.0001uempe \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y
Withdraw Rewards (Delegator)
bash
emped tx distribution withdraw-rewards $(emped keys show $WALLET --bech val -a) \
--chain-id $EMPED_CHAIN_ID \
--gas-prices 0.0001uempe \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y
Withdraw Rewards (Validator Commission)
bash
emped tx distribution withdraw-rewards $(emped keys show $WALLET --bech val -a) --commission \
--chain-id $EMPED_CHAIN_ID \
--gas-prices 0.0001uempe \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y
Unbond Tokens
bash
emped tx staking unbond $(emped keys show $WALLET --bech val -a) <amount>uempe \
--chain-id $EMPED_CHAIN_ID \
--gas-prices 0.0001uempe \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y
Redelegate Tokens
bash
emped tx staking redelegate $(emped keys show $WALLET --bech val -a) <destination_validator_address> <amount>uempe \
--chain-id $EMPED_CHAIN_ID \
--gas-prices 0.0001uempe \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y
4. Node Status & Info
Check Sync Status
bash
emped status 2>&1 | jq .result.sync_info
Check Peer Info
bash
emped status 2>&1 | jq .result.sync_info.catching_up
emped status 2>&1 | jq .result.node_info.listen_addr
Show Node ID
bash
emped tendermint show-node-id
Restart Node
bash
sudo systemctl restart emped
View Node Logs
bash
sudo journalctl -u emped -fo cat
5. Governance
List Proposals
bash
emped query gov proposals
View Proposal Details
bash
emped query gov proposal <proposal_id>
Vote on Proposal
bash
emped tx gov vote <proposal_id> <yes|no|no_with_veto|abstain> \
--chain-id $EMPED_CHAIN_ID \
--gas-prices 0.0001uempe \
--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 EMPED_CHAIN_ID="empe-testnet-2"
export EMPED_PORT="18"
Apply the changes with:
bash
source ~/.bash_profile
This cheat sheet is provided to streamline Empeiria validator and wallet management.