Repository navigation
MerkleNode joins the frozen 0.1.x surface, and directory trees arrive as
experimental, default-off features. Every existing golden vector is
byte-identical, and every identifier minted under earlier 0.1.x releases
remains valid. The dir_tree breaking notes below apply only to the new,
non-frozen features.
Added
-
MerkleNodebytes are frozen (#112): cross-language vectors in
tests/merkle_vectors.json, checked in Rust and Python.MerkleNodeis in the
default surface;unstable-merkleis now a deprecated no-op alias. -
dir_treesingle-file roots (#109):Linkis nowContentAddressable, and
snapshot/snapshot_withreturn the rootLink(also stored), so a
regular file is a root:resolve(store, &link.content_id()?, "")proves it
andverify_filechecks it, extra digests included. A file root and a
directory root over the same bytes have different ids;DirNodebytes are
unchanged. Breaking (experimental, non-frozen):snapshotreturnsLink
notContentId;resolve/Proof::verifytake aLinkid;Proof.nodes[0]
is the root link's bytes, sonodes.len()is depth + 1. -
structures::dir_treebehind the new default-offdir-treefeature
(#105):DirNode/Link,snapshot,resolveandProof. One root
ContentIdnames a directory of files, and a path resolves to a file's id
with an O(depth) proof that verifies against only the root. Bytes are
NON-FROZEN until conformance vectors land (#33). -
dir_treemulti-digest file links behind the new default-offmulti-digest
feature (#107):Link::Filegainsalso, extra SHA-256 / MD5 digests of
the same bytes thatProof::verify_filechecks ALL of, alongside BLAKE3 and
size. NewDigestAlg,file_link,snapshot_with, and the typed errors
InvalidDigest/UnsupportedDigest. A link with noalsokeeps its
previous bytes and root.Linkis no longerCopy.