Overview
Cardano Governance Docs is developer documentation that shows programmers how to build staking and voting features into an app. It walks through the working code for delegating ADA to a stake pool, claiming rewards, registering as a DRep (a delegate who votes on behalf of ADA holders)1, casting votes2, and putting a proposal on the blockchain2. The pages state their own limit plainly: this is about building those features, not operating a pool or taking part by hand3.
Published by the Cardano Foundation, it is the fourth of seven modules in the learning path on the Cardano Developer Portal, which runs from a first transaction through to a finished application4. It assumes a reader can already build transactions and handle native tokens. People who simply want to delegate their own vote or read the constitution are sent to the separate Cardano governance hub instead3.
Key Features
- Runnable code for each staking step. Registering a stake address, delegating to a pool, withdrawing rewards, and closing the address again each come with working examples, shown side by side in the Evolution SDK, the Mesh SDK (prebuilt libraries), and cardano-cli, Cardano's command-line tool56.
- The mistakes that lose rewards, spelled out. Rewards have to be withdrawn before a stake address is closed or they are gone, and a withdrawal is all or nothing, so no partial amount can be taken out65.
- A map of how Cardano voting works. The governance pages name the three groups that vote, list the seven governance action types that can be put on-chain, and explain that each type has its own mix of approval thresholds7.
- What to do when a wallet lacks governance support. Voting features reach a browser wallet through CIP-95, an optional add-on to Cardano's standard wallet connector, and the pages tell builders to handle wallets that decline it8.
- Concepts first, then code. Cardano Governance Docs opens each half with a plain explanation, staking reduced to five steps and governance to its voting groups and proposal types, before the hands-on pages fill in the detail97.
What to Expect
Cardano Governance Docs opens on a short page that reads like a table of contents: two explanation pages, four hands-on pages, and an appendix, each with a line saying what it covers3.
Developers arriving from earlier modules will find the format familiar. Each hands-on page presents the same operation in tabs, one for the Evolution SDK, one for the Mesh SDK, and one for cardano-cli, so you pick the toolkit you already use rather than translating from someone else's. SDKs here are prebuilt libraries that handle the fiddly parts of assembling a transaction5.
The pages assume a working setup: a key for a data provider, a test wallet, and enough familiarity to send transactions on a test network5. Timing questions get answered too, including why a fresh delegation earns nothing for the first three or four epochs, roughly 15 to 20 days, after which rewards arrive each epoch9.
Anyone can propose a fix. The portal is open source under an MIT license, pages carry an edit link into the GitHub repository10, and the contribution guide describes the quick route as editing the file in the browser and opening a pull request11.
