OrbitPay

Decentralized Payroll, Vesting & Treasury Protocol on Stellar Soroban.

  ___       _     _ _   ____
 / _ \ _ __| |__ (_) |_|  _ \ __ _ _   _
| | | | '__| '_ \| | __| |_) / _` | | | |
| |_| | |  | |_) | | |_|  __/ (_| | |_| |
 \___/|_|  |_.__/|_|\__|_|   \__,_|\__, |
                                    |___/

OrbitPay is a protocol that enables startups, DAOs, and remote-first organizations to manage payroll, token vesting, and treasury operations entirely on-chain using Stellar Soroban smart contracts.

💡 The Idea

Build an on-chain DAO operations protocol:

• Treasury: Multi-signature vault with configurable approval thresholds
• Payroll Streaming: Continuous token distribution, claimable in real-time
• Token Vesting: Cliff + linear vesting for team, advisors, and investors
• Governance: On-chain budget proposals with quorum-based approval voting

This is not just payments — it is programmable organizational finance.

🏗️ Architecture

graph TD
    Admin((Org Admin)) -->|Connect Wallet| UI[Next.js Dashboard]
    Employee((Employee)) -->|Claim Tokens| UI
    
    UI -->|Invoke| T[Treasury Contract]
    UI -->|Invoke| P[Payroll Stream Contract]
    UI -->|Invoke| V[Vesting Contract]
    UI -->|Invoke| G[Governance Contract]
    
    subgraph Stellar Soroban
        T -->|Multi-sig| T_Store[Vault Storage]
        P -->|Stream| P_Store[Stream State]
        V -->|Vest| V_Store[Schedule State]
        G -->|Vote| G_Store[Proposal State]
    end
    
    subgraph Backend
        Indexer[Event Indexer] -->|Poll| T
        Indexer -->|Poll| P
        Indexer -->|Poll| V
        Indexer -->|Poll| G
        Indexer -->|Store| DB[(PostgreSQL)]
    end
    
    DB -->|Query| API[Analytics API]
    API -->|Feed| UI

Loading

🛠 Tech Stack

Layer	Technology
Smart Contracts	Soroban (Rust), soroban-sdk 22.0.0
Frontend	Next.js 14, TypeScript, Tailwind CSS
Wallet	Freighter Wallet
Indexing	Custom Soroban-RPC event poller
Database	PostgreSQL, Redis
CI/CD	GitHub Actions

📂 Repository Structure

OrbitPay/
├── contracts/                        # Soroban workspace
│   └── contracts/
│       ├── treasury/                 # Multi-sig treasury (8 issues)
│       ├── payroll_stream/           # Payment streaming (6 issues)
│       ├── vesting/                  # Cliff + linear vesting (6 issues)
│       └── governance/               # Proposals & voting (5 issues)
├── frontend/                         # Next.js dashboard
│   └── src/
│       ├── app/                      # Pages (treasury, payroll, vesting, governance)
│       ├── components/               # Reusable UI components
│       ├── hooks/                    # Contract interaction hooks
│       └── lib/                      # Network & wallet utilities
├── backend/                          # Backend scaffold and monitoring assets
│   ├── README.md                     # Backend implementation contract
│   └── monitoring/                   # Prometheus, alerting, Grafana templates
├── docs/                             # Issue trackers & guides
│   ├── ISSUES-SMARTCONTRACT.md       # 25 smart contract issues
│   ├── ISSUES-FRONTEND.md           # 25 frontend issues
│   ├── ISSUES-BACKEND.md            # 10 backend/indexer issues
│   ├── ISSUES-SDK-TOOLING.md        # 10 SDK/tooling issues
│   ├── SMARTCONTRACT_GUIDE.md       # Contract development guide
│   └── FRONTEND_GUIDE.md            # Frontend integration guide
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── MAINTAINERS.md
└── STYLE.md

🚀 Getting Started

1. Prerequisites

• Rust & Cargo (for smart contracts)
• Soroban CLI: cargo install --locked soroban-cli
• Node.js v18+ (for frontend)
• Freighter Wallet browser extension

2. Installation

Clone the repository:

git clone https://github.com/YOUR_USERNAME/OrbitPay.git
cd OrbitPay

Verify contract integrity:

cd contracts
cargo build --all
cargo test --all

Setup frontend:

cd frontend
npm install
npm run dev

Backend monitoring scaffold:

cd backend/monitoring

📚 Documentation & Trackers

We have separated our task lists for better organization. Please refer to the specific tracker for your area of contribution:

• 🧠 Smart Contract Issues — 25 issues across 4 contracts
• 🎨 Frontend Issues — 25 issues for the Next.js dashboard
• ⚙️ Backend & Indexer Issues — 10 issues for the off-chain stack
• 🛠 SDK & Tooling Issues — 10 issues for SDK, CLI, and DevOps

Guides:

• 📘 Smart Contract Guide
• 🌐 Frontend Integration Guide
• 🏗️ Architecture Diagrams — Mermaid diagrams + contract cross-reference

API Docs (auto-generated):

Generated by cargo doc and deployed to GitHub Pages on every push to main:

https://xqcxx.github.io/OrbitPay/

To generate locally:

cd contracts
cargo doc --no-deps --all --open

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for details on our code of conduct and the development process.

Quick Start for Contributors:

1. Pick an issue from docs/
2. Fork the repo
3. Create a branch
4. Submit a PR!

---

Project maintained under the OrbitPay organization.