Cross-Chain Token Wrap Helper

WHAT IT DOES

Cross-Chain Token Wrap Helper watches the current L2 bridge page for the user's connected wallet address and the token being bridged, reads the user's token balance and the wrapped token balance on the source and destination chains via eth_call, compares the gas costs of wrapping vs. bridging in native form, calculates the optimal wrap amount to minimize total cost, and displays recommendations with cost analysis and estimated final balances. The tool connects to the user's wallet via window.ethereum, detects the destination chain from the page URL, reads the user's native token balance, estimates the gas costs for wrapping and unwrapping operations, calculates the total cost difference between wrapping vs. bridging native tokens, and provides recommendations based on user preferences and cost savings.

WHERE IT RUNS

The tool runs as a panel inside your browser on L2 bridge pages at https://bridge.arbitrum.io/*, https://app.optimism.io/bridge/*, and https://app.hop.exchange/*. It works on the Arbitrum, Optimism, and Hop Protocol bridge interfaces where users can choose to wrap tokens before bridging. 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 the Arbitrum, Optimism, or Hop bridge page, and open the Cross-Chain Token Wrap Helper panel. Select your wrap preference from the dropdown — Auto, Always Wrap, or Never Wrap — to control the tool's recommendation behavior. Set your minimum wrap threshold in USD (default $100) — the tool will only recommend wrapping if the cost savings exceed this amount. Set your maximum acceptable gas price in Gwei (default 50). Select the token you wish to bridge from the dropdown — ETH, USDC, USDT, or DAI. Toggle "Auto-check on page load" if you want the tool to analyze automatically when you open the panel. Click "Analyze" — the tool detects the destination chain, reads your native token balance, fetches current gas prices, calculates the costs of wrapping vs. bridging, compares the two options, and displays a complete analysis with recommendations based on your preferences. Review the output and use the recommended option for manual execution through the bridge interface.

MECHANISM — WRAP VS BRIDGE COST COMPARISON WITH GAS PRICE ANALYSIS

This tool uses a wrap vs. bridge cost comparison engine that evaluates the most cost-effective way to move tokens across L2 chains. The system first connects to window.ethereum and requests the user's wallet address. It detects the destination chain from the page URL to determine the appropriate cost parameters. Using the ethers library loaded at runtime, the tool creates a Web3Provider connected to window.ethereum and reads the user's native token balance. It fetches current gas prices via provider.getGasPrice() and converts them to Gwei. The tool estimates the wrap cost (approximately 0.05% for ETH, 0.1% for tokens), the bridge cost (approximately 0.1% for ETH, 0.15% for tokens), and the gas cost (approximately 0.05% of the transaction value). It calculates the total cost for each option, compares them, and determines the cost difference. The recommendation algorithm applies the user's preference: Always Wrap forces a wrap recommendation, Never Wrap forces a bridge recommendation, and Auto compares the cost difference against the configured threshold to make a data-driven recommendation.

THE PANEL

The BotGentz panel is fully draggable, allowing you to position it anywhere on your screen without obstructing the bridge interface. It includes per-site position memory, so the panel returns to your preferred location each time you visit the bridge page. 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 bridging 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 bridging to Arbitrum, Optimism, and Hop Protocol. This is an analysis and planning tool only — it does not execute wrap or bridge transactions automatically. The tool cannot guarantee that gas prices remain stable at execution time due to network fluctuations. It cannot read token balances or contracts that are not accessible via window.ethereum. It cannot account for slippage or price differences between native and wrapped tokens. It cannot verify bridge contract state or availability. It cannot predict future gas price movements or optimal timing. It cannot read private wallet information or transaction intentions. 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 wrap and bridge details independently before executing any transactions.