FastAPI surface for the OSS centralised verifier. Anyone can stand one up to re-validate proof-of-inference claims emitted by the TensorCash chain. /verify/* endpoints accept FlatBuffers payloads (plus /v1/verify/*/json variants for JSON-encoded requests).
Els punts d'accés /verify/* reben càrregues FlatBuffers (binàries, application/octet-stream). Les variants /v1/verify/*/json reben JSON amb la forma dels esquemes proof_* de més avall, extrets de validation.schema.json. /verify/full, model, pow, quick, quick-smell i logits cobreixen l'escala del verificador; /verify/status/{hash_id} consulta l'estat dels enviaments asíncrons.
verifier-ladder/full
Full re-execution rung. Replay a deterministic inference end-to-end. Inline + async variants.
POST/v1/verify/full
Verify Full
Paràmetres
Nom
Ubicació
Tipus
Obligatori
Descripció
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
x-prev-block-hash
header
string | null
—
x-merkle-root
header
string | null
—
x-bits
header
string | null
—
Cos de la sol·licitud
Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.
Model-only rung. Verify that a model commit matches what was claimed.
POST/v1/verify/model
Verify Model
Paràmetres
Nom
Ubicació
Tipus
Obligatori
Descripció
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
x-prev-block-hash
header
string | null
—
x-merkle-root
header
string | null
—
x-bits
header
string | null
—
Cos de la sol·licitud
Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.
Proof-of-work rung. Lightweight check that the block carried sufficient compute.
POST/v1/verify/pow
Verify Pow
Proof-only verification. Accepts MiningResponse, Proof, or ValidationRequest.
Context-free by contract: no chain context is validated, the block
precheck is not run, and every response form carries
`result_type="proof_only" / context_bound=false`.
Paràmetres
Nom
Ubicació
Tipus
Obligatori
Descripció
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
Cos de la sol·licitud
Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.
Quick rung. Sampling-based check; cheaper than full, weaker than full.
POST/v1/verify/quick
Verify Quick
Paràmetres
Nom
Ubicació
Tipus
Obligatori
Descripció
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
x-prev-block-hash
header
string | null
—
x-merkle-root
header
string | null
—
x-bits
header
string | null
—
Cos de la sol·licitud
Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.
Quick-smell rung. Heuristic smell test for adversarial proofs.
POST/v1/verify/quick-smell
Verify Quick Smell
Paràmetres
Nom
Ubicació
Tipus
Obligatori
Descripció
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
x-prev-block-hash
header
string | null
—
x-merkle-root
header
string | null
—
x-bits
header
string | null
—
Cos de la sol·licitud
Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.
Logits rung. Cheapest rung — verifies a logits commitment without re-running inference.
POST/v1/verify/logits
Verify Logits
Paràmetres
Nom
Ubicació
Tipus
Obligatori
Descripció
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
Cos de la sol·licitud
Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.
Batch status polling — matches gateway contract:
{completed, still_pending, waited_ms, server_ts}.
Only items with actual in-flight/lifecycle state appear in still_pending.
Liveness / readiness probes. /health and the kubernetes /healthz, /readyz.
GET/v1/verify/health
Health Check
Respostes
Estat
Descripció
Cos
200
Successful Response
application/jsonany
GET/health
Health
Respostes
Estat
Descripció
Cos
200
Successful Response
application/jsonany
GET/healthz
Healthz
Respostes
Estat
Descripció
Cos
200
Successful Response
application/jsonany
GET/readyz
Readyz
Respostes
Estat
Descripció
Cos
200
Successful Response
application/jsonany
verifier-ladder/batch-triage
POST/v1/verify/batch-triage
Verify Batch Triage
ADVISORY: which of these shares are worth a full verify?
Returns a summary verdict for the batch. Per-share outcomes are emitted as
Triage_Check / Triage_Clear / Triage_Error against each share's own
hash_id (little-endian display hex, same as the Full endpoints), pollable
via /v1/verify/status/batch with verification_type "triage".
Triage_Clear means DEPRIORITISED, not verified good. A Triage_Check must
still be confirmed with a real Full verification before any action.
Cos de la sol·licitud
Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.
N shares to triage in one batched pass.
Each entry of shares is a base64 ValidationRequest -- byte-identical to
what you would POST to /verify/full for that share.