Project overview:
This project allows anyone to create a Community Inclusion Currency (CIC).
At Grassroots Economics, we hep communities build their own currencies.
These currencies are backed by goods and services of the community.
Individuals within the community can mint some of their currency in exchange for a promise to redeem that amount of currency for their goods and services.
This project allows individuals to add these pledges to a community currency, specifying what goods and services they are pledging, the amount, value, etc.
The front end has a table where these details are filled out.
A submit button allows the CIC data to be stored in the smart contract, but the CIC has not been minted yet.
When all backers have signed off on their pledges, the CIC can be minted.
Minting distributes CIC to all the backers in proportion to the value of goods and services they pledged.
The CICs are ERC20s.
Directory Structure:
This project was bootstrapped with a React-app.
The public folder has React HTML.
The App folder has the Javascipt and CSS, and a contracts folder with smart contract JSON files.
The App folder has App.js, which is where most of the code was written for this project.
The Client folder has the front end components (HTM, CSS, JS).
The Contracts folder has the smart contracts.
The migrations folder has config for truffle migrations.
Front End:
Demo is deployed on Ropsten testnet and is hosted at:
https://communityinclusioncurrencies.firebaseapp.com/
Video of me walking through the app: https://drive.google.com/file/d/19Y8Y_QKNURlGiTTPv1LmVL-ZIQs_6kw7/view?usp=sharing
Dependencies and installation (mac):
npm
brew install node
truffle (for building, testing, and depoying contracts)
npm install -g truffle
ganache (for testing smart contracts with a local node)
https://github.com/trufflesuite/ganache-ui/releases
react (used for bootstrapping front-end)
npm install -g create-react-app
Metamask (a web wallet for interacting with Ethereum blockchain)
https://metamask.io/
Ropsten testnet Ether can be found for free at a faucet: https://faucet.ropsten.be/
Testing
Solidity and Javascript tests are in the test folder. to run the tests, get a local testnet running on port 8545, then run:
truffle test
My public Ethereum account: 0x3E7F054563682c42bd4907b88D0DC27557992576