feat: add evidence hashing (internal/evidence)
SHA-256 over raw asset bytes and over the canonical JSON form of metadata (encoding/json already sorts map keys and preserves struct field order deterministically, so no separate canonicalization library is needed for our own fixed types). A Timestamper interface stands in for the RFC-3161 timestamp step — no concrete implementation yet, since which TSA to use is an open decision (CLAUDE.md "Offene Punkte") that directly affects the archive's evidentiary weight, not a purely technical choice to make silently. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
32
internal/evidence/hash.go
Normal file
32
internal/evidence/hash.go
Normal file
@@ -0,0 +1,32 @@
|
||||
// Package evidence bildet die Beweiskette: Hashing von Assets und
|
||||
// Metadaten, RFC-3161-Zeitstempel über diesen Hash. Das Append-only-
|
||||
// Prinzip selbst wird von internal/store (Postgres-Trigger) erzwungen —
|
||||
// dieses Paket liefert nur die Bausteine, die evidence_package braucht.
|
||||
package evidence
|
||||
|
||||
import (
|
||||
"crypto/sha256"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
)
|
||||
|
||||
// HashBytes berechnet den SHA-256-Digest über beliebige Bytes, z. B.
|
||||
// ein Asset wie Screenshot oder Video.
|
||||
func HashBytes(data []byte) []byte {
|
||||
sum := sha256.Sum256(data)
|
||||
return sum[:]
|
||||
}
|
||||
|
||||
// HashMetadata berechnet den SHA-256-Digest über die kanonisierte JSON-
|
||||
// Repräsentation von v. "Kanonisiert" heißt hier: encoding/json sortiert
|
||||
// Objektschlüssel bereits deterministisch, und Struct-Felder behalten
|
||||
// ihre Deklarationsreihenfolge — für unsere eigenen, fest definierten
|
||||
// Go-Typen ist das schon eine stabile, reproduzierbare Serialisierung,
|
||||
// ohne dass es eine eigene Kanonisierungs-Bibliothek bräuchte.
|
||||
func HashMetadata(v any) ([]byte, error) {
|
||||
data, err := json.Marshal(v)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("evidence: metadata marshal: %w", err)
|
||||
}
|
||||
return HashBytes(data), nil
|
||||
}
|
||||
Reference in New Issue
Block a user