Package Logo
beacon_explorer
beacon-explorer@v0.1.0
README

Beacon Explorer

The Ethereum Beacon Chain Explorer consists of several Substreams modules showcasing the most basic operations that you can perform with Substreams on the Ethereum Beacon blockchain.

Before You Begin

Make sure you have the Substreams CLI installed, and you know the basic structure of a Substreams module. You must also provide a Pinax API key as $SUBSTREAMS_API_KEY environment variable

Modules

The substreams package in this repository provides the following substreams modules:

  • map_block_meta - streams some block metadata, such as slot number, root hash, spec version, timestamp, etc
  • map_block_full - streams the entire block content to help you explore available fields
  • map_blobs - streams blobs embedded into the beacon chain block

Building the Substreams

First, generate the Protobuf code, which is the output of the Substreams:

> make protogen

Then, build the Rust code using the cargo command-line tool:

> make build

Running Substreams modules

And now you can stream the corresponding substreams modules:

> make run map_block_meta
> make run map_block_full
> make run map_blobs

Alternatively, you can take advantage of substreams gui command for a nicer user interface:

> make gui map_block_meta
> make gui map_block_full
> make gui map_blobs

Or, you can just use substreams command to run it:

> substreams run -e eth-cl.substreams.pinax.network:443 map_block_meta -s -10

Endpoints

Pinax offers the following beacon chain substreams endpoints:

  • eth-cl.substreams.pinax.network:443
  • gnosis-cl.substreams.pinax.network:443
  • sepolia-cl.substreams.pinax.network:443
  • holesky-cl.substreams.pinax.network:443
  • chiado-cl.substreams.pinax.network:443
)
Documentation
Modules
Maps icon
Maps

map
map_block_meta

a706d3c75027d5f09161729195f31cb30f2b3338
map map_block_meta (
blocksf.beacon.type.v1.Block
)  -> beacon.block_meta.v1.BlockMeta

map_block_meta allows you to view a basic information about a block

substreams gui beacon-explorer@v0.1.0 map_block_meta

map
map_block_full

015e9042ae842f300328b72ac141507da23f2744
map map_block_full (
)  -> sf.beacon.type.v1.Block

map_block_full allows you to view a complete block, as received by a Substreams module

substreams gui beacon-explorer@v0.1.0 map_block_full

map
map_blobs

19ef8109fbbd4b04e52dc60d427bbb9d16947cda

map_blobs allows you to view blobs inside a block

substreams gui beacon-explorer@v0.1.0 map_blobs
Protobuf

Protobuf Docs Explorer

sf.beacon.type.v1
beacon.block_meta.v1
beacon.blobs.v1