REST API core-node

Small REST surface exposed by the TensorCash core-node alongside the JSON-RPC server. Used by the miner-api to query model metadata and node metrics. The full chain surface is the JSON-RPC at /docs/rpc/.

6 endpoint · OpenAPI 3.1.0 · Đặc tả OpenAPI (JSON)

Toàn bộ giao diện của chuỗi nằm ở JSON-RPC. Đây là giao diện REST nhỏ chạy cạnh node, được miner API cục bộ dùng để lấy metadata mô hình và metric của node. Cổng 8050 trong môi trường production.

Endpoint

GET/

Root

Root endpoint - provides API information.

Phản hồi

Trạng tháiMô tảNội dung
200Successful Response
  • application/json any

GET/health

Health Check

Health check endpoint - no auth required.

Phản hồi

Trạng tháiMô tảNội dung
200Successful Response
  • application/json any

GET/api/v1/models

Get Models List

Get list of models with rate limiting.

Tham số

TênVị tríKiểuBắt buộcMô tả
extendedqueryboolean—

Body của yêu cầu

Phản hồi

Trạng tháiMô tảNội dung
200Successful Response
422Validation Error

GET/api/v1/blockchaininfo

Get Blockchain Info

Pass-through to the node's getblockchaininfo RPC. Used by the verification orchestrator to compute distance-to-verdict for PendingVerification model records and trigger anticipatory smell-stat pre-bake before a model flips to Registered.

Body của yêu cầu

Phản hồi

Trạng tháiMô tảNội dung
200Successful Response
  • application/json any
422Validation Error

GET/api/v1/models/{model_hash}

Get Model Info

Get model information with input validation.

Tham số

TênVị tríKiểuBắt buộcMô tả
model_hashpathstringCó

Body của yêu cầu

Phản hồi

Trạng tháiMô tảNội dung
200Successful Response
  • application/json any
422Validation Error

GET/api/v1/miner/metrics

Get Miner Metrics

Get mining throughput metrics from the miner proxy. Returns token throughput (tokens/sec), completion rate, and totals.

Body của yêu cầu

Phản hồi

Trạng tháiMô tảNội dung
200Successful Response
  • application/json any
422Validation Error

Schema

HTTPAuthorizationCredentials

The HTTP authorization credentials in the result of using HTTPBearer or HTTPDigest in a dependency. The HTTP authorization header value is split by the first space. The first part is the scheme, the second part is the credentials. For example, in an HTTP Bearer token scheme, the client will send a header like: `` Authorization: Bearer deadbeef12346 ` In this case: * scheme will have the value "Bearer" * credentials will have the value "deadbeef12346"`

TrườngKiểuBắt buộcMô tả
schemestringCó
credentialsstringCó

HTTPValidationError

TrườngKiểuBắt buộcMô tả
detailValidationError[]—

ModelInfo

TrườngKiểuBắt buộcMô tả
model_hashstringCó
model_namestringCó
model_commitstringCó
difficultyintegerCó
statusinteger | null—
cidstring | null—
extrastring | null—
txidstring | null—
block_hashstring | null—
block_heightinteger | null—
deposit_txidstring | null—
deposit_voutinteger | null—
deposit_amountinteger | null—
owner_key_hashstring | null—
deposit_block_hashstring | null—
deposit_block_heightinteger | null—
commit_txidstring | null—
commit_block_hashstring | null—
commit_block_heightinteger | null—
verification_codeinteger | null—
verification_detailsstring | null—

ValidationError

TrườngKiểuBắt buộcMô tả
locstring | integer[]Có
msgstringCó
typestringCó