pezkuwichain/pezkuwi-runtime-templates
1
0
Fork 0
mirror of https://github.com/pezkuwichain/pezkuwi-runtime-templates.git synced 2026-04-22 04:27:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update documentation and templates for Pezkuwi branding

Browse Source
This commit is contained in:
Kurdistan Tech Ministry
2026-01-17 23:19:40 +03:00
parent d839cbd92b
commit 9bd688a742
172 changed files with 12903 additions and 6604 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/modules/ROOT/pages/runtimes/generic.adoc
+17 -17
View File
@@ -10,7 +10,7 @@ Generic Runtime Template is constructed with the purpose of providing the most g
The pezpallet list is constructed by the contributions of Parity, the community, and OpenZeppelin.
Our motivation for crafting the pezpallet list was to be as minimalistic as possible,
whilst preserving the most important pezpallets that are used in the Polkadot ecosystem.
whilst preserving the most important pezpallets that are used in the Pezkuwi ecosystem.
We designed this template to be generic, so that it can be used as a starting point for any other project/template,
and we aim to base our future templates off of this one.
@@ -29,22 +29,22 @@ To demystify the hard concepts, we provided a documentation, in which you can fi
[%collapsible]
====
* https://paritytech.github.io/polkadot-sdk/master/pezframe_system/index.html#[pezframe_system] is responsible from creating the runtime, initializing the storage, and providing the base functionality for the runtime.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezframe_system/index.html#[pezframe_system] is responsible from creating the runtime, initializing the storage, and providing the base functionality for the runtime.
* https://paritytech.github.io/polkadot-sdk/master/cumulus_pezpallet_parachain_system/index.html#[cumulus_pezpallet_parachain_system] handles low-level details of being a parachain.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezcumulus_pezpallet_teyrchain_system/index.html#[pezcumulus_pezpallet_teyrchain_system] handles low-level details of being a teyrchain.
* https://paritytech.github.io/polkadot-sdk/master/pezpallet_timestamp/index.html#[pezpallet_timestamp] provides a way for consensus systems to set and check the onchain time.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_timestamp/index.html#[pezpallet_timestamp] provides a way for consensus systems to set and check the onchain time.
* https://docs.rs/staging-parachain-info/latest/staging_parachain_info/index.html#[parachain_info] provides a way for parachains to report their parachain id and the relay chain block number.
* https://docs.rs/staging-teyrchain-info/latest/staging_teyrchain_info/index.html#[teyrchain_info] provides a way for teyrchains to report their teyrchain id and the relay chain block number.
* https://docs.rs/pezpallet-proxy/latest/pezpallet_proxy/#[pezpallet_proxy] enables delegation of rights to execute certain call types from one origin to another.
* https://paritytech.github.io/polkadot-sdk/master/pezpallet_utility/index.html#[pezpallet_utility] contains two basic pieces of functionality:
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_utility/index.html#[pezpallet_utility] contains two basic pieces of functionality:
** Batch dispatch: A stateless operation, allowing any origin to execute multiple calls in a single dispatch. This can be useful to amalgamate proposals, combining `set_code` with corresponding `set_storage`s, for efficient multiple payouts with just a single signature verify, or in combination with one of the other two dispatch functionality.
*** https://paritytech.github.io/polkadot-sdk/master/pezpallet_utility/pezpallet/struct.Pezpallet.html#method.force_batch[force_batch]: Sends a batch of dispatch calls. Errors are allowed and won’t interrupt
*** https://paritytech.github.io/polkadot-sdk/master/pezpallet_utility/pezpallet/struct.Pezpallet.html#method.batch[batch]: Sends a batch of dispatch calls. This will return `Ok` in all circumstances. To determine the success of the batch, an event is deposited. If a call failed and the batch was interrupted, then the `BatchInterrupted` event is deposited, along with the number of successful calls made and the error of the failed call. If all were successful, then the `BatchCompleted` event is deposited.
*** https://paritytech.github.io/polkadot-sdk/master/pezpallet_utility/pezpallet/struct.Pezpallet.html#method.batch_all[batch_all]: Send a batch of dispatch calls and atomically execute them. The whole transaction will rollback and fail if any of the calls failed.
*** https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_utility/pezpallet/struct.Pezpezpallet.html#method.force_batch[force_batch]: Sends a batch of dispatch calls. Errors are allowed and won’t interrupt
*** https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_utility/pezpallet/struct.Pezpezpallet.html#method.batch[batch]: Sends a batch of dispatch calls. This will return `Ok` in all circumstances. To determine the success of the batch, an event is deposited. If a call failed and the batch was interrupted, then the `BatchInterrupted` event is deposited, along with the number of successful calls made and the error of the failed call. If all were successful, then the `BatchCompleted` event is deposited.
*** https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_utility/pezpallet/struct.Pezpezpallet.html#method.batch_all[batch_all]: Send a batch of dispatch calls and atomically execute them. The whole transaction will rollback and fail if any of the calls failed.
** Pseudonymal dispatch: A stateless operation, allowing a signed origin to execute a call from an alternative signed origin. Each account has 2 * 2**16 possible “pseudonyms” (alternative account IDs) and these can be stacked. This can be useful as a key management tool, where you need multiple distinct accounts (e.g. as controllers for many staking accounts), but where it’s perfectly fine to have each of them controlled by the same underlying keypair. Derivative accounts are, for the purposes of proxy filtering considered exactly the same as the origin and are thus hampered with the origin’s filters.
* https://docs.rs/pezpallet-multisig/latest/pezpallet_multisig/#[pezpallet_multisig] enables multi-signature operations in your runtime. This module allows multiple signed origins (accounts) to coordinate and dispatch a call. For the call to execute, the threshold number of accounts from the set (signatories) must approve it.
@@ -76,7 +76,7 @@ To demystify the hard concepts, we provided a documentation, in which you can fi
** *length fee*: A fee proportional to the encoded length of the transaction.
** *tip*: An optional tip. Tip increases the priority of the transaction, giving it a higher chance to be included by the transaction queue.
* https://paritytech.github.io/polkadot-sdk/master/pezpallet_assets/index.html#[pezpallet_assets] deals with sets of assets implementing fungible traits, via [fungibles] traits in a simple, secure manner. This pezpallet makes heavy use of concepts such as Holds and Freezes from the [pezframe_support::traits::fungible] traits, therefore you should read and understand those docs as a prerequisite to understanding this pezpallet.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_assets/index.html#[pezpallet_assets] deals with sets of assets implementing fungible traits, via [fungibles] traits in a simple, secure manner. This pezpallet makes heavy use of concepts such as Holds and Freezes from the [pezframe_support::traits::fungible] traits, therefore you should read and understand those docs as a prerequisite to understanding this pezpallet.
* https://docs.rs/pezpallet-treasury/latest/pezpallet_treasury/#[pezpallet_treasury] provides a “pot” of funds that can be managed by stakeholders in the system and a structure for making spending proposals from this pot.
@@ -93,7 +93,7 @@ To demystify the hard concepts, we provided a documentation, in which you can fi
* https://docs.rs/pezpallet-referenda/latest/pezpallet_referenda/#[pezpallet_referenda] executes referenda. No voting logic is present here, and the Polling and PollStatus traits are used to allow the voting logic (likely in a pezpallet) to be utilized.
* https://github.com/OpenZeppelin/polkadot-runtime-templates/blob/main/evm-template/runtime/src/configs/governance/origins.rs#[pezpallet_custom_origins] allows custom origins for governance. // TODO: double check this, is it really our own pezpallet, or just copy paste?
* https://github.com/OpenZeppelin/pezkuwi-runtime-templates/blob/main/evm-template/runtime/src/configs/governance/origins.rs#[pezpallet_custom_origins] allows custom origins for governance. // TODO: double check this, is it really our own pezpallet, or just copy paste?
* https://docs.rs/pezpallet-whitelist/latest/pezpallet_whitelist/index.html#[pezpallet_whitelist] allows some configurable origin: `Config::WhitelistOrigin` to whitelist some hash of a call, and allows another configurable origin: `Config::DispatchWhitelistedOrigin` to dispatch them with the root origin.
@@ -105,16 +105,16 @@ To demystify the hard concepts, we provided a documentation, in which you can fi
[%collapsible]
====
* https://docs.rs/pezpallet-authorship/latest/pezpallet_authorship/#[pezpallet_authorship] provides authorship tracking for FRAME runtimes. This tracks the current author of the block and recent uncles.
* https://docs.rs/pezpallet-authorship/latest/pezpallet_authorship/#[pezpallet_authorship] provides authorship tracking for PEZFRAME runtimes. This tracks the current author of the block and recent uncles.
* https://paritytech.github.io/polkadot-sdk/master/pezpallet_collator_selection/index.html#[pezpallet_collator_selection] - manages the collators of a parachain. **Collation is *not* a secure activity** and this pezpallet does not implement any game-theoretic mechanisms to meet BFT safety assumptions of the chosen set. This pezpallet can:
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_collator_selection/index.html#[pezpallet_collator_selection] - manages the collators of a teyrchain. **Collation is *not* a secure activity** and this pezpallet does not implement any game-theoretic mechanisms to meet BFT safety assumptions of the chosen set. This pezpallet can:
** set invulnerable candidates (fixed candidates)
** set desired candidates (ideal number of non-fixed)
** set candidacy bond
** remove invulnerability (turn candidate into not fixed)
** and many more (all related to collators)
* https://paritytech.github.io/polkadot-sdk/master/pezpallet_session/index.html#[pezpallet_session] allows validators to manage their session keys, provides a function for changing the session length, and handles session rotation.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezpallet_session/index.html#[pezpallet_session] allows validators to manage their session keys, provides a function for changing the session length, and handles session rotation.
* https://docs.rs/pezpallet-aura/latest/pezpallet_aura/#[pezpallet_aura] extends Aura consensus by managing offline reporting. It can:
** get the current slot
@@ -122,7 +122,7 @@ To demystify the hard concepts, we provided a documentation, in which you can fi
** change and initialize authorities
** ensure the correctness of the state of this pezpallet
* https://paritytech.github.io/polkadot-sdk/master/cumulus_pezpallet_aura_ext/index.html#[cumulus_pezpallet_aura_ext] extends the Substrate AuRa pezpallet to make it compatible with parachains. It provides the Pezpallet, the Config and the GenesisConfig.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezcumulus_pezpallet_aura_ext/index.html#[pezcumulus_pezpallet_aura_ext] extends the Bizinikiwi AuRa pezpallet to make it compatible with teyrchains. It provides the Pezpezpallet, the Config and the GenesisConfig.
====
@@ -131,11 +131,11 @@ To demystify the hard concepts, we provided a documentation, in which you can fi
[%collapsible]
====
* https://paritytech.github.io/polkadot-sdk/master/cumulus_pezpallet_xcmp_queue/index.html#[cumulus_pezpallet_xcmp_queue] Responsible for the Queues (both incoming and outgoing) for XCMP messages. This pezpallet does not actually receive or send messages. Its responsibility is to place the incoming and outgoing XCMP messages in their respective queues and manage these queues.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezcumulus_pezpallet_xcmp_queue/index.html#[pezcumulus_pezpallet_xcmp_queue] Responsible for the Queues (both incoming and outgoing) for XCMP messages. This pezpallet does not actually receive or send messages. Its responsibility is to place the incoming and outgoing XCMP messages in their respective queues and manage these queues.
* https://docs.rs/pezpallet-xcm/6.0.0/pezpallet_xcm/#[pezpallet_xcm] is responsible for filtering, routing, and executing incoming XCM.
* https://paritytech.github.io/polkadot-sdk/master/cumulus_pezpallet_xcm/index.html#[cumulus_pezpallet_xcm] is responsible from detecting and ensuring whether XCM's are coming from *Relay* or *Sibling* chain.
* https://pezkuwichain.github.io/pezkuwi-sdk/master/pezcumulus_pezpallet_xcm/index.html#[pezcumulus_pezpallet_xcm] is responsible from detecting and ensuring whether XCM's are coming from *Relay* or *Sibling* chain.
* https://docs.rs/pezpallet-message-queue/latest/pezpallet_message_queue/#[MessageQueue] provides generalized message queuing and processing capabilities on a per-queue basis for arbitrary use-cases.