//! List of directories that ships with Tor, for initial directory

//! operations.

//!

//! When a client doesn't have directory information yet, it uses a

//! "Fallback Directory" to retrieve its initial information about the

//! network.

//!

//! # Semver note

//!

//! The types in this module are re-exported from `arti-client` and

//! `tor-dirmgr`: any changes here must be reflected there.

use derive_builder::Builder;

use tor_config::ConfigBuildError;

use tor_llcrypto::pk::ed25519::Ed25519Identity;

use tor_llcrypto::pk::rsa::RsaIdentity;

use serde::Deserialize;

use std::net::SocketAddr;

/// A directory whose location ships with Tor (or arti), and which we

/// can use for bootstrapping when we don't know anything else about

/// the network.

//

// Note that we do *not* set serde(deny_unknown_fields) on this

// structure: we want our fallback directory configuration format to

// be future-proof against adding new info about each fallback.

#[builder(build_fn(validate = "FallbackDirBuilder::validate", error = "ConfigBuildError"))]

pub struct FallbackDir {

    /// RSA identity for the directory relay

    rsa_identity: RsaIdentity,

    /// Ed25519 identity for the directory relay

    ed_identity: Ed25519Identity,

    /// List of ORPorts for the directory relay

    orports: Vec<SocketAddr>,

}

impl FallbackDir {

    /// Return a builder that can be used to make a `FallbackDir`.

}

impl FallbackDirBuilder {

    /// Make a new FallbackDirBuilder.

    ///

    /// You only need to use this if you're using a non-default set of

    /// fallback directories.

    /// Add a single OR port for this fallback directory.

    ///

    /// This field is required, and may be called more than once.

    /// Check whether this builder is ready to make a FallbackDir.

    fn validate(&self) -> std::result::Result<(), ConfigBuildError> {

}

impl tor_linkspec::ChanTarget for FallbackDir {

}