Reference
Binary Container
Look up syntax, contracts, layouts, algorithms, and exact behavior.
The repository implements an AIXC binary container with a fixed header and aligned sections for seed material, decision bits, residuals, and optional metadata. The header records archive mode, entropy codec, predictor backend, original byte length, unit counts, section offsets, and integrity flags.
This shape keeps parsing predictable. A decoder can validate the header, locate each section without scanning the whole file, verify optional CRC32 or SHA-256 body metadata, and confirm the predictor fingerprint before attempting a decode.
- Magic: AIXC.
- Header: 96-byte fixed prefix with little-endian offsets and lengths.
- Decision stream: LSB-first packed bits in the reference format.
- Residual stream: raw literals, ULEB128 token ids, top-k ranks, or section-coded bytes depending on mode.
- Optional section: TLV metadata for body integrity and predictor manifest fingerprints.
+----------------------+ 0 | magic/version/header | +----------------------+ | seed section | +----------------------+ | packed decisions | +----------------------+ | residual section | +----------------------+ | optional metadata | +----------------------+ | integrity trailer | +----------------------+