#i2p #tor #cyphernet #nym #privacy #p2p #cryptography


Network address types supporting proxying, mixnets, P2P with minimalistic dependencies (part of cyphernet suite)

3 releases (breaking)

0.3.0 Sep 5, 2023
0.2.0 Feb 15, 2023
0.1.0 Jan 16, 2023

#1226 in Network programming

Download history 68/week @ 2023-12-18 25/week @ 2023-12-25 20/week @ 2024-01-01 112/week @ 2024-01-08 33/week @ 2024-01-15 55/week @ 2024-01-22 32/week @ 2024-01-29 26/week @ 2024-02-05 114/week @ 2024-02-12 83/week @ 2024-02-19 54/week @ 2024-02-26 131/week @ 2024-03-04 110/week @ 2024-03-11 167/week @ 2024-03-18 156/week @ 2024-03-25 173/week @ 2024-04-01

621 downloads per month
Used in 13 crates (2 directly)


919 lines

Cypheraddr: network addresses supporting SOCKS5, Tor, I2P, Nym and P2P pubkeys

Build Tests Lints codecov

crates.io Docs Apache-2 licensed

Rust library providing a set of address data types with minimal dependencies which allow simple use of.

  • Tor, Nym, I2P and other mix networks and SOCKS proxies;
  • P2P addresses with node public keys.

The crate may be used in a way that prevents using DNS names (outside mixnet scope).

The library is a part of rust cyphernet suite.


Name: cypheraddr
Type: Library
Kind: Free software
License: Apache-2.0
Language: Rust
Compiler: 1.65
Author: Maxim Orlovsky
Maintained: Cyphernet DAO, Switzerland
  Maxim Orlovsky:
    GitHub: @dr-orlovsky
    GPG: EAE730CEC0C663763F028A5860094BAF18A26EC9
    SSH: BoSGFzbyOKC7Jm28MJElFboGepihCpHop60nS8OoG/A
    EMail: dr@orlovsky.ch
  Alexis Sellier:
    GitHub: @cloudhead
    SSH: iTDjRHSIaoL8dpHbQ0mv+y0IQqPufGl2hQwk4TbXFlw


Network addresses provided by the library include the following types:

  • InetHost - IP addr or DNS name
  • HostName - IP, DNS, Tor, I2P, Nym host name (no port or proxy information)
  • NetAddr - any type of host name + port information
  • PartialAddr - any type of host name + optional port, which defaults to generic const if not provided
  • PeerAddr - any of the above addresses + node public key for authentication
  • ProxiedHost - host name + proxy (there are IP/DNS w/o proxy and with proxy)
  • ProxiedAddr - any of the above addresses + proxy (thus IP/DNS is always proxied)

The library tries to minimize number of dependencies. Most of its functionality is available via non-default features, like:

  • mixnets: supports for mixnet network addresses, including tor, nym, i2p (may require additional crypto libraries for parsing public keys);
  • serde: encoding for addresses types;
  • dns: enable use of DNS names alongside IP addresses and mixnet names.


API reference documentation for the library can be accessed at https://docs.rs/cypheraddr/.


The libraries are distributed on the terms of Apache 2.0 opensource license. See LICENCE file for the license details.


~26K SLoC