core-node REST API

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 个端点 · OpenAPI 3.1.0 · OpenAPI 规范(JSON)

完整的链接口是 JSON-RPC。这里是节点旁的一个小型 REST 接口,本地矿工 API 通过它获取模型元数据和节点指标。生产环境中使用端口 8050。

端点

GET/

Root

Root endpoint - provides API information.

响应

状态说明请求体
200Successful Response
  • application/json any

GET/health

Health Check

Health check endpoint - no auth required.

响应

状态说明请求体
200Successful Response
  • application/json any

GET/api/v1/models

Get Models List

Get list of models with rate limiting.

参数

名称位置类型必填说明
extendedqueryboolean—

请求体

响应

状态说明请求体
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.

请求体

响应

状态说明请求体
200Successful Response
  • application/json any
422Validation Error

GET/api/v1/models/{model_hash}

Get Model Info

Get model information with input validation.

参数

名称位置类型必填说明
model_hashpathstring是

请求体

响应

状态说明请求体
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.

请求体

响应

状态说明请求体
200Successful Response
  • application/json any
422Validation Error

模式

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

字段类型必填说明
schemestring是
credentialsstring是

ModelInfo

字段类型必填说明
model_hashstring是
model_namestring是
model_commitstring是
difficultyinteger是
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

字段类型必填说明
locstring | integer[]是
msgstring是
typestring是