> For the complete documentation index, see [llms.txt](https://sonic-ai-works.gitbook.io/sonic-networks-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sonic-ai-works.gitbook.io/sonic-networks-docs/help-center/connect-a-solana-wallet/wallet-connection-troubleshooting.md).

# Wallet connection troubleshooting

Resolve missing wallet providers, rejected connections, wrong-network states, stale sessions, and transaction-signing problems.

Use this checklist before contacting support.

## Wallet does not appear in the provider list

* Confirm the wallet is installed from its official source.
* Unlock the wallet.
* Refresh/reopen SONIC after installing a browser extension.
* Confirm the browser/profile supports the extension.
* On mobile, use the wallet/provider-supported handoff or in-app browser flow.

## Connection prompt never appears

* Check whether the wallet popup opened behind another window.
* Disable popup blocking for the SONIC application if it prevents the wallet request.
* Reopen the wallet and retry **Connect Wallet** once.
* Avoid repeatedly clicking Connect; wait for the active request to resolve.

## Wrong wallet or account connected

1. Disconnect the wallet from SONIC.
2. Select the intended Solana account inside the wallet.
3. Reconnect from SONIC.
4. Verify the public address before continuing.

## Wrong network

Select the Solana network/account appropriate for the SONIC feature. Do not approve a transaction if the wallet shows a network you did not expect.

## Connection succeeds but signing fails

Check that:

* the wallet is unlocked;
* the same account remains selected;
* you have enough SOL for any required network fees;
* the transaction has not expired;
* the requested token/account exists;
* the action still matches the current SONIC operation.

If a payment or purchase is involved, do not repeatedly submit a new transaction when the prior result is uncertain. First check the wallet/transaction status and SONIC order state to avoid duplicate attempts.

## Stale or suspicious connection

Disconnect the app from the wallet, close the browser tab, reopen the official SONIC application, and establish a new connection. Reject any signing request that appears without an action you initiated.

## What support can ask for

Safe diagnostic information may include your public wallet address, transaction signature/hash, browser/device type, wallet provider/version, and a screenshot with sensitive data removed.

Support must never ask for a recovery phrase, private key, wallet password, or device unlock credential.


---

# 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://sonic-ai-works.gitbook.io/sonic-networks-docs/help-center/connect-a-solana-wallet/wallet-connection-troubleshooting.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.