Struct YesNoVotePoll 

pub struct YesNoVotePoll {
    pub purpose: YesNoVotePollPurpose,
    pub supermajority_numerator: u8,
    pub supermajority_denominator: u8,
    pub minimum_voting_power: YesNoMinimumVotingPower,
}

A poll the masternodes answer with yes, no or abstain.

The poll passes when the yes voting power is strictly more than supermajority_numerator / supermajority_denominator of the yes plus no voting power, the abstaining power left out of both sides, and the yes plus no voting power is at least minimum_voting_power. Otherwise it fails. The minimum is a fixed voting power or a share of the masternode list’s total voting power when the poll closes, banned masternodes left out. The whole rule is carried by the poll so every feature sets its own. Two thirds with a floor of 400 is numerator 2, denominator 3 and an absolute minimum of 400.

Only the purpose is the poll’s identity: Self::unique_id version 0 is the double SHA-256 of the domain tag dash platform yes/no vote poll id followed by the serialized purpose. A vote names the poll by that id alone; the rule is written to the poll’s stored info when it opens and cannot change after that. The prefunded balance that pays for the votes has the same id.

Fields

purpose: YesNoVotePollPurpose

What the poll decides. The poll’s id is derived from it alone.

supermajority_numerator: u8

The numerator of the share of yes plus no voting power that yes must exceed.

supermajority_denominator: u8

The denominator of the share of yes plus no voting power that yes must exceed.

minimum_voting_power: YesNoMinimumVotingPower

The least yes plus no voting power for the poll to pass.

Implementations

impl YesNoVotePoll

pub fn validate_parameters( &self, platform_version: &PlatformVersion, ) -> Result<(), ProtocolError>

Refuses parameters no poll can be opened with, by the rules the platform version selects (dpp.voting_versions.yes_no_vote_poll_parameters).

Parameters

• platform_version: the platform version, whose system limits bound the parameters.

Returns

Ok(()) for parameters a poll can run with, or the error refusing them.

pub fn required_voting_power( &self, total_voting_power: VotingPower, platform_version: &PlatformVersion, ) -> Result<VotingPower, ProtocolError>

The least yes plus no voting power the poll needs, given the total voting power of the masternode list in the block that closes it, by the rule the platform version selects (dpp.voting_versions.yes_no_vote_poll_decision).

Parameters

• total_voting_power: the masternode list’s total voting power in the closing block.
• platform_version: the platform version.

Returns

The required voting power.

pub fn passes( &self, yes_voting_power: VotingPower, no_voting_power: VotingPower, total_voting_power: VotingPower, platform_version: &PlatformVersion, ) -> Result<bool, ProtocolError>

Whether the poll passes with these final tallies, given the total voting power of the masternode list in the block that closes it, by the rule the platform version selects (dpp.voting_versions.yes_no_vote_poll_decision). Abstaining power plays no part.

Parameters

• yes_voting_power: the yes voting power cast.
• no_voting_power: the no voting power cast.
• total_voting_power: the masternode list’s total voting power in the closing block.
• platform_version: the platform version.

Returns

Whether the poll passes.

pub fn unique_id( &self, platform_version: &PlatformVersion, ) -> Result<Identifier, ProtocolError>

The id the poll is stored and voted on under, which also keys its end date index entry and names its prefunded balance, derived as the platform version selects (dpp.voting_versions.yes_no_vote_poll_id).

Parameters

• platform_version: the platform version.

Returns

The poll’s id.

pub fn specialized_balance_id( &self, platform_version: &PlatformVersion, ) -> Result<Identifier, ProtocolError>

The prefunded balance the votes on this poll are paid from: the poll’s unique id.

Parameters

• platform_version: the platform version, which selects how the id is derived.

Returns

The balance’s id.

Trait Implementations

impl<'__de, __Context> BorrowDecode<'__de, __Context> for YesNoVotePoll

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl<'__de, __Context> BorrowDecodeUntrusted<'__de, __Context> for YesNoVotePoll

fn borrow_decode_untrusted<__D: BorrowUntrustedDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Borrow-decode with explicit untrusted field dispatch and resource handling.

impl Clone for YesNoVotePoll

fn clone(&self) -> YesNoVotePoll

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for YesNoVotePoll

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for YesNoVotePoll

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl<__Context> DecodeUntrusted<__Context> for YesNoVotePoll

fn decode_untrusted<__D: UntrustedDecoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Decode with explicit untrusted field dispatch and resource handling.

impl<'de> Deserialize<'de> for YesNoVotePoll

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for YesNoVotePoll

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

Formats the value using the given formatter.

impl Encode for YesNoVotePoll

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.

impl Eq for YesNoVotePoll

impl From<YesNoVotePoll> for VotePoll

fn from(value: YesNoVotePoll) -> Self

Converts to this type from the input type.

impl JsonConvertible for YesNoVotePoll

fn to_json(&self) -> Result<JsonValue, ProtocolError>

fn from_json(json: JsonValue) -> Result<Self, ProtocolError>

impl JsonSafeFields for YesNoVotePoll

impl PartialEq for YesNoVotePoll

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

Equality operator ==.

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

Inequality operator !=.

impl PlatformDeserializableTrusted for YesNoVotePoll

fn deserialize_from_bytes_trusted_with_bytes_len( bytes: &[u8], ) -> Result<(Self, usize), ProtocolError>

Decodes under the type’s configured byte budget, returning the value and the number of bytes it took.

fn deserialize_from_bytes_trusted_no_limit_with_bytes_len( bytes: &[u8], ) -> Result<(Self, usize), ProtocolError>

Self::deserialize_from_bytes_trusted_with_bytes_len without the byte budget.

fn deserialize_from_bytes_trusted(data: &[u8]) -> Result<Self, ProtocolError>

where Self: Sized,

Decodes under the type’s configured byte budget. Bytes left over after the value are ignored; Self::deserialize_from_bytes_trusted_exact refuses them.

fn deserialize_from_bytes_trusted_no_limit( data: &[u8], ) -> Result<Self, ProtocolError>

where Self: Sized,

fn deserialize_from_bytes_trusted_exact( data: &[u8], ) -> Result<Self, ProtocolError>

where Self: Sized,

Self::deserialize_from_bytes_trusted that also refuses bytes left over after the value.

impl PlatformDeserializableUntrusted for YesNoVotePoll

fn deserialize_from_bytes_untrusted_with_bytes_len( bytes: &[u8], ) -> Result<(Self, usize), ProtocolError>

Decodes under the type’s configured byte budget, returning the value and the number of bytes it took.

fn deserialize_from_bytes_untrusted_no_limit_with_bytes_len( bytes: &[u8], ) -> Result<(Self, usize), ProtocolError>

Self::deserialize_from_bytes_untrusted_with_bytes_len without the byte budget.

fn deserialize_from_bytes_untrusted(data: &[u8]) -> Result<Self, ProtocolError>

where Self: Sized,

Decodes under the type’s configured byte budget. Bytes left over after the value are ignored; Self::deserialize_from_bytes_untrusted_exact refuses them.

fn deserialize_from_bytes_untrusted_no_limit( data: &[u8], ) -> Result<Self, ProtocolError>

where Self: Sized,

fn deserialize_from_bytes_untrusted_exact( data: &[u8], ) -> Result<Self, ProtocolError>

where Self: Sized,

Self::deserialize_from_bytes_untrusted that also refuses bytes left over after the value.

impl PlatformSerializable for YesNoVotePoll

type Error = ProtocolError

fn serialize_to_bytes(&self) -> Result<Vec<u8>, Self::Error>

fn serialize_consume_to_bytes(self) -> Result<Vec<u8>, Self::Error>

If the trait is not used just do a simple serialize

impl PlatformVersionEncode for YesNoVotePoll

fn platform_encode<__E: Encoder>( &self, encoder: &mut __E, platform_version: &PlatformVersion, ) -> Result<(), EncodeError>

Encode a given type.

impl<'__de> PlatformVersionedBorrowDecode<'__de> for YesNoVotePoll

fn platform_versioned_borrow_decode<__D: BorrowDecoder<'__de, Context = BincodeContext>>( decoder: &mut __D, platform_version: &PlatformVersion, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl PlatformVersionedDecode for YesNoVotePoll

fn platform_versioned_decode<__D: Decoder<Context = BincodeContext>>( decoder: &mut __D, platform_version: &PlatformVersion, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl Serialize for YesNoVotePoll

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for YesNoVotePoll

impl ValueConvertible for YesNoVotePoll

fn to_object(&self) -> Result<Value, ProtocolError>

where Self: Sized,

fn into_object(self) -> Result<Value, ProtocolError>

where Self: Sized,

fn from_object(value: Value) -> Result<Self, ProtocolError>

where Self: Sized,

fn from_object_ref(value: &Value) -> Result<Self, ProtocolError>

where Self: Sized,