Skip to content

digest ​

O namespace digest fornece 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); } }

Funções ​

FunçãoAssinatura
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>

ATENÇÃO

digest.md5 existe apenas para checksums de compatibilidade; MD5 possui colisões conhecidas e não deve proteger senhas, assinaturas, certificados ou integridade sensível à segurança.

DigestStream ​

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

MétodoAssinaturaDescrição
update(string | u8[]) => Result<DigestStream, CryptoError>Alimenta dados, retorna self
digest() => Result<u8[], CryptoError>Finaliza e retorna hash
reset() => Result<DigestStream, CryptoError>Reseta estado, retorna self
dispose() => voidLiberação antecipada determinística

O handle nativo é liberado automaticamente ao final do escopo léxico; dispose() permite liberação antecipada determinística e deve ser chamado no máximo uma vez. Algoritmos desconhecidos são rejeitados com 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();