🌍 Community Blockchain - Web3 Disaster Relief Fund

🚀 Advanced Technologies Used

🔐 Zero-Knowledge Proofs (ZKP)

🌐 Web3 & Blockchain Stack

🛡️ Privacy & Security Technologies

⚛️ Frontend Technologies

🔗 Blockchain Infrastructure

🏗️ System Architecture

Frontend Layer

Next.js Application
├── Components (UI/UX)
├── Pages (Routes)
├── Web3 Integration
└── State Management

Web3 Integration Layer

Wagmi Hooks
├── Wallet Connection
├── Contract Interactions
├── Transaction Management
└── Network Switching

Privacy Layer

Anon Aadhaar System
├── ZK Proof Generation
├── Identity Verification
├── Nullifier Management
└── Privacy Preservation

Blockchain Layer

Ethereum Network
├── DisasterFundPool Contract
├── AnonAadhaarVote Contract
├── Verifier Contracts
└── Access Control

🎯 Core Features

🔒 Privacy-First Design

💰 Transparent Fund Management

🎛️ Admin Controls

🔐 Advanced Security

🛠️ Development Setup

Prerequisites

Node.js 18+
npm or yarn
MetaMask wallet
Ethereum testnet ETH

Installation

# Clone repository
git clone https://github.com/rushikesh0022/community_blockchain.git
cd community_blockchain

# Install dependencies
npm install --legacy-peer-deps

# Setup environment variables
cp .env.local.example .env.local
# Add your contract addresses and keys

Smart Contract Development

# Navigate to contracts directory
cd contracts

# Compile contracts
npx hardhat compile

# Run tests
npx hardhat test

# Deploy to local network
npx hardhat node
npx hardhat run scripts/deploy.cjs --network localhost

# Deploy to testnet
npx hardhat run scripts/deploy.cjs --network sepolia

Frontend Development

# Start development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

🧪 Zero-Knowledge Implementation

Anon Aadhaar Integration

// ZK Proof Generation
const proof = await generateAnonAadhaarProof({
  aadhaarData: userData,
  signal: walletAddress,
  fieldsToReveal: ["pincode"],
});

// Proof Verification
const isValid = await verifyAnonAadhaarProof(proof);

Privacy Workflow

📋 Smart Contract Functions

DisasterFundPool.sol

// Project Management
function registerDisaster(string memory name, string memory description,
                         uint256 pincode, uint256 initialFunding) external onlyOwner

// Funding
function addFundsToDisaster(uint256 disasterId) external payable

// Claims with ZK Verification
function claimFunds(uint256 disasterId, uint256 nullifierSeed,
                   uint256 nullifier, uint256 timestamp,
                   address signal, uint256[4] calldata revealArray,
                   uint256[8] calldata groth16Proof) external

// Data Retrieval
function getDisasterDetails(uint256 disasterId) external view returns (...)

Zero-Knowledge Verification

// Verify Anon Aadhaar proof
modifier verifyAnonAadhaarProof(uint256 nullifierSeed, uint256 nullifier,
                               uint256 timestamp, address signal,
                               uint256[4] calldata revealArray,
                               uint256[8] calldata groth16Proof) {
    require(anonAadhaarVerifierAddr.verifyAnonAadhaarProof(
        nullifierSeed, nullifier, timestamp, signal, revealArray, groth16Proof
    ), "Invalid proof");
    _;
}

🌍 Network Configuration

Supported Networks

Contract Addresses

# Test Environment
DISASTER_FUND_POOL_TEST=0xB7696E510113C3F3063f869de7e5Ed49Bc1E8b5C
ANON_AADHAAR_VERIFIER=0x6bE8Cec7a06BA19c39ef328e8c8940cEfeF7E281

# Production Environment
DISASTER_FUND_POOL_PROD=0x...

🔄 Data Flow

Donation Flow

User → Connect Wallet → Select Project → Enter Amount →
Sign Transaction → Blockchain Update → UI Refresh

Claim Flow

User → Generate ZK Proof → Submit Claim → Contract Verification →
Nullifier Check → Fund Transfer → Event Emission

Admin Flow

Admin → Create Project → Set Parameters → Deploy to Blockchain →
Community Access → Fund Collection → Distribution Management

📚 Additional Documentation

🤝 Contributing

📄 License

🚀 Deployment

Frontend Deployment

Smart Contract Deployment

# Deploy to testnet
npx hardhat run scripts/deploy.cjs --network sepolia

# Verify on Etherscan
npx hardhat verify --network sepolia CONTRACT_ADDRESS

🔮 Future Enhancements

🛟 Support

## Environment Setup

This project requires environment variables for configuration.

1.  **Root Directory (`.env`):**
    Create a `.env` file in the project root by copying the example:

    ```bash
    cp .env.local.example .env
    ```

    Update the following variables in the `.env` file:

    - `NEXT_PUBLIC_ANON_AADHAAR_CONTRACT_ADDRESS`: The deployed Anon Aadhaar Verifier contract address (often a standard one, check Anon Aadhaar docs). The example uses `6bE8Cec7a06BA19c39ef328e8c8940cEfeF7E281`.
    - `NEXT_PUBLIC_VOTE_CONTRACT_ADDRESS_PROD`/`_TEST`: The deployed `AnonAadhaarVote` contract address. You will get this after deployment.
    - `NEXT_PUBLIC_DISASTER_FUND_POOL_ADDRESS_PROD`/`_TEST`: The deployed `DisasterFundPool` contract address. You will get this after deployment.
    - `NEXT_PUBLIC_PROJECT_ID`: Your WalletConnect Cloud project ID. Get one from [cloud.walletconnect.com](https://cloud.walletconnect.com/).
    - `NEXT_PUBLIC_RPC_URL`: The RPC URL for the network you are deploying to (e.g., Sepolia, Holesky).
    - `PRIVATE_KEY`: The private key of the wallet you will use for _deployment only_. **Handle with extreme care.**

2.  **Contracts Directory (`contracts/.env`):**
    Create a `.env` file within the `contracts` directory:
    ```bash
    cp contracts/.env.example contracts/.env # Assuming you create an example file there
    # or manually create contracts/.env
    ```
    Add the following variables:
    - `PRIVATE_KEY`: The private key of the account you'll use to deploy the contracts. **This is critical and should be kept secret.**
    - `NEXT_PUBLIC_RPC_URL`: The RPC URL for the network (e.g., Holesky, Sepolia).
    - Optionally, add API keys if needed for block explorers (e.g., `ETHERSCAN_API_KEY`).

## Contract Deployment

The smart contracts (`AnonAadhaarVote`, `DisasterFundPool`) are managed using Hardhat.

1.  **Navigate to the contracts directory:**

    ```bash
    cd contracts
    ```

2.  **Install contract dependencies (if not already done by root `npm install`):**

    ```bash
    npm install
    # or
    yarn install
    ```

3.  **Compile the contracts:**

    ```bash
    npx hardhat compile
    ```

4.  **Deploy the contracts:**
    Ensure your `contracts/.env` file is correctly set up with your `PRIVATE_KEY` and `NEXT_PUBLIC_RPC_URL`.
    Run the deployment script:

    ```bash
    npx hardhat run scripts/deploy.cjs --network <your_network_name>
    ```

    Replace `<your_network_name>` with the network defined in your [`hardhat.config.js`](contracts/hardhat.config.js) (e.g., `sepolia`, `holesky`, `localhost`).

5.  **Update `.env`:**
    After successful deployment, the script ([`contracts/scripts/deploy.cjs`](contracts/scripts/deploy.cjs)) will output the addresses of the deployed `DisasterFundPool` and `AnonAadhaarVote` contracts. Copy these addresses and paste them into the corresponding `NEXT_PUBLIC_VOTE_CONTRACT_ADDRESS_...` and `NEXT_PUBLIC_DISASTER_FUND_POOL_ADDRESS_...` variables in the root `.env` file.

## Running the Application

1.  **Navigate back to the root directory:**

    ```bash
    cd ..
    ```

2.  **Run in development mode:**

    ```bash
    npm run dev
    # or
    yarn dev
    ```

    Open [http://localhost:3000](http://localhost:3000) in your browser.

3.  **Build for production:**

    ```bash
    npm run build
    # or
    yarn build
    ```

4.  **Start the production server:**
    ```bash
    npm run start
    # or
    yarn start
    ```

## Linting

To check code style:

```bash
npm run lint
# or
yarn lint