> 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/how-to/common-issues-while-using-liberty-swap/fix-wallet-connection-issues.md).

# Fix Wallet Connection Issues

### 1️⃣ Symptoms of wallet-related issues

If you see any of the following, your wallet is likely the cause:

* Balance shows **0 tokens** but you know you have funds
* Swap button is disabled or stuck on **“Confirm”**
* Transaction window does not pop up
* Wallet stays on **“Connecting…”**
* Gas fee is not loading
* You receive **RPC error**, **network error**, or **failed to fetch**

### 2️⃣ Quick fix: Switch to another wallet

Different wallets use different RPC providers and internal engines.\
If one wallet is buggy or overloaded, another will often work instantly.

We recommend trying one of the following:

#### For EVM chains (PulseChain, Ethereum, BSC, Base, Arbitrum)

* **Rabby Wallet** (best stability & RPC handling)
* **MetaMask**
* **OKX Wallet**
* **IM Wallet**
* **Pulse Wallet** (native for PulseChain)

#### For Solana

* **Phantom**
* **Solflare**
* **Backpack**
* **OKX Wallet (Solana mode)**

👉 Simply connect Liberty Swap Finance using another wallet and try again.\
No funds will be lost - your assets remain on the blockchain.

### 3️⃣ Reset the wallet connection

If the wallet was previously connected and is now misbehaving:

1. Open your wallet
2. Go to **Connected Sites / dApps**
3. Remove or disconnect **Liberty Swap Finance**
4. Refresh the Liberty Swap Finance page
5. Reconnect your wallet

This clears stale sessions and fixes most connection bugs.

### 4️⃣ Check that your wallet is on the correct network

Your wallet must be on the same blockchain as the pool you are using.

Example:

* Using PulseChain pool → Wallet must be on **PulseChain**
* Using Base pool → Wallet must be on **Base**

Wrong network = swaps, balances, and gas will fail.

### 5️⃣ Switch RPC inside the wallet

Even if your wallet is correct, its default RPC may be overloaded.

Go to:\
**Wallet Settings → Network → RPC**\
Switch to a backup RPC or add a new one.

(Refer to the RPC list in this documentation.)

### 6️⃣ Update or restart your wallet

Outdated wallet versions often cause:

* Signature bugs
* Gas estimation failures
* dApp connection issues

Steps:

* Update the wallet extension or app
* Close and reopen the browser or mobile app
* Reconnect to Liberty Swap Finance

### 7️⃣ Try a different browser or device

Some wallets fail due to browser conflicts.

If needed:

* Try **Chrome, Brave, or Firefox**
* Or switch from mobile to desktop (or vice versa)

### 8️⃣ If nothing works

Your wallet software is likely unstable or incompatible with the network.

The fastest fix:

> **Switch to Rabby, MetaMask, Phantom, or OKX Wallet**

These wallets are fully tested and compatible with Liberty Swap Finance.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.libertyswap.finance/how-to/common-issues-while-using-liberty-swap/fix-wallet-connection-issues.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.