Skip to content

Add shard-0 clean database recovery producer - #5104

Open
polymorpher wants to merge 9 commits into
harmony-one:mainfrom
polymorpher:recovery-sync
Open

Add shard-0 clean database recovery producer#5104
polymorpher wants to merge 9 commits into
harmony-one:mainfrom
polymorpher:recovery-sync

Conversation

@polymorpher

Copy link
Copy Markdown

Summary

  • add the offline harmony-recovery-db pipeline for inspecting an Aug 8 shard-0 snapshot, exporting a verified forensic bundle, and replaying to the pinned recovery target
  • add strict compaction, deep verification, checksum-chained reporting, crash-safe release packaging, and comprehensive fault/E2E coverage
  • add build wiring, phase wrappers, and a copy-paste operator guide for producing and installing the sealed validator database

Test plan

  • make test-recovery
  • bash scripts/recovery/e2e-localnet.sh
  • go vet ./internal/recoverydb/... ./cmd/harmony-recovery-db/
  • go build ./...
  • run the mainnet-scale workflow against operator-managed Aug 8 and forensic database copies

Made with Cursor

polymorpher and others added 9 commits August 13, 2026 14:10
Introduce the strict read-only LevelDB opener, fail-closed write guards,
recovery anchors, key classification, and hashed report helpers used by
every producer stage.

Co-authored-by: Cursor <cursoragent@cursor.com>
Compare two baseline copies for agreement and export a checksummed
block and certificate bundle from a donor database.

Co-authored-by: Cursor <cursoragent@cursor.com>
Replay the exported bundle into a working copy up to the pinned target,
then compact the result for the sealed payload.

Co-authored-by: Cursor <cursoragent@cursor.com>
Walk state, certificates, and logical digests, then seal a checksummed
release directory with an install template.

Co-authored-by: Cursor <cursoragent@cursor.com>
Cover crash, fault, and localnet producer paths and document the
package test map.

Co-authored-by: Cursor <cursoragent@cursor.com>
Wire inspect, inventory, export, replay, compact, verify, compare, and
package subcommands with stable exit codes.

Co-authored-by: Cursor <cursoragent@cursor.com>
Provide operator wrappers for each pipeline stage plus fixture
generation for the clean-DB producer.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add the test-recovery target, install lsof for offline isolation checks,
and register the producer binary.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add the operator guide for the Aug 8 snapshot plus forensic donor,
the CLI contract, and the pinned 92730034 target notes.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant