How to Fix WalletNotReadyError

The error WalletNotReadyError means your wallet is not ready to connect. This usually happens when the wallet is not installed, not active, or the browser doesn’t support wallet extensions.

Common reasons for WalletNotReadyError

1. Wallet not installed on your browser (desktop)

If you connect from a computer without a wallet extension installed, the site cannot detect your wallet.

2. Wallet not installed on your phone

If you try to connect from mobile without the wallet app, the error appears.

3. Different devices

If the wallet is only on your phone but you connect from your computer, the connection fails since there is no wallet on the desktop.

4. Safari on desktop

Safari does not support wallet extensions. To use a wallet on desktop, switch to a supported browser like Chrome.

5. Wallet just installed

If you installed the wallet during the connection attempt, the site may not recognize it yet. In this case:

  • Restart your browser

  • Reopen the site

  • Try to connect again

6. Still not working on mobile

If the error persists on your phone, use your wallet’s native browser (inside the wallet app). This method always works.

How to open the site in the wallet browser

Phantom

  1. Open the Phantom app on your phone.

  2. Tap the browser (compass) icon at the bottom.

  3. In the search bar, enter the site URL.

  4. The site will open directly inside Phantom, and you can connect your wallet.

Solflare

  1. Open the Solflare app on your phone.

  2. Tap the browser icon at the bottom of the screen.

  3. Type in the site URL.

  4. The site will open inside Solflare, allowing smooth wallet connection.

Last updated