Web3 Connector

WHAT IT DOES

Web3 Connector is a diagnostic tool that displays your wallet connection status, network information, and available Web3 providers. It shows whether your wallet is connected, your wallet address, the current chain ID, the detected provider type (MetaMask, Coinbase Wallet, WalletConnect, or other EIP-1193 compatible providers), and the current block number. The tool also lists available provider types with informational cards, helping you understand what wallet options are supported. This is essential for debugging connection issues, verifying wallet integration, testing multi-wallet support, and understanding the Web3 provider landscape.

HOW TO USE

Connect your wallet using the BGWallet bridge (MetaMask or any Web3 wallet) via the "Connect" button in the header. The tool automatically detects your connection status and displays your wallet address, chain ID, and the provider type (if detectable). Use the "Refresh status" button to manually update the displayed information. The "Available providers" section shows informational cards for MetaMask, WalletConnect, Coinbase Wallet, and other EIP-1193 compatible providers — clicking any card provides a simple informational message. The tool also displays the current chain name and the latest block number (if connected). All data is read-only and does not require signing any transactions.

TECHNICAL MECHANISM

The tool uses the BGWallet bridge (injected by the host) to interact with the wallet provider. It calls BGWallet.isConnected() to check the connection status, BGWallet.getAddress() to retrieve the wallet address, BGWallet.getChainId() to get the chain ID, and BGWallet.getProvider() to access the underlying provider object. The tool attempts to detect the provider type by checking for specific flags on the provider object: isMetaMask for MetaMask, isCoinbaseWallet for Coinbase Wallet, and wc for WalletConnect. The current block number is fetched using BGWallet.getProvider().getBlockNumber(). The tool uses the same BGWallet.subscribe() method to listen for connection changes (onWalletChange), ensuring the UI updates automatically when the wallet connects or disconnects. All reads are performed directly through the wallet provider — no external APIs or third-party services are used. The provider cards in the "Available providers" section are informational only and do not perform actual connections.

WHAT IT CANNOT SEE

The tool cannot connect to wallets that do not support the standard EIP-1193 provider interface — it relies on the BGWallet bridge which expects a compliant provider. It cannot manage session persistence across page reloads without external storage — connection state is not persisted beyond the current session. It cannot detect or connect to hardware wallets (Ledger, Trezor) without browser extensions or additional libraries. It cannot provide wallet functionality beyond connection status and basic provider access — it does not support signing transactions, sending messages, or interacting with contracts. It cannot detect provider details for wallets that do not expose identifiable flags (e.g., some injected providers may appear as "Unknown"). It cannot diagnose network-level issues (firewalls, CORS, RPC errors) beyond what the provider returns. The tool is read-only and does not sign any transactions.

PLEASE NOTE

This tool works exclusively with EVM-compatible wallets and chains (Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Base, and others). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. The tool relies on the BGWallet bridge provided by the host environment — it does not implement its own wallet connection logic. The provider detection is based on common flags and may not identify all wallet types. The tool does not store any data — all reads happen live. The tool is provided as-is with no warranty or liability.