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
// Copyright 2022 MaidSafe.net limited.
//
// This SAFE Network Software is licensed to you under The General Public License (GPL), version 3.
// Unless required by applicable law or agreed to in writing, the SAFE Network Software distributed
// under the GPL Licence is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. Please review the Licences for the specific language governing
// permissions and limitations relating to use of the SAFE Network Software.
use bls::PublicKey as BlsPublicKey;
use serde::{Deserialize, Serialize};
use std::net::SocketAddr;
use xor_name::{XorName, XOR_NAME_LEN};
/// Information about a member of our section.
#[derive(Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize, Debug)]
pub struct NodeState {
/// Peer's name.
pub name: XorName,
/// Peer's address.
pub addr: SocketAddr,
/// Current state of the peer
pub state: MembershipState,
/// To avoid sybil attack via relocation, a relocated node's original name will be recorded.
pub previous_name: Option<XorName>,
}
impl NodeState {
/// Returns the age.
pub fn age(&self) -> u8 {
self.name[XOR_NAME_LEN - 1]
}
}
#[derive(Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize, Debug)]
/// Node's current section membership state
pub enum MembershipState {
/// Node is active member of the section.
Joined,
/// Node went offline.
Left,
/// Node was relocated to a different section.
Relocated(Box<RelocateDetails>),
}
/// Details of a node that has been relocated
#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord, Hash, Clone)]
pub struct RelocateDetails {
/// Name of the node to relocate (this is the node's name before relocation).
pub previous_name: XorName,
/// Relocation destination, the node will be relocated to
/// a section whose prefix matches this name.
pub dst: XorName,
/// The BLS key of the destination section used by the relocated node to verify messages.
pub dst_section_key: BlsPublicKey,
/// The age the node will have post-relocation.
pub age: u8,
}
