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.