25 lines
1.3 KiB
Markdown
25 lines
1.3 KiB
Markdown
# 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.
|