PullQuestAI

Problem Statement

PullQuest: Decentralized Protocol Enabling Open Source MeritocracyBuilt on Hedera Hashgraph with Self-Sovereign Identity IntegrationPullQuest aims to be a decentralized protocol creating a self-sustaining, reliable economy around open-source software development. Unlike traditional volunteer contributor models, PullQuest resolves deep challenges facing the open-source ecosystem using blockchain-based incentives, AI-driven quality assurance, and identity verification systems.Core Problem StatementOpen-source software has three fundamental challenges:Maintainer Burnout — Popular repositories are inundated with spammy, low-quality, and poorly thought out pull requests.No Incentives — Critical bug fixes and large feature contributions are often leveraged for free, with no direct reward for the individuals who create that value.Flimsy Hiring Signals — GitHub profiles alone give limited, noisy signals to employers about developers' real-world capabilities and impact.Solution ArchitecturePullQuest creates a transparent, merit-based marketplace that addresses these challenges using several interconnected mechanics:Economically Abstracted Filtering SystemContributors stake HBAR tokens to submit pull requests; staking encourages only serious, quality submissions.The "skin in the game" approach filters out spam and low-quality submissions.Successful PRs return the stake to contributors plus a small bonus. Spammy or poor-quality PRs result in stake forfeiture.Evaluation of Quality with AIPullQuestAI uses ML models to evaluate code quality, effort, and value to the project.Maintainers' feedback can influence stake refunds to encourage good-faith contributions that need refinements.PullQuestAI assigns a quantifiable Quest Score that reflects both contribution quality and developer skill.Monetary RewardsMaintainers fund bounties in HBAR for specific features or issues.Bounties are managed trustlessly with atomic payouts upon PR acceptance.This eliminates manual payment processing and reduces reliance on mutual trust.Verified Developer ProfileDeveloper profiles on-chain create a reputation system with verified contributions and a visible learning path.Can integrate self-sovereign identity (e.g., Aadhaar authentication where appropriate) without compromising privacy.Provides immutable, verifiable resumes built from real contributions.Technical ImplementationBlockchain InfrastructureNetwork: Hedera Hashgraph (chosen for fast finality, low fees, and enterprise-grade consensus).Smart Contracts: Manage staking, escrow bounties, and automatic payouts.Consensus Service (HCS-2): Immutably records contribution metadata and achievement data.Identity LayerSelf-sovereign identity with optional Aadhaar verification for stronger Sybil-resistance.On-chain reputation tied to verified identities while preserving user privacy.AI Analysis EngineCombines NLP and static analysis to assess code quality and detect patterns of legitimate vs. spam contributions.Learns from maintainer feedback to improve assessments over time.User ExperienceGasless transactions paid by the platform for a Web2-style experience.GitHub integration for seamless workflow (PR monitoring, comments, status checks).Role-based UIs: contributor, maintainer, and company dashboards.Economic ModelThe protocol runs three interconnected loops:Reputation LoopUsers get a starting allocation of HBAR for staking based on initial reputation or stake.Contributions increase reputation and earning potential.Spam or poor contributions reduce stake and reputation.Financial LoopMaintainers fund bounties for needed work.Contributors earn stake returns and bounty payments.Direct monetary incentives for useful open-source work.Talent LoopCompanies subscribe to search vetted developer profiles.Revenue funds platform operations and rewards top contributors.Creates a self-sustaining funding model for the ecosystem.Features DevelopedXP System: All contributions are recorded as experience points on-chain.Bounty Transfers: Completed work is paid directly in HBAR.GitHub Integration: PRs are automatically monitored and comments added.Wallet Management: HBAR transfers and balance tracking.Identity Verification: Profiles created via verification (e.g., Aadhaar where applicable).Recording in HCS-2: All platform activity is logged immutably.Impact and Value PropositionFor ContributorsDirect monetary payments for open-source work.Verifiable, tamper-proof portfolio of contributions.Less noise in contribution processes, strengthening maintainer relationships.For MaintainersSignificant reduction in low-quality PR noise.Ability to incentivize specific tasks with bounties.Improved access to higher-quality contributors via reputation filtering.For CompaniesAccess to pre-vetted talent with proven track records.Objective evaluation of developer skills through Quest Scores and on-chain contribution history.Reduced hiring costs and improved candidate quality due to clearer, verifiable signals.

Solution

Technical ArchitectureBlockchain Infrastructure - Hedera HashgraphI chose Hedera over traditional blockchains for several critical technical advantages. The sub-second finality enables immediate transaction confirmation, which is essential for a responsive user experience.The fixed low fees (around $0.0001 per transaction) make micro-transactions economically viable - something impossible on Ethereum or Bitcoin. I leveraged Hedera Consensus Service (HCS-2) for immutable logging without gas costs, creating a transparent audit trail of all platform activities.My smart contracts handle XP tracking, bounty escrow, and automated payouts using Solidity on the Hedera EVM. I implemented separate contract functions for different operations to maintain modularity and easier upgrades.Dual Backend ArchitectureI built two specialized backend services to handle different aspects of the platform:PullQuest Backend (Main Application Server)This handles the core application logic including user authentication, role-based access control, and the main dashboard functionalities.I implemented JWT-based authentication with role differentiation for contributors, maintainers, and recruiters. The frontend connects to this backend for all user management and dashboard operations.PullQuest GitHub Backend (Automation & Workflows)I created this dedicated service specifically for GitHub Actions integration and workflow automation. This backend processes GitHub webhooks, parses comment patterns like @pullquestai add 50HBAR Bounty to @username, and executes the corresponding blockchain transactions. It handles all the automated XP awards and bounty transfers triggered by GitHub events.Frontend - React with TypeScriptI used Vite as the build system for fast development iteration and optimized production builds. The frontend features three distinct role-based dashboards with context-based state management.Key Implementation Details1- GitHub Actions IntegrationI developed sophisticated workflows that parse specific comment patterns using regex and automatically trigger blockchain transactions. The system extracts parameters from comments, makes API calls to my PullQuest GitHub Backend, which then interacts with the Hedera smart contracts to transfer HBAR and award XP points. Each successful transaction posts a confirmation comment with the transaction hash for transparency.2- Wallet Address ManagementI implemented a user database that maps GitHub usernames to Hedera wallet addresses. For demonstration purposes, I built in fallback mechanisms that use a default wallet address when user data isn't available. This creates a seamless experience where users don't need to manually input wallet addresses for each transaction.HCS-2 Standard ImplementationI ensured compliance with the HCS-2 standard for consensus service logging, formatting all messages according to the specification: json{ "p": "hcs-2", "op": "register", "t_id": "topic_id", "metadata": "JSON_data", "m": "human_readable_message" }Aadhaar Authentication Integration using SelfI integrated self-sovereign identity verification using Aadhaar authentication at key points in the user journey. This links real-world identity to on-chain reputation while maintaining privacy, effectively preventing Sybil attacks and ensuring profile authenticity.Bounty Issues can be created while staking HBAR coinsDevelopment Challenges I SolvedReal-Time GitHub ProcessingProcessing GitHub webhooks reliably while ensuring blockchain transaction success required implementing comprehensive retry mechanisms and error handling. I built the system to handle network failures, temporary blockchain congestion, and API rate limits gracefully.Gas-Free User ExperienceI designed the platform to sponsor all transaction fees, providing a Web2-like experience that removes friction for users unfamiliar with blockchain interactions. This was crucial for mainstream adoption.Error Handling for Blockchain OperationsOne significant challenge was handling the getUserTotalXp function failures. I implemented robust fallback mechanisms that try to read from the smart contract first, then fall back to HCS data aggregation if the contract call fails, ensuring the user experience remains smooth even when individual components have issues.The architecture demonstrates my approach to practical blockchain adoption - leveraging Hedera's unique advantages (speed, low cost, consensus service) to enable use cases that wouldn't be feasible on other networks, while maintaining the transparency and immutability that makes blockchain valuable for reputation and incentive systems.