Trusted Contract Allowlist Manager

WHAT IT DOES

Trusted Contract Allowlist Manager is your personal contract security tool that helps you track which contracts you trust. It intercepts pending transaction details from confirmation pages, detects the target contract address, and checks it against your personal allowlist of trusted contracts. The tool displays a CLEAN status when the contract is on your allowlist and a FLAGGED status when the contract is unknown. It provides a full-featured allowlist management interface with add, remove, edit, search, and export functionality, supports importing known trusted contracts from curated sources, displays allowlist statistics and recent additions, sends alerts when interacting with non-allowlisted contracts, and provides one-click add from the current page.

WHERE IT RUNS

This script runs on all major DEX interfaces including Uniswap (app.uniswap.org), SushiSwap (app.sushi.com), Curve (curve.fi), Balancer (balancer.fi), 1inch (1inch.io), CowSwap (cow.fi), and major NFT marketplaces including OpenSea (opensea.io), Blur (blur.io), LooksRare (looksrare.org), Zora (zora.co), Rarible (rarible.com), and Foundation (foundation.app). It works on transaction confirmation pages, wallet approval dialogs, and any page displaying pending transaction details.

HOW TO USE

Install the script through the BotGentz userscript manager. Click "Connect Wallet" to link your EVM wallet extension. Navigate to any supported DEX or marketplace. The panel provides a complete allowlist management dashboard. To add a trusted contract, enter its address and name in the management section, or click "Add Current Contract" to trust the contract currently detected on the page. The tool comes pre-populated with a curated allowlist of major protocol contracts (Uniswap, SushiSwap, 1inch, CowSwap, Balancer, Curve, OpenSea, Blur). Your allowlist is automatically saved locally. Use the search bar to quickly find entries. Export your allowlist as JSON for backup or sharing, and import previously exported allowlists. The tool automatically checks pending transactions against your allowlist and sends alerts when interacting with unknown contracts.

CURATED AND USER-MANAGED ALLOWLIST DATABASE WITH COMPLETE CRUD OPERATIONS

Unlike simple contract viewers that only show addresses, this tool gives you full ownership of your trusted contract database through a persistent allowlist with complete CRUD (Create, Read, Update, Delete) operations. The database comes pre-populated with a curated list of widely trusted protocol addresses (Uniswap V2/V3 routers, SushiSwap, 1inch, CowSwap, Balancer V2, Curve, OpenSea, Blur) with proper names and source attribution. Each entry stores the contract address (normalized to lowercase), a user-friendly name, timestamp of addition, and source attribution (curated or user). The management interface provides real-time search across all entries, allowing you to quickly verify if a contract is already trusted. The import/export functionality uses JSON format, enabling easy backup, transfer between browsers, or sharing with trusted parties. The auto-check feature continuously monitors the current page for contract addresses and instantly alerts you if an unknown contract is detected, providing immediate security awareness during transaction confirmation.

THE PANEL

The floating panel is fully draggable and snap-to-edge enabled. You can collapse it to a compact bubble when not in use, resize it to your preferred dimensions, and it remembers its position across page loads using persistent storage. Press Escape to quickly dismiss the panel. The panel displays your wallet status, total allowlist entries, curated vs user count, auto-check status, current contract status, and recent allowlist entries with their names.

PLEASE NOTE

This script requires the free BotGentz extension to be installed in your browser—it does not run as a standalone extension. You also need a real EVM wallet extension already installed and configured for transaction interception. The allowlist is local only and not shared unless exported. The tool relies on the page exposing contract address in a detectable format and cannot automatically verify contract security. Lack of allowlist entry does not necessarily indicate a scam. No user data is collected or transmitted—all allowlist data stays local in your browser storage. The tool provides personal trust management but does not guarantee the security of any contract on the allowlist.