Onchain Atlas

Token Governance

The system of rules and contracts that let token holders vote to change how a protocol operates.

Also called: onchain governance · protocol governance · DAO voting

What it is

Token governance is the overall process — not just the token itself — by which a decentralized protocol makes collective decisions: proposing changes, voting on them, and executing the results. It's the "constitution and legislature" layer sitting on top of a governance token, defining who can propose what, how votes are counted, and what happens once a vote passes.

How it works

  1. The protocol deploys a governance module (commonly a fork of Compound's GovernorBravo or OpenZeppelin's Governor) alongside the token contract.
  2. Any address holding tokens above a proposal threshold can submit a proposal: typically calldata describing exact contract calls to execute (e.g., "call setInterestRate(0.05e18) on the lending pool").
  3. A voting delay passes before voting opens, so the community can review the proposal text and calldata rather than be surprised by it.
  4. During the voting period, token holders (or their delegates) cast for/against/abstain votes weighted by their token balance at a fixed snapshot block.
  5. If the vote clears quorum and a majority (or supermajority) threshold, it moves to a timelock queue — a mandatory waiting period before execution.
  6. After the timelock expires, anyone can trigger execution, and the timelock contract calls the target functions directly, changing protocol parameters, moving treasury funds, or upgrading contracts.
  7. Many protocols add guardrails: a security council or multisig empowered to veto or expedite in emergencies, and separate processes for smaller "temperature check" polls off-chain (e.g., Snapshot) before committing to a binding onchain vote.

Why designers use it

  • Splits protocol changes into a transparent, auditable proposal-vote-execute pipeline instead of relying on a single admin.
  • Timelocks give users an exit window before contested or malicious changes take effect.
  • Off-chain signaling (temperature checks) lets a community gauge sentiment cheaply before committing gas and legitimacy to a binding vote.
  • Scales decision-making as a protocol grows past the point where its founding team can or should decide everything unilaterally.

Failure modes

  • Low turnout means a handful of large or coordinated holders decide outcomes that affect everyone — many DAO votes pass with single-digit percentage participation.
  • Proposal complexity: voters are asked to approve raw calldata they can't easily verify does what the description says, opening room for malicious or buggy proposals to slip through.
  • Timelock bypass: if the timelock delay is too short, or an emergency multisig has broad override powers, the "safety window" is illusory.
  • Governance capture: delegate markets (paying for delegated votes) or vote-buying schemes can shift outcomes away from genuine community preference.
  • Forked/legacy code: many protocols copy governance contracts from other projects without auditing them for their specific parameter changes, inheriting bugs or mismatched thresholds.

What to check before using it

  • What is quorum set to, and is it realistic given typical turnout, or so low that a small group can pass anything?
  • Is there a public, human-readable diff or simulation of what a proposal's calldata actually does before the vote?
  • How long is the timelock, and can any privileged address shorten or skip it?
  • Who holds emergency powers (pause, veto, upgrade), and are those powers themselves subject to governance oversight?
  • Is voting power delegate-friendly, so passive holders aren't forced to either vote directly or abstain entirely?

Experiments that used it · 5

Shown oldest first, so you can watch the design evolve.

dYdX
Decentralized perpetuals exchange that migrated from Ethereum L1 margin trading to a StarkEx L2 orderbook and finally to its own Cosmos appchain, testing whether a CEX-grade orderbook can be progressively decentralized.
2017 partial success
Compound (lending)
Algorithmic pooled money market on Ethereum whose cToken model and June 2020 COMP liquidity-mining launch set the template for DeFi lending and ignited 'DeFi Summer'.
2018 major success
Neutrino USD (USDN)
Waves-native algorithmic stablecoin backed by WAVES collateral and 15% staking yields that depegged dozens of times, helped strand ~$500M of bad debt on Vires Finance, and was finally converted into the non-pegged index token XTN in 2023.
2019 failed
Goldfinch
Undercollateralized real-world credit protocol that lent stablecoins to fintech lenders in emerging markets via a tranched 'trust through consensus' model, originated $100M+ in loans, then wound down in 2026 after multi-year borrower defaults.
2021 failed
Pyth Network
A first-party financial oracle where exchanges, market makers, and trading firms publish their own prices directly on-chain, aggregated into a confidence-weighted feed that apps pull on demand instead of paying for constant push updates.
2021 ongoing