Expand description
能力契约(trait):业务层唯一需要依赖的东西。
对应 PHP 版的 Contract/ 命名空间。PHP 里 EncryptorInterface 是
SymmetricCipherInterface 的别名,Rust 侧只保留一个 SymmetricCipher。
Traits§
- Asymmetric
Cipher - 非对称加密:每次调用传入密钥材料(十六进制,格式由实现决定,如 SM2)。
- Hasher
- 哈希:单向摘要,无密钥。
- Identified
- 任何可注册进注册表的能力都带一个稳定标识(如
aes-256-gcm)。 - KeyAgreement
- 密钥协商:以己方私钥与对方公钥导出共享秘密(ECDH / X25519)。
- KeyDerivation
- 基于密钥材料的派生(典型为 HKDF):从 IKM + salt + info 得到任意长度输出。
- KeyEncapsulation
- 密钥封装(KEM,FIPS 203 ML-KEM):公钥封装 → (密文, 共享密钥);私钥解封装。 公钥、私钥、密文与共享密钥均为十六进制。
- Password
Based Kdf - 基于口令的密钥派生(典型为 PBKDF2):从人类可读口令得到固定长度密钥。
- Signer
- 签名:消息签名与验签。密钥与签名均为十六进制,格式由实现决定
(本项目内统一:ECDSA / SM2 为定长
r‖s,Ed25519 为 64 字节定长)。 - Symmetric
Cipher - 对称加密:同一实例绑定固定密钥,对二进制载荷加解密。