Undercollateralized Warning Overlay

WHAT IT DOES

Undercollateralized Warning Overlay watches the current Aave dashboard page for the user's loan positions, reads the user's supplied assets and borrowed assets from the LendingPool contract, monitors current collateralization ratio and health factor, calculates liquidation price levels and risk margin, and displays a visual warning overlay with risk level and recommended actions when the user approaches an undercollateralized state. The tool extracts the user's wallet address, queries the LendingPool contract via getUserAccountData to read total collateral in ETH, total debt in ETH, current health factor, and liquidation threshold. It then compares the health factor against user-defined thresholds, calculates the collateralization ratio, and determines the risk level — Safe, Warning, or Critical. When the health factor drops below the warning threshold, the tool displays a prominent visual warning, plays an alert sound, and sends browser notifications. It also provides actionable recommendations including repaying debt, adding collateral, or closing positions.

WHERE IT RUNS

The tool runs as a panel inside your browser on Aave dashboard pages at https://app.aave.com/*. It works on any Aave V2 or V3 dashboard page where the user can view their supplied and borrowed assets. The tool connects directly to your real EVM wallet extension (MetaMask, WalletConnect, or any wallet injecting window.ethereum) to read on-chain data via eth_call. No data is sent to any external server — all reads happen directly from the Ethereum blockchain through your wallet provider.

HOW TO USE

Install the BotGentz extension, navigate to your Aave dashboard, and open the Undercollateralized Warning Overlay panel. Set your warning threshold health factor (default 1.3) — the tool will trigger warnings when your health factor falls below this value. Toggle "Play alert sound" to enable audio alerts when a warning is triggered. Select your notification preference — Panel only, Browser notification, or Both. Choose your auto-refresh interval from the dropdown (10, 30, 60, or 120 seconds). Click "Monitor Position" — the tool reads the Aave LendingPool contract for your position data, calculates your health factor and risk level, and displays a comprehensive status report with a color-coded risk level indicator and specific recommendations. The tool continues monitoring at the selected refresh interval, updating the display and triggering alerts automatically when conditions change.

MECHANISM — REAL-TIME AAVE POSITION MONITORING WITH HEALTH FACTOR ANALYSIS

This tool uses a real-time Aave position monitoring engine that directly queries the protocol's LendingPool contract. The system first connects to window.ethereum to get the user's wallet address, then uses ethers to create a Web3Provider. It queries the LendingPool contract (0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9) using the getUserAccountData function, which returns total collateral in ETH, total debt in ETH, available borrows in ETH, current liquidation threshold, loan-to-value ratio, and health factor. The health factor is calculated by the protocol as (total collateral * liquidation threshold) / total debt, and is returned as a value scaled by 1e18. The tool converts this to a human-readable decimal, compares it against the user-defined threshold, and determines the risk level. It also calculates the collateralization ratio (total collateral / total debt) and derives liquidation price levels from the collateralization ratio and liquidation threshold. The tool includes a multi-tier alert system: visual panel updates with color-coded risk indicators, audio alerts via Web Audio API oscillator, and browser notifications through GM_notification. This client-side, non-custodial approach ensures privacy and security, with all data read directly from the blockchain through the user's own wallet.

THE PANEL

The BotGentz panel is fully draggable, allowing you to position it anywhere on your screen without obstructing the Aave interface. It includes per-site position memory, so the panel returns to your preferred location each time you visit the dashboard. Snap-to-edge functionality lets you dock the panel to any side of the browser window. The panel collapses to a compact icon when not in use and expands with a single click. You can resize it to your preferred dimensions, and pressing the Escape key instantly closes the panel. All interactions are smooth and intuitive, designed to work alongside your DeFi position management workflow.

PLEASE NOTE

This tool requires the free BotGentz extension and a real EVM wallet extension (such as MetaMask) already installed in your browser. EVM chains only — currently supports Ethereum mainnet and compatible networks. This is a monitoring and warning tool only — it does not execute liquidation prevention transactions automatically. The tool cannot guarantee real-time price feeds due to oracle update latency. It cannot account for flash loan attacks or rapid price movements that may liquidate positions before warnings are displayed. It cannot detect off-chain collateral or cross-protocol positions that affect overall health. It cannot read positions from protocols other than Aave V2/V3. It cannot prevent liquidation if the user does not take action. All blockchain reads are performed directly through your wallet provider; no data is stored or transmitted beyond your browser. Websites change their layouts and content structures regularly; while we continuously update the extraction logic, some pages may require script updates. Always verify all position details and risk levels directly on-chain before taking any action.