Concepts
This page defines the terms the rest of the docs use. If you already know Cosmos SDK chains, skim the ML-DSA-65 sections and move on.
ML-DSA-65
ML-DSA (Module-Lattice-Based Digital Signature Algorithm) is the signature scheme NIST standardized in FIPS 204 (August 2024). It was previously known as CRYSTALS-Dilithium. Its security rests on the hardness of lattice problems (Module-LWE and Module-SIS), which no known quantum algorithm solves efficiently.
The "65" is the parameter set. ML-DSA-65 targets NIST security category 3, roughly the strength of AES-192.
| ML-DSA-65 | Ed25519 | secp256k1 (ECDSA) | |
|---|---|---|---|
| Public key | 1,952 bytes | 32 bytes | 33 bytes (compressed) |
| Signature | 3,309 bytes | 64 bytes | 64 bytes |
| Private key | 4,032 bytes | 32 bytes | 32 bytes |
| Broken by Shor's algorithm | No | Yes | Yes |
The size difference matters on a blockchain, which stores every signature forever. Accounts and transactions covers what it means for fees and block size.
Accounts and addresses
An account is controlled by an ML-DSA-65 key pair. Its address is the first 20 bytes of SHA-256 of the public key, written in Bech32 with the prefix quac:
quac1z8qt7x6nys0wdc638pyqgj4cw7m96l2n32vcnq
The public key itself goes on chain the first time the account sends a transaction. Anyone can send coins to an address before that, so receiving needs no key on chain.
Validators and consensus
QUAC uses CometBFT, a Byzantine-fault-tolerant consensus engine. Validators take turns proposing blocks and vote on each one in two rounds (prevote, precommit). A block is final once validators holding more than two thirds of the voting power have precommitted. There are no forks or reorganizations after that.
Voting power comes from staked QUAC: a validator's own stake plus what other holders delegate to it. Every vote is signed with the validator's consensus key, which on QUAC must be ML-DSA-65.
Coins and denominations
| Unit | Value | Used where |
|---|---|---|
uquac |
1 | On chain: balances, fees, amounts in transactions |
QUAC |
1,000,000 uquac |
Wallets, explorer, these docs |
uquac is "micro-QUAC". Amounts on the command line are always in uquac, so 250000000uquac means 250 QUAC.
Minting
New QUAC comes from two sources only:
- Genesis allocation: balances written into the genesis file before the first block.
- Block rewards: the
x/mintmodule issues new coins each block, and the distribution module pays them to validators and their delegators.
Issuance stops permanently at the supply cap. See Monetary policy.
Gas and fees
Every transaction pays a fee: gas used × gas price. Gas measures work: bytes stored, state reads and writes, and signature checks. Nodes refuse transactions priced below their minimum gas price, which defaults to 0.0025uquac per unit of gas on QUAC. A typical transfer uses about 285,000 gas, so its fee is about 0.0008 QUAC.
Networks
| Network | Chain ID | What it is |
|---|---|---|
| Devnet | quac-devnet-1 |
One node on your machine, created by scripts/devnet.sh. |
| Public testnet | quac-testnet-1 |
Four Dyber validators. Test coins come from the faucet. May be reset. |
| Mainnet | — | Not launched. |