For the complete documentation index, see llms.txt. This page is also available as Markdown.

Manually Switching RPC URLs

ZKX Wallet lets you choose which RPC endpoint is used for any network already configured in your wallet, and add your own custom RPC endpoints - without removing or re-adding the network. This is useful when a network's default RPC is slow, rate-limited, temporarily down, or when you prefer a private or self-hosted RPC endpoint.

Switching the RPC URL only changes which server your wallet talks to for reading and broadcasting on-chain data. It does not change your account, address, balances, or transaction history.

Before You Start

  • This works for any network already in your wallet - built-in networks (PulseChain, Ethereum, OP Mainnet, BNB Chain, Polygon, Monad) as well as networks you added yourself via Chainlist or manually.

  • You do not need to remove the network to change its RPC - everything happens inside that network's Edit network screen.

Step 1 - Open Settings

Click the ZKX Wallet icon to open the extension, then open Settings.

The Settings panel shows two columns of options:

General

Accounts

Address Book

Networks

Transaction history

Signed messages

Recovery phrases

Extension password

Privacy Opt-outs

Custom tokens

Click Networks.

Step 2 - Select the Network and Open Edit

The Networks screen has two panels:

  • On the left, a searchable list of your networks (Search for network), with Add network from Chainlist and Add network manually at the bottom.

  • On the right, Network details for whichever network is selected - shown read-only, with Edit and Disable buttons in the top-right corner.

Click the network you want to change (for example, PulseChain), then click Edit. This opens the Edit network window for that network.


Step 3 - Choose a Different Default RPC URL

Inside Edit network, under Network details, you'll see:

  • Network name, Currency Symbol, and Currency Name - shown but not editable here.

  • An RPC URL input field with an Add button next to it (see Step 4).

  • Select default RPC URL - a list of every RPC endpoint currently available for this network, each with a radio button. The endpoint with the filled/green radio button is the one your wallet is actively using.

  • Chain ID and Block Explorer URL - shown but not editable here.

To switch RPCs, simply click the radio button next to a different endpoint in the Select default RPC URL list.

For example, on PulseChain you may see multiple options such as https://rpc.pulsechain.com, https://rpc.gigatheminter.com, and https://rpc-pulsechain.g4mm4.io — clicking any one of them selects it as the new default.

On the right-hand side of the Edit network window, an Available features box lists what the network supports (for example, whether smart contract wallets are supported, whether transaction simulation is supported, and whether token prices are available).

Step 4 - (Optional) Add a Custom RPC URL

If you want to use an RPC endpoint that isn't already listed:

  1. Paste the RPC URL into the RPC URL field near the top of the Edit network window.

  2. Click Add.

  3. The new endpoint appears in the Select default RPC URL list below, alongside the existing options.

  4. Click its radio button to make it the active default.

Step 5 - (Optional) Remove a Custom RPC URL

Hovering over an entry in the Select default RPC URL list reveals a red Remove link next to it. Click Remove to delete that RPC endpoint from the list.

Step 6 - Save Your Changes

At the bottom of the Edit network window are two buttons: Cancel and a second button that reads No changes (greyed out) until you actually change something, at which point it becomes Save (active, blue).

  1. Once you've selected a different RPC (and/or added or removed one), click Save.

  2. A green confirmation banner appears at the top of the window: "[Network name] settings saved!" - for example, "PulseChain settings saved!" - with a small × to dismiss it.

  3. Close the window to return to the Networks screen, which now reflects your updated RPC selection.


Important Notes

  • If the RPC you switch to is invalid, overloaded, or offline, your wallet may fail to load balances or broadcast transactions on that network. If this happens, reopen Edit network and switch back to a working RPC.

  • Always double-check a custom RPC URL before adding it - connecting to an untrusted or malicious RPC endpoint could expose which addresses and balances you're viewing, or serve your wallet incorrect chain data.

  • The Save button stays disabled ("No changes") until a real change is detected - if you don't see it become active after clicking a radio button, make sure you actually selected a different endpoint than the one already active.

Last updated