feat: initialize Kurdistan SDK - independent fork of Polkadot SDK

substrate/client/basic-authorship/Cargo.toml

@@ -0,0 +1,54 @@
+[package]
+name = "sc-basic-authorship"
+version = "0.34.0"
+authors.workspace = true
+edition.workspace = true
+license = "GPL-3.0-or-later WITH Classpath-exception-2.0"
+homepage.workspace = true
+repository.workspace = true
+description = "Basic implementation of block-authoring logic."
+readme = "README.md"
+
+[lints]
+workspace = true
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+
+[dependencies]
+codec = { workspace = true, default-features = true }
+futures = { workspace = true }
+log = { workspace = true, default-features = true }
+prometheus-endpoint = { workspace = true, default-features = true }
+sc-block-builder = { workspace = true, default-features = true }
+sc-proposer-metrics = { workspace = true, default-features = true }
+sc-telemetry = { workspace = true, default-features = true }
+sc-transaction-pool-api = { workspace = true, default-features = true }
+sp-api = { workspace = true, default-features = true }
+sp-blockchain = { workspace = true, default-features = true }
+sp-consensus = { workspace = true, default-features = true }
+sp-core = { workspace = true, default-features = true }
+sp-inherents = { workspace = true, default-features = true }
+sp-runtime = { workspace = true, default-features = true }
+sp-trie = { workspace = true, default-features = true }
+
+[dev-dependencies]
+parking_lot = { workspace = true, default-features = true }
+sc-client-api = { workspace = true, default-features = true }
+sc-transaction-pool = { workspace = true, default-features = true }
+substrate-test-runtime-client = { workspace = true }
+
+[features]
+runtime-benchmarks = [
+	"sc-block-builder/runtime-benchmarks",
+	"sc-client-api/runtime-benchmarks",
+	"sc-transaction-pool-api/runtime-benchmarks",
+	"sc-transaction-pool/runtime-benchmarks",
+	"sp-api/runtime-benchmarks",
+	"sp-blockchain/runtime-benchmarks",
+	"sp-consensus/runtime-benchmarks",
+	"sp-inherents/runtime-benchmarks",
+	"sp-runtime/runtime-benchmarks",
+	"sp-trie/runtime-benchmarks",
+	"substrate-test-runtime-client/runtime-benchmarks",
+]

substrate/client/basic-authorship/README.md

@@ -0,0 +1,31 @@
+Basic implementation of block-authoring logic.
+
+# Example
+
+```rust
+// The first step is to create a `ProposerFactory`.
+let mut proposer_factory = ProposerFactory::new(client.clone(), txpool.clone(), None);
+
+// From this factory, we create a `Proposer`.
+let proposer = proposer_factory.init(
+	&client.header(client.chain_info().genesis_hash).unwrap().unwrap(),
+);
+
+// The proposer is created asynchronously.
+let proposer = futures::executor::block_on(proposer).unwrap();
+
+// This `Proposer` allows us to create a block proposition.
+// The proposer will grab transactions from the transaction pool, and put them into the block.
+let future = proposer.propose(
+	Default::default(),
+	Default::default(),
+	Duration::from_secs(2),
+);
+
+// We wait until the proposition is performed.
+let block = futures::executor::block_on(future).unwrap();
+println!("Generated block: {:?}", block.block);
+```
+
+
+License: GPL-3.0-or-later WITH Classpath-exception-2.0

substrate/client/basic-authorship/src/lib.rs

@@ -0,0 +1,78 @@
+// This file is part of Substrate.
+
+// Copyright (C) Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: GPL-3.0-or-later WITH Classpath-exception-2.0
+
+// This program 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.
+
+// This program 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 this program. If not, see <https://www.gnu.org/licenses/>.
+
+//! Basic implementation of block-authoring logic.
+//!
+//! # Example
+//!
+//! ```
+//! # use sc_basic_authorship::ProposerFactory;
+//! # use sp_consensus::{Environment, Proposer};
+//! # use sp_runtime::generic::BlockId;
+//! # use std::{sync::Arc, time::Duration};
+//! # use substrate_test_runtime_client::{
+//! #     runtime::Transfer, Sr25519Keyring,
+//! #     DefaultTestClientBuilderExt, TestClientBuilderExt,
+//! # };
+//! # use sc_transaction_pool::{BasicPool, FullChainApi};
+//! # let client = Arc::new(substrate_test_runtime_client::new());
+//! # let spawner = sp_core::testing::TaskExecutor::new();
+//! # let txpool = Arc::from(BasicPool::new_full(
+//! #     Default::default(),
+//! #     true.into(),
+//! #     None,
+//! #     spawner.clone(),
+//! #     client.clone(),
+//! # ));
+//! // The first step is to create a `ProposerFactory`.
+//! let mut proposer_factory = ProposerFactory::new(
+//! 		spawner,
+//! 		client.clone(),
+//! 		txpool.clone(),
+//! 		None,
+//! 		None,
+//! 	);
+//!
+//! // From this factory, we create a `Proposer`.
+//! let proposer = proposer_factory.init(
+//! 	&client.header(client.chain_info().genesis_hash).unwrap().unwrap(),
+//! );
+//!
+//! // The proposer is created asynchronously.
+//! let proposer = futures::executor::block_on(proposer).unwrap();
+//!
+//! // This `Proposer` allows us to create a block proposition.
+//! // The proposer will grab transactions from the transaction pool, and put them into the block.
+//! let future = Proposer::propose(
+//! 	proposer,
+//! 	Default::default(),
+//! 	Default::default(),
+//! 	Duration::from_secs(2),
+//! 	None,
+//! );
+//!
+//! // We wait until the proposition is performed.
+//! let block = futures::executor::block_on(future).unwrap();
+//! println!("Generated block: {:?}", block.block);
+//! ```
+
+mod basic_authorship;
+
+pub use crate::basic_authorship::{
+	ProposeArgs, Proposer, ProposerFactory, DEFAULT_BLOCK_SIZE_LIMIT,
+};