// Copyright (C) Parity Technologies (UK) Ltd. and Dijital Kurdistan Tech Institute // This file is part of Pezcumulus. // SPDX-License-Identifier: GPL-3.0-or-later WITH Classpath-exception-2.0 // Pezcumulus 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. // Pezcumulus 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 Pezcumulus. If not, see . use pezkuwi_core_primitives::{Block, Hash, Header}; use pezsp_runtime::traits::NumberFor; use pezsc_network::{ config::{ NetworkConfiguration, NonReservedPeerMode, NotificationHandshake, PeerStore, ProtocolId, SetConfig, }, peer_store::PeerStoreProvider, service::traits::NetworkService, NotificationMetrics, }; use pezsc_network::{config::FullNetworkConfiguration, NetworkBackend, NotificationService}; use pezsc_network_common::{role::Roles, sync::message::BlockAnnouncesHandshake}; use pezsc_service::{error::Error, Configuration, SpawnTaskHandle}; use std::{iter, sync::Arc}; /// Build the network service, the network status sinks and an RPC sender. pub(crate) fn build_collator_network>( config: &Configuration, mut network_config: FullNetworkConfiguration, spawn_handle: SpawnTaskHandle, genesis_hash: Hash, best_header: Header, notification_metrics: NotificationMetrics, ) -> Result<(Arc, Arc), Error> { let protocol_id = config.protocol_id(); let (block_announce_config, notification_service) = get_block_announce_proto_config::( protocol_id.clone(), &None, Roles::from(&config.role), best_header.number, best_header.hash(), genesis_hash, notification_metrics.clone(), network_config.peer_store_handle(), ); // Since this node has no syncing, we do not want light-clients to connect to it. // Here we set any potential light-client slots to 0. adjust_network_config_light_in_peers(&mut network_config.network_config); let peer_store = network_config.take_peer_store(); spawn_handle.spawn("peer-store", Some("networking"), peer_store.run()); let network_params = pezsc_network::config::Params:: { role: config.role, executor: { let spawn_handle = Clone::clone(&spawn_handle); Box::new(move |fut| { spawn_handle.spawn("libp2p-node", Some("networking"), fut); }) }, fork_id: None, network_config, genesis_hash, protocol_id, metrics_registry: config.prometheus_config.as_ref().map(|config| config.registry.clone()), block_announce_config, bitswap_config: None, notification_metrics, }; let network_worker = Network::new(network_params)?; let network_service = network_worker.network_service(); // The network worker is responsible for gathering all network messages and processing // them. This is quite a heavy task, and at the time of the writing of this comment it // frequently happens that this future takes several seconds or in some situations // even more than a minute until it has processed its entire queue. This is clearly an // issue, and ideally we would like to fix the network future to take as little time as // possible, but we also take the extra harm-prevention measure to execute the networking // future using `spawn_blocking`. spawn_handle.spawn_blocking("network-worker", Some("networking"), async move { // The notification service must be kept alive to allow litep2p to handle // requests under the hood. It has been noted that without the notification // service of the `/block-announces/1` protocol, collators are not advertised // and their produced blocks do not propagate: // https://github.com/pezkuwichain/pezkuwi-sdk/issues/154 // // This is because the full nodes on the relay chain will attempt to establish // a connection to the minimal relay chain. By dropping the notification service, // litep2p would terminate the background task which handles the `/block-announces/1` // notification protocol. The downstream effect of this is that the full node // would ban and disconnect the the minimal relay chain node. let _notification_service = notification_service; network_worker.run().await; }); Ok((network_service, Arc::new(SyncOracle {}))) } fn adjust_network_config_light_in_peers(config: &mut NetworkConfiguration) { let light_client_in_peers = (config.default_peers_set.in_peers + config.default_peers_set.out_peers) .saturating_sub(config.default_peers_set_num_full); if light_client_in_peers > 0 { tracing::debug!(target: crate::LOG_TARGET, "Detected {light_client_in_peers} peer slots for light clients. Since this minimal node does support\ neither syncing nor light-client request/response, we are setting them to 0."); } config.default_peers_set.in_peers = config.default_peers_set.in_peers.saturating_sub(light_client_in_peers); } struct SyncOracle; impl pezsp_consensus::SyncOracle for SyncOracle { fn is_major_syncing(&self) -> bool { false } fn is_offline(&self) -> bool { true } } fn get_block_announce_proto_config>( protocol_id: ProtocolId, fork_id: &Option, roles: Roles, best_number: NumberFor, best_hash: Hash, genesis_hash: Hash, metrics: NotificationMetrics, peer_store_handle: Arc, ) -> (Network::NotificationProtocolConfig, Box) { let block_announces_protocol = { let genesis_hash = genesis_hash.as_ref(); if let Some(ref fork_id) = fork_id { format!("/{}/{}/block-announces/1", array_bytes::bytes2hex("", genesis_hash), fork_id) } else { format!("/{}/block-announces/1", array_bytes::bytes2hex("", genesis_hash)) } }; Network::notification_config( block_announces_protocol.into(), iter::once(format!("/{}/block-announces/1", protocol_id.as_ref()).into()).collect(), 1024 * 1024, Some(NotificationHandshake::new(BlockAnnouncesHandshake::::build( roles, best_number, best_hash, genesis_hash, ))), // NOTE: `set_config` will be ignored by `protocol.rs` as the block announcement // protocol is still hardcoded into the peerset. SetConfig { in_peers: 0, out_peers: 0, reserved_nodes: Vec::new(), non_reserved_mode: NonReservedPeerMode::Deny, }, metrics, peer_store_handle, ) }