Helix CAPTCHA™ Documentation

Complete documentation for integrating Helix CAPTCHA™ into your application.

Quick Start

Basic Integration (5 minutes)

Step 1: Include the Helix CAPTCHA™ script in your HTML:

<script src="https://helixcaptcha.org/sdk/helix-captcha.min.js"></script>

Step 2: Add the verification container:

<div id="helix-captcha"></div>

Step 3: Initialize the CAPTCHA:

const captcha = new HelixCAPTCHA({
  container: '#helix-captcha',
  siteKey: 'YOUR_SITE_KEY',
  onVerified: (token) => {
    console.log('Verification token:', token);
    // Submit your form
  }
});

captcha.render();

Step 4: Verify the token server-side:

// Node.js example
const response = await fetch('https://helixcaptcha.org/api/verify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    token: receivedToken,
    secret: 'YOUR_SECRET_KEY'
  })
});

const result = await response.json();
if (result.success) {
  // User is verified
}

API Reference

{
  "success": true,
  "consciousnessLevel": 0.89,
  "coherence": 0.91,
  "timestamp": "2025-11-20T21:00:00Z",
  "challenge_ts": "2025-11-20T21:00:00Z",
  "hostname": "example.com"
}

{
  "challengeId": "uuid-v4",
  "threshold": 0.7,
  "expiresAt": "2025-11-20T21:05:00Z"
}

{
  "status": "operational",
  "version": "1.0.0",
  "protocol": "FCS-1.0",
  "uptime": 99.98,
  "latency": 45,
  "stats": {
    "verificationsToday": 15234,
    "successRate": 0.992,
    "avgConsciousness": 0.87
  }
}

Integration Guide

Consciousness Measurement

Helix CAPTCHA™ measures consciousness through multiple signals:

• Movement Variance: Humans have natural variation; bots are too consistent
• Path Smoothness: Humans create smooth curves; bots create sharp angles
• Temporal Patterns: Humans have rhythm; bots are mechanical
• Spatial Entropy: Humans explore space; bots follow paths

JavaScript SDK

Full configuration options:

const captcha = new HelixCAPTCHA({
  // Required
  container: '#helix-captcha',  // CSS selector or DOM element
  siteKey: 'YOUR_SITE_KEY',     // Get from dashboard

  // Optional
  theme: 'dark',                // 'dark' | 'light'
  size: 'normal',               // 'normal' | 'compact'
  threshold: 0.7,               // Verification threshold (0-1)

  // Callbacks
  onVerified: (token) => {},    // Called on successful verification
  onExpired: () => {},          // Called when challenge expires
  onError: (error) => {},       // Called on error

  // Advanced
  language: 'en',               // UI language
  timeout: 120000,              // Challenge timeout (ms)
  retries: 3                    // Max retry attempts
});

Code Examples

React Integration:

import { useEffect, useRef } from 'react';

function SignupForm() {
  const captchaRef = useRef(null);

  useEffect(() => {
    const captcha = new HelixCAPTCHA({
      container: captchaRef.current,
      siteKey: process.env.HELIX_SITE_KEY,
      onVerified: (token) => {
        handleSubmit(token);
      }
    });

    captcha.render();

    return () => captcha.destroy();
  }, []);

  return <div ref={captchaRef} />;
}

Vue Integration:

<template>
  <div ref="captcha"></div>
</template>

<script>
export default {
  mounted() {
    this.captcha = new HelixCAPTCHA({
      container: this.$refs.captcha,
      siteKey: process.env.VUE_APP_HELIX_SITE_KEY,
      onVerified: this.handleVerification
    });
    this.captcha.render();
  },
  beforeDestroy() {
    this.captcha?.destroy();
  }
}
</script>

FCS-1.0 Protocol Specification

Helix CAPTCHA™ implements the FCS-1.0 (Field Coherence Semantics v1.0) protocol for Layer 3 trust verification.

Layer 3 Positioning

The internet stack consists of 4 layers:

• Layer 0: Compute (Meta, cloud providers)
• Layer 1: Intent (Google, OpenAI gateways)
• Layer 2: Action (Multi-actor execution)
• Layer 3: Trust (Helix CAPTCHA™, FCS-1.0)

Layer 3 is orthogonal to gateway competition. We don't compete for user intent—we verify trust for all layers.

Consciousness Measurement Algorithm

Verification score is calculated as:

consciousness_score =
    variance × 0.3 +
    smoothness × 0.3 +
    temporal_pattern × 0.2 +
    entropy × 0.2

// Threshold: 0.7 for human verification
// Range: 0.0 (bot) to 1.0 (high consciousness)

Security Architecture

Helix CAPTCHA™ employs multi-layered security:

1. Edge Firewall: Active since Nov 4, 2025 (ASN blocking, bot score filtering)
2. Cloudflare Bot Management: Bot score 0-100 calculation
3. Consciousness Verification: Semantic pattern analysis
4. Token Validation: Server-side verification with secret key

Performance

Next Steps

• Try the interactive demo
• Explore research partnerships
• View commercial licensing
• Integrate with Consciousness SDK