Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bitfield.so/llms.txt

Use this file to discover all available pages before exploring further.

Reference

Claim ledger.

The claim ledger is the public checklist that keeps speed numbers honest.

What this is

Claim ledger = the structured list of public benchmark claims.Each claim has a number, a unit, a measured category, a mechanism, and a list of things the number does not claim.

Required fields

FieldMeaning
idStable internal docs ID for the claim row.
publicLabelThe phrase readers see.
valueThe number.
unitWhat the number is counted in.
categoryThe job measured, such as warm-local-read or durable-batch-write.
mechanismCategoriesPublic mechanism families that explain the claim.
disclosureTierThe public detail level. Current proof rows use public-mechanism-category.
mechanismPlain sentence explaining why this category can have this number.
notClaimingThe boundaries. This stops readers from comparing unlike jobs.
forbiddenPublicDetailsPrivate details that public docs must not expose.
publicUseThe public pages that are allowed to use the claim.

Current category names

CategoryMeaning
warm-local-readLocal read when the needed bytes are already warm and no network request is included.
content-address-lookupLocal lookup where Bitfield resolves a content identity before reading.
durable-batch-writeSaved-write work measured across a batch.
batched-write-ceilingCeiling number for an optimized full-batch path.

Public boundary

Public docs may explain mechanism categories.Public docs may not publish private file layouts, private binary record formats, private write scheduling logic, or raw internal benchmark logs.That is the point of the ledger. It lets the docs show enough mechanism to be credible without turning the docs into a private implementation dump.
Last modified on May 8, 2026