feat: add collator peer ID to ParachainInherentData

cumulus/client/parachain-inherent/src/lib.rs

@@ -208,6 +208,7 @@ impl ParachainInherentDataProvider {
 			validation_data: validation_data.clone(),
 			relay_chain_state,
 			relay_parent_descendants,
+			collator_peer_id: None,
 		})
 	}
 }

cumulus/client/parachain-inherent/src/mock.rs

@@ -241,6 +241,7 @@ impl<R: Send + Sync + GenerateRandomness<u64>> InherentDataProvider
 			horizontal_messages,
 			relay_chain_state: proof,
 			relay_parent_descendants: Default::default(),
+			collator_peer_id: None,
 		};
 
 		parachain_inherent_data.provide_inherent_data(inherent_data).await

cumulus/pallets/parachain-system/src/lib.rs

@@ -639,6 +639,7 @@ pub mod pallet {
 				downward_messages,
 				horizontal_messages,
 				relay_parent_descendants,
+				collator_peer_id: _,
 			} = data;
 
 			// Check that the associated relay chain block number is as expected.

cumulus/parachains/runtimes/test-utils/src/lib.rs

@@ -347,6 +347,7 @@ where
 				downward_messages: Default::default(),
 				horizontal_messages: Default::default(),
 				relay_parent_descendants: Default::default(),
+				collator_peer_id: None,
 			};
 
 			let _ = cumulus_pallet_parachain_system::Pallet::<Runtime>::set_validation_data(
@@ -710,6 +711,7 @@ pub fn mock_open_hrmp_channel<
 			downward_messages: Default::default(),
 			horizontal_messages: Default::default(),
 			relay_parent_descendants: Default::default(),
+			collator_peer_id: None,
 		};
 		inherent_data
 			.put_data(

cumulus/primitives/parachain-inherent/src/lib.rs

@@ -30,7 +30,9 @@
 extern crate alloc;
 
 use cumulus_primitives_core::{
-	relay_chain::{BlakeTwo256, Hash as RelayHash, HashT as _, Header as RelayHeader},
+	relay_chain::{
+		vstaging::ApprovedPeerId, BlakeTwo256, Hash as RelayHash, HashT as _, Header as RelayHeader,
+	},
 	InboundDownwardMessage, InboundHrmpMessage, ParaId, PersistedValidationData,
 };
 
@@ -44,7 +46,7 @@ pub const INHERENT_IDENTIFIER: InherentIdentifier = *b"sysi1338";
 
 /// Legacy ParachainInherentData that is kept around for backward compatibility.
 /// Can be removed once we can safely assume that parachain nodes provide the
-/// `relay_parent_descendants` field.
+/// `relay_parent_descendants` and `collator_peer_id` fields.
 pub mod v0 {
 	use alloc::{collections::BTreeMap, vec::Vec};
 	use cumulus_primitives_core::{
@@ -115,6 +117,9 @@ pub struct ParachainInherentData {
 	/// This information is used to ensure that a parachain node builds blocks
 	/// at a specified offset from the chain tip rather than directly at the tip.
 	pub relay_parent_descendants: Vec<RelayHeader>,
+	/// Contains the collator peer ID, which is later sent by the parachain to the
+	/// relay chain via a UMP signal to promote the reputation of the given peer ID.
+	pub collator_peer_id: Option<ApprovedPeerId>,
 }
 
 // Upgrades the ParachainInherentData v0 to the newest format.
@@ -126,6 +131,7 @@ impl Into<ParachainInherentData> for v0::ParachainInherentData {
 			downward_messages: self.downward_messages,
 			horizontal_messages: self.horizontal_messages,
 			relay_parent_descendants: Vec::new(),
+			collator_peer_id: None,
 		}
 	}
 }

cumulus/test/client/src/block_builder.rs

@@ -123,6 +123,7 @@ fn init_block_builder(
 				downward_messages: Default::default(),
 				horizontal_messages: Default::default(),
 				relay_parent_descendants: Default::default(),
+				collator_peer_id: None,
 			},
 		)
 		.expect("Put validation function params failed");

cumulus/test/service/src/bench_utils.rs

@@ -99,6 +99,7 @@ pub fn extrinsic_set_validation_data(
 		downward_messages: Default::default(),
 		horizontal_messages: Default::default(),
 		relay_parent_descendants: Default::default(),
+		collator_peer_id: None,
 	};
 
 	cumulus_test_runtime::UncheckedExtrinsic::new_bare(

cumulus/xcm/xcm-emulator/src/lib.rs

@@ -1200,6 +1200,7 @@ macro_rules! decl_test_networks {
 						downward_messages: Default::default(),
 						horizontal_messages: Default::default(),
 						relay_parent_descendants: Default::default(),
+						collator_peer_id: None,
 					}
 				}
 			}

prdoc/pr_8708.prdoc

@@ -0,0 +1,21 @@
+title: "feat: add collator peer ID to ParachainInherentData"
+
+doc:
+  - audience: Runtime Dev
+    description: |
+      Adds an optional `collator_peer_id` field to the new version of `ParachainInherentData`
+      introduced in PR #8299. The field is currently unused and defaults to `None`, but is
+      included proactively to avoid creating another inherent data version in the future.
+      This sets the stage for sending collator peer IDs via UMP signals in upcoming work.
+
+crates:
+  - name: cumulus-client-parachain-inherent
+    bump: patch
+  - name: cumulus-client-parachain-inherent
+    bump: patch
+  - name: parachains-runtimes-test-utils
+    bump: patch
+  - name: cumulus-primitives-parachain-inherent
+    bump: patch
+  - name: xcm-emulator
+    bump: patch