Verificar la integridad de un zip de Knot Core

1. Obtener el SHA256 publicado

El hash actual se muestra en la página de Knot Core y en el manifiesto:

curl -sS https://knot.tools/downloads/data/releases.json | jq -r '.latest.zip_sha256'

O a través de las cabeceras HTTP al descargar:

curl -sI https://knot.tools/downloads/knot-core/latest | grep -i x-knot-sha256

2. Descargar el zip

curl -sSL -o knot-core.zip https://knot.tools/downloads/knot-core/latest

3. Comparar localmente

macOS / Linux (BSD):

shasum -a 256 knot-core.zip

Linux (GNU):

sha256sum knot-core.zip

El resultado debe corresponder exactamente al zip_sha256 publicado.

4. Firma Ed25519 (releases ≥ 2.13.4)

El manifiesto incluye signature_hex y signature_payload. La firma cubre el JSON canónico del payload (no el contenido binario del zip). Clave pública fijada: rel-2026-04.

628d5479fee21f70088115ea3dba50264d404d5a82782d6d20c781d3d27e188e

Ejemplo PHP (extensión sodium):

$manifest = json_decode(file_get_contents('https://knot.tools/downloads/data/releases.json'), true);
$payload = $manifest['latest']['signature_payload'];
$sig = sodium_hex2bin($manifest['latest']['signature_hex']);
$pub = sodium_hex2bin('628d5479fee21f70088115ea3dba50264d404d5a82782d6d20c781d3d27e188e');
$sort = function (array &$a) use (&$sort): void {
    ksort($a);
    foreach ($a as &$v) {
        if (is_array($v)) {
            $sort($v);
        }
    }
};
$sort($payload);
$canonical = json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
var_export(sodium_crypto_sign_verify_detached($sig, $canonical, $pub));