Skip to content

Commit 7a9911b

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 5fc9ae2 commit 7a9911b

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
@@ -161,6 +161,39 @@ To keep things clear and concise, **Native TORUS** will be referred to as **TORU
161161
</Steps>
162162

163163

164+
## Troubleshooting SwitchChain Torus EVM Issues
165+
166+
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.
167+
168+
### The Issue
169+
170+
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:
171+
172+
- Not all wallets implement this RPC method
173+
- WalletConnect intercepts calls and only supports basic methods like `eth_sendTransaction`, `eth_sign`, and `personal_sign`
174+
- This limitation prevents automatic network switching
175+
176+
### Solutions
177+
178+
<Steps>
179+
180+
1. **Manual Network Setup**
181+
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.
182+
183+
2. **Use MetaMask (Recommended)**
184+
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.
185+
186+
3. **Protocol Limitations**
187+
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`).
188+
189+
</Steps>
190+
191+
<Aside type="tip">
192+
This is not a wagmi bug or a Bridge issue, but rather a limitation of certain wallet implementations when used with WalletConnect.
193+
</Aside>
194+
195+
---
196+
164197
## What's Next?
165198

166199
Now that you have TORUS tokens, you can:

0 commit comments

Comments
 (0)