sc_network_common/
sync.rs

1// This file is part of Substrate.
2
3// Copyright (C) Parity Technologies (UK) Ltd.
4// SPDX-License-Identifier: GPL-3.0-or-later WITH Classpath-exception-2.0
5
6// This program is free software: you can redistribute it and/or modify
7// it under the terms of the GNU General Public License as published by
8// the Free Software Foundation, either version 3 of the License, or
9// (at your option) any later version.
10
11// This program is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14// GNU General Public License for more details.
15
16// You should have received a copy of the GNU General Public License
17// along with this program. If not, see <https://www.gnu.org/licenses/>.
18
19//! Abstract interfaces and data structures related to network sync.
20
21pub mod message;
22
23/// Sync operation mode.
24#[derive(Copy, Clone, Debug, Eq, PartialEq)]
25pub enum SyncMode {
26	/// Full block download and verification.
27	Full,
28	/// Download blocks and the latest state.
29	LightState {
30		/// Skip state proof download and verification.
31		skip_proofs: bool,
32		/// Download indexed transactions for recent blocks.
33		storage_chain_mode: bool,
34	},
35	/// Warp sync - verify authority set transitions and the latest state.
36	Warp,
37}
38
39impl SyncMode {
40	/// Returns `true` if `self` is [`Self::Warp`].
41	pub fn is_warp(&self) -> bool {
42		matches!(self, Self::Warp)
43	}
44
45	/// Returns `true` if `self` is [`Self::LightState`].
46	pub fn light_state(&self) -> bool {
47		matches!(self, Self::LightState { .. })
48	}
49}
50
51impl Default for SyncMode {
52	fn default() -> Self {
53		Self::Full
54	}
55}