Struct AeadAlgorithmBuilder

pub struct AeadAlgorithmBuilder;

Builder for constructing aead algorithm instances.

用于构建对称算法实例的构建器。

Usage Pattern | 使用模式

The builder provides a fluent interface for algorithm selection:

构建器为算法选择提供流畅的接口：

use seal_crypto_wrapper::algorithms::aead::AeadAlgorithm;

// High performance with hardware acceleration
let aes = AeadAlgorithm::build().aes256_gcm();

// Software-optimized
let chacha = AeadAlgorithm::build().chacha20_poly1305();

// Extended nonce support
let xchacha = AeadAlgorithm::build().xchacha20_poly1305();

Implementations

impl AeadAlgorithmBuilder

pub fn aes128_gcm(self) -> AeadAlgorithm

Selects AES-128-GCM algorithm.

选择 AES-128-GCM 算法。

Properties | 属性

• Key size: 128 bits
• Nonce size: 96 bits (12 bytes)
• Tag size: 128 bits (16 bytes)
• Security level: 128-bit

Performance | 性能

Excellent with AES-NI hardware acceleration. 在 AES-NI 硬件加速下表现出色。

pub fn aes256_gcm(self) -> AeadAlgorithm

Selects AES-256-GCM algorithm.

选择 AES-256-GCM 算法。

Properties | 属性

• Key size: 256 bits
• Nonce size: 96 bits (12 bytes)
• Tag size: 128 bits (16 bytes)
• Security level: 256-bit

Use Cases | 使用场景

Recommended for high-security applications and long-term data protection. 推荐用于高安全性应用和长期数据保护。

pub fn chacha20_poly1305(self) -> AeadAlgorithm

Selects ChaCha20-Poly1305 algorithm.

选择 ChaCha20-Poly1305 算法。

Properties | 属性

• Key size: 256 bits
• Nonce size: 96 bits (12 bytes)
• Tag size: 128 bits (16 bytes)
• Security level: 256-bit

Advantages | 优势

• Constant-time implementation
• No timing side-channels
• Excellent software performance
• 常数时间实现
• 无时序侧信道
• 出色的软件性能

pub fn xchacha20_poly1305(self) -> AeadAlgorithm

Selects XChaCha20-Poly1305 algorithm.

选择 XChaCha20-Poly1305 算法。

Properties | 属性

• Key size: 256 bits
• Nonce size: 192 bits (24 bytes)
• Tag size: 128 bits (16 bytes)
• Security level: 256-bit

Key Feature | 关键特性

Extended 192-bit nonce eliminates nonce collision concerns. 扩展的 192 位 nonce 消除了 nonce 碰撞的担忧。