Enum Network

pub enum Network {
    Main,
    Test,
    Regtest,
}

Represents a Zcash network environment (mainnet, testnet, or regtest).

The Network enum identifies which Zcash network a wallet, address, or transaction belongs to. Each network has different consensus rules, address encodings, and initial blockchain parameters.

Zcash Concept Relation

Zcash, like Bitcoin, operates on multiple networks:

• Mainnet: The primary Zcash network where real ZEC with monetary value is transferred
• Testnet: A testing network that simulates mainnet but uses worthless test coins
• Regtest: A private “regression test” network for local development and testing

These networks are isolated from each other, with different genesis blocks, address formats, and consensus parameters.

Data Preservation

The Network value is critical during wallet migration to ensure addresses and transactions are reconstructed for the correct network. Address formats differ between networks, and migrating a wallet to an incorrect network would render it unusable.

Examples

In the ZeWIF format, the Network value is stored at the wallet level:

// Wallet on the main Zcash network
let network = Network::Main;

// Wallets on mainnet and testnet have incompatible address formats
match network {
    Network::Main => println!("This wallet stores real ZEC"),
    Network::Test => println!("This wallet stores test coins only"),
    Network::Regtest => println!("This wallet is for local testing"),
}

Variants

Main

Test

Regtest

Trait Implementations

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 From<Network> for CBOR

fn from(value: Network) -> Self

Converts to this type from the input type.

impl From<Network> for Envelope

fn from(value: Network) -> Self

Converts to this type from the input type.

impl From<Network> for String

fn from(value: Network) -> String

Converts to this type from the input 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 PartialEq for Network

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl TryFrom<CBOR> for Network

type Error = Error

The type returned in the event of a conversion error.

fn try_from(cbor: CBOR) -> Result<Self>

Performs the conversion.

impl TryFrom<Envelope> for Network

type Error = Error

The type returned in the event of a conversion error.

fn try_from(envelope: Envelope) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for Network

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Network

impl Eq for Network

impl StructuralPartialEq for Network