Skip to content

Releases

The workspace version is 0.0.0 (development). All crates share the workspace version defined in the root Cargo.toml:

[workspace.package]
version = "0.0.0"
edition = "2024"
rust-version = "1.88"

Base Reth Node tracks a specific Reth release. The current pinned version:

reth v1.11.0

This is specified in the workspace dependencies as a git dependency with a tag:

reth-db = { git = "https://github.com/paradigmxyz/reth", tag = "v1.11.0" }

Production images are published at:

ghcr.io/base/node-reth

These are managed in the base/node repository and include both vanilla Reth and Base Reth, selectable via NODE_TYPE.

Release branches follow the releases/v<version> naming convention. The process uses GitHub Actions workflows:

  1. Release candidates are created via the “Create Release” workflow with rc type. RC versions are auto-numbered (e.g., v1.0.0-rc.1, v1.0.0-rc.2).
  2. Final releases are created with final type, which tags Docker images as v1.0.0, 1.0, 1, and latest.
WorkflowTriggerPurpose
Release Version SyncAutomaticUpdates Cargo.toml versions on release branches
Create ReleaseManualCreates RC or final release tags
ReleaseTag pushBuilds Docker images, creates GitHub release

The workspace defines default members that are built by cargo build:

  • bin/based
  • bin/node (produces base-reth-node)
  • bin/basectl
  • bin/builder
  • bin/consensus
  • bin/ingress-rpc
  • bin/audit-archiver
  • bin/mempool-rebroadcaster