Optimistic Project Funding

Cargo.toml

@@ -338,6 +338,7 @@ members = [
 	"substrate/frame/core-fellowship",
 	"substrate/frame/delegated-staking",
 	"substrate/frame/democracy",
+	"substrate/frame/distribution",
 	"substrate/frame/election-provider-multi-phase",
 	"substrate/frame/election-provider-multi-phase/test-staking-e2e",
 	"substrate/frame/election-provider-support",
@@ -903,6 +904,7 @@ pallet-default-config-example = { path = "substrate/frame/examples/default-confi
 pallet-delegated-staking = { path = "substrate/frame/delegated-staking", default-features = false }
 pallet-democracy = { path = "substrate/frame/democracy", default-features = false }
 pallet-dev-mode = { path = "substrate/frame/examples/dev-mode", default-features = false }
+pallet-distribution = { path = "substrate/frame/distribution", default-features = false }
 pallet-election-provider-multi-phase = { path = "substrate/frame/election-provider-multi-phase", default-features = false }
 pallet-election-provider-support-benchmarking = { path = "substrate/frame/election-provider-support/benchmarking", default-features = false }
 pallet-elections-phragmen = { path = "substrate/frame/elections-phragmen", default-features = false }
@@ -940,6 +942,7 @@ pallet-nomination-pools-benchmarking = { path = "substrate/frame/nomination-pool
 pallet-nomination-pools-runtime-api = { path = "substrate/frame/nomination-pools/runtime-api", default-features = false }
 pallet-offences = { path = "substrate/frame/offences", default-features = false }
 pallet-offences-benchmarking = { path = "substrate/frame/offences/benchmarking", default-features = false }
+pallet-opf = { path = "substrate/frame/opf", default-features = false }
 pallet-paged-list = { path = "substrate/frame/paged-list", default-features = false }
 pallet-parachain-template = { path = "templates/parachain/pallets/template", default-features = false }
 pallet-parameters = { path = "substrate/frame/parameters", default-features = false }

docs/sdk/Cargo.toml

@@ -91,6 +91,8 @@ pallet-scheduler = { workspace = true, default-features = true }
 pallet-referenda = { workspace = true, default-features = true }
 pallet-broker = { workspace = true, default-features = true }
 pallet-babe = { workspace = true, default-features = true }
+pallet-distribution = { workspace = true, default-features = true }
+pallet-opf = { workspace = true, default-features = true }
 
 # Primitives
 sp-io = { workspace = true, default-features = true }

prdoc/pr_5162.prdoc

@@ -0,0 +1,18 @@
+# Schema: Polkadot SDK PRDoc Schema (prdoc) v1.0.0
+# See doc at https://raw.githubusercontent.com/paritytech/polkadot-sdk/master/prdoc/schema_user.json
+
+title: "Optimistic Project Funding"
+
+doc:
+  - audience: Runtime Dev
+    description: |
+      the combination of the OPF pallet and the DISTRIBUTION pallet handles the Optimistic Project Funding. 
+      It allows users to nominate projects (whitelisted in OpenGov) with their DOT. This mechanism will be funded with a constant stream of DOT taken directly from inflation and distributed to projects based on the proportion of DOT that has nominated them.
+      The project rewards distribution is handled by the **Distribution Pallet**
+      The user’s conviction has not been implemented in this first pallet iteration.
+
+crates:
+  - name: pallet-distribution
+    bump: patch
+  - name: pallet-opf
+    bump: patch

substrate/bin/node/runtime/src/lib.rs

@@ -2143,6 +2143,62 @@ impl pallet_broker::Config for Runtime {
 	type PriceAdapter = pallet_broker::CenterTargetPrice<Balance>;
 }
 
+
+parameter_types! {
+	// Id of the treasury
+	pub const PotId: PalletId = PalletId(*b"py/potid");
+
+	// Time needed after approval to unlock the reward claim
+	pub const Period:BlockNumber = 5*MINUTES;
+
+	// Maximum number of whitelisted projects
+	pub const MaxProjects:u32 = 50;
+
+	pub const EpochDurationBlocks: BlockNumber = EPOCH_DURATION_IN_BLOCKS;
+
+}
+impl pallet_distribution::Config for Runtime {
+	type RuntimeEvent = RuntimeEvent;
+
+	type NativeBalance = Balances;
+
+	/// Pot PalletId
+	type PotId = PotId;
+
+	/// A reason for placing a hold on funds.
+	type RuntimeHoldReason = RuntimeHoldReason;
+
+	/// This the minimum required time period between project whitelisting
+	/// and payment/reward_claim from the treasury.
+	type BufferPeriod = Period;
+
+	/// Maximum number of whitelisted projects
+	type MaxProjects = MaxProjects;
+
+	/// Epoch duration in blocks
+	type EpochDurationBlocks = EpochDurationBlocks;
+
+	type BlockNumberProvider = System;
+
+	type WeightInfo = pallet_distribution::weights::SubstrateWeight<Runtime>;
+}
+
+parameter_types!{	
+	pub const MaxWhitelistedProjects: u32 = 64;
+	pub const TemporaryRewards: Balance = 100000 * DOLLARS;
+	pub const TotalPeriod:BlockNumber = 30 * DAYS;
+	pub const LockPeriod:BlockNumber = 10 * DAYS;
+}
+impl pallet_opf::Config for Runtime {
+	type RuntimeEvent = RuntimeEvent;
+	type VoteLockingPeriod = LockPeriod;
+	type VotingPeriod = TotalPeriod;
+	type MaxWhitelistedProjects = MaxWhitelistedProjects;
+	type TemporaryRewards = TemporaryRewards;
+	type WeightInfo = pallet_opf::weights::SubstrateWeight<Runtime>;
+}
+
+
 parameter_types! {
 	pub const MixnetNumCoverToCurrentBlocks: BlockNumber = 3;
 	pub const MixnetNumRequestsToCurrentBlocks: BlockNumber = 3;
@@ -2482,6 +2538,12 @@ mod runtime {
 
 	#[runtime::pallet_index(79)]
 	pub type AssetConversionMigration = pallet_asset_conversion_ops::Pallet<Runtime>;
+
+	#[runtime::pallet_index(80)]
+	pub type Distribution = pallet_distribution::Pallet<Runtime>;
+
+	#[runtime::pallet_index(81)]
+	pub type OptimisticProjectFunding = pallet_opf::Pallet<Runtime>;
 }
 
 /// The address format for describing accounts.
@@ -2645,6 +2707,8 @@ mod benches {
 		[pallet_safe_mode, SafeMode]
 		[pallet_example_mbm, PalletExampleMbms]
 		[pallet_asset_conversion_ops, AssetConversionMigration]
+		[pallet_distribution, Distribution]
+		[pallet_opf, OptimisticProjectFunding]
 	);
 }
 

substrate/frame/distribution/Cargo.toml

@@ -0,0 +1,67 @@
+[package]
+name = "pallet-distribution"
+version = "0.1.0"
+authors.workspace = true
+edition.workspace = true
+license = "Apache-2.0"
+homepage = "https://substrate.io"
+repository.workspace = true
+description = "FRAME pallet to distribute funds to whitelisted projects"
+readme = "README.md"
+
+[lints]
+workspace = true
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+
+[dependencies]
+codec = { workspace = true, default-features = false }
+log = { workspace = true }
+scale-info = { features = ["derive"], workspace = true , default-features = false }
+frame-benchmarking = { optional = true, workspace = true , default-features = false }
+frame-support = { workspace = true , default-features = false }
+frame-system = { workspace = true , default-features = false }
+sp-io = { workspace = true , default-features = false }
+sp-runtime = { workspace = true , default-features = false }
+sp-core = { workspace = true , default-features = false }
+
+pallet-assets = { workspace = true, default-features = false }
+pallet-balances = { workspace = true, default-features = false }
+pallet-timestamp = { workspace = true, default-features = false }
+pallet-sudo = { workspace = true, default-features = false }
+pallet-transaction-payment = { workspace = true, default-features = false }
+pallet-transaction-payment-rpc-runtime-api = { workspace = true, default-features = false }
+
+[features]
+default = ["std"]
+std = [
+	"codec/std",
+	"frame-benchmarking?/std",
+	"log/std",
+	"scale-info/std",
+	"frame-support/std",
+	"frame-system/std",
+	"pallet-balances/std",
+	"pallet-timestamp/std",
+	"pallet-sudo/std",
+	"pallet-transaction-payment-rpc-runtime-api/std",
+	"pallet-transaction-payment/std",
+	"pallet-assets/std",
+	"sp-core/std",
+	"sp-io/std",
+	"sp-runtime/std",
+]
+runtime-benchmarks = [
+	"frame-benchmarking/runtime-benchmarks",
+	"frame-support/runtime-benchmarks",
+	"frame-system/runtime-benchmarks",
+	"pallet-balances/runtime-benchmarks",
+	"sp-runtime/runtime-benchmarks",
+]
+try-runtime = [
+	"frame-support/try-runtime",
+	"frame-system/try-runtime",
+	"pallet-balances/try-runtime",
+	"sp-runtime/try-runtime",
+]

substrate/frame/distribution/README.md

@@ -0,0 +1,30 @@
+# Distribution Pallet
+## Overview
+
+The **Distribution Pallet** handles the distribution of whitelisted projects rewards.
+
+For now only one reward distribution pattern has been implemented, but the pallet could be extended
+to offer to the user claiming rewards for a project, a choice between more than one distribution pattern.
+
+The **Distribution Pallet** receives a list of Whitelisted/Nominated Projects with
+their respective calculated rewards. For each project, it will create a corresponding 
+spending that will be stored until the project reward can be claimed. At the moment, the reward claim period start corresponds to: [beginning of an ***Epoch_Block*** + ***BufferPeriod***] (The ***BufferPeriod*** can be configured in the runtime).
+
+
+### Terminology
+
+- **PotId:** Pot containing the funds used to pay the rewards.
+- **BufferPeriod:** minimum required buffer time period between project nomination and reward claim.
+## Interface
+
+### Dispatchable Functions
+
+#### Public
+
+These calls can be made from any externally held account capable of creating
+a signed extrinsic.
+
+Basic actions:
+- `claim_reward_for` - From this extrinsic any user can claim a reward for a nominated/whitelisted project.
+
+License: Apache-2.0