Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Welcome to the **Polkadot Hackathon Survival Guide**! Whether you're a **blockchain pro** or just starting with **Polkadot**, this guide has all the essential info, tips, and resources to help you in your journey building on Polkadot. ✨

From setting up your **development environment** to **presenting your project**, we’ve got you covered. The Polkadot ecosystem provides multiple development pathways:
From setting up your **development environment** to **presenting your project**, we’ve got you covered. The Polkadot ecosystem provides **multiple** development pathways:

<img width="1109" alt="image" src="https://github.com/user-attachments/assets/5c5bf50a-1906-4f04-9478-0d3bcc70649b" />

Expand Down
23 changes: 15 additions & 8 deletions tinkerer-materials/quickstarters.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,11 +56,18 @@ They typically feature wallet integration, real-time chain data display, and tra

**Ready-to-use code templates and working examples to jumpstart your development.** These repositories provide battle-tested starting points for different types of Polkadot applications. Clone, modify, and build upon these foundations rather than starting from scratch.

| Boilerplate | Language | Type | Purpose | Repo URL |
|---|---|---|---|---|
| [Polkadot API TS Boilerplate](https://github.com/CrackTheCode016/polkadot-api-ts-boilerplate) | TypeScript | Template | Base PAPI app (balances/tx wiring scaffold) | https://github.com/CrackTheCode016/polkadot-api-ts-boilerplate |
| [Polkadot API Example CLI](https://github.com/CrackTheCode016/polkadot-api-example-cli) | TypeScript | Example | Sample CLI ("You Got Mail!") using PAPI boilerplate | https://github.com/CrackTheCode016/polkadot-api-example-cli |
| [EduNews (PAPI + Vue)](https://github.com/CrackTheCode016/edunews) | TypeScript | Example | Working web app using PAPI for chain reads | https://github.com/CrackTheCode016/edunews |
| [SubXT Template](https://github.com/CrackTheCode016/polkadot-subxt-boilerplate) | Rust | Template | Consolidated Subxt client template with signing examples | https://github.com/CrackTheCode016/polkadot-subxt-boilerplate |
| [EduNews SubXT](https://github.com/CrackTheCode016/edunews-subxt) | Rust | Example | Working example using Subxt, using the subxt boilerplate. | https://github.com/CrackTheCode016/edunews-subxt |
| [EduChain (Polkadot SDK)](https://github.com/w3f/educhain) | Rust (SDK) | Example | Example parachain with custom pallets | https://github.com/w3f/educhain |
#### Templates

| Resource | Language | Purpose | Repo URL |
|---|---|---|---|
| [Polkadot API TS Boilerplate](https://github.com/CrackTheCode016/polkadot-api-ts-boilerplate) | TypeScript | Base PAPI Typescript repo | https://github.com/CrackTheCode016/polkadot-api-ts-boilerplate |
| [SubXT Template](https://github.com/CrackTheCode016/polkadot-subxt-boilerplate) | Rust | Consolidated Subxt client template with signing examples | https://github.com/CrackTheCode016/polkadot-subxt-boilerplate |

#### Examples

| Resource | Language | Purpose | Repo URL |
|---|---|---|---|
| [Polkadot API Example CLI](https://github.com/CrackTheCode016/polkadot-api-example-cli) | TypeScript | Sample CLI ("You Got Mail!") using PAPI boilerplate | https://github.com/CrackTheCode016/polkadot-api-example-cli |
| [EduNews (PAPI + Vue)](https://github.com/CrackTheCode016/edunews) | TypeScript | Working web app using PAPI for chain reads | https://github.com/CrackTheCode016/edunews |
| [EduNews SubXT](https://github.com/CrackTheCode016/edunews-subxt) | Rust | Working example using Subxt, using the subxt boilerplate. | https://github.com/CrackTheCode016/edunews-subxt |
| [EduChain (Polkadot SDK)](https://github.com/w3f/educhain) | Rust (SDK) | Example parachain with custom pallets | https://github.com/w3f/educhain |
40 changes: 28 additions & 12 deletions tinkerer-materials/solution-matrix.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,24 +9,40 @@ The following table showcases how different pallets, which may be deployed on di

| Use case | Polkadot SDK building blocks | Tools & services (dev, infra, UX) | Parachains / products (examples) | Notes |
|---|---|---|---|---|
| **Payments & P2P transfers** | `pallet-balances`, `pallet-assets` | Polkadot.js API & Extension, Nova/SubWallet, Subscan/Statescan | **Asset Hub**, **Bifrost** (liquid staking tokens), **Hydration** (DEX) | Prefer multi‑asset via `pallet-assets` for fungibles; use Asset Hub for canonical issuance + XCM distribution. |
| **Tenders/Grants transparency** | `pallet-assets`, `pallet-collective`, `pallet-treasury`, `pallet-vesting`, `pallet-proxy` | Multix, Staking & OpenGov dashboards | **Asset Hub**, **Collectives chain** | |
| **Supply chain / provenance** | `pallet-nft`, `pallet-assets`, `pallet-timestamp` | | **Asset Hub**, **People Chain** | |
| **Cross‑chain asset routing** | XCM v5 (`pallet-xcm`), `xcm-executor`, `pallet-xtokens` (ORML) | Paraspell SDK, Paraspell API, Paraspell XCM playground, Polkadot.js, PAPI | **Bridge Hub**, **Asset Hub**, **Moonbeam** (XC‑20), **Bifrost** | Use buy‑execution/fee payment assets carefully; prefer assets registered on Asset Hub for widespread acceptance. |
| **Payments & P2P transfers** | `pallet-balances`, `pallet-assets` | Polkadot.js API & Extension, Nova/SubWallet, Subscan/Statescan | **Asset Hub**, **Hydration** (DEX) | Prefer multi‑asset via `pallet-assets` for fungibles; use Asset Hub for canonical issuance + XCM distribution. |
| **Tenders/Grants transparency** | `pallet-assets`, `pallet-collective`, `pallet-treasury`, `pallet-proxy` | Multix, Staking & OpenGov dashboards | **Asset Hub**, **Collectives chain** | |
| **Supply chain / provenance** | `pallet-nft`, `pallet-assets` | | **Asset Hub**, **People Chain** | |
| **Cross‑chain asset routing** | XCM v5 (`pallet-xcm`), `xcm-executor`, `pallet-xtokens` (ORML) | Paraspell SDK, Paraspell API, Paraspell XCM playground, Polkadot.js, PAPI | **Bridge Hub**, **Asset Hub**, **Moonbeam** (XC‑20)| Use buy‑execution/fee payment assets carefully; prefer assets registered on Asset Hub for widespread acceptance. |
| **Ethereum ↔ Polkadot bridging** | `snowbridge-pallet-system`, `snowbridge-pallet-ethereum-client`, `snowbridge-pallet-outbound-queue`, `snowbridge-pallet-inbound-queue` | [Turtle.cool](https://turtle.cool/) | [Snowbridge](https://docs.snowbridge.network/) (ETH↔Polkadot), **Bridge Hub** | |
| **Universal interoperability / Multi-chain bridging** | `pallet-ismp` (Interoperable State Machine Protocol) | [Hyperbridge SDK](https://docs.hyperbridge.network/developers/integration), cross-chain messaging APIs | [**Hyperbridge**](https://docs.hyperbridge.network/) (universal interoperability hub), **Bridge Hub** | Hyperbridge enables trustless communication between any blockchain networks, not limited to Ethereum-Polkadot |
| **Identity & KYC / credentials** | `pallet-identity`, `pallet-membership`, `pallet-registrar` | https://w3n.id/, off‑chain verifiers | **People chain** (DIDs & verifiable credentials), **KILT** | Keep PII off‑chain; store hashes/attestations on‑chain, present credentials off‑chain when possible. |
| **DAO / Governance (OpenGov)** | `pallet-democracy`/OpenGov tracks, `pallet-collective`, `pallet-treasury`, `pallet-conviction-voting`, `pallet-proxy` | Polkassembly, Subsquare, Referenda dashboards | **Collectives**, OpenGov | |
| **Smart contracts (Rust)** | `pallet-revive` (ink!), `pallet-scheduler`, weights/benchmarking | ink! toolchain, POP CLI, create-polkadot-app | **Astar** (Wasm), **Phala** (off‑chain compute for contracts), **Aleph Zero** | |
| **DAO / Governance (OpenGov)** | `pallet-collective`, `pallet-treasury`, `pallet-conviction-voting`, `pallet-proxy` | Polkassembly, Subsquare, Referenda dashboards | **Collectives**, OpenGov | |
| **Smart contracts (Rust)** | `pallet-revive` (ink!), weights/benchmarking | ink! toolchain, POP CLI, create-polkadot-app | **Astar** (Wasm), **Phala** (off‑chain compute for contracts), **Aleph Zero** | |
| **Smart contracts (Solidity)** | pallet-revive | Hardhat/Foundry Polkadot plugins, RPC providers | **AssetHub** (Kusama, Paseo), **Moonbeam**, **Astar** (EVM) | |
| **NFTs & marketplaces** | `pallet-nft`, `pallet-uniques` (NFTs), `pallet-assets` (fungible), metadata pallets | system.rmrk, IPFS/Crust | **Unique Network**, **Asset Hub** (NFTs), **Astar**/**Moonbeam** (EVM NFTs) | Use `pallet-nft` for native NFTs; RMRK adds composability on compatible chains. |
| **Gaming / Metaverse** | `pallet-uniques`, custom logic pallets, on‑chain randomness (`pallet-randomness`/VRF) | Wallet SDKs, indexers, oracles | **Unique Network**, **Astar**, **Crust** (storage) | Keep heavy assets off‑chain; commit proofs/hashes on‑chain. |
| **Privacy / ZK use cases** | `pallet-mmr` | | **Manta Network** (privacy & zk apps), **Phala** (TEE off‑chain compute) | Combine on‑chain verifiers with off‑chain proving for UX. |
| **RWA** | `pallet-assets`, identity/membership pallets, freeze/thaw controls | People Chain, credentials, custodial integrations | **Peaq Network**, **Centrifuge** (RWA), **Pendulum** (forex rails) | |
| **🔒 Off‑chain compute / confidential jobs** | Off‑chain workers, `pallet-scheduler` | Phala SDK | **Phala Network** | Route sensitive workloads to TEEs; commit results on‑chain. |
| **Privacy / ZK use cases** | `pallet-mmr` | | **Phala** (TEE off‑chain compute) | Combine on‑chain verifiers with off‑chain proving for UX. |
| **RWA** | `pallet-assets`, identity/membership pallets, freeze/thaw controls | People Chain, credentials, custodial integrations | **Peaq Network**, **Centrifuge** (RWA) | |
| **🔒 Off‑chain compute / confidential jobs** | Off‑chain workers, `pallet-acurast` (data attestation), `pallet-acurast-compute` (compute resource management), `pallet-marketplace` (job marketplace) | [Acurast SDK](https://docs.acurast.com/), Phala SDK | **Acurast Network** (decentralized cloud), **Phala Network** | Acurast provides verifiable off-chain compute with TEE attestations; route compute jobs to decentralized processors with staking mechanisms. |
| **Data Oracles / External Data** | `pallet-acurast` (secure data ingestion), `pallet-hyperdrive` (state synchronization), off-chain workers | [Acurast Console](https://docs.acurast.com/), oracle APIs, data feeds | **Acurast Network** (data oracles), **Phala Network** | Use Acurast for tamper-proof external data feeds with processor attestations; hyperdrive pallet enables secure cross-chain data synchronization. |


## Some Ideas to try!
- Health data consent and e‑prescriptions
- Ticketing, passes and access control
- Programmable B2B invocing

> **Disclaimer:** *Below is merely a suggestion to set you in the right direction, and is not a definitive solution.*

> **More Ideas:** Check out the [Polkadot Builder Party Hackathon Idea List](https://forum.polkadot.network/t/polkadot-builder-party-hackathon-idea-list/14653) for additional project inspiration and community-suggested ideas.

### 🏥 Health Data Consent & E-Prescriptions

- **Core Pallets**: `pallet-identity` (patient verification), `pallet-assets` (prescription tokens with minimal metadata), `pallet-proxy` (delegate access to family/caregivers)
- **Implementation**: **Privacy-first approach** - Deploy on a private/permissioned parachain or solo chain restricted to healthcare network participants. Patient identities are hashed references, not personal data. Prescriptions as transferable tokens contain only essential non-sensitive metadata (prescription ID, expiry). All sensitive medical data stored off-chain with encrypted storage, only access permissions and hashes stored on-chain.
- **Tools**: KILT for verifiable credentials (off-chain presentation), encrypted IPFS or private cloud storage for medical records
- **Chains**: **Private parachain deployment** (hospital network only), **KILT** (credential verification), or **Phala Network** (TEE-based privacy)

### 🎫 Ticketing, Passes & Access Control

- **Core Pallets**: `pallet-nft` (unique tickets with metadata, or VIP tier tickets NFTs),`pallet-collective` (event organizer DAOs)
- **Implementation**: Each ticket as NFT with embedded QR codes and event metadata. VIP tiers represented as special NFTs with different attributes/metadata granting special privileges. Event organizers use collective pallets for multi-signature event management and revenue sharing.
- **Tools**: QR code generation libraries, mobile wallet integration, IPFS for event media
- **Chains**: **Asset Hub** (ticket NFTs), **Unique Network** (advanced NFT features like nested NFTs for combo tickets)
Loading