magic-domain-program 0.3.0

Domain registration program for Ephemeral Rollups
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

use std::borrow::Cow;

use super::{features::FeaturesSet, status::ErStatus, version::v0::RecordV0};
use borsh::{BorshDeserialize, BorshSerialize};
use solana_program::pubkey::Pubkey;

use crate::{consts::ER_RECORD_SEED, ID};

#[derive(Debug, BorshSerialize, BorshDeserialize)]
#[cfg_attr(not(feature = "entrypoint"), derive(PartialEq, Eq, Clone))]
pub enum ErRecord {
    V0(RecordV0),
}

impl ErRecord {
    /// Computes record's PDA for the given ER node
    pub fn pda(&self) -> (Pubkey, u8) {
        Pubkey::find_program_address(&self.seeds(), &ID)
    }

    /// Returns an array of seeds for the record's PDA derivation
    pub fn seeds(&self) -> [&[u8]; 2] {
        [ER_RECORD_SEED, self.identity().as_ref()]
    }

    /// Returns identity pubkey of the given ER
    pub fn identity(&self) -> &Pubkey {
        match self {
            Self::V0(r) => &r.identity,
        }
    }

    /// Returns FQDN address for the given ER node
    pub fn addr(&self) -> &str {
        match self {
            Self::V0(v) => &v.addr,
        }
    }

    /// Returns transaction fees of given ER node
    pub fn base_fee(&self) -> u16 {
        match self {
            Self::V0(v) => v.base_fee,
        }
    }

    /// Returns supported set of features by the given ER node
    pub fn features(&self) -> &FeaturesSet {
        match self {
            Self::V0(v) => &v.features,
        }
    }

    /// Returns the block time in ms of the given ER node
    pub fn block_time_ms(&self) -> u16 {
        match self {
            Self::V0(v) => v.block_time_ms,
        }
    }

    /// Returns current status of the given ER node
    pub fn status(&self) -> ErStatus {
        match self {
            Self::V0(v) => v.status,
        }
    }

    /// Returns load average of the given ER node
    pub fn load_average(&self) -> u32 {
        match self {
            Self::V0(v) => v.load_average,
        }
    }

    /// Returns 3 digit country code of the given ER node
    pub fn country_code(&self) -> CountryCode {
        match self {
            Self::V0(v) => v.country_code,
        }
    }

    /// Updates the FQDN address in the given ER record
    pub fn set_addr(&mut self, addr: String) {
        match self {
            Self::V0(v) => v.addr = addr,
        }
    }

    /// Updates base transaction fee in the given ER record
    pub fn set_base_fee(&mut self, base_fee: u16) {
        match self {
            Self::V0(v) => v.base_fee = base_fee,
        }
    }

    /// Updates the features set in the given ER record
    pub fn set_features(&mut self, features: FeaturesSet) {
        match self {
            Self::V0(v) => v.features = features,
        }
    }

    /// Updates block time in ms in the given ER record
    pub fn set_block_time_ms(&mut self, block_time_ms: u16) {
        match self {
            Self::V0(v) => v.block_time_ms = block_time_ms,
        }
    }

    /// Updates node status for the given ER record
    pub fn set_status(&mut self, status: ErStatus) {
        match self {
            Self::V0(v) => v.status = status,
        }
    }

    /// Updates the load average for the given ER record
    pub fn set_load_average(&mut self, load_average: u32) {
        match self {
            Self::V0(v) => v.load_average = load_average,
        }
    }

    /// Updates the country code for the given ER record
    pub fn set_country_code(&mut self, country_code: CountryCode) {
        match self {
            Self::V0(v) => v.country_code = country_code,
        }
    }
}

#[derive(BorshDeserialize, BorshSerialize, Debug, Clone, Copy, PartialEq, Eq)]
pub struct CountryCode([u8; 3]);

impl<S: AsRef<[u8]>> From<S> for CountryCode {
    fn from(value: S) -> Self {
        const LEN: usize = std::mem::size_of::<CountryCode>();
        let mut buf = [0u8; LEN];
        buf.copy_from_slice(&value.as_ref()[..LEN]);
        Self(buf)
    }
}

impl CountryCode {
    pub fn as_str(&self) -> Cow<'_, str> {
        String::from_utf8_lossy(&self.0)
    }
}