Blockzilla

Blockzilla is a Rust toolkit for turning Solana history into compact, indexed archives that can be read without running a validator.

The main product is the blockzilla CLI and its Archive V2 format. Both are pre-1.0, so pin the Git revision used to produce an archive.

Components

Path	Status	Role
blockzilla/	Active	Builds and reads Archive V2 and includes an experimental finite-work scheduler.
services/	Prototype / experimental	Hivezilla durable capture/replication, the Blockzilla watcher, and read-only Edgezilla implementations.
crates/	Libraries	Shared formats, parsers, and Old Faithful readers.
examples/token-api/	Example	Builds a small derived index and local API.
docs/	Reference	Implemented formats, architecture, research, and historical results.
scripts/	Developer tools	Benchmarks and correctness utilities.

The shortest working newcomer path is:

Old Faithful CAR -> Blockzilla -> local Archive V2

The target system adds redundant Hivezilla capture, Blockzilla-managed storage, cloud replication, Edgezilla serving, and local indexer streaming. See the system schema for that direction.

Quick start: build and read the fixture

The repository pins Rust 1.96.0. Clone it and inspect the CLI:

git clone https://github.com/FernoLabs/blockzilla.git
cd blockzilla
cargo run --locked -p blockzilla -- --help

Build one block from the included fixture and read it back:

OUT="$(mktemp -d)"

cargo run --locked -p blockzilla -- \
  build-archive-v2-hot-blocks \
  crates/old-faithful/car-reader/benches/fixtures/epoch-157-biggest.car \
  "$OUT" \
  --max-blocks 1 \
  --no-access

cargo run --locked -p blockzilla -- \
  bench-archive-v2-hot-blocks \
  "$OUT/archive-v2-blocks.zstd" \
  --workers 1 \
  --chunk-size 1

The fixture is only a smoke test. Full epochs can require hundreds of gigabytes across source, output, and temporary files; use a fresh output directory and keep the source archive immutable.

Development

cargo fmt --all -- --check
cargo check --workspace --all-targets --locked
cargo test --workspace --all-targets --locked

Read the documentation index, the roadmap, and the security policy before working on formats, deployments, or credential-handling code.

Blockzilla is available under the MIT License.