aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-16 17:19:28 +0000
committertv <tv@krebsco.de>2026-11-16 18:30:09 +0100
commitf74a2226065639b384314a1962e8177146244861 (patch)
tree10c6a6ecd8ff944069d8239e175551072b05f805 /docs
parent627795d72fedf19725c0d521788260dc63c137eb (diff)
federation-tests: vectors for JCS's order of names, and for the sizes
JCS sorts an object's names by their UTF-16 units, not by their bytes or code points; the two differ for a name from U+E000 to U+FFFF beside one beyond U+FFFF. Names in events and versions are ASCII, but a value is any JSON: a vector with two such names catches a builder sorting strings as Rust does. And vectors at federation 1's sizes and just past them.
Diffstat (limited to 'docs')
-rw-r--r--docs/federation-tests.md11
1 files changed, 7 insertions, 4 deletions
diff --git a/docs/federation-tests.md b/docs/federation-tests.md
index 7e92371..24c48f4 100644
--- a/docs/federation-tests.md
+++ b/docs/federation-tests.md
@@ -110,10 +110,13 @@ each row marked sim expects.
## Fixed bytes
-Vectors for: an event and its ID, a signature, a version and its hash, a checkpoint and
-its ID, the genesis change of a federation's root and of a fork's, and a snapshot after
-a checkpoint. A vector that changes is a change of the federation, which takes its next
-number ([`federation.md`](federation.md), Changing the federation).
+Vectors for: an event and its ID; an event whose value holds names JCS sorts by their
+UTF-16 units otherwise than by their bytes (one from U+E000 to U+FFFF beside one beyond
+U+FFFF); events at federation 1's sizes and just past them; a signature, a version and
+its hash, a checkpoint and its ID, the genesis change of a federation's root and of a
+fork's, and a snapshot after a checkpoint. A vector that changes is a change of the
+federation, which takes its next number ([`federation.md`](federation.md), Changing the
+federation).
## Fuzzing and mutants