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是