Oracle README: exact provenance check and the full list of added test files

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Andy Dixon
2026-10-08 11:51:14 +01:00
co-authored by Claude
parent 53968f8822
commit afdfbc5ebd
+11 -7
View File
@@ -9,12 +9,14 @@ binary contain no Go code and need no Go toolchain.
Provenance: Provenance:
- Every file under `oracle/go` is byte-identical to the same path at the - All 32 Go sources and `go.mod`/`go.sum` under `oracle/go` are
repository root at `4c1507c`, except the three added test files below. byte-identical to the same paths at the repository root at `4c1507c`.
- `oracle_vectors_test.go`, `internal/pqcrypt/oracle_vectors_test.go` and - The only additions are test files whose names contain `oracle`
`internal/stream/oracle_vectors_test.go` are test-only generators. They (`*oracle_vectors_test.go`, `oracle_decrypt_test.go`,
call the frozen code and write what it computes; they skip themselves `*oracle_bench_test.go`). They call the frozen code and record what it
unless `VAULT_ORACLE_OUT` is set, and add nothing to the oracle binary. computes; they skip themselves unless `VAULT_ORACLE_OUT` or
`VAULT_ORACLE_DECRYPT` is set (benchmarks run only with `-bench`), and add
nothing to the oracle binary.
- Dependencies are pinned by `go.mod`/`go.sum`: CIRCL v1.6.4, - Dependencies are pinned by `go.mod`/`go.sum`: CIRCL v1.6.4,
golang.org/x/crypto v0.53.0, x/sys v0.46.0, x/term v0.44.0. The module golang.org/x/crypto v0.53.0, x/sys v0.46.0, x/term v0.44.0. The module
needs Go 1.26.6 or newer. needs Go 1.26.6 or newer.
@@ -22,7 +24,9 @@ Provenance:
Check the copy is still faithful: Check the copy is still faithful:
```sh ```sh
git diff --stat 4c1507c HEAD -M -- oracle/go # renames only, plus the generators for f in $(git ls-tree -r --name-only 4c1507c | grep -E '\.go$|^go\.(mod|sum)$'); do
cmp <(git show 4c1507c:$f) oracle/go/$f || echo "DIFFERS: $f"
done
``` ```
Use: Use: