QUACDocs

Getting started

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:

  1. Genesis allocation: balances written into the genesis file before the first block.
  2. Block rewards: the x/mint module 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.

Edit this page on GitHub