Verifier REST API

POST/v1/verify/full

Verify Full

Parameter

Body permintaan

Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/octet-stream string (binary)

Respons

POST/v1/verify/full/json

Verify Full Json

Parameter

Body permintaan

• application/json proof_ValidationRequest

Respons

POST/v1/verify/full/request

Verify Full Request

Parameter

Body permintaan

• application/octet-stream string (binary)

Respons

POST/v1/verify/full/request/submit

Verify Full Request Submit

Parameter

Body permintaan

• application/octet-stream string (binary)

Respons

POST/v1/verify/model

Verify Model

Parameter

Body permintaan

Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/octet-stream string (binary)

Respons

POST/v1/verify/model/json

Verify Model Json

Parameter

Body permintaan

• application/json proof_ValidationRequest

Respons

POST/v1/verify/model/request

Verify Model Request

Parameter

Body permintaan

• application/octet-stream string (binary)

Respons

POST/v1/verify/model/request/submit

Verify Model Request Submit

Parameter

Body permintaan

• application/octet-stream string (binary)

Respons

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`.

Parameter

Body permintaan

Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/octet-stream string (binary)

Respons

POST/v1/verify/pow/json

Verify Pow Json

Parameter

Body permintaan

• application/json proof_MiningResponse | proof_Proof | proof_ValidationRequest

Respons

POST/v1/verify/quick

Verify Quick

Parameter

Body permintaan

Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/octet-stream string (binary)

Respons

POST/v1/verify/quick/json

Verify Quick Json

Parameter

Body permintaan

• application/json proof_ValidationRequest

Respons

POST/v1/verify/quick-smell

Verify Quick Smell

Parameter

Body permintaan

Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/octet-stream string (binary)

Respons

POST/v1/verify/quick-smell/json

Verify Quick Smell Json

Parameter

Body permintaan

• application/json proof_ValidationRequest

Respons

POST/v1/verify/quick-smell/request/submit

Verify Quick Smell Request Submit

Parameter

Body permintaan

• application/octet-stream string (binary)

Respons

POST/v1/verify/logits

Verify Logits

Parameter

Body permintaan

Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/octet-stream string (binary)

Respons

POST/v1/verify/logits/json

Verify Logits Json

Parameter

Body permintaan

• application/json proof_ValidationRequest

Respons

POST/v1/verify/challenge/request

Verify Challenge Request

Parameter

Body permintaan

• application/octet-stream string (binary)

Respons

POST/v1/verify/challenge/request/submit

Verify Challenge Request Submit

Parameter

Body permintaan

• application/octet-stream string (binary)

Respons

GET/v1/verify/status/{hash_id}

Get Verification Status

Search all types; return 200 (complete), 202 (pending), or 404.

Parameter

Respons

GET/v1/verify/status/full/{hash_id}

Get Status Full

Parameter

Respons

GET/v1/verify/status/model/{hash_id}

Get Status Model

Parameter

Respons

GET/v1/verify/status/challenge/{hash_id}

Get Status Challenge

Parameter

Respons

GET/v1/verify/status/quick-smell/{hash_id}

Get Status Quick Smell

Parameter

Respons

GET/v1/verify/status/pow/{hash_id}

Get Status Pow

Proof-only status: always `result_type="proof_only"`, never a block result.

Parameter

Respons

POST/v1/verify/status/batch

Get Status Batch

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.

Body permintaan

• application/json StatusBatchRequest

Respons

GET/v1/public/status/{hash_id}

Get Public Status

Public read-only status. Returns {"status": "NAN"} if not found. Note: no durable-storage fallback in the open-source build.

Parameter

Respons

GET/v1/verify/health

Health Check

Respons

GET/health

Health

Respons

GET/healthz

Healthz

Respons

GET/readyz

Readyz

Respons

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 permintaan

Body is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/json BatchTriageRequest

Respons

BatchTriageRequest

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.

Body_verify_full_json_v1_verify_full_json_post

Body_verify_logits_json_v1_verify_logits_json_post

Body_verify_model_json_v1_verify_model_json_post

Body_verify_pow_json_v1_verify_pow_json_post

Body_verify_quick_json_v1_verify_quick_json_post

Body_verify_quick_smell_json_v1_verify_quick_smell_json_post

HTTPValidationError

StatusBatchItem

StatusBatchRequest

ValidationError

proof_FloatArray

proof_UIntArray

proof_Proof

proof_ValidationType

Tipe: "Quick" | "Quick_Smell" | "Full" | "Model" | "Challenge" | "Logits" | "BatchTriage"

proof_ResponseValue

Tipe: "Quick_OK" | "Quick_Fail" | "Quick_OK_Smell_OK" | "Quick_OK_Smell_Fail" | "Quick_Fail_Smell_OK" | "Quick_Fail_Smell_Fail" | "Full_Green" | "Full_Amber" | "Full_Red" | "Model_OK" | "Model_Fail" | "Challenge_OK" | "Challenge_Fail" | "Model_Pending_Review" | "Logits_OK" | "Logits_Fail" | "Triage_Check" | "Triage_Clear" | "Triage_Error"

proof_ValidationUnion

Tipe: "NONE" | "BlockValidation" | "ModelValidation" | "BatchValidation"

proof_BlockValidation

proof_ModelValidation

proof_BatchShare

proof_BatchValidation

proof_ValidationRequest

proof_ValidationResponse

proof_BlockHeader

proof_MiningResponse