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).
Các endpoint /verify/* nhận payload FlatBuffers (nhị phân application/octet-stream). Các biến thể /v1/verify/*/json nhận JSON có cấu trúc giống các schema proof_* bên dưới, được ghép từ validation.schema.json. /verify/full, model, pow, quick, quick-smell và logits bao quát thang kiểm chứng của verifier; /verify/status/{hash_id} dùng để truy vấn trạng thái các yêu cầu bất đồng bộ.
verifier-ladder/full
Full re-execution rung. Replay a deterministic inference end-to-end. Inline + async variants.
POST/v1/verify/full
Verify Full
Tham số
Tên
Vị trí
Kiểu
Bắt buộc
Mô tả
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
—
Body của yêu cầu
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
Tham số
Tên
Vị trí
Kiểu
Bắt buộc
Mô tả
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
—
Body của yêu cầu
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`.
Tham số
Tên
Vị trí
Kiểu
Bắt buộc
Mô tả
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
Body của yêu cầu
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
Tham số
Tên
Vị trí
Kiểu
Bắt buộc
Mô tả
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
—
Body của yêu cầu
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
Tham số
Tên
Vị trí
Kiểu
Bắt buộc
Mô tả
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
—
Body của yêu cầu
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
Tham số
Tên
Vị trí
Kiểu
Bắt buộc
Mô tả
details
query
boolean
—
Include failure details in response
accept
header
string | null
—
x-verify-details
header
string | null
—
Body của yêu cầu
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
Phản hồi
Trạng thái
Mô tả
Nội dung
200
Successful Response
application/jsonany
GET/health
Health
Phản hồi
Trạng thái
Mô tả
Nội dung
200
Successful Response
application/jsonany
GET/healthz
Healthz
Phản hồi
Trạng thái
Mô tả
Nội dung
200
Successful Response
application/jsonany
GET/readyz
Readyz
Phản hồi
Trạng thái
Mô tả
Nội dung
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.
Body của yêu cầu
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.