sigil-governance · proposal

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum ProposalType {
    /// Change a chain parameter (60% threshold).
    ParameterChange,
    /// Upgrade a WASI module binary (75% threshold).
    WasiModuleUpgrade,
    /// Spend funds from the community treasury (67% threshold).
    TreasurySpend,
    /// Slash a validator for misbehaviour (67% threshold).
    ValidatorSlashing,
    /// Emergency governance action requiring super-majority (80% threshold).
    EmergencyAction,
}

#[must_use]
pub fn approval_threshold(&self) -> f64;

#[must_use]
pub fn veto_threshold(&self) -> f64;

#[must_use]
pub fn voting_period_epochs(&self) -> u64;

#[must_use]
pub fn timelock_epochs(&self) -> u64;

#[must_use]
pub fn min_deposit(&self) -> u64;

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub enum ProposalPayload {
    /// Change a chain parameter from one value to another.
    ParameterChange {
        parameter_path: String,
        old_value: serde_json::Value,
        new_value: serde_json::Value,
    },
    /// Upgrade a WASI module to a new binary.
    WasiModuleUpgrade {
        module_name: String,
        current_hash: String,
        new_hash: String,
        new_wasm_size: u64,
    },
    /// Transfer funds from the community treasury.
    TreasurySpend {
        recipient_did: String,
        amount: u64,
        reason: String,
    },
    /// Slash a validator for a documented offense.
    ValidatorSlashing {
        validator_did: String,
        offense_description: String,
        evidence_hashes: Vec<String>,
    },
    /// Emergency action with freeform parameters.
    EmergencyAction {
        action_type: String,
        parameters: serde_json::Value,
    },
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum ProposalStatus {
    /// Collecting the required deposit.
    Deposit,
    /// Active voting period.
    Voting,
    /// Passed vote but not yet executed (in timelock).
    Passed,
    /// Did not reach the approval threshold.
    Rejected,
    /// Successfully executed after timelock.
    Executed,
    /// Cancelled by the proposer before execution.
    Cancelled,
    /// Rejected via NoWithVeto exceeding the veto threshold.
    Vetoed,
    /// Execution was attempted but failed.
    Failed,
}

#[must_use]
pub fn is_terminal(&self) -> bool;

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Proposal {
/// Unique proposal identifier.

pub id: String,
/// DID of the account that submitted the proposal.

pub proposer_did: String,
/// Category of the proposal, determines thresholds and periods.

pub proposal_type: ProposalType,
/// Short human-readable title.

pub title: String,
/// Extended description / rationale.

pub description: String,
/// Type-specific payload data.

pub payload: ProposalPayload,
/// Current lifecycle status.

pub status: ProposalStatus,
/// Epoch at which the proposal was submitted.

pub submit_epoch: u64,
/// Epoch at which voting begins (after deposit is met).

pub voting_start_epoch: u64,
/// Epoch at which voting closes.

pub voting_end_epoch: u64,
/// Epoch at which the proposal may be executed (after timelock).

/// `None` until the proposal passes.

pub execution_epoch: Option<u64>,
/// Deposit amount in micro-MINT.

pub deposit: u64
}

#[must_use]
pub fn is_active(&self) -> bool;

#[must_use]
pub fn is_terminal(&self) -> bool;

#[must_use]
pub fn can_transition_to(&self, new_status: ProposalStatus) -> bool;