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.
-
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.
-
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.
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.