Hash dokazuje bajtove, ne značenje
Dokaz u decision ledgeru vrijedi samo ako netko godinama kasnije može rekonstruirati potpuno iste bajtove. Kanonska serijalizacija, schema version u svakom zapisu i verifier koji ne dijeli vaš kod čine hash reproducibilnim.

U decision ledgeru izračunate hash zapisa, anchorate ga, a godinama kasnije netko ga ponovno izračuna da provjeri da se ništa nije promijenilo. Anchor je lakši dio. Provjera radi samo ako ta osoba može rekonstruirati potpuno iste bajtove nad kojima je hash izvorno izračunat, i tu se mnogi ledgeri lome a da nitko ne primijeti.
Ista odluka, dva hasha
Hash funkcija ne zna što odluka znači. Vidi bajtove. Serijalizirajte isti objekt dvaput i možete dobiti dva različita niza: ključevi drugim redom, razmak iza dvotočke, broj zapisan kao 1.0 umjesto 1, vrijeme s milisekundama ili bez njih, slovo s dijakritikom u drugom Unicode obliku. Svaka razlika daje potpuno drukčiji hash.
Najčešće se to dogodi bez buga u vašem kodu. Nadogradi se serializer library i promijene se defaulti. Klasi se doda polje i output se pomakne. Netko ponovno računa hash iz retka u bazi umjesto iz izvornog payloada. Zapis je netaknut, nitko ga nije mijenjao, a dokaz svejedno pada. Još gore, pada pred osobom za koju je ledger izgrađen.
Tri pravila za reproducibilne bajtove
Kanonska serijalizacija. Odaberite jedan encoding i dokumentirajte ga: redoslijed polja, zapis brojeva, datuma i vremenskih zona, Unicode normalizaciju, kodiranje znakova. Postojeće sheme poput RFC 8785 za JSON dobra su polazna točka. Zatim spremite točno one bajtove nad kojima ste računali hash, a pri provjeri hashirajte te spremljene bajtove. Nikad novu serijalizaciju objekta učitanog odnekud drugdje.
Schema version u svakom zapisu. Polja će se kroz godine mijenjati. Zapis mora reći po kojim je pravilima nastao, kako bi onaj tko ga čita za pet godina znao kako ga tumačiti i koju kanonizaciju primijeniti. Stari zapisi se ne prepisuju u novu shemu: zadržavaju svoju verziju.
Verifier koji ne dijeli vaš kod. Ako hash može reproducirati samo vaša aplikacija, dokaz ovisi o tome da aplikacija još postoji i ponaša se jednako. Zapišite encoding dovoljno dobro da ga netko drugi implementira u drugom jeziku, i po mogućnosti neka to netko i učini.
Testirajte ga kao svaki drugi contract
Držite u repozitoriju mali skup fiksnih primjera zapisa s očekivanim hashevima. Pokrećite ih u CI-ju na svakom buildu. Ako nadogradnja librarya ili refaktoriranje promijeni ijedan hash, build pada prije nego što išta stigne u produkciju. Postavljanje traje nekoliko minuta i to je jedino rano upozorenje koje ćete dobiti.
Što to znači za isporuku
Za tvrtke u regiji koje rade za strane klijente to je razlika između dokaza i obećanja kad revizor partnera zatraži provjeru. Anchor dokazuje da se bajtovi nisu promijenili. Da budu reproducibilni, to je vaš posao i dio specifikacije ledgera, ne detalj implementacije. Encoding, verzije sheme i test vektori idu u paket isporuke.
Kako bi netko izvan vašeg tima ponovno izračunao jedan od vaših hasheva?