name	erigon-seg-retire
description	Run the Erigon segment retire command to build, merge, and clean snapshot files. Use this for snapshot publication readiness preparation.
allowed-tools	Bash, Read

Erigon Segment Retire Command

The erigon seg retire command prepares snapshot files for publication by performing build, merge, and cleanup operations on segment files.

Prerequisites

Erigon must be stopped - The command requires exclusive access to the datadir
Binary must be built - Run /erigon-build first if the binary doesn't exist
Datadir must exist - A synced Erigon datadir with blockchain data

Command

./build/bin/erigon seg retire --datadir=<path>

Replace <path> with the actual path to your Erigon data directory.

What the Command Does

The retire command performs these operations in sequence:

Build Missing Indices - Creates any missing indices for block and Caplin snapshots
Retire Blocks - Freezes blocks from the database into snapshot files
Remove Overlaps - Cleans up overlapping snapshot files
Prune Ancient Blocks - Removes block data from the database that has been successfully snapshotted
Build State History - Creates missing accessors and builds state history snapshot files
Prune State History - Removes state history that has been snapshotted
Merge and Cleanup - Merges smaller snapshot files into larger ones and removes overlaps

Usage in Snapshot Release Workflow

This command is part of the "Publishable v2" snapshot release flow:

Shutdown Erigon
Run seg retire (this command)
Optionally run seg clearIndexing
Run seg index
Create torrent files
Run integrity check
Run publishable command

Example

# Build the binary first (if needed)
make erigon

# Ensure Erigon is stopped, then run seg retire
./build/bin/erigon seg retire --datadir=/data/erigon

Important Notes

File Lock: If Erigon is running, the command will fail due to file lock
Long running: This command can take significant time on mainnet
Disk I/O intensive: Performs extensive read/write operations
Resource intensive: Designed to maximize resource utilization

Plus depuis ce dépôt

même dépôt

erigon-seg-rebase

erigontech/erigon

Use the 'erigon seg step-rebase' command to change the step size of an existing datadir. Use when the user wants to rebase segments or modify step sizes.

2026-06-133.6k

erigon-test-all

erigontech/erigon

Run the full Erigon test suite locally using GOGC=80 make test-all. Use this before marking a PR ready for review. Equivalent to the "All tests" CI workflow.

2026-05-283.6k

erigon-test-race

erigontech/erigon

Run Erigon tests with Go race detector to find data races and concurrency bugs. Use this for concurrency-sensitive changes (parallel executor, p2p, txpool). Takes 30-60 minutes.

2026-05-283.6k

erigon-ci

erigontech/erigon

Run Erigon CI checks locally and/or trigger them remotely on a branch via GitHub Actions workflow_dispatch. Use this when you need to verify a branch passes all CI before or after pushing — especially for branches like bal-devnet-2 that don't auto-trigger on push/PR events.

2026-05-253.6k

erigon-implement-eip

erigontech/erigon

Implement a new EIP for a hardfork under development in Erigon. Use when the user asks to implement, port, or wire up an EIP — covers spec lookup, dep analysis, prior-work check, implementation, lint, tests, and a wrap-up saved to `agentspecs/`.

2026-05-253.6k

benchmarkoor

erigontech/erigon

Run benchmarkoor performance benchmarks against a locally-built Erigon binary and produce per-test MGas/s comparison tables. Covers image build, dataset reset, run invocation, result parsing, and before/after comparisons.

2026-05-223.6k

Erigon Segment Retire Command

The erigon seg retire command prepares snapshot files for publication by performing build, merge, and cleanup operations on segment files.

Prerequisites

Erigon must be stopped - The command requires exclusive access to the datadir

Binary must be built - Run /erigon-build first if the binary doesn't exist

Datadir must exist - A synced Erigon datadir with blockchain data

Command

./build/bin/erigon seg retire --datadir=<path>

Replace <path> with the actual path to your Erigon data directory.

What the Command Does

The retire command performs these operations in sequence:

Build Missing Indices - Creates any missing indices for block and Caplin snapshots

Retire Blocks - Freezes blocks from the database into snapshot files

Remove Overlaps - Cleans up overlapping snapshot files

Prune Ancient Blocks - Removes block data from the database that has been successfully snapshotted

Build State History - Creates missing accessors and builds state history snapshot files

Prune State History - Removes state history that has been snapshotted

Merge and Cleanup - Merges smaller snapshot files into larger ones and removes overlaps

Usage in Snapshot Release Workflow

This command is part of the "Publishable v2" snapshot release flow:

Shutdown Erigon

Run seg retire (this command)

Optionally run seg clearIndexing

Run seg index

Create torrent files

Run integrity check

Run publishable command

Example

# Build the binary first (if needed) make erigon # Ensure Erigon is stopped, then run seg retire ./build/bin/erigon seg retire --datadir=/data/erigon

Important Notes

File Lock: If Erigon is running, the command will fail due to file lock

Long running: This command can take significant time on mainnet

Disk I/O intensive: Performs extensive read/write operations

Resource intensive: Designed to maximize resource utilization