Blockchain-Verifizierung

Einen Datensatz verifizieren

Authentifizierte Benutzer können jeden blockchain-verankerten Datensatz innerhalb der Plattform verifizieren, und Gegenparteien können dieselben Datensätze auf der öffentlichen Verifizierungsseite ohne Anmeldung prüfen. Die Verifizierung bestätigt, dass das Dokument seit seiner Verankerung nicht verändert wurde: Die Plattform berechnet den SHA-256-Hash des aktuellen Dokuments neu und vergleicht ihn mit dem auf der Blockchain gespeicherten Hash. Eine Übereinstimmung bedeutet, dass das Dokument unverändert ist; eine Nichtübereinstimmung bedeutet, dass es seit der Verankerung geändert wurde.

Was Sie lernen werden

So verifizieren Sie einen verankerten Datensatz innerhalb eines Falls
Was Sie zur Verifizierung benötigen (In-App- vs. öffentliche Verifizierung)
Was eine erfolgreiche vs. fehlgeschlagene Verifizierung bedeutet
So suchen Sie einen Datensatz anhand des Transaktions-Hash oder der Entitäts-ID
So funktioniert das Wiederholungs- und Ausstehend-Transaktionssystem

Authentifizierungsanforderung

Vilulia bietet zwei Verifizierungswege. Gegenparteien, die einen verankerten Datensatz erhalten, können ihn auf der öffentlichen Seite unter /verify ohne Konto oder Anmeldung verifizieren, per Transaktions-Hash, Vergleichs-ID, Schiedsspruch-ID oder durch Einreichen eines Hashs zum Vergleich. Die In-App-Verifizierungs-API ist davon getrennt: Sie erfordert Authentifizierung, Zugriff auf den Fall oder die Entität sowie die Funktion blockchain_verification in Ihrem Tarif.

Verifizierung über einen Falldatensatz

Bei Schiedssprüchen wird der Blockchain-Verifizierungsstatus direkt im Tab Schiedssprüche des Falls angezeigt. Sobald ein Schiedsspruch ausgestellt und verankert wurde, zeigt das Panel den Transaktions-Hash (tx_hash), die Blocknummer, das bestätigte Datum und die Uhrzeit, den Netzwerknamen sowie einen Link zur Ansicht der Transaktion auf PolygonScan an. Wurde ein Schiedsspruch noch nicht verankert, wird eine Schaltfläche Auf Blockchain verifizieren angezeigt, die die Verankerung einleitet. Es gibt keinen separaten Verifizierungs-Tab im Falldatensatz.

Die Verifizierung wird für Vergleiche, Schiedssprüche, Dokumente (nur endgültige/ausgeführte) und Schulungszertifikate unterstützt. Beweis-Uploads, Entwürfe und Arbeitsdokumente werden nicht auf der Chain gespeichert.

QR-Codes für Schulungszertifikate

PDF-Schulungszertifikate enthalten einen QR-Code, der eine Verifizierungs-URL in der Form https://vilulia.com/verify/{verification_code} kodiert. Das Scannen des QR-Codes öffnet eine öffentliche Verifizierungsabfrage für dieses Zertifikat und gibt den Namen des Inhabers, den Kurstitel und das Ausstellungsdatum zurück. Eine Anmeldung ist nicht erforderlich.

Verifizierung per Transaktions-Hash oder Entitäts-ID

Jeder verankerte Datensatz kann per Transaktions-Hash (GET /api/v1/blockchain/tx/{tx_hash}) oder nach Entitätstyp und ID verifiziert werden (zum Beispiel GET /api/v1/blockchain/settlement/{id}, GET /api/v1/blockchain/award/{id}, GET /api/v1/blockchain/document/{id} oder GET /api/v1/blockchain/certificate/{id}). Die öffentliche Verifizierungsseite deckt ohne Anmeldung eine Teilmenge davon ab: GET /verify/tx/{tx_hash}, GET /verify/settlement/{id} und GET /verify/award/{id}. Administratoren können außerdem die Seite Blockchain-Verifizierungsverlauf im Admin-Dashboard aufrufen, die alle verankerten Datensätze in einer filterbaren, paginierten Tabelle auflistet und einen CSV-Export unterstützt.

Ausstehende Transaktionen

Wenn eine Transaktion an das Polygon-Netzwerk übermittelt wird, die Bestätigung jedoch das Zeitlimit überschreitet, speichert das System sie als ausstehend und eine Hintergrundaufgabe überwacht sie weiter. Der Verankerungsstatus kann über GET /api/v1/blockchain/anchor-status/{log_id} oder nach Entität über GET /api/v1/blockchain/anchor-status/by-entity/{type}/{id} abgefragt werden. Mögliche Statuswerte sind: pending, processing, submitted, confirmed und failed.

Wiederholungslogik

Das Verankerungssystem wiederholt vorübergehende Fehler (Netzwerkfehler, Zeitüberschreitungen, Ratenbegrenzungen, 5xx-Antworten) automatisch mit exponentiellem Backoff und vollem Jitter, standardmäßig bis zu drei Versuchen. Dauerhafte Fehler (unzureichende Mittel, ungültige Signatur, Ausführung rückgängig gemacht) werden nicht wiederholt. Wenn alle Wiederholungen erschöpft sind, wird der Datensatz als fehlgeschlagen markiert und kann manuell erneut eingereicht werden.

Verifizierungsergebnisse

Ein verifiziertes Ergebnis bedeutet, dass der SHA-256-Hash des aktuellen Dokuments mit dem zum Zeitpunkt der Verankerung auf der Polygon-Blockchain gespeicherten Hash übereinstimmt und damit bestätigt, dass das Dokument nicht verändert wurde. Ein fehlgeschlagenes Ergebnis bedeutet, dass die Hashes nicht übereinstimmen, was darauf hinweist, dass der Dokumentinhalt von dem abweicht, was verankert wurde. Eine fehlgeschlagene Verifizierung sollte sofort untersucht werden.

Ist der Blockchain-Dienst zum Zeitpunkt der Verifizierung nicht verfügbar, vergleicht die Plattform den erwarteten Hash mit dem lokal in der Datenbank gespeicherten Hash und vermerkt dies in der Antwort.