Pre-flight transport modelling, calibration parameter estimation, and receipt-backed QUA/OPX gating support.
Namespace /api/v1/usl. Returns receipts, not claims — advisory timing, suppression, coherence, and estimator outputs for downstream review.
Pre-flight advisory only. This API does not run quantum hardware, does not prove physical quantum transport,
and is not a physically validated quantum transport law. Not a lab validation, not a direct hardware control layer,
and not a replacement for Quantum Machines QUA/OPX calibration.
Claim: API/model-validated USL transport coherence-loss law for pre-flight planning.
Route claim levels differ by surface. Core USL transport routes use research_harness_preflight_only;
QM Bridge routes use template_generation_and_calibration_assist_only;
Control Assist routes use control_recommendation_only.
Production API base URL
https://signal.sparse-supernova.com
Prepend this host to every path below (e.g. /api/v1/usl/status, /api/v1/usl/transport/simulate).
Send header X-API-Key (or Authorization: Bearer) on authenticated routes.
Quick start Checking API…
Get running in 60 seconds
Check status (no key): GET /api/v1/usl/status
Check D_target: POST /api/v1/usl/transport/coherence-loss
If CL passes, run POST /api/v1/usl/transport/simulate
Store the JSON receipt for QUA/OPX pre-flight review
X-API-Key: YOUR_KEY
# or
Authorization: Bearer YOUR_KEY
Content-Type: application/json # required on POST
Key tiers
Tier
Example
Step limits (simulate / sweep / scan)
Demo
demo-sparse-supernova-2026
1000 / 50 / 100
Production
Your issued key
10000 / 500 / 2000
Demo key is for examples and integration tests only. Rate limit: 60 requests per 60s per key+route.
Operational notesLab integrations
Operational notes for lab integrations
QUA timing
Default clock_cycle_ns is 4 for Quantum Machines compatibility.
Responses also include duration_cycles (for the selected clock) and duration_cycles_4ns (4 ns convention).
Optional request: clock_cycle_ns, duration_seconds, duration_cycles, or duration_cycles_4ns.
Lab validation receipts
Physical lab outcomes can be treated as validation receipts comparing predicted CL(D) with measured transport loss.
They are evidence artefacts, not model-training events. The API does not update the closed-form law from uploads.
POST/api/v1/usl/lab/transport-resultSubmit physical transport result as validation receipt (stored: false, model_update: none)
Rate-limit guidance
Closed-loop lab runners should batch observations and call the API at a bounded cadence.
Use /transport/sweep for grids rather than many individual /simulate calls.
Default limit: 60 requests / 60s per API key + route.
Response envelope (every route)
All JSON responses include honesty fields:
{
"claim_level": "research_harness_preflight_only",
"forbidden_claim": "",
"caveats": [
"Pre-flight advisory only.",
"Not a lab validation.",
"Not a direct hardware control system.",
"Not a replacement for Quantum Machines QUA/OPX calibration.",
"Outputs are candidate timing, suppression, coherence, and estimator receipts for downstream review."
],
"usl_version": "3.1.1"
}
Transport simulate — additional fields
Field
Description
ok
Overall protocol pass (may be false with HTTP 200)
Closed-form law29 API measurements · max residual <0.03%
Closed-form transport coherence loss
USL transport coherence loss follows CL = (2D+1)/(D+1)2
under the dim=1 transport-quality convention. In the current API/model curve,
the result is independent of λdB, rB, N, and trap frequency.
API/model-validated transport coherence-loss law, not a physically validated quantum transport law.
This API does not run quantum hardware and does not prove physical quantum transport.
The lab validation is one curve: vary Feshbach ramp amplitude, infer Dtarget, and measure transport loss.
D_target is the experimental object. Conservative QEC design rule: D_target > 200 for CL < 1%.
POST/api/v1/usl/transport/coherence-lossCalculate CL from D_target
POST/api/v1/usl/transport/qec-thresholdFind minimum D for target loss
Generate reviewable QUA/Python templates and bounded calibration-step recommendations from USL transport receipts.
The bridge emits timing in 4 ns QUA clock cycles, candidate amplitude values, and safety notes for local lab review.
Template only.
Generated QUA/Python templates require local QM configuration and lab-side review.
This API does not connect to OPX hardware, does not call qm.execute, and does not prove physical quantum transport.
Local lab software remains responsible for configuration, safety checks, execution, and measurement.
Local Python collects readout traces, posts FRAI observations to the API,
receives an estimated D and a bounded next amplitude recommendation,
then the lab runner decides whether to execute the next QUA sequence.
USL Control AssistBounded recommendations · not hardware execution
Theory-B-weighted control recommendations
USL Control Assist turns observed D error into bounded recommendations for ramp amplitude,
transit velocity, and D suppression targets. It uses the closed-form coherence-loss curve
CL = (2D+1)/(D+1)2 as a nonlinear gain modifier.
Control recommendation only.
Recommendations are advisory and are never applied automatically.
The API does not execute QUA, does not connect to OPX hardware, and does not claim
Sontag/CLF stability. Any recommendation must be checked with
/api/v1/usl/transport/simulate before local lab software acts on it.
POST/api/v1/usl/control/recommendRecommend bounded actuator corrections from D error
Auth: Required · Body: full runTransportProtocol input · Returns 200 even when ok: false
Optional D_target adds closed_form_coherence_loss using the dim=1 formula
CL = (2D+1)/(D+1)2. If omitted, D_suppress is used as the CL reference.
This is an extra receipt only — monolith ok / summary are unchanged.
Request body parameters
Field
Type
Required
Description
dim
integer
yes
Hilbert-space dimension factor (≥1)
lambdaDB
number
yes
de Broglie wavelength scale
D_A, D_B
number
yes
Field values at endpoints A and B
r_A, r_B
number
yes
Radii at A and B
D_boundary
number
yes
Boundary field value
deltaR
number
yes
Transport distance (m)
D_suppress
number
yes
Suppressed field target (also used for closed_form_coherence_loss when D_target omitted)
D_target
number
no
Explicit ramp-amplitude target for closed-form CL receipt (overrides D_suppress for CL only)