CrowdChain

CrowdChain is a decentralized crowdfunding platform built on the Ethereum blockchain. It allows users to create and contribute to various campaigns, with the option to set up milestones for the campaigns.

Table Of Content

• CrowdChain
  • Table Of Content
  • About
  • Features
  • Technologies Used
    • Frontend(Client)
    • Blockchain (Contracts)
    • Backend (Server)
  • Project Structure
    • Contracts
      • CampaignBase Contract
      • CampaignDonation Contract
      • CampaignUpdates Contract
      • Crowdfunding Contract
      • CrowdchainToken Contract
    • Client
    • Server
  • Testing
  • Deployment
  • Upcoming Features
  • GIFs
    • Desktop
    • Mobile

About

CrowdChain is designed to provide a decentralized and transparent platform for crowdfunding. Users can create campaigns with or without milestones. Milestones can be Pending, Funding, Withdrawn, Started, Completed, Rejected.

For campaign without milestones, donors can request for a refund before the campaign refund deadline has passed. Campaign owner can withdraw the campaign funds once the refund deadline is over.

For campaigns with milestone, donors can request for a refund before the first milestone is approved. Milestone approval happens when the campaign owner has withdrawn the funds raised for the milestone.

Campaign owners can update their donors about the current status of their campaign by posting updates.

Tokens are awarded to donors at the end of each successful campaign. Also, a fee of 2% is paid to the creator of the contract(me of course😅).

Features

• Campaign Creation: Users can create crowdfunding campaigns with or without milestones.
• Donations: Donors can contribute to active campaigns by donating any ERC20 token, including Ether.
• Milestones: Campaigns can be set up with up to 4 milestones, each with its own target amount and deadline.
• Withdrawal: Campaign owners can withdraw the funds once the campaign's goal is reached or a milestone is completed.
• Refunds: Donors can request refunds for their contributions before the campaign's refund deadline.
• Token Distribution: Successful campaigns will distribute a CrowdChain (CC) token to all donors proportional to their contributions.

Technologies Used

Frontend(Client)

• Next.js: React framework for building the user interface.
• TailwindCSS: Utility-first CSS framework for styling the application.
• ShadCn: UI component library.
• React Hook Form: Form management library.
• Zustand: State management library.
• Wagmi: Ethereum blockchain interaction library.
• React Query: Data fetching and caching library.
• Connectkit: Wallet connection library.

Blockchain (Contracts)

• Solidity: Programming language for writing the smart contracts.
• Foundry: Development environment.

Backend (Server)

• Express.js: Backend server.
• @filebase/sdk: Library for uploading campaign cover images to the IPFS decentralized storage network.
• Redis: To cache some information displayed on the home page.
• MongoDb: To persist some of the cached data.
• Viem: To communicate with the blockchain.

Project Structure

The CrowdChain project is divided into three main parts:

Contracts

The contract folder contains the smart contracts for the CrowdChain platform. The main contracts are:

CampaignBase Contract

This is an abstract contract that provides the core functionality to create campaigns.

CampaignDonation Contract

It is an abstract contract that extends the CampaignBase contract and provides the core functionality to donate, request refund and withdraw funds from campaigns.

CampaignUpdates Contract

It is an abstract contract extends the CampaignDonation contract and adds functionality to post and get updates.

Crowdfunding Contract

This is the main contract that get deployed. It extends the CampaignDonation contract.

CrowdchainToken Contract

This contract is an ERC20 token that is distributed to successful campaign donors.

Client

The client folder contains the Next.js-based frontend application that allows users to interact with the CrowdChain platform.

Server

The server folder contains the Express.js-based backend server responsible for handling the upload of campaign cover images to the IPFS network.

Testing

The important functions in the smart contracts have been thoroughly tested using foundry.

Deployment

CrowdChain is currently deployed on the Base Sepolia test network.

• Crowdfunding: 0x37A4EE129D495a884d6077c4C61e74Fb77A3B783
• Crowdfunding Token: 0xa8eca398be7507d8854bf9645b8118f7ea45c4d8

Upcoming Features

• Display total donations, campaigns and supported tokens on the home page
• Display recent donations, updates and refunds on the home page
• Allow campaign owners to post updates
• Allow donors to claim their CrowdChain (CC) tokens.
• Allow donors with CC tokens to vote in a milestoned campaign.
• Allow donors with CC tokens to vote for urgent withdraw of campaign funds.
• Allow stablecoins donations.
• Provide a means to get current price of supported coins/tokens.

GIFs

Desktop

Mobile