Skip to content

digest ​

El namespace digest proporciona hashing de uso único e incremental.

tyrus
import { CryptoError, digest } from "tyrus:crypto";
import { utf8 } from "tyrus:encoding";

const data: u8[] = utf8.encode("hello world");
const hash: Result<u8[], CryptoError> = digest.sha256(data);
match (hash) { Ok(bytes) => { print(bytes.length); } Err(error) => { printError(error.code); } }

Funciones ​

FunciónFirma
digest.sha256(string | u8[]) => Result<u8[], CryptoError>
digest.sha384(string | u8[]) => Result<u8[], CryptoError>
digest.sha512(string | u8[]) => Result<u8[], CryptoError>
digest.md5(string | u8[]) => Result<u8[], CryptoError>
digest.create(string) => Result<DigestStream, CryptoError>

ATENCIÓN

digest.md5 existe solo para checksums de compatibilidad; MD5 tiene colisiones conocidas y no debe proteger contraseñas, firmas, certificados ni integridad sensible a la seguridad.

DigestStream ​

digest.create("sha256" | "sha384" | "sha512") devuelve un Result<DigestStream, CryptoError> para hashing incremental:

MétodoFirmaDescripción
update(string | u8[]) => Result<DigestStream, CryptoError>Alimenta datos, devuelve self
digest() => Result<u8[], CryptoError>Finaliza y devuelve hash
reset() => Result<DigestStream, CryptoError>Resetea estado, devuelve self
dispose() => voidLiberación anticipada determinista

El handle nativo se libera automáticamente al final de su ámbito léxico; dispose() permite la liberación anticipada determinista y debe llamarse como máximo una vez. Los algoritmos desconocidos se rechazan con ERR_CRYPTO_DIGEST_ALGORITHM.

tyrus
import { digest } from "tyrus:crypto";
import { utf8 } from "tyrus:encoding";

const stream: DigestStream = digest.create("sha256");
stream.update(utf8.encode("hello "));
stream.update(utf8.encode("world"));
const hash: u8[] = stream.digest();