Enum Block

pub enum Block {
    V1(BlockV1),
    V2(BlockV2),
}

A block after execution.

Variants

V1(BlockV1)

The legacy, initial version of the block.

V2(BlockV2)

The version 2 of the block.

Implementations

impl Block

pub fn clone_header(&self) -> BlockHeader

Clones the header, put it in the versioning enum, and returns it.

pub fn take_header(self) -> BlockHeader

Returns the block’s header, consuming self.

pub fn timestamp(&self) -> Timestamp

Returns the timestamp from when the block was proposed.

pub fn protocol_version(&self) -> ProtocolVersion

Returns the protocol version of the network from when this block was created.

pub fn hash(&self) -> &BlockHash

The hash of this block’s header.

pub fn body_hash(&self) -> &Digest

Returns the hash of the block’s body.

pub fn random_bit(&self) -> bool

Returns a random bit needed for initializing a future era.

pub fn accumulated_seed(&self) -> &Digest

Returns a seed needed for initializing a future era.

pub fn parent_hash(&self) -> &BlockHash

Returns the parent block’s hash.

pub fn proposer(&self) -> &PublicKey

Returns the public key of the validator which proposed the block.

pub fn clone_body(&self) -> BlockBody

Clone the body and wrap is up in the versioned Body.

pub fn take_body(self) -> BlockBody

Returns the block’s body, consuming self.

pub fn verify(&self) -> Result<(), BlockValidationError>

Check the integrity of a block by hashing its body and header

pub fn height(&self) -> u64

Returns the height of this block, i.e. the number of ancestors.

pub fn era_id(&self) -> EraId

Returns the era ID in which this block was created.

pub fn clone_era_end(&self) -> Option<EraEnd>

Clones the era end, put it in the versioning enum, and returns it.

pub fn is_switch_block(&self) -> bool

Returns true if this block is the last one in the current era.

pub fn is_genesis(&self) -> bool

Returns true if this block is the first block of the chain, the genesis block.

pub fn state_root_hash(&self) -> &Digest

Returns the root hash of global state after the deploys in this block have been executed.

pub fn rewarded_signatures(&self) -> &RewardedSignatures

List of identifiers for finality signatures for a particular past block.

pub fn maybe_current_gas_price(&self) -> Option<u8>

Return the gas price for V2 block header.

pub fn transaction_count(&self) -> u64

Returns the count of transactions within a block.

pub fn all_transaction_hashes( &self, ) -> impl Iterator<Item = TransactionHash> + '_

Returns a list of all transaction hashes in a block.

pub fn block_utilization(&self, transaction_config: TransactionConfig) -> u64

Available on crate feature std only.

Returns the utilization of the block against a given chainspec.

pub fn has_hit_slot_capacity( &self, transaction_config: TransactionConfig, ) -> bool

Available on crate feature std only.

Returns true if the block has reached capacity in any of its transaction limit.

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DataSize for Block

where BlockV1: DataSize, BlockV2: DataSize,

const IS_DYNAMIC: bool = true

If true, the type has a heap size that can vary at runtime, depending on the actual value.

const STATIC_HEAP_SIZE: usize = 0usize

The amount of space a value of the type always occupies. If IS_DYNAMIC is false, this is the total amount of heap memory occupied by the value. Otherwise this is a lower bound.

fn estimate_heap_size(&self) -> usize

Estimates the size of heap memory taken up by this value.

impl Debug for Block

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Block

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Block

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

Formats the value using the given formatter.

impl From<&BlockV1> for Block

fn from(block: &BlockV1) -> Self

Converts to this type from the input type.

impl From<&BlockV2> for Block

fn from(block: &BlockV2) -> Self

Converts to this type from the input type.

impl From<BlockV1> for Block

fn from(block: BlockV1) -> Self

Converts to this type from the input type.

impl From<BlockV2> for Block

fn from(block: BlockV2) -> Self

Converts to this type from the input type.

impl From<JsonBlockWithSignatures> for Block

Available on crate features std and json-schema only.

fn from(block_with_signatures: JsonBlockWithSignatures) -> Self

Converts to this type from the input type.

impl FromBytes for Block

fn from_bytes(bytes: &[u8]) -> Result<(Self, &[u8]), Error>

Deserializes the slice into Self.

fn from_vec(bytes: Vec<u8>) -> Result<(Self, Vec<u8>), Error>

Deserializes the Vec<u8> into Self.

impl JsonSchema for Block

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 Block

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToBytes for Block

fn to_bytes(&self) -> Result<Vec<u8>, Error>

Serializes &self to a Vec<u8>.

fn serialized_length(&self) -> usize

Returns the length of the Vec<u8> which would be returned from a successful call to to_bytes() or into_bytes(). The data is not actually serialized, so this call is relatively cheap.

fn into_bytes(self) -> Result<Vec<u8>, Error>

where Self: Sized,

Consumes self and serializes to a Vec<u8>.

fn write_bytes(&self, writer: &mut Vec<u8>) -> Result<(), Error>

Writes &self into a mutable writer.

impl TryFrom<Block> for BlockV2

type Error = BlockConversionError

The type returned in the event of a conversion error.

fn try_from(value: Block) -> Result<BlockV2, BlockConversionError>

Performs the conversion.

impl Eq for Block

impl StructuralPartialEq for Block