Enum CipherId 

#[repr(u8)]
pub enum CipherId {
    ChaCha20Poly1305 = 1,
    Aes256Gcm = 2,
}

AEAD 算法选择。

Variants

ChaCha20Poly1305 = 1

ChaCha20-Poly1305（RFC 8439），12 字节 nonce。

参考实现与测试向量使用此算法。生产默认为 XChaCha20-Poly1305（24 字节 nonce）， 目前尚未实现，见 docs/research/02-file-format-spec.md §5.2 的说明。

Aes256Gcm = 2

AES-256-GCM。有 AES-NI 硬件加速时更快。

Implementations

impl CipherId

pub const fn from_u8(v: u8) -> Result<Self>

由 header 中的数值解析。

Errors

未知取值时返回 Error::MalformedHeader。

pub fn encrypt( self, key: &SecretKey, nonce: &[u8; 12], plaintext: &[u8], aad: &[u8], ) -> Result<Vec<u8>>

AEAD 加密。输出为 密文 || tag。

Errors

底层 AEAD 失败时返回错误（正常输入下不会发生）。

pub fn decrypt( self, key: &SecretKey, nonce: &[u8; 12], ciphertext: &[u8], aad: &[u8], ) -> Result<Option<Vec<u8>>>

AEAD 解密。输入为 密文 || tag。

认证失败时返回 Ok(None)，让调用方区分「密码不对」和「真的坏了」—— 这在扫描场景下很关键：试错密码是正常流程，不该当作错误处理。

Errors

目前不返回 Err，签名保留以便未来扩展。

Trait Implementations

impl Clone for CipherId

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for CipherId

impl Debug for CipherId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for CipherId

impl PartialEq for CipherId

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CipherId