Beerus

Beerus

Beerus is a Starknet Light Client inspired by and using helios. It is designed to be simple, modular, and fast, supporting the Starknet v0.6.0 OpenRPC spec.

Copy the configuration file from etc/conf/beerus.toml and set up the RPC provider URLs in the copy. Make sure that providers are compatible. Read more about providers here.

Run the following command to start Beerus:

cargo run --release -- -c ./path/to/config.toml

To verify that Beerus is up and running, try this request:

curl -H 'Content-type: application/json' -d '{
    "jsonrpc": "2.0",
    "method": "starknet_getStateRoot",
    "params": [],
    "id": 1
}' http://127.0.0.1:3030

{
  "jsonrpc": "2.0",
  "result": "0x539895aff28be4958188c1d4e8e68ee6772bdd49dd9362a4fbb189e61c54ff1",
  "id": 1
}

Ensure that eth_execution_rpc and starknet_rpc URLs correspond to the selected network (MAINNET or SEPOLIA).

Beerus relies on two untrusted RPC endpoints:

• Starknet RPC endpoint: Requires v0.6.0 of the Starknet OpenRPC specs and support for Pathfinder's extension API.
• Ethereum RPC endpoint: No special requirements; must support Ethereum JSON-RPC Specification.

cargo build --all --release

cargo test --all

Build the Docker image:

docker build . -t beerus

Run the Docker container:

docker run -e NETWORK=<arg> -e ETH_EXECUTION_RPC=<arg> -e STARKNET_RPC=<arg> -it beerus

Run examples with:

ALCHEMY_API_KEY='YOURAPIKEY' cargo run --example basic
ALCHEMY_API_KEY='YOURAPIKEY' cargo run --example call