node README

The project's README from github.com/base/node. As one markdown file: README.md.

[!CAUTION]

This repository is archived

Use releases from base/base for all new installations and upgrades. Development and releases have moved to base/base; this repository is no longer maintained.

Base

Base Node

Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's OP Stack. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus.

Website base.org Docs Discord Twitter Base Farcaster Base

Quick Start

  1. Ensure you have an Ethereum L1 full node RPC and beacon endpoint available.

  2. Choose your network:

    • For mainnet: use .env.mainnet
    • For testnet: use .env.sepolia
  3. Configure your L1 endpoints in the appropriate .env file:

    BASE_NODE_L1_ETH_RPC=<your-preferred-l1-rpc>
    BASE_NODE_L1_BEACON=<your-preferred-l1-beacon>
    
  4. Start the node:

    # For mainnet (default):
    docker compose up --build
    
    # For testnet:
    NETWORK_ENV=.env.sepolia docker compose up --build
    

Supported Clients

Requirements

Minimum Requirements

Production Hardware Specifications

The following are the hardware specifications we use in production:

Configuration

Required Settings

Network Settings

Optional Features

For full configuration options, see .env.mainnet or .env.sepolia.

Testing Flashblocks RPC Methods

When running in Flashblocks mode, you can query a pending block using the Flashblocks RPC:

curl -X POST \
  --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["pending", false],"id":1}' \
  http://localhost:8545

Snapshots

Snapshots are available to help you sync your node more quickly. See docs.base.org for links and more details on how to restore from a snapshot.

Supported Networks

Network Status
Mainnet ✅
Testnet ✅

Troubleshooting

For support please join our Discord and post in 🛠|node-operators. You can alternatively open a new GitHub issue.

Disclaimer

THE NODE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. We make no guarantees about asset protection or security. Usage is subject to applicable laws and regulations.

For more information, visit docs.base.org.

node (base/node)

Searching Database…

68.3K ·GitHub
archived
Что это такое?Docker-сборка для запуска ноды Base. Base — это безопасный и недорогой Ethereum L2 второго уровня, удобный для разработчиков и построенный на OP Stack от Optimism; в роли исполняющего клиента выступает base-reth-node, а в роли консенсусного — base-consensus.
Что нужно сделать, чтобы поднять ноду?Подготовьте RPC полноузлового Ethereum L1 и адрес beacon-узла, выберите файл .env.mainnet или .env.sepolia под свою сеть, пропишите в нём адреса L1 и запустите ноду.
Какой компьютер мне понадобится для этого?Как минимум современный многоядерный процессор, 32 ГБ оперативной памяти (лучше 64 ГБ), NVMe SSD и установленные на хосте Docker с Docker Compose.
Этот репозиторий — по-прежнему то место, где стоит брать ПО для ноды?Нет — разработка и релизы переехали в base/base. Этот репозиторий заархивирован и больше не поддерживается, поэтому для новых установок и обновлений используйте релизы из base/base.
Обязательно запускать это на Linux-сервере?Это Docker-сборка, так что она работает везде, где работают Docker и Docker Compose; эталонное железо для продакшена — инстансы AWS с локальными NVMe-дисками.
Есть ли подвох в лицензии или ответственности?На GitHub указана MIT, но само ПО для ноды поставляется с жёстким дисклеймером: оно предоставляется «как есть», без каких-либо гарантий по защите активов или безопасности.
Есть ли способ синхронизироваться быстрее, чем с самого генезиса?Да — есть снапшоты, которые помогают синхронизировать ноду заметно быстрее; ссылки и инструкции по восстановлению из снапшота есть на docs.base.org.
Сколько места на диске стоит заложить?Достаточно для двух копий текущего размера цепочки плюс размер снапшота плюс запас в 20% на рост; эталонный архивный узел для продакшена использует RAID 0 из всех локальных NVMe-дисков на AWS i7i.12xlarge.
Что даёт опция Flashblocks?Задав RETHFBWEBSOCKETURL, вы переключаете исполняющий клиент в режим Flashblocks: при этом добавляется Flashblocks RPC для запроса ещё не зафиксированных блоков; без этой переменной нода работает в обычном режиме.
Creator
base
Size
3 MB
Stars
68.3K
Age
3y
Commits · 90 Days