- Transparency: All transactions are tracked and verified on-chain.
- Enables smooth USDC transfers to contributors across supported networks. Reward Pools for Open Source Contributions
MergeFi is a decentralized platform that incentivizes open-source contributions by automating rewards for merged pull requests on GitHub.
Payments, powered by AI recommendations and maintainer approval, are distributed in USDC with cross-chain support through Avail.
Contributors are rewarded not only financially, they also earn NFT badges for their contributions and merges, which appear publicly on the Merged PRs Page.
- Uses AI models to recommend fair payment amounts based on PR complexity, size, and repository context.
- Maintainers can review, adjust, and approve rewards before distribution.
- Leverages Avail for secure and scalable cross-chain interactions.
- Enables smooth USDC transfers to contributors across supported networks.
- Integrates Blockscout to provide a full transaction history.
- Every PR merge and payment is logged on-chain and displayed on a Merged PRs page.
- Contributors receive unique NFT badges for merged PRs and project milestones.
- Each badge is verifiable on-chain, adding a gamified layer to open source contribution.
- Maintainers can create and manage pools tied to specific repositories.
- Reward settings, AI model parameters, and payout limits are configurable per pool.
Maintainer Repo
└── PR-Pool Contract (per repo)
├── AI Pricing Engine
├── Reward Pool (USDC)
├── Avail Bridge
├── NFT Badge Minting
└── Blockscout Integration
- Maintainer creates a reward pool for their repository.
- Contributors submit PRs as usual.
- AI evaluates the PR and suggests a reward amount.
- Maintainer approves/rejects the AI’s recommendation.
- USDC is sent to the contributor via the Avail bridge.
- NFT badge is minted for the contributor’s wallet.
- All transactions are displayed on the Merged PRs page using Blockscout data.
| Component | Technology |
|---|---|
| Smart Contracts | Solidity, Foundry |
| Cross-Chain Layer | Avail |
| NFTs | ERC-721 Badges |
| Frontend | React / TypeScript |
| AI Engine | Gemini-API |
| Blockchain Explorer | Blockscout |
| Backend | Node.js + Express |
| Storage | IPFS / Pinata (for metadata) |
# Clone the repository
git clone https://github.com/<your-username>/MergeFi.git
cd MergeFi
# Install dependencies
npm install
# Compile contracts
forge build
# Run local dev server
npm run devCreate a .env file with the following:
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
FRONTEND_URL=
SUPABASE_URL=
SUPABASE_ANON_KEY=
PRIVATE_KEY=
SEPOLIA_RPC_URL=
ARBITRUM_SEPOLIA_RPC_URL=
SEPOLIA_ROUTER_ADDRESS=
ARBITRUM_ROUTER_ADDRESS=
GEMINI_API_KEY=Deploy your smart contracts to a testnet or mainnet:
forge script script/Deploy.s.sol --rpc-url <NETWORK_RPC_URL> --broadcastWe welcome contributions!
- Fork the repo
- Create a new branch (
feat/awesome-feature) - Commit and push your changes
- Open a PR — rewards await 🎉
| Role | Token | Purpose |
|---|---|---|
| Maintainers | USDC | Deposit to fund reward pools |
| Contributors | USDC | Receive payment for merged PRs |
| Contributors | NFT Badges | Earn collectible proof of contribution |
This project is licensed under the MIT License — see LICENSE for details.
- Add GitHub OAuth integration for maintainer verification
- Expand AI models for PR valuation
- Launch public dashboard for project rankings
- Gamify contributor badges with rarity tiers
PR-Pool aims to bridge open source development and Web3 economics, creating a future where contributors are fairly rewarded, transparent systems power collaboration, and AI helps maintainers scale community-driven projects.