Digital One Foundation Back to the record
The Project Handshake

Terms you can check before you agree to them.

A handshake runs before any real message: two parties with no reason to trust each other settle terms each can check for itself. These notes do the same with records, for a reader deciding whether a construction is sound rather than whether to buy something. The primitives, byte layouts and failure modes are here in full, because a construction you cannot re-implement is a construction you cannot check.

ContentsSix notes, in the order the problem is usually met

The conclusion, before the argument

Software cannot make a record unwritable by whoever holds its credentials; it can make alteration impossible to hide from a holder of an earlier commitment. Paper 002 makes each top-level field a salted Merkle leaf, so a withheld field is visible as a withholding, not an absence. It publishes its own defect with the failing input: a value can be shortened by lengthening its salt. A truncated chain still verifies: omission is invisible without an earlier commitment held elsewhere, worth only its holder's independence.

On the provenance of this material

Every byte-level claim is reproducible from the construction as described, and each defect was found in working code with its failing input stated; a hypothesis is called one. The constructions came from a commercial evidence system, as paper 002 records; its internals are not published, so a reader checks the construction, not its implementation. Deliberately absent: prices, plans and tiers, deployment internals, and product semantics — what a record should contain is a design decision, not a property of the construction. European instruments are cited where they explain why a technical property matters. 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.

What a reader may do with this

These notes are contributed under CC BY 4.0: quote, reproduce and build on them, with attribution, a link to the licence, and an indication of any changes. The Foundation is an entity in formation under Dutch law.