Enum PercentageThreshold

pub enum PercentageThreshold {
    Majority {},
    Percent(Decimal),
}

A percentage of voting power that must vote yes for a proposal to pass. An example of why this is needed:

If a user specifies a 60% passing threshold, and there are 10 voters they likely expect that proposal to pass when there are 6 yes votes. This implies that the condition for passing should be vote_weights >= total_votes * threshold.

With this in mind, how should a user specify that they would like proposals to pass if the majority of voters choose yes? Selecting a 50% passing threshold with those rules doesn’t properly cover that case as 5 voters voting yes out of 10 would pass the proposal. Selecting 50.0001% or or some variation of that also does not work as a very small yes vote which technically makes the majority yes may not reach that threshold.

To handle these cases we provide both a majority and percent option for all percentages. If majority is selected passing will be determined by yes > total_votes * 0.5. If percent is selected passing is determined by yes >= total_votes * percent.

In both of these cases a proposal with only abstain votes must fail. This requires a special case passing logic.

Variants

Majority

The majority of voters must vote yes for the proposal to pass.

Percent(Decimal)

A percentage of voting power >= percent must vote yes for the proposal to pass.

Trait Implementations

impl Clone for PercentageThreshold

fn clone(&self) -> PercentageThreshold

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PercentageThreshold

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PercentageThreshold

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for PercentageThreshold

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for PercentageThreshold

fn eq(&self, other: &PercentageThreshold) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PercentageThreshold

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PercentageThreshold

impl StructuralPartialEq for PercentageThreshold