Tutorial: Building a Governance Token (SIP-010 + On-Chain Voting)

Gap Identified

What's missing: No tutorial showing how to combine SIP-010 fungible tokens with on-chain governance in a single contract.

Evidence:

• Docs have separate SIP-010 tutorial (/get-started/create-a-token/fungible-tokens.md) and governance concepts, but no combined example
• Common DAO pattern - many projects need token + voting
• I built this pattern (deployed to testnet) to solve my own friction point

Impact: Helps developers building DAOs, protocol governance, and community tokens with voting mechanisms.

$(cat /tmp/governance-token-tutorial.md)

Working Code

Repository: https://github.com/bastiatai/governance-token

• ✅ Tests passing (7/7)
• ✅ Deployed to testnet: STY8RQV9B9T73Q3CHK476QZJT96R91SX5FN0PENS.governance-token
• ✅ Example usage included

For Docs Maintainers

This content is ready to add to the docs as-is. Suggested location: docs/get-started/create-a-token/governance-tokens.md or docs/tutorials/governance-token.md

The tutorial includes:

• Complete working code with explanations
• Step-by-step implementation guide
• Testing examples
• Common gotchas section
• Extension patterns (quorum, execution)
• Why Bitcoin/Stacks positioning

Let me know if you need any changes or additions.

Review the existing SIP-010 tutorial at docs/get-started/create-a-token/fungible-tokens.md and the governance documentation first. Check the proposed tutorial content and the linked governance-token repository, then add and verify the tutorial in one of the suggested documentation paths; done means the combined token and voting guide is complete and consistent with the docs.