Skip to content

cipher ​

El namespace cipher.aes proporciona cifrado y descifrado autenticado AES-256-GCM.

tyrus
import { cipher, rand } from "tyrus:crypto";
import { utf8 } from "tyrus:encoding";

try {
    const key: u8[] = rand.randomBytes(32);
    const aad: u8[] = utf8.encode("record:42");
    const encrypted: u8[] = cipher.aes.encryptWithAad("sensitive data", key, aad);
    const decrypted: string = cipher.aes.decryptTextWithAad(encrypted, key, aad);
    print(decrypted);
} catch (error: Error) {
    printError(error.message);
}

Funciones ​

FunciónFirma
cipher.aes.encrypt(string | u8[], u8[]) => Result<u8[], CryptoError>
cipher.aes.encryptWithAad(string | u8[], u8[], u8[]) => Result<u8[], CryptoError>
cipher.aes.decryptText(u8[], u8[]) => Result<string, CryptoError>
cipher.aes.decryptBytes(u8[], u8[]) => Result<u8[], CryptoError>
cipher.aes.decryptTextWithAad(u8[], u8[], u8[]) => Result<string, CryptoError>
cipher.aes.decryptBytesWithAad(u8[], u8[], u8[]) => Result<u8[], CryptoError>

encrypt crea un envelope AES-256-GCM versionado. decryptText autentica antes de decodificar UTF-8, mientras que decryptBytes autentica antes de devolver bytes. La clave debe contener exactamente 32 bytes.

encryptWithAad, decryptTextWithAad y decryptBytesWithAad vinculan datos autenticados adicionales al envelope. El descifrado debe recibir AAD idéntico byte por byte. El envelope autentica magic, versión, identificador del algoritmo, nonce, ciphertext, tag y el AAD proporcionado. Las seis operaciones devuelven Result con CryptoError para fallos recuperables; maneje el valor con match o propáguelo con ?. Los códigos estables incluyen ERR_CRYPTO_INVALID_KEY_SIZE, ERR_CRYPTO_INVALID_ENVELOPE, ERR_CRYPTO_DECRYPTION_FAILED y ERR_CRYPTO_INVALID_UTF8.