BarangayChain

BarangayChain: Transparency Community Governance on the Blockchain

BarangayChain is a blockchain-based platform that transform barangay governance in the Philippines through transparency, accountability, and citizen participation. In the Philippines, barangays often face certain issues such as ghost projects, inflated receipts, and delayed audits that still manifest and even became a norm. BarangayChain addresses these issues by developing decentralized technology that provides a transformative solution for managing community projects, budgets, and decision-making processes. This platform does not only allow barangay officials to manage projects but also create projects with complete transparency, while citizens can actively participate through voting on initiatives and monitoring budget allocation in real-time.

Key Features:

• Project Management: Allows to track community projects from proposal to completion with a progress monitoring
• Budget Transparency: View detailed budget schedules, fund releases, and even expenditure tracking on a blockchain ledger
• Citizen Voting: Exercise your right to vote through secure, verifiable voting on barangay projects and initiatives
• Contractor Management: Transparent in selecting contractor and payment tracking
• Audit Trail: Complete and clean records of all transactions and decisions

Project Lifecycle:

1. Project Creation Officials create projects with defined milestones and budgets. The treasury validates budget availability and the project becomes visible to whitelisted vendors.

2. Milestone Submission Vendors complete work and submit milestones with supporting documentation (photos, reports) uploaded to IPFS. The milestone enters "Pending Verification" state for citizen voting.

3. Voting & Verification Citizens review the submitted documentation and vote to approve or reject the milestone. A minimum of 5 citizen votes is required for quorum. Each citizen can vote once per milestone.

4. Completion & Fund Release After sufficient verification votes, officials finalize the milestone. The treasury automatically releases PYUSD payment to the vendor, and the milestone is marked as completed. Fund Flow: Treasury → Project Escrow → Vendor Payment

Key States: Projects: Active → In Progress → Completed Milestones: Pending → Submitted → Under Review → Completed

Conclusion: By using blockchain technology, BarangayChain minimizes corruption risks, ensures proper utilization if fund and empowers Filipino citizens to fully trust local government operations. It transforms Philippine governance into a trustworthy, transparent, and community-driven in this digital age.

BarangayChain is designed with a secure yet simple blockchain setup that keeps every project, vote, and fund transparent.

Smart Contract Layer:

• BarangayChain.sol – the core protocol that handles project management, budget releases, and citizen voting
• CitizenNFT.sol – serves as each citizen’s digital ID, ensuring verified participation
• Treasury.sol – manages fund allocation and budget releases with built-in transparency
• BarangayAccessManager.sol – handles role-based permissions for Admins, Officials, Contractors, and Citizens
• Developed using Solidity with OpenZeppelin libraries for security and access control
• Built, tested, and deployed through Hardhat, with full verification and extensive test coverage for reliability

Frontend Application:

• Powered by Next.js and React for a fast, modern web experience
• TypeScript ensures clean and consistent code
• Wagmi and Viem make blockchain interaction smooth and reliable
• Material UI (MUI) provides a polished, consistent design
• TanStack Query ensures quick and efficient data fetching

Architecture:

• Structured as a monorepo using pnpm workspaces to organize contracts and app packages
• Maintains a transparent audit trail, recording every project update, vote, and transaction directly on-chain
• Uses Blockscout to monitor transaction status and send real-time notifications
• Employs an automated treasury system using PYUSD as the stable treasury token for secure and predictable fund management
• Enforces role-based access control at the smart contract level, ensuring accountability at every step

Together, these components create a tamper-proof, transparent, and citizen-friendly governance system that makes community management simple and trustworthy.