pezkuwi-sdk/docs/runtimes-pallets.md

Pezkuwi SDK - Runtime Pezpallet Mapping

Generated: 2025-12-08 Purpose: Complete inventory of all pallets across production runtimes

---

Summary

• Total Production Runtimes: 9
  • 2 Relay Chain Runtimes (PezkuwiChain, Zagros)
  • 7 Teyrchain Runtimes (Asset Hub x2, People Chain x2, Test Teyrchain, Penpal, Test)
• Total Custom Pallets: 14
• Custom Pallets with Benchmarks: 9

---

1. PezkuwiChain Relay Chain Runtime

Spec Name: pezkuwichain Spec Version: 1_020_001 Benchmarks: ✅ Yes

Pallets (Total: 61)

System & Core (Index 0-10)

• System (0) - frame_system
• Babe (1) - pallet_babe
• Timestamp (2) - pallet_timestamp
• Indices (3) - pallet_indices
• Balances (4) - pallet_balances
• Authorship (5) - pallet_authorship
• Parameters (6) - pallet_parameters
• Offences (7) - pallet_offences
• Session (8) - pallet_session
• Staking (9) - pallet_staking
• Grandpa (10) - pallet_grandpa

Consensus & Authority (Index 12-15)

• AuthorityDiscovery (12) - pallet_authority_discovery
• FastUnstake (15) - pallet_fast_unstake

Governance (Index 17-21, 43-44)

• Council (17) - pallet_collective::
• Treasury (18) - pallet_treasury
• Claims (19) - claims
• ConvictionVoting (20) - pallet_conviction_voting
• Referenda (21) - pallet_referenda
• Origins (43) - pallet_custom_origins
• Whitelist (44) - pallet_whitelist

Utility & Common (Index 24-33)

• Utility (24) - pallet_utility
• Vesting (28) - pallet_vesting
• Scheduler (29) - pallet_scheduler
• Proxy (30) - pallet_proxy
• Multisig (31) - pallet_multisig
• Preimage (32) - pallet_preimage
• TransactionPayment (33) - pallet_transaction_payment
• Historical (34) - session_historical

Teyrchains Support (Index 50-68)

• TeyrchainsOrigin (50) - teyrchains_origin
• Configuration (51) - teyrchains_configuration
• ParasShared (52) - teyrchains_shared
• ParaInclusion (53) - teyrchains_inclusion
• ParaInherent (54) - teyrchains_paras_inherent
• ParaScheduler (55) - teyrchains_scheduler
• Paras (56) - teyrchains_paras
• Initializer (57) - teyrchains_initializer
• Dmp (58) - teyrchains_dmp
• Hrmp (60) - teyrchains_hrmp
• ParaSessionInfo (61) - teyrchains_session_info
• ParasDisputes (62) - teyrchains_disputes
• ParasSlashing (63) - teyrchains_slashing
• MessageQueue (64) - pallet_message_queue
• OnDemandAssignmentProvider (66) - teyrchains_on_demand
• CoretimeAssignmentProvider (68) - teyrchains_assigner_coretime

Teyrchain Onboarding (Index 70-74)

• Registrar (70) - paras_registrar
• Slots (71) - slots
• Auctions (72) - auctions
• Crowdloan (73) - crowdloan
• Coretime (74) - coretime

🔴 CUSTOM PEZKUWI PALLETS (Index 91)

• ValidatorPool (91) - pallet_validator_pool (TNPoS Shadow Mode)

Migrations & XCM (Index 98-99)

• MultiBlockMigrations (98) - pallet_migrations
• XcmPallet (99) - pallet_xcm

VoterBagsList (Index 100)

• VoterBagsList (100) - pallet_bags_list::

BEEFY & MMR (Index 240-242)

• Beefy (240) - pallet_beefy
• Mmr (241) - pallet_mmr
• MmrLeaf (242) - pallet_beefy_mmr

Testing & Admin (Index 249-255)

• RootTesting (249) - pallet_root_testing
• ParasSudoWrapper (250) - paras_sudo_wrapper
• AssignedSlots (251) - assigned_slots
• ValidatorManager (252) - validator_manager
• StateTrieMigration (254) - pallet_state_trie_migration
• Sudo (255) - pallet_sudo

---

2. Zagros Relay Chain Runtime

Spec Name: zagros Spec Version: 1_020_001 Status: ⚠️ Zagros runtime does NOT exist in this codebase. Only PezkuwiChain relay chain is implemented.

---

3. Asset Hub PezkuwiChain Teyrchain Runtime

Spec Name: asset-hub-pezkuwichain Spec Version: 1_020_001 Benchmarks: ✅ Yes

Pallets (Total: 43)

System Support (Index 0-5)

• System (0) - frame_system
• TeyrchainSystem (1) - cumulus_pallet_teyrchain_system
• Timestamp (3) - pallet_timestamp
• TeyrchainInfo (4) - teyrchain_info
• WeightReclaim (5) - cumulus_pallet_weight_reclaim

Monetary (Index 10-13)

• Balances (10) - pallet_balances
• TransactionPayment (11) - pallet_transaction_payment
• AssetTxPayment (13) - pallet_asset_conversion_tx_payment

Collator Support (Index 20-24)

• Authorship (20) - pallet_authorship
• CollatorSelection (21) - pallet_collator_selection
• Session (22) - pallet_session
• Aura (23) - pallet_aura
• AuraExt (24) - cumulus_pallet_aura_ext

XCM Helpers (Index 30-34, 45)

• XcmpQueue (30) - cumulus_pallet_xcmp_queue
• PezkuwiXcm (31) - pallet_xcm
• CumulusXcm (32) - cumulus_pallet_xcm
• MessageQueue (34) - pallet_message_queue
• ToZagrosXcmRouter (45) - pallet_xcm_bridge_hub_router::

Utilities (Index 40-42)

• Utility (40) - pallet_utility
• Multisig (41) - pallet_multisig
• Proxy (42) - pallet_proxy

Assets & NFTs (Index 50-62)

• Assets (50) - pallet_assets::
• Uniques (51) - pallet_uniques
• Nfts (52) - pallet_nfts
• ForeignAssets (53) - pallet_assets::
• NftFractionalization (54) - pallet_nft_fractionalization
• PoolAssets (55) - pallet_assets::
• AssetConversion (56) - pallet_asset_conversion
• AssetsFreezer (57) - pallet_assets_freezer::
• ForeignAssetsFreezer (58) - pallet_assets_freezer::
• PoolAssetsFreezer (59) - pallet_assets_freezer::
• AssetRewards (60) - pallet_asset_rewards
• Nis (61) - pallet_nis
• AssetRate (62) - pallet_asset_rate

Treasury & Bounties (Index 63-65)

• Bounties (63) - pallet_bounties
• ChildBounties (64) - pallet_child_bounties
• Treasury (65) - pallet_treasury

🔴 CUSTOM PEZKUWI PALLETS (Index 70-73)

• PezTreasury (70) - pallet_pez_treasury ⭐ BENCHMARKED
• Presale (71) - pallet_presale ⭐ BENCHMARKED
• TokenWrapper (73) - pallet_token_wrapper ⭐ BENCHMARKED

Staking (Index 80-89)

• Staking (80) - pallet_staking_async
• NominationPools (81) - pallet_nomination_pools
• VoterList (83) - pallet_bags_list::
• DelegatedStaking (84) - pallet_delegated_staking
• StakingRcClient (89) - pallet_staking_async_rc_client

Multi-Block Election (Index 85-88)

• MultiBlockElection (85) - pallet_election_provider_multi_block
• MultiBlockElectionVerifier (86) - pallet_election_provider_multi_block::verifier
• MultiBlockElectionUnsigned (87) - pallet_election_provider_multi_block::unsigned
• MultiBlockElectionSigned (88) - pallet_election_provider_multi_block::signed

Migrations (Index 200)

• AssetConversionMigration (200) - pallet_asset_conversion_ops

---

4. Asset Hub Zagros Teyrchain Runtime

Spec Name: asset-hub-zagros Spec Version: 1_020_001 Benchmarks: ✅ Yes

Pallets (Total: 42)

System Support (Index 0-9)

• System (0) - frame_system
• TeyrchainSystem (1) - cumulus_pallet_teyrchain_system
• Timestamp (3) - pallet_timestamp
• TeyrchainInfo (4) - teyrchain_info
• WeightReclaim (5) - cumulus_pallet_weight_reclaim
• MultiBlockMigrations (6) - pallet_migrations
• Preimage (7) - pallet_preimage
• Scheduler (8) - pallet_scheduler
• Sudo (9) - pallet_sudo

Monetary (Index 10-14)

• Balances (10) - pallet_balances
• TransactionPayment (11) - pallet_transaction_payment
• AssetTxPayment (13) - pallet_asset_conversion_tx_payment
• Vesting (14) - pallet_vesting

Collator Support (Index 20-24)

• Authorship (20) - pallet_authorship
• CollatorSelection (21) - pallet_collator_selection
• Session (22) - pallet_session
• Aura (23) - pallet_aura
• AuraExt (24) - cumulus_pallet_aura_ext

XCM Helpers (Index 30-36)

• XcmpQueue (30) - cumulus_pallet_xcmp_queue
• PezkuwiXcm (31) - pallet_xcm
• CumulusXcm (32) - cumulus_pallet_xcm
• ToPezkuwichainXcmRouter (34) - pallet_xcm_bridge_hub_router::
• MessageQueue (35) - pallet_message_queue
• SnowbridgeSystemFrontend (36) - snowbridge_pezpallet_system_frontend

Utilities (Index 40-43)

• Utility (40) - pallet_utility
• Multisig (41) - pallet_multisig
• Proxy (42) - pallet_proxy
• Indices (43) - pallet_indices

Assets & NFTs (Index 50-61)

• Assets (50) - pallet_assets::
• Uniques (51) - pallet_uniques
• Nfts (52) - pallet_nfts
• ForeignAssets (53) - pallet_assets::
• NftFractionalization (54) - pallet_nft_fractionalization
• PoolAssets (55) - pallet_assets::
• AssetConversion (56) - pallet_asset_conversion
• AssetsFreezer (57) - pallet_assets_freezer::
• ForeignAssetsFreezer (58) - pallet_assets_freezer::
• PoolAssetsFreezer (59) - pallet_assets_freezer::
• Revive (60) - pallet_revive
• AssetRewards (61) - pallet_asset_rewards

State Trie Migration (Index 70)

• StateTrieMigration (70) - pallet_state_trie_migration

Staking (Index 80-89)

• Staking (80) - pallet_staking_async
• NominationPools (81) - pallet_nomination_pools
• VoterList (83) - pallet_bags_list::
• DelegatedStaking (84) - pallet_delegated_staking
• StakingRcClient (89) - pallet_staking_async_rc_client
• MultiBlockElection (85) - pallet_election_provider_multi_block
• MultiBlockElectionVerifier (86) - pallet_election_provider_multi_block::verifier
• MultiBlockElectionUnsigned (87) - pallet_election_provider_multi_block::unsigned
• MultiBlockElectionSigned (88) - pallet_election_provider_multi_block::signed

Governance (Index 90-95)

• ConvictionVoting (90) - pallet_conviction_voting
• Referenda (91) - pallet_referenda
• Origins (92) - pallet_custom_origins
• Whitelist (93) - pallet_whitelist
• Treasury (94) - pallet_treasury
• AssetRate (95) - pallet_asset_rate

Migrations (Index 200)

• AssetConversionMigration (200) - pallet_asset_conversion_ops

Admin Operations (Index 254)

• AhOps (254) - pallet_ah_ops

---

5. People PezkuwiChain Teyrchain Runtime

Spec Name: people-pezkuwichain Spec Version: 1_020_001 Benchmarks: ✅ Yes

Pallets (Total: 34)

System Support (Index 0-4)

• System (0) - frame_system
• TeyrchainSystem (1) - cumulus_pallet_teyrchain_system
• Timestamp (2) - pallet_timestamp
• TeyrchainInfo (3) - teyrchain_info
• WeightReclaim (4) - cumulus_pallet_weight_reclaim

Monetary (Index 10-12)

• Balances (10) - pallet_balances
• TransactionPayment (11) - pallet_transaction_payment
• SkipFeelessPayment (12) - pallet_skip_feeless_payment

Collator Support (Index 20-24)

• Authorship (20) - pallet_authorship
• CollatorSelection (21) - pallet_collator_selection
• Session (22) - pallet_session
• Aura (23) - pallet_aura
• AuraExt (24) - cumulus_pallet_aura_ext

XCM (Index 30-34)

• XcmpQueue (30) - cumulus_pallet_xcmp_queue
• PezkuwiXcm (31) - pallet_xcm
• CumulusXcm (32) - cumulus_pallet_xcm
• MessageQueue (34) - pallet_message_queue

Utilities (Index 40-44)

• Utility (40) - pallet_utility
• Multisig (41) - pallet_multisig
• Proxy (42) - pallet_proxy
• Recovery (43) - pallet_recovery
• Vesting (44) - pallet_vesting

🔴 Identity & People (Index 50-53) - CUSTOM PALLETS

• Identity (50) - pallet_identity
• IdentityKyc (51) - pallet_identity_kyc ⭐ BENCHMARKED
• Referral (52) - pallet_referral ⭐ BENCHMARKED
• Perwerde (53) - pallet_perwerde ⭐ BENCHMARKED

🔴 NFTs and Roles (Index 60-61) - CUSTOM PALLETS

• Nfts (60) - pallet_nfts
• Tiki (61) - pallet_tiki ⭐ BENCHMARKED

Governance (Index 70-75)

• Council (70) - pallet_collective::
• Scheduler (71) - pallet_scheduler
• Democracy (72) - pallet_democracy
• Elections (73) - pallet_elections_phragmen
• Welati (75) - pallet_welati ⭐ BENCHMARKED (PezkuwiChain Governance)

🔴 Trust & Staking (Index 80-82) - CUSTOM PALLETS

• StakingScore (80) - pallet_staking_score ⭐ BENCHMARKED
• Trust (81) - pallet_trust ⭐ BENCHMARKED
• Society (82) - pallet_society

Assets & Rewards (Index 90-91)

• Assets (90) - pallet_assets
• PezRewards (91) - pallet_pez_rewards ⭐ BENCHMARKED

Migrations (Index 98, 248)

• MultiBlockMigrations (98) - pallet_migrations
• IdentityMigrator (248) - identity_migrator

---

6. People Zagros Teyrchain Runtime

Spec Name: people-zagros Spec Version: 1_020_001 Benchmarks: ✅ Yes

Pallets (Total: 18)

System Support (Index 0-4)

• System (0) - frame_system
• TeyrchainSystem (1) - cumulus_pallet_teyrchain_system
• Timestamp (2) - pallet_timestamp
• TeyrchainInfo (3) - teyrchain_info
• WeightReclaim (4) - cumulus_pallet_weight_reclaim

Monetary (Index 10-11)

• Balances (10) - pallet_balances
• TransactionPayment (11) - pallet_transaction_payment

Collator Support (Index 20-24)

• Authorship (20) - pallet_authorship
• CollatorSelection (21) - pallet_collator_selection
• Session (22) - pallet_session
• Aura (23) - pallet_aura
• AuraExt (24) - cumulus_pallet_aura_ext

XCM (Index 30-34)

• XcmpQueue (30) - cumulus_pallet_xcmp_queue
• PezkuwiXcm (31) - pallet_xcm
• CumulusXcm (32) - cumulus_pallet_xcm
• MessageQueue (34) - pallet_message_queue

Utilities (Index 40-42)

• Utility (40) - pallet_utility
• Multisig (41) - pallet_multisig
• Proxy (42) - pallet_proxy

Identity (Index 50)

• Identity (50) - pallet_identity

Migrations (Index 98, 248)

• MultiBlockMigrations (98) - pallet_migrations
• IdentityMigrator (248) - identity_migrator

Note: This is a minimal People Chain runtime without custom Pezkuwi pallets (no Tiki, IdentityKyc, etc.)

---

7. Penpal Test Teyrchain Runtime

Spec Name: penpal-teyrchain Spec Version: 1 Benchmarks: ⚠️ Limited

Pallets (Total: 19)

• System (0) - frame_system
• TeyrchainSystem (1) - cumulus_pallet_teyrchain_system
• Timestamp (2) - pallet_timestamp
• TeyrchainInfo (3) - teyrchain_info
• Balances (10) - pallet_balances
• TransactionPayment (11) - pallet_transaction_payment
• AssetTxPayment (12) - pallet_asset_tx_payment
• Authorship (20) - pallet_authorship
• CollatorSelection (21) - pallet_collator_selection
• Session (22) - pallet_session
• Aura (23) - pallet_aura
• AuraExt (24) - cumulus_pallet_aura_ext
• XcmpQueue (30) - cumulus_pallet_xcmp_queue
• PezkuwiXcm (31) - pallet_xcm
• CumulusXcm (32) - cumulus_pallet_xcm
• MessageQueue (34) - pallet_message_queue
• Utility (40) - pallet_utility
• Assets (50) - pallet_assets::
• ForeignAssets (51) - pallet_assets::
• PoolAssets (52) - pallet_assets::
• AssetConversion (53) - pallet_asset_conversion
• Revive (60) - pallet_revive
• Sudo (255) - pallet_sudo

Purpose: Testing interactions between system teyrchains and non-trusted-teleporter chains.

---

8. PezkuwiChain Test Teyrchain Runtime

Spec Name: test-teyrchain Spec Version: 1_020_001 Benchmarks: ❌ No

Pallets (Total: 14)

• System - frame_system
• Timestamp - pallet_timestamp
• Sudo - pallet_sudo
• TransactionPayment - pallet_transaction_payment
• WeightReclaim - cumulus_pallet_weight_reclaim
• TeyrchainSystem (20) - cumulus_pallet_teyrchain_system
• TeyrchainInfo (21) - teyrchain_info
• Balances (30) - pallet_balances
• Assets (31) - pallet_assets
• Aura - pallet_aura
• AuraExt - cumulus_pallet_aura_ext
• XcmpQueue (50) - cumulus_pallet_xcmp_queue
• PezkuwiXcm (51) - pallet_xcm
• CumulusXcm (52) - cumulus_pallet_xcm
• MessageQueue (54) - pallet_message_queue
• Spambot (99) - cumulus_ping

Purpose: Basic test runtime for XCM and teyrchain functionality testing.

---

9. Bridge Hub, Coretime, Collectives Runtimes

Bridge Hub PezkuwiChain & Zagros

Status: Detected but not fully analyzed in this report.

Coretime PezkuwiChain & Zagros

Status: Detected but not fully analyzed in this report.

Collectives Zagros

Status: Detected but not fully analyzed in this report.

---

Custom Pallets Distribution Table

Pezpallet Name	Asset Hub PZ	Asset Hub ZG	People PZ	People ZG	PZ Relay	Test Runtimes	Benchmarks
pezpallet-pez-treasury	✓						✅
pezpallet-presale	✓						✅
pezpallet-token-wrapper	✓						✅
pezpallet-identity-kyc			✓				✅
pezpallet-referral			✓				✅
pezpallet-perwerde			✓				✅
pezpallet-tiki			✓				✅
pezpallet-welati			✓				✅
pezpallet-staking-score			✓				✅
pezpallet-trust			✓				✅
pezpallet-pez-rewards			✓				✅
pezpallet-validator-pool					✓		❌
pezpallet-collective-content							❌
teyrchain-info	✓	✓	✓	✓		✓	❌

Legend:

• ✓ = Pezpallet is included in this runtime
• ✅ = Has benchmarks configured
• ❌ = No benchmarks
• Empty = Not included

---

Custom Pallets Details

1. pezpallet-pez-treasury 💰

• Runtime: Asset Hub PezkuwiChain
• Purpose: PEZ token treasury management and distribution
• Benchmarks: ✅ Yes

2. pezpallet-presale 🎫

• Runtime: Asset Hub PezkuwiChain
• Purpose: Token presale management
• Benchmarks: ✅ Yes

3. pezpallet-token-wrapper 🔄

• Runtime: Asset Hub PezkuwiChain
• Purpose: Token wrapping/unwrapping functionality
• Benchmarks: ✅ Yes

4. pezpallet-identity-kyc 🆔

• Runtime: People PezkuwiChain
• Purpose: Enhanced identity with KYC capabilities
• Benchmarks: ✅ Yes

5. pezpallet-referral 🤝

• Runtime: People PezkuwiChain
• Purpose: Referral program management
• Benchmarks: ✅ Yes

6. pezpallet-perwerde 📚

• Runtime: People PezkuwiChain
• Purpose: Educational credentials and achievements
• Benchmarks: ✅ Yes

7. pezpallet-tiki 🎖️

• Runtime: People PezkuwiChain
• Purpose: Role-based NFT badges system
• Benchmarks: ✅ Yes

8. pezpallet-welati 🏛️

• Runtime: People PezkuwiChain
• Purpose: PezkuwiChain governance (Serok, Parlement, Diwan)
• Benchmarks: ✅ Yes

9. pezpallet-staking-score 📊

• Runtime: People PezkuwiChain
• Purpose: Trust and participation scoring
• Benchmarks: ✅ Yes

10. pezpallet-trust 🛡️

• Runtime: People PezkuwiChain
• Purpose: Trust-based interactions and reputation
• Benchmarks: ✅ Yes

11. pezpallet-pez-rewards 🎁

• Runtime: People PezkuwiChain
• Purpose: PEZ token rewards distribution
• Benchmarks: ✅ Yes

12. pezpallet-validator-pool ⛏️

• Runtime: PezkuwiChain Relay Chain
• Purpose: TNPoS validator pool (shadow mode, runs parallel to NPoS)
• Benchmarks: ❌ No

13. pezpallet-collective-content 📝

• Runtime: None (not integrated yet)
• Purpose: Content management for collectives
• Benchmarks: ❌ No

14. teyrchain-info ℹ️

• Runtime: All teyrchain runtimes
• Purpose: Provides teyrchain ID information
• Benchmarks: ❌ No (infrastructure pezpallet)

---

Architecture Notes

🎯 Strategic Pezpallet Placement

1. Asset Hub PezkuwiChain - Economic Layer

   • PEZ treasury and presale management
   • Token wrapping functionality
   • Full asset management suite

2. People PezkuwiChain - Identity & Governance Layer

   • Identity + KYC integration
   • Role-based NFTs (Tiki)
   • Educational credentials (Perwerde)
   • Governance system (Welati)
   • Trust and reputation systems
   • PEZ rewards distribution

3. PezkuwiChain Relay - Consensus Layer

   • TNPoS validator pool (experimental)
   • Standard NPoS staking
   • Full teyrchain orchestration

⚠️ Missing Components

1. Zagros Relay Chain: Not implemented - only PezkuwiChain relay exists
2. Bridge Hub Runtimes: Detected but not fully analyzed
3. Coretime Runtimes: Detected but not fully analyzed
4. Collectives Runtime: Detected but not fully analyzed

📊 Benchmark Coverage

• Total Custom Pallets: 14
• With Benchmarks: 11 (79%)
• Without Benchmarks: 3 (21%)
  • pezpallet-validator-pool (relay chain)
  • pezpallet-collective-content (not integrated)
  • teyrchain-info (infrastructure)

---

Recommendations

1. Critical Issues

• ⚠️ Zagros Runtime Missing: Only PezkuwiChain relay chain exists. Need to decide:
  • Is Zagros still planned?
  • Should references be removed?
  • Update terminology documentation

2. Benchmark Coverage

• ✅ Good coverage for production pallets (79%)
• ⚠️ Add benchmarks for pezpallet-validator-pool if going to production
• ℹ️ teyrchain-info and collective-content can stay without benchmarks

3. Runtime Organization

• ✅ Good separation: Economic (Asset Hub) vs Social (People Chain)
• ✅ Custom pallets well-distributed by function
• ⚠️ Consider whether all staking functionality should be on Asset Hub or if some should move

4. Testing

• ✅ Good test runtime coverage (Penpal, Test Teyrchain)
• ℹ️ Bridge/Coretime/Collectives runtimes need documentation

---

Version History

• 2025-12-08: Initial comprehensive report
• Pallets Analyzed: 14 custom pallets across 9 runtimes
• Benchmarks Verified: 11/14 pallets (79%)

---

Generated by: Claude Code Project: Pezkuwi SDK - Independent Blockchain GitHub: pezkuwichain/pezkuwi-sdk