Verifier REST API

POST/v1/verify/full

Verify Full

參數

請求主體

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)

回應

POST/v1/verify/full/json

Verify Full Json

參數

請求主體

• application/json proof_ValidationRequest

回應

POST/v1/verify/full/request

Verify Full Request

參數

請求主體

• application/octet-stream string (binary)

回應

POST/v1/verify/full/request/submit

Verify Full Request Submit

參數

請求主體

• application/octet-stream string (binary)

回應

POST/v1/verify/model

Verify Model

參數

請求主體

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)

回應

POST/v1/verify/model/json

Verify Model Json

參數

請求主體

• application/json proof_ValidationRequest

回應

POST/v1/verify/model/request

Verify Model Request

參數

請求主體

• application/octet-stream string (binary)

回應

POST/v1/verify/model/request/submit

Verify Model Request Submit

參數

請求主體

• application/octet-stream string (binary)

回應

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

參數

請求主體

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)

回應

POST/v1/verify/pow/json

Verify Pow Json

參數

請求主體

• application/json proof_MiningResponse | proof_Proof | proof_ValidationRequest

回應

POST/v1/verify/quick

Verify Quick

參數

請求主體

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)

回應

POST/v1/verify/quick/json

Verify Quick Json

參數

請求主體

• application/json proof_ValidationRequest

回應

POST/v1/verify/quick-smell

Verify Quick Smell

參數

請求主體

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)

回應

POST/v1/verify/quick-smell/json

Verify Quick Smell Json

參數

請求主體

• application/json proof_ValidationRequest

回應

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

Verify Quick Smell Request Submit

參數

請求主體

• application/octet-stream string (binary)

回應

POST/v1/verify/logits

Verify Logits

參數

請求主體

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)

回應

POST/v1/verify/logits/json

Verify Logits Json

參數

請求主體

• application/json proof_ValidationRequest

回應

POST/v1/verify/challenge/request

Verify Challenge Request

參數

請求主體

• application/octet-stream string (binary)

回應

POST/v1/verify/challenge/request/submit

Verify Challenge Request Submit

參數

請求主體

• application/octet-stream string (binary)

回應

GET/v1/verify/status/{hash_id}

Get Verification Status

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

參數

回應

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

Get Status Full

參數

回應

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

Get Status Model

參數

回應

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

Get Status Challenge

參數

回應

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

Get Status Quick Smell

參數

回應

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

Get Status Pow

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

參數

回應

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.

請求主體

• application/json StatusBatchRequest

回應

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.

參數

回應

GET/v1/verify/health

Health Check

回應

GET/health

Health

回應

GET/healthz

Healthz

回應

GET/readyz

Readyz

回應

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 is a FlatBuffer-encoded ValidationRequest (or Proof / MiningResponse for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/.

• application/json BatchTriageRequest

回應

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

型別: "Quick" | "Quick_Smell" | "Full" | "Model" | "Challenge" | "Logits" | "BatchTriage"

proof_ResponseValue

型別: "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

型別: "NONE" | "BlockValidation" | "ModelValidation" | "BatchValidation"

proof_BlockValidation

proof_ModelValidation

proof_BatchShare

proof_BatchValidation

proof_ValidationRequest

proof_ValidationResponse

proof_BlockHeader

proof_MiningResponse