Base

Base is a rollup built on Ethereum.

Why Base

• Cheap, fast, and open platform: Base is a globally available platform that provides 1-second and <1-cent transactions to anyone in the world.
• Reach more users: Base is committed to helping developers grow their user base by distributing their apps through official Base channels.
• A place to earn: Base has delivered grants to more than 1,000 builders, with plans to continue supporting more.
• Access to high-quality tooling: Builders have access to tools to build incredible onchain experiences for AI, social, media, and entertainment.

Learn More

• Visit the docs for information on how to:
  • Connect your wallet
  • Run a node
  • Deploy an app
• The specs site has an overview of the protocol, including past and upcoming upgrades.

Install Binaries

Use baseup to install the GitHub release binaries for this repository:

curl -fsSL https://raw.githubusercontent.com/base/base/main/baseup/install | bash

Run a Node

This repository now hosts the public Base node previously published from base/node. Root docker-compose.yml pulls ghcr.io/base/node. Pass --build to compile this tree. For local development, see Run a Local Devnet.

1. Set BASE_NODE_L1_ETH_RPC and BASE_NODE_L1_BEACON in .env.mainnet or .env.sepolia.
2. Start the node:

# Mainnet (default):
docker compose up --build

# Testnet:
NETWORK_ENV=.env.sepolia docker compose up --build

# Pin a published image (no compile):
NODE_TAG=v1.3.0 docker compose up

See the docs for hardware requirements, snapshots, Flashblocks, and historical proofs.

Run a Local Devnet

Devnet	Use it for	Start
Docker devnet	A fresh L1 and L2 stack: sequencing, derivation, batching, hardfork activation	just devnet up-single
Snapshot devnet	Real Base Mainnet state and contracts, acting as any account, 200ms blocks; no L1	just devnet snapshot download --dir <dir>, then just devnet snapshot run --dir <dir>

Start with the Run a Local Devnet guide. docs/guides/DEVNET.md covers every local environment in this repository.

Base Anvil Package

Every push to main publishes patched anvil and forge binaries to GHCR as ghcr.io/base/base-anvil. Use immutable sha-<commit> tags for pinned downstream tests, or main for the latest successful main build.

License

Licensed under MIT.