Skip to content

Blobstream for validators

Blobstream allows Ethereum developers to build high-throughput L2s using Celestia, the first data availability layer with data availability sampling.

This page and following tutorials will go over Blobstream and how validators on Celestia can run it.

If you're looking to learn more, you can view the orchestrator-relayer repository or read more about how Blobstream works.

Install the Blobstream binary

The orchestrator is the software that signs the Blobstream attestations, and the relayer is the software that relays them to the target EVM chain.

The following sections in this category presume you have the following setup:

  • A celestia-app validator node running
  • The following hardware minimum requirements for running the orchestrator:
    • Memory: 2 GB RAM
    • CPU: 1 core
    • Disk: 10 GB SSD Storage

Install

  1. Install Go 1.21.4

  2. Clone the https://github.com/celestiaorg/orchestrator-relayer repository:

    bash
    git clone https://github.com/celestiaorg/orchestrator-relayer.git
    cd orchestrator-relayer
    git checkout v1.0.1
    git clone https://github.com/celestiaorg/orchestrator-relayer.git
    cd orchestrator-relayer
    git checkout v1.0.1

    These commands check you out to: v1.0.1 of @celestiaorg/orchestrator-relayer

  3. Install the Blobstream CLI

    sh
    make install
    make install

Usage

sh
# Print help
blobstream --help
# Print help
blobstream --help

Next steps

  1. If you are a Celestia validator, all you need to do is run the orchestrator. Check out the Blobstream orchestrator page for more details.
  2. Learn about key management
  3. Optional: If you want to post commitments on an EVM chain, you will need to deploy a new Blobstream contract and run a relayer, or run a relayer for an already deployed Blobstream contract. Check out the Blobstream relayer page for relayer docs and the Blobstream deployment page for how to deploy a new Blobstream contract.
  4. Optional: Learn how to run a Blobstream bootstrapper node

TIP

The Blobstream P2P network is a separate network than the consensus or the data availability one. Thus, you will need its specific bootstrappers to be able to connect to it.

The smart contract implementation is in blobstream-contracts.

The state machine implementation is in x/blobstream.

Blobstream ADRs are in the docs.

Blobstream design explained in this blog post on layer 2s.