What's this?

Do you want to run an archive node + block explorer in your machine using only 1 command and (almost) no devops knowledge?

This repo provides a series of pre-configured docker compose files that spin-up a Prysm (consensus layer client) + Erigon (execution layer archive node; alpha series) + Otterscan (block explorer).

Just follow the instructions, fill in the gaps and run it. Or customize it for your needs. Or improve it and contribute it back, it's all opensource.

The twitter 🧵 that originated this project: https://twitter.com/wmitsuda/status/1535148383555530757

How much disk space does it take?

As of Aug/2022.

Sepolia testnet

• 2.1GB for Erigon sepolia archive
• 320MB for Prysm sepolia beacon chain

Sepolia testnet (akula + lighthouse)

• 2.5GB for Akula sepolia archive
• 1.0GB for Lighthouse sepolia beacon chain

Goerli testnet

• 188GB for Erigon goerli archive
• 286MB for Prysm goerli beacon chain (checkpoint sync)

Ropsten testnet (deprecated)

• 266GB for Erigon ropsten archive
• 4.3GB for Prysm ropsten beacon chain

Run it

Requirements

• Docker compose V2 (see: https://stackoverflow.com/a/66516826/49530)

Sepolia testnet

1. Clone this repo
2. Create empty dirs for erigon (<erigon-data-dir>) and prysm (<prysm-data-dir>) databases
3. On /sepolia directory, run: PRYSM_DATA="<prysm-data-dir>" ERIGON_DATA="<erigon-data-dir>" docker compose up
4. Wait a few hours until the archive node finishes syncing sepolia
5. You should be able to access Otterscan block explorer to browse your archive by accessing: http://localhost:3000/

Sepolia testnet (akula + lighthouse **** HIGHLY EXPERIMENTAL ****)

1. Clone this repo
2. Create empty dirs for akula (<akula-data-dir>) and lighthouse (<lighthouse-data-dir>) databases
3. On /sepolia-akula-lighthouse directory, run: LIGHTHOUSE_DATA="<lighthouse-data-dir>" AKULA_DATA="<akula-data-dir>" docker compose up
4. Wait a few hours until the archive node finishes syncing sepolia
5. You should be able to access Otterscan block explorer to browse your archive by accessing: http://localhost:3000/

Updating the local akula image

Akula has no stable releases or tags so far, so we build an in-place docker image during the service start process. It is pinned to a pre-defined git commit hash.

That means if the Dockerfile gets updated, you need to manually run on /sepolia-akula-lighthouse directory: LIGHTHOUSE_DATA="<lighthouse-data-dir>" AKULA_DATA="<akula-data-dir>" docker compose build

Goerli testnet

1. Clone this repo
2. Create empty dirs for erigon (<erigon-data-dir>) and prysm (<prysm-data-dir>) databases
3. On /goerli directory, run: PRYSM_DATA="<prysm-data-dir>" ERIGON_DATA="<erigon-data-dir>" docker compose up
4. Wait 1-2 days until the archive node finishes syncing goerli
5. You should be able to access Otterscan block explorer to browse your archive by accessing: http://localhost:3000/

Ropsten testnet (deprecated)

1. Clone this repo
2. Create empty dirs for erigon (<erigon-data-dir>) and prysm (<prysm-data-dir>) databases
3. On /ropsten diretory, run: PRYSM_DATA="<prysm-data-dir>" ERIGON_DATA="<erigon-data-dir>" docker compose up
4. Wait 1-2 days until the archive node finishes syncing ropsten
5. You should be able to access Otterscan block explorer to browse your archive by accessing: http://localhost:3000/

Remember that ropsten is deprecated and will have no more upgrades after the merge