XOS Testnet

XOS is a high-performance, low-cost chain that natively bridges major assets such as SPL and ERC20.

XOS Cheat Sheet and Key Management

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

1. Key Management

Create a New Wallet

xosd keys add $WALLET

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

Recover Wallet from Seed Phrase

xosd keys add $WALLET --recover

List Wallets

xosd keys list

Show Wallet Details

xosd keys show $WALLET

Delete Wallet

xosd keys delete $WALLET

2. Wallet Operations

Check Balance

xosd q bank balances $(xosd keys show $WALLET -a)

Send Tokens

xosd tx bank send $(xosd keys show $WALLET -a) <receiver_wallet_address> <amount><denom> --chain-id $XOS_CHAIN_ID --gas-prices 80000000000axos --gas-adjustment 1.5 --gas auto -y

Example:

xosd tx bank send $(xosd keys show $WALLET -a) xos1...zzz 1000000000000000000axos --chain-id $XOS_CHAIN_ID --gas-prices 80000000000axos --gas-adjustment 1.5 --gas auto -y

3. Validator Management

Create Validator

Configuration

Amount

Moniker

Identity

Website

Contact

Details

Commission

Port

Generated Command

cat <<EOF > /root/.xosd/validator.json
{
  "pubkey": {
    "@type": "/cosmos.crypto.ed25519.PubKey",
    "key": "$(xosd tendermint show-validator | grep -Po '"key":s*"K[^"]*')"
  },
  "amount": "1000000000000000000axos",
  "moniker": "",
  "identity": "",
  "website": "",
  "security": "",
  "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
xosd tx staking create-validator /root/.xosd/validator.json \
  --from=wallet \
  --chain-id=$XOSD_CHAIN_ID \
  --gas=auto \
  --gas-prices=80000000000axos \
  --gas-adjustment=1.4 \
  --keyring-backend=os \
  --home ~/.xosd \
  --node http://localhost:11657 \
  -y

Parameter Explanation:

Parameter	Details
`--amount`	Tokens self-delegated to the validator. 1000000000000000000axos = 1 XOS
`--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

xosd 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 $XOSD_CHAIN_ID \
--gas-prices 80000000000axos \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Delegate Tokens

xosd tx staking delegate <validator_address> <amount>axos --chain-id $XOSD_CHAIN_ID --gas-prices 80000000000axos --gas-adjustment 1.5 --gas auto --from $WALLET -y

Withdraw Rewards (Delegator)

xosd tx distribution withdraw-rewards <validator_address> --chain-id $XOSD_CHAIN_ID --gas-prices 80000000000axos --gas-adjustment 1.5 --gas auto --from $WALLET -y

Withdraw Rewards (Validator Commission)

xosd tx distribution withdraw-rewards <validator_address> --commission --chain-id $XOSD_CHAIN_ID --gas-prices 80000000000axos --gas-adjustment 1.5 --gas auto --from $WALLET -y

Unbond Tokens

xosd tx staking unbond <validator_address> <amount>axos --chain-id $XOSD_CHAIN_ID --gas-prices 80000000000axos --gas-adjustment 1.5 --gas auto --from $WALLET -y

Redelegate Tokens

xosd tx staking redelegate <source_validator_address> <destination_validator_address> <amount>axos --chain-id $XOSD_CHAIN_ID --gas-prices 80000000000axos --gas-adjustment 1.5 --gas auto --from $WALLET -y

4. Node Status & Info

Check Sync Status

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

Check Peer Info

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

Show Node ID

xosd tendermint show-node-id

Restart Node

sudo systemctl restart xosd

View Node Logs

sudo journalctl -u xosd -fo cat

5. Governance

List Proposals

xosd query gov proposals

View Proposal Details

xosd query gov proposal <proposal_id>

Vote on Proposal

xosd tx gov vote <proposal_id> <yes|no|no_with_veto|abstain> --chain-id $XOS_CHAIN_ID --gas-prices 80000000000axos --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 XOSD_CHAIN_ID="xos-testnet-1"
export XOSD_PORT="12"

Apply the changes with:

source ~/.bash_profile

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