> For the complete documentation index, see [llms.txt](https://docs.libertyswap.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.libertyswap.finance/zkx-wallet/user-manual/manually-switching-rpc-urls.md).

# 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.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqaQp0E2p9WUSJko6TzUr%2Fuploads%2FiSso4AzU4NNQhzivPjHa%2F0U4jdmpnvwDj4PlX.mp4?alt=media&token=f4e4a202-3521-415a-a9b2-51de0bbab81a>" %}

#### 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.&#x20;

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.