Troubleshooting

Common issues and solutions for the TAGBASE extension.

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