Enum unc_primitives::block::Block

pub enum Block {
    BlockV1(Arc<BlockV1>),
    BlockV2(Arc<BlockV2>),
    BlockV3(Arc<BlockV3>),
}

Versioned Block data structure. For each next version, document what are the changes between versions.

Variants

BlockV1(Arc<BlockV1>)

BlockV2(Arc<BlockV2>)

BlockV3(Arc<BlockV3>)

Implementations

impl Block

pub fn genesis( genesis_protocol_version: ProtocolVersion, chunks: Vec<ShardChunkHeader>, timestamp: DateTime<Utc>, height: BlockHeight, initial_gas_price: Balance, initial_total_supply: Balance, next_bp_hash: CryptoHash ) -> Self

Returns genesis block for given genesis date and state root.

pub fn produce( this_epoch_protocol_version: ProtocolVersion, next_epoch_protocol_version: ProtocolVersion, prev: &BlockHeader, height: BlockHeight, block_ordinal: NumBlocks, chunks: Vec<ShardChunkHeader>, epoch_id: EpochId, next_epoch_id: EpochId, epoch_sync_data_hash: Option<CryptoHash>, approvals: Vec<Option<Box<Signature>>>, gas_price_adjustment_rate: Rational32, min_gas_price: Balance, max_gas_price: Balance, minted_amount: Option<Balance>, challenges_result: ChallengesResult, challenges: Challenges, signer: &dyn ValidatorSigner, next_bp_hash: CryptoHash, block_merkle_root: CryptoHash, timestamp_override: Option<DateTime<Utc>> ) -> Self

Produces new block from header of previous block, current state root and set of transactions.

pub fn verify_total_supply( &self, prev_total_supply: Balance, minted_amount: Option<Balance> ) -> bool

pub fn verify_gas_price( &self, gas_price: Balance, min_gas_price: Balance, max_gas_price: Balance, gas_price_adjustment_rate: Rational32 ) -> bool

pub fn compute_next_gas_price( gas_price: Balance, gas_used: Gas, gas_limit: Gas, gas_price_adjustment_rate: Rational32, min_gas_price: Balance, max_gas_price: Balance ) -> Balance

Computes gas price for applying chunks in the next block according to the formula: next_gas_price = gas_price * (1 + (gas_used/gas_limit - 1/2) * adjustment_rate) and clamped between min_gas_price and max_gas_price.

pub fn compute_state_root<'a, T: IntoIterator<Item = &'a ShardChunkHeader>>( chunks: T ) -> CryptoHash

pub fn compute_block_body_hash_impl(body: &BlockBody) -> CryptoHash

pub fn compute_chunk_prev_outgoing_receipts_root<'a, T: IntoIterator<Item = &'a ShardChunkHeader>>( chunks: T ) -> CryptoHash

pub fn compute_chunk_headers_root<'a, T: IntoIterator<Item = &'a ShardChunkHeader>>( chunks: T ) -> (CryptoHash, Vec<MerklePath>)

pub fn compute_chunk_tx_root<'a, T: IntoIterator<Item = &'a ShardChunkHeader>>( chunks: T ) -> CryptoHash

pub fn compute_outcome_root<'a, T: IntoIterator<Item = &'a ShardChunkHeader>>( chunks: T ) -> CryptoHash

pub fn compute_challenges_root(challenges: &Challenges) -> CryptoHash

pub fn compute_gas_used<'a, T: IntoIterator<Item = &'a ShardChunkHeader>>( chunks: T, height: BlockHeight ) -> Gas

pub fn compute_gas_limit<'a, T: IntoIterator<Item = &'a ShardChunkHeader>>( chunks: T, height: BlockHeight ) -> Gas

pub fn validate_chunk_header_proof( chunk: &ShardChunkHeader, chunk_root: &CryptoHash, merkle_path: &MerklePath ) -> bool

pub fn header(&self) -> &BlockHeader

pub fn chunks(&self) -> ChunksCollection<'_>

pub fn challenges(&self) -> &Challenges

pub fn vrf_value(&self) -> &Value

pub fn vrf_proof(&self) -> &Proof

pub fn hash(&self) -> &CryptoHash

pub fn compute_block_body_hash(&self) -> Option<CryptoHash>

pub fn check_validity(&self) -> Result<(), BlockValidityError>

Checks that block content matches block hash, with the possible exception of chunk signatures

impl Block

pub fn get_mut(&mut self) -> &mut BlockV3

impl Block

pub fn mut_header(&mut self) -> &mut BlockHeader

pub fn set_chunks(&mut self, chunks: Vec<ShardChunkHeader>)

Trait Implementations

impl BorshDeserialize for Block

fn deserialize_reader<__R: Read>(reader: &mut __R) -> Result<Self, Error>

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn try_from_reader<R>(reader: &mut R) -> Result<Self, Error>

where R: Read,

impl BorshSerialize for Block

fn serialize<__W: Write>(&self, writer: &mut __W) -> Result<(), Error>

impl Clone for Block

fn clone(&self) -> Block

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Block

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

Formats the value using the given formatter.

impl EnumExt for Block

fn deserialize_variant<__R: Read>( reader: &mut __R, variant_tag: u8 ) -> Result<Self, Error>

Deserialises given variant of an enum from the reader.

impl PartialEq for Block

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Block

impl StructuralPartialEq for Block