feat: Rebrand Polkadot/Substrate references to PezkuwiChain

This commit systematically rebrands various references from Parity Technologies'
Polkadot/Substrate ecosystem to PezkuwiChain within the kurdistan-sdk.

Key changes include:
- Updated external repository URLs (zombienet-sdk, parity-db, parity-scale-codec, wasm-instrument) to point to pezkuwichain forks.
- Modified internal documentation and code comments to reflect PezkuwiChain naming and structure.
- Replaced direct references to  with  or specific paths within the  for XCM, Pezkuwi, and other modules.
- Cleaned up deprecated  issue and PR references in various  and  files, particularly in  and  modules.
- Adjusted image and logo URLs in documentation to point to PezkuwiChain assets.
- Removed or rephrased comments related to external Polkadot/Substrate PRs and issues.

This is a significant step towards fully customizing the SDK for the PezkuwiChain ecosystem.

bizinikiwi/pezframe/examples/single-block-migrations/src/lib.rs

@@ -0,0 +1,222 @@
+// This file is part of Bizinikiwi.
+
+// Copyright (C) Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: MIT-0
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy of
+// this software and associated documentation files (the "Software"), to deal in
+// the Software without restriction, including without limitation the rights to
+// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+// of the Software, and to permit persons to whom the Software is furnished to do
+// so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+//! # Single Block Migration Example Pallet
+//!
+//! An example pallet demonstrating best-practices for writing single-block migrations in the
+//! context of upgrading pallet storage.
+//!
+//! ## Forewarning
+//!
+//! Single block migrations **MUST** execute in a single block, therefore when executed on a
+//! teyrchain are only appropriate when guaranteed to not exceed block weight limits. If a
+//! teyrchain submits a block that exceeds the block weight limit it will **brick the chain**!
+//!
+//! If weight is a concern or you are not sure which type of migration to use, you should probably
+//! use a multi-block migration.
+//!
+//! TODO: Link above to multi-block migration example.
+//!
+//! ## Pallet Overview
+//!
+//! This example pallet contains a single storage item [`Value`](pallet::Value), which may be set by
+//! any signed origin by calling the [`set_value`](crate::Call::set_value) extrinsic.
+//!
+//! For the purposes of this exercise, we imagine that in [`StorageVersion`] V0 of this pallet
+//! [`Value`](pallet::Value) is a `u32`, and this what is currently stored on-chain.
+//!
+//! ```ignore
+//! // (Old) Storage Version V0 representation of `Value`
+//! #[pallet::storage]
+//! pub type Value<T: Config> = StorageValue<_, u32>;
+//! ```
+//!
+//! In [`StorageVersion`] V1 of the pallet a new struct [`CurrentAndPreviousValue`] is introduced:
+#![doc = docify::embed!("src/lib.rs", CurrentAndPreviousValue)]
+//! and [`Value`](pallet::Value) is updated to store this new struct instead of a `u32`:
+#![doc = docify::embed!("src/lib.rs", Value)]
+//!
+//! In StorageVersion V1 of the pallet when [`set_value`](crate::Call::set_value) is called, the
+//! new value is stored in the `current` field of [`CurrentAndPreviousValue`], and the previous
+//! value (if it exists) is stored in the `previous` field.
+#![doc = docify::embed!("src/lib.rs", pezpallet_calls)]
+//!
+//! ## Why a migration is necessary
+//!
+//! Without a migration, there will be a discrepancy between the on-chain storage for [`Value`] (in
+//! V0 it is a `u32`) and the current storage for [`Value`] (in V1 it was changed to a
+//! [`CurrentAndPreviousValue`] struct).
+//!
+//! The on-chain storage for [`Value`] would be a `u32` but the runtime would try to read it as a
+//! [`CurrentAndPreviousValue`]. This would result in unacceptable undefined behavior.
+//!
+//! ## Adding a migration module
+//!
+//! Writing a pallets migrations in a separate module is strongly recommended.
+//!
+//! Here's how the migration module is defined for this pallet:
+//!
+//! ```text
+//! bizinikiwi/pezframe/examples/single-block-migrations/src/
+//! ├── lib.rs       <-- pallet definition
+//! ├── Cargo.toml   <-- pallet manifest
+//! └── migrations/
+//!    ├── mod.rs    <-- migrations module definition
+//!    └── v1.rs     <-- migration logic for the V0 to V1 transition
+//! ```
+//!
+//! This structure allows keeping migration logic separate from the pallet logic and
+//! easily adding new migrations in the future.
+//!
+//! ## Writing the Migration
+//!
+//! All code related to the migration can be found under
+//! [`v1.rs`](migrations::v1).
+//!
+//! See the migration source code for detailed comments.
+//!
+//! Here's a brief overview of modules and types defined in `v1.rs`:
+//!
+//! ### `mod v0`
+//!
+//! Here we define a [`storage_alias`](pezframe_support::storage_alias) for the old v0 [`Value`]
+//! format.
+//!
+//! This allows reading the old v0 value from storage during the migration.
+//!
+//! ### `InnerMigrateV0ToV1`
+//!
+//! Here we define our raw migration logic,
+//! `InnerMigrateV0ToV1` which implements the [`UncheckedOnRuntimeUpgrade`] trait.
+//!
+//! #### Why [`UncheckedOnRuntimeUpgrade`]?
+//!
+//! Otherwise, we would have two implementations of [`OnRuntimeUpgrade`] which could be confusing,
+//! and may lead to accidentally using the wrong one.
+//!
+//! #### Standalone Struct or Pallet Hook?
+//!
+//! Note that the storage migration logic is attached to a standalone struct implementing
+//! [`UncheckedOnRuntimeUpgrade`], rather than implementing the
+//! [`Hooks::on_runtime_upgrade`](pezframe_support::traits::Hooks::on_runtime_upgrade) hook directly on
+//! the pallet. The pallet hook is better suited for special types of logic that need to execute on
+//! every runtime upgrade, but not so much for one-off storage migrations.
+//!
+//! ### `MigrateV0ToV1`
+//!
+//! Here, `InnerMigrateV0ToV1` is wrapped in a
+//! [`VersionedMigration`] to define
+//! [`MigrateV0ToV1`](crate::migrations::v1::MigrateV0ToV1), which may be used
+//! in runtimes.
+//!
+//! Using [`VersionedMigration`] ensures that
+//! - The migration only runs once when the on-chain storage version is `0`
+//! - The on-chain storage version is updated to `1` after the migration executes
+//! - Reads and writes from checking and setting the on-chain storage version are accounted for in
+//!   the final [`Weight`](pezframe_support::weights::Weight)
+//!
+//! ### `mod test`
+//!
+//! Here basic unit tests are defined for the migration.
+//!
+//! When writing migration tests, don't forget to check:
+//! - `on_runtime_upgrade` returns the expected weight
+//! - `post_upgrade` succeeds when given the bytes returned by `pre_upgrade`
+//! - Pallet storage is in the expected state after the migration
+//!
+//! [`VersionedMigration`]: pezframe_support::migrations::VersionedMigration
+//! [`GetStorageVersion`]: pezframe_support::traits::GetStorageVersion
+//! [`OnRuntimeUpgrade`]: pezframe_support::traits::OnRuntimeUpgrade
+//! [`UncheckedOnRuntimeUpgrade`]: pezframe_support::traits::UncheckedOnRuntimeUpgrade
+//! [`MigrateV0ToV1`]: crate::migrations::v1::MigrateV0ToV1
+
+// We make sure this pallet uses `no_std` for compiling to Wasm.
+#![cfg_attr(not(feature = "std"), no_std)]
+// allow non-camel-case names for storage version V0 value
+#![allow(non_camel_case_types)]
+
+// Re-export pallet items so that they can be accessed from the crate namespace.
+pub use pallet::*;
+
+// Export migrations so they may be used in the runtime.
+pub mod migrations;
+#[doc(hidden)]
+mod mock;
+
+extern crate alloc;
+
+use codec::{Decode, Encode, MaxEncodedLen};
+use pezframe_support::traits::StorageVersion;
+use pezsp_runtime::RuntimeDebug;
+
+/// Example struct holding the most recently set [`u32`] and the
+/// second most recently set [`u32`] (if one existed).
+#[docify::export]
+#[derive(
+	Clone, Eq, PartialEq, Encode, Decode, RuntimeDebug, scale_info::TypeInfo, MaxEncodedLen,
+)]
+pub struct CurrentAndPreviousValue {
+	/// The most recently set value.
+	pub current: u32,
+	/// The previous value, if one existed.
+	pub previous: Option<u32>,
+}
+
+// Pallet for demonstrating storage migrations.
+#[pezframe_support::pallet(dev_mode)]
+pub mod pallet {
+	use super::*;
+	use pezframe_support::pezpallet_prelude::*;
+	use pezframe_system::pezpallet_prelude::*;
+
+	/// Define the current [`StorageVersion`] of the pallet.
+	const STORAGE_VERSION: StorageVersion = StorageVersion::new(1);
+
+	#[pallet::pallet]
+	#[pallet::storage_version(STORAGE_VERSION)]
+	pub struct Pallet<T>(_);
+
+	#[pallet::config]
+	pub trait Config: pezframe_system::Config {}
+
+	/// [`StorageVersion`] V1 of [`Value`].
+	///
+	/// Currently used.
+	#[docify::export]
+	#[pallet::storage]
+	pub type Value<T: Config> = StorageValue<_, CurrentAndPreviousValue>;
+
+	#[docify::export(pezpallet_calls)]
+	#[pallet::call]
+	impl<T: Config> Pallet<T> {
+		pub fn set_value(origin: OriginFor<T>, value: u32) -> DispatchResult {
+			ensure_signed(origin)?;
+
+			let previous = Value::<T>::get().map(|v| v.current);
+			let new_struct = CurrentAndPreviousValue { current: value, previous };
+			<Value<T>>::put(new_struct);
+
+			Ok(())
+		}
+	}
+}

bizinikiwi/pezframe/examples/single-block-migrations/src/migrations/mod.rs

@@ -0,0 +1,26 @@
+// This file is part of Bizinikiwi.
+
+// Copyright (C) Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: MIT-0
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy of
+// this software and associated documentation files (the "Software"), to deal in
+// the Software without restriction, including without limitation the rights to
+// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+// of the Software, and to permit persons to whom the Software is furnished to do
+// so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+/// Module containing all logic associated with the example migration from
+/// [`StorageVersion`](pezframe_support::traits::StorageVersion) V0 to V1.
+pub mod v1;

bizinikiwi/pezframe/examples/single-block-migrations/src/migrations/v1.rs

@@ -0,0 +1,202 @@
+// This file is part of Bizinikiwi.
+
+// Copyright (C) Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: MIT-0
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy of
+// this software and associated documentation files (the "Software"), to deal in
+// the Software without restriction, including without limitation the rights to
+// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+// of the Software, and to permit persons to whom the Software is furnished to do
+// so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+use pezframe_support::{
+	storage_alias,
+	traits::{Get, UncheckedOnRuntimeUpgrade},
+};
+
+#[cfg(feature = "try-runtime")]
+use alloc::vec::Vec;
+
+/// Collection of storage item formats from the previous storage version.
+///
+/// Required so we can read values in the v0 storage format during the migration.
+mod v0 {
+	use super::*;
+
+	/// V0 type for [`crate::Value`].
+	#[storage_alias]
+	pub type Value<T: crate::Config> = StorageValue<crate::Pallet<T>, u32>;
+}
+
+/// Implements [`UncheckedOnRuntimeUpgrade`], migrating the state of this pallet from V0 to V1.
+///
+/// In V0 of the template [`crate::Value`] is just a `u32`. In V1, it has been upgraded to
+/// contain the struct [`crate::CurrentAndPreviousValue`].
+///
+/// In this migration, update the on-chain storage for the pallet to reflect the new storage
+/// layout.
+pub struct InnerMigrateV0ToV1<T: crate::Config>(core::marker::PhantomData<T>);
+
+impl<T: crate::Config> UncheckedOnRuntimeUpgrade for InnerMigrateV0ToV1<T> {
+	/// Return the existing [`crate::Value`] so we can check that it was correctly set in
+	/// `InnerMigrateV0ToV1::post_upgrade`.
+	#[cfg(feature = "try-runtime")]
+	fn pre_upgrade() -> Result<Vec<u8>, pezsp_runtime::TryRuntimeError> {
+		use codec::Encode;
+
+		// Access the old value using the `storage_alias` type
+		let old_value = v0::Value::<T>::get();
+		// Return it as an encoded `Vec<u8>`
+		Ok(old_value.encode())
+	}
+
+	/// Migrate the storage from V0 to V1.
+	///
+	/// - If the value doesn't exist, there is nothing to do.
+	/// - If the value exists, it is read and then written back to storage inside a
+	///   [`crate::CurrentAndPreviousValue`].
+	fn on_runtime_upgrade() -> pezframe_support::weights::Weight {
+		// Read the old value from storage
+		if let Some(old_value) = v0::Value::<T>::take() {
+			// Write the new value to storage
+			let new = crate::CurrentAndPreviousValue { current: old_value, previous: None };
+			crate::Value::<T>::put(new);
+			// One read + write for taking the old value, and one write for setting the new value
+			T::DbWeight::get().reads_writes(1, 2)
+		} else {
+			// No writes since there was no old value, just one read for checking
+			T::DbWeight::get().reads(1)
+		}
+	}
+
+	/// Verifies the storage was migrated correctly.
+	///
+	/// - If there was no old value, the new value should not be set.
+	/// - If there was an old value, the new value should be a [`crate::CurrentAndPreviousValue`].
+	#[cfg(feature = "try-runtime")]
+	fn post_upgrade(state: Vec<u8>) -> Result<(), pezsp_runtime::TryRuntimeError> {
+		use codec::Decode;
+		use pezframe_support::ensure;
+
+		let maybe_old_value = Option::<u32>::decode(&mut &state[..]).map_err(|_| {
+			pezsp_runtime::TryRuntimeError::Other("Failed to decode old value from storage")
+		})?;
+
+		match maybe_old_value {
+			Some(old_value) => {
+				let expected_new_value =
+					crate::CurrentAndPreviousValue { current: old_value, previous: None };
+				let actual_new_value = crate::Value::<T>::get();
+
+				ensure!(actual_new_value.is_some(), "New value not set");
+				ensure!(
+					actual_new_value == Some(expected_new_value),
+					"New value not set correctly"
+				);
+			},
+			None => {
+				ensure!(crate::Value::<T>::get().is_none(), "New value unexpectedly set");
+			},
+		};
+		Ok(())
+	}
+}
+
+/// [`UncheckedOnRuntimeUpgrade`] implementation [`InnerMigrateV0ToV1`] wrapped in a
+/// [`VersionedMigration`](pezframe_support::migrations::VersionedMigration), which ensures that:
+/// - The migration only runs once when the on-chain storage version is 0
+/// - The on-chain storage version is updated to `1` after the migration executes
+/// - Reads/Writes from checking/settings the on-chain storage version are accounted for
+pub type MigrateV0ToV1<T> = pezframe_support::migrations::VersionedMigration<
+	0, // The migration will only execute when the on-chain storage version is 0
+	1, // The on-chain storage version will be set to 1 after the migration is complete
+	InnerMigrateV0ToV1<T>,
+	crate::pallet::Pallet<T>,
+	<T as pezframe_system::Config>::DbWeight,
+>;
+
+/// Tests for our migration.
+///
+/// When writing migration tests, it is important to check:
+/// 1. `on_runtime_upgrade` returns the expected weight
+/// 2. `post_upgrade` succeeds when given the bytes returned by `pre_upgrade`
+/// 3. The storage is in the expected state after the migration
+#[cfg(any(all(feature = "try-runtime", test), doc))]
+mod test {
+	use self::InnerMigrateV0ToV1;
+	use super::*;
+	use crate::mock::{new_test_ext, MockRuntime};
+	use pezframe_support::assert_ok;
+
+	#[test]
+	fn handles_no_existing_value() {
+		new_test_ext().execute_with(|| {
+			// By default, no value should be set. Verify this assumption.
+			assert!(crate::Value::<MockRuntime>::get().is_none());
+			assert!(v0::Value::<MockRuntime>::get().is_none());
+
+			// Get the pre_upgrade bytes
+			let bytes = match InnerMigrateV0ToV1::<MockRuntime>::pre_upgrade() {
+				Ok(bytes) => bytes,
+				Err(e) => panic!("pre_upgrade failed: {e:?}"),
+			};
+
+			// Execute the migration
+			let weight = InnerMigrateV0ToV1::<MockRuntime>::on_runtime_upgrade();
+
+			// Verify post_upgrade succeeds
+			assert_ok!(InnerMigrateV0ToV1::<MockRuntime>::post_upgrade(bytes));
+
+			// The weight should be just 1 read for trying to access the old value.
+			assert_eq!(weight, <MockRuntime as pezframe_system::Config>::DbWeight::get().reads(1));
+
+			// After the migration, no value should have been set.
+			assert!(crate::Value::<MockRuntime>::get().is_none());
+		})
+	}
+
+	#[test]
+	fn handles_existing_value() {
+		new_test_ext().execute_with(|| {
+			// Set up an initial value
+			let initial_value = 42;
+			v0::Value::<MockRuntime>::put(initial_value);
+
+			// Get the pre_upgrade bytes
+			let bytes = match InnerMigrateV0ToV1::<MockRuntime>::pre_upgrade() {
+				Ok(bytes) => bytes,
+				Err(e) => panic!("pre_upgrade failed: {e:?}"),
+			};
+
+			// Execute the migration
+			let weight = InnerMigrateV0ToV1::<MockRuntime>::on_runtime_upgrade();
+
+			// Verify post_upgrade succeeds
+			assert_ok!(InnerMigrateV0ToV1::<MockRuntime>::post_upgrade(bytes));
+
+			// The weight used should be 1 read for the old value, and 1 write for the new
+			// value.
+			assert_eq!(
+				weight,
+				<MockRuntime as pezframe_system::Config>::DbWeight::get().reads_writes(1, 2)
+			);
+
+			// After the migration, the new value should be set as the `current` value.
+			let expected_new_value =
+				crate::CurrentAndPreviousValue { current: initial_value, previous: None };
+			assert_eq!(crate::Value::<MockRuntime>::get(), Some(expected_new_value));
+		})
+	}
+}

bizinikiwi/pezframe/examples/single-block-migrations/src/mock.rs

@@ -0,0 +1,64 @@
+// This file is part of Bizinikiwi.
+
+// Copyright (C) Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: MIT-0
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy of
+// this software and associated documentation files (the "Software"), to deal in
+// the Software without restriction, including without limitation the rights to
+// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+// of the Software, and to permit persons to whom the Software is furnished to do
+// so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+#![cfg(any(all(feature = "try-runtime", test), doc))]
+
+use crate::*;
+use pezframe_support::{derive_impl, weights::constants::ParityDbWeight};
+
+// Re-export crate as its pallet name for construct_runtime.
+use crate as pezpallet_example_storage_migration;
+
+type Block = pezframe_system::mocking::MockBlock<MockRuntime>;
+
+// For testing the pallet, we construct a mock runtime.
+pezframe_support::construct_runtime!(
+	pub struct MockRuntime {
+		System: pezframe_system::{Pallet, Call, Config<T>, Storage, Event<T>},
+		Balances: pezpallet_balances::{Pallet, Call, Storage, Config<T>, Event<T>},
+		Example: pezpallet_example_storage_migration::{Pallet, Call, Storage},
+	}
+);
+
+#[derive_impl(pezframe_system::config_preludes::TestDefaultConfig)]
+impl pezframe_system::Config for MockRuntime {
+	type Block = Block;
+	type AccountData = pezpallet_balances::AccountData<u64>;
+	type DbWeight = ParityDbWeight;
+}
+
+#[derive_impl(pezpallet_balances::config_preludes::TestDefaultConfig)]
+impl pezpallet_balances::Config for MockRuntime {
+	type AccountStore = System;
+}
+
+impl Config for MockRuntime {}
+
+pub fn new_test_ext() -> pezsp_io::TestExternalities {
+	use pezsp_runtime::BuildStorage;
+
+	let t = RuntimeGenesisConfig { system: Default::default(), balances: Default::default() }
+		.build_storage()
+		.unwrap();
+	t.into()
+}