Wallet Session Timeout Warning

WHAT IT DOES

Wallet Session Timeout Warning watches the current page for wallet session activity, reads the current session status and idle time from window.ethereum, and triggers a warning notification when the session is about to timeout or has been idle for a user-defined period, with options to extend the session or reconnect. It helps you avoid losing access to dApps due to session timeouts.

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 wallet sessions are used. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you monitor your wallet session.

HOW TO USE

Click "Connect & Monitor" to connect your real wallet extension and start monitoring the session. The panel displays the current session status (Active, Idle, or Disconnected) and shows time remaining before idle timeout. Configure your session settings: set the idle timeout warning threshold (how long before warning), the expiry warning threshold (how long before session expiry warning), toggle auto-extend on or off, and toggle desktop notifications on or off. Use "Reset Activity" to manually reset the idle timer, or "Check Session" to refresh the session status. The panel automatically updates every 30 seconds and tracks user activity (clicks, keypresses, scrolling, mouse movement) to reset the idle timer.

TECHNICAL OPERATION

Wallet Session Timeout Warning uses raw JSON-RPC calls via window.ethereum.request() to interact with the wallet extension. It reads the connected account using eth_accounts to determine if a session is active. The tool tracks user activity on the page using DOM event listeners (click, keydown, scroll, mousemove) to reset the idle timer. It compares the time since the last activity against the user-configured idle timeout threshold and triggers notifications when the session is idle for too long. The tool also attempts to detect session expiry if the wallet extension exposes it (e.g., through provider properties). When a warning threshold is crossed, the tool sends a desktop notification and displays a warning in the panel. Auto-extend, when enabled, simulates activity to keep the session alive. The panel updates every 30 seconds via setInterval.

THE PANEL

The Wallet Session Timeout Warning 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 the exact session timeout if the wallet extension does not expose it, cannot detect idle time if the wallet extension does not track it, cannot automatically extend a session without user interaction, and cannot prevent session timeout if the wallet extension enforces it. No private keys are stored or transmitted—all session monitoring is read-only. Always verify your session status in your wallet extension.