Base node
Base is a secure, low-cost, developer-friendly Ethereum L2 built to bring the next billion users onchain. It's built on Optimism’s open-source OP Stack.
This repository contains the relevant Docker builds to run your own node on the Base network.
Hardware requirements
We recommend you have this configuration to run a node:
- at least 16 GB RAM
- an SSD drive with at least 1 TB free
Troubleshooting
If you encounter problems with your node, please open a GitHub issue or reach out on our Discord:
- Once you've joined, in the Discord app go to
server menu
>Linked Roles
>connect GitHub
and connect your GitHub account so you can gain access to our developer channels - Report your issue in
#🛟|node-support
Supported networks
Ethereum Network | Status |
---|---|
Goerli testnet | ✅ |
Sepolia testnet | ✅ |
Mainnet | ✅ |
Usage
- Ensure you have an Ethereum L1 full node RPC available (not Base), and set
OP_NODE_L1_ETH_RPC
(in the.env.*
file if using docker-compose). If running your own L1 node, it needs to be synced before Base will be able to fully sync. - Uncomment the line relevant to your network (
.env.goerli
,.env.sepolia
, or.env.mainnet
) under the 2env_file
keys indocker-compose.yml
. - Run:
docker compose up --build
- You should now be able to
curl
your Base node:
curl -d '{"id":0,"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false]}' \
-H "Content-Type: application/json" http://localhost:8545
Note: Some L1 nodes (e.g. Erigon) do not support fetching storage proofs. You can work around this by specifying --l1.trustrpc
when starting op-node (add it in op-node-entrypoint
and rebuild the docker image with docker compose build
.) Do not do this unless you fully trust the L1 node provider.
You can map a local data directory for op-geth
by adding a volume mapping to the docker-compose.yaml
:
services:
geth: # this is Optimism's geth client
...
volumes:
- $HOME/data/base:/data
supervisord
Running in single container with If you'd like to run the node in a single container instead of docker-compose
, you can use the supervisord
entrypoint.
This is useful for running the node in a Kubernetes cluster, for example.
Note that you'll need to override some of the default configuration that assumes a multi-container environment (OP_NODE_L2_ENGINE_RPC
) and any port conflicts (OP_NODE_RPC_PORT
).
Example:
docker run --env-file .env.goerli -e OP_NODE_L2_ENGINE_RPC=ws://localhost:8551 -e OP_NODE_RPC_PORT=7545 ghcr.io/base-org/node:latest
Snapshots
If you're a prospective or current Base Node operator and would like to restore from a snapshot to save time on the initial sync, it's possible to always get the latest available snapshot of the Base chain on mainnet and/or testnet by using the following CLI commands. The snapshots are updated every hour.
Mainnet
wget https://base-mainnet-archive-snapshots.s3.us-east-1.amazonaws.com/$(curl https://base-mainnet-archive-snapshots.s3.us-east-1.amazonaws.com/latest)
Testnet
wget https://base-goerli-archive-snapshots.s3.us-east-1.amazonaws.com/$(curl https://base-goerli-archive-snapshots.s3.us-east-1.amazonaws.com/latest)
Syncing
Sync speed depends on your L1 node, as the majority of the chain is derived from data submitted to the L1. You can check your syncing status using the optimism_syncStatus
RPC on the op-node
container. Example:
command -v jq &> /dev/null || { echo "jq is not installed" 1>&2 ; }
echo Latest synced block behind by: \
$((($( date +%s )-\
$( curl -s -d '{"id":0,"jsonrpc":"2.0","method":"optimism_syncStatus"}' -H "Content-Type: application/json" http://localhost:7545 |
jq -r .result.unsafe_l2.timestamp))/60)) minutes
Disclaimer
We’re excited for you to build on Base 🔵 — but we want to make sure that you understand the nature of the the node software and smart contracts offered here.
THE NODE SOFTWARE AND SMART CONTRACTS CONTAINED HEREIN ARE FURNISHED AS IS, WHERE IS, WITH ALL FAULTS AND WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY, NON- INFRINGEMENT, OR FITNESS FOR ANY PARTICULAR PURPOSE. IN PARTICULAR, THERE IS NO REPRESENTATION OR WARRANTY THAT THE NODE SOFTWARE AND SMART CONTRACTS WILL PROTECT YOUR ASSETS — OR THE ASSETS OF THE USERS OF YOUR APPLICATION — FROM THEFT, HACKING, CYBER ATTACK, OR OTHER FORM OF LOSS OR DEVALUATION.
You also understand that using the node software and smart contracts are subject to applicable law, including without limitation, any applicable anti-money laundering laws, anti-terrorism laws, export control laws, end user restrictions, privacy laws, or economic sanctions laws/regulations.