From 7a9911b9a7bb469cacba9ea74c3282c8324778cc Mon Sep 17 00:00:00 2001 From: Rodrigo Oler Date: Mon, 8 Sep 2025 14:52:23 -0300 Subject: [PATCH] feat: add troubleshooting section for SwitchChain Torus EVM issues - Documented common issues with WalletConnect and mobile wallets regarding the `wallet_switchEthereumChain` RPC method. - Provided solutions including manual network setup, recommended use of MetaMask, and clarification on protocol limitations. - Added a tip to clarify that the issue is not a bug but a limitation of certain wallet implementations. --- .../holders/bridge-from-base.mdx | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/src/content/docs/how-to-guides/holders/bridge-from-base.mdx b/src/content/docs/how-to-guides/holders/bridge-from-base.mdx index 302f9cd..4efbc02 100644 --- a/src/content/docs/how-to-guides/holders/bridge-from-base.mdx +++ b/src/content/docs/how-to-guides/holders/bridge-from-base.mdx @@ -161,6 +161,39 @@ To keep things clear and concise, **Native TORUS** will be referred to as **TORU +## Troubleshooting SwitchChain Torus EVM Issues + +If you're experiencing issues with **WalletConnect** and your mobile wallet when trying to switch to the Torus EVM network on the Bridge, this is likely related to limited RPC method support. + +### The Issue + +The problem occurs when using **WalletConnect** with mobile wallets that don't fully support the `wallet_switchEthereumChain` RPC method (part of **[EIP-3326](https://eips.ethereum.org/EIPS/eip-3326)**). When the Bridge tries to automatically switch to the Torus EVM network, the call fails because: + +- Not all wallets implement this RPC method +- WalletConnect intercepts calls and only supports basic methods like `eth_sendTransaction`, `eth_sign`, and `personal_sign` +- This limitation prevents automatic network switching + +### Solutions + + + +1. **Manual Network Setup** + Check if your wallet allows you to manually add the **Torus EVM** network. You can follow our [manual setup guide](https://docs.torus.network/how-to-guides/holders/bridge-from-base/#:~:text=Do%20not%20see%20Torus%20EVM%3F) to add the network configuration. + +2. **Use MetaMask (Recommended)** + For the smoothest Bridge experience, we recommend using [**MetaMask**](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/), which has 100% support for all Bridge functions including automatic network switching. + +3. **Protocol Limitations** + If your wallet has the network added but still doesn't work, this may be due to your wallet not supporting [EIP-3326](https://eips.ethereum.org/EIPS/eip-3326) (`wallet_switchEthereumChain`). + + + + + +--- + ## What's Next? Now that you have TORUS tokens, you can: