tor-linkspec

描述Tor中继，用于连接到它们的。

概述

tor-linkspec crate提供特质和数据结构，描述如何连接到Tor中继。

当描述网络中Tor中继的位置时，Tor协议使用一组“链路指定符”，每个指定符都对应中继位置或标识的一个方面——例如其IP地址和端口号、其Ed25519身份密钥、其（旧版）RSA身份指纹等。此crate的LinkSpec类型编码这些结构。

当客户端通过Tor网络构建电路时，它需要了解该电路中中继的某些信息。此crate的ChanTarget和CircTarget特质代表对象，描述客户端可以使用的网络中的中继，作为电路的第一跳或任何跳。

此crate是Arti项目的一部分，该项目旨在用Rust实现Tor。Arti中的其他几个crate依赖于它。除非您正在以相当低级别与Tor协议交互，否则您可能不需要此crate。

tor-linkspec是一个独立的crate，以便它可以被其他公开链路指定符的crate使用，以及消费它们的crate。

未来工作

TODO：可能我们应该重命名此crate。在Tor协议中，“链路指定符”是一个相当晦涩的术语。

TODO: 可能链接指定符和 *目标 特性应该属于不同的crate。

编译时特性

• pt-client -- 使用增强的数据类型来支持可插拔的传输。

• full -- 使用上述所有特性进行构建。

实验性和不稳定特性

请注意，由这些特性启用的API不受语义版本控制保证：我们可能在补丁版本之间破坏或删除它们。

• experimental -- 使用上述所有实验特性进行构建。（目前，这个crate中没有实验特性，但将来可能会有。）

[^1]：记住，语义版本控制是使各种 cargo 特性可靠工作的原因。明确来说：如果你希望 cargo update 仅进行安全更改，那么你不能启用这些特性。

许可协议：MIT 或 Apache-2.0