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 |