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