API Reference

Base URL: https://pot.rpc.gateway.tribewarez.com

Endpoints

GET /health

Liveness check.

Response:

{ "status": "ok", "service": "pot-o-validator", "version": "0.1.0" }

GET /status

Mining stats, difficulty, network peers.

Response:

{
  "node_id": "...",
  "difficulty": 2,
  "max_tensor_dim": 64,
  "peer_network_mode": "local_only",
  "pool_strategy": "solo",
  "stats": { "total_challenges_issued": 10, "total_proofs_valid": 5 },
  "engine": { "tasks_processed": 10, "successful": 8, "failed": 2 },
  "network": { "peers": [], "total_nodes": 1, "synced": true }
}

POST /challenge

Get a mining challenge.

Body:

{ "slot": 12345, "slot_hash": "abcdef...", "device_type": "native" }

POST /submit

Submit a proof.

Body:

{
  "proof": { "challenge_id": "...", "mml_score": 0.72, "..." : "..." },
  "signature": [0, 1, 2]
}

GET /miners/:pubkey

Query miner account (proxied from on-chain).

GET /pool

Pool info (type, miners, stake, minimum_stake).

POST /devices/register

Register an ESP or external mining device.

GET /network/peers

List known peers (empty in local_only mode).