Enum Denunciation 

pub enum Denunciation {
    Endorsement(EndorsementDenunciation),
    BlockHeader(BlockHeaderDenunciation),
}

A denunciation enum

Variants

Endorsement(EndorsementDenunciation)

BlockHeader(BlockHeaderDenunciation)

Implementations

impl Denunciation

pub fn is_for_endorsement(&self) -> bool

Check if it is a Denunciation of several endorsements

pub fn is_for_block_header(&self) -> bool

Check if it is a Denunciation of several block headers

pub fn is_also_for_endorsement( &self, s_endorsement: &SecureShareEndorsement, sig_chain_id: Option<u64>, ) -> Result<bool, DenunciationError>

Check if it is a Denunciation for this endorsement

sig_chain_id selects the signed-hash layout used to reconstruct the signature hash (see EndorsementDenunciation::compute_hash_for_sig_verif).

pub fn is_also_for_block_header( &self, s_block_header: &SecuredHeader, sig_chain_id: Option<u64>, ) -> Result<bool, DenunciationError>

Check if it is a Denunciation for this block header

sig_chain_id selects the signed-hash layout used to reconstruct the signature hash (see BlockHeaderDenunciation::compute_hash_for_sig_verif).

pub fn is_valid(&self) -> bool

Check if Denunciation is valid using the legacy (chain-agnostic) signed-hash layout. Kept for backward compatibility with tests / pre-activation data. Production code should use Self::is_valid_with_chain with the sig_chain_id derived from the denounced slot’s network-agreed active version.

pub fn is_valid_with_chain(&self, sig_chain_id: Option<u64>) -> bool

Check if Denunciation is valid, reconstructing signatures with the chain-scoped signed-hash layout selected by sig_chain_id (None = legacy, Some(chain_id) = chain-scoped).

This is the chain-aware variant that prevents cross-chain replay of endorsements / block headers as denunciations (F90 / PDF #11): when sig_chain_id is Some(local_chain_id), a denunciation combining two messages signed on different chains no longer verifies, because the second message’s signature was produced over a hash folding in a different chain id.

pub fn get_slot(&self) -> &Slot

Get Denunciation slot ref

pub fn get_index(&self) -> Option<&u32>

Get field: index (return None for a block header denunciation)

pub fn get_public_key(&self) -> &PublicKey

Get Denunciation public key ref

pub fn is_expired( denunciation_slot_period: &u64, slot_period: &u64, denunciation_expire_periods: &u64, ) -> bool

Check if denunciation has expired given a slot period Note that slot_period can be:

• A final slot period (for example in order to cleanup denunciation pool caches)
• A block slot period (in execution (execute_denunciation(…)))

Trait Implementations

impl Clone for Denunciation

fn clone(&self) -> Denunciation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Denunciation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Denunciation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Deserializer<Denunciation> for DenunciationDeserializer

fn deserialize<'a, E: ParseError<&'a [u8]> + ContextError<&'a [u8]>>( &self, buffer: &'a [u8], ) -> IResult<&'a [u8], Denunciation, E>

Deserialize a value T from a buffer of u8.

impl From<&Denunciation> for DenunciationIndex

Create a DenunciationIndex from a Denunciation

fn from(value: &Denunciation) -> Self

Converts to this type from the input type.

impl From<&Denunciation> for DenunciationTypeId

fn from(value: &Denunciation) -> Self

Converts to this type from the input type.

impl From<Denunciation> for Denunciation

fn from(value: Denunciation) -> Self

Converts to this type from the input type.

impl PartialEq for Denunciation

fn eq(&self, other: &Denunciation) -> 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 Denunciation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Serializer<Denunciation> for DenunciationSerializer

fn serialize( &self, value: &Denunciation, buffer: &mut Vec<u8>, ) -> Result<(), SerializeError>

Serialize a value T into a buffer of u8.

impl TryFrom<(&DenunciationPrecursor, &DenunciationPrecursor)> for Denunciation

Create a new Denunciation from 2 DenunciationPrecursor (legacy, chain-agnostic signed-hash layout). Kept for backward compatibility. Production code should use the chain-aware tuple variant.

type Error = DenunciationError

The type returned in the event of a conversion error.

fn try_from( (de_p_1, de_p_2): (&DenunciationPrecursor, &DenunciationPrecursor), ) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(&DenunciationPrecursor, &DenunciationPrecursor, Option<u64>)> for Denunciation

Create a new Denunciation from 2 DenunciationPrecursor using the chain-scoped signed-hash layout selected by sig_chain_id (None = legacy, Some(chain_id) = chain-scoped).

type Error = DenunciationError

The type returned in the event of a conversion error.

fn try_from( (de_p_1, de_p_2, sig_chain_id): (&DenunciationPrecursor, &DenunciationPrecursor, Option<u64>), ) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(&SecureShare<BlockHeader, BlockId>, &SecureShare<BlockHeader, BlockId>)> for Denunciation

Create a new Denunciation from 2 SecureHeader (legacy, chain-agnostic signed-hash layout). Kept for backward compatibility with tests and pre-activation data. Production code should use the chain-aware tuple variant.

type Error = DenunciationError

The type returned in the event of a conversion error.

fn try_from( (s_bh1, s_bh2): (&SecuredHeader, &SecuredHeader), ) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(&SecureShare<BlockHeader, BlockId>, &SecureShare<BlockHeader, BlockId>, Option<u64>)> for Denunciation

Create a new Denunciation from 2 SecureHeader using the chain-scoped signed-hash layout selected by sig_chain_id (None = legacy, Some(chain_id) = chain-scoped).

type Error = DenunciationError

The type returned in the event of a conversion error.

fn try_from( (s_bh1, s_bh2, sig_chain_id): (&SecuredHeader, &SecuredHeader, Option<u64>), ) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(&SecureShare<Endorsement, EndorsementId>, &SecureShare<Endorsement, EndorsementId>)> for Denunciation

Create a new Denunciation from 2 SecureShareEndorsement (legacy, chain-agnostic signed-hash layout). Kept for backward compatibility with tests and pre-activation data. Production code should use the chain-aware tuple variant.

type Error = DenunciationError

The type returned in the event of a conversion error.

fn try_from( (s_e1, s_e2): (&SecureShareEndorsement, &SecureShareEndorsement), ) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(&SecureShare<Endorsement, EndorsementId>, &SecureShare<Endorsement, EndorsementId>, Option<u64>)> for Denunciation

Create a new Denunciation from 2 SecureShareEndorsement using the chain-scoped signed-hash layout selected by sig_chain_id (None = legacy, Some(chain_id) = chain-scoped). The same sig_chain_id must be used to sign the endorsements and to verify the resulting denunciation.

type Error = DenunciationError

The type returned in the event of a conversion error.

fn try_from( (s_e1, s_e2, sig_chain_id): (&SecureShareEndorsement, &SecureShareEndorsement, Option<u64>), ) -> Result<Self, Self::Error>

Performs the conversion.

impl StructuralPartialEq for Denunciation