wownero 0.1.0

Rust Wownero Library.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

// Rust Wownero Library
// Written in 2019-2022 by
//    Monero Rust Contributors
// Adapted to Wownero in 2022 by
//    Boog900
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//

//! Wownero networks definition and related error types.
//!
//! This module defines the existing Wownero networks and their associated magic bytes.
//!

use crate::util::address::AddressType;
use thiserror::Error;

/// Potential errors encountered while manipulating Wownero networks.
#[derive(Error, Debug, PartialEq, Eq)]
pub enum Error {
    /// Invalid magic network byte.
    #[error("Invalid magic network byte")]
    InvalidMagicByte,
}

/// Wownero has a different amount of bytes depending if
/// you are using Mainnet(2) or not(1)  :) :) :)
///
pub enum NetworkByte {
    /// Mainnet uses 2 bytes for net byte
    Mainnet(u8, u8),
    /// Stagenet && Testnet use 1 byte
    NotMainnet(u8),
}

impl NetworkByte {
    /// Turns the network byte(s) into a Vec
    pub fn as_vec(self) -> Vec<u8> {
        match self {
            NetworkByte::Mainnet(x, y) => vec![x, y],
            NetworkByte::NotMainnet(x) => vec![x],
        }
    }
    /// Returns the amount of Netbytes for each net
    pub fn number_of_bytes(network: Network) -> usize {
        match network {
            Network::Mainnet => 2,
            Network::Stagenet | Network::Testnet => 1,
        }
    }
}
/// The list of the existing Wownero networks.
///
/// Network implements [`Default`] and returns [`Network::Mainnet`].
///
#[derive(Debug, PartialEq, Eq, Hash, Clone, Copy)]
pub enum Network {
    /// Mainnet is the "production" network and blockchain.
    Mainnet,
    /// Stagenet is technically equivalent to mainnet, both in terms of features and consensus
    /// rules.
    Stagenet,
    /// Testnet is the "experimental" network and blockchain where things get released long before
    /// mainnet.
    Testnet,
}

impl Network {
    /// Get the associated magic byte given an address type.
    pub fn as_u8(self, addr_type: &AddressType) -> NetworkByte {
        use AddressType::*;
        use Network::*;
        match self {
            Mainnet => match addr_type {
                Standard => NetworkByte::Mainnet(178, 32),
                Integrated(_) => NetworkByte::Mainnet(154, 53),
                SubAddress => NetworkByte::Mainnet(176, 95),
            },
            Testnet => match addr_type {
                Standard => NetworkByte::NotMainnet(53),
                Integrated(_) => NetworkByte::NotMainnet(54),
                SubAddress => NetworkByte::NotMainnet(63),
            },
            Stagenet => match addr_type {
                Standard => NetworkByte::NotMainnet(24),
                Integrated(_) => NetworkByte::NotMainnet(25),
                SubAddress => NetworkByte::NotMainnet(36),
            },
        }
    }

    /// Recover the network type given an address magic byte.
    pub fn from_u8(byte: u8) -> Result<Network, Error> {
        use Network::*;
        match byte {
            178 | 154 | 176 => Ok(Mainnet),
            53 | 54 | 63 => Ok(Testnet),
            24 | 25 | 36 => Ok(Stagenet),
            _ => Err(Error::InvalidMagicByte),
        }
    }
}

impl Default for Network {
    fn default() -> Network {
        Network::Mainnet
    }
}