Skip to content

argon2 ​

O namespace argon2 fornece hashing de senhas Argon2id com parâmetros configuráveis.

tyrus
import { CryptoError, argon2, jwt, rand } from "tyrus:crypto";

interface SessionClaims {
    role: string;
}

// Password hashing
match (await argon2.hash("my-password")) {
    Ok(hash) => {
        match (await argon2.verify(hash, "my-password")) {
            Ok(valid) => { print(valid); } // true
            Err(error) => { printError(error.code); } // ERR_CRYPTO_ARGON2_*
        }
        match (argon2.needsRehash(hash)) {
            Ok(migrate) => { print(migrate); } // false
            Err(error) => { printError(error.code); } // ERR_CRYPTO_ARGON2_INVALID_HASH
        }
    }
    Err(error) => { printError(error.code); } // ERR_CRYPTO_ARGON2_*
}

// JWT HMAC requires at least 32 bytes of secret material.
try {
    const key: string = "0123456789abcdef0123456789abcdef";
    const inputClaims: SessionClaims = { role: "reader" };
    const signed: Result<string, CryptoError> = jwt.sign(inputClaims, key, { algorithm: "HS384", expiresIn: "1h", subject: "123" });
    match (signed) {
        Ok(token) => {
            const verified: Result<SessionClaims, CryptoError> = jwt.verify<SessionClaims>(token, key, { algorithms: ["HS384"], subject: "123" });
            match (verified) {
                Ok(claims) => {
                    print(claims.role); // reader
                }
                Err(error) => { printError(error.code); } // ERR_CRYPTO_*
            }
        }
        Err(error) => { printError(error.code); } // ERR_CRYPTO_*
    }
} catch (error: Error) {
    printError(error.message);
}

// Secure random
const id: string = rand.uuidv7();
try {
    const bytes: u8[] = rand.randomBytes(32);
    print(bytes.length);
} catch (error: Error) {
    printError(error.message);
}

Funções ​

FunçãoAssinatura
argon2.hash(string | u8[], options?) => Promise<Result<string, CryptoError>>
argon2.verify(string, string | u8[], options?) => Promise<Result<boolean, CryptoError>>
argon2.needsRehash(string) => Result<boolean, CryptoError>

argon2.hash cumpre com Ok(hash) em caso de sucesso e Err(CryptoError) para entrada ou opções inválidas, concorrência esgotada, falha do gerador aleatório ou falha do worker. Usa Argon2id com salt aleatório de 16 bytes, saída de 32 bytes e o perfil padrão m=65536, t=3, p=4. As opções podem definir type: "argon2id", memoryCost de 19.456 a 262.144 KiB, timeCost de 2 a 10, parallelism de 1 a 16 e um secret binário não vazio de até 1.024 bytes. Senhas textuais e binárias são limitadas a 1.024 bytes.

argon2.verify cumpre com Ok(matches) para um hash válido e Err(CryptoError) para strings PHC malformadas, parâmetros inválidos, pepper obrigatório ausente, concorrência esgotada ou falha do worker. Limita strings PHC a 4 KiB e valida parâmetros não confiáveis antes de alocar trabalho. Um hash com pepper contém um marcador autenticado não secreto; omitir secret retorna ERR_CRYPTO_ARGON2_PEPPER_REQUIRED, enquanto um secret incorreto retorna Ok(false). Armazene e rotacione o pepper separadamente dos hashes de senha.

argon2.needsRehash retorna Ok(true) quando a string PHC é válida, mas seu algoritmo, versão, parâmetros, tamanho do salt ou tamanho da saída diferem do perfil padrão. Strings PHC inválidas ou grandes demais retornam Err(CryptoError) com o código ERR_CRYPTO_ARGON2_INVALID_HASH.

Limite de concorrência

No máximo quatro operações Argon2 executam simultaneamente. Chamadas adicionais cumprem com Err(CryptoError) e o código ERR_CRYPTO_ARGON2_BUSY.