Skip to content

Commit 67caa32

Browse files
committed
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.
1 parent 1fd6a77 commit 67caa32

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

src/content/docs/how-to-guides/holders/bridge-from-base.mdx

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,39 @@ To keep things clear and concise, **Native TORUS** will be referred to as **TORU
137137
</Steps>
138138

139139

140+
## Troubleshooting SwitchChain Torus EVM Issues
141+
142+
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.
143+
144+
### The Issue
145+
146+
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:
147+
148+
- Not all wallets implement this RPC method
149+
- WalletConnect intercepts calls and only supports basic methods like `eth_sendTransaction`, `eth_sign`, and `personal_sign`
150+
- This limitation prevents automatic network switching
151+
152+
### Solutions
153+
154+
<Steps>
155+
156+
1. **Manual Network Setup**
157+
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.
158+
159+
2. **Use MetaMask (Recommended)**
160+
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.
161+
162+
3. **Protocol Limitations**
163+
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`).
164+
165+
</Steps>
166+
167+
<Aside type="tip">
168+
This is not a wagmi bug or a Bridge issue, but rather a limitation of certain wallet implementations when used with WalletConnect.
169+
</Aside>
170+
171+
---
172+
140173
## What's Next?
141174

142175
Now that you have TORUS tokens, you can:

0 commit comments

Comments
 (0)