Struct BlockV1

pub struct BlockV1 { /* private fields */ }

A block after execution, with the resulting global state root hash. This is the core component of the Casper linear blockchain. Version 1.

Implementations

impl BlockV1

pub fn hash(&self) -> &BlockHash

Returns the BlockHash identifying this block.

pub fn header(&self) -> &BlockHeaderV1

Returns the block’s header.

pub fn take_header(self) -> BlockHeaderV1

Returns the block’s header, consuming self.

pub fn body(&self) -> &BlockBodyV1

Returns the block’s body.

pub fn take_body(self) -> BlockBodyV1

Returns the block’s body, consuming self.

pub fn parent_hash(&self) -> &BlockHash

Returns the parent block’s hash.

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 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 era_end(&self) -> Option<&EraEndV1>

Returns the EraEnd of a block if it is a switch block.

pub fn timestamp(&self) -> Timestamp

Returns the timestamp from when the block was proposed.

pub fn era_id(&self) -> EraId

Returns the era ID in which this block was created.

pub fn height(&self) -> u64

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

pub fn protocol_version(&self) -> ProtocolVersion

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

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 Genesis block, i.e. has height 0 and era 0.

pub fn proposer(&self) -> &PublicKey

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

pub fn deploy_hashes(&self) -> &[DeployHash]

Returns the deploy hashes within the block.

pub fn transfer_hashes(&self) -> &[DeployHash]

Returns the transfer hashes within the block.

pub fn deploy_and_transfer_hashes(&self) -> impl Iterator<Item = &DeployHash>

Returns the deploy and transfer hashes in the order in which they were executed.

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

Returns Ok if and only if the block’s provided block hash and body hash are identical to those generated by hashing the appropriate input data.

pub fn random_with_specifics<I: IntoIterator<Item = DeployHash>>( rng: &mut TestRng, era_id: EraId, height: u64, protocol_version: ProtocolVersion, is_switch: bool, deploy_hashes_iter: I, ) -> Self

Available on crate features std and testing only.

Returns a random block, but using the provided values.

If deploy_hashes_iter is empty, a few random deploy hashes will be added to the deploy_hashes and transfer_hashes fields of the body. Otherwise, the provided deploy hashes will populate the deploy_hashes field and transfer_hashes will be empty.

Trait Implementations

impl Clone for BlockV1

fn clone(&self) -> BlockV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DataSize for BlockV1

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 BlockV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BlockV1

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BlockV1

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<BlockV1> for Block

fn from(block: BlockV1) -> Self

Converts to this type from the input type.

impl FromBytes for BlockV1

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 BlockV1

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 BlockV1

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

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 BlockV1

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

Writes &self into a mutable writer.

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>.

impl Eq for BlockV1

impl StructuralPartialEq for BlockV1