Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shawntabrizi/substratekitties
A simple cryptokitties-like runtime built with Substrate
https://github.com/shawntabrizi/substratekitties
Last synced: 4 days ago
JSON representation
A simple cryptokitties-like runtime built with Substrate
- Host: GitHub
- URL: https://github.com/shawntabrizi/substratekitties
- Owner: shawntabrizi
- License: mit
- Created: 2019-01-09T10:25:00.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-12T15:21:59.000Z (2 months ago)
- Last Synced: 2024-09-13T08:09:17.507Z (2 months ago)
- Language: Rust
- Homepage:
- Size: 15.4 MB
- Stars: 26
- Watchers: 3
- Forks: 14
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Substrate Kitties Package
This repository contains a end to end working package of Substrate Kitties repositories.
This includes:
- The Substrate Kitties Pallet
- The Polkadot SDK Minimal Template
- The Substrate Kitties UI
These projects should work together to show an example of a simple decentralized application (DApp) using the Polkadot technology stack.
[Tutorials are available](#tutorials) to learn how to build these projects.
## Creating the Package
This package was created by cloning a few public repositories, and bringing them together.
**Substrate Kitties Pallet**
```
git clone --depth=1 --branch=gitorial https://github.com/shawntabrizi/substrate-collectables-workshop
rm -rf ./substrate-collectables-workshop/.git
```
**Polkadot SDK Minimal Template**
```
git clone --depth=1 --branch=master https://github.com/paritytech/polkadot-sdk-minimal-template
rm -rf ./polkadot-sdk-minimal-template/.git
```
We need to update the minimal template to include the `pallet-kitties`, which is shown in this commit:
https://github.com/shawntabrizi/substratekitties/commit/4129751eba6d12d7cdaff3c45131546f4d037a43
**Substrate Kitties UI**
This project is local to this repo.
Built by: @marcuspang (thank you!)
PR: https://github.com/shawntabrizi/substratekitties/pull/42
## Setup
To run this project, you will need to install some prerequisites and compile the projects.
### Prerequisites
This package uses Rust, NodeJS, and the Polkadot SDK.
To install all the prerequisites needed for Rust and the Polkadot SDK, run:
```sh
curl --proto '=https' --tlsv1.2 https://raw.githubusercontent.com/paritytech/polkadot-sdk/master/scripts/getting-started.sh -sSf | sh
```
To install NodeJS, I recommend you use `nvm` which is a way to install NodeJS and manage which version you use.
See the instructions here: https://github.com/nvm-sh/nvm
### Compiling and Running the Blockchain
Change to the `polkadot-sdk-minimal-template` directory:
```sh
cd polkadot-sdk-minimal-template
```
Then build the node binary:
```sh
cargo build --release
```
This should create the `minimal-template-node` binary which you can run like this:
```sh
./target/release/minimal-template-node --dev
```
This already includes `pallet-kitties` in the runtime.
You should see that blocks are being produced in the terminal logs.
### Running the UI
See the [README included with the UI](./papi-ui/README.md).
## Tutorials
You can learn how to build the different parts of the Substrate Kitties project by following these tutorials.
### Substrate Collectables Workshop
Learn how to build your first Polkadot SDK Pallet:
https://shawntabrizi.github.io/substrate-collectables-workshop/
### Build a Custom Blockchain
Learn how to build your first custom blockchain:
TODO
### Build a Polkadot SDK Front End
Learn how to build your first Polkadot SDK compatible front end:
TODO