Files

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.