Struct exonum::messages::Status

pub struct Status { /* fields omitted */ }

Current node status.

Validation

The message is ignored if its signature is incorrect or its height is lower than a node's height.

Processing

If the message's height number is bigger than a node's one, then BlockRequest with current node's height is sent in reply.

Generation

Status message is broadcast regularly with the timeout controlled by blockchain::ConsensusConfig::status_timeout. Also, it is broadcast after accepting a new block.

Methods

impl Status

pub fn new(
    from: &PublicKey,
    height: Height,
    last_hash: &Hash,
    secret_key: &SecretKey
) -> Status

Creates message and signs it.

pub fn new_with_signature(
    from: &PublicKey,
    height: Height,
    last_hash: &Hash,
    signature: &Signature
) -> Status

Creates message and appends existing signature.

pub fn to_hex(&self) -> String

Returns the hex representation of the binary data. Lower case letters are used (e.g. f9b4ca).

pub fn from(&self) -> &PublicKey

The sender's public key.

pub fn height(&self) -> Height

The height to which the message is related.

pub fn last_hash(&self) -> &Hash

Hash of the last committed block.

Trait Implementations

impl Clone for Status

fn clone(&self) -> Status

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for Status

fn eq(&self, __arg_0: &Status) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &Status) -> bool

This method tests for !=.

impl ServiceMessage for Status

const SERVICE_ID: u16

SERVICE_ID: u16 = CONSENSUS

ID of the service this message belongs to.

const MESSAGE_ID: u16

MESSAGE_ID: u16 = 0 + 1

ID of the message itself. Should be unique within a service.

impl Message for Status

fn from_raw(raw: RawMessage) -> Result<Status, Error>

Converts the raw message into the specific one.

fn raw(&self) -> &RawMessage

Returns raw message.

fn verify_signature(&self, pub_key: &PublicKey) -> bool

Verifies the message using given public key.

impl<'a> SegmentField<'a> for Status

fn item_size() -> Offset

size of item fixed part that this Field collect.

fn count(&self) -> Offset

count of items in collection

fn extend_buffer(&self, buffer: &mut Vec<u8>)

extend buffer with this collection

unsafe fn from_buffer(buffer: &'a [u8], from: Offset, count: Offset) -> Self

create collection from buffer

fn check_data(
    buffer: &'a [u8],
    from: CheckedOffset,
    count: CheckedOffset,
    latest_segment: CheckedOffset
) -> Result

check collection data

impl AsRef<RawMessage> for Status

fn as_ref(&self) -> &RawMessage

Performs the conversion.

impl FromHex for Status

type Error = Error

fn from_hex<T: AsRef<[u8]>>(hex: T) -> Result<Self, Self::Error>

Creates an instance of type Self from the given hex string, or fails with a custom error type.

impl StorageValue for Status

Important traits for Vec<u8>

impl Write for Vec<u8>

fn into_bytes(self) -> Vec<u8>

Serialize a value into a vector of bytes.

fn from_bytes(value: Cow<[u8]>) -> Self

Deserialize a value from bytes.

impl Debug for Status

fn fmt(&self, fmt: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl ExonumJson for Status

fn deserialize_field<B>(
    value: &Value,
    buffer: &mut B,
    from: Offset,
    to: Offset
) -> Result<(), Box<Error>> where
    B: WriteBufferWrapper, 

write deserialized field in buffer on place.

fn serialize_field(&self) -> Result<Value, Box<Error + Send + Sync>>

serialize field as json::Value

impl ExonumJsonDeserialize for Status

fn deserialize(value: &Value) -> Result<Self, Box<Error>>

deserialize json value.

impl<'de> Deserialize<'de> for Status

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Serialize for Status

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.