HQCA v2 · Developer reference
API & PQC Inspector
NIST PQC Standard Status
Aligned to OMB M-26-15
- FIPS 203Active
ML-KEM-768
Key encapsulation · mTLS
- FIPS 204Active
ML-DSA-65
Client & job signatures
- FIPS 205Active
SLH-DSA-128s
Long-lived root keys
- FIPS 206Deferred
FN-DSA-512
Compact signatures
- FIPS 2072027 Track
HQC-192
Backup KEM
POST
/api/v2/workloads/dispatch
Submit an ML-DSA-65 signed workload. The orchestrator routes it to RacQ or Advantage2, or rejects it under policy.
gRPC WorkloadService.Dispatch · auth ML-KEM-768 mTLS + ML-DSA-65
| Parameter | Type | Description |
|---|---|---|
| workload_type | enum | VARIATIONAL | ANNEALING | FEDERATED |
| payload | bytes | Circuit, QUBO, or gradient blob |
| sovereignty | enum | ON_PREM_REQUIRED | CLOUD_ALLOWED |
| signature | bytes | FIPS 204 ML-DSA-65 signature (3,309 B) |
client.py
from qfabric import Client
from qfabric.pqc import MlDsa65
signer = MlDsa65.load("keys/client.mldsa65")
client = Client("https://gateway.qfabric.example", kem="ML-KEM-768")
job = client.workloads.dispatch(
workload_type="ANNEALING",
payload=open("tail_risk_1650.qubo", "rb").read(),
sovereignty="CLOUD_ALLOWED",
signer=signer,
)
print(job.job_id, job.route)Example response · 200 OK
application/json
{
"job_id": "QF-7A24",
"route": "TIER_3B_ANNEALING",
"target": "Advantage2_system1",
"attestation": "POQE_WITNESS",
"status": "QUEUED"
}