1.3 KiB
Excavation request digest v1
This defines digest input only, not a persisted file or network envelope. Never dump
native C++ structures. Request shape is validated before hashing; total input is bounded.
FNV-1a uint64 offset=14695981039346656037, prime=1099511628211; for each byte b:
h = (h xor b) * prime modulo 2^64. Every integer below is little endian.
| Order | Field | Width |
|---|---|---|
| 1 | Request contract version, literal 1 | u32 |
| 2 | Command ID | u64 |
| 3 | Destination ID, literal 1 | u32 |
| 4 | Cut count | u32 |
| 5, repeated in canonical cut order | Chunk x, y, z | three u64 conversions of signed coordinates modulo 2^64 |
| 6, per cut | Local x, y, z | three u32 |
| 7, per cut | Expected revision | u64 |
| 8, per cut | Removed fill | u32 |
Digest field is excluded. Canonical order is chunk lexicographic x/y/z then X-fast local ordinal, with no duplicates. Store identity/descriptor is bound by the target store, not this digest; neither digest nor revision authenticates a caller. M5.6 now supplies world/frame/base versions, bounds, integrity checks and transaction framing in world-snapshot.md and world-journal.md. Geometry, debris and retry metadata form one consistent persistence unit; recording only a request digest cannot recover it.