Skip to content

SplitStream — pooled payouts for open source contributors

SplitStream

On-chain treasury settlement for open source teams. SplitStream turns a pooled treasury into a verifiable, disputable, per-contributor payout — instead of manual off-chain calculation. It is made of three repositories, documented together here.

  • splitstream-core


    The Soroban vault contract that holds the funds and enforces the rules: Merkle-proof claims, fixed basis-point splits, linear vesting, and a 24-hour challenge window before any payout unlocks.

    Introduction

  • splitstream-actions


    The GitHub Action that turns merged PRs across an org into a signed payout manifest — counting what contributors closed and relaying the settlement root on-chain.

    Introduction

  • splitstream-sdk-cli


    The client SDK and CLI contributors claim with, and maintainers simulate, report, and reconcile with — a typed client over the vault contract.

    Introduction

How the pieces fit

flowchart LR
    GH["Merged PRs\n(GitHub org)"] --> ACT["splitstream-actions\ncount → manifest → Merkle root"]
    ACT -->|"post_cycle_root"| CORE["splitstream-core\nSoroban vault"]
    CORE -->|"24h dispute window"| READY["Claims open"]
    READY -->|"proof + withdraw"| SC["splitstream-sdk-cli\nclaim, simulate, status"]
    SC --> CONTRIB["Contributor wallet"]

The contract never knows about GitHub, points, or issue counts — it only verifies (address, amount) pairs against a committed root and pays them. Everything that decides what a contributor is owed happens in splitstream-actions; everything that lets a contributor collect happens through splitstream-sdk-cli.

Read the cross-repo architecture

Start here

I want to… Go to
Understand the protocol end to end Architecture
Read the contract's 19 public functions and 17 errors Contract reference
See a cycle lifecycle with a worked numeric example Protocol mechanics
Configure the GitHub Action for my org For maintainers (actions)
Claim a payout as a contributor For contributors (sdk-cli)
Build, test, and deploy any of the three repos Developer guides

Source repositories

Repository Language Role
splitstream-core Rust / Soroban Vault contract — settlement and custody
splitstream-actions TypeScript GitHub→chain bridge — manifest + root relay
splitstream-sdk-cli TypeScript Client SDK + CLI — claim and operate

Pre-audit software

The vault has not been independently audited. It is appropriate for Testnet and controlled Mainnet use with amounts you can afford to lose — see SECURITY.md and the threat model in each repository before moving real funds.