🏛️ DAO Governance Tracker

Monitor DAO proposals & voting activity across Uniswap, Aave, Compound, MakerDAO & Gitcoin with real-time Telegram alerts — powered by Snapshot API + Tally API.

---

🔍 What is DAO Governance Tracking?

DAO governance tracking monitors on-chain and off-chain voting proposals from decentralized protocols — helping DeFi participants stay informed about protocol changes before they pass and affect token prices or protocol rules.

This bot tracks governance using:

• 📸 Snapshot API — free off-chain governance data (no API key needed)
• 🗳️ Tally API — on-chain Governor Bravo proposals
• 🏛️ 5 Major DAOs — Uniswap, Aave, Compound, MakerDAO, Gitcoin

---

✨ Features

• 📋 Active Proposals — fetch open voting proposals per DAO
• 🗳️ Vote Breakdown — For/Against/Abstain with percentage bars
• 🔔 New Proposal Alerts — instant Telegram alert on new proposals
• ⚠️ Deadline Alerts — notify when voting ends in < 24 hours
• 📊 DAO Summary — followers, total proposals, votes stats
• 👥 Top Voters — see who voted and how
• 🏆 Top Active — all active proposals sorted by urgency
• 📡 Auto Monitor — background polling every 5 minutes
• 🤖 Telegram Bot — 9 interactive commands

---

🚀 Quick Start

1. Install dependencies

pip install requests

2. Set API keys

Open dao_governance_tracker.py and configure:

TELEGRAM_TOKEN   = "your_telegram_bot_token"
TELEGRAM_CHAT_ID = "your_chat_id"

No additional API keys needed — Snapshot API is free and open!

3. Run as Telegram Bot

python dao_governance_tracker.py

4. Quick CLI check (one-time)

python dao_governance_tracker.py check uniswap
python dao_governance_tracker.py check aave

---

🤖 Telegram Commands

Command	Description
/gov_proposals <dao>	Active proposals for a DAO
/gov_proposal <id>	Proposal detail + top voters
/gov_add <dao>	Add DAO to watchlist
/gov_remove <dao>	Remove DAO from watchlist
/gov_list	Show watched DAOs
/gov_summary <dao>	DAO overview & stats
/gov_daos	List all available DAOs
/gov_monitor on/off	Toggle auto monitoring
/gov_top	All active proposals by urgency

---

📊 Sample Output

🦄 Uniswap Governance
━━━━━━━━━━━━━━━━━━━━━━
📋 Deploy Uniswap V3 on X Chain

🟢 Status  : ACTIVE
📡 Source  : Snapshot
👤 Author  : 0x1a2b3c...

📊 Vote Breakdown:
- For             ██████████ 78.4%
- Against         ██░░░░░░░░ 18.2%
- Abstain         ░░░░░░░░░░  3.4%

🏆 Leading: For (78.4%)
🎯 Quorum : 82.3%
⏰ Ends in : 2d 14h

🗳️ Votes   : 1,247
🔗 View Proposal

---

🚨 Alert System

Alert	Trigger
🔔 New Proposal	New active proposal detected
⚠️ Deadline Alert	Voting ends in < 24 hours

---

🏗️ Architecture

dao_governance_tracker.py
├── SnapshotClient      → Snapshot GraphQL API (off-chain)
│   ├── get_proposals()       → fetch active/closed proposals
│   ├── get_proposal_detail() → single proposal full data
│   ├── get_votes()           → top voters per proposal
│   └── get_space_info()      → DAO followers & stats
├── TallyClient         → Tally GraphQL API (on-chain)
│   └── get_proposals()       → Governor Bravo proposals
├── GovernanceAnalyzer  → Core tracking engine
│   ├── fetch_proposals()     → fetch + format for one DAO
│   ├── fetch_all_watched()   → scan all watched DAOs
│   ├── check_new_proposals() → detect unseen proposals
│   ├── check_ending_soon()   → detect deadline < 24h
│   └── get_dao_summary()     → DAO stats overview
└── GovernanceBot       → Telegram bot with 9 commands
    └── _monitor_loop()       → background polling thread

---

📡 Data Sources

Source	Usage
Snapshot API	Off-chain governance (no API key)
Tally API	On-chain Governor proposals

---

🏛️ Supported DAOs

DAO	Token	Governance Type
🦄 Uniswap	UNI	Snapshot + Governor Bravo
👻 Aave	AAVE	Snapshot + Aave Gov V2
🏦 Compound	COMP	Snapshot + Governor Alpha
Ⓜ️ MakerDAO	MKR	Snapshot + DSChief
🌱 Gitcoin	GTC	Snapshot + Governor Bravo

---

⚙️ Configuration

Variable	Default	Description
POLL_INTERVAL	300s	How often to check proposals
DEADLINE_ALERT_HOURS	24h	Hours before deadline to alert
MIN_QUORUM_ALERT	50%	Quorum percentage to alert

---

⚠️ Disclaimer

This tool is for informational purposes only. Always do your own research before participating in governance votes.

---

🔧 Requirements

requests>=2.28.0

No Web3.py required — uses REST/GraphQL APIs only!

---

👤 Author

Rizal — @rizalcodes

Building Web3 tools with Python 🐍⛓️

---

📄 License

MIT License — free to use, modify, and distribute.