Crates & API

This page indexes the Rust crates and firmware that power the PoT-O validator and related services. Full API documentation is generated by cargo doc and published on docs.rs when crates are released.

Rust crates (pot-o-validator workspace)

The off-chain validator lives under gateway.tribewarez.com/testnet.rpc.gateway.tribewarez.com/pot-o-validator/. The workspace includes:

Crate	Description	docs.rs	crates.io
pot-o-validator	PoT-O validator HTTP service and library (config, consensus, device registry, HTTP API)	docs.rs/pot-o-validator	When published
pot-o-core	Core types and utilities: block, transaction, errors, constants	docs.rs/pot-o-core	When published
ai3-lib	AI3 support: tensor engine, ESP compatibility, mining operations	docs.rs/ai3-lib	When published
pot-o-mining	Mining coordination: challenge generation, MML/neural path validation, PoT-O consensus	docs.rs/pot-o-mining	When published
pot-o-extensions	DeFi, staking, pool strategy, device protocol, chain bridge, peer network, proof authority	docs.rs/pot-o-extensions	When published

Build docs locally from the validator directory:

cd gateway.tribewarez.com/testnet.rpc.gateway.tribewarez.com/pot-o-validator
cargo doc --no-deps --open

Auxiliary binaries

• pot-o-validator — main HTTP server (health, status, challenge, submit, devices, DeFi endpoints).
• pot-o-mml-calibrate — CLI to compare DEFLATE-based MML scores with ESP-style entropy approximation.
• pot-o-timing — timing harness for PoT-O operations and mining loop.
• pot-o-golden-proofs — generates golden proofs for fixed slots (JSONL to stdout).

Firmware (C/C++)

ESP32-S and ESP8266 mining firmware is not a Rust crate. It lives under:

• pot-o-validator/firmware/esp-pot-o-miner/ — PlatformIO project for on-device tensor mining.

See ESP Mining and the esp-pot-o-miner repository for build and flash instructions.

Tests

Location	Description
pot-o-validator/tests/	Integration tests (e.g. http_status_smoke for validator HTTP).
pot-o-validator/ai3-lib/tests/	Engine smoke tests.

Run all tests:

cd gateway.tribewarez.com/testnet.rpc.gateway.tribewarez.com/pot-o-validator
cargo test --all

See also

• Implementation Mapping — RFC-to-code mapping and validator layout.
• PoT-O API Reference — HTTP API and OpenAPI spec.