Enum zebra_chain::parameters::network::Network

pub enum Network {
    Mainnet,
    Testnet(Arc<Parameters>),
}

An enum describing the possible network choices.

Variants

Mainnet

The production mainnet.

Testnet(Arc<Parameters>)

A test network such as the default public testnet, a configured testnet, or Regtest.

Implementations

impl Network

pub fn new_default_testnet() -> Self

Creates a new Network::Testnet with the default Testnet testnet::Parameters.

pub fn new_configured_testnet(params: Parameters) -> Self

Creates a new configured Network::Testnet with the provided Testnet testnet::Parameters.

pub fn is_default_testnet(&self) -> bool

Returns true if the network is the default Testnet, or false otherwise.

pub fn kind(&self) -> NetworkKind

Returns the NetworkKind for this network.

pub fn iter() -> impl Iterator<Item = Self>

Returns an iterator over Network variants.

pub fn is_max_block_time_enforced(&self, height: Height) -> bool

Returns true if the maximum block time rule is active for network and height.

Always returns true if network is the Mainnet. If network is the Testnet, the height should be at least TESTNET_MAX_TIME_START_HEIGHT to return true. Returns false otherwise.

Part of the consensus rules at https://zips.z.cash/protocol/protocol.pdf#blockheader

pub fn default_port(&self) -> u16

Get the default port associated to this network.

pub fn mandatory_checkpoint_height(&self) -> Height

Get the mandatory minimum checkpoint height for this network.

Mandatory checkpoints are a Zebra-specific feature. If a Zcash consensus rule only applies before the mandatory checkpoint, Zebra can skip validation of that rule.

pub fn bip70_network_name(&self) -> String

Return the network name as defined in BIP70

pub fn lowercase_name(&self) -> String

Return the lowercase network name.

pub fn is_a_test_network(&self) -> bool

Returns true if this network is a testing network.

pub fn sapling_activation_height(&self) -> Height

Returns the Sapling activation height for this network.

impl Network

pub fn activation_list(&self) -> BTreeMap<Height, NetworkUpgrade>

Returns a map between activation heights and network upgrades for network, in ascending height order.

If the activation height of a future upgrade is not known, that network upgrade does not appear in the list.

This is actually a bijective map.

When the environment variable TEST_FAKE_ACTIVATION_HEIGHTS is set and it’s a test build, this returns a list of fake activation heights used by some tests.

impl Network

pub fn sapling_efvk_hrp(&self) -> &'static str

Returns the human-readable prefix for an Zcash Sapling extended full viewing key for this network.

impl Network

Network methods for fetching blockchain vectors.

pub fn is_mainnet(&self) -> bool

Returns true if network is of type Mainnet.

pub fn block_iter(&self) -> Iter<'static, u32, &'static [u8]>

Returns iterator over blocks.

pub fn block_map(&self) -> BTreeMap<u32, &'static [u8]>

Returns blocks indexed by height in a BTreeMap.

Returns Mainnet blocks if self is set to Mainnet, and Testnet blocks otherwise.

pub fn gen_block(&self) -> Option<&&[u8]>

Returns genesis block for chain.

pub fn test_block(&self, main_height: u32, test_height: u32) -> Option<Block>

Returns block bytes

pub fn blockchain_iter(&self) -> Iter<'_, u32, &[u8]>

Returns iterator over blockchain.

pub fn blockchain_map(&self) -> &BTreeMap<u32, &'static [u8]>

Returns BTreemap of blockchain.

pub fn block_sapling_roots_iter( &self ) -> (Iter<'_, u32, &[u8]>, BTreeMap<u32, &[u8; 32]>)

Returns iterator over blocks and sapling roots.

pub fn block_sapling_roots_map( &self ) -> (&BTreeMap<u32, &'static [u8]>, &BTreeMap<u32, &'static [u8; 32]>)

Returns BTreemap of blocks and sapling roots.

pub fn test_block_sapling_roots( &self, main_height: u32, test_height: u32 ) -> Option<(&[u8], [u8; 32])>

Returns block and sapling root bytes

pub fn block_sprout_roots_height( &self ) -> (&BTreeMap<u32, &'static [u8]>, &BTreeMap<u32, &'static [u8; 32]>, u32)

Returns BTreemap of blocks and sprout roots, and last split height.

Trait Implementations

impl Arbitrary for Network

type Parameters = ()

The type of parameters that arbitrary_with accepts for configuration of the generated Strategy. Parameters must implement Default.

fn arbitrary_with(_args: ()) -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

type Strategy = BoxedStrategy<Network>

The type of Strategy used to generate values of type Self.

fn arbitrary() -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self).

impl Clone for Network

fn clone(&self) -> Network

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Network

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Network

fn default() -> Network

Returns the “default value” for a type.

impl Display for Network

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&Network> for &'static str

fn from(network: &Network) -> &'static str

Converts to this type from the input type.

impl From<Network> for NetworkKind

fn from(network: Network) -> Self

Converts to this type from the input type.

impl FromStr for Network

type Err = InvalidNetworkError

The associated error which can be returned from parsing.

fn from_str(string: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Network

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl ParameterDifficulty for Network

fn target_difficulty_limit(&self) -> ExpandedDifficulty

Returns the easiest target difficulty allowed on network. See ParameterDifficulty::target_difficulty_limit

impl Parameters for Network

fn activation_height(&self, nu: NetworkUpgrade) -> Option<BlockHeight>

Returns the activation height for a particular network upgrade, if an activation height has been set.

fn coin_type(&self) -> u32

The coin type for ZEC, as defined by SLIP 44.

fn address_network(&self) -> Option<Network>

Returns the standard network constant for address encoding. Returns ‘None’ for nonstandard networks.

fn hrp_sapling_extended_spending_key(&self) -> &str

Returns the human-readable prefix for Bech32-encoded Sapling extended spending keys the network to which this Parameters value applies.

fn hrp_sapling_extended_full_viewing_key(&self) -> &str

Returns the human-readable prefix for Bech32-encoded Sapling extended full viewing keys for the network to which this Parameters value applies.

fn hrp_sapling_payment_address(&self) -> &str

Returns the Bech32-encoded human-readable prefix for Sapling payment addresses viewing keys for the network to which this Parameters value applies.

fn b58_pubkey_address_prefix(&self) -> [u8; 2]

Returns the human-readable prefix for Base58Check-encoded transparent pay-to-public-key-hash payment addresses for the network to which this Parameters value applies.

fn b58_script_address_prefix(&self) -> [u8; 2]

Returns the human-readable prefix for Base58Check-encoded transparent pay-to-script-hash payment addresses for the network to which this Parameters value applies.

fn is_nu_active(&self, nu: NetworkUpgrade, height: BlockHeight) -> bool

Determines whether the specified network upgrade is active as of the provided block height on the network to which this Parameters value applies.

impl PartialEq for Network

fn eq(&self, other: &Network) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Network

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Network

impl StructuralPartialEq for Network