backfilling missing blocks page#1207
Merged
Merged
Conversation
…rage/restore Adds a new node-operators/archive-node/backfilling-missing-blocks page covering mina-missing-blocks-auditor (detection, exit-code bits, structured output), mina-archive-blocks (precomputed + extensional restore), and the missing-blocks-guardian script (audit / single-run / daemon modes), plus a hard-fork section spelling out the two preconditions the auditor needs (first canonical post-fork block + at least one block at or above the target tip) and pointers to o1Labs-published precomputed-block / dump buckets alongside the recommendation to self-host them for decentralization. Refactors archive-redundancy.mdx to focus purely on storage: keeps the multi-daemon / multi-archive redundancy guidance and block-data backup methods, adds a Back up the archive database subsection (pg_dump scheduling plus the mina-archive-dumps bucket), and replaces the old detection + restore sections with a redirect to the new page. The two pages now cross-link in both directions so storage and recovery have a clean split. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…-fork section Restructures the backfilling page to advertise the guardian first (installed as mina-missing-blocks-guardian from the mina-archive Debian package and Docker image) and demotes mina-missing-blocks-auditor + mina-archive-blocks into an "individual tools" section for setups where the guardian's defaults are not a good fit. Rewrites the hard-fork subsection to reflect what actually happens: the chain is continuous across the fork, but operators commonly miss the fork window or join late and need to patch in post-fork blocks. The only extra precondition for the guardian to work is that the first canonical post-fork block (global_slot_since_hard_fork = 0) is already in the database. Drops the hard-fork-specific bucket paragraph and the caution block per review. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
… buckets Replaces the auth-walled cloud-console "storage/browser" links with the public storage.googleapis.com bucket URLs that already appear in the curl examples on the same pages, so the bucket references are consistent and work without a Google account. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
dkijania
commented
May 27, 2026
Member
Author
There was a problem hiding this comment.
Here i removed part which vaguely described how to restore missing archive blocks and just redirect to backfilling-missing-blocks
SanabriaRusso
approved these changes
May 27, 2026
| Schedule this regularly (a nightly cron is typical) and publish the dumps to object storage that your downstream consumers can reach. | ||
|
|
||
| 1. Restore precomputed blocks from: | ||
| O1Labs publishes nightly dumps of its public-network archives to the [mina-archive-dumps](https://storage.googleapis.com/mina-archive-dumps/) GCS bucket as a convenience: |
Member
There was a problem hiding this comment.
What's the convention with the name? I would suggest to write it the same way every time i.e., o1Labs
| Schedule this regularly (a nightly cron is typical) and publish the dumps to object storage that your downstream consumers can reach. | ||
|
|
||
| 1. Restore precomputed blocks from: | ||
| O1Labs publishes nightly dumps of its public-network archives to the [mina-archive-dumps](https://storage.googleapis.com/mina-archive-dumps/) GCS bucket as a convenience: |
Member
There was a problem hiding this comment.
Suggested change
| O1Labs publishes nightly dumps of its public-network archives to the [mina-archive-dumps](https://storage.googleapis.com/mina-archive-dumps/) GCS bucket as a convenience: | |
| o1Labs publishes nightly dumps of its public-network archives to the [mina-archive-dumps](https://storage.googleapis.com/mina-archive-dumps/) GCS bucket as a convenience: |
Co-authored-by: SanabriaRusso <luis@o1labs.org>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.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
2 participants
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.
Adds a new node-operators/archive-node/backfilling-missing-blocks page covering
mina-missing-blocks-auditor (detection, exit-code bits, structured output),
mina-archive-blocks (precomputed + extensional restore), and the
missing-blocks-guardian script (audit / single-run / daemon modes), plus a
hard-fork section spelling out the two preconditions the auditor needs
(first canonical post-fork block + at least one block at or above the target
tip) and pointers to o1Labs-published precomputed-block / dump buckets
alongside the recommendation to self-host them for decentralization.
Refactors archive-redundancy.mdx to focus purely on storage: keeps the
multi-daemon / multi-archive redundancy guidance and block-data backup
methods, adds a Back up the archive database subsection (pg_dump scheduling
plus the mina-archive-dumps bucket), and replaces the old detection +
restore sections with a redirect to the new page. The two pages now
cross-link in both directions so storage and recovery have a clean split.