NFT Minting and Voting DApp

📖 Table of Contents

• Overview
• Project Insights
• Live Demo
• Features
• Smart Contract Functions
• Frontend Features
• Prerequisites
• Installation
• Usage
• More updates
• Acknowledgments
• Contact
• How to Contribute
• Contributing
• Code of Conduct
• Contribution Guidelines
• Suggestions & Feedback
• Show Your Support
• License
• Stargazers
• Forkers
• Project Admin

🔍 Overview

This is a decentralized application (DApp) built with React that allows users to mint NFTs by uploading images, vote for their favorite NFTs, and select a winner. The images are uploaded to IPFS via Pinata, and the metadata is stored on the blockchain using a smart contract.

📊 Project Insights

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	👥 Contributors

🚀 Live Demo

Experience NFT-VOTING-CONTEST live here:
👉

🌟 Features

• Connect to MetaMask wallet
• Upload and validate image files
• Upload images to IPFS via Pinata
• Mint NFTs using a smart contract
• Vote for minted NFTs
• Select and reward the winner

🌟 Exciting News...

🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💃🎉💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow NFT-VOTING-CONTEST! Let’s make learning and career development smarter – together! 🌟👨‍💻👩‍💻

👩‍💻 GSSoC is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects 🌍 while learning, collaborating, and growing together. 🌱

🌈 With mentorship, community support, and collaborative coding, it's the perfect platform for developers to:

• ✨ Improve their skills
• 🤝 Contribute to impactful projects
• 🏆 Get recognized for their work
• 📜 Receive certificates and swag!

🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this NFT-VOTING-CONTEST project family! Let's build, learn, and grow together — one commit at a time. 🔥👨‍💻👩‍💻

Smart Contract Functions

Public Functions

• mintnft(string tokenUri)

  • Mints a new NFT and stores metadata on IPFS.
  • Payable function.

• vote(uint256 tokenId, uint256 amount)

  • Votes for a specific NFT by donating ETH.
  • Payable function.

• selectwinner()

  • Returns the ID of the NFT with the highest votes.

• sendwinningamount()

  • Sends the reward pool to the winner's address.

View Functions

• returncurrentrewardpool()

  • Retrieves the current reward pool amount.

• getAllMintedNFTs()

  • Returns all minted NFTs with their details (owner, votes, token URI).

• voterinfo(address)

  • Provides voting details for a specific user.

• rewardpool()

  • Displays the total reward pool.

Frontend Features

Wallet Connection

• Allows users to connect their Ethereum wallet using MetaMask.

File Upload

• Validates and uploads NFT images (JPEG/PNG, max size 5MB).

Live Countdown Timer

• Displays remaining time for voting.

Error Handling

• Displays messages for invalid actions or errors (e.g., incorrect file type).

Data Fetching

• Automatically fetches all minted NFTs and the reward pool upon wallet connection.

Prerequisites

Before you begin, ensure you have met the following requirements:

• Node.js and npm installed
• MetaMask installed in your browser
• Pinata account and API keys

Installation

1. Clone the repository:

   git clone https://github.com/Aditya41205/NFT-MINTING.git
   cd NFT-MINTING
   

2. Install the dependencies:

   npm install
   

3. Configuration Create a .env file in the root directory and add your Pinata API credentials:

REACT_APP_PINATA_API_KEY=your_pinata_api_key
REACT_APP_PINATA_SECRET_KEY=your_pinata_secret_key

4 Running the App Start the development server:

npm start

Usage

1. Connect your MetaMask wallet by clicking the "Connect Wallet" button.
2. Upload a valid PNG or JPEG image under 5MB.
3. Click "Mint NFT" to upload the image to IPFS and mint an NFT.
4. Enter the Token ID and amount to vote for an NFT and click "Vote".
5. Click "Select Winner" to select a winner (only accessible by the contract owner).
6. Click "Send Winning Amount" to send the reward to the winner (only accessible by the contract owner).

updated.mp4

Acknowledgements

• React
• Ethers.js
• Pinata
• OpenZeppelin

More updates

Stay tuned more updates are underway to make nft minting process gasless

Issue Creation ✴

Report bugs and issues or propose improvements through our GitHub repository's "Issues" tab.

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.

Contribution Guidelines 📑

• Firstly Star (⭐) the Repository
• Fork the Repository and create a new branch for any updates/changes/issue you are working on.
• Start Coding and do changes.
• Commit your changes
• Create a Pull Request which will be reviewed and suggestions would be added to improve it.
• Add Screenshots and updated website links to help us understand what changes is all about.

Contributing is fun🧡

We welcome all contributions and suggestions! Whether it's a new feature, design improvement, or a bug fix - your voice matters 💜

Your insights are invaluable to us. Reach out to us team for any inquiries, feedback, or concerns.

🙏 Acknowledgments

• Thanks to all contributors of this project
• Special shoutout to GirlScript Summer of Code (GSSoC’25) for the amazing community and support!
• Built with dedication, collaboration, and lots of chai

📞 Contact

• GitHub Issues: Report bugs or request features
• Email: Contact the maintainers for collaboration opportunities

Feel free to reach out with any questions or feedback!

🤝How to Contribute

We love contributions from the community! Whether it's a bug report, a new feature, or a documentation improvement, we appreciate your help.

How to Contribute

1. Fork the repository and create a new branch for your changes.
2. Make your changes and ensure everything is working as expected.
3. Submit a pull request with a clear description of your changes.

Found a Bug?

• Check the issue tracker to see if the bug has already been reported.
• If not, open a new issue and provide as much detail as possible.

Have a Feature Idea?

• We'd love to hear it! Open an issue to discuss your idea.

🤝 Contributing

We welcome contributions from developers of all skill levels! Here are some ways you can contribute:

Ways to Contribute

• 🐛 Bug fixes - Help us identify and fix bugs
• ✨ New features - Suggest and implement new functionality
• 📚 Documentation - Improve our docs and guides
• 🎨 UI/UX improvements - Make the platform more user-friendly
• 🔧 Performance optimizations - Help make NFT-VOTING-CONTEST faster and more efficient
• 📱 Mobile responsiveness - Improve the mobile experience
• 🔒 Security enhancements - Help keep user data safe

Thank you to everyone who has made NFT-VOTING-CONTEST better! 💚

📜 Code of Conduct

Please refer to the Code of Conduct for details on contributing guidelines and community standards.

🤝👤 Contribution Guidelines

We love our contributors! If you'd like to help, please check out our CONTRIBUTE.md file for guidelines.

Thank you once again to all our contributors who has contributed to NFT-VOTING-CONTEST! Your efforts are truly appreciated. 💖👏

See the full list of contributors and their contributions on the GitHub Contributors Graph.

Show some by starring this awesome repository!

💡 Suggestions & Feedback

Feel free to open issues or discussions if you have any feedback, feature suggestions, or want to collaborate!

🙌 Show Your Support

If you find NFT-VOTING-CONTEST project helpful, give it a star! ⭐ to support more such educational initiatives:

• ⭐ Starring the repository
• 🐦 Sharing on social media
• 💬 Telling your friends and colleagues
• 🤝 Contributing to the project

📄 License

This project is licensed under the MIT License - see the License file for details.

⭐ Stargazers

🍴 Forkers

🧑‍💻Project Admin:

Aditya kumar mishra

👨‍🏫Mentors – NFT-VOTING-CONTEST (GSSoC'25)

Role	Name	GitHub Profile	LinkedIn Profile
Mentor 1	Sitaram sahu	Sitaram	sitaram-sahu

Give us a Star and let's make magic!

👨‍💻 Built with ❤️ by NFT-VOTING-CONTEST Team

❤️ Aditya kumar mishra and Contributors ❤️

Open an Issue | 🌟 Star on GitHub | 🚀 Live Demo

⬆️ Back to Top

Ready to show off your coding achievements? Get started with NFT-VOTING-CONTEST today! 🚀