// 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 . use crate::artifacts::ArtifactId; use parity_scale_codec::{Decode, Encode}; use polkadot_parachain::primitives::ValidationCodeHash; use polkadot_primitives::ExecutorParams; use sp_core::blake2_256; use std::{ cmp::{Eq, PartialEq}, fmt, sync::Arc, time::Duration, }; #[cfg(test)] use crate::host::tests::TEST_PREPARATION_TIMEOUT; /// A struct that carries the exhaustive set of data to prepare an artifact out of plain /// Wasm binary /// /// Should be cheap to clone. #[derive(Clone, Encode, Decode)] pub struct PvfPrepData { /// Wasm code (uncompressed) pub(crate) code: Arc>, /// Wasm code hash pub(crate) code_hash: ValidationCodeHash, /// Executor environment parameters for the session for which artifact is prepared pub(crate) executor_params: Arc, /// Preparation timeout pub(crate) prep_timeout: Duration, } impl PvfPrepData { /// Returns an instance of the PVF out of the given PVF code and executor params. pub fn from_code( code: Vec, executor_params: ExecutorParams, prep_timeout: Duration, ) -> Self { let code = Arc::new(code); let code_hash = blake2_256(&code).into(); let executor_params = Arc::new(executor_params); Self { code, code_hash, executor_params, prep_timeout } } /// Returns artifact ID that corresponds to the PVF with given executor params pub(crate) fn as_artifact_id(&self) -> ArtifactId { ArtifactId::new(self.code_hash, self.executor_params.hash()) } /// Returns validation code hash for the PVF pub(crate) fn code_hash(&self) -> ValidationCodeHash { self.code_hash } /// Returns PVF code pub(crate) fn code(&self) -> Arc> { self.code.clone() } /// Returns executor params pub(crate) fn executor_params(&self) -> Arc { self.executor_params.clone() } /// Creates a structure for tests #[cfg(test)] pub(crate) fn from_discriminator_and_timeout(num: u32, timeout: Duration) -> Self { let descriminator_buf = num.to_le_bytes().to_vec(); Self::from_code(descriminator_buf, ExecutorParams::default(), timeout) } #[cfg(test)] pub(crate) fn from_discriminator(num: u32) -> Self { Self::from_discriminator_and_timeout(num, TEST_PREPARATION_TIMEOUT) } } impl fmt::Debug for PvfPrepData { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!( f, "Pvf {{ code, code_hash: {:?}, executor_params: {:?}, prep_timeout: {:?} }}", self.code_hash, self.executor_params, self.prep_timeout ) } } impl PartialEq for PvfPrepData { fn eq(&self, other: &Self) -> bool { self.code_hash == other.code_hash && self.executor_params.hash() == other.executor_params.hash() } } impl Eq for PvfPrepData {}