Skip to content
@Trustless-OSS

Trustless OSS

Trustless OSS

TRUSTLESS-OSS

Trustless OSS is an open-source bounty platform that turns GitHub issues into escrow-backed rewards on the Stellar ecosystem.

Maintainers fund a USDC escrow and attach rewards to issues with labels. Contributors receive USDC when their work is approved and the linked pull request is merged.


Overview

Trustless OSS connects the GitHub contribution workflow with programmable escrow payments. Reward amounts, assignments, and payout states are visible before work starts, so contributors know what they can earn and maintainers do not have to coordinate payouts manually.


Core Objectives

  • Replace spreadsheets and manual transfers with a repeatable bounty workflow
  • Make rewards visible before work begins
  • Hold funds in escrow until the work is approved and merged
  • Keep GitHub as the place where work and payout commands happen
  • Support low-cost Stellar USDC payouts, with CCTP represented as a future cross-chain route

How It Works

  1. A maintainer connects a repository by installing the Trustless OSS GitHub App.
  2. The maintainer deploys and funds the repository's Trustless Work escrow with Stellar USDC.
  3. An issue becomes a bounty when it receives the rewarded label and a reward label.
  4. The maintainer adds low, medium, or high to select a configured reward tier, or uses custom and a bot comment to set a custom amount.
  5. The assigned contributor links a Stellar wallet, and the backend creates the corresponding milestone in the multi-release escrow.
  6. The contributor opens a pull request that references the issue with a closing keyword such as Closes #123.
  7. After the pull request is approved and merged, the milestone is released and the contributor receives the eligible bounty amount in USDC.

Bot commands start with @Trustless-OSS. Custom amounts and commands such as @Trustless-OSS 100, /pay, /reject, /retry, and /wallet are documented in docs/BOT_COMMANDS.md.


Architecture Approach

Trustless OSS follows a hybrid architecture:

  • On-chain: Trustless Work multi-release escrow deployment, funding, milestones, releases, and refunds on Stellar
  • Off-chain: a separate Rust backend, Toss Backend, handles GitHub webhooks, persistence, authorization, and payout orchestration
  • Web app: a Next.js dashboard provides repository setup, escrow controls, reward management, and contributor onboarding
  • Authentication and wallets: GitHub OAuth through Supabase authenticates dashboard users, while Stellar wallets handle transaction signing, funding, and payouts

Open Source & Community

The project is developed in public. Code, issues, and milestones live on GitHub and evolve through community contributions and review.

See CONTRIBUTING to get started.


Project Status

Trustless OSS is under active development. Core repository, escrow, and reward flows are in place. Some dashboard views—including activity, leaderboard, funds charts, notifications, and the homepage event feed—still use sample or demo data until the required backend APIs are available.


Ecosystem

Stellar Soroban USDC Escrow GitHub App


Trustless OSS aims to make paying open-source contributors as simple as merging a pull request.

Pinned Loading

  1. Trustless-OSS Trustless-OSS Public

    Automated on-chain bounties for open source — fund Stellar USDC escrow, attach rewards to GitHub issues, and pay contributors when PRs merge.

    TypeScript 4 25

  2. Toss-Backend Toss-Backend Public

    ⚡⚡High-performance Rust Axum API Service for Trustless-OSS ⚡⚡

    Rust 1 9

  3. DocApp DocApp Public

    Documentation for the Trustless-OSS project to help new users learn how to integrate and use it in their repositories and organizations.

    MDX

Repositories

Showing 4 of 4 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…