sigil-tower · tower_committee

pub const COMMITTEE_QUORUM: usize;

pub const COMMITTEE_SIZE: usize;

pub const DEFAULT_TERM_EPOCHS: u64;

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct TowerCommittee {
/// DIDs of the 11 committee members.

pub members: Vec<String>,
/// Epoch at which this committee's term began.

pub term_start_epoch: u64,
/// Length of the committee's term in epochs.

pub term_length_epochs: u64
}

pub fn is_member(&self, did: &str) -> bool;

pub fn is_term_expired(&self, current_epoch: u64) -> bool;

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct PendingDecision {
/// What kind of decision this is.

pub decision_type: DecisionType,
/// Votes from committee members (DID -> approve/reject).

pub votes: HashMap<String, bool>
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub enum DecisionType {
    /// Confirm slashing of a validator (DID of the validator to slash).
    SlashValidator(String),
    /// Change a protocol parameter (parameter name, new value).
    ParameterChange(String, String),
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub enum DecisionResult {
    /// The decision was approved.
    Approved(DecisionType),
    /// The decision was rejected.
    Rejected(DecisionType),
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TowerCommitteeState {
/// The current Tower Committee.

pub current_committee: TowerCommittee,
/// Pending decisions awaiting votes.

pub pending_decisions: Vec<PendingDecision>
}

pub fn new(committee: TowerCommittee) -> Self;

pub fn propose(&mut self, decision_type: DecisionType) -> usize;

pub fn vote(
        &mut self,
        decision_id: usize,
        voter_did: &str,
        approve: bool,
    ) -> Result<Option<DecisionResult>, TowerError>;

pub fn is_approved(&self, decision_id: usize) -> bool;

pub fn pending_count(&self) -> usize;