{"id":28083243,"url":"https://github.com/blockblaz/zeam","last_synced_at":"2026-02-06T04:12:01.868Z","repository":{"id":265948607,"uuid":"865514253","full_name":"blockblaz/zeam","owner":"blockblaz","description":"Ethereum beam client in Zig","archived":false,"fork":false,"pushed_at":"2025-07-31T18:21:34.000Z","size":270,"stargazers_count":49,"open_issues_count":4,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-31T20:29:39.170Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blockblaz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-30T16:52:00.000Z","updated_at":"2025-07-31T16:43:43.000Z","dependencies_parsed_at":"2025-01-10T17:25:08.950Z","dependency_job_id":"23774cee-acde-47b5-b3c0-936544eb4a93","html_url":"https://github.com/blockblaz/zeam","commit_stats":null,"previous_names":["blockblaz/zeam"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blockblaz/zeam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockblaz%2Fzeam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockblaz%2Fzeam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockblaz%2Fzeam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockblaz%2Fzeam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blockblaz","download_url":"https://codeload.github.com/blockblaz/zeam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockblaz%2Fzeam/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268162252,"owners_count":24205696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-13T09:00:56.105Z","updated_at":"2026-01-28T14:06:58.179Z","avatar_url":"https://github.com/blockblaz.png","language":"Zig","readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/blockblaz/zeam\"\u003e\u003cimg width=\"500\" title=\"Zeam\" src='assets/zeam-logo.png' /\u003e\u003c/a\u003e\u003c/p\u003e\n\n[![CI](https://github.com/blockblaz/zeam/actions/workflows/ci.yml/badge.svg)](https://github.com/blockblaz/zeam/actions/workflows/ci.yml)\n[![risc0](https://github.com/blockblaz/zeam/actions/workflows/risc0.yml/badge.svg)](https://github.com/blockblaz/zeam/actions/workflows/risc0.yml)\n\n# zeam - Zig Beam Client\n\nBeam Chain is a futuristic ZK based Ethereum Consensus Protocol first [unveiled in Devcon 7 Bangkok Thailand, Nov 2024](https://www.youtube.com/watch?v=Gjuenkv1zrw)\nand is meant to upgrade the current Beacon Chain when ready. Zeam is its production grade implementation (wip).\n\nThe heart of Beam Chain is to massively scale and decentralize ethereum consensus with provable and verifiable\nprotocol via ZK-VMs but also bundles some of the other disruptive ideas and learnings on ethereum consensus which \ncould be a bit harder to incrementally implement on the current Beacon Chain.\n\n## Beam Chain\n\n[Beam Chain Developments \u0026 Resources](./resources/beam.md)\n\n## Client Development\n\nAs is the ethos of ethereum community, beam protocol and specs will be developed in open. Zeam will not only\ntranslate those specs to an production grade zig client but also actively contribute to development of those\nspecs.\n\nWe also will collaborate actively with other Beam clients and collectively will push the protocol to maturity\nfor consideration and deployment to ethereum blockchain.\n\nWe are currently doing various POCs/libs development:\n\n - [POC of zig run time](https://github.com/blockblaz/zeam-runtime) with various ZK-VMs.\n - [Snappy](https://github.com/blockblaz/zig-snappy) \u0026 [Snappy frames](https://github.com/blockblaz/snappyframesz)\n - [Zig \u003c\u003e rust libp2p interops](https://github.com/blockblaz/zig-libp2p-pocs)\n - [Zig SSZ!](https://github.com/blockblaz/ssz.zig)\n - [Hash Signatures](https://github.com/blockblaz/hash-sigz)\n\nAnd all of these efforts culminating in a [ZEAM POC](./resources/zeam.md) with which we hope to aid in Beam Spec\nresearch especially with state transition proving.\n\nAs we go along, we will also be maintaining important [resources](./resources/) related to beam protocol, ZK and\nZK-VMs, and quantum security \u0026 updates.\n\n### Zig Ecosystem\n\nZig despite being relatively new is an upcoming ecosystem stack for ethereum protocol. We will aim to further push\nthe stack towards maturity via our modular client approach as well as independent libraries development and\ncontribution.\n\nPlease reach out to us if you are actively engaged in developing a library in the ecosystem that you may think\nwe can use and/or contribute to.\n\n### Zeam community\n\nPlease join us on our community to take part in conversations around Beam Protocol and Zeam Client:\n\n- [zeam community](https://t.me/zeamETH) telegram group\n- [zeamETH](https://x.com/zeamETH) X(formerly twitter) handle\n\n### Contributions\n\nZeam will welcome opensource contributions that meaningfully further the development of Zeam client. Keep Watching\nout for this space for annoucements on the same or reach out to us via our [community telegram group](https://t.me/zeamETH)\n\n### Build instructions\n\n#### Docker\n\nDocker images are built in CI using `Dockerfile.prebuilt`, which packages pre-built binaries. This avoids intermittent build failures caused by a [Zig HTTP connection pool bug](https://github.com/ziglang/zig/issues/21316) when building inside Docker.\n\nTo build a Docker image locally:\n```bash\n# Build zeam natively first\nzig build -Doptimize=ReleaseFast -Dgit_version=\"$(git rev-parse --short HEAD)\"\n\n# Then create Docker image with pre-built binary\ndocker build -f Dockerfile.prebuilt -t zeam:local .\n```\n\nFor publishing to a public registry, add OCI labels for better traceability:\n```bash\ndocker build -f Dockerfile.prebuilt \\\n  --build-arg GIT_COMMIT=$(git rev-parse HEAD) \\\n  --build-arg GIT_BRANCH=$(git rev-parse --abbrev-ref HEAD) \\\n  -t blockblaz/zeam:latest .\n```\n\n#### Prerequisites\n\n - Zeam requires zig version 0.14.1 to build.\n - Zeam requires Rust 1.85+ to be able to build the rust connections to various zkvms\n - Both [risc0](https://github.com/risc0/risc0) (v3.0.3) and OpenVM provers are supported:\n   - risc0 requires the toolchain to be [installed](https://dev.risczero.com/api/zkvm/install): `rzup install r0vm 3.0.3`\n   - OpenVM is self-contained (no external toolchain needed)\n\n#### Build\n\nIn order to build the transition functions (one for each supported zkvm), as well as the whole client, type:\n\n```\n\u003e zig build -Doptimize=ReleaseFast\n```\n\nat the root of the repository.\n\n#### Running the prover demo\n\n```\n\u003e zig build -Doptimize=ReleaseFast install run -- prove\n```\n\n### Local Lean Devnet\n\nTo run a local devnet with multiple nodes for testing and development, see the [Local Devnet Setup Guide](./pkgs/cli/test/fixtures/README.md) which provides detailed instructions for running a 2-node setup with finalization.\n\nor checkout the [lean-quickstart](https://github.com/blockblaz/lean-quickstart) submodule (`git submodule update --init lean-quickstart`) use the handy command line tool to spin up two nodes for local interop.\n\n#### Checkpoint Sync\n\nZeam supports checkpoint sync for faster initial synchronization. You can start a node from a trusted finalized checkpoint state by using the `--checkpoint-sync-url` parameter. See the [Local Devnet Setup Guide](./pkgs/cli/test/fixtures/README.md#checkpoint-sync) for detailed documentation and examples.\n\n### Testing Scenarios\n\n1. Test blocks by root [parent-sync](./resources/parent-sync.md)\n2. Test checkpoint sync [checkpoint-sync](./resources/checkpoint-sync.md)\n\n### Reporting Issues\n\nOpen an [issue or a bug](https://github.com/blockblaz/zeam/issues/new) or else talk to us via our [community telegram group](https://t.me/zeamETH). \n","funding_links":[],"categories":["Network \u0026 Web"],"sub_categories":["Web3 Framework"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblockblaz%2Fzeam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblockblaz%2Fzeam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblockblaz%2Fzeam/lists"}