Troubleshooting
Common issues and solutions for the TAGBASE extension.
Extension Issues
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
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
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
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
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:
Chrome
✅ Fully supported
Brave
✅ Fully supported
Edge
✅ Fully supported
Firefox
⚠️ Limited support
Safari
❌ Not supported
Network & API Errors
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
Last updated