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,315 @@
// 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 crate::impls::AccountIdOf;
use core::marker::PhantomData;
use cumulus_primitives_core::{IsSystem, ParaId};
use pezframe_support::{
traits::{fungibles::Inspect, tokens::ConversionToAssetBalance, Contains, ContainsPair},
weights::Weight,
};
use pezsp_runtime::traits::Get;
use xcm::latest::prelude::*;
/// A `ChargeFeeInFungibles` implementation that converts the output of
/// a given WeightToFee implementation an amount charged in
/// a particular assetId from pezpallet-assets
pub struct AssetFeeAsExistentialDepositMultiplier<
Runtime,
WeightToFee,
BalanceConverter,
AssetInstance: 'static,
>(PhantomData<(Runtime, WeightToFee, BalanceConverter, AssetInstance)>);
impl<CurrencyBalance, Runtime, WeightToFee, BalanceConverter, AssetInstance>
cumulus_primitives_utility::ChargeWeightInFungibles<
AccountIdOf<Runtime>,
pezpallet_assets::Pallet<Runtime, AssetInstance>,
> for AssetFeeAsExistentialDepositMultiplier<Runtime, WeightToFee, BalanceConverter, AssetInstance>
where
Runtime: pezpallet_assets::Config<AssetInstance>,
WeightToFee: pezframe_support::weights::WeightToFee<Balance = CurrencyBalance>,
BalanceConverter: ConversionToAssetBalance<
CurrencyBalance,
<Runtime as pezpallet_assets::Config<AssetInstance>>::AssetId,
<Runtime as pezpallet_assets::Config<AssetInstance>>::Balance,
>,
<BalanceConverter as ConversionToAssetBalance<
CurrencyBalance,
<Runtime as pezpallet_assets::Config<AssetInstance>>::AssetId,
<Runtime as pezpallet_assets::Config<AssetInstance>>::Balance,
>>::Error: core::fmt::Debug,
{
fn charge_weight_in_fungibles(
asset_id: <pezpallet_assets::Pallet<Runtime, AssetInstance> as Inspect<
AccountIdOf<Runtime>,
>>::AssetId,
weight: Weight,
) -> Result<
<pezpallet_assets::Pallet<Runtime, AssetInstance> as Inspect<AccountIdOf<Runtime>>>::Balance,
XcmError,
> {
let amount = WeightToFee::weight_to_fee(&weight);
// If the amount gotten is not at least the ED, then make it be the ED of the asset
// This is to avoid burning assets and decreasing the supply
let asset_amount = BalanceConverter::to_asset_balance(amount, asset_id)
.map_err(|error| {
tracing::debug!(target: "xcm::charge_weight_in_fungibles", ?error, "AssetFeeAsExistentialDepositMultiplier cannot convert to valid balance (possibly below ED)");
XcmError::TooExpensive
})?;
Ok(asset_amount)
}
}
/// Accepts an asset if it is a native asset from a particular `Location`.
pub struct ConcreteNativeAssetFrom<LocationValue>(PhantomData<LocationValue>);
impl<LocationValue: Get<Location>> ContainsPair<Asset, Location>
for ConcreteNativeAssetFrom<LocationValue>
{
fn contains(asset: &Asset, origin: &Location) -> bool {
tracing::trace!(
target: "xcm::filter_asset_location",
?asset, ?origin, location=?LocationValue::get(),
"ConcreteNativeAsset"
);
asset.id.0 == *origin && origin == &LocationValue::get()
}
}
pub struct RelayOrOtherSystemTeyrchains<
SystemTeyrchainMatcher: Contains<Location>,
Runtime: teyrchain_info::Config,
> {
_runtime: PhantomData<(SystemTeyrchainMatcher, Runtime)>,
}
impl<SystemTeyrchainMatcher: Contains<Location>, Runtime: teyrchain_info::Config> Contains<Location>
for RelayOrOtherSystemTeyrchains<SystemTeyrchainMatcher, Runtime>
{
fn contains(l: &Location) -> bool {
let self_para_id: u32 = teyrchain_info::Pallet::<Runtime>::get().into();
if let (0, [Teyrchain(para_id)]) = l.unpack() {
if *para_id == self_para_id {
return false;
}
}
matches!(l.unpack(), (1, [])) || SystemTeyrchainMatcher::contains(l)
}
}
/// Contains all sibling system teyrchains, including the one where this matcher is used.
///
/// This structure can only be used at a teyrchain level. In the Relay Chain, please use
/// the `xcm_builder::IsChildSystemTeyrchain` matcher.
pub struct AllSiblingSystemTeyrchains;
impl Contains<Location> for AllSiblingSystemTeyrchains {
fn contains(l: &Location) -> bool {
tracing::trace!(target: "xcm::contains", location=?l, "AllSiblingSystemTeyrchains");
match l.unpack() {
// System teyrchain
(1, [Teyrchain(id)]) => ParaId::from(*id).is_system(),
// Everything else
_ => false,
}
}
}
/// Accepts an asset if it is a concrete asset from the system (Relay Chain or system teyrchain).
pub struct ConcreteAssetFromSystem<AssetLocation>(PhantomData<AssetLocation>);
impl<AssetLocation: Get<Location>> ContainsPair<Asset, Location>
for ConcreteAssetFromSystem<AssetLocation>
{
fn contains(asset: &Asset, origin: &Location) -> bool {
tracing::trace!(target: "xcm::contains", ?asset, ?origin, "ConcreteAssetFromSystem");
let is_system = match origin.unpack() {
// The Relay Chain
(1, []) => true,
// System teyrchain
(1, [Teyrchain(id)]) => ParaId::from(*id).is_system(),
// Others
_ => false,
};
asset.id.0 == AssetLocation::get() && is_system
}
}
/// Filter to check if a given location is the parent Relay Chain or a sibling teyrchain.
///
/// This type should only be used within the context of a teyrchain, since it does not verify that
/// the parent is indeed a Relay Chain.
pub struct ParentRelayOrSiblingTeyrchains;
impl Contains<Location> for ParentRelayOrSiblingTeyrchains {
fn contains(location: &Location) -> bool {
matches!(location.unpack(), (1, []) | (1, [Teyrchain(_)]))
}
}
/// Filter to check if a given `target` location represents the same AccountId32 as `origin`,
/// but coming from another sibling system chain.
///
/// This type should only be used within the context of a teyrchain, to allow accounts on system
/// chains to Alias to the same accounts on the local chain.
pub struct AliasAccountId32FromSiblingSystemChain;
impl ContainsPair<Location, Location> for AliasAccountId32FromSiblingSystemChain {
fn contains(origin: &Location, target: &Location) -> bool {
let result = match origin.unpack() {
// `origin` is AccountId32 on sibling system teyrchain
(1, [Teyrchain(para_id), AccountId32 { network: _, id: origin }])
if ParaId::from(*para_id).is_system() =>
{
match target.unpack() {
// `target` is local AccountId32 and matches `origin` remote account
(0, [AccountId32 { network: _, id: target }]) => target.eq(origin),
_ => false,
}
},
_ => false,
};
tracing::trace!(
target: "xcm::contains",
?origin, ?target, ?result,
"AliasAccountId32FromSiblingSystemChain"
);
result
}
}
#[cfg(test)]
mod tests {
use pezframe_support::{parameter_types, traits::Contains};
use super::{
AliasAccountId32FromSiblingSystemChain, AllSiblingSystemTeyrchains, Asset,
ConcreteAssetFromSystem, ContainsPair, GeneralIndex, Here, Location, PalletInstance,
Parent, Teyrchain,
};
use pezkuwi_primitives::LOWEST_PUBLIC_ID;
use xcm::latest::prelude::*;
parameter_types! {
pub const RelayLocation: Location = Location::parent();
}
#[test]
fn concrete_asset_from_relay_works() {
let expected_asset: Asset = (Parent, 1000000).into();
let expected_origin: Location = (Parent, Here).into();
assert!(<ConcreteAssetFromSystem<RelayLocation>>::contains(
&expected_asset,
&expected_origin
));
}
#[test]
fn concrete_asset_from_sibling_system_para_fails_for_wrong_asset() {
let unexpected_assets: Vec<Asset> = vec![
(Here, 1000000).into(),
((PalletInstance(50), GeneralIndex(1)), 1000000).into(),
((Parent, Teyrchain(1000), PalletInstance(50), GeneralIndex(1)), 1000000).into(),
];
let expected_origin: Location = (Parent, Teyrchain(1000)).into();
unexpected_assets.iter().for_each(|asset| {
assert!(!<ConcreteAssetFromSystem<RelayLocation>>::contains(asset, &expected_origin));
});
}
#[test]
fn concrete_asset_from_sibling_system_para_works_for_correct_asset() {
// (para_id, expected_result)
let test_data = vec![
(0, true),
(1, true),
(1000, true),
(1999, true),
(2000, false), // Not a System Teyrchain
(2001, false), // Not a System Teyrchain
];
let expected_asset: Asset = (Parent, 1000000).into();
for (para_id, expected_result) in test_data {
let origin: Location = (Parent, Teyrchain(para_id)).into();
assert_eq!(
expected_result,
<ConcreteAssetFromSystem<RelayLocation>>::contains(&expected_asset, &origin)
);
}
}
#[test]
fn all_sibling_system_teyrchains_works() {
// system teyrchain
assert!(AllSiblingSystemTeyrchains::contains(&Location::new(1, [Teyrchain(1)])));
// non-system teyrchain
assert!(!AllSiblingSystemTeyrchains::contains(&Location::new(
1,
[Teyrchain(LOWEST_PUBLIC_ID.into())]
)));
// when used at relay chain
assert!(!AllSiblingSystemTeyrchains::contains(&Location::new(0, [Teyrchain(1)])));
// when used with non-teyrchain
assert!(!AllSiblingSystemTeyrchains::contains(&Location::new(1, [OnlyChild])));
}
#[test]
fn alias_accountid32_from_sibling_system_teyrchains() {
let acc_42 = AccountId32 { network: None, id: [42u8; 32] };
let acc_13 = AccountId32 { network: None, id: [13u8; 32] };
// origin acc_42 on sibling system teyrchain aliases into local acc_42
assert!(AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(1), acc_42]),
&Location::new(0, [acc_42])
));
// if target is not local account, always fails
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(1), acc_42]),
&Location::new(0, [])
));
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(1), acc_42]),
&Location::new(0, [Teyrchain(1)])
));
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(1), acc_42]),
&Location::new(0, [GeneralIndex(42)])
));
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(1), acc_42]),
&Location::new(1, [acc_42])
));
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(1), acc_42]),
&Location::new(2, [acc_42])
));
// origin acc_13 on sibling system teyrchain CANNOT alias into local acc_42
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(1), acc_13]),
&Location::new(0, [acc_42])
));
// origin acc_42 on sibling non-system teyrchain CANNOT alias into local acc_42
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(1, [Teyrchain(LOWEST_PUBLIC_ID.into()), acc_42]),
&Location::new(0, [acc_42])
));
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(0, [acc_13]),
&Location::new(0, [acc_13]),
));
assert!(!AliasAccountId32FromSiblingSystemChain::contains(
&Location::new(0, [acc_42]),
&Location::new(1, [Teyrchain(1), acc_42]),
));
}
}