Quantum V^ LLC

QRNG Enterprise Evaluation Guide

Confidential

What You're Evaluating

STEADYWATCH™ QRNG is a quantum random number generation service backed by real IBM Quantum hardware entropy. Entropy is harvested from quantum circuits running on IBM Quantum processors, folded across three independent prime-seeded hives (VAULT p=5, VIPER p=13, LOTUS p=17), and made available via a simple REST API.

Every byte returned is derived from measured quantum state collapse — not a PRNG, not a software simulation.

No Installation Required

This evaluation connects to a live, hosted instance. No IBM Quantum account, no Docker setup, no seed generation. You need only:

Mac or Linux terminal
curl (pre-installed on both)
A browser

Check API status before proceeding:
infin-8.github.io/STEADYWATCH-QUANTUM-DEMO/status.html
The status page shows real-time connectivity and the current API base URL. Copy it before running the commands below.

API Base URL

https://<current-tunnel-url>.trycloudflare.com

Get the current URL from the status page. Set it as a shell variable for convenience:

export SW_API="https://<current-tunnel-url>.trycloudflare.com"

Quickstart

1. Health Check

Verify the service is live and all three hive seeds are loaded:

curl "$SW_API/qrng/health"

Expected response:

{
  "status": "ok",
  "ready": true,
  "hives": ["VAULT", "VIPER", "LOTUS"],
  "fingerprint": "765c803f8cfd1e1b",
  "counter": 0
}

2. Generate Random Bytes

# 32 bytes of quantum entropy (hex-encoded)
curl "$SW_API/qrng/bytes?n=32"

# 64 bytes
curl "$SW_API/qrng/bytes?n=64"

Expected response:

{
  "hex": "a3f2c1...",
  "bytes": 32,
  "source": "ibm-quantum-hkdf",
  "fingerprint": "765c803f8cfd1e1b",
  "counter": 1
}

3. Random Integer

# Random integer between 1 and 1000000
curl "$SW_API/qrng/int?min=1&max=1000000"

4. Random Float

# Float in [0, 1)
curl "$SW_API/qrng/float"

5. Random UUID

curl "$SW_API/qrng/uuid"

6. Batch Generation

# 10 values, 16 bytes each
curl "$SW_API/qrng/batch?count=10&bytes=16"

Public Attestation

Every entropy pool has a cryptographic fingerprint that can be independently verified against the originating IBM Quantum job:

curl "$SW_API/qrng/attestation"

Expected response:

{
  "master_fingerprint": "765c803f8cfd1e1b...",
  "hives": {
    "VAULT":  { "prime": 5,  "satellites": 144, "backend": "ibm_marrakesh", "job_ids": ["..."] },
    "VIPER":  { "prime": 13, "satellites": 336, "backend": "ibm_marrakesh", "job_ids": ["..."] },
    "LOTUS":  { "prime": 17, "satellites": 432, "backend": "ibm_marrakesh", "job_ids": ["..."] }
  },
  "verify_url": "https://quantum.ibm.com/jobs/{job_id}",
  "service": "STEADYWATCH™ QRNG · Quantum V^ LLC"
}

Take any job_id from the response and paste it into https://quantum.ibm.com/jobs/{job_id} to independently verify the quantum hardware run that produced the entropy.

Interactive Demo

A browser-based demo with live entropy visualization is available at:
infin-8.github.io/STEADYWATCH-QUANTUM-DEMO/qrng.html

Architecture Overview

IBM Quantum Hardware (ibm_marrakesh)
    ↓ quantum circuit measurements
Dantian Synthesis (OR/MAJ across p=5, p=13, p=17)
    ↓ 912 satellite measurements folded via SHA-256
Three-Hive Entropy Pool (VAULT + VIPER + LOTUS)
    ↓ HKDF-SHA256 stream derivation
REST API  ←  Your application

Key properties:

Source: measured quantum state collapse on IBM Quantum superconducting processors
Derivation: HKDF-SHA256 keyed from the folded entropy pool
Verification: every job ID is publicly auditable at quantum.ibm.com
No PRNG, no software simulation, no classical fallback in the entropy pool

Integration

The API is stateless and requires no authentication for evaluation. Production deployments include API key issuance, rate limiting, and dedicated entropy allocation.

For integration support or production access: nathaniel.a.vazquez@gmail.com