{"id":32782114,"url":"https://github.com/mongetro/poap-plus","last_synced_at":"2026-04-13T03:02:14.789Z","repository":{"id":322405532,"uuid":"1074718792","full_name":"Mongetro/poap-plus","owner":"Mongetro","description":"Blockchain Proof of Attendance Protocol on EVM - Digital attendance certification system with NFT badges","archived":false,"fork":false,"pushed_at":"2025-11-04T08:31:00.000Z","size":200,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-04T10:18:18.807Z","etag":null,"topics":["blockchain","ethereum","ipfs","nft","nodejs","react","smartcontracts","solidity"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mongetro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-12T10:51:26.000Z","updated_at":"2025-11-04T08:31:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Mongetro/poap-plus","commit_stats":null,"previous_names":["mongetro/poap-plus"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Mongetro/poap-plus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mongetro%2Fpoap-plus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mongetro%2Fpoap-plus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mongetro%2Fpoap-plus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mongetro%2Fpoap-plus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mongetro","download_url":"https://codeload.github.com/Mongetro/poap-plus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mongetro%2Fpoap-plus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":282713022,"owners_count":26714760,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-04T02:00:05.887Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","ethereum","ipfs","nft","nodejs","react","smartcontracts","solidity"],"created_at":"2025-11-04T21:00:33.559Z","updated_at":"2025-11-04T21:01:47.503Z","avatar_url":"https://github.com/Mongetro.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# POAP+ - Proof of Attendance Protocol on EVM\n\nThis repository contains a decentralized attendance certification system built on Ethereum. Create, distribute, and verify digital attendance badges as NFTs with unique metadata and IPFS storage.\n\n## Features\n\n- Digital Badges: ERC-721 NFTs for event attendance proof\n- IPFS Integration: Decentralized image and metadata storage\n- Multi-Network Support: Deploy on Ethereum, Sepolia, Polygon, and local networks\n- Verification System: Real-time attendance verification on blockchain\n- Custom Metadata: Unique badge metadata for each participant\n- Modern UI: React-based responsive frontend\n\n## Prerequisites\n\nBefore you begin, ensure you have:\n\n- [Node.js](https://nodejs.org/fr) (v18 or higher)\n- [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/)\n- [MetaMask](https://metamask.io/) or compatible Ethereum wallet\n- Testnet ETH (for Sepolia deployment). You can get some on [Alchemy Faucet ](https://www.alchemy.com/faucets/ethereum-sepolia) or [Google Faucet ](https://cloud.google.com/application/web3/faucet/ethereum/sepolia)\n\n## Quick start\n\n## 1. Clone and Install\n\nThe first things you need to do are cloning this repository and installing its\ndependencies:\n\n```sh\ngit clone https://github.com/Mongetro/poap-plus.git\ncd poap-plus\nnpm install\n```\n\n## 2. Backend Configuration\n\nSet up environment variables\n\nCreate a .env file in the project root :\n\n```sh\ncp .env.example .env\n```\n\nPS : ⚠️ NEVER commit real private keys in your .env to version control\n\nOnce you have copied the .env file, configure all environment variables according to the instructions included in the file.\n\n## 3. Compile and Deploy Smart Contract\n\nCompile your smart contract :\n\n```sh\nnpx hardhat compile\n```\n\nYou can deploy your smart contract on a local network like Hardhat or on Ethereum testnets. In our case, we will use the Sepolia testnet.\n\n```sh\nnpx hardhat run scripts/deploy.js --network sepolia\n```\n\n## 4. Frontend Setup\n\nNavigate to frontend directory\n\n```sh\ncd frontend\n```\n\nInstall frontend dependencies\n\n```sh\nnpm install\n```\n\nCreate a .env file in the frontend directory:\n\n```sh\ncp .env.example .env\n```\n\nPS : ⚠️ NEVER commit real private keys in your .env to version control\n\nOnce you have copied the .env file, configure all environment variables according to the instructions included in the file.\n\n## 5. Start Frontend Application\n\nRun development server\n\n```sh\nnpm run dev\n```\n\nThe Decentralized Application (dApp) will start and typically be available at [http://localhost:5173/](http://localhost:5173/).\n\nYou will need to have a compatible Ethereum wallet, such as [MetaMask](https://metamask.io/) installed and listening to the network you have chosen to deploy your smart contract on ( `sepolia` in our case).\n\n## User Guide\n\n## 1. Connect Wallet\n\n- Open the application in your browser at [http://localhost:5173/](http://localhost:5173/)\n- Connect your wallet (MetaMask)\n- Ensure you're on the correct network (Localhost, Sepolia, etc.)\n\n## 2. Create an Event\n\n- Navigate to \"Create Event\"\n- Fill in event details (name, date, organizer)\n- Upload an event image (stored on IPFS)\n- Send data and confirm the blockchain transaction via your wallet\n\n## 3. Mint Badges\n\n- Go to \"Mint Badge\"\n- Select the event and enter participant details\n- POAP system will generate unique metadata and mint the NFT\n- Badges are automatically transferred to participants' wallets\n\n## 4. Verify Attendance badges\n\n- Use \"Verify\" page to check badge ownership\n- Enter any Ethereum address to verify attendance\n- View detailed badge information and metadata\n\n## Troubleshooting\n\n**Common Issues**\n\n**_Metamask Connection Issues_**\n\n- Ensure you're on the correct network\n- Reset account in MetaMask (Settings \u003e Advanced \u003e Clear activity tab data)\n\n**_Transaction Failures_**\n\n- Check you have sufficient gas funds (ETH)\n- Verify contract is deployed on current network\n\n**_Frontend Build Issues_**\n\n- Clear node_modules and reinstall dependencies\n- Check all environment variables are set\n- Verify React and dependency versions\n\n**Happy _building_! Enjoy ! 🎉**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongetro%2Fpoap-plus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmongetro%2Fpoap-plus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongetro%2Fpoap-plus/lists"}