Skip to research
Vraelis Research
All researchVraelis Prompto / Reference note and proposed protocol

Canonical manifest encoding

Make a manifest reproducible without silently changing the files it describes.

Research note · November 14, 2026

Research question

How should two implementations encode the same manifest before signing or comparing it?

Method

  1. Define a schema with explicit path, size and digest fields. Reject duplicate property names and unsupported values rather than allowing parsers to make different choices.
  2. Apply a named canonicalization scheme to the manifest, not to the underlying model files. Preserve array order unless the schema explicitly defines a separate ordering operation before canonicalization.
  3. Build fixtures containing nested objects, escaped characters and numeric edge cases. Produce canonical bytes with two implementations and compare the bytes directly before comparing their hashes.

Records to retain

  • Manifest schema version
  • Original and canonical manifest bytes
  • Canonicalization implementation versions
  • Cross-implementation mismatch cases

Source basis

RFC 8785 specifies recursive object-property sorting and deterministic primitive serialization. It does not sort array elements. A schema must still define what a list of files means and how its order is chosen.

Interpretation & limits

Canonicalization removes representation ambiguity within its rules. It cannot decide whether a path is safe, a record is complete or a signer is authorized. No interoperability results are claimed here.

Next experiments

  • Publish a small cross-language fixture corpus.
  • Test rejection behavior for duplicate keys and unsupported numbers.

References

  1. JSON Canonicalization Scheme
  2. The Update Framework specification

Technical reference

Implementation details supporting this note, drawn directly from the maintained documentation. These are technical references, not additional papers or new experimental results. Expand a topic to inspect its method, fields and limits.

Related notes