Struct Header

pub struct Header {
    pub version: Version,
    pub compact_target: Uint32,
    pub timestamp: Timestamp,
    pub number: BlockNumber,
    pub epoch: EpochNumberWithFraction,
    pub parent_hash: H256,
    pub transactions_root: H256,
    pub proposals_hash: H256,
    pub extra_hash: H256,
    pub dao: Byte32,
    pub nonce: Uint128,
}

The block header.

Refer to RFC CKB Block Structure.

Fields

version: Version

The block version.

It must equal to 0 now and is reserved for future upgrades.

compact_target: Uint32

The block difficulty target.

It can be converted to a 256-bit target. Miners must ensure the Eaglesong of the header is within the target.

timestamp: Timestamp

The block timestamp.

It is a Unix timestamp in milliseconds (1 second = 1000 milliseconds).

Miners should put the time when the block is created in the header, however, the precision is not guaranteed. A block with a higher block number may even have a smaller timestamp.

number: BlockNumber

The consecutive block number starting from 0.

epoch: EpochNumberWithFraction

The epoch information of this block.

See EpochNumberWithFraction for details.

parent_hash: H256

The header hash of the parent block.

transactions_root: H256

The commitment to all the transactions in the block.

It is a hash on two Merkle Tree roots:

• The root of a CKB Merkle Tree, which items are the transaction hashes of all the transactions in the block.
• The root of a CKB Merkle Tree, but the items are the transaction witness hashes of all the transactions in the block.

proposals_hash: H256

The hash on proposals in the block body.

It is all zeros when proposals is empty, or the hash on all the bytes concatenated together.

extra_hash: H256

The hash on uncles and extension in the block body.

The uncles hash is all zeros when uncles is empty, or the hash on all the uncle header hashes concatenated together. The extension hash is the hash of the extension. The extra hash is the hash on uncles hash and extension hash concatenated together.

Notice

This field is renamed from uncles_hash since 0.100.0. More details can be found in CKB RFC 0031.

dao: Byte32

DAO fields.

See RFC Deposit and Withdraw in Nervos DAO.

nonce: Uint128

Miner can modify this field to find a proper value such that the Eaglesong of the header is within the target encoded from compact_target.

Trait Implementations

impl Clone for Header

fn clone(&self) -> Header

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Header

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

Formats the value using the given formatter.

impl Default for Header

fn default() -> Header

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Header

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Header> for Header

fn from(input: Header) -> Self

Converts to this type from the input type.

impl From<Header> for Header

fn from(json: Header) -> Self

Converts to this type from the input type.

impl Hash for Header

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for Header

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(gen: &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 Header

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Header

impl StructuralPartialEq for Header