⛰️ Zenith Protocol (Stellar Soroban)

Zenith Protocol is the native Stellar distribution layer for recurring, point-based open-source contribution payouts. It eliminates bridging friction by enabling trustless, proportional asset distribution (via native USDC or XLM) directly on the Soroban smart contract platform.

📖 The Problem It Solves

Current recurring bounty platforms (like Drips) rely heavily on Ethereum infrastructure. Zenith brings this capability natively to Stellar, allowing maintainers to evaluate GitHub PRs off-chain and distribute funds on-chain with sub-cent transaction fees and zero bridging risk.

Repository: github.com/CodedBay/zenith-stellar

🏗️ Architecture

1. Sponsor Deposits: Ecosystem funds are deposited into the Soroban contract (deposit).
2. Point Allocation: An authorized Admin (or GitHub multisig oracle) awards points based on contribution weight (award_points).
3. Lock & Calculate: The wave is finalized (close_wave), locking the exact mathematical ratios.
4. Proportional Claims: Contributors claim their exact share of the total pool based on the 128-bit formula: (Total Funds * User Points) / Total Points.

🚀 Quick Start

Prerequisites

• Rust (v1.84.0 or later)
• Stellar CLI (v26+)
• Node.js (v20+) for the frontend

Build & Test Smart Contract

make build
make test

Deploy to Testnet

Ensure your Stellar CLI is configured with a zenith_admin identity, then run:

make deploy

Run the Frontend

cd frontend
npm install
npm run dev

🛡️ Security

Zenith utilizes secure 128-bit integer math to prevent precision loss during proportional distribution. It strictly implements the Checks-Effects-Interactions pattern to prevent re-entrancy attacks during token claims.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.