erigon-seg-integrity

Runs integrity checks on Erigon datadir snapshot and segment files.

3.6k|1.5k|Updated May 27, 2019
One-click install
npx skills add https://github.com/erigontech/erigon --skill erigon-seg-integrity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: erigon-seg-integrity
Source: https://github.com/erigontech/erigon/tree/main/.claude/skills/erigon-seg-integrity
Command: npx skills add https://github.com/erigontech/erigon --skill erigon-seg-integrity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verifying that Erigon snapshot and segment files are valid and consistent requires running the correct CLI checks with the right flags, which is error-prone when done manually, especially during snapshot publishing or after suspected data corruption.

Core Features & Use Cases

  • Datadir Integrity Verification: Executes erigon seg integrity against a datadir to validate snapshot and segment files.
  • Selective Check Execution: Runs or skips specific named checks via --check and --skip-check, discovered dynamically through --help.
  • Torrent Piece-Hash Verification: Optionally enables a torrent piece-hash pre-pass with --file-integrity-cache for deeper file validation.
  • Use Case: During the snapshot publishing process, run all default integrity checks against a mainnet datadir with --failFast=false to collect every warning before release.

Quick Start

Ask the assistant to run integrity checks on your Erigon datadir at a given path, optionally specifying which checks to run or skip.

Frequently Asked Questions about erigon-seg-integrity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run integrity checks on an Erigon datadir?

Run ./build/bin/erigon seg integrity --datadir=<path> with Erigon stopped, since the command needs exclusive datadir access. Use --check or --skip-check to control which checks execute.

How do I find the available erigon seg integrity checks?

Run ./build/bin/erigon seg integrity --help and read the --check flag description, which lists all currently available check names. The list changes over time, so never assume a fixed set of checks.

Why does erigon seg integrity fail with a file lock error?

The command fails when Erigon is still running because it requires exclusive access to the datadir. Stop the Erigon node first, then rerun the integrity check.

What does --file-integrity-cache do in erigon seg integrity?

Setting --file-integrity-cache speeds up repeated runs and enables a torrent piece-hash verification pass over the snapshots directory recursively. Skip that pass with --skip-check TorrentPieces.

Does --failFast=false make a failed integrity check pass?

No. --failFast=false only verifies every file before giving up; a piece-hash mismatch, unreadable path, or interrupted run still exits non-zero. A partial scan is never reported as a pass.