Struct BlockDigest

Class that store uses to save blocks. This contains: BlockHeader, and list of TxIds.

Implements

IBlockMetadata

IBlockExcerpt

Inherited Members

ValueType.Equals(Object)

ValueType.GetHashCode()

ValueType.ToString()

Object.Equals(Object, Object)

Object.GetType()

Object.ReferenceEquals(Object, Object)

Namespace: Libplanet.Store

Assembly: Libplanet.Store.dll

Syntax

public readonly struct BlockDigest : IBlockMetadata, IBlockExcerpt

Constructors

BlockDigest(Dictionary)

Creates BlockDigest instance from Bencodex.Types.Dictionary representation of the Block.

Declaration

public BlockDigest(Dictionary dict)

Parameters

Type	Name	Description
Bencodex.Types.Dictionary	dict	Bencodex.Types.Dictionary representation of the Block.

BlockDigest(BlockHeader, ImmutableArray<ImmutableArray<Byte>>)

Creates BlockDigest instance from BlockHeader and Transaction ids the Block has.

Declaration

public BlockDigest(BlockHeader header, ImmutableArray<ImmutableArray<byte>> txIds)

Parameters

Type	Name	Description
BlockHeader	header	BlockHeader of the Block.
ImmutableArray<ImmutableArray<Byte>>	txIds	Transaction ids the Block has.

Properties

Hash

The block hash.

Declaration

public readonly BlockHash Hash { get; }

Property Value

Type	Description
BlockHash

Index

The height of the block.

Declaration

public readonly long Index { get; }

Property Value

Type	Description
Int64

Remarks

Zero means it is a genesis block. Not allowed to be negative.

See Also

Index

LastCommit

The BlockCommit about previous block's vote information.

Declaration

public readonly BlockCommit LastCommit { get; }

Property Value

Type	Description
BlockCommit

Miner

The address of the miner.

Declaration

public readonly Address Miner { get; }

Property Value

Type	Description
Address

PreviousHash

The previous block's hash. If it's a genesis block (i.e., its Index is 0) this must be null.

Declaration

public readonly BlockHash? PreviousHash { get; }

Property Value

Type	Description
Nullable<BlockHash>

ProtocolVersion

The protocol version number.

Declaration

public readonly int ProtocolVersion { get; }

Property Value

Type	Description
Int32

See Also

ProtocolVersion

PublicKey

The public key of the Miner. This is used for verifying the signature.

Although this is nullable type-wise, it is mandatory where ProtocolVersion is 2 or later. As blocks had not been signed in the previous protocol versions, the type of this is nullable.

Declaration

public readonly PublicKey PublicKey { get; }

Property Value

Type	Description
PublicKey

Signature

The block signature.

Declaration

public readonly ImmutableArray<byte>? Signature { get; }

Property Value

Type	Description
Nullable<ImmutableArray<Byte>>

StateRootHash

The state root hash.

Declaration

public readonly HashDigest<SHA256> StateRootHash { get; }

Property Value

Type	Description
HashDigest<SHA256>

Timestamp

The time the block is created.

Declaration

public readonly DateTimeOffset Timestamp { get; }

Property Value

Type	Description
DateTimeOffset

Remarks

This is always UTC.

TxHash

The hash of all transactions in the block. This is null if the block has no transactions.

Declaration

public readonly HashDigest<SHA256>? TxHash { get; }

Property Value

Type	Description
Nullable<HashDigest<SHA256>>

TxIds

The Ids of Transactions in a Block. This is not necessarily ordered by Id.

Declaration

public readonly ImmutableArray<ImmutableArray<byte>> TxIds { get; }

Property Value

Type	Description
ImmutableArray<ImmutableArray<Byte>>

Methods

Deserialize(Byte[])

Gets BlockDigest instance from serialized bytes.

Declaration

public static BlockDigest Deserialize(byte[] bytes)

Parameters

Type	Name	Description
Byte[]	bytes	Serialized BlockDigest.

Returns

Type	Description
BlockDigest	Deserialized BlockDigest.

Exceptions

Type	Condition
ArgumentNullException	Thrown when the passed bytes is null.
Bencodex.DecodingException	Thrown when decoded value is not Bencodex.Types.Dictionary type.

FromBlock(Block)

Gets BlockDigest representation of the Block.

Declaration

public static BlockDigest FromBlock(Block block)

Parameters

Type	Name	Description
Block	block	The block instance to get its digest.

Returns

Type	Description
BlockDigest	BlockDigest representation of the Block.

GetHeader()

Gets the block header.

Declaration

public readonly BlockHeader GetHeader()

Returns

Type	Description
BlockHeader	The block header.

Serialize()

Gets serialized byte array of the BlockDigest.

Declaration

public readonly byte[] Serialize()

Returns

Type	Description
Byte[]	Serialized byte array of BlockDigest.

ToBencodex()

Gets Bencodex.Types.Dictionary representation of BlockDigest.

Declaration

public readonly Dictionary ToBencodex()

Returns

Type	Description
Bencodex.Types.Dictionary	Bencodex.Types.Dictionary representation of BlockDigest.

Implements

IBlockMetadata

IBlockExcerpt