Skip to content

Latest commit

 

History

History
152 lines (108 loc) · 4.38 KB

docker.md

File metadata and controls

152 lines (108 loc) · 4.38 KB
description
Authors: [ JleopoldA ]

🐳 Docker

System Requirements

CPU OS RAM DISK
4 Core Ubuntu 22.04.4 16GB RAM 1.5TB

{% hint style="info" %} Blast Archival node has a size of 1.5TB on September 30, 2024. {% endhint %}

Blast

{% hint style="info" %} To run Blast you need to utilize an L1 node for Blast to interact with. Instructions on how to do so can be found here.
https://docs.prylabs.network/docs/install/install-with-script {% endhint %}

Official Docs

https://docs.blast.io/about-blast

Pre-Requisites

Update, upgrade, clean the system, and apply firewall management (ufw).

# Update, upgrade and clean system
sudo apt update -y && sudo apt upgrade -y && sudo apt auto-remove -y
# Set explicit default UFW rules
sudo ufw default deny incoming && sudo ufw default allow outgoing

# Allow SSH, HTTP and HTTPS
sudo ufw allow 22/tcp
sudo ufw allow 80
sudo ufw allow 443

Install Docker & Docker Compose

The following code will install Docker & Docker Compose, both are necessary requirements to run Blast.

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

# Install Docker Packages
 sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
 
 # Verify Docker Installation is Successful
sudo docker run hello-world

# Install Docker-Compose
sudo apt-get update
sudo apt-get install docker-compose-plugin

# Verify Docker-Compose installation by checking the version
docker compose version

# Expected output
Docker Compose version vN.N.N

Create Blast Directory

The command "mkdir blast" will create a directory named "blast" within your current working directory. The second command will alter your current working directory to the newly created "blast" directory. 

mkdir blast && cd blast

Clone Blast-IO Deployment Repository

The Blast deployment repository contains the necessary Docker Compose Configurations. We will obtain the Deployment repository while within our "blast" directory.
The commands "git clone git@github.com:blast-io/deployment.git" or
"git clone https://github.com/blast-io/deployment.git" will download the repository.
The command "cd deployment" will change your current working directory to the deployment directory.

# Download Deployment Repository using SSH
git clone git@github.com:blast-io/deployment.git
cd deployment

# If you receive errors running "git clone git@github.com:blast-io/deployment.git"
# You can download it this way instead
git clone https://github.com/blast-io/deployment.git
cd deployment

Create .env file

sudo nano .env

Paste the following into your newly created .env file.

# NETWORK should be mainnet or sepolia
NETWORK={YOUR_NETWORK} # Set to either mainnet or sepolia
GETH_DATA_DIR=blast-get-data # The path where you want to store blockchain data
L1_RPC_URL={YOUR_RPC_ENDPOINT_URL} # L1 node RPC endpoint URL
L1_RPC_KIND={YOUR_RPC_KIND} # Type of RPC provider (alcehmy, infura, any, etc)
OP_NODE_L1_BEACON={YOUR_L1_BEACON_API} # Your L1 Beacon api endpoint

Start Docker Containers

docker compose up -d

This pulls the latest version of the pre-built Docker images and starts the necessary containers.

Query Blast Node

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' http://localhost:8545

# The response should resemble the following:
{"jsonrpc":"2.0","id":1,"result":"0xcab5ab"}

View Docker Logs

docker logs blast-geth -f --tail 100

References

https://docs.blast.io/building/guides/node/basic