Decentralized Autonomous Organization (DAO) application - Users can connect wallets, create polls, and vote.

• ✅ MetaMask wallet connection
• ✅ Poll/Proposal creation
• ✅ Voting on proposals
• ✅ Transparent recording on blockchain
• ✅ 7-day voting period

• Frontend: Next. js 14 + TypeScript + React 18
• Smart Contracts: Solidity 0.8.20
• Development Framework: Hardhat
• Web3 Library: ethers.js v6
• Blockchain: Ethereum (Sepolia Testnet)

alchemy_finalproject/
├── contracts/          # Solidity smart contracts
│   └── DAO. sol        # Main DAO contract
├── scripts/           # Deployment scripts
│   └── deploy. js      # Contract deployment
├── test/              # Smart contract tests
│   └── DAO.test.js    # DAO tests
├── frontend/          # Next. js application
│   ├── src/
│   │   ├── app/       # Next.js App Router
│   │   └── components/# React components
│   └── public/        # Static files
├── hardhat.config. js  # Hardhat configuration
└── package.json       # Project dependencies

In the root directory:

npm install

For the frontend:

cd frontend
npm install
cd ..

Copy .env.example to .env:

cp .env.example .env

Edit the .env file:

SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR-API-KEY
PRIVATE_KEY=your-private-key-here

⚠️ Warning: Never commit the .env file to git!

npm run compile

npm test

Deploy to local Hardhat network:

npx hardhat node  # In one terminal window
npm run deploy    # In another terminal window

Deploy to Sepolia testnet:

npm run deploy -- --network sepolia

Note the deployed contract address!

Copy frontend/.env.local.example to frontend/.env.local:

cd frontend
cp .env.local.example . env.local

Add the deployed contract address:

NEXT_PUBLIC_CONTRACT_ADDRESS=0xYourContractAddress

cd frontend
npm run dev

The application will run at http://localhost:3000.

1. MetaMask Setup

   • Install the MetaMask browser extension
   • Connect to Sepolia testnet
   • Get test ETH: https://sepoliafaucet.com

2. Connect Wallet

   • Open the application
   • Click the "Connect Wallet" button
   • Approve in MetaMask

3. Create Proposal

   • Go to "Create New Proposal" section
   • Write a description
   • Confirm the transaction

4. Vote

   • View active proposals
   • Click on the proposal you want to vote on
   • Confirm the transaction

Creates a new proposal.

• Parameters: Proposal description
• Returns: Proposal ID

Votes on a proposal.

• Parameters: Proposal ID
• Constraints: Each address can only vote once

Retrieves proposal details.

• Returns: ID, description, vote count, deadline, status, creator

Checks if an address has voted.

Run all tests:

npm test

Run a specific test file:

npx hardhat test test/DAO.test.js

View test coverage:

npx hardhat coverage

• Never share your private keys
• Don't add the .env file to git
• Perform comprehensive tests before deploying to mainnet
• Have the smart contract professionally audited

• Token-based voting system
• Proposal execution mechanism
• Multi-choice voting
• Delegation system
• Time-locked tokens
• Proposal details with IPFS
• Mobile responsive design improvements

MIT License

1. Fork it
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push your branch (git push origin feature/amazing-feature)
5. Open a Pull Request

You can open an issue for your questions.

• Alchemy University
• Hardhat Team
• OpenZeppelin
• Ethereum Community