Governance Proposal Alert

WHAT IT DOES

Governance Proposal Alert watches the current page for DAO governance proposals, reads the proposal details, status, voting deadlines, and current vote counts from the governance contracts, and triggers alerts when a proposal is created, when the user's followed proposals are about to end, or when a proposal reaches a significant vote milestone (e.g., quorum met or passing threshold crossed). It keeps you informed about critical governance events without manually checking proposal pages.

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 follow in the "Proposals to Follow" section. Configure your alert settings: toggle which alert types you want (new proposal, deadline approaching, vote milestone), set the reminder timing (1 hour, 6 hours, or 24 hours before deadline), set the milestone threshold percentage, and toggle desktop notifications on or off. Click "Connect & Start Monitoring" to connect your real wallet extension, which will begin monitoring the proposals. The panel displays your voting power and the number of proposals being followed.

TECHNICAL OPERATION

Governance Proposal Alert 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, getVotes, and proposalCount to fetch proposal data. It tracks the user's voting power and checks each followed proposal for three alert conditions: new proposal creation (by monitoring proposalCount), approaching deadlines (when time remaining falls below the configured threshold), and vote milestones (when vote counts reach a user-defined percentage of quorum or passing threshold). The tool uses setInterval for automatic refreshes based on the user-defined interval and maintains an alert tracking system to avoid duplicate notifications.

THE PANEL

The Governance Proposal Alert 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 or discussions, cannot vote on the user's behalf, and cannot predict proposal outcomes. 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.