Doc – Lumen – Nagagini Node

LUMEN

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

Minimum Hardware

NODE	CPU	RAM	SSD	OS
lumend	4	8	200 GB	Ubuntu 22.04 LTS

1. Key Management

Create a New Wallet

				
					lumend keys add $WALLET

Recover Wallet from Seed Phrase

				
					lumend keys add $WALLET --recover

List Wallets

				
					lumend keys list

Show Wallet Details

				
					lumend keys show $WALLET

Delete Wallet

				
					lumend keys delete $WALLET

2. PQC Key Management (Dilithium - Quantum-Resistant)

Generate PQC Wallet

				
					lumend keys pqc-generate $PQC_WALLET

Import PQC Hex

				
					cat > ~/pqc_public_hex.txt << 'EOF'
PASTE_PUBLIC_KEY_HEX_HERE
EOF

				
					cat > ~/pqc_private_hex.txt << 'EOF'
PASTE_PRIVATE_KEY_HEX_HERE
EOF

Import PQC Hex

				
					lumend keys pqc-import \
  --name $PQC_WALLET \
  --privkey "$(cat ~/pqc_private_hex.txt)" \
  --pubkey "$(cat ~/pqc_public_hex.txt)" \
  --scheme dilithium3

Link PQC to Cosmos Wallet (Required for Dual-Sign)

				
					lumend keys pqc-link \
  --from $WALLET \
  --pqc $PQC_WALLET \

Verify PQC Setup

				
					lumend keys pqc-list                # List PQC keys & linked wallets
lumend keys pqc-show $PQC_WALLET    # Show details of one PQC key

Secure Cleanup (After Import & Link)

				
					shred -u ~/pqc_private_hex.txt ~/pqc_public_hex.txt

Link PQC Wallet on-chain

Requirement: Wallet must have ≥ 0.001 LMN (1000 ulmn) to execute this tx.
This is a DAO-governed parameter (dilithium3 min) and may change via governance.

				
					lumend tx pqc link-account \
  --from $WALLET \
  --pubkey "$(lumend keys pqc-show $PQC_WALLET | grep 'PubKey (hex)' | sed 's/.*: *//')" \
  --scheme dilithium3 \
  --chain-id $LUMEN_CHAIN_ID \
  --gas auto \
  --gas-prices 0ulmn \
  --node https://lumen-rpc.linknode.org \
  --yes

Verify PQC Wallet on-chain

				
					lumend query pqc account $(lumend keys show $WALLET -a) --node https://lumen-rpc.linknode.org

3. Wallet Operations

Check Balance

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

Send Tokens

				
					lumend tx bank send $(lumend keys show $WALLET -a) <receiver_wallet_address> <amount><denom> --chain-id $LUMEN_CHAIN_ID --gas-prices 0ulmn --gas-adjustment 1.5 --gas auto -y

Check tx hash

				
					lumend query tx <hash> --node https://lumen-rpc.linknode.org

4. Node Management

Generated Code

				
					cat > $HOME/.lumen/validator.json << EOF
{
  "pubkey": $(lumend tendermint show-validator),
  "amount": "1000000ulmn",
  "moniker": "",
  "identity": "",
  "website": "",
  "security_contact": "",
  "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

lumend tx staking create-validator validator.json \
  --from $WALLET \
  --chain-id $LUMEN_CHAIN_ID \
  --gas auto \
  --gas-adjustment 1.5 \
  --gas-prices 0ulmn \
  --node https://lumen-rpc.linknode.org \
  --yes

Edit Validator

				
					lumend tx staking edit-validator \
--moniker "<new_moniker>" \
--identity "<new_keybase_id>" \
--website "<new_website>" \
--security-contact "<new_contact_email>" \
--details "<new_description>" \
--commission-rate "<new_commission_rate>" \
--chain-id $LUMEN_CHAIN_ID \
--gas-prices 0ulmn \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Delegate Tokens

				
					lumend tx staking delegate $(lumend keys show $WALLET --bech val -a) <amount>ulmn \
--chain-id $LUMEN_CHAIN_ID \
--gas-prices 0ulmn \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Delegator)

				
					lumend tx distribution withdraw-rewards $(lumend keys show $WALLET --bech val -a) \
--chain-id $LUMEN_CHAIN_ID \
--gas-prices 0ulmn \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Validator Commission)

				
					lumend tx distribution withdraw-rewards $(lumend keys show $WALLET --bech val -a) --commission \
--chain-id $LUMEN_CHAIN_ID \
--gas-prices 0ulmn \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Unbond Tokens

				
					lumend tx staking unbond $(lumend keys show $WALLET --bech val -a) <amount>ulmn \
--chain-id $LUMEN_CHAIN_ID \
--gas-prices 0ulmn \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Redelegate Tokens

				
					lumend tx staking redelegate $(lumend keys show $WALLET --bech val -a) <destination_validator_address> <amount>ulmn \
--chain-id $LUMEN_CHAIN_ID \
--gas-prices 0ulmn \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Validator Recovery (Unjail)

If your validator is jailed (e.g., due to downtime):

				
					lumend tx slashing unjail \
  --from $WALLET \
  --chain-id $LUMEN_CHAIN_ID \
  --gas auto \
  --gas-prices 0ulmn \
  --node https://lumen-rpc.linknode.org \
  --yes

5. Node Status & Info

Check Sync Status

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

Check Peer Info

				
					Check Peer Info

Show Node ID

				
					lumend tendermint show-node-id

Restart Node

				
					sudo systemctl restart lumend

View Node Logs

				
					sudo journalctl -u lumend -fo cat

6. Governance

List Proposals

				
					lumend query gov proposals

View Proposal Details

				
					lumend query gov proposal <proposal_id>

Vote on Proposal

				
					lumend tx gov vote <proposal_id> <yes|no|no_with_veto|abstain> \
--chain-id $LUMEN_CHAIN_ID \
--gas-prices 0ulmn \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

7. Environment Variables

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

				
					export WALLET="wallet"
export MONIKER="YourMoniker"
export LUMEN_CHAIN_ID="lumen"
export LUMEN_PORT="13"

Apply the changes with:

				
					source ~/.bash_profile