SPEZIFIKATION v1.0
1. Übersicht
Ein Truthlocks Proof Bundle ist ein portables Nachweisdokument. Verwenden Sie das Format und den Verifizierer, die für den Endpunkt dokumentiert sind, der es erstellt hat. CBOR-Unterstützung ist unten als zukünftige Erweiterung aufgeführt, nicht als Garantie für aktuelle Exporte. Beweismittel können Attestierungsdaten, Schlüsselreferenzen und Transparenzprotokollnachweise umfassen. Verifizieren Sie die Signatur und die Protokollaufnahme separat; fehlende Beweismittel dürfen nicht als bestandene Prüfung gemeldet werden. Vertrauen Sie niemals einem öffentlichen Schlüssel allein, weil er im Bundle enthalten ist: Etablieren Sie den autorisierten Schlüssel über einen vertrauenswürdigen Kanal. Das untenstehende Schema ist eine Referenzbeschreibung; gleichen Sie die tatsächliche Exportversion und ihren signierten Byte-Vertrag ab, bevor Sie einen Verifizierer implementieren.2. Bundle-Struktur
Proof-Bundles werden als JSON-Objekte serialisiert und folgen diesem Schema:3. Felddefinitionen
3.1 Kopfzeile
3.1.1 Bundle-Integritäts-Hash
3.2 Attestierung
3.3 Nachweise (Transparenzprotokoll)
3.4 Ausstellerzertifikat
4. Verifizierungsalgorithmus
Um ein Truthlocks Proof Bundle zu verifizieren, führen Sie die folgenden Schritte der Reihe nach aus. Wenn ein Schritt fehlschlägt, ist das Bundle ungültig.Schritt 1: Integrität des Bundles validieren
Berechnen Sie den SHA-256-Hash aller Bundle-Felder mit Ausnahme vonbundle_hash_b64url und bundle_signature. Dekodieren Sie den bundle_hash_b64url-Wert mit Base64url und vergleichen Sie ihn mit Ihrem berechneten Hash. Wenn sie nicht übereinstimmen, wurde das Bundle manipuliert.
Schritt 2: Attestierungssignatur überprüfen
Verwenden Sie den öffentlichen Schlüssel vonissuer_certificate.public_key_der und den in attestation.signature_format angegebenen Algorithmus, um attestation.signature mit der kanonischen Bestätigungsnutzlast (alle Bestätigungsfelder außer signature und status) zu überprüfen.
Schritt 3: Inhaltshash überprüfen
Wenn Sie die Originaldatei haben, berechnen Sie ihren SHA-256-Hash und vergleichen Sie ihn mitattestation.content_hash. Dies bestätigt, dass die Datei seit der Attestierung nicht geändert wurde.
Wenn ein document_hash-Wert vorhanden ist, können Sie ihn auch mit Ihrem berechneten Hash vergleichen. Der document_hash ist ein vorab berechneter SHA-256-Hex-Hash, den der Minter zum Zeitpunkt der Prägung übergeben hat, was eine zusätzliche Integritätsprüfung unabhängig von der Payload-Kodierung bietet.
Schritt 4: Überprüfung der Aufnahme in das Transparenzprotokoll
Für jeden Eintrag inproofs überprüfen Sie den Merkle-Inklusionsbeweis. Beginnend mit leaf_hash an Position leaf_index, berechnen Sie den Root neu, indem Sie mit jedem Geschwisterknoten in inclusion_proof hashen. Das Ergebnis muss mit root_hash übereinstimmen.
Schritt 5: Schlüsselgültigkeit überprüfen
Bestätigen Sie, dassissuer_certificate.valid_from ≤ attestation.issued_at ≤ issuer_certificate.valid_until (falls vorhanden).
5. Unterstützte Algorithmen
6. Verifizierungstools
Proof-Bundles können mit einer dieser Methoden verifiziert werden:- CLI:
truthlock verify -b bundle.json -f original-file --trusted-log-key "$TRUTHLOCKS_LOG_PUBLIC_KEY" --trusted-issuer-key "$TRUTHLOCKS_ISSUER_PUBLIC_KEY". Pinnen Sie beide öffentlichen Schlüssel unabhängig vom Bundle. Offline-Prüfungen stellen den aktuellen Widerrufsstatus nicht fest. - Web: Hochladen unter
verify.truthlocks.com/proof/[id] - SDK:
client.verify.verifyBundle(bundleJson, fileBuffer) - Manuell: Befolgen Sie den obigen Verifizierungsalgorithmus mit jeder Ed25519/ECDSA-Bibliothek
7. Erweiterungspunkte
Das Feldmetadata im Attestierungsobjekt ist erweiterbar. Benutzerdefinierte Schemata können zusätzliche Felder enthalten, ohne die Verifizierung zu beeinträchtigen. Der Kernverifizierungsalgorithmus hängt nur von content_hash, signature und den Transparenzprotokoll-Nachweisen ab.
Zukünftige Formatversionen können einführen:
- CBOR-Kodierung für kompakte binäre Darstellung
- Multi-Attestierungs-Bundles (Stapelverifizierung)
- Konsistenznachweise über mehrere Protokolle hinweg
- Nachweise des Widerrufsstatus (eingebettet)
8. Designprinzipien
- Eigenständig: Keine Netzwerkzugriff für die Verifizierung erforderlich
- Vertrauensminimiert: Verifizierbar, auch wenn Truthlocks den Betrieb einstellt
- Vorwärtskompatibel: Unbekannte Felder werden von älteren Verifizierern ignoriert
- Deterministisch: Kanonische JSON-Kodierung gewährleistet konsistentes Hashing
- Offen: Verwendet standardmäßige kryptografische Primitive (keine proprietären Formate)

