# Telegram · Unabhängiger Zeuge

Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/witness/

Führen Sie „Witness“ mit einem eigenen Schlüssel und Bot aus, veröffentlichen Sie signierte Checkpoints in einem Kanal und vergleichen Sie die Exporte damit.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt)

Führen Sie „Witness“ mit einem eigenen Schlüssel und Bot aus, veröffentlichen Sie signierte Checkpoints in einem Kanal und vergleichen Sie die Exporte damit.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Beweise und Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/)

![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

[Exportieren und verifizieren](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) · [Hohe Sicherheit](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/) · [Anleitung zum Panel](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#extras)

Ein Witness speichert signierte Checkpoints getrennt vom Collector. Er überprüft die Signatur des Collectors und die Kontinuität des Journals, signiert das Ergebnis mit seinem eigenen Schlüssel und veröffentlicht es in einem Telegram-Kanal. Führen Sie ihn auf einem separaten Server mit Lesezugriff auf den Witness-Endpunkt des Collectors aus.

Das technische Ergebnis umfasst aufbewahrte Journal-Präfixe, Challenge-Antworten, Signaturprüfungen, Merkle-Inklusions-/Konsistenzprüfungen und signierte Kontinuitätsergebnisse. Für einen Witness, den ein anderer Verwahrer betreibt, bewahren Sie Verwahrer und Schlüsselkontrollnachweis mit dessen Fingerabdruck auf. Getrennte Schlüssel und getrennte Verwahrung beschreiben unterschiedliche Teile des Aufbaus. Der Verifier meldet, dass ein zweiter Schlüssel den Journal-Kopf festgehalten hat und bis zu welchem Eintrag; der Schlüsselkontrollnachweis des Verwahrers zeigt, wer diesen Schlüssel hält. Das Witness-Journal ist eine unterstützende Prüfung; das Minimum für Beweise ist Zeit von Dritten. Die Kanalbeiträge fügen externe Zeit hinzu: Telegram datiert jeden öffentlichen Beitrag, und der Verifier liest diese Daten selbst.

Ablaufdiagramm · Collector → Zeuge (Signierter Prüfpunkt: Anzahl der Einträge + Head-Hash); Zeuge → Witness-Protokoll, eigener Schlüssel; Zeuge → Telegram-Kanal (Signierter Beitrag über den eigenen Bot); Beweismaterial-ZIP → verify.py; Witness-Protokoll, eigener Schlüssel → verify.py; Telegram-Kanal → verify.py (t.me/s-Seite live lesen oder als Desktop-Export) · Collector · Zeuge · Witness-Protokoll, eigenerSchlüssel · Telegram-Kanal · Beweismaterial-ZIP · verify.py · Signierter Prüfpunkt: Anzahl · der Einträge + Head-Hash · Signierter Beitrag über den · eigenen Bot · t.me/s-Seite live lesen oder · als Desktop-Export

**Diagramm als Text**

1. Collector → Zeuge (Signierter Prüfpunkt: Anzahl der Einträge + Head-Hash)
2. Zeuge → Witness-Protokoll, eigener Schlüssel
3. Zeuge → Telegram-Kanal (Signierter Beitrag über den eigenen Bot)
4. Beweismaterial-ZIP → verify.py
5. Witness-Protokoll, eigener Schlüssel → verify.py
6. Telegram-Kanal → verify.py (t.me/s-Seite live lesen oder als Desktop-Export)

**Auf dieser Seite**

- [Was der Witness festhält](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#what-the-witness-holds)
- [Was überprüft und aufgezeichnet wird](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#what-it-checks-and-records)
- [Einen Witness ausführen](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#run-a-witness)
- [Öffentliche Nachweisseite für mehrere Arbeitsbereiche](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#public-proof-page-for-several-workspaces)
- [Überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#verify)

## Was der Witness festhält

| Der Zeuge hat | Der Zeuge hat niemals |
| --- | --- |
| Ein schreibgeschütztes **Witness-Token** für einen Arbeitsbereich | Die Telegram-Sitzung oder die API-Zugangsdaten des Erfassers |
| Eigener Ed25519-Schlüssel und eigenes Protokoll | Der Speicher des Collectors, der Signaturschlüssel oder das Panel-Token |
| Ein eigenes Telegram-Bot-Token | Inhalt der Nachricht: Der Kopf besteht aus einer Datensatzanzahl und einem Hash |

Das Token wird unter **Weitere Tools → Extras → Unabhängiger Zeuge** erstellt, einmal angezeigt und ausschließlich als SHA-256 gespeichert. Es öffnet genau einen Endpunkt, `GET /api/witness/head`, der einen frisch signierten Checkpoint sowie signierte, inhaltsfreie Sammelzähler und den Betriebszustand zurückgibt. Es kann weder das Panel öffnen, noch Nachrichteninhalte lesen oder Einstellungen ändern, und das Panel-Token wird dort nicht akzeptiert. Ein Token kann auf derselben Seite widerrufen werden. Der Collector protokolliert, wann ein neuer Witness-Schlüssel mit der Überprüfung beginnt (`witness.seen`), und zeigt die letzte Überprüfung pro Token an; ein Witness, der innerhalb von 2.5-Intervallen keine Überprüfung durchgeführt hat, wird als überfällig markiert.

Neue Zeugen senden bei jeder Abfrage eine zufällige Herausforderung; die Erfassungsanweisung gibt diese unter der Signatur des Sammlers wieder. Zähler sind an den genauen Kontrollpunkt gebunden und werden in signierte Zeugenbeiträge aufgenommen. Ältere Kopfzeilen werden vom eigenständigen Zeugen weiterhin akzeptiert. Das Wachstum des Protokolls allein wird niemals als neue Nachricht gezählt.

## Was überprüft und aufgezeichnet wird

In jedem Intervall (standardmäßig alle 10 Minuten) führt TgWitness folgende Schritte durch:

1. ruft den Header selbst ab (der Collector kann ihn weder übertragen noch überspringen);
2. Überprüft die Signatur des Collectors, den festgesteckten Collector-Schlüssel (`--collector-fingerprint`, bzw. den zuerst gesehenen Schlüssel), einen nicht abnehmenden Zähler und einen unveränderten Kopf bei einem unveränderten Zähler. Merkle-Inklusions- und Konsistenznachweise überprüfen, ob ein wachsendes Journal den beibehaltenen Checkpoint erweitert. Sobald Kontinuitätsnachweise verwendet wurden, wird deren Entfernung abgelehnt;
3. fügt seinem eigenen Protokoll einen signierten Datensatz hinzu: `witness.anchor` mit dem Status `ok`, `key_changed`, `rollback` (weniger Datensätze als zuvor), `fork` (gleiche Länge, anderer Kopf) oder `invalid` (die Antwort hat die Überprüfung nicht bestanden) oder `witness.no_response`, wenn der Kollektor nicht geantwortet hat;
4. Das Ergebnis wird signiert im Kanal veröffentlicht, einschließlich der Meldung „keine Antwort“, solange TgWitness läuft und die Bot-API erreichen kann. Die Beitrags-ID wird aufgezeichnet (`witness.posted`), ebenso wie ein fehlgeschlagener Beitrag (`witness.post_failed`).

Ein Eintrag sieht wie folgt aus; die letzte Zeile enthält die signierte Erklärung:

```
TgWitness witness #42 · journal head
Collector 3fa9c2d1e0b4a7f6: 18234 records
Head 9b1f…c07e
2026-10-28T19:40:00.123+00:00
TGW1.eyJhdCI6…<statement>.<signature>
```

## Ein Witness ausführen

Sie benötigen einen Telegram-Bot (erstellen Sie einen mit @BotFather), einen Kanal, in dem dieser Bot als Administrator fungiert, sowie die Adresse des Collectors, die für den Zeugen erreichbar ist – über HTTPS außerhalb eines privaten Netzwerks (siehe das HTTPS-Profil im Abschnitt [„Bereitstellung“](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/)).

Öffnen Sie im Panel **Weitere Tools → Extras → Unabhängiger Witness → „Konfigurieren** “. In drei Schritten werden der schreibgeschützte Zugriff, Ihr Kanal und das Intervall festgelegt, anschließend wird der Witness gestartet. Die Veröffentlichungsrichtlinie, ein optionaler HTTP/SOCKS5-Proxy und eine benutzerdefinierte Bot-API-Adresse finden Sie unter **„Erweiterte Einstellungen** “. Das Formular lädt die Datei `witness.json` herunter, in der der Collector-Schlüssel dieses Arbeitsbereichs festgehalten ist. Laden Sie das neu erstellte schreibgeschützte Token mit **„Zugriffsdatei speichern** als“ `witness-token.txt` herunter; legen Sie diese Datei sowie eine auf dem Witness-Host erstellte `bot-token.txt` -Datei neben dieser JSON-Datei ab. Der Collector erhält das Bot-Token niemals. Der Download startet weder einen Dienst noch wird eine Nachricht veröffentlicht. Es wird kein Witness für ein gehostetes Projekt implizit registriert.

```
python -m tgwitness.witness run --config witness.json --check-config
python -m tgwitness.witness run --config witness.json
python -m tgwitness.witness fingerprint --config witness.json
```

Der erste Befehl überprüft Konfigurations- und Geheimdateien ohne Netzwerkanfragen oder Schlüsselerstellung. Pfade in JSON sind relativ zu dieser Datei; CLI-/Umgebungspfade sind relativ zum Arbeitsverzeichnis. Bewahren Sie den Fingerabdruck des Witness außerhalb seines Hosts auf. Der „Last-Poll“-Indikator des Collectors bestätigt lediglich eine Anfrage; die Veröffentlichung wird von Proof gemeldet oder im Witness-Protokoll und im Kanal überprüft.

Wenn sich das Panel hinter einem SSH-Tunnel befindet, stellen Sie nur den begrenzten Witness-Endpunkt auf einem separaten HTTPS-Hostnamen gemäß [diesem Caddy-Beispiel](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example) bereit. Der Standard-Arbeitsbereich verwendet dann „`https://witness.example.org`“, andere Arbeitsbereiche verwenden „ `https://witness.example.org/profiles/ID`“. Token sind weiterhin erforderlich; das Panel und seine anderen API-Routen werden von diesem virtuellen Host nicht weitergeleitet.

Wählen Sie „`all`“ für regelmäßig veröffentlichte Checkpoints. Ein Fünf-Minuten-Intervall entspricht etwa 288 Einträgen pro Arbeitsbereich pro Tag. „`changes`“ und „`problems`“ lassen bewusst einige Überprüfungen unveröffentlicht. MTProxy ist für den Telegram-Client des Erfassers vorgesehen. Witness-HTTP-Abfragen und die HTTPS-Bot-API von Telegram verwenden ihre eigene direkte/HTTP/SOCKS5-Route ([Bot-API](https://core.telegram.org/bots/api)).

**Neben dem Collector, mit Docker** (derselbe Host – unabhängiger Prozess und Schlüssel, jedoch derselbe Betreiber): Geben Sie die Werte in „`.env`“ ein und starten Sie das Profil.

```
TGWITNESS_WITNESS_TOKEN=tgww_...
TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC...
TGWITNESS_WITNESS_CHANNEL=@your_witness_channel
# another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/<workspace ID>

docker compose --profile witness up -d
docker compose logs witness     # prints the witness key fingerprint
```

Verwenden Sie bei der Veröffentlichung eines Bildes den Code `docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d`.

**Auf einem fremden Server** (getrennte Verwahrung): Kopieren Sie das Repository dorthin, setzen Sie `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` sowie die drei oben genannten Werte in `.env` und führen Sie anschließend

```
docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d
```

oder ohne Docker:

```
python -m tgwitness.witness run --collector https://your-collector.example.org \
    --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel
```

### Auf Discord veröffentlichen

Ein Witness kann Beiträge statt auf Telegram auch in einem Discord-Kanal veröffentlichen. Öffne in Discord **„Kanal bearbeiten“ → „Integrationen“ → „Webhooks“**, erstelle einen Webhook und kopiere dessen URL. Wähle im Bedienfeld in Schritt 2 **„Discord-Webhook · dein Kanal**“ aus. Speichere auf dem Witness-Host die URL als `discord-webhook.txt` neben `witness.json`; sie gelangt niemals zum Collector.

```
python -m tgwitness.witness run --collector https://your-collector.example.org \
    --token-file witness-token.txt --discord-webhook-file discord-webhook.txt
```

Ein Witness hat einen Publisher: entweder einen Telegram-Kanal oder einen Discord-Webhook, nicht beides. Beiträge enthalten dieselbe signierte Aussage und können niemanden anpingen. Ein Beitrag, der länger als die von Discord festgelegten 2,000 Zeichen ist, wird durch eine kurze Zeile ersetzt, wobei der vollständige Check als `witness-check.txt` angehängt wird. Jede Beitrags-ID wird als `witness.posted` aufgezeichnet. `verify.py --channel` liest nur Telegram-Kanäle aus; für Discord sollte daher das Witness-Journal geführt werden: Es enthält jeden Check. Discord-Beiträge liefern dem Verifizierer keine externe Zeitangabe.

### Optionen

| Option | Umfeld | Standard | Bedeutung |
| --- | --- | --- | --- |
| `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | Intervalle zwischen den Überprüfungen: 1–1.440 |
| `--timeout` | `_TIMEOUT` | 30 | Wartezeit für den Collector und die Bot-API: 5–600 Sekunden |
| `--post` | `_POST` | `all` | `all`: alles in Ordnung; `changes`: ein neuer Ansatz oder ein Problem; `problems`: ausschließlich Probleme und fehlende Antworten |
| `--title` | `_TITLE` | `TgWitness witness` | Die ersten Wörter jedes Kanalbeitrags |
| `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | Speichern Sie den Collector-Schlüssel, anstatt der ersten Antwort zu vertrauen |
| `--proxy` | `_PROXY` | direkt | `socks5://host:port` oder `http://host:port` |
| `--bot-api` | `_BOT_API` | `https://api.telegram.org` | Adresse der Bot-API, z. B. eines lokalen Bot-API-Servers |
| `--data-dir` | `_DATA` | `witness-data` | Witness-Schlüssel und Protokoll |
| `--config` | `_CONFIG` | – | JSON-Datei mit einer der oben genannten Optionen |

Die Collector-Adresse, die Tokens und der Kanal stammen von `--collector`, `--token` oder `--token-file`, `--bot-token` oder `--bot-token-file`, `--discord-webhook-file` und `--channel`, oder `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` und `_CHANNEL`, wodurch Geheimnisse aus der Prozessliste ferngehalten werden.

Eine Konfigurationsdatei verwendet Optionsnamen mit Unterstrichen sowie „`texts`“, wodurch die Wörter der Kanalbeiträge ersetzt werden:

```
{"collector": "https://your-collector.example.org", "token_file": "witness-token.txt",
 "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel",
 "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness",
 "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}}
```

`texts`-Schlüssel: `ok`, `key_changed`, `rollback`, `fork`, `invalid`, `no_response`, `collector`, `records`, `head`. Die Befehlszeile hat Vorrang vor der Umgebung, die Umgebung vor der Datei. Unbekannte Optionen oder Text-Schlüssel stoppen den Zeugen mit einer Meldung, anstatt ignoriert zu werden. Der Wortlaut hat keinerlei Einfluss auf die Verifizierung: verify.py überprüft das signierte Token am Ende jedes Beitrags. Bei `--post changes` oder `problems` befinden sich nicht gepostete Prüfungen weiterhin im Witness-Journal, und `verify.py` listet sie als nie gepostet auf; der Startdatensatz benennt die Richtlinie. Jede Prüfung erscheint weiterhin im Journal, sodass weniger Beiträge bedeuten, dass weniger Einträge von Telegram datiert werden, nicht jedoch, dass weniger Prüfungen vorhanden sind.

Auch ohne Kanal führt „Witness“ weiterhin sein Protokoll. Bewahren Sie den Fingerabdruck des „Witness“-Schlüssels (`python -m tgwitness.witness fingerprint`) an einem anderen Ort auf.

## Öffentliche Proof-Seite für mehrere Arbeitsbereiche

`python -m tgwitness.proof` TgWitness unterstützt bis zu 32 Arbeitsbereiche gleichzeitig und stellt eine schreibgeschützte Seite mit der neuesten signierten Überprüfung jedes einzelnen bereit. Jeder Arbeitsbereich erhält einen eigenen Witness-Schlüssel und ein Journal im Datenordner sowie einen angehefteten Collector-Schlüssel; das Posten in einem Telegram-Kanal ist pro Arbeitsbereich optional. Beginnen Sie mit [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example):

| Fachgebiet | Bedeutung |
| --- | --- |
| `title` | Seitentitel, 1–100 Zeichen |
| `data_dir` | Witness-Schlüssel und -Journale, bezogen auf die Datei; Standard `proof-data` |
| `interval`, `timeout` | Minuten zwischen den Überprüfungen (1–1440, Standardwert 5); Sekunden Wartezeit (5–600, Standardwert 20) |
| `workspaces[].id`, `label` | Kurzer Alias in Kleinbuchstaben und der angezeigte Name |
| `workspaces[].collector` | Adresse des Collectors; andere Arbeitsbereiche enden auf `/profiles/<workspace ID>` |
| `workspaces[].collector_fingerprint` | Erforderlich, für jeden Arbeitsbereich unterschiedlich |
| `workspaces[].token_file` | Datei mit dem schreibgeschützten Witness-Token dieses Arbeitsbereichs |
| `workspaces[].channel`, `bot_token_file` | Optional, beides zusammen: Jede Überprüfung in einem Kanal veröffentlichen |
| `workspaces[].proxy`, `bot_api` | Optionale Route und Bot-API-Adresse |

```
python -m tgwitness.proof --config proof.json --check-config
python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790
```

Der erste Befehl überprüft die Datei und die Token-Dateien, ohne eine Verbindung herzustellen. Die Seite beantwortet nur GET- und HEAD-Anfragen:

- `/` Zeigt alle Arbeitsbereiche an; ein Arbeitsbereich, der seit 2,5 Intervallen nicht überprüft wurde, wird als veraltet markiert.
- `/api/proof` Liefert dasselbe Ergebnis wie JSON.
- `/api/proof/<id>` Lädt die neueste signierte Erklärung herunter (`tgwitness-public-proof-v1`): Witness-Aufzeichnungsnummer und Hash, Status, angehefteter Collector-Schlüssel, Checkpoint, Erfassungszähler sowie die Angabe, ob der Kanalbeitrag erfolgreich war, signiert mit dem Witness-Schlüssel dieses Arbeitsbereichs.
- `/healthz` Gibt den Status 503 zurück, wenn der Monitor eines Arbeitsbereichs gestoppt wurde.

Weisen Sie der Seite einen eigenen Hostnamen zu, wie z. B. [„Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example)“. Zur Überprüfung exportieren Sie das Witness-Journal eines Arbeitsbereichs mit `python -m tgwitness.witness export --data-dir proof-data/<id> --out witness.zip` und verwenden Sie es wie unten beschrieben.

## Überprüfen

Auf der Seite des Zeugen: Exportieren Sie das Protokoll:

```
python -m tgwitness.witness export --out witness.zip
# Docker (add -f deploy/compose/compose.witness.yaml on a witness server):
docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip
docker compose cp witness:/witness/witness.zip .
```

Anschließend kann man an beliebiger Stelle mit der signierten ZIP-Datei des Collectors und der Adresse des öffentlichen Kanals:

```
python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \
    --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel
```

`--channel` akzeptiert auch einen Telegram-Desktop-Export (*Chat-Verlauf exportieren* → JSON ergibt `result.json`) oder eine gespeicherte Kopie der Seite; diese überprüfen den Inhalt des Beitrags, liefern jedoch keine externe Zeitangabe.

`verify.py` überprüft das Zeugen-Journal (Kette und Signaturen) und anschließend, ob **jeder Head, den der Zeuge gesehen hat, Teil des exportierten Journals ist**: Der Datensatz an dieser Stelle muss genau diesen Hash aufweisen. Ein Head, der nicht übereinstimmt, führt zum Fehlschlagen der Überprüfung – das Journal wurde geändert, nachdem der Witness es gesehen hat. Es werden außerdem Heads gemeldet, die nach dem Export gesehen wurden, vom Witness aufgezeichnete Anomalien, fehlgeschlagene Antworten, Zeiträume, deren übereinstimmende Checkpoints in diesem Export vorhanden sind („Witnessed from X to Y“) sowie Lücken. Spätere Checkpoints verlängern diese Zeiträume nicht. Das Ergebnis enthält die Nummer des zuletzt übereinstimmenden Datensatzes und die Anzahl der nachfolgenden Datensätze ohne übereinstimmenden Checkpoint. Es zählen nur Antworten, die mit dem eigenen Schlüssel des Exports signiert wurden: Ein Export, der mit einem Schlüssel signiert wurde, den der Zeuge nie gesehen hat, wird als nicht bezeugt gemeldet, und ohne `--fingerprint` bleibt sein Unterzeichner ungebunden. Mit `--channel` muss jeder signierte Beitrag Datensatz für Datensatz mit dem Zeugen-Journal übereinstimmen : Geänderte Beiträge bestehen die Überprüfung nicht, fehlende Beiträge werden aufgelistet. Die Übereinstimmung des Tokens authentifiziert den Inhalt; das Datum liegt außerhalb des signierten Tokens.

Mit einer Live-Adresse `https://t.me/s/…` oder `https://telegram.me/s/…` liest der Prüfer das Datum jedes Beitrags zum Zeitpunkt der Überprüfung von der Seite ab. Telegram legt dieses Datum fest; Daten von bearbeiteten Beiträgen werden nicht verwendet. Das früheste solche Datum eines Beitrags am Exportanfang ist die externe Zeit des letzten Datensatzes, der diese Mindestbedingung für den Nachweis erfüllt. Daten aus anderen Quellen, wie beispielsweise einer bereitgestellten `result.json`-Datei, einer gespeicherten Seite oder einer anderen Webadresse, sind bereitgestellte Metadaten, keine unabhängige Zeitangabe; das Ergebnis gibt an, woher die Beitragsdaten stammen (`post_date_verification`).

### Eine beglaubigte Exportgrenze ist erforderlich

Für eine Übergabe, die eine beglaubigte Abschlussaufzeichnung enthalten muss, fügen Sie bitte „`--require-witness`“ hinzu:

```
python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \
    --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness
```

Dies erfordert den unabhängig gespeicherten Fingerabdruck des Zeugen, einen anderen Schlüssel als den Collector-Schlüssel und einen passenden Checkpoint genau am Ende dieses Exports. Ein Checkpoint, der nur ein früheres Präfix abdeckt, ist unzureichend. Unterbrechen Sie die Erfassung, lassen Sie den Zeugen den Endzustand beobachten und exportieren Sie, bevor weitere Einträge in das Journal geschrieben werden; sollte sich das Journal ändern, speichern Sie einen weiteren Checkpoint und exportieren Sie diesen Zustand. Ein späterer Checkpoint allein kann den endgültigen Hash eines kürzeren Exports nicht verifizieren. Wenn zusätzlich `--channel` angegeben wird, führen fehlende beanspruchte Beiträge oder eine leere Übereinstimmungsmenge zum Scheitern dieser strengen Prüfung. Ohne das Flag melden gewöhnliche Integritätsprüfungen weiterhin nicht bezeugte Datensätze, ohne ein ansonsten intaktes Archiv zurückzuweisen.

Das Witness-Journal und den darin festgehaltenen Schlüssel getrennt aufbewahren. Online-Prüfungen verifizieren die Kontinuität zwischen den Kontrollpunkten; die Offline-Verifizierung vergleicht jeden gespeicherten Kontrollpunkt mit dem Export. Ältere Heads ohne Kontinuitätsnachweise behalten den Offline-Vergleich bei und werden ohne Online-Kontinuitätsprüfung gemeldet. Der Bericht listet die Ausfallzeiten der Witnesses und fehlgeschlagene Veröffentlichungen nach Zeitintervallen auf.

### Tägliche Siegel und nicht verfügbare Zeitstempelkalender

Der Witness versiegelt die Journalgrenze des vorangegangenen UTC-Tages und übermittelt den Hash dieses signierten Siegels an OpenTimestamps. Eine Kalenderübermittlung ist ein ausstehender Nachweis; nur unabhängig überprüfte Bitcoin-Commitments erhalten eine Bestätigung im Verifier.

Wenn alle Kalender fehlschlagen, verbleiben das signierte Siegel und der erfolglose Versuch im Protokoll. Der stündliche Wartungsdurchlauf versucht diesen ursprünglichen Datensatz erneut, auch nach einem Neustart oder einer Datumsänderung. Er scannt höchstens 32-Siegel, übermittelt höchstens zwei fehlende Einreichungen und benötigt höchstens 60 Sekunden für Wiederholungsversuche pro Durchlauf. Ein persistenter Cursor durchläuft nacheinander ältere Siegel. Beibehaltene Einreichungen folgen dem bestehenden Proof-Upgrade-Pfad.

Ein erneuter Versuch überschreibt das Siegel nicht, ändert weder dessen ursprüngliches Datum noch behauptet er, dass der Kalender es früher empfangen habe. Eine spätere Bitcoin-Bestätigung bleibt eine spätere externe Bestätigung. Fehlende Nachweise bleiben `none`; ausstehende Nachweise bleiben `pending`, bis der Prüfer sie unabhängig überprüft.
