DAO Proposal Countdown Overlay

WHAT IT DOES DAO Proposal Countdown Overlay watches the current DAO governance page for proposal identifiers or contract addresses, reads the proposal's status, voting periods, and deadlines from the governance contract on-chain, monitors for approaching voting windows and proposal expiration, calculates time remaining and displays a countdown with proposal details, and alerts the user when critical deadlines are approaching for proposals they are tracking. The tool extracts proposal IDs from the page URL or DOM, connects to the appropriate governance contract (Uniswap, Aave, or Yearn), queries the contract's proposals function via eth_call to read proposal data including the proposer address, start block, end block, and description, calculates the time remaining by comparing the end block against the current block number, and displays a live countdown with color-coded urgency indicators. It then triggers alerts when the remaining time falls below configurable thresholds, helping users stay informed about governance participation deadlines. WHERE IT RUNS The tool runs as a panel inside your browser on DAO governance pages at https://app.uniswap.org/*, https://app.aave.com/*, and https://app.yearn.fi/*. It works on any page within these domains that displays DAO proposal details. The tool connects to your real EVM wallet extension (MetaMask, WalletConnect, or any wallet injecting window.ethereum) to read on-chain data via eth_call and the ethers library loaded at runtime. No data is sent to any external server; all reads happen directly from the blockchain through your wallet provider. HOW TO USE Install the BotGentz extension, navigate to a DAO proposal page on Uniswap, Aave, or Yearn, and open the DAO Proposal Countdown Overlay panel. Set your alert threshold in hours (default 24) — the tool will alert you when a proposal has less than this much time remaining. Select your monitoring interval from the dropdown — 60, 120, 300, or 600 seconds. Choose your alert preference — Panel only, Browser notification, or Both. Click "Monitor Proposals" — the tool detects the proposal ID from the page URL, connects to the governance contract via ethers, reads the proposal's end block, calculates the time remaining using the current block number, and displays a live countdown on the panel. The countdown updates automatically every 10 seconds, and the panel refreshes at your chosen interval. When the remaining time drops below the configured threshold, the tool triggers an alert with urgency assessment. The alert log maintains a history of recent alerts for review. Click "Refresh" to manually check the proposal status, or "Clear History" to reset the alert log. MECHANISM — ON-CHAIN PROPOSAL QUERY WITH BLOCK-BASED COUNTDOWN CALCULATION This tool uses an on-chain proposal query engine that reads proposal data directly from governance contracts. The system first detects the proposal ID from the page URL using pattern matching (e.g., /proposal/123 or /123? format). It then identifies the appropriate governance contract address based on the current domain: Uniswap (0x408ED6354d4973f66138C91495F2f2FCbd8724C3), Aave (0xEC568fffba86c094cf06b22134B23074DFE2252c), or Yearn (0xFEB4acf3df3cDEA7399794D0869ef76A6EfAff52). Using the ethers library loaded at runtime, the tool creates a Web3Provider connected to window.ethereum and instantiates the governance contract with the proposals function ABI. It queries the contract using proposals(proposalId), which returns the proposer address, start block, end block, and description. The tool fetches the current block number via provider.getBlockNumber() and calculates the remaining blocks until the proposal ends. Using an average block time of 12 seconds, it converts the remaining blocks to seconds and formats the result as a human-readable countdown. The urgency assessment uses a tiered system: Critical (