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.
This commit is contained in:
2025-12-14 00:04:10 +03:00
parent 286de54384
commit 1c0e57d984
9084 changed files with 997839 additions and 997557 deletions
@@ -0,0 +1,79 @@
[package]
name = "pezpallet-root-offences"
version = "25.0.0"
authors.workspace = true
edition.workspace = true
license = "Apache-2.0"
homepage.workspace = true
repository.workspace = true
description = "FRAME root offences pallet"
readme = "README.md"
[lints]
workspace = true
[package.metadata.docs.rs]
targets = ["x86_64-unknown-linux-gnu"]
[dependencies]
codec = { features = ["derive"], workspace = true }
scale-info = { features = ["derive"], workspace = true }
pezpallet-session = { features = ["historical"], workspace = true }
pezpallet-staking = { workspace = true }
pezframe-support = { workspace = true }
pezframe-system = { workspace = true }
pezsp-core = { workspace = true }
pezsp-runtime = { workspace = true }
pezsp-staking = { workspace = true }
[dev-dependencies]
pezpallet-balances = { workspace = true, default-features = true }
pezpallet-staking-reward-curve = { workspace = true, default-features = true }
pezpallet-timestamp = { workspace = true, default-features = true }
pezsp-io = { workspace = true, default-features = true }
pezframe-election-provider-support = { workspace = true, default-features = true }
[features]
default = ["std"]
std = [
"codec/std",
"pezframe-election-provider-support/std",
"pezframe-support/std",
"pezframe-system/std",
"pezpallet-balances/std",
"pezpallet-session/std",
"pezpallet-staking/std",
"pezpallet-timestamp/std",
"scale-info/std",
"pezsp-core/std",
"pezsp-io/std",
"pezsp-runtime/std",
"pezsp-staking/std",
]
runtime-benchmarks = [
"pezframe-election-provider-support/runtime-benchmarks",
"pezframe-support/runtime-benchmarks",
"pezframe-system/runtime-benchmarks",
"pezpallet-balances/runtime-benchmarks",
"pezpallet-session/runtime-benchmarks",
"pezpallet-staking-reward-curve/runtime-benchmarks",
"pezpallet-staking/runtime-benchmarks",
"pezpallet-timestamp/runtime-benchmarks",
"pezsp-io/runtime-benchmarks",
"pezsp-runtime/runtime-benchmarks",
"pezsp-staking/runtime-benchmarks",
]
try-runtime = [
"pezframe-election-provider-support/try-runtime",
"pezframe-support/try-runtime",
"pezframe-system/try-runtime",
"pezpallet-balances/try-runtime",
"pezpallet-session/try-runtime",
"pezpallet-staking/try-runtime",
"pezpallet-timestamp/try-runtime",
"pezsp-runtime/try-runtime",
]
@@ -0,0 +1,5 @@
# Root Offences Pallet
Pallet that allows the root to create an offence.
NOTE: This pallet should only be used for testing purposes.
@@ -0,0 +1,234 @@
// This file is part of Bizinikiwi.
// Copyright (C) Parity Technologies (UK) Ltd.
// SPDX-License-Identifier: Apache-2.0
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//! # Root Offences Pallet
//! Pallet that allows the root to create an offence.
//!
//! NOTE: This pallet should be used for testing purposes.
#![cfg_attr(not(feature = "std"), no_std)]
#[cfg(test)]
mod mock;
#[cfg(test)]
mod tests;
extern crate alloc;
use alloc::{vec, vec::Vec};
pub use pallet::*;
use pezpallet_session::historical::IdentificationTuple;
use pezsp_runtime::{traits::Convert, Perbill};
use pezsp_staking::offence::{Kind, Offence, OnOffenceHandler};
#[pezframe_support::pallet]
pub mod pallet {
use super::*;
use pezframe_support::pezpallet_prelude::*;
use pezframe_system::pezpallet_prelude::*;
use pezsp_staking::{offence::ReportOffence, SessionIndex};
/// Custom offence type for testing spam scenarios.
///
/// This allows creating offences with arbitrary kinds and time slots.
#[derive(Clone, Debug, Encode, Decode, TypeInfo)]
pub struct TestSpamOffence<Offender> {
/// The validator being slashed
pub offender: Offender,
/// The session in which the offence occurred
pub session_index: SessionIndex,
/// Custom time slot (allows unique offences within same session)
pub time_slot: u128,
/// Slash fraction to apply
pub slash_fraction: Perbill,
}
impl<Offender: Clone> Offence<Offender> for TestSpamOffence<Offender> {
const ID: Kind = *b"spamspamspamspam";
type TimeSlot = u128;
fn offenders(&self) -> Vec<Offender> {
vec![self.offender.clone()]
}
fn session_index(&self) -> SessionIndex {
self.session_index
}
fn time_slot(&self) -> Self::TimeSlot {
self.time_slot
}
fn slash_fraction(&self, _offenders_count: u32) -> Perbill {
self.slash_fraction
}
fn validator_set_count(&self) -> u32 {
unreachable!()
}
}
#[pallet::config]
pub trait Config:
pezframe_system::Config
+ pezpallet_staking::Config
+ pezpallet_session::Config<ValidatorId = <Self as pezframe_system::Config>::AccountId>
+ pezpallet_session::historical::Config
{
#[allow(deprecated)]
type RuntimeEvent: From<Event<Self>> + IsType<<Self as pezframe_system::Config>::RuntimeEvent>;
/// The offence handler provided by the runtime.
///
/// This is a way to give the offence directly to the handling system (staking, ah-client).
type OffenceHandler: OnOffenceHandler<Self::AccountId, IdentificationTuple<Self>, Weight>;
/// The offence report system provided by the runtime.
///
/// This is a way to give the offence to the `pezpallet-offences` next.
type ReportOffence: ReportOffence<
Self::AccountId,
IdentificationTuple<Self>,
TestSpamOffence<IdentificationTuple<Self>>,
>;
}
#[pallet::pallet]
pub struct Pallet<T>(_);
#[pallet::event]
#[pallet::generate_deposit(pub(super) fn deposit_event)]
pub enum Event<T: Config> {
/// An offence was created by root.
OffenceCreated { offenders: Vec<(T::AccountId, Perbill)> },
}
#[pallet::error]
pub enum Error<T> {
/// Failed to get the active era from the staking pallet.
FailedToGetActiveEra,
}
type OffenceDetails<T> = pezsp_staking::offence::OffenceDetails<
<T as pezframe_system::Config>::AccountId,
IdentificationTuple<T>,
>;
#[pallet::call]
impl<T: Config> Pallet<T> {
/// Allows the `root`, for example sudo to create an offence.
///
/// If `identifications` is `Some`, then the given identification is used for offence. Else,
/// it is fetched live from `session::Historical`.
#[pallet::call_index(0)]
#[pallet::weight(T::DbWeight::get().reads(2))]
pub fn create_offence(
origin: OriginFor<T>,
offenders: Vec<(T::AccountId, Perbill)>,
maybe_identifications: Option<Vec<T::FullIdentification>>,
maybe_session_index: Option<SessionIndex>,
) -> DispatchResult {
ensure_root(origin)?;
ensure!(
maybe_identifications.as_ref().map_or(true, |ids| ids.len() == offenders.len()),
"InvalidIdentificationLength"
);
let identifications =
maybe_identifications.ok_or("Unreachable-NoIdentification").or_else(|_| {
offenders
.iter()
.map(|(who, _)| {
T::FullIdentificationOf::convert(who.clone())
.ok_or("failed to call FullIdentificationOf")
})
.collect::<Result<Vec<_>, _>>()
})?;
let slash_fraction =
offenders.clone().into_iter().map(|(_, fraction)| fraction).collect::<Vec<_>>();
let offence_details = Self::get_offence_details(offenders.clone(), identifications)?;
Self::submit_offence(&offence_details, &slash_fraction, maybe_session_index);
Self::deposit_event(Event::OffenceCreated { offenders });
Ok(())
}
/// Same as [`Pallet::create_offence`], but it reports the offence directly to a
/// [`Config::ReportOffence`], aka pezpallet-offences first.
///
/// This is useful for more accurate testing of the e2e offence processing pipeline, as it
/// won't skip the `pezpallet-offences` step.
///
/// It generates an offence of type [`TestSpamOffence`], with cas a fixed `ID`, but can have
/// any `time_slot`, `session_index``, and `slash_fraction`. These values are the inputs of
/// transaction, int the same order, with an `IdentiticationTuple` coming first.
#[pallet::call_index(1)]
#[pallet::weight(T::DbWeight::get().reads(2))]
pub fn report_offence(
origin: OriginFor<T>,
offences: Vec<(IdentificationTuple<T>, SessionIndex, u128, u32)>,
) -> DispatchResult {
ensure_root(origin)?;
for (offender, session_index, time_slot, slash_ppm) in offences {
let slash_fraction = Perbill::from_parts(slash_ppm);
Self::deposit_event(Event::OffenceCreated {
offenders: vec![(offender.0.clone(), slash_fraction)],
});
let offence =
TestSpamOffence { offender, session_index, time_slot, slash_fraction };
T::ReportOffence::report_offence(Default::default(), offence).unwrap();
}
Ok(())
}
}
impl<T: Config> Pallet<T> {
/// Returns a vector of offenders that are going to be slashed.
fn get_offence_details(
offenders: Vec<(T::AccountId, Perbill)>,
identifications: Vec<T::FullIdentification>,
) -> Result<Vec<OffenceDetails<T>>, DispatchError> {
Ok(offenders
.clone()
.into_iter()
.zip(identifications.into_iter())
.map(|((o, _), i)| OffenceDetails::<T> {
offender: (o.clone(), i),
reporters: Default::default(),
})
.collect())
}
/// Submits the offence by calling the `on_offence` function.
fn submit_offence(
offenders: &[OffenceDetails<T>],
slash_fraction: &[Perbill],
maybe_session_index: Option<SessionIndex>,
) {
let session_index = maybe_session_index.unwrap_or_else(|| {
<pezpallet_session::Pallet<T> as pezframe_support::traits::ValidatorSet<
T::AccountId,
>>::session_index()
});
T::OffenceHandler::on_offence(&offenders, &slash_fraction, session_index);
}
}
}
@@ -0,0 +1,311 @@
// This file is part of Bizinikiwi.
// Copyright (C) Parity Technologies (UK) Ltd.
// SPDX-License-Identifier: Apache-2.0
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
use super::*;
use crate as root_offences;
use alloc::collections::btree_map::BTreeMap;
use pezframe_election_provider_support::{
bounds::{ElectionBounds, ElectionBoundsBuilder},
onchain, SequentialPhragmen,
};
use pezframe_support::{
derive_impl, parameter_types,
traits::{ConstBool, ConstU32, ConstU64, OneSessionHandler},
};
use pezpallet_staking::{BalanceOf, StakerStatus};
use pezsp_runtime::{curve::PiecewiseLinear, testing::UintAuthorityId, traits::Zero, BuildStorage};
use pezsp_staking::{EraIndex, SessionIndex};
type Block = pezframe_system::mocking::MockBlock<Test>;
type AccountId = u64;
type Balance = u64;
type BlockNumber = u64;
pub const INIT_TIMESTAMP: u64 = 30_000;
pub const BLOCK_TIME: u64 = 1000;
pezframe_support::construct_runtime!(
pub enum Test
{
System: pezframe_system,
Timestamp: pezpallet_timestamp,
Balances: pezpallet_balances,
Staking: pezpallet_staking,
Session: pezpallet_session,
RootOffences: root_offences,
Historical: pezpallet_session::historical,
}
);
/// Another session handler struct to test on_disabled.
pub struct OtherSessionHandler;
impl OneSessionHandler<AccountId> for OtherSessionHandler {
type Key = UintAuthorityId;
fn on_genesis_session<'a, I: 'a>(_: I)
where
I: Iterator<Item = (&'a AccountId, Self::Key)>,
AccountId: 'a,
{
}
fn on_new_session<'a, I: 'a>(_: bool, _: I, _: I)
where
I: Iterator<Item = (&'a AccountId, Self::Key)>,
AccountId: 'a,
{
}
fn on_disabled(_validator_index: u32) {}
}
impl pezsp_runtime::BoundToRuntimeAppPublic for OtherSessionHandler {
type Public = UintAuthorityId;
}
#[derive_impl(pezframe_system::config_preludes::TestDefaultConfig)]
impl pezframe_system::Config for Test {
type Block = Block;
type AccountData = pezpallet_balances::AccountData<u64>;
}
#[derive_impl(pezpallet_balances::config_preludes::TestDefaultConfig)]
impl pezpallet_balances::Config for Test {
type AccountStore = System;
}
pezpallet_staking_reward_curve::build! {
const REWARD_CURVE: PiecewiseLinear<'static> = curve!(
min_inflation: 0_025_000u64,
max_inflation: 0_100_000,
ideal_stake: 0_500_000,
falloff: 0_050_000,
max_piece_count: 40,
test_precision: 0_005_000,
);
}
parameter_types! {
pub static ElectionsBounds: ElectionBounds = ElectionBoundsBuilder::default().build();
}
pub struct OnChainSeqPhragmen;
impl onchain::Config for OnChainSeqPhragmen {
type System = Test;
type Solver = SequentialPhragmen<AccountId, Perbill>;
type DataProvider = Staking;
type WeightInfo = ();
type MaxWinnersPerPage = ConstU32<100>;
type MaxBackersPerWinner = ConstU32<100>;
type Sort = ConstBool<true>;
type Bounds = ElectionsBounds;
}
parameter_types! {
pub const RewardCurve: &'static PiecewiseLinear<'static> = &REWARD_CURVE;
pub static Offset: BlockNumber = 0;
pub const Period: BlockNumber = 1;
pub static SessionsPerEra: SessionIndex = 3;
pub static SlashDeferDuration: EraIndex = 0;
pub const BondingDuration: EraIndex = 3;
pub static LedgerSlashPerEra: (BalanceOf<Test>, BTreeMap<EraIndex, BalanceOf<Test>>) = (Zero::zero(), BTreeMap::new());
}
#[derive_impl(pezpallet_staking::config_preludes::TestDefaultConfig)]
impl pezpallet_staking::Config for Test {
type OldCurrency = Balances;
type Currency = Balances;
type CurrencyBalance = <Self as pezpallet_balances::Config>::Balance;
type UnixTime = Timestamp;
type SessionsPerEra = SessionsPerEra;
type SlashDeferDuration = SlashDeferDuration;
type AdminOrigin = pezframe_system::EnsureRoot<Self::AccountId>;
type BondingDuration = BondingDuration;
type SessionInterface = Self;
type EraPayout = pezpallet_staking::ConvertCurve<RewardCurve>;
type NextNewSession = Session;
type ElectionProvider = onchain::OnChainExecution<OnChainSeqPhragmen>;
type GenesisElectionProvider = Self::ElectionProvider;
type TargetList = pezpallet_staking::UseValidatorsMap<Self>;
type VoterList = pezpallet_staking::UseNominatorsAndValidatorsMap<Self>;
}
impl pezpallet_session::historical::Config for Test {
type RuntimeEvent = RuntimeEvent;
type FullIdentification = ();
type FullIdentificationOf = pezpallet_staking::UnitIdentificationOf<Self>;
}
pezsp_runtime::impl_opaque_keys! {
pub struct SessionKeys {
pub other: OtherSessionHandler,
}
}
impl pezpallet_session::Config for Test {
type SessionManager = pezpallet_session::historical::NoteHistoricalRoot<Test, Staking>;
type Keys = SessionKeys;
type ShouldEndSession = pezpallet_session::PeriodicSessions<Period, Offset>;
type SessionHandler = (OtherSessionHandler,);
type RuntimeEvent = RuntimeEvent;
type ValidatorId = AccountId;
type ValidatorIdOf = pezsp_runtime::traits::ConvertInto;
type NextSessionRotation = pezpallet_session::PeriodicSessions<Period, Offset>;
type DisablingStrategy = ();
type WeightInfo = ();
type Currency = Balances;
type KeyDeposit = ();
}
impl pezpallet_timestamp::Config for Test {
type Moment = u64;
type OnTimestampSet = ();
type MinimumPeriod = ConstU64<5>;
type WeightInfo = ();
}
impl Config for Test {
type RuntimeEvent = RuntimeEvent;
type OffenceHandler = Staking;
type ReportOffence = ();
}
pub struct ExtBuilder {
validator_count: u32,
minimum_validator_count: u32,
invulnerables: Vec<AccountId>,
balance_factor: Balance,
}
impl Default for ExtBuilder {
fn default() -> Self {
Self {
validator_count: 2,
minimum_validator_count: 0,
invulnerables: vec![],
balance_factor: 1,
}
}
}
impl ExtBuilder {
fn build(self) -> pezsp_io::TestExternalities {
let mut storage = pezframe_system::GenesisConfig::<Test>::default().build_storage().unwrap();
pezpallet_balances::GenesisConfig::<Test> {
balances: vec![
// controllers (still used in some tests. Soon to be deprecated).
(10, self.balance_factor * 50),
(20, self.balance_factor * 50),
(30, self.balance_factor * 50),
(40, self.balance_factor * 50),
// stashes
(11, self.balance_factor * 1500),
(21, self.balance_factor * 1500),
(31, self.balance_factor * 1000),
(41, self.balance_factor * 2000),
],
..Default::default()
}
.assimilate_storage(&mut storage)
.unwrap();
let stakers = vec![
// (stash, ctrl, stake, status)
// these two will be elected in the default test where we elect 2.
(11, 11, 1000, StakerStatus::<AccountId>::Validator),
(21, 21, 1000, StakerStatus::<AccountId>::Validator),
// a loser validator
(31, 31, 500, StakerStatus::<AccountId>::Validator),
// an idle validator
(41, 41, 1000, StakerStatus::<AccountId>::Idle),
];
let _ = pezpallet_staking::GenesisConfig::<Test> {
stakers: stakers.clone(),
..Default::default()
};
let _ = pezpallet_staking::GenesisConfig::<Test> {
stakers: stakers.clone(),
validator_count: self.validator_count,
minimum_validator_count: self.minimum_validator_count,
invulnerables: self.invulnerables,
slash_reward_fraction: Perbill::from_percent(10),
..Default::default()
}
.assimilate_storage(&mut storage);
let _ = pezpallet_session::GenesisConfig::<Test> {
keys: stakers
.into_iter()
.map(|(id, ..)| (id, id, SessionKeys { other: id.into() }))
.collect(),
..Default::default()
}
.assimilate_storage(&mut storage);
storage.into()
}
pub fn build_and_execute(self, test: impl FnOnce() -> ()) {
let mut ext = self.build();
ext.execute_with(test);
}
}
/// Progresses from the current block number (whatever that may be) to the `P * session_index + 1`.
pub(crate) fn start_session(session_index: SessionIndex) {
let end: u64 = if Offset::get().is_zero() {
(session_index as u64) * Period::get()
} else {
Offset::get() + (session_index.saturating_sub(1) as u64) * Period::get()
};
run_to_block(end);
// session must have progressed properly.
assert_eq!(
Session::current_index(),
session_index,
"current session index = {}, expected = {}",
Session::current_index(),
session_index,
);
}
/// Progress to the given block, triggering session and era changes as we progress.
///
/// This will finalize the previous block, initialize up to the given block, essentially simulating
/// a block import/propose process where we first initialize the block, then execute some stuff (not
/// in the function), and then finalize the block.
pub(crate) fn run_to_block(n: BlockNumber) {
System::run_to_block_with::<AllPalletsWithSystem>(
n,
pezframe_system::RunToBlockHooks::default().after_initialize(|bn| {
Timestamp::set_timestamp(bn * BLOCK_TIME + INIT_TIMESTAMP);
}),
);
}
/// Progress by n block.
pub(crate) fn advance_blocks(n: u64) {
run_to_block(System::block_number() + n);
}
pub(crate) fn active_era() -> EraIndex {
pezpallet_staking::ActiveEra::<Test>::get().unwrap().index
}
@@ -0,0 +1,104 @@
// This file is part of Bizinikiwi.
// Copyright (C) Parity Technologies (UK) Ltd.
// SPDX-License-Identifier: Apache-2.0
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
use super::*;
use pezframe_support::{assert_err, assert_noop, assert_ok};
use mock::{
active_era, advance_blocks, start_session, ExtBuilder, RootOffences, RuntimeOrigin, System,
Test as T,
};
use pezpallet_staking::asset;
#[test]
fn create_offence_fails_given_signed_origin() {
use pezsp_runtime::traits::BadOrigin;
ExtBuilder::default().build_and_execute(|| {
let offenders = (&[]).to_vec();
assert_err!(
RootOffences::create_offence(RuntimeOrigin::signed(1), offenders, None, None),
BadOrigin
);
})
}
#[test]
fn create_offence_works_given_root_origin() {
ExtBuilder::default().build_and_execute(|| {
start_session(1);
assert_eq!(active_era(), 0);
assert_eq!(asset::staked::<T>(&11), 1000);
let offenders = [(11, Perbill::from_percent(50))].to_vec();
assert_ok!(RootOffences::create_offence(
RuntimeOrigin::root(),
offenders.clone(),
None,
None
));
System::assert_last_event(Event::OffenceCreated { offenders }.into());
// offence is processed in the following block.
advance_blocks(1);
// the slash should be applied right away.
assert_eq!(asset::staked::<T>(&11), 500);
// the other validator should keep their balance, because we only created
// an offences for the first validator.
assert_eq!(asset::staked::<T>(&21), 1000);
})
}
#[test]
fn create_offence_wont_slash_non_active_validators() {
ExtBuilder::default().build_and_execute(|| {
start_session(1);
assert_eq!(active_era(), 0);
// we cannot even submit an offence for this, because we cannot generate an identification
// for them.
let offenders = [(31, Perbill::from_percent(20)), (11, Perbill::from_percent(20))].to_vec();
assert_noop!(
RootOffences::create_offence(RuntimeOrigin::root(), offenders.clone(), None, None),
"failed to call FullIdentificationOf"
);
})
}
#[test]
fn create_offence_wont_slash_idle() {
ExtBuilder::default().build_and_execute(|| {
start_session(1);
assert_eq!(active_era(), 0);
// 41 is idle.
assert_eq!(asset::staked::<T>(&41), 1000);
// we cannot even submit an offence for this, because we cannot generate an identification
// for them.
let offenders = [(41, Perbill::from_percent(50))].to_vec();
assert_noop!(
RootOffences::create_offence(RuntimeOrigin::root(), offenders.clone(), None, None),
"failed to call FullIdentificationOf"
);
})
}