Erigon Seg Rebase
Apps & Automationerigon-seg-rebaseErigon Seg Rebase is an Agent Skill for apps & automation published in the erigontech/erigon repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/erigontech/erigon/blob/HEAD/.claude/skills/erigon-seg-rebase/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/erigon-seg-rebase, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Erigon Segment Step Rebase
Overview
The erigon seg step-rebase command changes the step size of an existing Erigon datadir. This is used to modify the granularity of snapshot segments.
Command Syntax
./build/bin/erigon seg step-rebase --datadir=<path> --new-step-size=<size> [other-flags]
Flags
--datadir: Path to the Erigon datadir (required)--new-step-size: New step size to rebase to (required; must be an exact divisor or multiple of the current step size fromsnapshots/erigondb.toml)--keep-blocks: Keep chaindata instead of deleting it. Resets only execution state (domains, history, changesets, prune progress) via the same logic asintegration stage_exec --reset, so already-downloaded blocks stay in the DB and get re-executed on next start. Without this flag the whole chaindata DB is deleted and the block tail must be re-downloaded from the network.
The command is interactive: it prints the full rename/delete plan and waits for a y/N confirmation on stdin (echo y | erigon seg step-rebase ... when scripting).
Common Step Sizes
1562500: Default/full stepsize781250: stepsize/2 (half step)390625: stepsize/4 (quarter step)
Usage Patterns
Rebase to Half Step
./build/bin/erigon seg step-rebase --datadir=/path/to/datadir --new-step-size=781250
Rebase to Quarter Step
./build/bin/erigon seg step-rebase --datadir=/path/to/datadir --new-step-size=390625
Rebase Keeping Already-Downloaded Blocks
./build/bin/erigon seg step-rebase --datadir=/path/to/datadir --new-step-size=781250 --keep-blocks
Run erigon seg retire first to minimize the re-execution window, then after the rebase start erigon (or run integration stage_exec) to re-execute the kept blocks from the snapshot files' end.
Important Considerations
Before Running
- Backup datadir: Consider backing up the datadir before rebasing
- Stop Erigon: Ensure Erigon is not running on the target datadir
- Verify current step: Check what the current step size is
- Ensure Erigon binary is built: run
make erigonto build it
After Running
- Verify the rebase completed successfully
- Check segment files in the datadir
- Restart Erigon if needed
Step Sizes
Common step sizes used in Erigon:
1562500: Full/default stepsize781250: Half step (stepsize/2)390625: Quarter step (stepsize/4)
The step size affects:
- Snapshot segment granularity
- File size and organization
- Query and sync performance
Workflow
When the user wants to rebase step size:
-
Confirm parameters
- Ask for target datadir path
- Ask for desired step size
- Confirm if they want to rebase a specific range
-
Safety checks
- Verify datadir exists
- Check if Erigon is running (should not be)
-
Execute rebase
./build/bin/erigon seg step-rebase --datadir=/path/to/datadir --new-step-size=<size> -
Verify results
- Check command output for errors
- List segment files to verify changes
Error Handling
Common issues:
- "datadir not found": Verify the path is correct
- "database locked": Stop Erigon process first
- Invalid step size: Use valid step sizes (1562500, 781250, or 390625)
Examples
Example 1: Rebase datadir to half step
./build/bin/erigon seg step-rebase --datadir=./chaindata --new-step-size=781250
Example 2: Rebase to quarter step
./build/bin/erigon seg step-rebase --datadir=/mnt/erigon/datadir --new-step-size=390625
Tips
- The operation can be time-consuming for large datadirs
- Smaller step sizes (like 390625) create more granular segments
- If building from source, use
make erigonto build the binary atbuild/bin/erigon