Verification Modules

A comprehensive integration guide for Untraced SDK

Email Verification

Verify email ownership without revealing the email address.

Module ID: zk-email

OAuth Required: No

Configuration Options:

{
  provider: 'any' | 'gmail' | 'outlook'  // Default: 'any'
}

Usage:

const { open } = useUntracedModal();

// Any email provider
open('zk-email');

// Specific provider
open('zk-email', { provider: 'gmail' });

What happens:

1. User connects wallet

2. Email verification process executes

3. Attestation created and signed

4. Result returned with transaction hash

Age Verification

Prove user meets age threshold without revealing exact age.

Module ID: zk-age

OAuth Required: No

Configuration Options:

{
  minAge: number  // 13-100, Default: 18
}

Usage:

const { open } = useUntracedModal();

// Default 18+
open('zk-age');

// Custom age threshold
open('zk-age', { minAge: 21 });

GitHub Verification

Verify GitHub account activity and commit history.

Module ID: zk-github

OAuth Required: Yes

Configuration Options:

{
  minCommits: number  // 0-10000, Default: 10
}

Usage:

const { open } = useUntracedModal();

// Default 10 commits
open('zk-github');

// Require 100 commits
open('zk-github', { minCommits: 100 });

OAuth Flow:

1. User clicks verify

2. OAuth popup opens automatically

3. User authorizes GitHub

4. Popup closes with access token

5. SDK fetches commit data

6. Wallet connection for attestation

7. Success

GitHub API Data Fetched:

• Total commit count

• Repository count

• Account age

• Username (for verification)

Twitter Verification

Verify Twitter/X account ownership and metrics.

Module ID: zk-twitter

OAuth Required: Yes

Configuration Options:

{
  verificationType: 'account' | 'followers' | 'verified',
  minFollowers?: number  // Required if verificationType = 'followers'
}

Usage:

const { open } = useUntracedModal();

// Basic account verification
open('zk-twitter', { verificationType: 'account' });

// Follower count verification
open('zk-twitter', {
  verificationType: 'followers',
  minFollowers: 1000
});

// Verified badge check
open('zk-twitter', { verificationType: 'verified' });

OAuth Flow:

1. User clicks verify

2. OAuth popup with PKCE opens

3. User authorizes Twitter

4. Token returned securely

5. SDK verifies account data

6. Attestation created

7. Success

Balance Verification

Prove wallet has minimum balance without revealing exact amount.

Module ID: zk-balance

OAuth Required: No

Configuration Options:

{
  minBalance: number  // In ETH, Default: 0.1
}

Usage:

const { open } = useUntracedModal();

// Default 0.1 ETH
open('zk-balance');

// Custom threshold
open('zk-balance', { minBalance: 1.0 });