RPC Troubleshooting Guide
A detailed guide on how to identify and troubleshoot common RPC issues
Last updated
A detailed guide on how to identify and troubleshoot common RPC issues
Last updated
When using the AlienBase platform, you may occasionally encounter issues related to the RPC (Remote Procedure Call) connections. RPC issues can affect transactions, balance updates, and general interaction with the Base Chain. This guide provides steps to help you identify, troubleshoot, and resolve RPC issues.
RPC serves as the bridge between your wallet and the Base Chain. If the RPC server has issues, it can prevent your wallet from performing operations successfully.
First, ensure there are no ongoing issues with the Base Chain itself:
Official Status Page: Visit the to check for any service disruptions, maintenance, or updates.
Knowing which RPC server your wallet uses is crucial for diagnosing issues:
Find the RPC URL in Your Wallet: Typically located in the network or settings section of your wallet app.
Verify RPC Server: Compare your RPC URL with the official list on .
If you suspect your current RPC server is problematic, you can switch to another:
Through Chainlist: Visit Chainlist, locate Base Chain, and select another RPC server to automatically add to your wallet.
Manually Changing RPC in MetaMask:
Go to MetaMask, select Settings.
Navigate to Networks, select Base Chain.
Input a new RPC URL from the approved list on Chainlist.
Understanding the specific RPC errors can help in diagnosing the issue:
Access Developer Tools: Right-click on the AlienBase webpage, select "Inspect" (Chrome) or "Inspect Element" (Firefox), then click on the "Console" tab.
Look for Errors: Identify any JSON RPC error messages, such as:
Error: Failed to fetch
Internal JSON-RPC error.
net::ERR_CONNECTION_REFUSED
If issues persist after switching RPC servers:
Take Screenshots: Capture any error messages or issues.
Contact Support: Send a detailed report to AlienBase support by opening a ticket in the . Include screenshots, the RPC URL used, and a description of the issue for helping the team to identify the problem quickly