Enum ShardKind

pub enum ShardKind {
    BeaconChain,
    IntermediateShard,
    LeafShard,
    Phantom,
    Invalid,
}

A kind of shard.

Schematically, the hierarchy of shards is as follows:

                         Beacon chain
                         /          \
     Intermediate shard 1            Intermediate shard 2
             /  \                            /  \
Leaf shard 11   Leaf shard 12   Leaf shard 22   Leaf shard 22

Beacon chain has index 0, intermediate shards indices 1..=1023. Leaf shards share the same least significant 10 bits as their respective intermediate shards, so leaf shards of intermediate shard 1 have indices like 1025,2049,3097,etc.

If represented as least significant bits first (as it will be in the formatted address):

Intermediate shard bits
    \            /
     1000_0000_0001_0000_0000
                /            \
               Leaf shard bits

Note that shards that have 10 least significant bits set to 0 (corresponds to the beacon chain) are not leaf shards, in fact, they are not even physical shards that have nodes in general. The meaning of these shards is TBD, currently they are called “phantom” shards and may end up containing some system contracts with special meaning, but no blocks will ever exist for such shards.

Variants

BeaconChain

Beacon chain shard

IntermediateShard

Intermediate shard directly below the beacon chain that has child shards

LeafShard

Leaf shard, doesn’t have child shards

Phantom

TODO

Invalid

Invalid shard kind (if decoded from invalid bit pattern)

Trait Implementations

impl Clone for ShardKind

fn clone(&self) -> ShardKind

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ShardKind

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

Formats the value using the given formatter.

impl Hash for ShardKind

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 PartialEq for ShardKind

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

impl Eq for ShardKind

impl StructuralPartialEq for ShardKind