// 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/>.

//! Runtime modules for parachains code.

//!

//! It is crucial to include all the modules from this crate in the runtime, in

//! particular the `Initializer` module, as it is responsible for initializing the state

//! of the other modules.

#![cfg_attr(feature = "runtime-benchmarks", recursion_limit = "256")]

#![cfg_attr(not(feature = "std"), no_std)]

pub mod assigner_coretime;

pub mod assigner_on_demand;

pub mod assigner_parachains;

pub mod configuration;

pub mod coretime;

pub mod disputes;

pub mod dmp;

pub mod hrmp;

pub mod inclusion;

pub mod initializer;

pub mod metrics;

pub mod origin;

pub mod paras;

pub mod paras_inherent;

pub mod reward_points;

pub mod scheduler;

pub mod session_info;

pub mod shared;

pub mod runtime_api_impl;

mod util;

#[cfg(any(feature = "runtime-benchmarks", test))]

mod builder;

#[cfg(test)]

mod mock;

#[cfg(test)]

mod ump_tests;

extern crate alloc;

pub use origin::{ensure_parachain, Origin};

pub use paras::{ParaLifecycle, UpgradeStrategy};

use polkadot_primitives::{HeadData, Id as ParaId, ValidationCode};

use sp_runtime::{DispatchResult, FixedU128};

/// Trait for tracking message delivery fees on a transport protocol.

pub trait FeeTracker {

	/// Type used for assigning different fee factors to different destinations

	type Id;

	/// Returns the evolving exponential fee factor which will be used to calculate the delivery

	/// fees.

	fn get_fee_factor(id: Self::Id) -> FixedU128;

	/// Increases the delivery fee factor by a factor based on message size and records the result.

	///

	/// Returns the new delivery fee factor after the increase.

	fn increase_fee_factor(id: Self::Id, message_size_factor: FixedU128) -> FixedU128;

	/// Decreases the delivery fee factor by a constant factor and records the result.

	///

	/// Does not reduce the fee factor below the initial value, which is currently set as 1.

	///

	/// Returns the new delivery fee factor after the decrease.

	fn decrease_fee_factor(id: Self::Id) -> FixedU128;

}

/// Schedule a para to be initialized at the start of the next session with the given genesis data.

/// Schedule a para to be cleaned up at the start of the next session.

/// Schedule a parathread (on-demand parachain) to be upgraded to a lease holding parachain.

/// Schedule a lease holding parachain to be downgraded to an on-demand parachain.

/// Schedules a validation code upgrade to a parachain with the given id.

/// Sets the current parachain head with the given id.