https://github.com/risc0/blobstream0
https://github.com/risc0/blobstream0
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/risc0/blobstream0
- Owner: risc0
- License: apache-2.0
- Created: 2024-06-07T15:39:24.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-17T19:01:16.000Z (6 months ago)
- Last Synced: 2025-04-05T08:35:04.768Z (3 months ago)
- Language: Rust
- Size: 395 KB
- Stars: 11
- Watchers: 13
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Blobstream Zero
> WARNING: This project is currently experimental and not recommended for any production use cases yet
Blobstream Zero is an implementation of [Blobstream](https://docs.celestia.org/developers/blobstream) using the [RISC Zero zkVM](https://www.risczero.com/) to verify Celestia blocks.
The blocks are verified using a zk Tendermint light client with the [light-client-guest](./light-client-guest/guest/src/main.rs) program, which will verify the light client block transition as well as generating a merkle root of all intermediate blocks. This proof is then verified on Ethereum using the [Blobstream solidity contracts](./contracts/src/).
The ABI for the Blobstream Zero solidity contract as well as the merkle tree format for the batch proof is currently matching previous implementations to maintain as much compatibility with previous solutions as well as the [existing APIs to request Blobstream inclusion proofs](https://docs.celestia.org/developers/blobstream-proof-queries#_1-data-root-inclusion-proof).
### Usage
Clone this repository, then pull submodules:
```console
git submodule update --init --recursive
```
Ensure [Rust](https://www.rust-lang.org/tools/install), [Foundry](https://book.getfoundry.sh/getting-started/installation), and [the RISC Zero toolchain](https://dev.risczero.com/api/zkvm/install) are installed.
Build guest programs and update autogenerated files:
```console
# Could also run `cargo build`
cargo check
```
Optionally run tests, which includes an [end to end test](./host/tests/e2e_test.rs):
```console
cargo test
```
Run the CLI to generate proofs or post those proofs on an Eth based network:
```console
cargo run -p blobstream0 -- --help
```
For docs on running the Blobstream service, see [usage-guide.md](./usage-guide.md).
> Note: This CLI as well as other APIs will change in the short term. If you need anything specific from this, [open an issue](https://github.com/risc0/blobstream0/issues/new)!