docs: add troubleshooting guide

docs/get-started/troubleshooting.mdx

@@ -0,0 +1,45 @@
+---
+title: "Troubleshooting common issues"
+description: "Common issues and troubleshooting tips when building on Base."
+---
+
+When building on Base, you may encounter issues related to network configuration, wallet authentication, smart contract deployment, or transactions. This guide covers some common problems and practical ways to troubleshoot them.
+
+## Smart contract deployment
+
+### Error: Could not detect network
+
+This usually means your RPC endpoint is unavailable or incorrectly configured.
+
+**Try:**
+
+- Verify that your RPC URL is correct.
+- Check that the RPC endpoint matches the network you are deploying to.
+- Confirm that your environment variables are loaded correctly.
+- Try a different RPC provider if the endpoint is unavailable.
+
+### Error: Insufficient funds for gas
+
+The deployer account does not have enough native ETH to pay for the transaction.
+
+**Try:**
+
+- Check the balance of the wallet you are deploying from.
+- If you are using Base Sepolia, fund the wallet with Base Sepolia ETH.
+- Make sure your wallet is connected to the correct network.
+
+### Transaction reverted
+
+A transaction can revert when a contract requirement or assertion fails.
+
+**Try:**
+
+- Check the transaction logs for the revert reason.
+- Verify that the function arguments are correct.
+- Confirm that the contract is deployed on the network you are using.
+- Run your tests with additional verbosity to inspect the failing assertion.
+
+For Foundry projects, you can use:
+
+```bash
+forge test -vvv