Add validator recovery preflight and metadata tooling - #5105
Open
polymorpher wants to merge 9 commits into
Open
Conversation
Introduce the harmony-recovery inplace stack (rodb, chainread, certverify, statecheck, anchor, report, and fixtures) so a live shard-0 LevelDB can be sampled without writes. Co-authored-by: Cursor <cursoragent@cursor.com>
Provide the cobra root and preflight subcommand, exit-code delivery, dependency guard, and golden/fail-path tests for the eligibility sampler. Co-authored-by: Cursor <cursoragent@cursor.com>
Check in the synthetic LevelDB kits, receipt goldens, generator script, and gitignore exceptions so the preflight tests have hermetic data. Co-authored-by: Cursor <cursoragent@cursor.com>
Describe live-node usage, PASS/FAIL meaning, the Telegram receipt flow, and the operator-only mainnet pilot measurements. Co-authored-by: Cursor <cursoragent@cursor.com>
Provide the JSON anchor, strict read-only DB opener, integrity checksums, report types, and write-refusing adapters used by scan, export, and audit. Co-authored-by: Cursor <cursoragent@cursor.com>
Implement the shared norm library, HMR1 codec, reference export, scan helpers, and the masked-overlay branch-audit engine. Co-authored-by: Cursor <cursoragent@cursor.com>
Extend the preflight-owned harmony-recovery root with the offline metadata command group and the documented prometheus dependency exemption. Co-authored-by: Cursor <cursoragent@cursor.com>
Check in the localnet kit, help goldens, generator script, gitignore exceptions, and the acceptance matrix that pins scan/export/audit. Co-authored-by: Cursor <cursoragent@cursor.com>
Record the CLI contract, HMR/reference schemas, exit codes, and the compiled mainnet recovery anchor used by the metadata commands. Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
harmony-recovery preflighteligibility check for validator databasesv2026.1.1Isolation boundary
scripts/go_executable_build.sh,Makefile, orDockerfileharmony-recoveryis built and run explicitlyharmony-recovery-dbproducer/recovery-sync pipelineTest plan
git diff --check v2026.1.1...HEADscripts/go_executable_build.sh,Makefile,Dockerfile,cmd/harmony,core,node,api,internal/chain)go test ./cmd/harmony-recovery ./internal/recovery/...(Go 1.24.2 with the repository's macOS BLS/GMP loader wrapper)Made with Cursor