Ere Guests

A catalog, downloader, and execution harness for release-backed stateless validator guests used with Ere.

Table of Contents

• Ere Guests
  • Table of Contents
  • Supported Rust Versions (MSRV)
  • Overview
  • Repository Structure
    • Workspace Crates
    • Guest Artifacts
  • Development
    • Formatting
  • License

Supported Rust Versions (MSRV)

The current MSRV (minimum supported Rust version) is 1.93.

Overview

This repository republishes checksum-verified guest ELFs and program verification keys from upstream releases. The active guest and zkVM combinations are defined in artifact-registry.json.

Repository Structure

Workspace Crates

Located in crates/, these provide reusable functionality for guest programs and host:

• stateless-validator-catalog - Catalog of active validator kinds and registry-derived versions
• stateless-validator-common - Canonical no_std tests-zkevm v0.8.2 input and output schemas
• stateless-validator-downloader - Downloads republished ELFs and VKs from releases and workflow artifacts
• stateless-validator-test - Runs EEST and rolling devnet inputs against registry artifacts in dockerized zkVMs

Guest Artifacts

Ethrex v26.0.0-rc.2 and Reth v0.1.0-rc.2 are currently active on OpenVM, SP1, and ZisK. Zesu keeps catalog ID 2 reserved and remains inactive until compatible, checksum-backed release artifacts pass the same test matrix.

Pull requests run a pinned 10-block glamsterdam-devnet-8 fixture set. The daily workflow runs the latest 100 available blocks from the rolling catalog.

Development

Formatting

Formatting the workspace:

.github/scripts/cargo-fmt-all.sh

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.