Hippo Protocol

Archived

Hippo Protocol is a Layer 1 healthcare blockchain enabling secure, HIPAA-compliant data sharing for AI, DeSci, and medical research.

Hippo Cheat Sheet and Key Management

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

1. Key Management

Create a New Wallet

hippod keys add $WALLET

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

Recover Wallet from Seed Phrase

hippod keys add $WALLET --recover

You will be prompted to enter your seed phrase.

List Wallets

hippod keys list

Show Wallet Details

hippod keys show $WALLET

Delete Wallet

hippod keys delete $WALLET

2. Wallet Operations

Check Balance

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

Send Tokens

hippod tx bank send $(hippod keys show $WALLET -a) <receiver_wallet_address> <amount><denom> --chain-id $HIPPO_CHAIN_ID --gas-prices 0.0001ahp --gas-adjustment 1.5 --gas auto -y

Example:

hippod tx bank send $(hippod keys show $WALLET -a) hippo1...yyy 1000000ahp --chain-id $HIPPO_CHAIN_ID --gas-prices 0.0001ahp --gas-adjustment 1.5 --gas auto -y

Replace <amount> with the number of tokens and <denom> with the token denomination (e.g., ahp).

3. Validator Management

Ensure you have enough ahp tokens for self-delegation and transaction fees before creating a validator.

Create Validator

Configuration

Amount

Moniker

Identity

Website

Contact

Details

Commission

Chain

Generated Command

cat <<EOF > /root/.hippo/validator.json
{
  "pubkey": {
    "@type": "/cosmos.crypto.ed25519.PubKey",
    "key": "$(hippod tendermint show-validator | grep -Po '"key":s*"K[^"]*')"
  },
  "amount": "1000000000000000000ahp",
  "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
hippod tx staking create-validator /root/.hippo/validator.json \
  --from=$WALLET \
  --chain-id=hippo-protocol-1 \
  --gas=auto \
  --gas-adjustment=1.4 \
  --fees 154141500000000000ahp \
  --home ~/.hippo \
  -y

Parameter Explanation:

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

hippod 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 $HIPPO_CHAIN_ID \
--gas-prices 1000000000000ahp \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Delegate Tokens

hippod tx staking delegate $(hippod keys show $WALLET --bech val -a) <amount>ahp \
  --chain-id $HIPPO_CHAIN_ID \
  --gas-prices 1000000000000ahp \
  --gas-adjustment 1.5 \
  --gas auto \
  --from $WALLET \
  -y

Withdraw Rewards (Delegator)

hippod tx distribution withdraw-rewards $(hippod keys show $WALLET --bech val -a) \
--chain-id $HIPPO_CHAIN_ID \
--gas-prices 1000000000000ahp \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Withdraw Rewards (Validator Commission)

hippod tx distribution withdraw-rewards $(hippod keys show $WALLET --bech val -a) --commission \
--chain-id $hippod_CHAIN_ID \
--gas-prices 1000000000000ahp \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Unbond Tokens

hippod tx staking unbond $(hippod keys show $WALLET --bech val -a) <amount>ahp \
--chain-id $HIPPO_CHAIN_ID \
--gas-prices 1000000000000ahp \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

Redelegate Tokens

hippod tx staking redelegate $(hippod keys show $WALLET --bech val -a) <destination_validator_address> <amount>ahp \
--chain-id $HIPPO_CHAIN_ID \
--gas-prices 1000000000000ahp \
--gas-adjustment 1.5 \
--gas auto \
--from $WALLET \
-y

4. Node Status & Info

Check Sync Status

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

Check Peer Info

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

Show Node ID

hippod tendermint show-node-id

Restart Node

sudo systemctl restart hippod

View Node Logs

sudo journalctl -u hippod -fo cat

5. Governance

List Proposals

hippod query gov proposals

View Proposal Details

hippod query gov proposal <proposal_id>

Vote on Proposal

hippod tx gov vote <proposal_id> <yes|no|no_with_veto|abstain> \
--chain-id $HIPPO_CHAIN_ID \
--gas-prices 1000000000000ahp \
--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 HIPPO_CHAIN_ID="hippo-protocol-1"
export HIPPO_PORT="10"

Apply the changes with:

source ~/.bash_profile

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