WalletConnect Session Manager

WHAT IT DOES

WalletConnect Session Manager watches the current page for WalletConnect session activity, reads the current session status, connected wallet address, and network from the page's WalletConnect integration, and provides an interface to manage active sessions, disconnect sessions, and view session details including chain, permissions, and peer metadata. It helps you monitor and manage your WalletConnect connections across different dApps.

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

HOW TO USE

Click "Connect & Check" to connect your real wallet extension and detect any active WalletConnect session. The panel displays session details including connection status, connected account, network, dApp name and URL, session expiry, and permissions. Use "Refresh Session" to update the session status. The settings allow you to configure session timeout warnings, enable auto-disconnect for idle sessions, and toggle desktop notifications. The panel shows detailed session information including peer metadata (dApp name, URL), session ID, expiry time, and available permissions.

TECHNICAL OPERATION

WalletConnect Session Manager uses raw JSON-RPC calls via window.ethereum.request() to interact with the wallet extension. It reads the connected account using eth_accounts and the network chain ID using eth_chainId. The tool detects WalletConnect sessions by checking window.ethereum for WalletConnect-specific properties (isWalletConnect, wc), and by scanning localStorage for WalletConnect session data. It extracts peer metadata including dApp name, URL, and description from the WalletConnect provider or stored session data. The tool also reads session details including session ID, expiry time, and available permissions/methods. It listens for accountsChanged and chainChanged events to keep the status updated in real-time. The session details display includes the active wallet address, network, dApp information, session expiry countdown, and permission list.

THE PANEL

The WalletConnect Session Manager 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 manage sessions that are not initiated through the page's WalletConnect provider, cannot view session data from other wallet extensions, cannot disconnect a session programmatically without user interaction in the wallet extension, and cannot track sessions across multiple tabs or devices. No private keys are stored or transmitted—all session management happens through your wallet extension's native interface. Always verify the dApp URL and permissions before connecting.