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 150 151 152 153 154 155 156 157 158 159 160
// Copyright (C) Parity Technologies (UK) Ltd.
// This file is part of Polkadot.
// Polkadot 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.
// Polkadot 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 Polkadot. If not, see <http://www.gnu.org/licenses/>.
//! Basic parachain that adds a number as part of its state.
#![no_std]
extern crate alloc;
use alloc::vec::Vec;
use codec::{Decode, Encode};
use tiny_keccak::{Hasher as _, Keccak};
#[cfg(not(feature = "std"))]
mod wasm_validation;
#[cfg(not(feature = "std"))]
#[global_allocator]
static ALLOC: dlmalloc::GlobalDlmalloc = dlmalloc::GlobalDlmalloc;
const LOG_TARGET: &str = "runtime::undying";
// Make the WASM binary available.
#[cfg(feature = "std")]
include!(concat!(env!("OUT_DIR"), "/wasm_binary.rs"));
fn keccak256(input: &[u8]) -> [u8; 32] {
let mut out = [0u8; 32];
let mut keccak256 = Keccak::v256();
keccak256.update(input);
keccak256.finalize(&mut out);
out
}
/// Wasm binary unwrapped. If built with `BUILD_DUMMY_WASM_BINARY`, the function panics.
#[cfg(feature = "std")]
pub fn wasm_binary_unwrap() -> &'static [u8] {
WASM_BINARY.expect(
"Development wasm binary is not available. Testing is only \
supported with the flag disabled.",
)
}
/// Head data for this parachain.
#[derive(Default, Clone, Hash, Eq, PartialEq, Encode, Decode, Debug)]
pub struct HeadData {
/// Block number
pub number: u64,
/// parent block keccak256
pub parent_hash: [u8; 32],
/// hash of post-execution state.
pub post_state: [u8; 32],
}
impl HeadData {
pub fn hash(&self) -> [u8; 32] {
keccak256(&self.encode())
}
}
/// Block data for this parachain.
#[derive(Default, Clone, Encode, Decode, Debug)]
pub struct GraveyardState {
/// The grave index of the last placed tombstone.
pub index: u64,
/// We use a matrix where each element represents a grave.
/// The unsigned integer tracks the number of tombstones raised on
/// each grave.
pub graveyard: Vec<u8>,
// TODO: Add zombies. All of the graves produce zombies at a regular interval
// defined in blocks. The number of zombies produced scales with the tombstones.
// This would allow us to have a configurable and reproducible PVF execution time.
// However, PVF preparation time will likely rely on prebuild wasm binaries.
pub zombies: u64,
// Grave seal.
pub seal: [u8; 32],
}
/// Block data for this parachain.
#[derive(Default, Clone, Encode, Decode, Debug)]
pub struct BlockData {
/// The state
pub state: GraveyardState,
/// The number of tombstones to erect per iteration. For each tombstone placed
/// a hash operation is performed as CPU burn.
pub tombstones: u64,
/// The number of iterations to perform.
pub iterations: u32,
}
pub fn hash_state(state: &GraveyardState) -> [u8; 32] {
keccak256(state.encode().as_slice())
}
/// Executes all graveyard transactions in the block.
pub fn execute_transaction(mut block_data: BlockData) -> GraveyardState {
let graveyard_size = block_data.state.graveyard.len();
for _ in 0..block_data.iterations {
for _ in 0..block_data.tombstones {
block_data.state.graveyard[block_data.state.index as usize] =
block_data.state.graveyard[block_data.state.index as usize].wrapping_add(1);
block_data.state.index =
((block_data.state.index.saturating_add(1)) as usize % graveyard_size) as u64;
}
// Chain hash the seals and burn CPU.
block_data.state.seal = hash_state(&block_data.state);
}
block_data.state
}
/// Start state mismatched with parent header's state hash.
#[derive(Debug)]
pub struct StateMismatch;
/// Execute a block body on top of given parent head, producing new parent head
/// and new state if valid.
pub fn execute(
parent_hash: [u8; 32],
parent_head: HeadData,
block_data: BlockData,
) -> Result<(HeadData, GraveyardState), StateMismatch> {
assert_eq!(parent_hash, parent_head.hash());
if hash_state(&block_data.state) != parent_head.post_state {
log::debug!(
target: LOG_TARGET,
"state has diff vs head: {:?} vs {:?}",
hash_state(&block_data.state),
parent_head.post_state,
);
return Err(StateMismatch)
}
// We need to clone the block data as the fn will mutate it's state.
let new_state = execute_transaction(block_data.clone());
Ok((
HeadData {
number: parent_head.number + 1,
parent_hash,
post_state: hash_state(&new_state),
},
new_state,
))
}