beacon 0.2.0

Minimal Serenity beacon chain implementation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

// Copyright 2018 Parity Technologies (UK) Ltd.
// This file is part of Substrate Shasper.

// Substrate is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// Substrate is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with Substrate.  If not, see <http://www.gnu.org/licenses/>.

//! Beacon blocks

#[cfg(feature = "serde")]
use serde::{Serialize, Deserialize, de::DeserializeOwned};
use ssz::{Codec, Encode, Decode};
use bm_le::{IntoTree, FromTree, MaxVec};
use crate::*;
use crate::primitives::*;
use crate::types::*;

#[derive(Codec, Encode, Decode, IntoTree, FromTree, Clone, PartialEq, Eq, Default)]
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize), serde(deny_unknown_fields))]
#[cfg_attr(feature = "serde", serde(bound = "C: Config + Serialize + Clone + DeserializeOwned + 'static"))]
#[cfg_attr(feature = "parity-codec", derive(parity_codec::Encode, parity_codec::Decode))]
#[cfg_attr(feature = "std", derive(Debug))]
/// Beacon block body.
pub struct BeaconBlockBody<C: Config> {
	/// Randao reveal.
	pub randao_reveal: H768,
	/// Eth1 data.
	pub eth1_data: Eth1Data,
	/// Graffiti.
	pub graffiti: H256,
	/// Proposer slashings.
	pub proposer_slashings: MaxVec<ProposerSlashing, C::MaxProposerSlashings>,
	/// Attester slashings.
	pub attester_slashings: MaxVec<AttesterSlashing<C>, C::MaxAttesterSlashings>,
	/// Attestations.
	pub attestations: MaxVec<Attestation<C>, C::MaxAttestations>,
	/// Deposits.
	pub deposits: MaxVec<Deposit, C::MaxDeposits>,
	/// Voluntary exits.
	pub voluntary_exits: MaxVec<VoluntaryExit, C::MaxVoluntaryExits>,
	/// Transfer.
	pub transfers: MaxVec<Transfer, C::MaxTransfers>,
}

/// Sealed or unsealed block.
pub trait Block {
	/// Configuration of the block.
	type Config: Config;

	/// Slot of the block.
	fn slot(&self) -> u64;
	/// Previous block root.
	fn parent_root(&self) -> &H256;
	/// State root.
	fn state_root(&self) -> &H256;
	/// Body.
	fn body(&self) -> &BeaconBlockBody<Self::Config>;
	/// Signature of the block. None for unsealed block.
	fn signature(&self) -> Option<&Signature>;
}

#[derive(Codec, Encode, Decode, IntoTree, FromTree, Clone, PartialEq, Eq, Default)]
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize), serde(deny_unknown_fields))]
#[cfg_attr(feature = "serde", serde(bound = "C: Config + Serialize + Clone + DeserializeOwned + 'static"))]
#[cfg_attr(feature = "parity-codec", derive(parity_codec::Encode, parity_codec::Decode))]
#[cfg_attr(feature = "std", derive(Debug))]
/// Beacon block.
pub struct BeaconBlock<C: Config> {
	/// Slot of the block.
	pub slot: Uint,
	/// Previous block root.
	pub parent_root: H256,
	/// State root.
	pub state_root: H256,
	/// Body.
	pub body: BeaconBlockBody<C>,
	/// Signature.
	pub signature: Signature,
}

impl<C: Config> Block for BeaconBlock<C> {
	type Config = C;

	fn slot(&self) -> u64 { self.slot }
	fn parent_root(&self) -> &H256 { &self.parent_root }
	fn state_root(&self) -> &H256 { &self.state_root }
	fn body(&self) -> &BeaconBlockBody<C> { &self.body }
	fn signature(&self) -> Option<&Signature> { Some(&self.signature) }
}

impl<'a, C: Config, T: Block<Config=C>> From<&'a T> for UnsealedBeaconBlock<C> {
	fn from(t: &'a T) -> UnsealedBeaconBlock<C> {
		UnsealedBeaconBlock {
			slot: t.slot(),
			parent_root: t.parent_root().clone(),
			state_root: t.state_root().clone(),
			body: t.body().clone(),
		}
	}
}

#[derive(Codec, Encode, Decode, IntoTree, FromTree, Clone, PartialEq, Eq, Default)]
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize), serde(deny_unknown_fields))]
#[cfg_attr(feature = "serde", serde(bound = "C: Config + Serialize + Clone + DeserializeOwned + 'static"))]
#[cfg_attr(feature = "parity-codec", derive(parity_codec::Encode, parity_codec::Decode))]
#[cfg_attr(feature = "std", derive(Debug))]
/// Unsealed Beacon block.
pub struct UnsealedBeaconBlock<C: Config> {
	/// Slot of the block.
	pub slot: Uint,
	/// Previous block root.
	pub parent_root: H256,
	/// State root.
	pub state_root: H256,
	/// Body.
	pub body: BeaconBlockBody<C>,
}

impl<C: Config> Block for UnsealedBeaconBlock<C> {
	type Config = C;

	fn slot(&self) -> u64 { self.slot }
	fn parent_root(&self) -> &H256 { &self.parent_root }
	fn state_root(&self) -> &H256 { &self.state_root }
	fn body(&self) -> &BeaconBlockBody<C> { &self.body }
	fn signature(&self) -> Option<&Signature> { None }
}

impl<C: Config> UnsealedBeaconBlock<C> {
	/// Fake sealing a beacon block, with empty signature.
	pub fn fake_seal(self) -> BeaconBlock<C> {
		BeaconBlock {
			slot: self.slot,
			parent_root: self.parent_root,
			state_root: self.state_root,
			body: self.body,
			signature: Default::default(),
		}
	}
}