Skip to content

A decentralized fund raising application, efficient for raising funds, and granting loan requests through a approve system.

Notifications You must be signed in to change notification settings

jamaltheatlantean/community-we-fund

Repository files navigation

A COMMUNITY FUNDING CONTRACT

I created this contract as one of six projects that i came up with after i was confident enough and ready to start building dApps that'll go on the block-chain.
I built it to help boost close community/organizational funding, for the purpose of granting loans to it's members.

Community members are assigned the role of Benefactor when they register and pay the registration fee.

If a member of the community was in need of funding they will simply fill out a request form stating how much they needed and to be more convincing they are also required to give the community a good reason as to why they should approve the loan request. If more than half of the community approves of the individuals request then they can get the funds transferred to them by calling the execute function on the smart contract.

BUILDING THE DAPP

It was fun to build and get creative in creating this smart contract by combining a few things i had learned throughout my learning curve.

Getting Started on this project

Prerequisites

  • npm
    npm install npm@latest -g

Installation

i. Get a free API Key at https://alchemyapi.io

ii. Clone the repo

git clone https://github.com/jamaltheatlantean/community-we-fund.git

iii. Install npm
npm install

iv. Enter your API in config.js

const API_KEY = 'ENTER YOUR API';

Install Hardhat Dependencies

npm save --dev @nomiclabs/hardhat-ethers@npm:hardhat-deploy-ethers ethers @nomiclabs/hardhat-etherscan @nomiclabs/hardhat-waffle chai ethereum-waffle hardhat hardhat-contract-sizer hardhat-deploy hardhat-gas-reporter prettier prettier-plugin-solidity solhint solidity-coverage dotenv

Deploy on rinkeby testnet

npx hardhat deploy --network rinkeby

You can get some rinkeby faucet by following steps:

i. Go to https://faucets.chain.link/rinkeby
ii. Connect your wallet
iii. Copy and Paste your address.
iv. Pass the Captcha.
v. Click on send request and wait confirmation.

Or you can test the functions on an IDE by copy, pasting, and compiling the code on https://Remix.ethereum.org

Usage

1.) Keep a community registry
2.) Boost community savings
3.) Safely store community funds on the block-chain
4.) Loan ETH to community members in need

Project Status

This repo is no longer maintained. Contact me for any enquiries.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Contact

Author - Jamal The Atlantean
Reach me on Twitter Or send me a mail - [email protected]

Project Link: https://github.com/jamaltheatlantean/community-we-fund

About

A decentralized fund raising application, efficient for raising funds, and granting loan requests through a approve system.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published