Trustless OSS is a GitHub-integrated bounty platform that turns labeled issues into on-chain USDC payouts. Maintainers deploy and fund a Trustless Work escrow, and contributors receive funds automatically when a linked PR merges.

Open source maintainers need a way to pay contributors without manual escrow transfers or trust-based bookkeeping. This project uses GitHub webhooks, issue labels, and Trustless Work milestones to automate payout execution.

• Connects GitHub repos via GitHub App and Supabase auth
• Deploys a Trustless Work multi-release escrow on Stellar
• Marks issues as bounties with rewarded + difficulty labels
• Supports custom bounties via maintainer comment commands
• Prompts assigned contributors to connect their Stellar wallet
• Creates Trustless Work milestones on assignment
• Releases funds automatically when a PR referencing the issue is merged
• Supports partial payout splits, rejection/dispute, retry, and refund
• Includes a dashboard refund flow to withdraw remaining escrow funds and cancel active bounties

flowchart LR
    Maintainer -->|connect repo| App[Trustless OSS App]
    Maintainer -->|deploy escrow| TrustlessWork[Trustless Work]
    Maintainer -->|label issue| GitHub[GitHub]
    GitHub -->|webhook| App
    App -->|create pending bounty| DB[Supabase]
    GitHub -->|assign issue| App
    App -->|ask wallet| Contributor[Contributor]
    Contributor -->|connect wallet| App
    App -->|push milestone| TrustlessWork
    GitHub -->|PR merged| App
    App -->|approve + release| TrustlessWork
    TrustlessWork -->|send USDC| ContributorWallet[Contributor Wallet]

• rewarded — marks an issue as bounty-enabled
• low / medium / high — fixed reward tiers
• custom — manual amount required via command

If custom is applied, the maintainer must comment:

• @Trustless-OSS 150

If the amount is missing, the bot will ask for it.

Note: The project does not use bonus:50 label in code. The active custom flow is custom + @Trustless-OSS <amount>.

For automatic payout, a merged PR must reference the issue in its body using keywords like:

• closes #123
• fixes #123
• resolves #123

This is how the app matches the merged PR to the bounty issue.

• @Trustless-OSS /reject triggers a dispute flow and returns funds to the maintainer
• @Trustless-OSS /pay <percentage> saves partial payout intent
• Dashboard supports an escrow refund button to withdraw remaining USDC and cancel active issues
• Refund flow uses Trustless Work dispute/resolve logic to pull remaining funds back to the maintainer's wallet
• This is still a hackathon proof-of-concept: platform signing and maintainer dispute resolution are centralized v1 choices

Maintainers can refund escrow funds from the dashboard when a repo is connected and a wallet is linked. Refunding withdraws remaining USDC from the on-chain escrow, cancels pending/active issues, and updates the app state.

If the maintainer wallet is not connected, the app asks to connect it before refunding.

1. Maintainer logs in and connects a repo.
2. Deploy the Trustless Work escrow contract from the dashboard.
3. Fund the escrow with USDC.
4. Add rewarded + low|medium|high|custom to an issue.
5. Assign a contributor.
6. Contributor follows the bot link to connect their Stellar wallet.
7. Submit a PR that references the issue.
8. When the PR merges, the system releases the bounty.

• Node.js >= 22
• pnpm >= 11

# Install dependencies
pnpm install

# Copy environment variables template
cp .env.example .env

# Run development server
pnpm dev

Fill in the following variables in .env:

• NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY — Supabase authentication client keys
• NEXT_PUBLIC_BACKEND_URL — API endpoint of the backend service
• NEXT_PUBLIC_GITHUB_APP_SLUG — GitHub App slug for repositories connection
• NEXT_PUBLIC_APP_URL — URL where this application is running (e.g., http://localhost:3000)

• app/connect/page.tsx — contributor wallet onboarding flow
• app/dashboard/[repoId]/page.tsx — repository details, escrow details, and issue state view
• app/dashboard/connect-repo/page.tsx — GitHub App connection layout

This repo contains the standalone frontend application of the Trustless OSS platform. It interacts with the backend service to trigger milestone updates and escrow queries.