https://github.com/wmitsuda/one-liner-archive

Spin-up ethereum archive nodes + block explorer in one line
https://github.com/wmitsuda/one-liner-archive

blockchain erigon ethereum

Last synced: about 5 hours ago
JSON representation

Spin-up ethereum archive nodes + block explorer in one line

• Host: GitHub
• URL: https://github.com/wmitsuda/one-liner-archive
• Owner: wmitsuda
• License: mit
• Created: 2022-06-15T21:03:45.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-09-21T17:53:41.000Z (about 2 years ago)
• Last Synced: 2023-03-04T04:12:08.211Z (over 1 year ago)
• Topics: blockchain, erigon, ethereum
• Language: Dockerfile
• Homepage:
• Size: 23.9 MB
• Stars: 26
• Watchers: 3
• Forks: 6
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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 (``) and prysm (``) databases

3. On `/sepolia` directory, run: `PRYSM_DATA="" ERIGON_DATA="" 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 (``) and lighthouse (``) databases

3. On `/sepolia-akula-lighthouse` directory, run: `LIGHTHOUSE_DATA="" AKULA_DATA="" 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="" AKULA_DATA="" docker compose build`

## Goerli testnet

1. Clone this repo

2. Create empty dirs for erigon (``) and prysm (``) databases

3. On `/goerli` directory, run: `PRYSM_DATA="" ERIGON_DATA="" 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 (``) and prysm (``) databases

3. On `/ropsten` diretory, run: `PRYSM_DATA="" ERIGON_DATA="" 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