2forseglede funn

Etterprøv selv

Du trenger ikke stole på oss.

Alt du trenger er en terminal med node og git. Instruksene under er de samme som er publisert i det offentlige ankerarkivet — et forseglet funn kan først etterprøves fullt ut når det avforsegles eller publiseres, for det er da det kanoniske artefaktet blir offentlig. Fram til da kan du kontrollere at hash, ankerforpliktelse og tidsstempel allerede står fast.

1. 1Hent det kanoniske artefaktet

   Publiserte og avforseglede funn serveres som kanonisk JSON fra API-et. Feltet canonical i svaret er selve artefaktet som ble hashet.

   curl -s https://www.folkefakta.no/api/findings/FUNN-ID -o svar.json

2. 2Regn ut SHA-256 på nytt

   Hashen tas over en kanonisk serialisering, ikke over rå JSON. Protokollregelen, ordrett fra protokollfilen (scripts/institution/lib/canonical.js): "JSON with object keys sorted by UTF-16 code-unit order, arrays in given order, no whitespace, hashed as SHA-256 over UTF-8 bytes." Altså: objektnøkler sortert i UTF-16-kodeenhetsrekkefølge (vanlig JavaScript-sortering), arrayer i sin opprinnelige rekkefølge, ingen mellomrom — rekursivt gjennom hele objektet. Lagre snutten under som kanonisk.js og kjør den eksakte kommandoen:

   // node kanonisk.js < svar.json | shasum -a 256
   function kanonisk(v) {
     if (v === null || typeof v !== 'object') return JSON.stringify(v);
     if (Array.isArray(v)) return '[' + v.map(kanonisk).join(',') + ']';
     return '{' + Object.keys(v).sort().map(function (k) {
       return JSON.stringify(k) + ':' + kanonisk(v[k]);
     }).join(',') + '}';
   }
   var raw = '';
   process.stdin.on('data', function (c) { raw += c; });
   process.stdin.on('end', function () {
     var svar = JSON.parse(raw);
     process.stdout.write(kanonisk(svar.canonical || svar));
   });

   node kanonisk.js < svar.json | shasum -a 256 skriver ut heksadesimalhashen. Snutten gjør det samme som verify.js i ankerarkivets README — den skriver den kanoniske serialiseringen til stdout, og shasum -a 256 hasher UTF-8-bytene.