mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-05-01 18:17:56 +00:00
Pierre Krieger
8c03a4fcef
* Split the Roles bitfield in three * Forgot to include some changes * Fix cli test * More test fixes * Oh God, merging master broke other tests * Didn't run the doctests * Address review * I'm trying to fix the build blindly because it's taking a good hour to compile on my machine * Address some review * Also update the peerset's API to make sense * Fix peerset tests * Fix browser node * client: distinguish between local and network authority Co-authored-by: André Silva <andre.beat@gmail.com>
101 lines
3.1 KiB
Rust
101 lines
3.1 KiB
Rust
// Copyright 2019-2020 Parity Technologies (UK) Ltd.
|
|
// This file is part of Substrate.
|
|
|
|
// Substrate is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
|
|
// Substrate is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Substrate. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
//! Network event types. These are are not the part of the protocol, but rather
|
|
//! events that happen on the network like DHT get/put results received.
|
|
|
|
use bytes::Bytes;
|
|
use libp2p::core::PeerId;
|
|
use libp2p::kad::record::Key;
|
|
use sp_runtime::ConsensusEngineId;
|
|
|
|
/// Events generated by DHT as a response to get_value and put_value requests.
|
|
#[derive(Debug, Clone)]
|
|
#[must_use]
|
|
pub enum DhtEvent {
|
|
/// The value was found.
|
|
ValueFound(Vec<(Key, Vec<u8>)>),
|
|
|
|
/// The requested record has not been found in the DHT.
|
|
ValueNotFound(Key),
|
|
|
|
/// The record has been successfully inserted into the DHT.
|
|
ValuePut(Key),
|
|
|
|
/// An error has occurred while putting a record into the DHT.
|
|
ValuePutFailed(Key),
|
|
}
|
|
|
|
/// Type for events generated by networking layer.
|
|
#[derive(Debug, Clone)]
|
|
#[must_use]
|
|
pub enum Event {
|
|
/// Event generated by a DHT.
|
|
Dht(DhtEvent),
|
|
|
|
/// Opened a substream with the given node with the given notifications protocol.
|
|
///
|
|
/// The protocol is always one of the notification protocols that have been registered.
|
|
NotificationStreamOpened {
|
|
/// Node we opened the substream with.
|
|
remote: PeerId,
|
|
/// The concerned protocol. Each protocol uses a different substream.
|
|
engine_id: ConsensusEngineId,
|
|
/// Role of the remote.
|
|
role: ObservedRole,
|
|
},
|
|
|
|
/// Closed a substream with the given node. Always matches a corresponding previous
|
|
/// `NotificationStreamOpened` message.
|
|
NotificationStreamClosed {
|
|
/// Node we closed the substream with.
|
|
remote: PeerId,
|
|
/// The concerned protocol. Each protocol uses a different substream.
|
|
engine_id: ConsensusEngineId,
|
|
},
|
|
|
|
/// Received one or more messages from the given node using the given protocol.
|
|
NotificationsReceived {
|
|
/// Node we received the message from.
|
|
remote: PeerId,
|
|
/// Concerned protocol and associated message.
|
|
messages: Vec<(ConsensusEngineId, Bytes)>,
|
|
},
|
|
}
|
|
|
|
/// Role that the peer sent to us during the handshake, with the addition of what our local node
|
|
/// knows about that peer.
|
|
#[derive(Debug, Clone)]
|
|
pub enum ObservedRole {
|
|
/// Full node.
|
|
Full,
|
|
/// Light node.
|
|
Light,
|
|
/// When we are a validator node, this is a sentry that protects us.
|
|
OurSentry,
|
|
/// When we are a sentry node, this is the authority we are protecting.
|
|
OurGuardedAuthority,
|
|
/// Third-party authority.
|
|
Authority,
|
|
}
|
|
|
|
impl ObservedRole {
|
|
/// Returns `true` for `ObservedRole::Light`.
|
|
pub fn is_light(&self) -> bool {
|
|
matches!(self, ObservedRole::Light)
|
|
}
|
|
}
|