Complete product documentation for the Ubounty.ai platform - an automated cryptocurrency bounty system for GitHub issues.
This repository contains comprehensive, user-friendly documentation explaining how Ubounty.ai works from a business and user experience perspective. Whether you're a project maintainer looking to incentivize development or a developer wanting to earn cryptocurrency bounties, you'll find everything you need here.
Note: This documentation focuses on product features and user experience. It does not contain implementation details, code, or sensitive information.
Start here:
- Getting Started - Your first steps on the platform
I want to create bounties:
- Bounty Creator Guide - Complete guide for project maintainers
I want to earn bounties:
- Developer Guide - Complete guide for developers
Understanding the System:
- Payout Logic - How payments work from issue to payout
- Payment & Security - How your funds are protected
- Platform Features - All features and capabilities
Quick Reference:
- FAQ - Common questions and answers
For: Everyone new to Ubounty Covers:
- Platform overview
- Quick start guides for creators and developers
- Setting up your wallet
- Understanding bounty statuses
- Key concepts
- Safety tips
Read this if: You're new to the platform and want a quick overview.
For: Project maintainers, open source sponsors, anyone funding bounties Covers:
- Creating your first bounty
- AI-powered bounty analysis
- Funding process
- Managing active bounties
- Making payment decisions
- Best practices
- Common scenarios
- Troubleshooting
Read this if: You want to incentivize development work on your GitHub issues.
For: Developers looking to earn cryptocurrency bounties Covers:
- Finding and evaluating bounties
- Working on issues
- Submitting pull requests
- Getting paid
- Setting up your wallet
- Maximizing earnings
- Common scenarios
- Troubleshooting
Read this if: You want to earn money by solving GitHub issues.
For: Everyone who wants to understand payment workflows Covers:
- The complete payment journey
- Multiple PR scenarios
- Auto-split mechanism
- Special edge cases
- Payment timeline examples
- User responsibilities
- Payment security and trust
- Frequently asked questions
Read this if: You want to understand exactly how and when payments are executed.
For: Everyone concerned about fund safety and security Covers:
- How payments work (USDC, Base network, x402 protocol)
- Blockchain security
- Escrow system
- Wallet security best practices
- Transaction transparency
- Platform security measures
- Risk mitigation
- Best practices for creators and developers
Read this if: You want to understand how your funds are protected and best security practices.
For: Everyone who wants to know what the platform can do Covers:
- Core features (bounty creation, multi-contributor, instant payments)
- AI-powered features (analysis, pricing, requirements)
- GitHub integration
- Bounty management
- Payment features
- Discovery and search
- Notifications
- Future features
Read this if: You want a comprehensive overview of all platform capabilities.
For: Everyone with quick questions Covers:
- General questions
- Creator-specific questions
- Developer-specific questions
- Payments and fees
- Security and safety
- Technical questions
- Troubleshooting
Read this if: You have a specific question and want a quick answer.
Ubounty.ai is an automated cryptocurrency bounty platform that connects:
- Bounty Creators - People who fund bounties on GitHub issues
- Developers - People who solve issues and earn cryptocurrency
- Blockchain - Technology that enables instant, transparent payments
For Creators:
- Select a GitHub issue
- Set a bounty amount (in USDC)
- Fund with cryptocurrency
- When developers solve it, approve payment
- Payment executes automatically
For Developers:
- Find a bounty you can solve
- Submit a pull request
- PR gets merged by maintainer
- Creator approves payment
- Receive USDC in your wallet instantly
✅ Instant Payments - Funds transfer in 3-5 seconds ✅ Automated - No manual payment processing ✅ Transparent - All transactions on public blockchain ✅ Fair - Multiple contributors can all get paid ✅ Secure - Funds held in blockchain escrow ✅ Global - Pay anyone, anywhere, in seconds ✅ Low Cost - 5% platform fee, minimal blockchain fees
Supported:
- Currency: USDC (USD Coin stablecoin)
- Network: Base (Coinbase L2)
- Minimum Bounty: $10 USDC
- Platform Fee: 5%
- Payment Speed: 3-5 seconds
- Payment Decision Window: 7 days
- Bounty creators have 7 days to allocate payment after first PR merge
- If no decision, payment auto-splits equally among all merged PRs
- Payment decisions are final and irreversible
- 5% of bounty amount
- Charged when bounty is created
- Developer receives 100% of allocated amount
- Must be on public GitHub repositories
- Issue must be open (not closed)
- Repository must be accessible for comments
- Developers need a wallet address to receive payment
- No deadline to add wallet (approved payments wait indefinitely)
- Payment executes automatically when wallet is connected
You're in the right place! Use the guides above to learn about:
- Getting started
- Creating bounties
- Earning bounties
- Security
- Features
- Common questions
Email:
Community:
- GitHub: (for platform issues)
Response Time:
- Typically within 24 hours
- Security issues get priority
Found a bug or security vulnerability?
- Include detailed description
- Screenshots if possible
- Steps to reproduce
Coming Soon:
Reputation System
- User ratings and reviews
- Trust indicators
- Quality scores
Bounty Templates
- Pre-made templates for common bounties
- Quick creation process
Milestone-Based Bounties
- Large projects split into phases
- Payment per milestone
Multi-Currency Support
- ETH, USDT, DAI support
- Flexible payment options
Private Bounties
- Invite-only bounties
- Direct collaboration
See Platform Features for details.
This documentation is designed to:
- Explain product features in user-friendly language
- Help users understand workflows and processes
- Provide best practices and guidance
- Answer common questions
- Focus on business logic, not implementation
❌ Source code ❌ API endpoints and technical implementation ❌ Sensitive configuration details ❌ Security vulnerabilities or exploits ❌ Private keys, secrets, or credentials
Ubounty.ai Team
1.0
Create Bounty → Fund ($Amount + 5%) → PR Merged →
Decide Allocation → Payment Executes
Timeline: 10-20 seconds to create, up to 7 days to decide payment
Minimum: $10 USDC Fee: 5% Currency: USDC on Base network
Find Bounty → Submit PR → PR Merged →
Creator Decides → Receive Payment
Timeline: 2-7 days from PR merge to payment
Required: GitHub account + Wallet address Earnings: 100% of allocated percentage Speed: 3-5 seconds once approved
This documentation is © 2025 Ubounty.ai. All rights reserved.
The Ubounty.ai platform and associated trademarks are property of their respective owners.
Website: https://ubounty.ai
Found an error or want to suggest improvements?
Include:
- Document name
- Section
- Suggested change
- Reason for change
We appreciate feedback that helps make our documentation clearer and more useful!
Start exploring:
- New user? → Getting Started
- Want to create bounties? → Bounty Creator Guide
- Want to earn bounties? → Developer Guide
- Have questions? → FAQ
Welcome to Ubounty.ai! Let's build the future of open source compensation together. 🚀