Skip to main content

Module contract

Module contract 

Source
Expand description

能力契约(trait):业务层唯一需要依赖的东西。

对应 PHP 版的 Contract/ 命名空间。PHP 里 EncryptorInterface 是 SymmetricCipherInterface 的别名,Rust 侧只保留一个 SymmetricCipher。

Traits§

AsymmetricCipher
非对称加密:每次调用传入密钥材料(十六进制,格式由实现决定,如 SM2)。
Hasher
哈希:单向摘要,无密钥。
Identified
任何可注册进注册表的能力都带一个稳定标识(如 aes-256-gcm)。
KeyAgreement
密钥协商:以己方私钥与对方公钥导出共享秘密(ECDH / X25519)。
KeyDerivation
基于密钥材料的派生(典型为 HKDF):从 IKM + salt + info 得到任意长度输出。
KeyEncapsulation
密钥封装(KEM,FIPS 203 ML-KEM):公钥封装 → (密文, 共享密钥);私钥解封装。 公钥、私钥、密文与共享密钥均为十六进制。
PasswordBasedKdf
基于口令的密钥派生(典型为 PBKDF2):从人类可读口令得到固定长度密钥。
Signer
签名:消息签名与验签。密钥与签名均为十六进制,格式由实现决定 (本项目内统一:ECDSA / SM2 为定长 r‖s,Ed25519 为 64 字节定长)。
SymmetricCipher
对称加密:同一实例绑定固定密钥,对二进制载荷加解密。