Testing

A comprehensive test page is available at /test-sdk:

Test Environment

A comprehensive test page is available at /test-sdk:

bun run dev
# Navigate to http://localhost:3000/test-sdk

Test Features:

• Real-time status monitoring

• All 5 verification modules

• OAuth flow testing

• Programmatic verification

• State management testing

• Live test log

Running Tests

1. Basic Module Test:

• Click "Email Module"

• Connect wallet

• Should complete successfully

2. OAuth Test (GitHub):

• Ensure GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET are set

• Click "GitHub Module"

• OAuth popup opens

• Authorize

• Popup closes

• Verification completes

3. OAuth Test (Twitter):

• Ensure TWITTER_CLIENT_ID and TWITTER_CLIENT_SECRET are set

• Click "Twitter Module"

• OAuth popup opens

• Authorize

• PKCE flow completes

• Verification succeeds

4. Programmatic Test:

• Scroll to "Programmatic Verification"

• Click any module button

• Verification runs without modal

• Result displayed below

See TESTING_GUIDE.md for detailed testing instructions.

---

Deployment

Production Checklist

Before deploying to production:

• Get client ID from dashboard.untraced.io

• Configure OAuth apps (GitHub, Twitter)

• Set up environment variables

• Uncomment origin validation in oauth.ts

• Configure proper callback URLs

• Test all verification modules

• Implement error tracking (Sentry, etc.)

• Add analytics for verification success rates

• Set up monitoring for failed verifications

• Configure rate limiting on API routes

• Review smart contract permissions

• Test on staging environment first

Environment Variables

Required variables:

# Production URL
NEXT_PUBLIC_URL=https://yourdomain.com

# Registry Contract
NEXT_PUBLIC_REGISTRY_ADDRESS=0xA5f2af132B0163f9333c67f5EfD4C35f037BbA60

# Attestor (server-side only)
ATTESTOR_PRIVATE_KEY=0x...

# GitHub OAuth
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...

# Twitter OAuth
TWITTER_CLIENT_ID=...
TWITTER_CLIENT_SECRET=...