QUACDocs

Tools

quacd CLI

quacd is the node, the wallet and the query tool in one binary. This page collects the commands you'll use most. Every command has --help.

Global flags

Flag Meaning
--home <dir> Node and keyring directory (default ~/.quacd)
--chain-id <id> quac-testnet-1, quac-devnet-1, …
--node tcp://host:26657 Which node to query or broadcast to (CometBFT RPC)
--keyring-backend os|file|test Where keys are stored
-o json JSON output

Keys

quacd keys add <name>                       # new ML-DSA-65 key (default on QUAC)
quacd keys add <name> --recover             # restore from mnemonic
quacd keys list
quacd keys show <name> -a                   # address
quacd keys show <name> --bech val -a        # quacvaloper… address of the same key
quacd keys export <name>                    # encrypted (armored) export
quacd keys delete <name>
quacd keys add shared --multisig a,b,c --multisig-threshold 2   # all members must be ML-DSA-65

Queries

quacd q bank balances <address>
quacd q bank total-supply
quacd q bank denom-metadata uquac
quacd q auth account <address>
quacd q tx <hash>
quacd q block --type=height <height>
quacd q mint inflation
quacd q mint annual-provisions
quacd q staking validators
quacd q staking delegations <address>
quacd q distribution rewards <address>
quacd q consensus params
quacd status

Transactions

Every transaction command takes the same fee flags. On QUAC, use:

--gas auto --gas-adjustment 1.4 --gas-prices 0.0025uquac
quacd tx bank send <from> <to> <amount>uquac
quacd tx staking delegate <quacvaloper…> <amount>uquac --from <name>
quacd tx staking unbond <quacvaloper…> <amount>uquac --from <name>
quacd tx distribution withdraw-all-rewards --from <name>
quacd tx gov submit-proposal proposal.json --from <name>
quacd tx gov vote <id> yes --from <name>

Offline signing

quacd tx bank send <from> <to> <amount>uquac --generate-only --offline \
  --account-number <n> --sequence <s> --chain-id quac-testnet-1 --fees 1000uquac --gas 400000 > unsigned.json
quacd tx sign unsigned.json --from <name> --offline --account-number <n> --sequence <s> --chain-id quac-testnet-1 > signed.json
quacd tx broadcast signed.json            # via --node, or:
quacd tx encode signed.json              # base64 for the REST broadcast endpoint

Node and genesis

quacd init <moniker> --chain-id <id>                     # ML-DSA-65 consensus key by default
quacd genesis add-genesis-account <address|key> <amount>uquac
quacd genesis gentx <key> <amount>uquac --chain-id <id>
quacd genesis collect-gentxs
quacd genesis validate
quacd start
quacd comet show-node-id
quacd comet show-validator                               # consensus pubkey (ML-DSA-65)
quacd comet unsafe-reset-all                             # wipe chain data, keep keys

Defaults that differ from other Cosmos chains

Other Cosmos chains QUAC
keys add --key-type secp256k1 ml_dsa_65
init --consensus-key-algo ed25519 ml_dsa_65
Address prefix cosmos quac
Denom stake uquac
Minimum gas price empty or 0stake 0.0025uquac

Edit this page on GitHub