# Baremetal ## System Requirements | CPU | OS | RAM | DISK | | :----------: | :--------------------: | :----------: | :-------------------: | | 8+ cores CPU | Debian 12/Ubuntu 22.04 | => 16 GB RAM | 1TB+ (NVME preffered) | {% hint style="info" %} *The Base archive node reached a size of 804GB by May 2, 2024* {% endhint %} ## Base 🔵 {% hint style="success" %} Base is a secure, low-cost Ethereum L2 built on Optimism’s open-source [OP Stack](https://stack.optimism.io/). In this guide, Optimism's `op-erigon` and `op-node`binaries are built from source to facilitate the node's installation. This method has proved to sync an archive node successfully in \~48 hours using the official snapshot provided by the Base team. {% endhint %} {% hint style="warning" %} Before you start, make sure that you have your own synced Ethereum L1 RPC URL (e.g. Erigon) and L1 Consensus Layer Beacon endpoint (e.g. Lighthouse) ready. {% endhint %} ## Pre-Requisites {% code overflow="wrap" %} ```bash sudo apt update -y && sudo apt upgrade -y && sudo apt autoremove -y sudo apt install -y git make wget gcc pkg-config libusb-1.0-0-dev libudev-dev jq gcc g++ curl libssl-dev screen apache2-utils build-essential pkg-config ``` {% endcode %} ### Setting up Firewall Set explicit default UFW rules ```bash sudo ufw default deny incoming sudo ufw default allow outgoing ``` Allow SSH ```bash sudo ufw allow 22/tcp ``` Allow remote RPC connections with Base Node ```bash sudo ufw allow from ${REMOTE.HOST.IP} to any port 8545 ``` {% hint style="warning" %} Not advised to allow all or unknown IP address to RPC port {% endhint %} Enable Firewall ```bash sudo ufw enable ``` ## Download a snapshot Snapshots URL: *Create a directory and start downloading an archive in screen session as it takes \~9 hours* {% code overflow="wrap" %} ```bash mkdir base && cd base screen -S archive aria2c --file-allocation=none -c -x 10 -s 10 "https://datadirs.testinprod.io/base-mainnet-db-14631082.zst" ``` {% endcode %} ```bash #to return to previous screen and continue installation press Ctrl+a+d ``` ## Compile Op-node ### Required Software Dependencies
DependencyVersionVersion Check Command
go^1.21go version
node^20node --version
pnpm^8pnpm --version
foundry^0.2.0forge --version
make^4make --version
yarn1.22.21yarn --version
nvm0.39.3nvm --verison
### Install go {% code overflow="wrap" fullWidth="false" %} ```bash sudo wget https://go.dev/dl/go1.21.6.linux-amd64.tar.gz && sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.21.6.linux-amd64.tar.gz && rm go1.21.6.linux-amd64.tar.gz ``` {% endcode %} ### Install nvm ```bash wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash ``` ### Download foundry ```bash curl -L https://foundry.paradigm.xyz | bash ``` ### Install foundry ```bash foundryup source /root/.bashrc ``` ### Install node and yarn ```bash nvm install 16 && npm install --global yarn && nvm use 16 && npm -g install pnpm source /root/.bashrc ``` ### Check if go and all dependancies are installed ```bash go version nvm -v npm -v yarn -v pnpm -v ``` ### Create directories ```bash mkdir -p /root/github mkdir -p /root/data/base/op-node mkdir -p /root/data/base/op-erigon ``` ### Build op-node ```bash cd /root/github/ git clone https://github.com/ethereum-optimism/optimism.git cd optimism git checkout v1.7.0 nvm install && npm install --global yarn && nvm use node && npm -g install pnpm pnpm install pnpm build make op-node ``` *#The binary is built at /root/github/optimism/op-node/bin/op-node* ### Create systemd service {% hint style="warning" %} You'll need your own synced Ethereum L1 RPC URL (e.g. Erigon) and L1 Consensus Layer Beacon endpoint (e.g. Lighthouse) in order to run Base {% endhint %} {% code overflow="wrap" %} ```bash echo "[Unit] Description=Base OP Node Service After=network.target StartLimitIntervalSec=60 StartLimitBurst=3 [Service] Type=simple Restart=on-failure RestartSec=5 TimeoutSec=900 User=root Nice=0 LimitNOFILE=200000 WorkingDirectory=/root/data/base/op-node/ ExecStart=/root/data/optimism/op-node/bin/op-node \ --l1=http://:9656 \ --l1.beacon=http://:5052 \ --l1.trustrpc=true \ --l1.rpckind=erigon \ --l2=http://0.0.0.0:8552 \ --l2.jwt-secret=/root/data/base/erigon/jwt.hex \ --rpc.addr=0.0.0.0 \ --rpc.port=9546 \ --rollup.config=/root/data/base/erigon/rollup.json \ --metrics.enabled \ --metrics.addr=0.0.0.0 \ --metrics.port=7301 \ --network=base-mainnet \ --p2p.listen.tcp=9923 \ --p2p.listen.udp=9923 \ --p2p.bootnodes=enr:-J24QNz9lbrKbN4iSmmjtnr7SjUMk4zB7f1krHZcTZx-JRKZd0kA2gjufUROD6T3sOWDVDnFJRvqBBo62zuF-hYCohOGAYiOoEyEgmlkgnY0gmlwhAPniryHb3BzdGFja4OFQgCJc2VjcDI1NmsxoQKNVFlCxh_B-716tTs-h1vMzZkSs1FTu_OYTNjgufplG4N0Y3CCJAaDdWRwgiQG,enr:-J24QH-f1wt99sfpHy4c0QJM-NfmsIfmlLAMMcgZCUEgKG_BBYFc6FwYgaMJMQN5dsRBJApIok0jFn-9CS842lGpLmqGAYiOoDRAgmlkgnY0gmlwhLhIgb2Hb3BzdGFja4OFQgCJc2VjcDI1NmsxoQJ9FTIv8B9myn1MWaC_2lJ-sMoeCDkusCsk4BYHjjCq04N0Y3CCJAaDdWRwgiQG,enr:-J24QDXyyxvQYsd0yfsN0cRr1lZ1N11zGTplMNlW4xNEc7LkPXh0NAJ9iSOVdRO95GPYAIc6xmyoCCG6_0JxdL3a0zaGAYiOoAjFgmlkgnY0gmlwhAPckbGHb3BzdGFja4OFQgCJc2VjcDI1NmsxoQJwoS7tzwxqXSyFL7g0JM-KWVbgvjfB8JA__T7yY_cYboN0Y3CCJAaDdWRwgiQG,enr:-J24QHmGyBwUZXIcsGYMaUqGGSl4CFdx9Tozu-vQCn5bHIQbR7On7dZbU61vYvfrJr30t0iahSqhc64J46MnUO2JvQaGAYiOoCKKgmlkgnY0gmlwhAPnCzSHb3BzdGFja4OFQgCJc2VjcDI1NmsxoQINc4fSijfbNIiGhcgvwjsjxVFJHUstK9L1T8OTKUjgloN0Y3CCJAaDdWRwgiQG,enr:-J24QG3ypT4xSu0gjb5PABCmVxZqBjVw9ca7pvsI8jl4KATYAnxBmfkaIuEqy9sKvDHKuNCsy57WwK9wTt2aQgcaDDyGAYiOoGAXgmlkgnY0gmlwhDbGmZaHb3BzdGFja4OFQgCJc2VjcDI1NmsxoQIeAK_--tcLEiu7HvoUlbV52MspE0uCocsx1f_rYvRenIN0Y3CCJAaDdWRwgiQG \ --verifier.l1-confs=4 \ --rollup.load-protocol-versions=true KillSignal=SIGTERM [Install] WantedBy=multi-user.target" > /etc/systemd/system/op-node.service ``` {% endcode %} ```bash sudo nano /etc/systemd/system/op-node.service #make changes in op-node service file sudo systemctl daemon-reload #refresh systemd configuration when changes made sudo systemctl start op-node.service #start op-node sudo systemctl enable op-node.service #enable op-node service at system startup sudo journalctl -fu op-node.service #follow logs of op-node service ``` ## Compile Erigon ```bash cd /root/github/ git clone https://github.com/testinprod-io/op-erigon cd op-erigon git checkout v2.60.0-0.6.1 make ``` #### Create JWT secret file and download genesis and rollup .json files ```bash cd /root/data/base/erigon openssl rand -hex 32 > /root/data/base/erigon/jwt.txt curl -LO https://raw.githubusercontent.com/base-org/node/main/mainnet/genesis-l2.json curl -LO https://raw.githubusercontent.com/base-org/node/main/mainnet/rollup.json ``` ### Create systemd service ```bash sudo echo "[Unit] Description=Erigon Base Service After=network.target StartLimitIntervalSec=60 StartLimitBurst=3 [Service] Type=simple Restart=on-failure RestartSec=5 TimeoutSec=900 User=root Nice=0 LimitNOFILE=200000 WorkingDirectory=/root/data/base/erigon/ ExecStart=/root/data/github/op-erigon/build/bin/erigon \ --datadir=/root/data/base/erigon/datadir \ --ethash.dagdir=/root/data/base/erigon/datadir/ethash \ --authrpc.jwtsecret=/root/data/base/erigon/jwt.hex \ --authrpc.port=8552 \ --http \ --http.addr=0.0.0.0 \ --http.port=9660 \ --http.compression \ --http.vhosts=* \ --http.corsdomain=* \ --http.api=eth,debug,net,trace,web3,erigon \ --private.api.addr=0.0.0.0:9095 \ --ws --ws.compression \ --metrics --metrics.addr=0.0.0.0 --metrics.port=9700 \ --torrent.download.rate 80mb \ --torrent.port=42070 \ --rpc.returndata.limit=1000000 \ --txpool.gossip.disable=true \ --chain=base-mainnet \ --db.size.limit=8TB \ --nodiscover \ --p2p.allowed-ports=30303,30304,30305,30306,30307,30308,30309,30310 \ --rollup.sequencerhttp="https://mainnet-sequencer.base.org" KillSignal=SIGTERM [Install] WantedBy=multi-user.target" > /etc/systemd/system/op-erigon.service ``` ## Sync using downloaded Snapshot ```bash screen –r archive ls #to see the name of downloaded archive zstd --decompress base-mainnet-db-14631082.zst -o mdbx.dat ``` *#Unzipping takes \~3-4 hrs so you can go touch some grass* Consider switching screen by pressing`ctrl A+D`to allow a process run in the background #### After extracting is done move the contents of geth directory into op-erigon data directoy: ```bash mv mdbx.dat /root/data/erigon/datadir/chaindata/ ``` ### Start op-erigon ```bash sudo systemctl daemon-reload #refresh systemd configuration when changes made sudo systemctl start op-erigon.service #start op-erigon sudo systemctl enable op-erigon.service #enable op-erigon service at system startup sudo journalctl -fu op-erigon.service #follow logs of op-erigon service ``` {% hint style="info" %} To check or modify `op-erigon.service` parameters simply run `sudo nano /etc/systemd/system/op-erigon.service` Ctrl+X and Y to save changes {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.infradao.com/archive-nodes-101/base/erigon/baremetal.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.