Empe Testnet

Active

Empeiria is a Layer-1 blockchain project building a verifiable and decentralized data infrastructure.

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

emped keys add $WALLET

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

Recover Wallet from Seed Phrase

emped keys add $WALLET --recover

You will be prompted to enter your seed phrase.

List Wallets

emped keys list

Show Wallet Details

emped keys show $WALLET

Delete Wallet

emped keys delete $WALLET

2. Wallet Operations

Check Balance

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

Send Tokens

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:

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

Amount

Moniker

Identity

Website

Details

Contact

Generated Command

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

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

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

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)

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)

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

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

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

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

Check Peer Info

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

Show Node ID

emped tendermint show-node-id

Restart Node

sudo systemctl restart emped

View Node Logs

sudo journalctl -u emped -fo cat

5. Governance

List Proposals

emped query gov proposals

View Proposal Details

emped query gov proposal <proposal_id>

Vote on Proposal

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:

export WALLET="wallet"
export MONIKER="YourMoniker"
export EMPED_CHAIN_ID="empe-testnet-2"
export EMPED_PORT="18"

Apply the changes with:

source ~/.bash_profile

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