注意：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 nightly进行编译自动选择。具体条件如下所述。

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

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

文档

semver-stable、面向公众的curve25519-dalek API在此处进行了文档说明。

本地构建文档

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 crate在每个条件移动或赋值之前放置了一个优化屏障。更多详细信息可以在subtle crate的文档中找到。

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

然而，我们并没有尝试将栈数据清零，原因有两个。首先，这样做是无法正确完成的：我们没有控制栈分配，因此无法知道要擦除多少数据。其次，因为 curve25519-dalek 提供了一个中级API，因此开始清零栈数据可能不是在 curve25519-dalek 函数的入口点，而是在其他crate中函数的入口点。

实现是内存安全的，并且不包含任何显著的 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

遗憾的是，我们目前没有计划直接将FFI添加到 curve25519-dalek。原因是，我们使用Rust功能来提供一个API，该API维护安全不变性，这不可能在FFI边界上维护。例如，如上文中 安全 部分所述，无法构造无效点，如果我们在FFI上公开点操作，则情况并非如此。

然而，curve25519-dalek 被设计为一个 中级 API，旨在实现其他，更高级的原始函数。而不是在中级提供FFI，我们的建议是在Rust中实现高级原始函数（签名、PAKE、ZKP等），使用 curve25519-dalek 作为依赖项，并让该crate为该原始函数提供最小、面向字节的FFI。

贡献

请参阅 CONTRIBUTING.md。

关于

剧透警告： 第十二任博士与 Daleks 的第一次遭遇发生在他的第二集完整剧集 "Into the 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 贡献的。