Digital One Foundation Back to the record
The Project Handshake

Terms you can check before you agree to them.

A handshake, in a protocol, is the part that happens before any real message. Two parties with no prior reason to trust each other establish, in the open, terms that each can verify for itself. It assumes the network is hostile. It is designed to fail loudly rather than quietly.

These are working notes on doing the same thing with records: publishing the constructions, the reasoning behind each choice, and the mistakes found along the way, so that anyone deciding whether to rely on this class of infrastructure can examine the terms first.

Why publish thisNobody should have to take a vendor's word for it

Systems that produce evidence have an awkward property: the more important their output, the less their own assurances are worth. A record that matters is a record someone will one day want to dispute, and at that moment every claim made by the party who produced it is exactly the claim under examination. The only statements that survive are the ones a sceptic can check without cooperation.

That is an argument for publishing methodology rather than conclusions. A construction that is described precisely enough to re-implement can be attacked by people who owe us nothing — which is the only review that counts. The notes below are written for that reader: someone deciding whether a construction is sound, not someone deciding whether to buy something.

They are contributed to the Foundation's public record under an open licence. The Foundation is being established under Dutch law as an independent steward of exactly this kind of material — open evidence, open standards, and neutral infrastructure meant to outlive any single company. Papers here describe constructions, not products. Where a construction was developed inside a commercial system, that provenance is stated plainly; where a design decision is a product decision rather than a technical one, it is marked as out of scope rather than dressed up.

The standard these are held to

Every byte-level claim in these papers is reproducible from the description given. Every defect described is one that was actually found in working code, with the failing input stated. Where a limitation exists, it is named in the paper that would otherwise be read as claiming otherwise — not in a footnote at the end of the series.

The papersFive notes, in the order the problem is usually met

ScopeWhat these notes deliberately leave out

Two categories are absent by design, and it is better to say so than to let a reader hunt for them.

Everything else — the primitives, the byte layouts, the failure modes and the reasoning — is here in full, because a construction you cannot re-implement is a construction you cannot check.

Not legal analysis

Several papers reference European instruments where they explain why a technical property matters. Those references are contextual and are cited to their published text so a reader can go and read it. They are not legal analysis, they are not advice, and where a legal question is genuinely unsettled the papers say so rather than resolving it in passing.