feat: FRAME umbrella crate.

Cargo.toml

@@ -74,6 +74,7 @@ members = [
 	"client/transaction-pool",
 	"client/transaction-pool/api",
 	"client/utils",
+	"frame",
 	"frame/alliance",
 	"frame/assets",
 	"frame/atomic-swap",

frame/Cargo.toml

@@ -0,0 +1,46 @@
+[package]
+name = "frame"
+version = "0.0.1-dev"
+authors = ["Parity Technologies <admin@parity.io>"]
+edition = "2021"
+license = "Apache-2.0"
+homepage = "https://substrate.io"
+repository = "/~https://github.com/paritytech/substrate/"
+description = "The single package to get you started with FRAME"
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+
+[dependencies]
+# external deps
+parity-scale-codec = { version = "3.2.2", default-features = false, features = ["derive"]}
+scale-info = {  version = "2.6.0", default-features = false, features = ["derive"]}
+
+# primitive deps
+sp-api = { default-features = false, path = "../primitives/api" }
+sp-runtime = { default-features = false, path = "../primitives/runtime" }
+sp-std = { default-features = false, path = "../primitives/std" }
+sp-keyring = { default-features = false, path = "../primitives/keyring" }
+sp-io = { default-features = false, path = "../primitives/io" }
+sp-core = { default-features = false, path = "../primitives/core" }
+sp-arithmetic = { default-features = false, path = "../primitives/arithmetic" }
+
+# frame deps
+frame-support = { default-features = false,  path = "./support" }
+frame-system = { default-features = false,  path = "./system" }
+
+[features]
+default = [ "std" ]
+std = [
+	"parity-scale-codec/std",
+	"scale-info/std",
+
+	"sp-api/std",
+	"sp-runtime/std",
+	"sp-std/std",
+
+	"frame-support/std",
+]
+try-runtime = [
+	"frame-support/try-runtime",
+]

frame/src/lib.rs

@@ -0,0 +1,132 @@
+//! # FRAME
+//!
+//! > Substrate's State Transition Function (Runtime) Framework.
+//!
+//!   ______   ______    ________   ___ __ __   ______
+//!  /_____/\ /_____/\  /_______/\ /__//_//_/\ /_____/\
+//!  \::::_\/_\:::_ \ \ \::: _  \ \\::\| \| \ \\::::_\/_
+//!   \:\/___/\\:(_) ) )_\::(_)  \ \\:.      \ \\:\/___/\
+//!    \:::._\/ \: __ `\ \\:: __  \ \\:.\-/\  \ \\::___\/_
+//!     \:\ \    \ \ `\ \ \\:.\ \  \ \\. \  \  \ \\:\____/\
+//!      \_\/     \_\/ \_\/ \__\/\__\/ \__\/ \__\/ \_____\/
+//!
+//!
+//! # Introduction
+//!
+//! Substrate is at a very high level composed of two parts:
+//!
+//! 1. A *runtime* who's representing the state transition function of a blockchain, and is encoded
+//! as a wasm blob.
+//! 2. A client' who's primary purpose is to execute the given runtime.
+//!
+//! FRAME is the primary framework to build a runtime.
+//!
+//! ## Pallets
+//!
+//! ```
+//! use frame::pallet;
+//!
+//! #[pallet::pallet]
+//! mod pallet {
+//!
+//! 	#[pallet::config]
+//! 	pub trait Config: frame_system::Config {}
+//!
+//! 	#[pallet::pallet]
+//! 	pub struct Pallet<T>(_);
+//! }
+//! # fn main() {}
+//! ```
+//!
+//! ## Runtime
+//!
+//! <TODO>
+//!
+//! # This Crate
+//!
+//! This crate is an amalgamation of multiple other crates that are often used together to compose a
+//! pallet. It is not necessary to use it, and it may fall short for certain purposes.
+//!
+//! In short, this crate only re-exports types and traits from multiple sources. All of these
+//! sources are listed (and re-exported again) in [`deps`].
+
+/// export the main pallet macro. This can wrap a `mod pallet` and will transform it into being
+/// a pallet, eg `#[frame::pallet] mod pallet { .. }`.
+pub use frame_support::pallet;
+
+/// A prelude that is suitable to be used inside the
+pub mod prelude {
+	pub use super::macros::*;
+	pub use frame_support::pallet_prelude::*;
+	pub use frame_system::pallet_prelude::*;
+}
+
+/// All macros often used in FRAME pallets.
+pub mod macros {
+	pub use frame_support::{
+		assert_err, assert_err_ignore_postinfo, assert_error_encoded_size, assert_noop, assert_ok,
+		assert_storage_noop, construct_runtime, defensive, defensive_assert, ensure,
+		parameter_types, storage_alias,
+	};
+	pub use sp_runtime::{bounded_btree_map, bounded_vec};
+}
+
+/// All traits often used in FRAME pallets.
+///
+/// Note that types implementing these traits can also be found in this module.
+pub mod traits {
+	pub use frame_support::traits::*;
+	pub use sp_runtime::traits::*;
+}
+
+/// The arithmetic types used for safe math.
+pub mod arithmetic {
+	pub use sp_arithmetic::{traits::*, *};
+}
+
+/// Low level primitive types used in FRAME pallets.
+pub mod primitives {
+	pub use sp_core::{H160, H256, H512, U256, U512};
+	pub use sp_runtime::traits::{BlakeTwo256, Hash, Keccak256};
+}
+
+/// Testing-specific helpers.
+pub mod testing {
+	pub mod prelude {
+		pub use frame_system::mocking::*;
+		pub use sp_io::TestExternalities as TestState;
+	}
+}
+
+/// All derive macros.
+pub mod derive {
+	pub use frame_support::{
+		CloneNoBound, DebugNoBound, DefaultNoBound, EqNoBound, PartialEqNoBound,
+		RuntimeDebugNoBound,
+	};
+	pub use parity_scale_codec::{Decode, Encode};
+	pub use scale_info::TypeInfo;
+	pub use sp_std::fmt::Debug;
+}
+
+/// Access to all of the dependencies of this crate. In case the re-exports are not enough, this
+/// module can be used.
+pub mod deps {
+	pub use frame_support;
+	pub use frame_system;
+	pub use parity_scale_codec;
+	pub use scale_info;
+	pub use sp_api;
+	pub use sp_arithmetic;
+	pub use sp_core;
+	pub use sp_runtime;
+	pub use sp_std;
+}
+
+/// Substrate's specific `std` library. See [`deps::sp_std`].
+pub use sp_std as std;
+
+/// A macro-sub module that contains a list of all pallet macros, with proper documentation. It
+/// enhances IDE experience.
+// TODO: does not seem to work.
+pub use frame_support::pallet_macros as pallet;

primitives/core/src/crypto.rs

@@ -931,8 +931,7 @@ pub trait Pair: CryptoType + Sized + Clone + Send + Sync + 'static {
 	///   - the path may be followed by `///`, in which case everything after the `///` is treated
 	/// as a password.
 	/// - If `s` begins with a `/` character it is prefixed with the Substrate public `DEV_PHRASE`
-	///   and
-	/// interpreted as above.
+	///   and interpreted as above.
 	///
 	/// In this case they are interpreted as HDKD junctions; purely numeric items are interpreted as
 	/// integers, non-numeric items as strings. Junctions prefixed with `/` are interpreted as soft