注意：SIMD 后端需要 64 位字大小。尝试设置 bits=32 和 backend=simd 将导致编译错误。

交叉编译

由于后端选择是通过目标进行的，交叉编译将自动选择正确的字大小。例如，如果 x86-64 Linux 机器运行以下命令，curve25519-dalek 将使用 32 位的 serial 后端编译。

$ sudo apt install gcc-multilib # (or whatever package manager you use)
$ rustup target add i686-unknown-linux-gnu
$ cargo build --target i686-unknown-linux-gnu

SIMD 后端

具体的 SIMD 后端（AVX512 / AVX2 / serial 默认）会根据当前可用的 CPU 功能以及是否使用 Rust 夜间构建自动选择。具体条件如下所述。

对于给定的 CPU 功能，您也可以指定适当的 -C target_feature 以构建假设所需的 SIMD 指令始终可用的二进制文件。如果没有充分的理由，请不要这样做。

如果使用非夜间编译器编译，curve25519-dalek 将不会包含 AVX512 代码，因此在运行时永远不会选择它。

文档

公开的 curve25519-dalek API 使用语义版本控制（SemVer）进行文档记录此处。

在本地构建文档

curve25519-dalek 文档需要自定义 HTML 标头以包含用于数学支持的 KaTeX。不幸的是，cargo doc 目前不支持此功能，但可以使用以下命令构建文档：

make doc

用于常规文档的

make doc-internal

用于包含私有项目的文档的

维护策略

此库的所有默认功能均受语义版本控制（SemVer）保护。以下概述了 MSRV 和公共 API 的 SemVer 免疫。

最低支持的 Rust 版本

从4.x版本开始，MSRV的更改将伴随次要版本号的提升。

公共API SemVer豁免

影响公共API的SemVer豁免组件的重大更改将伴随一些版本号的提升。以下是一些具体的政策

安全性

《curve25519-dalek》类型的目的是使非法状态无法表示。例如，任何EdwardsPoint实例都保证在Edwards曲线上有一个点，任何RistrettoPoint实例都保证在Ristretto群中有一个有效点。

所有操作都使用恒定时间逻辑（没有秘密相关的分支，没有秘密相关的内存访问）实现，除非特别标记为变量时间代码。我们相信我们的恒定时间逻辑降低到恒定时间汇编，至少在x86_64目标上。

为了防止可能的未来编译器优化，subtle包在每个条件移动或赋值之前放置了一个优化屏障。更多详细信息可以在《curve25519-dalek》包文档中找到。

某些功能（例如，多标量乘法或批量求逆）需要堆分配临时缓冲区。所有可能包含秘密数据的堆分配缓冲区在释放之前都明确地清零。

然而，我们没有尝试清零堆栈数据，原因有两个。首先，这样做不可能正确：我们没有控制堆分配，因此不知道要擦除多少数据。其次，因为《curve25519-dalek》提供的是中级别API，正确的开始清零堆栈数据的地方可能是《curve25519-dalek》函数的入口点，而不是其他包中函数的入口点。

实现是内存安全的，并且不包含任何显著的unsafe代码。SIMD后端使用unsafe内部调用SIMD内联函数。这些被标记为unsafe，仅因为在不适当的CPU上调用它们会导致SIGILL，但整个后端仅在运行时检测到适当的CPU功能或整个程序使用适当的target_feature编译时才会调用。

性能

基准测试使用criterion.rs运行。

cargo bench --features "rand_core"
export RUSTFLAGS='-C target_cpu=native'
cargo +nightly bench --features "rand_core"

性能是正确性、安全性和清晰度之后的次要目标，但我们的目标是与其他实现竞争。

FFI

遗憾的是，我们没有计划直接在《curve25519-dalek》中添加FFI。原因是我们使用Rust特性提供保持安全不变性的API，这些不变性不可能在FFI边界上保持。例如，如上所述的《安全性》部分中所述，无效点是不可能构造的，如果我们在FFI上公开点操作，则情况并非如此。

然而，《curve25519-dalek》被设计为中级别API，旨在实现其他更高级的原始功能。而不是在中级别提供FFI，我们的建议是在Rust中实现更高级的原语（例如签名、PAKE、ZKP等），将《curve25519-dalek》作为依赖项，并让该包提供针对该原语的特定于字节的缓冲区FFI。

贡献

请参阅《CONTRIBUTING.md。

关于

剧透警告： 第十二任博士与 Daleks 的第一次接触发生在他的第二集全剧，“进入 Dalek”。一艘“联合银河抵抗”的船发现了一台损坏的 Dalek 已经变成“善良”的，渴望杀死所有其他 Daleks。博士、克拉拉和一支士兵小队被缩小并进入 Dalek，博士将其命名为 Rusty。他们修复了损坏，但意外地将其恢复到原始状态，导致它大肆破坏并警告 Dalek 舰队叛乱船的位置。然而，博士通过将他的心灵与 Dalek 连接起来，设法将 Rusty 恢复到之前的状态：Rusty 分享了博士对宇宙之美的看法，同时也分享了他对 Daleks 的深深仇恨。Rusty 摧毁了其他 Daleks 并离开了船只，决心追踪并结束 Dalek 种族。

curve25519-dalek 由 Isis Agora Lovecruft 和 Henry de Valence 创作。

此库的部分内容最初是 Adam Langley 的 Golang ed25519 库的移植，该库反过来又是参考实现 ref10 的移植。自此以后，大部分代码，包括 32 位字段算术，都已重写。

快速 u32 和 u64 标量算术由 Andrew Moon 实现，标量逆运算的加法链由 Brian Smith 提供。优化后的批量逆运算由 Sean Bowe 和 Daira Hopwood 贡献。