docs: add blob archive endpoint page - #256
Open
a-thomas-22 wants to merge 1 commit into
Open
a-thomas-22 wants to merge 1 commit into
a-thomas-22 wants to merge 1 commit into
Conversation
Documents the newly-public blob archive at https://blobs.blobflow.com as a new /blob-archive page, linked from the primary nav and the sitemap. The page leads with the point most likely to cost people time: this is not a beacon blob_sidecars API. The path prefix looks like one, but there is no blob_sidecars route and the payload carries no KZG commitments, proofs, or signed block header, so a consensus client cannot sync from it. L2 batch reconstruction works because clients like Arbitrum Nitro verify blob data against the versioned hashes already in the L1 transaction. Framed around the supported workflow: use the archive to backfill historical blobs, then repoint the node at a live consensus endpoint once synced. Only the root base URL is documented. Every documented behavior and all three curl examples were verified against the live endpoint. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This branch was successfully deployed
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.
Adds a
/blob-archivepage documenting the newly-public blob archive at https://blobs.blobflow.com, linked from the primary nav and the sitemap.What the page says
It leads with the point most likely to cost people real time: this is not a beacon
blob_sidecarsAPI. The beacon-style path prefix makes it look like one, but there is noblob_sidecarsroute and the payload carries no KZG commitments, no proofs, and no signed block header. Prysm/Lighthouse/Teku cannot sync or backfill from it. L2 batch reconstruction works because clients like Arbitrum Nitro verify blob data against the versioned hashes already in the L1 transaction, so raw blobs are sufficient there.The rest is framed around the supported workflow: use the archive to backfill historical blobs, then repoint the node at a live consensus endpoint once synced. Only the root base URL is documented, no profile prefixes.
Covers the Nitro quickstart flag, the three supported paths, response shape, status codes, coverage (mainnet, Deneb slot 8626176 onward, minutes of lag), limits and etiquette, and three copy-pasteable
curlexamples.Verification
Every documented behavior was probed against the live endpoint, and all three
curlexamples run as written. A few things differ from what I was originally told, so the page documents the actual behavior:head/finalized/0x-root slots return 400Retry-After: 12{"data":[]}Confirmed as stated: 128 KiB per blob (~1 MB per blob on the wire),
max-age=900on root blobs,max-age=86400ongenesisandconfig/spec, Deneb origin slot 8626176.The ~512 Mbps cap and 429 behavior are documented as described but not tested, since triggering it would mean deliberately hammering the service.
npm run lint,npm run typecheck,npm test(453 passing) andnpm run buildall clean. The page prerenders as a static route.Once merged, the site auto-deploys via ArgoCD after the image tag is bumped.
🤖 Generated with Claude Code