https://github.com/jochasinga/flowwow
NFT petshop built on Flow blockchain and IPFS
https://github.com/jochasinga/flowwow
Last synced: 8 months ago
JSON representation
NFT petshop built on Flow blockchain and IPFS
- Host: GitHub
- URL: https://github.com/jochasinga/flowwow
- Owner: jochasinga
- Created: 2021-08-26T03:17:41.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-11-06T04:11:10.000Z (over 4 years ago)
- Last Synced: 2025-04-19T21:41:05.146Z (about 1 year ago)
- Language: TypeScript
- Size: 1.84 MB
- Stars: 28
- Watchers: 2
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🐶 Flowwow
Flowwow is an NFT pet marketplace built on [Flow](https://onflow.org) and [NFT Storage](https://nft.storage). It is intended to be a demo of how to mint and manage NFTs on the Flow blockchain, storing them in IPFS and Filecoin via the NFT.storage service. You can browse delightful pets, adopt them (transfer from marketplace to your wallet), and release them (transfer from your wallet back to the marketplace).
### Prerequisites
First, make sure you install [Flow CLI](https://docs.onflow.org/flow-cli/install/) and sign up for a [NFT.storage](https://nft.storage) account to get the API token. You will also need to have [Docker](https://docs.docker.com/engine/install/) and [Docker Compose](https://docs.docker.com/compose/install/) installed.
### Get Started
1. Run the Flow chain emulator, local dev wallet, and the React app with `docker-compose up`
2. Deploy the [`PetshopContract`](./src/flow/contracts/PetshopContract.cdc) with `flow project deploy`
3. Go to `http://localhost:3000`
4. Click Login or Signup button to connect to a local dev wallet, which will let you choose an account. You can choose a separate account from the emulator (service account) or create new ones. Then, select "Activate Collection" under the dropdown menu for every new account.
5. Try minting, adopting (transfer from marketplace to you), and releasing (transferring back to the marketplace) pet NFTs.
### Features
- [ ] **Authentication**
- [x] Local dev wallet (emulator)
- [ ] Flow-compatible wallets (testnet)
- [x] **Non-fungible Token**
- [x] Account setup
- [x] Minting (pre-minting and user-minting)
- [x] Withdrawing and deposit
- [ ] **Fungible Token**
- [ ] Account setup
- [ ] Minting
- [ ] Withdrawing and deposit
- [ ] Storage
- [x] Store images on NFT Storage
- [ ] Store all metadata on NFT Storage (testnet or mainnet)
### Interacting with CLI
It can be helpful to directly interact with the contract(s) via the Flow CLI. Try running the following in a separate terminal, while the emulator is running:
#### GetAllTokenIds
Get all the NFTs' IDs on the chain
`flow scripts execute ./src/flow/scripts/pets/GetAllTokenIds.cdc`
#### CheckTokenMetadata
Get the NFT's metadata from its ID
`flow scripts execute ./src/flow/scripts/pets/CheckTokenMetaData.cdc `
#### MintPetToken
Mint a new NFT of your own. Check out [`pets.json`](./pets.json) to get the idea of the JSON string to pass as an argument. Don't forget to include the IPFS link in the `uri` field (or any link to an online image resource) for your NFT to show up.
`flow transactions send ./src/flow/transactions/pets/MintPetToken.cdc `
## Copyrights
Dual-licensed under MIT and Apache 2. Dog and cat photos from Unsplash.