Skip to content

Repository files navigation

ProsperON Season 0

A Plural Staking Super App for Celo

ProsperON is an experimental economic model where network usage (gas fees and voluntary CELO burns) earns users non-transferable, decaying "Prosper Credits" that determine their share of weekly yield distributions from a collaborative endowment pool.

The Core Loop

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   BURN → MINT → POOL → ALLOCATE                                │
│                                                                 │
│   1. Use Celo (pay gas, burn CELO)                             │
│   2. Earn Prosper Credits (with 2% weekly decay)               │
│   3. Endowment generates yield via Aave                        │
│   4. Yield distributed based on your credit share              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Features

Dashboard

  • View your aggregated Prosper Credits across all linked wallets
  • See transaction history with gas costs and burn amounts
  • Track credit decay projection over time
  • Perform voluntary CELO burns to boost credits

Governance

  • Create proposals for community discussion
  • Vote on proposals with credit-weighted voting power
  • Comment and participate in discussions
  • Voting power = your current decayed credits at time of vote

Steer

  • Direct your allocation across ecosystem priorities:
    • Users - Rebates, perks, community distribution
    • Builders - Gas sponsorship, growth boosts
    • Public Goods - Infrastructure, tooling, audits

Transparency Hub

  • Real-time endowment balance and Aave yield tracking
  • Sponsor deposits and contributions
  • Weekly distribution history

Linked Wallets

  • Connect multiple wallets to one identity
  • Aggregate credits from all verified wallets
  • Signature-based wallet verification

Technical Stack

Frontend

  • React with TypeScript
  • Wouter for routing
  • TanStack Query for server state
  • Tailwind CSS + shadcn/ui components
  • Wagmi + Reown AppKit for wallet connections

Backend

  • Express.js with TypeScript
  • Drizzle ORM with PostgreSQL
  • Viem for blockchain interactions

External APIs

  • Etherscan API v2 for Celo transaction indexing
  • Aave for yield generation on endowment

Getting Started

Prerequisites

  • Node.js 20+
  • PostgreSQL database
  • Etherscan API key (for Celo)
  • Reown Project ID (for wallet connections)

Environment Variables

# Database
DATABASE_URL=postgresql://...

# Etherscan API for Celo
ETHERSCAN_API_KEY=your_etherscan_api_key

# Reown/WalletConnect (must be in client/.env for Vite)
VITE_REOWN_PROJECT_ID=your_reown_project_id

# Admin access
ADMIN_PASSWORD=your_admin_password

# Burn address (optional, has default)
BURN_ADDRESS=0x2c696e742e07d92d9ae574865267c54b13930363
VITE_BURN_ADDRESS=0x2c696e742e07d92d9ae574865267c54b13930363

Installation

# Install dependencies
npm install

# Push database schema
npm run db:push

# Start development server
npm run dev

The app will be available at http://localhost:5000

Project Structure

├── client/                 # React frontend
│   ├── src/
│   │   ├── components/     # UI components
│   │   ├── contexts/       # React contexts (Wallet)
│   │   ├── lib/           # Utilities and configs
│   │   └── pages/         # Route pages
│   └── .env               # Frontend env vars (VITE_*)
│
├── server/                 # Express backend
│   ├── routes.ts          # API endpoints
│   ├── storage.ts         # Database operations
│   ├── db.ts              # Database connection
│   └── services/          # Business logic
│       ├── credits.ts     # Credit calculation with decay
│       ├── etherscan.ts   # Transaction fetching
│       ├── aave.ts        # Endowment yield tracking
│       └── distribution.ts # Weekly distributions
│
└── shared/                 # Shared code
    └── schema.ts          # Database schema (Drizzle)

Key Concepts

Prosper Credits

  • Earn: 1 CELO burned (gas or voluntary) = 1 raw credit
  • Decay: 2% per week, applied continuously based on transaction age
  • Non-transferable: Credits are tied to your wallet identity
  • Aggregated: All linked wallets contribute to your total

Credit Formula

decayed_credits = raw_credits × (0.98 ^ weeks_since_transaction)
total_credits = sum(decayed_credits for all transactions)

Governance Voting

  • Voting power = your current decayed credits at vote time
  • Votes are "snapshot" at cast time for auditability
  • Supports For / Against / Abstain votes
  • Credit threshold required to create proposals and vote

Weekly Distributions

  • Yield generated from Aave deposits
  • Distributed proportionally: your_share = your_credits / total_credits
  • Users can steer their allocation across ecosystem buckets

API Endpoints

Wallet

  • POST /api/wallet/connect - Register/login wallet
  • GET /api/wallet/:address - Get user and linked wallets
  • POST /api/wallet/:address/link - Initiate wallet linking
  • PATCH /api/wallet/:address/profile - Update username/bio

Credits

  • GET /api/credits/:address - Get decayed credit summary
  • GET /api/transactions/:address - Get transaction history

Governance

  • GET /api/governance/posts - List proposals
  • GET /api/governance/posts/:id - Get proposal details
  • POST /api/governance/posts - Create proposal
  • POST /api/governance/posts/:id/vote - Cast vote
  • POST /api/governance/posts/:id/comments - Add comment

Transparency

  • GET /api/endowment - Current endowment position
  • GET /api/sponsors - Sponsor deposits
  • GET /api/distributions - Weekly distribution history

Season 0: Validation Phase

ProsperON Season 0 is a centralized MVP designed to validate the economic model before decentralization:

  • All inputs are on-chain verifiable (Celo transactions)
  • Credit calculations are auditable
  • Allocations are tracked on a centralized ledger
  • This phase collects data to design Celo's future economic system

Contributing

This project is in experimental validation phase. Contributions and feedback are welcome as we iterate on the economic model.

License

MIT


Built with purpose for the Celo ecosystem.

About

Unlocking the power of Celo tokenomics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages