pezkuwichain/pezkuwi-sdk
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Files
5a1fd2ea22fd9e282b599fb2612cee85373895a9
pezkuwi-sdk/templates/minimal/README.md
T
pezkuwichain 5a1fd2ea22 fix: update GitHub URLs from master to main branch 
- Replace tree/master with tree/main in all documentation and code comments
- Fix issues/168 -> pull/168 reference (issue was converted to PR)
2026-01-27 20:30:20 +03:00

5.5 KiB
Raw Blame History

Pezkuwi SDK's Minimal Template

Pezkuwi SDK Logo Pezkuwi SDK Logo

This is a minimal template for creating a blockchain based on Pezkuwi SDK.

This template is automatically updated after releases in the main Pezkuwi SDK monorepo.

Table of Contents

Intro

  • 🤏 This template is a minimal (in terms of complexity and the number of components) template for building a blockchain node.

  • 🔧 Its runtime is configured with a single custom pezpallet as a starting point, and a handful of ready-made pallets such as a Balances pezpallet.

  • 👤 The template has no consensus configured - it is best for experimenting with a single node network.

Template Structure

A Pezkuwi SDK based project such as this one consists of:

  • 🧮 the Runtime - the core logic of the blockchain.
  • 🎨 the Pallets - from which the runtime is constructed.
  • 💿 a Node - the binary application (which is not part of the cargo default-members list and is not compiled unless building the entire workspace).

Getting Started

  • 🦀 The template is using the Rust language.

  • 👉 Check the Rust installation instructions for your system.

  • 🛠️ Depending on your operating system and Rust version, there might be additional packages required to compile this template - please take note of the Rust compiler output.

Fetch minimal template code.

git clone https://github.com/pezkuwichain/pezkuwi-sdk/issues/25.git minimal-template

cd minimal-template

Starting a Minimal Template Chain

Minimal Template Node

Build both node & runtime

cargo build --workspace --release

🐳 Alternatively, build the docker image which builds all the workspace members, and has as entry point the node binary:

docker build . -t pezkuwi-sdk-minimal-template

Start the pez-minimal-template-node

The pez-minimal-template-node has dependency on the pez-minimal-template-runtime. It will use the pez_minimal_template_runtime::WASM_BINARY constant (which holds the WASM blob as a byte array) for chain spec building, while starting.

<target/release/path/to/pez-minimal-template-node> --tmp --consensus manual-seal-3000
# or via docker
docker run --rm pezkuwi-sdk-minimal-template

Zombienet with pez-minimal-template-node

For this one we just need to have zombienet installed and run:

zombienet --provider native spawn zombienet-multi-node.toml

Connect with the PezkuwiChain-JS Apps Front-End

  • 🌐 You can interact with your local node using the hosted version of the PezkuwiChain/Bizinikiwi Portal.

  • 🪐 A hosted version is also available on IPFS.

  • 🧑‍🔧 You can also find the source code and instructions for hosting your own instance in the pezkuwi-js/apps repository.

Takeaways

Previously minimal template's development chains:

  • ❌ Started in a multi-node setup will produce forks because minimal lacks consensus.
  • 🧹 Do not persist the state.
  • 💰 Are pre-configured with a genesis state that includes several pre-funded development accounts.
  • 🧑‍⚖️ One development account (ALICE) is used as sudo accounts.

Contributing

Getting Help

Reference in New Issue View Git Blame Copy Permalink