Struct AesGcmCrypter 

pub struct AesGcmCrypter { /* private fields */ }

AES-256-GCM 加密器（密码学安全）

使用 AES-256-GCM AEAD 算法，每次加密生成随机 12 字节 nonce。 密文格式：nonce(12) || ciphertext || tag(16)（由 aes-gcm crate 内部处理）。

Implementations

impl AesGcmCrypter

pub fn new(key: &[u8; 32]) -> Self

从 32 字节密钥创建

pub fn from_key_str(key: &str) -> Self

从任意长度密钥字符串创建（SHA-256 派生 32 字节密钥）

impl AesGcmCrypter

pub fn encrypt_with_aad( &self, plaintext: &[u8], aad: &[u8], ) -> Result<Vec<u8>, CryptoError>

AES-GCM 认证加密（带附加认证数据 AAD）

密文格式：nonce(12) || ciphertext || tag(16) AAD（Additional Authenticated Data）不包含在密文中，但参与认证标签计算， 解密时必须提供相同的 AAD 才能成功。

pub fn decrypt_with_aad( &self, ciphertext: &[u8], aad: &[u8], ) -> Result<Vec<u8>, CryptoError>

AES-GCM 认证解密（带附加认证数据 AAD）

必须提供与加密时相同的 AAD，否则认证标签校验失败。

Trait Implementations

impl Crypter for AesGcmCrypter

fn encrypt(&self, plaintext: &[u8]) -> Result<Vec<u8>, CryptoError>

fn decrypt(&self, ciphertext: &[u8]) -> Result<Vec<u8>, CryptoError>