Module 3 - Setup OP Geth Node
Setup OP Geth Node
Section titled “Setup OP Geth Node”Steps to start Postgres, Light Client, Geth, Rhea, Hercules, and optional Nginx via Docker.
This OP Geth node serves as a non-voting RPC node that enables executing Eth L2 transactions.
- Setting up an OP Geth Node needs OP Geth, Rhea, Hercules, Light Client (AKA Proxy), and Postgres.
- OP Geth has been modified to calculate gas based on the required Solana compute. It retrieves the required gas value by querying Light Client.
- Rhea picks up L2 transactions from OP Geth mempool, composes them into Solana transactions, and submits them to Solana for sequencing.
- Solana’s consensus voting nodes execute and vote on the ordering of these transactions. Hercules reads state from Solana nodes and confirms L2 transactions and ordering on OP Geth.
Machine specs
Section titled “Machine specs”We recommend using an Ubuntu machine with the specs below. However, macOS is also supported.
Run Docker containers with one command
Section titled “Run Docker containers with one command”docker compose up -d
Alternatively, Run Docker containers below sequentially
Section titled “Alternatively, Run Docker containers below sequentially”Postgres
Section titled “Postgres”docker compose up -d postgres_romedocker logs postgres_rome -f
Wait for the logs print out “database system is ready to accept connections”.
Apply Migrations
Section titled “Apply Migrations”docker compose up apply_migrations
Light Client
Section titled “Light Client”Light Client provides an Ethereum interface to access Solana state.
This includes providing gas estimates to Geth.
docker compose up -d proxy_romedocker logs proxy_rome -f
Wait for the logs print out “Starting the RPC server at 0.0.0.0:9090”.
Geth is the rollup client that accepts and executes Eth L2 transactions, and provides transaction results to the user. It is a non-voting RPC node.
docker compose up -d gethdocker logs geth -f
Wait for the logs print out “HTTP server started”.
Rhea takes rollup transactions from Geth, packages them as Rome Solana transactions, and submits them to Solana for sequencing.
docker compose up -d rheadocker logs rhea -f
Wait for the logs to print out “Polling: http://geth:8545”.
Hercules
Section titled “Hercules”Hercules reads state from Solana nodes and confirms L2 transactions and ordering on OP Geth.
docker compose up -d herculesdocker logs hercules -f
Wait for the logs to print out “SolanaBlockLoader is in sync with Solana validator”.
Deposit UI
Section titled “Deposit UI”Deposit UI enables users to deposit and withdraw SOL in exchange for rSOL that is used for gas payment on Rome.
docker compose up -d deposituidocker logs depositui -f
docker compose up -d romenginxdocker logs romenginx -f
Wait for the logs to print out “Configuration complete; ready for start up”.
Restart services if needed
Section titled “Restart services if needed”docker compose down -d
docker compose up -d
Docker containers overview
Section titled “Docker containers overview”The docker containers you ran are listed below.
Docker Container | Purpose |
---|---|
proxy_rome | Light Client |
geth | OP Geth |
rhea | Rhea |
hercules | Hercules |
postgres_rome | Postgres database |
apply_migrations | Postgres migrations |
deposituiui | Deposit UI |
romenginx | Nginx Proxy |