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예