https://github.com/niklr/crowdmint
Decentralized crowdfunding powered by Nervos Network
https://github.com/niklr/crowdmint
defi nervos nervosnetwork
Last synced: about 1 year ago
JSON representation
Decentralized crowdfunding powered by Nervos Network
- Host: GitHub
- URL: https://github.com/niklr/crowdmint
- Owner: niklr
- Created: 2021-09-14T15:02:52.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-07-28T11:50:09.000Z (almost 3 years ago)
- Last Synced: 2025-03-29T06:11:15.299Z (about 1 year ago)
- Topics: defi, nervos, nervosnetwork
- Language: TypeScript
- Homepage: https://niklr.github.io/crowdmint/
- Size: 2.34 MB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CrowdMINT
Decentralized crowdfunding on [Nervos Network](https://www.nervos.org/).
CrowdMINT is a blockchain based solution leveraging NFTs to crowdfund community projects.
The developed smart contracts support both the fixed AON (All-Or-Nothing) and the flexible KIA (Keep-It-All) [crowdfunding models](https://www.researchgate.net/publication/272306935_Crowdfunding_Models_Keep-it-All_vs_All-or-Nothing).
A big advantage of smart contracts is most of the fees known from conventional crowdfunding platforms are eliminated.
However, possible business uses cases could involve a small fee when creating projects or after successful campaigns, directly programmed into the smart contract.
Typical crowdfunding campaigns offer rewards to contributors for specific amounts. On top of that, CrowdMINT plans to leverage NFTs to incentivize funders.
By choosing this option, the amount above the funding goal will be distributed to the holders of minted NFTs and based on the percentage defined by the campaign creator.
Example:
- Funding goal was set to 100'000 CKB and reached 500'000 CKB
- 50% of the amount above goal will be distributed to eligible funders
- NFT minting was limited to 100 with a unit price of 1'000 CKB
- Funder A minted 2 NFTs
- Funder B minted 10 NFTs
Both funders A and B not only contributed to make this crowdfunding project a success but also get a ROI.
- 50% of 400'000 CKB = 200'000 CKB is distributed among eligible funders
- Funder A gets 2% of 200'000 CKB = 4'000 CKB (2'000 CKB profit)
- Funder B gets 10% of 200'000 CKB = 20'000 CKB (10'000 CKB profit)
A decentralized crowdfunding solution such as CrowdMINT could have a great impact on the community leading to a higher number of successful projects started on Nervos.
#### Table of Content:
* [Demo](#demo)
* [Architecture](#architecture)
* [Roadmap](#roadmap)
* [Setup](#setup)
Video Walkthrough: [https://youtu.be/s-3PJrl0gQQ](https://youtu.be/s-3PJrl0gQQ)
Live Demo: [https://niklr.github.io/crowdmint/](https://niklr.github.io/crowdmint/)
Before accessing the live demo, please make sure to complete the following steps:
- [Setup Godwoken Network in MetaMask](#metamask)
- [Create a Godwoken Account by Making a Layer 2 Deposit](#deposit)
The contracts can be found in the [contracts](/contracts) folder.
They are built using [Solidity](https://docs.soliditylang.org/en/v0.7.6/) in combination with [Hardhat](https://hardhat.org/).
The workers can be found in the [workers](/workers) folder.
They are built using [TypeScript](https://www.typescriptlang.org/) and run as part of [GitHub Actions](https://github.com/features/actions).
[Pinata](https://www.pinata.cloud/) was selected in order to pin data hosted on [IPFS](https://ipfs.io/).
Whenever a project gets created or updated, the worker will detect and handle the events initiated by the smart contract.
The frontend can be found in the [client](/client) folder.
It is built using [React](https://reactjs.org/) and [GraphQL](https://graphql.org/) in combination with [TypeScript](https://www.typescriptlang.org/).
For design & layout purposes the [Material UI](https://mui.com/) framework has been chosen.
All components are using [Polyjuice Provider](https://github.com/nervosnetwork/polyjuice-provider) to interact with Nervos Layer 2 (Godwoken).
### 2021.Q4
Alpha release on Nervos Layer 2 Godwoken Testnet with the focus on functionalities for a minimum viable product.
- Start new projects as a creator
- Contribute to projects as an individual
- Withdraw as a creator or individual
### 2022.Q1
Implement [ERC-721](https://ethereum.org/en/developers/docs/standards/tokens/erc-721/) Non-Fungible Token standard.
- Enable project creators to leverage NFTs to incentivize funders
- Mint project NFTs and collect NFT rewards as an individual
- Beta release on Nervos Layer 2 Godwoken Testnet
### 2022.Q2
Public release on Nervos Layer 2 Godwoken Mainnet.
- Security audit of smart contracts
- Integrate [The Graph](https://thegraph.com/en/) to improve querying performance
- Automatized social media promotion covering trending projects
### 2022.Q3
Airdrop governance token which allows token holders to help shape the future of CrowdMINT.
Establish DAO to decentralize the decision-making process:
- Approve new projects and vote-based promotion on start page
- Flag misconducting users to be suspended or banned
The setup is split into 3 parts; [contracts](/contracts), [workers](/workers) and [client](/client). All parts require [Node](https://nodejs.org/en/) v14+ and [Yarn](https://yarnpkg.com/getting-started/install) to be installed.
To install all dependencies just run the following command in the folder containing this README:
```bash
yarn install-all
```
### Setup Godwoken Network in MetaMask
https://github.com/Kuzirashi/gw-gitcoin-instruction/blob/master/src/tasks/7.port.eth.dapp.md
Godwoken Testnet
Network Name: Godwoken Testnet
RPC URL: https://godwoken-testnet-web3-rpc.ckbapp.dev
Chain ID: 71393
Currency Symbol: <Leave Empty>
Block Explorer URL: <Leave Empty>
Godwoken Devnet
Network Name: Godwoken Devnet
RPC URL: http://localhost:8024
Chain ID: 1024777
Currency Symbol: <Leave Empty>
Block Explorer URL: <Leave Empty>
### Create a Godwoken Account by Making a Layer 2 Deposit
https://github.com/Kuzirashi/gw-gitcoin-instruction/blob/master/src/component-tutorials/4.layer2.deposit.md
## Impressions
