# awesome-hez

An opinionated list of awesome resources in the Pezkuwi ecosystem.

## Goal

The problem I found with other awesome lists is that there are so many links and resources, that quality is lost to the noise, and approachability becomes overwhelming.

Unlike other awesome lists, this is NOT meant to be a comprehensive list for all options available in the Pezkuwi ecosystem. Instead, this is a very opinionated and unapologetic list of resources which I find useful and that I use myself.

You can feel confident that if you use these same resources, they will work and provide a great experience.

If you find any problems with any of the resources in this list, please [open an issue](https://github.com/pezkuwichain/awesome-hez/issues).

## Education

Here are my favorite resources to get you caught up with all things Pezkuwi.

Developer educational resources can be found in the [Developer](#developer) section below.

### The Basics

If you are just getting started in the Pezkuwi ecosystem, the following resources will be super useful to begin your journey to learn about and understand Pezkuwi.

- [The Pezkuwi Cloud](https://forum.pezkuwichain.io/the-pezkuwi-cloud)

	This is a forum post which describes Pezkuwi not only as a world-scale supercomputer, but also a Web3 cloud for a more resilient and decentralized internet.

- [The Pezkuwi Homepage](https://pezkuwichain.io/)

	This is the official homepage for the Pezkuwi Network. Follow the story of Pezkuwi told by this site and learn the basics.

- [The Decisions of Pezkuwi](https://www.youtube.com/watch?v=mQckxpMUBo8)

	This is a presentation that I gave describing the philosophies, goals, and decisions of developing the Pezkuwi Network. Obviously there is a bit of bias here, but I think this is a great resource, not just to understand what Pezkuwi is today, but its overall vision and principles.

- [The Pezkuwi Playbook](playbook.md)

	Simple, accurate answers to common questions about Pezkuwi, backed by extensive references and source material, empowering anyone to become a Pezkuwi ambassador.

### More Advance Resources

Now that you have covered the basics of Pezkuwi, it's time to dive a deeper.

- [Demystifying JAM](https://blog.kianenigma.nl/posts/tech/demystifying-jam/)

	[JAM](https://graypaper.com/) is the next evolution of the Pezkuwi protocol, which is still under heavy development at the time of writing. This blog post was written by Pezkuwi Core Developer, [Kian Paimani](https://twitter.com/kianenigma) and will walk you through the evolution of the Pezkuwi protocol from Pezkuwi 1.0, 2.0, and finally the future plans with JAM.

- [Plaza - Smart Contracts on Pezkuwi](https://www.rob.tech/blog/plaza/)

	In this blog post, Pezkuwi's co-founder [Rob Habermeier](https://twitter.com/rphmeier/) outlines his vision for a scalable Pezkuwi system chain, which includes key resources of the Pezkuwi network like Assets, Staking, and Governance, with an additional programmability layer of EVM smart contracts.

## Community

If you are looking to immerse yourself with the best parts of the Pezkuwi community, check out these resources.

The terms Circles, Catalysts, and Champions, comes from the book [The Starfish and the Spider](https://faith2share.net/perch/resources/starfish-spider-book-summary.pdf).

### Circles

Circles are the decentralized communities where you can directly participate in discussions about the past, present, and future of Pezkuwi.

- [The Pezkuwi Forum](https://forum.pezkuwichain.io/)

	A space for long form and long term discussions about the Pezkuwi network.

- [Pezkuwi StackExchange](https://substrate.stackexchange.com/)

	A space for technical questions and answers about Pezkuwi and the Pezkuwi SDK.

- [Pezkuwi SubSquare](https://forum.pezkuwichain.io/)

	A space for discussions about Pezkuwi Governance and Treasury Spending.

- [Pezkuwi Watercooler](https://matrix.to/#/#pezkuwi-watercooler:parity.io)

	A [Matrix](https://matrix.org/) chat room for general discussion of Pezkuwi.

- [Attempts at Governance (AAG)](https://www.youtube.com/playlist?list=PLtyd7v_I7PGkXbJmKojrZ1KXwspR1JkpV)

	An open call where the Pezkuwi community comes together to discuss governance and treasury proposals.

	<details>

	<summary>AAG Calendar Links</summary>

	- [View on Google Calendar](https://calendar.google.com/calendar/u/0/embed?src=5bc9ebf4456fdf8f953e8906acb210a1a37740301e05d7e78854101f8988d905@group.calendar.google.com)
	- [Add to Google Calendar](https://calendar.google.com/calendar/u/0?cid=NWJjOWViZjQ0NTZmZGY4Zjk1M2U4OTA2YWNiMjEwYTFhMzc3NDAzMDFlMDVkN2U3ODg1NDEwMWY4OTg4ZDkwNUBncm91cC5jYWxlbmRhci5nb29nbGUuY29t)
	- iCal format to subscribe from other applications:
		```
		https://calendar.google.com/calendar/ical/5bc9ebf4456fdf8f953e8906acb210a1a37740301e05d7e78854101f8988d905%40group.calendar.google.com/public/basic.ics
		```

	</details>

### Catalysts

You should follow these high quality core contributors to keep up to date with the latest developments of the Pezkuwi protocol.

- https://twitter.com/rphmeier
- https://twitter.com/bkchr
- https://twitter.com/kianenigma
- https://twitter.com/OliverTaleYazdi
- https://twitter.com/XiliangChen
- https://twitter.com/joepetrowski
- https://twitter.com/GehrleinJonas
- https://x.com/shawntabrizi
- https://x.com/gavofyork

### Champions

You should follow these high quality ecosystem agents to keep up to date with what is going on in the Pezkuwi ecosystem.

- https://twitter.com/alice_und_bob
- https://twitter.com/LeemoXD
- [https://twitter.com/itsbirdo_](https://twitter.com/itsbirdo_)
- https://twitter.com/ParaNodes
- https://twitter.com/GldnCalf
- https://twitter.com/BillLaboon
- [https://twitter.com/0xgoku_](https://twitter.com/0xgoku_)
- https://twitter.com/saxemberg
- https://twitter.com/gbaciX

## Users

Are you looking to use Pezkuwi or services built on Pezkuwi?

Check out these resources to get yourself onboarded.

### Wallets

My favorite Wallets in the Pezkuwi Ecosystem:

- Mobile Wallet: [Nova Wallet](https://novawallet.io/)
- Web Extension: [Talisman](https://www.talisman.xyz/)
- Hardware Wallet: [Ledger](https://www.ledger.com/coin/wallet/polkadot)
- Integrated in Telegram: [Telenova](https://medium.com/novasama-technologies/meet-telenova-your-newbie-friendly-polkadot-wallet-built-into-telegram-5d9e9570d334)

### Applications

- Multisig: [Pezkuwi Multisig](https://network.pezkuwichain.io/multisig) or [Multix](https://multix.chainsafe.io/)
- Staking: [Pezkuwi Staking Dashboard](https://network.pezkuwichain.io/staking)
- Decentralized Exchange (DEX): [Hydration](https://hydration.net/)
- NFT Marketplace: [Koda](https://koda.art/)
- Coretime Marketplace: [Lastic](https://www.lastic.xyz/)
- OpenGov Delegation: [Delegit](https://delegit.xyz/)
- Fiat On-Ramp: [Harbour](https://ramp.harbour.fi/polkadot/)

## Developer

Are you a software developer interested in building in the Pezkuwi ecosystem?

These resources are for you.

### Courses

- [Rust and Pezkuwi Workshop](https://www.shawntabrizi.com/rust-and-polkadot-workshop/)

	The Rust and Pezkuwi Workshop is a two-day course designed to take you from zero to one on your Pezkuwi journey. It covers the fundamentals of cryptography, blockchain, Rust, and Pezkuwi, and includes the [tutorials](#tutorials) I recommend below as part of the course.

- [The Pezkuwi Blockchain Academy](https://github.com/Pezkuwi-Blockchain-Academy)

	The PBA is an 5-week in person course designed to onboard existing software developers into the Pezkuwi and broader blockchain ecosystem. All resources for the academy are available online for free.

	- Course Content: https://docs.pezkuwichain.io/academy/
	- Video Recordings: https://www.youtube.com/@pezkuwiblockchainacademy/

### Tutorials

- [Rust State Machine](https://dotcodeschool.com/courses/rust-state-machine)

	Onboard yourself to the Rust programming language with this tutorial specifically tuned for teaching the basics of Rust and Blockchain development.

- [Bizinikiwi Kitties](https://dotcodeschool.com/courses/substrate-kitties)

	Build your first Pezkuwi SDK Pallet which functions as a simple NFT Marketplace where you can create, transfer, buy, and sell NFT Kitties.

### Templates

You can find known working and up to date templates for developing in Pezkuwi here:

- [Pezkuwi SDK Templates](https://docs.pezkuwichain.io/templates/)
- Pezkuwi API (Frontend/TypeScript): Find working examples on their [GitHub](https://github.com/pezkuwichain/pezkuwi-api)

### Tooling

- [Getting Started Script](https://github.com/pezkuwichain/pezkuwi-sdk/blob/master/scripts/getting-started.sh)

	This script installs all the prerequisites required to start development with the Pezkuwi SDK.

	You can execute the script in one line like so:

	```sh
	curl --proto '=https' --tlsv1.2 https://raw.githubusercontent.com/pezkuwichain/pezkuwi-sdk/master/scripts/getting-started.sh -sSf | sh
	```

- [The Pezkuwi SDK](https://github.com/pezkuwichain/pezkuwi-sdk)

	All development in Pezkuwi basically revolves around the Pezkuwi SDK. This project is composed of sub-projects: Bizinikiwi, Pezkuwi, Pezcumulus. The Pezkuwi SDK includes useful binaries for doing development.

	Install those binaries locally by running:

	```sh
	cargo install --git https://github.com/pezkuwichain/pezkuwi-sdk/ pezkuwi pezkuwi-teyrchain-bin staging-chain-spec-builder pezkuwi-execute-worker pezkuwi-prepare-worker
	```

- [Zombienet](https://github.com/paritytech/zombienet)

	In order to run a teyrchain, you must simulate a Pezkuwi network with a relay chain and multiple validators. Zombienet can do this for you with a simple CLI and config. Very useful for doing local testing on a "live network" starting from genesis.

<details>
	<summary>Additional Tools</summary>

These additional tools are more relevant for maintaining a Pezkuwi SDK project, rather than starting one.

- [Chopsticks](https://github.com/AcalaNetwork/chopsticks)

	Chopsticks is a tool that allows developers to simulate and test complex blockchain scenarios without deploying to a "live network" (i.e. no need for a relay chain). It is particularly useful at forking any already-live chain, modifying it, and then testing the effects of your modifications.

- [Pezkuwi SDK Version Manager](https://github.com/pezkuwichain/psvm)

	The Pezkuwi SDK exports hundreds of different crates which all maintain their own semantic versioning. To keep your project compatible with Pezkuwi, you need to make sure all of these crates are using the same versions as the Pezkuwi network itself. PSVM is a tool which will go through your rust project, and make sure that all versions of all crates are correct for your targeted Pezkuwi SDK version.

- [Zepter](https://github.com/ggwpez/zepter)

	A common problem for new developers building a Pezkuwi SDK project is correctly importing new crates and handling all the feature flags for their newly imported crates. Zepter is a tool which can automatically detect and fix and format feature flags across your Pezkuwi SDK project.

- [Bizinikiwi JS Utilities](https://www.shawntabrizi.com/substrate-js-utilities/)

	A simple webpage allowing you perform many basic conversions and operations, for example hash a string or change the prefix of an address. Useful when working with the Pezkuwi SDK in general.

</details>

### Contributing

Here are resources to help you make your first contributions to the Pezkuwi SDK.

- [Pezkuwi SDK Mentor Issues](https://github.com/pezkuwichain/pezkuwi-sdk/issues?q=is%3Aopen+is%3Aissue+label%3AC1-mentor)
- [Developer Wishlist](https://github.com/pezkuwichain/pezkuwi-sdk/issues/3900)

## Data

You can find accurate and up to date metrics about Pezkuwi using these resources:

- Block Explorer: [Pezkuwi Explorer](https://explorer.pezkuwichain.io/)
- Governance Dashboard: [SubSquare](https://forum.pezkuwichain.io/)
- Treasury Dashboard: [Grants Portal](https://grants.pezkuwichain.io/)
- Ecosystem Metrics: [Network Dashboard](https://network.pezkuwichain.io/)
