Troubleshooting

Some Common Issues and their troubleshooting

Common Issues

Popup Blocked

Problem: OAuth popup doesn't open

Solution:

• Disable popup blocker for your domain

• Ensure OAuth is triggered by user interaction (not automatic)

• Check browser console for errors

No Wallet Detected

Problem: "No wallet detected" error

Solution:

• Install MetaMask or another Web3 wallet

• Ensure wallet is unlocked

• Refresh page after installing wallet

• Check wallet is connected to correct network

OAuth Callback Error

Problem: OAuth redirects to error page

Solution:

• Verify callback URLs match in OAuth app settings

• Check environment variables are set correctly

• Ensure cookies are enabled

• Review network tab for failed requests

Token Not Found

Problem: "Failed to retrieve access token"

Solution:

• Check OAuth secrets are correct

• Verify callback routes are working

• Look for CORS issues

• Check server logs for errors

Verification Failed

Problem: Generic "Verification failed" error

Solution:

• Ensure attestor private key is configured

• Verify user meets module requirements

• Check smart contract permissions

• Review backend API logs

• Test with different module

Debugging

Enable Verbose Logging:

<UntracedProvider
  config={{
    // ...
    onSuccess: (result) => {
      console.log('[UNTRACED] Success:', result);
    },
    onError: (error) => {
      console.error('[UNTRACED] Error:', error);
    },
    onClose: () => {
      console.log('[UNTRACED] Modal closed');
    },
  }}
>

Check Network Requests:

Open browser DevTools → Network tab → Filter by:

• /api/auth/github - OAuth initiation

• /api/auth/github/callback - Token exchange

• /oauth-callback - Popup callback

• /api/attest/* - Verification requests

Inspect Popup Communication:

// In browser console
window.addEventListener('message', (event) => {
  console.log('[UNTRACED] Message:', event.data);
});