Governance Deadline Countdown

WHAT IT DOES

Governance Deadline Countdown watches the current page for DAO governance proposals, reads the proposal details, voting deadlines, and status from the governance contracts, and displays a real-time countdown timer overlay showing the time remaining until each proposal's voting deadline, with visual alerts when deadlines are approaching. It keeps you informed about critical voting windows and helps you never miss a governance deadline.

WHERE IT RUNS

This tool operates as a userscript within the BotGentz extension framework, running directly in your browser on any website. It works on any EVM-compatible blockchain page—Ethereum, Polygon, Arbitrum, Optimism, and more—where DAO governance contracts are deployed. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you monitor governance activities.

HOW TO USE

Enter your DAO governance contract address in the "Governance Setup" section. Add the proposal IDs you want to track in the "Proposals to Track" section (comma-separated). Configure your display settings: choose your preferred countdown format (Compact, Full, or Standard), set the refresh interval, and toggle deadline notifications on or off. Click "Connect & Start Countdown" to connect your real wallet extension, which will begin displaying real-time countdowns for each tracked proposal. The panel shows each proposal's ID, status, and time remaining, updating every second. Use "Refresh Now" for an immediate data refresh, or "Stop Countdown" to disconnect.

TECHNICAL OPERATION

Governance Deadline Countdown uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain—no external library required for basic operations. It loads ethers at runtime using a simple script tag injection for ABI encoding and contract interactions. The tool reads the governance contract using view functions including state, proposalDeadline, and proposals to fetch proposal data and deadlines. It calculates the time remaining by comparing the deadline timestamp with the current time, and displays it in real-time using setInterval for second-by-second updates. The tool checks for approaching deadlines at three checkpoints (24 hours, 6 hours, and 1 hour) and sends notifications when these thresholds are crossed. Visual alerts are displayed in the panel with color-coded timers (green for safe, yellow for approaching, red for critical).

THE PANEL

The Governance Deadline Countdown panel is fully draggable and remembers its position between sessions using GM_setValue. It snaps to the edge of the viewport for a clean interface and can be collapsed to a small icon when not in use. The panel is resizable to accommodate longer content. Press Escape to quickly close or collapse the panel. The design is optimized for productivity with a dark theme, clear visual hierarchy, and responsive controls that adapt to your workflow.

PLEASE NOTE

This tool requires the free BotGentz extension installed in your browser and a real EVM wallet extension (MetaMask, Rabby, etc.) already installed. EVM chains only—this does not work on non-EVM blockchains. The tool cannot read governance data if the contract does not expose the required view functions, cannot detect off-chain proposal data, and cannot predict deadline changes. No private keys are stored or transmitted—all data is read-only from the blockchain. Always verify the governance contract address and proposal IDs before starting monitoring.