Update MetaMask Connect docs and bump version to 2.1.1

[shahbaz17]

Description

Add comprehensive documentation for account switching, session reconnection, and error handling. Include new troubleshooting guides for cancellation normalization, sign-only dapps, and unexpected account switches. Clarify account ordering behavior, chainChanged event timing, and mobile QR modal handling. Update version requirement from @metamask/connect-evm@^2.1.0 to @metamask/connect-evm@^2.1.1 in wagmi quickstart.

Issue(s) fixed

Fixes #

Preview

Checklist

• If this PR updates or adds documentation content that changes or adds technical meaning, it has received an approval from an engineer or DevRel from the relevant team.
• If this PR updates or adds documentation content, it has received an approval from a technical writer.

External contributor checklist

• I've read the contribution guidelines.
• I've created a new issue (or assigned myself to an existing issue) describing what this PR addresses.

---

Note

Low Risk
Markdown documentation and version string updates only; no runtime or application code changes.

Overview
Documentation-only updates for MetaMask Connect EVM: guides and troubleshooting now cover account re-selection (connect with forceRequest: true), EIP-2255 mapping (wallet_requestPermissions / wallet_revokePermissions), and reconnect pitfalls (don't rely on accounts[0], merged sessions).

Troubleshooting expands with normalized user-rejection handling (code 53 / rpcCode 4001), a split explanation of supportedNetworks failures (post-connect signing vs 4902 switch), sign-only / SIWE guidance (broad network config or provider.selectedChainId), mobile deeplink vs QR when ui.showInstallModal is true, and unexpected account switch after reconnect.

Reference notes clarify SDK account ordering, chainChanged during connect, and ui.showInstallModal mobile behavior. The Wagmi quickstart bumps the required package to @metamask/connect-evm@^2.1.1.

^{Reviewed by Cursor Bugbot for commit f4a147e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
metamask-docs	Ready	Preview, Comment	Jul 13, 2026 2:06pm