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はい

HTTPValidationError

フィールド型必須説明
detailValidationError[]—

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はい