85 lines
2.6 KiB
Rust
85 lines
2.6 KiB
Rust
|
// Copyright 2015, 2016 Parity Technologies (UK) Ltd.
|
||
|
|
// This file is part of Parity.
|
||
|
|
|
||
|
|
// Parity 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.
|
||
|
|
|
||
|
|
// Parity 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 Parity. If not, see <http://www.gnu.org/licenses/>.
|
||
|
|
|
||
|
|
use util::{H256};
|
||
|
|
use util::misc::{VersionInfo};
|
||
|
|
|
||
|
|
/// Information regarding a particular release of Parity
|
||
|
|
#[derive(Debug, Clone, PartialEq)]
|
||
|
|
pub struct ReleaseInfo {
|
||
|
|
/// Information on the version.
|
||
|
|
pub version: VersionInfo,
|
||
|
|
/// Does this release contain critical security updates?
|
||
|
|
pub is_critical: bool,
|
||
|
|
/// The latest fork that this release can handle.
|
||
|
|
pub fork: u64,
|
||
|
|
/// Our platform's binary, if known.
|
||
|
|
pub binary: Option<H256>,
|
||
|
|
}
|
||
|
|
|
||
|
|
/// Information on our operations environment.
|
||
|
|
#[derive(Debug, Clone, PartialEq)]
|
||
|
|
pub struct OperationsInfo {
|
||
|
|
/// Our blockchain's latest fork.
|
||
|
|
pub fork: u64,
|
||
|
|
|
||
|
|
/// Last fork our client supports, if known.
|
||
|
|
pub this_fork: Option<u64>,
|
||
|
|
|
||
|
|
/// Information on our track's latest release.
|
||
|
|
pub track: ReleaseInfo,
|
||
|
|
/// Information on our minor version's latest release.
|
||
|
|
pub minor: Option<ReleaseInfo>,
|
||
|
|
}
|
||
|
|
|
||
|
|
/// Information on the current version's consensus capabililty.
|
||
|
|
#[derive(Debug, Clone, Copy, PartialEq)]
|
||
|
|
pub enum CapState {
|
||
|
|
/// Unknown.
|
||
|
|
Unknown,
|
||
|
|
/// Capable of consensus indefinitely.
|
||
|
|
Capable,
|
||
|
|
/// Capable of consensus up until a definite block.
|
||
|
|
CapableUntil(u64),
|
||
|
|
/// Incapable of consensus since a particular block.
|
||
|
|
IncapableSince(u64),
|
||
|
|
}
|
||
|
|
|
||
|
|
impl Default for CapState {
|
||
|
|
fn default() -> Self { CapState::Unknown }
|
||
|
|
}
|
||
|
|
|
||
|
|
pub trait Service: Send + Sync {
|
||
|
|
/// Is the currently running client capable of supporting the current chain?
|
||
|
|
/// We default to true if there's no clear information.
|
||
|
|
fn capability(&self) -> CapState;
|
||
|
|
|
||
|
|
/// The release which is ready to be upgraded to, if any. If this returns `Some`, then
|
||
|
|
/// `execute_upgrade` may be called.
|
||
|
|
fn upgrade_ready(&self) -> Option<ReleaseInfo>;
|
||
|
|
|
||
|
|
/// Actually upgrades the client. Assumes that the binary has been downloaded.
|
||
|
|
/// @returns `true` on success.
|
||
|
|
fn execute_upgrade(&self) -> bool;
|
||
|
|
|
||
|
|
/// Our version info.
|
||
|
|
fn version_info(&self) -> VersionInfo;
|
||
|
|
|
||
|
|
/// Information gathered concerning the release.
|
||
|
|
fn info(&self) -> Option<OperationsInfo>;
|
||
|
|
}
|
||
|
|
|