API Reference
Full internal API spec with HS-Carbon fixed-point, quality u16, anti-replay horizons, and Clockchain merkle proofs.
Internal Use
This page contains the complete field-level surfaces used for production deployments. Do not expose this document publicly unless you intend to support these endpoints and policies.
Normative rules
Tick encoding (verified semantics)
- `R` ticks per cycle (default Earth: 86400)
- `phi_ticks ∈ [0, R-1]`
- `deltaPhi_ticks ∈ [1, floor(R/2)-1]`
- `d_ticks(a,b)=min(|a-b|, R-|a-b|)`
- `in_window ⇔ d_ticks(phi_now, phi_center_ticks) ≤ deltaPhi_ticks`
No-float signing rule
Any object intended to be signed/verified **MUST NOT** contain floats.
Anti-replay tuple (Security Profile)
Reject duplicates within horizon: `(security_profile_id, signer_id, scope, cycle_index, nonce)`
1) Core State Public
GET `/v1/core/state`
Same as public, but may include additional integer fields depending on deployment.
2) Quantum Scheduler Paid
GET `/v1/quantum/decision`
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `hardware_id` | string | Yes | Backend/QPU identifier. |
| `sla_target_u16` | int (0..65534) | Yes | Target quality. |
| `swt_zone` | int (1..12) | Optional | Client zone. |
| `tile_id` | int (1..600) | Optional | Client tile. |
| `max_wait_s_u32` | int | Optional | Client max wait. |
Response (verified semantics)
{
"status": "APPROVED",
"reason_code": "WINDOW_FOUND",
"convention_id": "<TIMEVERSE_CONVENTION_ID>",
"R": 86400,
"day_index": 1240,
"phi_center_ticks": 59318,
"deltaPhi_ticks": 1200,
"swt_zone": 6,
"tile_id": 266,
"policy": {
"sla_target_u16": 62258,
"quality_floor_u16": 60000,
"lock_floor_u16": 42000,
"max_allowed_delta_ticks_u16": 1500
}
}Display-only (optional)
- `predicted_noise_display` (float)
- `semantic_phase_display` (string)
- `message_display` (string)
3) AI Phase Embedding (TPE) Public
GET `/v1/ai/tpe-vector`
Same as public. Embeddings are display-only floats.
4) TSAE Issuance (Signed Receipt) Paid
POST `/v1/security/tsae`
Request body (verified semantics)
{
"scope":"tsae.audit.<your_scope>",
"convention_id":"<TIMEVERSE_CONVENTION_ID>",
"day_index":1240,
"phi_center_ticks":59318,
"deltaPhi_ticks":1200,
"phi_action_ticks":59340,
"swt_zone":6,
"tile_id":266,
"action_hash_hex":"<sha256>",
"quality":{
"fidelity_u16":61000,
"lock_u16":65534,
"meas_phi_ticks":59210,
"max_allowed_delta_ticks_u16":1500
},
"hscarbon":{
"energy_mwh_u32":12000,
"carbon_intensity_mgco2_per_kwh_u32":240000,
"carbon_threshold_mgco2_per_kwh_u32":260000
},
"cost":{
"millihsbits_u32":123
}
}Response: signed TSAE
{
"tsae": {
"body": {
"tsae_schema":"TV-TSAE-2025-12",
"convention_id":"<TIMEVERSE_CONVENTION_ID>",
/* ... more fields ... */
"action_hash_hex":"<sha256>",
"verdict":"ALLOW"
},
"sig": {
"schema":"TV-SECPROF-2026-03.1",
/* ... more fields ... */
"signature":"..."
}
},
"display":{
"utc_action_display":"2026-02-15T12:00:01Z",
"stamp_display":"earth.1240.SWT6.266...."
}
}5) Clockchain Anchoring Enterprise
POST `/v1/clockchain/anchor`
Anchors `sha256(canonical_json(TSAE))` into the next Proof-of-Time block.
Request
{
"anchor_schema":"TV-CLOCKCHAIN-ANCHOR-2026-01",
"convention_id":"<TIMEVERSE_CONVENTION_ID>",
"anchor_hash_hex":"<sha256>",
"day_index":1240,
"phi_action_ticks":59340,
"swt_zone":6,
"tile_id":266,
"scope":"anchor.tsae"
}Response
{
"accepted": true,
"pending": true,
"anchor_hash_hex": "<sha256>",
"estimated_hs_u8": 2
}GET `/v1/clockchain/proof?anchor_hash_hex=...`
Returns merkle inclusion proof + finalized block evidence.
Response (verified semantics)
{
"proof_schema":"TV-CLOCKCHAIN-PROOF-2026-01",
"anchor_hash_hex":"...",
"block":{
"height_u64":12345,
"block_hash_hex":"...",
"previous_hash_hex":"...",
"day_index":1240,
"hs_u8":2,
"leader_agent_id":"AGENT-2",
"anchors_merkle_root_hex":"...",
"finality":{
"threshold_u8":8,
"ok_signatures_u8":11,
"finalized":1
}
},
"merkle_proof":{
"leaf_index_u32":7,
"path":["<sib1>","<sib2>","<sib3>"]
},
"signatures":{
"leader": { "<sig_obj>": "..." },
"validators": [ { "<sig_obj>": "..." } ]
}
}