# Troubleshooting

#### Extension Issues

| Issue                     | Solution                                                                           |
| ------------------------- | ---------------------------------------------------------------------------------- |
| Extension not appearing   | Ensure the extension is installed and enabled in your browser's extension settings |
| Extension icon greyed out | Refresh the page or restart your browser                                           |
| QR scanner not opening    | Allow camera permissions when prompted                                             |
| Camera feed is black      | Check that no other app is using your camera                                       |
| Slow performance          | Disable other extensions temporarily to check for conflicts                        |

***

#### Wallet Connection Issues

| Issue                     | Solution                                                              |
| ------------------------- | --------------------------------------------------------------------- |
| Wallet not detected       | Ensure your wallet extension is installed, enabled, and refreshed     |
| Multiple wallets conflict | Disable other wallet extensions, keeping only the one you want to use |
| Connection rejected       | Unlock your wallet and try connecting again                           |
| Wrong wallet connected    | Disconnect and reconnect with the correct wallet                      |

**Supported Cardano Wallets:**

* Eternl
* Nami
* Flint
* Yoroi
* Lace
* Typhon
* GeroWallet
* NuFi

***

#### Signing & Verification Issues

| Issue                              | Solution                                                   |
| ---------------------------------- | ---------------------------------------------------------- |
| Signing failed                     | Ensure your wallet is unlocked and try again               |
| Challenge expired                  | Request a new verification challenge—they are time-limited |
| "Token not found" error            | Verify the token is in the connected wallet address        |
| Verification stuck on "Submitting" | Check your internet connection and retry                   |
| Wrong network error                | Ensure you're connected to mainnet, not a testnet          |

***

#### QR Code Scanning Issues

| Issue                     | Solution                                                |
| ------------------------- | ------------------------------------------------------- |
| QR code not recognized    | Ensure the QR code is a valid TAGBASE verification code |
| Blurry or unreadable      | Improve lighting and hold the camera steady             |
| Camera won't focus        | Clean your camera lens and ensure adequate lighting     |
| "Invalid QR code" message | The QR code may be damaged or not a TAGBASE code        |

***

#### Claim Issues

| Issue                       | Solution                                                    |
| --------------------------- | ----------------------------------------------------------- |
| Claim not appearing         | Refresh the page or check the URL matches exactly           |
| Duplicate claim warning     | A claim for this Verification ID already exists on this URL |
| "Verification ID not found" | Double-check the ID format: TBXXXX-XXXX-XXXX                |
| Cannot delete claim         | Claims are permanent records and cannot be removed          |

***

#### Browser Compatibility

TAGBASE extension is optimized for:

| Browser | Status             |
| ------- | ------------------ |
| Chrome  | ✅ Fully supported  |
| Brave   | ✅ Fully supported  |
| Edge    | ✅ Fully supported  |
| Firefox | ⚠️ Limited support |
| Safari  | ❌ Not supported    |

***

#### Network & API Errors

| Error Code | Meaning      | Solution                                       |
| ---------- | ------------ | ---------------------------------------------- |
| 400        | Bad request  | Check input data format                        |
| 401        | Unauthorized | Re-authenticate or refresh session             |
| 404        | Not found    | Verify the Verification ID exists              |
| 429        | Rate limited | Wait a moment before retrying                  |
| 500        | Server error | Try again later; contact support if persistent |


---

# Agent Instructions: 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:

```
GET https://docs.tagbase.io/extension/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.