BRIDGE Documentation

From zero to first verification in under 10 minutes.

What is BRIDGE?

BRIDGE is a multi-model consensus verification protocol that eliminates single-model risk from critical AI decisions. Instead of trusting one model's output, BRIDGE routes your verification request through multiple independent AI models, forces them into adversarial debate, and delivers a consensus result with a mathematically grounded confidence score.

Think of it as a jury system for AI. No single model controls the verdict. Each model independently analyzes your input, then defends its findings against counterarguments from the others. Only claims that survive adversarial challenge earn high confidence scores. The entire process is recorded in an immutable audit trail.

BRIDGE is designed for high-stakes decisions: contract review, code audits, regulatory compliance, medical literature analysis, and any domain where a single model's hallucination or bias could cause real damage. It is not a chatbot. It is a trust layer.

How It Works

Every verification follows a five-stage pipeline:

1
Submit
Send content via API
2
Independent Analysis
Models analyze in isolation
3
Adversarial Debate
Models challenge each other
4
Consensus Engine
Weighted agreement score
5
Verified Output
Confidence + audit trail

Models are selected based on the verification type. The system ensures diversity of architecture and training lineage to minimize correlated failures. No model sees another's analysis until the debate phase begins.

Quickstart

Step 1: Get Your API Key

  1. Create a free account at /start
  2. Navigate to Dashboard → API Keys
  3. Click Create Key and copy your key immediately (it will not be shown again)

Step 2: Install the SDK

bash
pip install bridge-protocol
Note: Python SDK is in development. Use the REST API directly for production workloads today.
bash
npm install @bridge-protocol/sdk
Note: Node.js SDK is in development. Use the REST API directly for production workloads today.
No installation needed. curl is available on all major operating systems. Proceed to Step 3.

Step 3: Run Your First Verification

python
from bridge_protocol import BridgeClient

client = BridgeClient(api_key="your_api_key_here")

result = client.verify(
    content="The contract states payment is due within 30 days of invoice.",
    verification_type="contract_review",
    options={
        "depth": "standard",
        "models": 3
    }
)

print(f"Confidence: {result.confidence}")
print(f"Findings: {result.findings}")
print(f"Consensus ID: {result.consensus_id}")
javascript
import { BridgeClient } from '@bridge-protocol/sdk';

const client = new BridgeClient({ apiKey: 'your_api_key_here' });

const result = await client.verify({
    content: 'The contract states payment is due within 30 days of invoice.',
    verificationType: 'contract_review',
    options: {
        depth: 'standard',
        models: 3
    }
});

console.log(`Confidence: ${result.confidence}`);
console.log(`Findings:`, result.findings);
console.log(`Consensus ID: ${result.consensusId}`);
bash
curl -X POST https://api.bridge-protocol.io/v1/verify \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The contract states payment is due within 30 days of invoice.",
    "verification_type": "contract_review",
    "options": {
      "depth": "standard",
      "models": 3
    }
  }'

Step 4: Read the Response

json
{
  "consensus_id": "cons_8f3a2b1c4d5e6f7890",
  "confidence": 0.94,
  "status": "complete",
  "findings": [
    {
      "claim": "Payment obligation is net-30 from invoice date",
      "confidence": 0.97,
      "models_agreed": 3,
      "models_total": 3
    },
    {
      "claim": "No late payment penalty clause identified",
      "confidence": 0.89,
      "models_agreed": 2,
      "models_total": 3
    }
  ],
  "dissents": [
    {
      "model": "model_c",
      "claim": "Clause may imply business days rather than calendar days",
      "round": 4
    }
  ],
  "rounds_completed": 5,
  "audit_trail": "/v1/consensus/cons_8f3a2b1c4d5e6f7890/evidence"
}

The confidence field represents the adversarial survival score of the overall consensus. Individual findings each carry their own confidence and agreement counts. Dissents record claims that did not reach consensus but may be worth human review.

Consensus Engine

The Consensus Engine is the orchestration core of BRIDGE. It manages model selection, debate routing, and scoring.

Model Selection

Models are selected based on three criteria: architectural diversity (transformer variants, mixture-of-experts, etc.), training lineage independence, and domain performance history. The engine never uses two models from the same provider family in a single verification.

Independent Analysis Phase

Each selected model receives identical inputs with zero visibility into other models' outputs. They produce structured findings with explicit confidence levels and supporting evidence. This isolation prevents anchoring bias.

Debate Orchestration

After independent analysis, the engine synthesizes areas of disagreement and routes them as adversarial challenges. Each model must defend its claims against specific counterarguments from the others. The engine tracks which claims survive and which are withdrawn.

Confidence Score

The BRIDGE confidence score is not a hallucination probability. It is an adversarial survival score: the degree to which a claim withstood structured challenge from independent models.

Formula

formula
confidence = (agreements_after_debate / total_models)
             * (1 - withdrawal_rate)
             * debate_depth_weight

where:
  agreements_after_debate = models still supporting claim post-debate
  total_models            = number of models in the verification
  withdrawal_rate         = claims withdrawn / claims initially made
  debate_depth_weight     = min(rounds_completed / 5, 1.0)

Scores range from 0.0 to 1.0. A score above 0.85 indicates strong adversarial survival. Scores below 0.60 indicate significant disagreement and warrant human review.

Debate Rounds

Each verification undergoes multiple rounds of structured adversarial debate. Typical verifications complete in 3 to 7 rounds. The system enforces a hard cap of 7 rounds to bound latency and cost.

Round Structure

Early Termination

If all models reach unanimous agreement before round 7, debate terminates early. The rounds_completed field in the response indicates how many rounds were actually executed.

Audit Trail

Every verification produces an immutable audit trail secured by a SHA-256 hash chain. Each step in the pipeline (submission, individual analyses, debate rounds, final consensus) generates a timestamped, hashed record.

Accessing the Audit Trail

bash
curl https://api.bridge-protocol.io/v1/consensus/cons_8f3a2b1c4d5e6f7890/evidence \
  -H "Authorization: Bearer your_api_key_here"

The response includes the complete chain of evidence: which models participated, what each produced independently, every challenge and response in the debate, and the final scoring logic. This is your cryptographic proof that the verification was conducted fairly.

Authentication

All API requests require a Bearer token in the Authorization header:

http
Authorization: Bearer your_api_key_here

Key Permissions

Permission Scope Use Case
read View verifications, audit trails Dashboards, monitoring
write Create verifications, manage projects Production integrations
admin Manage keys, billing, team members Account administration

Rate Limits

Tier Requests/min Concurrent Monthly Limit
Free 10 2 100 verifications
Pro 60 10 5,000 verifications
Enterprise 300 50 Unlimited

API Endpoints

POST/v1/verify
Submit content for synchronous multi-model verification. Returns when consensus is reached.
bash
curl -X POST https://api.bridge-protocol.io/v1/verify \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "...", "verification_type": "contract_review"}'
POST/v1/verify/async
Submit content for asynchronous verification. Returns immediately with a consensus_id for polling.
bash
curl -X POST https://api.bridge-protocol.io/v1/verify/async \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "...", "verification_type": "code_review", "webhook_url": "https://yourapp.com/hook"}'
GET/v1/consensus/{id}
Retrieve the result of a completed or in-progress verification by consensus ID.
bash
curl https://api.bridge-protocol.io/v1/consensus/cons_8f3a2b1c4d5e6f7890 \
  -H "Authorization: Bearer your_api_key_here"
GET/v1/consensus/{id}/evidence
Retrieve the full immutable audit trail for a verification, including all debate rounds.
bash
curl https://api.bridge-protocol.io/v1/consensus/cons_8f3a2b1c4d5e6f7890/evidence \
  -H "Authorization: Bearer your_api_key_here"
GET/v1/models
List all models currently available in the BRIDGE verification pool with their capabilities and status.
bash
curl https://api.bridge-protocol.io/v1/models \
  -H "Authorization: Bearer your_api_key_here"

SDKs

Official SDKs are in active development. The REST API is fully stable and production-ready today.

Python

python
from bridge_protocol import BridgeClient

client = BridgeClient(api_key="your_api_key_here")

# Synchronous verification
result = client.verify(
    content="Your content here",
    verification_type="contract_review"
)

# Async verification
job = client.verify_async(
    content="Your content here",
    verification_type="code_review",
    webhook_url="https://yourapp.com/hook"
)
print(f"Polling ID: {job.consensus_id}")
SDK Status: Python SDK is in development. Use REST API for production. Install with pip install bridge-protocol for early access.

Node.js

javascript
import { BridgeClient } from '@bridge-protocol/sdk';

const client = new BridgeClient({ apiKey: 'your_api_key_here' });

// Synchronous verification
const result = await client.verify({
    content: 'Your content here',
    verificationType: 'contract_review'
});

// Async verification
const job = await client.verifyAsync({
    content: 'Your content here',
    verificationType: 'code_review',
    webhookUrl: 'https://yourapp.com/hook'
});
console.log(`Polling ID: ${job.consensusId}`);
SDK Status: Node.js SDK is in development. Use REST API for production. Install with npm install @bridge-protocol/sdk for early access.

REST (curl)

No SDK required. The REST API is the most reliable integration path today:

bash
# Verify content
curl -X POST https://api.bridge-protocol.io/v1/verify \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "...", "verification_type": "contract_review"}'

# Check result
curl https://api.bridge-protocol.io/v1/consensus/cons_YOUR_ID \
  -H "Authorization: Bearer your_api_key_here"

# Get audit trail
curl https://api.bridge-protocol.io/v1/consensus/cons_YOUR_ID/evidence \
  -H "Authorization: Bearer your_api_key_here"

Chrome Extension

Verify content directly from any AI chat interface. The BRIDGE Chrome Extension adds a floating verification button to ChatGPT, Claude, Gemini, and other AI platforms.

How it works

1. Install the extension
2. Enter your BRIDGE API key in the popup
3. Visit any AI chat (ChatGPT, Claude, Gemini)
4. Click the BRIDGE indicator to save conversations as decisions

Supported platforms

ChatGPT (openai.com, chatgpt.com)
Claude (claude.ai)
Gemini (gemini.google.com)
Any AI chat interface

Install: Download the extension files, open chrome://extensions, enable Developer Mode, click "Load unpacked", and select the extension folder. Source on GitHub

Guides

Step-by-step walkthroughs for common verification workflows:

Ready to verify?

Get started free. No credit card required. 100 verifications per month on the free tier.