explaingit

mattsse/zeth

Analysis updated 2026-08-15 · repo last pushed 2025-05-23

1Audience · developerComplexity · 4/5StaleSetup · hard

TLDR

Zeth generates cryptographic proofs that Ethereum and Optimism blockchain blocks are valid, by replaying block construction inside a zero-knowledge virtual machine so anyone can verify correctness independently.

Mindmap

mindmap
  root((repo))
    What it does
      Proves blocks valid
      Replays block construction
      No trust needed
    Tech stack
      Rust
      RISC Zero zkVM
      Bonsai cloud proving
      GPU and CPU proving
    Modes
      Build blocks natively
      Run in emulator
      Prove with ZK
      Verify proofs
    Supported chains
      Ethereum mainnet
      Optimism
      Base
      Testnets
    Use cases
      ZK proof research
      Layer 2 development
      Verify without full node
    Audience
      ZK developers
      L2 teams
      Blockchain researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a cryptographic proof that a specific Ethereum block was executed correctly.

USE CASE 2

Verify an existing ZK proof of an Optimism block without running a full node.

USE CASE 3

Benchmark block-construction computation costs using the emulator mode.

USE CASE 4

Experiment with zero-knowledge proof systems for Layer 2 networks during research and development.

What is it built with?

RustRISC Zero zkVMBonsaiGPU

How does it compare?

mattsse/zeth0xallam/posthog0xallam/search-engine
Stars111
LanguagePythonC++
Last pushed2025-05-232026-03-262023-08-23
MaintenanceStaleMaintainedDormant
Setup difficultyhardmoderatehard
Complexity4/53/53/5
Audiencedeveloperpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires RISC Zero zkVM setup plus an RPC provider like Alchemy, and optionally a GPU or Bonsai cloud account for proving.

No license information is provided in the explanation, so the licensing terms for this repository are unknown.

In plain English

Zeth is an open-source tool that proves Ethereum and Optimism blockchain blocks are valid, without needing to trust a validator or sync committee. Instead of just claiming that a block was built correctly, Zeth generates a cryptographic proof that anyone can check independently. To do this, Zeth replays every step of block construction inside a special environment called the RISC Zero zkVM (a "zero-knowledge virtual machine"). It fetches block data from a standard RPC provider (like Alchemy) or a local cache, then does the full work of building the block from scratch: verifying signatures, checking account balances, applying transactions, paying rewards, and updating the state. Because all of this happens inside the zkVM, the output is a proof that the block execution was correct. The project offers four modes: build (construct blocks natively without proofs), run (test inside the emulator to measure computation cost), prove (generate a real ZK proof), and verify (check that a proof is valid). You can generate proofs locally on CPU or GPU, or offload the heavy work to Bonsai, RISC Zero's cloud-based proving service. Proofs are saved as files you can verify later. This is most useful for developers or teams working on zero-knowledge proof systems, Layer 2 networks, or anyone who wants to independently verify blockchain state without running a full node. The README notes that Zeth is not audited for production use, so it is currently better suited for experimentation and research than live deployments. It supports Ethereum mainnet and testnets (Sepolia, Holesky) along with Optimism, Base, and their testnets.

Copy-paste prompts

Prompt 1
Set up Zeth to generate a ZK proof for an Ethereum mainnet block using an Alchemy RPC provider, running locally on CPU.
Prompt 2
Use Zeth to benchmark the computation cost of constructing an Optimism block in run mode and compare it against Base.
Prompt 3
Fetch a recent Sepolia testnet block, generate a proof using Bonsai cloud proving, then verify the saved proof file locally.
Prompt 4
Explain the difference between Zeth's build, run, prove, and verify modes and when to use each one for blockchain block validation.

Frequently asked questions

What is zeth?

Zeth generates cryptographic proofs that Ethereum and Optimism blockchain blocks are valid, by replaying block construction inside a zero-knowledge virtual machine so anyone can verify correctness independently.

Is zeth actively maintained?

Stale — no commits in 1-2 years (last push 2025-05-23).

What license does zeth use?

No license information is provided in the explanation, so the licensing terms for this repository are unknown.

How hard is zeth to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is zeth for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.