acropolis 0.2.1

UNDER CONSTRUCTION: A safe local-first Rust Cardano node scaffold.
Documentation

Acropolis

UNDER CONSTRUCTION: Acropolis is not production-ready. Do not use it to manage funds, produce blocks, submit transactions, or operate a blockchain node.

Acropolis is a safe local-first Rust scaffold for Cardano node and cardano-node development. The project is authored by Trevor Knott and Knott Dynamics.

Safety

  • The default command prints a local startup plan.
  • Mainnet contact is blocked.
  • Default paths do not dial peers, fetch remote data, serve interfaces, or mutate node state.
  • Production ledger, sync, forging, storage, and peer-to-peer behavior are incomplete.
  • Live testnet behavior requires an explicit opt-in and remains strictly bounded.
  • Published package contents are restricted by an explicit Cargo allowlist.

Local Capabilities

  • Startup and shutdown planning.
  • Offline network profile reporting.
  • Bounded local Cardano configuration, topology, and peer snapshot inspection.
  • Deterministic Cardano network protocol vectors and in-memory conformance checks.
  • Local observability and safety reports.
  • An optional tui dashboard.

Safe Commands

cargo fmt --check
cargo check --offline
cargo test --offline
cargo run --offline -- plan
cargo run --offline -- status
cargo run --offline -- networks
cargo run --offline -- testnet-plan --network testnet
cargo run --offline -- testnet-conformance
cargo run --offline -- testnet-readiness
cargo check --offline --features tui --examples
cargo test --offline --features tui

Construction Preview

cargo install acropolis
acropolis status

This installs the local reporting scaffold only. It does not install a production Cardano node.

The testnet-probe and testnet-handshake-probe commands can open one explicitly authorized public-testnet connection. The handshake probe writes one Cardano proposal frame and reads one bounded response frame. Both commands reject mainnet, DNS hostnames, non-default ports, retries, and timeouts above five seconds.

Publication

The crate is published as acropolis with these discovery terms: Acropolis, Cardano, Cardano node, cardano-node, blockchain, and node.

See docs/README.md for the construction and safety status.