Reproducible quantum research with signed evidence bundles

1. Design experiment
2. Estimate cost (free)
3. Run on simulator → iterate
4. Run on QPU → collect results
5. Benchmark with ACOS + DRI
6. Export signed evidence bundle
7. Generate GlassBox audit trail
8. Publish with DOI-linked evidence

# Request evidence bundle for a completed job
curl -H "Authorization: Bearer $QCOS_API_KEY" \
  "https://api.softquantus.com/api/v1/jobs/job_abc123/evidence" \
  -o evidence_bundle.zip

# Verify (public endpoint, no API key needed)
curl -X POST https://api.softquantus.com/api/v1/verify/evidence \
  -F "bundle=@evidence_bundle.zip"

import os
import time
import json
import requests

API_KEY = os.environ["QCOS_API_KEY"]
BASE_URL = "https://api.softquantus.com"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

BACKENDS = [
    "statevector_simulator",
    "aws_sv1",
    "aws_ionq_aria_1"
]

TARGET_CIRCUIT = (
    'OPENQASM 2.0; include "qelib1.inc"; '
    'qreg q[2]; creg c[2]; '
    'h q[0]; cx q[0],q[1]; measure q -> c;'
)

results = {}

for backend in BACKENDS:
    # Step 1: ACOS certification check
    acos_resp = requests.post(
        f"{BASE_URL}/api/v1/acos/certify",
        headers=HEADERS,
        json={"backend": backend, "level": "standard"}
    )
    acos_resp.raise_for_status()
    acos = acos_resp.json()

    # Step 2: DRI reliability probe
    dri_resp = requests.post(
        f"{BASE_URL}/api/v1/dri/probe",
        headers=HEADERS,
        json={"backend": backend, "probe_depth": 3}
    )
    dri_resp.raise_for_status()
    dri_probe_id = dri_resp.json()["probe_id"]

    # Wait for DRI
    while True:
        dri = requests.get(f"{BASE_URL}/api/v1/dri/{dri_probe_id}", headers=HEADERS).json()
        if dri.get("status") == "completed":
            break
        time.sleep(5)

    # Step 3: Run experiment
    job_resp = requests.post(
        f"{BASE_URL}/api/v1/execute",
        headers=HEADERS,
        json={"circuit": TARGET_CIRCUIT, "backend": backend, "shots": 4096}
    )
    job_resp.raise_for_status()
    job_id = job_resp.json()["job_id"]

    # Poll
    while True:
        r = requests.get(f"{BASE_URL}/api/v1/jobs/{job_id}", headers=HEADERS).json()
        if r["status"] in ("completed", "failed"):
            break
        time.sleep(5)

    # Compute Bell fidelity
    counts = r["counts"]
    total = sum(counts.values())
    fidelity = (counts.get("00", 0) + counts.get("11", 0)) / total

    results[backend] = {
        "fidelity": fidelity,
        "dri_score": dri.get("dri_score"),
        "acos_level": acos.get("certification_level"),
        "job_id": job_id,
        "evidence_url": f"{BASE_URL}/api/v1/jobs/{job_id}/evidence"
    }
    print(f"  {backend}: fidelity={fidelity:.4f}  DRI={dri.get('dri_score')}")

# Print comparison table
print("\nBackend Comparison — Bell State Fidelity")
print(f"{'Backend':<30} {'Fidelity':>10} {'DRI Score':>12} {'ACOS Level':>12}")
print("-" * 68)
for bk, res in results.items():
    print(f"{bk:<30} {res['fidelity']:>10.4f} {str(res['dri_score']):>12} {str(res['acos_level']):>12}")

# Save results with evidence references
with open("experiment_results.json", "w") as f:
    json.dump(results, f, indent=2)
print("\nResults saved: experiment_results.json")

# Run QV benchmark on a backend
curl -X POST https://api.softquantus.com/api/v1/bench/run \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "suite": "qv",
    "backend": "aws_ionq_aria_1",
    "options": {"min_qubits": 2, "max_qubits": 12, "trials": 200, "shots": 2048}
  }'