Skip to content
forked from b3ww/vGrant

πŸ’Έ OpenBounty automates crypto bounty with trustless payouts upon first valid GitHub merge, using ZK-proof Git identity linking

Notifications You must be signed in to change notification settings

Davphla/OpenBounty

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸͺ™ OpenBounty - Fund-on-Merge Crypto Bounty System

ETHGlobal PRAGUE

Bounty with autonomous, trustless payouts
Zero approvals Β· PR theft protection Β· First-merge-wins mechanics


OpeenBounty is a decentralized bounty platform that enforces Fund on Merge consensus (See below), automating crypto payments to developers upon first valid code integration while eliminating payment delays, manual approvals, and PR theft through zero-knowledge verification.

Fund on Merge Concensus

graph LR
    F[πŸ’Έ Funder]
    D[πŸ‘¨β€πŸ’» Developer]

    F -->|1 - Fund bounty| C[πŸ“œ Smart Contract]
    D -->|2 - Submit PR| G[πŸ™ Git]
    G -->|3 - First Merge| C
    C -->|4 - Auto-Payout| D
    
    style C fill:#e6f7ff,stroke:#1890ff,stroke-width:2px
    style F fill:#f6ffed,stroke:#52c41a
    style D fill:#fff7e6,stroke:#fa8c16
    style G fill:#f9f0ff,stroke:#722ed1
    classDef default fill:none,stroke:none,color:black
Loading

User Story

Alice πŸ‘©β€πŸ’Ό needs a Blender feature her team can't build. She:

  1. Creates GitHub issue #1234
  2. Highlight by funding USDC bounty (Vault escrow) with deadline

Bob πŸ‘¨β€πŸ’» wants paid open source work. He:

  1. Finds Alice's issue via bounty board
  2. Submit a solution via Pull-Request (Code + tests + docs).

Maintainer πŸ€΅β€β™‚οΈ:

  1. Reviews Bob's Pull-Request against standard
  2. Merges on approval β†’ auto-releases payment
  3. Receives review fee (5-15% of bounty) β†’ funds project treasury

πŸš€ How Vbounty Works

⭐ Funder Journey

A Funder creates bounty for desired features:

graph LR
    A[πŸ’Έ 1. Create bounty] --> B[Define Specs & Deadline]
    B --> C[πŸ”’ 2. Lock USDC in Escrow]
    C --> D[πŸ”„ 3. Open bounty]
    D --> E{Resolution}
    E -->|First Valid Merge| F[🟒 4a. Auto-Payout]
    E -->|Deadline Reached| G[πŸ”΄ 4b. Auto-Refund]
    F --> H[βœ… bounty Closed]
    G --> H
Loading
  1. Create bounty : Remunerate Open Source Projects and Contributors
struct bounty {
    address payable funder;
    address token;  // USDC: 0xA0b8... 
    uint256 amount;
    uint256 deadline;
    bool isClaimed;
}
  1. Funds Locking
  • USDC held in audited vault contract
  • Immutable until resolution conditions met
  1. Automatic Resolution
  • 🟒 Success: Contract auto-sent to first merged PR
  • πŸ”΄ Timeout: Funder refund after deadline

πŸ‘¨β€πŸ’» Developer Journey

A Developer can work on available bountyed issues. The first valid merge claim the bounty πŸ’Έ

flowchart LR
    A[πŸ‘¨β€πŸ’» 1 - Find bounty] --> R[πŸ›‘οΈ 2 - Link Git account and wallet using **vbounty**]
    R --> B[3 - Submit PR with Solution]
    B --> C[4 - Maintainer Reviews]
    C --> D{5 - Approved?}
    D -->|Yes| E[6 - Merge PR]
    D -->|No| B
Loading

✨ Core Innovation

πŸ›‘οΈ PR Theft Protection

By using the Web Proof technology of vlayer, we ensure a Git Account is linked to a Wallet Address by enforcing a registration of the developer before a valid merge (Step 2. in above diagram). We use our front-end to simplify the interaction with our smart contract.

We enables a fluid User Experience for a Zero-Knowledge-Proof Verification (ZK-proof), opposing Cryptographical RSA challenge using Git SSH keys, which may be challenging for casual user.

To use OpenBounty, you should:

⚠️ It is recommended to take a look at Security Consideration before using Web Proof technology.

graph LR
    A[Resolved Issue] --> B{Issuer registered on vbounty ?}
    B -->|Valid Linked Git Account| C[πŸ’Έ - Instant USDC Payout]
    C --> L[βœ… bounty Claimed]
    B -->|Missing Account| D[πŸ›‘ - Claim Rejected]
    D --> M[⚠️ bounty Pending - Alert Maintainers]

Loading

πŸ”‘ Key Benefits

Feature πŸ’Έ Funder πŸ‘¨β€πŸ’» Developer
Winner Selection Algorithmic - no bias Meritocracy win
Fund Handling Reclaim anytime post-deadline Instant payout on merge
Technical Focus Define problem β†’ fund β†’ wait Find issue β†’ code β†’ get paid

βœ… When bounties beat classic models:

  • Funder: Pays only for results (no hourly fees/management)
  • Developper: Earns remuneration and reputation
  • Blender: Gets vetted code faster

❌ When Traditional Wins:

  • Complex projects: Poor for multi-phase work needing iteration
  • Relationship-dependent: Bad when ongoing collaboration required
  • Sensitive work: Unsuitable for proprietary/NDA-protected code
  • High-support features: Suboptimal if post-launch maintenance needed
  • Niche skills: Less effective than targeted freelancer recruitment

When to use Bounties ?

⭐ For Funder

  • Scope is clear & achievable (1-3 week tasks)
  • Seeking specialized skills for non-core features
  • Budget certainty outweighs timeline flexibility
  • Funds released only for verified working solutions

πŸ‘¨β€πŸ’» For Developper

  • Be rewarded for your Open Source Work in your Free Time
  • Build a Reputation with contributions (Git/NFTs)
  • Compete on skill, not location
  • Access global opportunities with no interviews

πŸ€΅β€β™‚οΈ For Maintainer

  • Project benefits from new vetted contributions
  • Quality control is enforced (verified before merge)
  • Earn sustainable funding (percentage of bounties)
  • Grow ecosystem through new contributors

🌐 Why Decentralizing it ?

  • 0% platform fees (vs. 20% on Upwork/Fiverr)
  • Decentralized: No geo-restrictions/censorship
  • Transparency: Verifiable on-chain contract

πŸ† Prize Integrations

πŸ“½οΈ Partners

world logo

VLayer provides verifiable data infrastructure that bridges Web2 and Web3, enabling developers to integrate and verify real-world data β€” like web and email proofs β€” into Ethereum smart contracts using zero-knowledge proofs and familiar tools like Solidity.

  • ZK-verified contributor identities
  • Anti-sybil protection for submissions

πŸ… Prize Submissions

Prize Category Value
VLayer Most inspiring use $4,000
VLayer Best Web Proofs $2,000

Potential upgrade

  • Implement decentralized database for front-end caching (using IPFS)

  • Manage multiple concensus - Fund on merge / Fund on merge and Approval (Bounty / Free-lance concensus)

  • Add other Git service (Gitlab, ...)

  • Add developper portfolio

  • Priority ranking in Project

  • Add early bonus in the protocol

  • Made by ❀️ by:

  • Basile Fouquet

  • SΓ©bastien Lucas

  • Lucas Leclerc

  • Nathan Flattin

  • David Gozlan

About

πŸ’Έ OpenBounty automates crypto bounty with trustless payouts upon first valid GitHub merge, using ZK-proof Git identity linking

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 59.8%
  • Rust 35.7%
  • CSS 3.6%
  • Other 0.9%