Beerus

Report a Bug - Request a Feature - Ask a Question

Beerus is a StarkNet Light Client inspired by and using helios. The goal is to provide a simple and easy to use client to query StarkNet state and interact with contracts.

• Rust
• helios
• ethers-rs

Here is a high level overview of the architecture of Beerus.

Here is a simple overview of how Beerus work. The example is for querying a storage value of a StarkNet contract.

To install with beerusup:

curl -sL https://raw.githubusercontent.com/keep-starknet-strange/beerus/main/beerusup | sh

cargo build --release

cargo test

Beerus is configurable through environment variables.

cp examples/.env.example .env
source .env

The project requires an Ethereum node and a Starknet node. For Ethereum nodes you can use Alchemy (not Infura since it does not support getProof endpoint).

Ethereum execution layer RPC URL (must be an Ethereum provider that supports the eth_getProof endpoint).

Ethereum consensus layer RPC URL (must be a consensus node that supports the light client beacon chain api)

For StarkNet node for the moment you can use Infura but soon verify proof will be implemented in Pathfinder nodes, and so will these nodes be working as well.

RUST_LOG=info cargo run --bin beerus-cli

RUST_LOG=info cargo run --bin beerus-rpc

See the open issues for a list of proposed features (and known issues).

• Top Feature Requests (Add your votes using the 👍 reaction)
• Top Bugs (Add your votes using the 👍 reaction)
• Newest Bugs

Reach out to the maintainer at one of the following places:

• GitHub Discussions
• Contact options listed on this GitHub profile

If you want to say thank you or/and support active development of Beerus:

• Add a GitHub Star to the project.
• Tweet about the Beerus.
• Write interesting articles about the project on Dev.to, Medium or your personal blog.

Together, we can make Beerus better!

First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

Please read our contribution guidelines, and thank you for being involved!

Beerus follows good practices of security, but 100% security cannot be assured. Beerus is provided "as is" without any warranty. Use at your own risk.

_For more information and to report security issues, please refer to our security documentation.

• Huge props to A16z for their work on helios.

The contributors page.

Thanks goes to these wonderful people (emoji key):

Abdel @ StarkWare ⚠️ 💻	Lucas @ StarkWare 💻	danilowhk 💻	Clément Walter 💻	Elias Tazartes 💻	drspacemn 💻	Mathieu 💻
TurcFort07 📖	Florian Bellotti 💻	Tom Brand 💻	ftupas 💻	pscott 💻
Add your contributions

This project follows the all-contributors specification. Contributions of any kind welcome!