Sign in
Servers

Tdx Host Profile Status

Is this host class known, and which VM images cover it? The check chutes-cvm host verify runs.

Deliberately version-free: a miner verifies a host BEFORE downloading any image, so this asks only about the topology -- "can this host run anything at all, and if so what". Whether one specific image can boot is POST /servers/tdx/preflight, which the launch path runs against the version it actually holds.

  • measurements non-empty -> the class is attestable; those are the images it can launch.
  • empty, status: pending -> registered, awaiting measurement generation. Nothing to do but retry later; re-submitting will not speed it up.
  • empty, status: unknown -> never submitted. Register it with POST /servers/tdx/host_profiles.

A POST because the API owns the fingerprint: a caller cannot ask about "my topology" without handing over the profile to be fingerprinted. Stores nothing -- the read-only counterpart to the submission route. Signed by the miner hotkey, so the signature covers the request body.

post/servers/tdx/host_profiles/status

Headers

X-Chutes-Hotkeystring nullable
X-Chutes-Signaturestring nullable
X-Chutes-Noncestring nullable
Authorizationstring nullable

Request body

hostnamestring nullable
timestampstring nullable
pci_topologystring nullable

Response

Successful Response

fingerprintstring required
status'accepted' | 'pending' | 'unknown' required

Retention lifecycle of a submitted host class -- monotonic, only ever advances (unknown -> pending -> accepted) and never regresses.

accepted is class-level and version-agnostic: a measurement was generated for this fingerprint at some point, so the class is on the attestable set and retained (its profile is kept for RTMR0 regeneration). It is NOT the answer to "can version X launch here" -- that is POST /servers/tdx/preflight, which joins the caller's (version, rc) to the class's measurements. Submission only reports which of the three the class is in; POST /servers/tdx/host_profiles/status reports the same lifecycle without storing anything.

detailstring required

Changes