{ "openapi": "3.1.0", "info": { "title": "TensorCash OSS verification API", "description": "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).", "version": "1.0.0" }, "paths": { "/v1/verify/full": { "post": { "tags": [ "verifier-ladder/full" ], "summary": "Verify Full", "operationId": "verify_full_v1_verify_full_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include failure details in response", "default": false, "title": "Details" }, "description": "Include failure details in response" }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } }, "description": "Body is a FlatBuffer-encoded `ValidationRequest` (or `Proof` / `MiningResponse` for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/." }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/model": { "post": { "tags": [ "verifier-ladder/model" ], "summary": "Verify Model", "operationId": "verify_model_v1_verify_model_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include failure details in response", "default": false, "title": "Details" }, "description": "Include failure details in response" }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } }, "description": "Body is a FlatBuffer-encoded `ValidationRequest` (or `Proof` / `MiningResponse` for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/." }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/pow": { "post": { "tags": [ "verifier-ladder/pow" ], "summary": "Verify Pow", "description": "Proof-only verification. Accepts MiningResponse, Proof, or ValidationRequest.\n\nContext-free by contract: no chain context is validated, the block\nprecheck is not run, and every response form carries\n``result_type=\"proof_only\"`` / ``context_bound=false``.", "operationId": "verify_pow_v1_verify_pow_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include failure details in response", "default": false, "title": "Details" }, "description": "Include failure details in response" }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } }, "description": "Body is a FlatBuffer-encoded `ValidationRequest` (or `Proof` / `MiningResponse` for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/." }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/quick": { "post": { "tags": [ "verifier-ladder/quick" ], "summary": "Verify Quick", "operationId": "verify_quick_v1_verify_quick_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include failure details in response", "default": false, "title": "Details" }, "description": "Include failure details in response" }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } }, "description": "Body is a FlatBuffer-encoded `ValidationRequest` (or `Proof` / `MiningResponse` for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/." }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/quick-smell": { "post": { "tags": [ "verifier-ladder/quick-smell" ], "summary": "Verify Quick Smell", "operationId": "verify_quick_smell_v1_verify_quick_smell_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include failure details in response", "default": false, "title": "Details" }, "description": "Include failure details in response" }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } }, "description": "Body is a FlatBuffer-encoded `ValidationRequest` (or `Proof` / `MiningResponse` for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/." }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/logits": { "post": { "tags": [ "verifier-ladder/logits" ], "summary": "Verify Logits", "operationId": "verify_logits_v1_verify_logits_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include failure details in response", "default": false, "title": "Details" }, "description": "Include failure details in response" }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } }, "description": "Body is a FlatBuffer-encoded `ValidationRequest` (or `Proof` / `MiningResponse` for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/." }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/full/json": { "post": { "tags": [ "verifier-ladder/full" ], "summary": "Verify Full Json", "operationId": "verify_full_json_v1_verify_full_json_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Details" } }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/proof_ValidationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/model/json": { "post": { "tags": [ "verifier-ladder/model" ], "summary": "Verify Model Json", "operationId": "verify_model_json_v1_verify_model_json_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Details" } }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/proof_ValidationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/pow/json": { "post": { "tags": [ "verifier-ladder/pow" ], "summary": "Verify Pow Json", "operationId": "verify_pow_json_v1_verify_pow_json_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Details" } }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/proof_MiningResponse" }, { "$ref": "#/components/schemas/proof_Proof" }, { "$ref": "#/components/schemas/proof_ValidationRequest" } ] } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/quick/json": { "post": { "tags": [ "verifier-ladder/quick" ], "summary": "Verify Quick Json", "operationId": "verify_quick_json_v1_verify_quick_json_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Details" } }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/proof_ValidationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/quick-smell/json": { "post": { "tags": [ "verifier-ladder/quick-smell" ], "summary": "Verify Quick Smell Json", "operationId": "verify_quick_smell_json_v1_verify_quick_smell_json_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Details" } }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } }, { "name": "x-prev-block-hash", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Prev-Block-Hash" } }, { "name": "x-merkle-root", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Merkle-Root" } }, { "name": "x-bits", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Bits" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/proof_ValidationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/logits/json": { "post": { "tags": [ "verifier-ladder/logits" ], "summary": "Verify Logits Json", "operationId": "verify_logits_json_v1_verify_logits_json_post", "parameters": [ { "name": "details", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Details" } }, { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } }, { "name": "x-verify-details", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Verify-Details" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/proof_ValidationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/full/request": { "post": { "tags": [ "verifier-ladder/full" ], "summary": "Verify Full Request", "operationId": "verify_full_request_v1_verify_full_request_post", "parameters": [ { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/model/request": { "post": { "tags": [ "verifier-ladder/model" ], "summary": "Verify Model Request", "operationId": "verify_model_request_v1_verify_model_request_post", "parameters": [ { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/challenge/request": { "post": { "tags": [ "verifier-ladder/challenge" ], "summary": "Verify Challenge Request", "operationId": "verify_challenge_request_v1_verify_challenge_request_post", "parameters": [ { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/full/request/submit": { "post": { "tags": [ "verifier-ladder/full" ], "summary": "Verify Full Request Submit", "operationId": "verify_full_request_submit_v1_verify_full_request_submit_post", "parameters": [ { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/model/request/submit": { "post": { "tags": [ "verifier-ladder/model" ], "summary": "Verify Model Request Submit", "operationId": "verify_model_request_submit_v1_verify_model_request_submit_post", "parameters": [ { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/challenge/request/submit": { "post": { "tags": [ "verifier-ladder/challenge" ], "summary": "Verify Challenge Request Submit", "operationId": "verify_challenge_request_submit_v1_verify_challenge_request_submit_post", "parameters": [ { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/quick-smell/request/submit": { "post": { "tags": [ "verifier-ladder/quick-smell" ], "summary": "Verify Quick Smell Request Submit", "operationId": "verify_quick_smell_request_submit_v1_verify_quick_smell_request_submit_post", "parameters": [ { "name": "accept", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Accept" } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/status/{hash_id}": { "get": { "tags": [ "status" ], "summary": "Get Verification Status", "description": "Search all types; return 200 (complete), 202 (pending), or 404.", "operationId": "get_verification_status_v1_verify_status__hash_id__get", "parameters": [ { "name": "hash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/status/full/{hash_id}": { "get": { "tags": [ "status" ], "summary": "Get Status Full", "operationId": "get_status_full_v1_verify_status_full__hash_id__get", "parameters": [ { "name": "hash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/status/model/{hash_id}": { "get": { "tags": [ "status" ], "summary": "Get Status Model", "operationId": "get_status_model_v1_verify_status_model__hash_id__get", "parameters": [ { "name": "hash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/status/challenge/{hash_id}": { "get": { "tags": [ "status" ], "summary": "Get Status Challenge", "operationId": "get_status_challenge_v1_verify_status_challenge__hash_id__get", "parameters": [ { "name": "hash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/status/quick-smell/{hash_id}": { "get": { "tags": [ "status" ], "summary": "Get Status Quick Smell", "operationId": "get_status_quick_smell_v1_verify_status_quick_smell__hash_id__get", "parameters": [ { "name": "hash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/status/pow/{hash_id}": { "get": { "tags": [ "status" ], "summary": "Get Status Pow", "description": "Proof-only status: always ``result_type=\"proof_only\"``, never a block result.", "operationId": "get_status_pow_v1_verify_status_pow__hash_id__get", "parameters": [ { "name": "hash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/status/batch": { "post": { "tags": [ "status" ], "summary": "Get Status Batch", "description": "Batch status polling \u2014 matches gateway contract:\n{completed, still_pending, waited_ms, server_ts}.\nOnly items with actual in-flight/lifecycle state appear in still_pending.", "operationId": "get_status_batch_v1_verify_status_batch_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusBatchRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/public/status/{hash_id}": { "get": { "tags": [ "status" ], "summary": "Get Public Status", "description": "Public read-only status. Returns {\"status\": \"NAN\"} if not found.\nNote: no durable-storage fallback in the open-source build.", "operationId": "get_public_status_v1_public_status__hash_id__get", "parameters": [ { "name": "hash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hash Id" } }, { "name": "verification_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by type", "title": "Verification Type" }, "description": "Filter by type" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/verify/health": { "get": { "tags": [ "health" ], "summary": "Health Check", "operationId": "health_check_v1_verify_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/verify/batch-triage": { "post": { "tags": [ "verifier-ladder/batch-triage" ], "summary": "Verify Batch Triage", "description": "ADVISORY: which of these shares are worth a full verify?\n\nReturns a summary verdict for the batch. Per-share outcomes are emitted as\nTriage_Check / Triage_Clear / Triage_Error against each share's own\nhash_id (little-endian display hex, same as the Full endpoints), pollable\nvia /v1/verify/status/batch with verification_type \"triage\".\n\nTriage_Clear means DEPRIORITISED, not verified good. A Triage_Check must\nstill be confirmed with a real Full verification before any action.", "operationId": "verify_batch_triage_v1_verify_batch_triage_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchTriageRequest" } } }, "required": true, "description": "Body is a FlatBuffer-encoded `ValidationRequest` (or `Proof` / `MiningResponse` for /pow). FlatBuffers IDL + JSON Schema published at https://tensorcash.org/docs/schemas/." }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/health": { "get": { "summary": "Health", "operationId": "health_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "tags": [ "health" ] } }, "/healthz": { "get": { "summary": "Healthz", "operationId": "healthz_healthz_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "tags": [ "health" ] } }, "/readyz": { "get": { "summary": "Readyz", "operationId": "readyz_readyz_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "tags": [ "health" ] } } }, "components": { "schemas": { "BatchTriageRequest": { "properties": { "shares": { "items": { "type": "string" }, "type": "array", "minItems": 1, "title": "Shares", "description": "base64 ValidationRequest blobs" }, "chunk": { "type": "integer", "maximum": 256.0, "minimum": 0.0, "title": "Chunk", "description": "shares per forward pass; 0 = worker default", "default": 0 }, "rank_ratio": { "type": "number", "minimum": 0.0, "title": "Rank Ratio", "description": "flag above this x cohort median; 0 = default", "default": 0.0 }, "bootstrap": { "type": "integer", "maximum": 200000.0, "minimum": 0.0, "title": "Bootstrap", "description": "0 = worker default", "default": 0 }, "wait_ms": { "type": "integer", "maximum": 600000.0, "minimum": 0.0, "title": "Wait Ms", "default": 120000 } }, "type": "object", "required": [ "shares" ], "title": "BatchTriageRequest", "description": "N shares to triage in one batched pass.\n\nEach entry of `shares` is a base64 ValidationRequest -- byte-identical to\nwhat you would POST to /verify/full for that share." }, "Body_verify_full_json_v1_verify_full_json_post": { "properties": { "proof_b64": { "type": "string", "title": "Proof B64" } }, "type": "object", "required": [ "proof_b64" ], "title": "Body_verify_full_json_v1_verify_full_json_post" }, "Body_verify_logits_json_v1_verify_logits_json_post": { "properties": { "proof_b64": { "type": "string", "title": "Proof B64" } }, "type": "object", "required": [ "proof_b64" ], "title": "Body_verify_logits_json_v1_verify_logits_json_post" }, "Body_verify_model_json_v1_verify_model_json_post": { "properties": { "proof_b64": { "type": "string", "title": "Proof B64" } }, "type": "object", "required": [ "proof_b64" ], "title": "Body_verify_model_json_v1_verify_model_json_post" }, "Body_verify_pow_json_v1_verify_pow_json_post": { "properties": { "payload_b64": { "type": "string", "title": "Payload B64" } }, "type": "object", "required": [ "payload_b64" ], "title": "Body_verify_pow_json_v1_verify_pow_json_post" }, "Body_verify_quick_json_v1_verify_quick_json_post": { "properties": { "proof_b64": { "type": "string", "title": "Proof B64" } }, "type": "object", "required": [ "proof_b64" ], "title": "Body_verify_quick_json_v1_verify_quick_json_post" }, "Body_verify_quick_smell_json_v1_verify_quick_smell_json_post": { "properties": { "proof_b64": { "type": "string", "title": "Proof B64" } }, "type": "object", "required": [ "proof_b64" ], "title": "Body_verify_quick_smell_json_v1_verify_quick_smell_json_post" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "StatusBatchItem": { "properties": { "hash_id": { "type": "string", "minLength": 1, "title": "Hash Id" }, "verification_type": { "type": "string", "title": "Verification Type" }, "batch_hash_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Batch Hash Id" } }, "type": "object", "required": [ "hash_id", "verification_type" ], "title": "StatusBatchItem" }, "StatusBatchRequest": { "properties": { "items": { "items": { "$ref": "#/components/schemas/StatusBatchItem" }, "type": "array", "title": "Items" }, "wait_ms": { "type": "integer", "maximum": 10000.0, "minimum": 0.0, "title": "Wait Ms", "default": 0 } }, "type": "object", "required": [ "items" ], "title": "StatusBatchRequest" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "proof_FloatArray": { "type": "object", "properties": { "values": { "type": "array", "items": { "type": "number" } } }, "additionalProperties": false }, "proof_UIntArray": { "type": "object", "properties": { "values": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 4294967295 } } }, "additionalProperties": false }, "proof_Proof": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 0, "maximum": 255 }, "tick": { "type": "integer", "minimum": 0, "maximum": 18446744073709551615 }, "timestamp": { "type": "integer", "minimum": 0, "maximum": 18446744073709551615 }, "target": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "vdf": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "block_hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "header_prefix": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "is_solution": { "type": "boolean" }, "model_identifier": { "type": "string" }, "compute_precision": { "type": "string" }, "ipfs_cid": { "type": "string" }, "extra_flags": { "type": "string" }, "temperature": { "type": "number" }, "top_p": { "type": "number" }, "top_k": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "repetition_penalty": { "type": "number" }, "chosen_tokens": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 4294967295 } }, "chosen_probs": { "type": "array", "items": { "type": "number" } }, "sampling_u": { "type": "array", "items": { "type": "number" } }, "softmax_normalizers": { "type": "array", "items": { "type": "number" } }, "prompt_tokens": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 4294967295 } }, "pad_mask": { "type": "array", "items": { "type": "boolean" } }, "topk_logits": { "type": "array", "items": { "$ref": "#/components/schemas/proof_FloatArray" } }, "topk_indices": { "type": "array", "items": { "$ref": "#/components/schemas/proof_UIntArray" } }, "logsumexp_stats": { "type": "array", "items": { "$ref": "#/components/schemas/proof_FloatArray" } } }, "additionalProperties": false }, "proof_ValidationType": { "type": "string", "enum": [ "Quick", "Quick_Smell", "Full", "Model", "Challenge", "Logits", "BatchTriage" ] }, "proof_ResponseValue": { "type": "string", "enum": [ "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": { "type": "string", "enum": [ "NONE", "BlockValidation", "ModelValidation", "BatchValidation" ] }, "proof_BlockValidation": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "prev_block_hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "merkle_root": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "timestamp": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "bits": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "nonce": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "pow_blob_hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "adjusted_bits": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "pow_blob": { "$ref": "#/components/schemas/proof_Proof" }, "difficulty": { "type": "integer", "minimum": -9223372036854775808, "maximum": 9223372036854775807 }, "height": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "ruleset": { "type": "integer", "minimum": 0, "maximum": 255 } }, "additionalProperties": false }, "proof_ModelValidation": { "type": "object", "properties": { "model_name": { "type": "string" }, "model_commit": { "type": "string" }, "difficulty": { "type": "integer", "minimum": -9223372036854775808, "maximum": 9223372036854775807 }, "cid": { "type": "string" }, "extra": { "type": "string" }, "txid": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "block_hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "block_height": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 } }, "additionalProperties": false }, "proof_BatchShare": { "type": "object", "properties": { "hash_id": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "request": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } } }, "additionalProperties": false }, "proof_BatchValidation": { "type": "object", "properties": { "shares": { "type": "array", "items": { "$ref": "#/components/schemas/proof_BatchShare" } }, "chunk": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "rank_ratio": { "type": "number" }, "bootstrap": { "type": "integer", "minimum": 0, "maximum": 4294967295 } }, "additionalProperties": false }, "proof_ValidationRequest": { "type": "object", "properties": { "hash_id": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "validation_type": { "$ref": "#/components/schemas/proof_ValidationType" }, "request_type": { "$ref": "#/components/schemas/proof_ValidationUnion" }, "request": { "anyOf": [ { "$ref": "#/components/schemas/proof_BlockValidation" }, { "$ref": "#/components/schemas/proof_ModelValidation" }, { "$ref": "#/components/schemas/proof_BatchValidation" } ] } }, "additionalProperties": false }, "proof_ValidationResponse": { "type": "object", "properties": { "hash_identifier": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "enum_response": { "$ref": "#/components/schemas/proof_ResponseValue" } }, "additionalProperties": false }, "proof_BlockHeader": { "type": "object", "properties": { "req_id": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "version": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "prev_block_hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "merkle_root": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "timestamp": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "bits": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "height": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "stepbind": { "type": "integer", "minimum": 0, "maximum": 255 } }, "additionalProperties": false }, "proof_MiningResponse": { "type": "object", "properties": { "req_id": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "nonce": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "adjusted_bits": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "pow_blob_hash": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 255 } }, "difficulty": { "type": "integer", "minimum": 0, "maximum": 4294967295 }, "pow_blob": { "$ref": "#/components/schemas/proof_Proof" }, "completion_id": { "type": "string" } }, "additionalProperties": false } } }, "tags": [ { "name": "verifier-ladder/full", "description": "Full re-execution rung. Replay a deterministic inference end-to-end. Inline + async variants." }, { "name": "verifier-ladder/model", "description": "Model-only rung. Verify that a model commit matches what was claimed." }, { "name": "verifier-ladder/pow", "description": "Proof-of-work rung. Lightweight check that the block carried sufficient compute." }, { "name": "verifier-ladder/quick", "description": "Quick rung. Sampling-based check; cheaper than full, weaker than full." }, { "name": "verifier-ladder/quick-smell", "description": "Quick-smell rung. Heuristic smell test for adversarial proofs." }, { "name": "verifier-ladder/logits", "description": "Logits rung. Cheapest rung \u2014 verifies a logits commitment without re-running inference." }, { "name": "verifier-ladder/challenge", "description": "Challenge protocol. Async-only \u2014 submit a challenge, retrieve result via /status." }, { "name": "status", "description": "Status polling for async submissions. One endpoint per ladder rung plus a generic by-hash and batch." }, { "name": "health", "description": "Liveness / readiness probes. /health and the kubernetes /healthz, /readyz." } ] }