https://github.com/envoy-vc/crowdfunding-dapp
https://github.com/envoy-vc/crowdfunding-dapp
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/envoy-vc/crowdfunding-dapp
- Owner: Envoy-VC
- License: apache-2.0
- Created: 2022-12-20T13:22:48.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-03-15T09:38:55.000Z (about 2 years ago)
- Last Synced: 2025-01-23T00:25:29.033Z (3 months ago)
- Language: JavaScript
- Homepage: https://crowdfunding-dapp-envoy-vc.vercel.app/
- Size: 1.98 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Welcome to CrowdWork 🎉
A decentralized crowdfunding app built on the Polygon Blockchain.
With CrowdWork, you can easily create and manage crowdfunding campaigns for your projects. Our smart contract ensures that funds are held securely and are released to the campaign creator only when the campaign reaches its goal or after a specified time period has passed.
🚀 Smart contract repository: https://github.com/Envoy-VC/crowdfundng-contract
✅ Contract address on the Polygon Mumbai: https://mumbai.polygonscan.com/address/0xb7A1C0949Fa55EC7e92c6Dbf7F18B1d61237aa74
🖼️ OpenSea Collection: https://testnets.opensea.io/collection/crowdwork-dao
To get started with CrowdWork, you will need to have a web3 enabled browser and an Ethereum wallet. You can then interact with the contract on the Polygon Mumbai to create and contribute to campaigns.
---
# How to use the App
To begin playing with the app, set up the web3 wallets and obtain some testnet tokens.
---
## Setting up Wallet
First and foremost, you will require a web3 wallet. You may instal and configure Metamask by following these steps:
1. First, visit the MetaMask website (https://metamask.io/) and click on the "Get Chrome Extension" button to install the MetaMask extension for Google Chrome.
2. Click "Add to Chrome" and then "Add Extension" to install MetaMask.
3. Click on the MetaMask icon in the top right corner of your browser to open the app.
4. Follow the prompts to set up your MetaMask account. This will include creating a password and choosing a seed phrase to secure your account. Make sure to keep your seed phrase in a safe place, as you will need it to access your account if you ever lose your password.
Next, the current version of the app operates on the Polygon Mumbai testnet, so you'll need to add the network to your wallet and obtain some testnet coins before you can experiment with it.
1. Once you have set up your MetaMask account, click on the "Networks" dropdown in the top left corner of the app.
2. Click on the "Add Network" button.
3. In the "New Network" dialog box, enter the following information:
- Network Name: Polygon Mumbai
- New RPC URL: https://matic-mumbai.chainstacklabs.com
- ChainID: 80001
- Symbol: MATIC
- Block Explorer URL: https://mumbai.polygonscan.com/
4. Click the "Save" button to add the Polygon Mumbai network to your MetaMask wallet.
5. You should now be able to switch to the Polygon Mumbai network in the "Networks" dropdown.
That's it! You should now be able to use MetaMask to interact with the Polygon Mumbai network. To get some Testnet funds just follow the following steps:-
1. To get testnet funds, you can visit the Polygon Faucet (https://faucet.polygon.technology/) and enter your MetaMask wallet address to request testnet tokens.
2. Once you have received your testnet tokens, you should be able to see them in your MetaMask wallet and use them to interact with the Polygon Mumbai testnet.
---
## Creating a Campaign
1. First, open the app and navigate to the campaign section.
2. In the "Create a Campaign" form, fill in the following details:
- Name: Enter the name of your campaign.
- Title of campaign: Enter a brief, catchy title for your campaign that summarizes its purpose.
- Story: Explain why you are raising this campaign and what it will be used for. This should be a compelling narrative that inspires people to contribute.
- Goal target: Set a goal target for your campaign in terms of the amount of funds you want to raise.
- Category: Choose a category that best describes the theme of your campaign. This will help people find your campaign when searching for similar projects.
- Start date: Choose the date when your campaign will go live and start accepting contributions.
- End date: Choose the date when your campaign will end and no longer accept contributions.
- Campaign banner: Upload an image that will be used as the banner for your campaign. This should be a high-quality image that represents the theme of your campaign.
- NFT image: If you plan to give out non-fungible tokens (NFTs) as a reward to your funders, upload an image of the NFT here.
3. When you are finished filling out the form, click the "Create New Campaign" button to create your campaign.
4. The app will then process the transaction and create your campaign. This may take a few minutes, depending on the blockchain network you are using.
That's it! You should now have a live crowdfunding campaign that people can contribute to. Make sure to promote your campaign and engage with your funders to encourage them to contribute.
---
## Contributing to a Campaign
[
1. First, navigate to the campaign you want to contribute to. This can usually be done by browsing through the campaigns on the dashboard.
2. Once you have found the campaign, look for a button or form that allows you to make a contribution. This is labeled a "Fund Campaign".
3. In the form or input field provided, enter the amount you want to contribute to the campaign. This amount is in "MATIC", the native currency for Polygon Blockchain.
4. Click the "Fund this Campaign" button to initiate the transaction process.
5. The app will then process the transaction and send it to the blockchain network.
6. A MetaMask pop-up window will appear, asking you to confirm the transaction. Click "Accept" to confirm the contribution.
7. Wait for the transaction to be processed by the network. This can take 15-30 seconds, depending on the network conditions.
Once the transaction has been processed, your contribution will be recorded on the blockchain and added to the campaign's total funds.
That's it! You have successfully contributed to a campaign. Make sure to keep track of your contribution and any rewards or updates from the campaign organizers.
---
### How to Receive NFTs for your Contributions
1. After you have successfully donated to a campaign, your NFT will be automatically minted and added to your collection.
2. To view your NFTs, go to https://testnets.opensea.com/account and sign in with your account.
3. On your profile page, you should see a list of your NFTs, including any that you received from donating to campaigns.
4. If you don't see your NFTs in the main list, try looking in the "Hidden" tab. This is where NFTs that you have not explicitly shown on your profile will be displayed.
5. You can click on any of your NFTs to view more details about them, including their attributes and metadata.
---
## Withdrawing Funds
1. First, make sure that you are the owner of the campaign. You will typically need to be the person who created the campaign.
2. Navigate to the campaign page and look for a button this is labeled as "Withdraw".
3. Note that you will typically only be able to withdraw funds if the end date of the campaign has passed. If the campaign is still active, you will need to wait until it is completed before you can withdraw the funds.
4. Click on the "Withdraw" button to initiate the withdrawal process.
5. A MetaMask pop-up window will appear, asking you to confirm the transaction. Click "Accept" to confirm the withdrawal.
6. Wait for the transaction to be processed by the network. This can take a few minutes, depending on the network conditions.
7. Once the transaction has been processed, the funds will be transferred from the campaign's wallet to your account.
That's it! You have successfully withdrawn the funds from your campaign. Make sure to keep track of your funds and any tax or legal obligations that may apply.
---
❤️ Thank you for using CrowdWork! We hope it helps you achieve your crowdfunding goals. If you have any questions or feedback, please feel free to reach out to us at [Twitter](https://twitter.com/Envoy_1084)
---