Donate directly to verified climate projects using XLM — every transaction tracked on-chain.
Stellar GreenPay is an open-source climate donation platform where donors give XLM directly to verified environmental projects. Every donation is recorded on the Stellar blockchain via Soroban smart contracts — providing radical transparency and zero platform fees.
- 🔗 Wallet Connect — Freighter browser wallet integration
- 🌍 Browse Projects — Verified climate projects with impact metrics
- 💚 Donate XLM — Direct on-chain donations to project wallets
- 📊 Impact Tracking — Soroban contract tracks every donation and CO₂ offset
- 🏆 Leaderboard — Top donors ranked by total XLM given
- 💬 Project Updates — Organisations post progress updates to donors
stellar-greenpay/
├── frontend/ # Next.js + React + Tailwind CSS
├── backend/ # Node.js + Express API
├── contracts/ # Stellar Soroban smart contracts (Rust)
├── docs/ # Architecture & API documentation
├── scripts/ # Deployment & utility scripts
├── .github/ # CI/CD workflows & issue templates
├── CONTRIBUTING.md
├── ROADMAP.md
└── LICENSE
| Tool | Version |
|---|---|
| Node.js | ≥ 18.x |
| npm | Latest |
| Rust + Cargo | ≥ 1.74 (for contracts) |
| Freighter Wallet | Browser extension |
git clone https://github.com/your-org/stellar-greenpay.git
cd stellar-greenpay
chmod +x scripts/setup-dev.sh
./scripts/setup-dev.shcd frontend && npm run dev
# → http://localhost:3000cd backend && npm run dev
# → http://localhost:4000NEXT_PUBLIC_STELLAR_NETWORK=testnet
NEXT_PUBLIC_HORIZON_URL=https://horizon-testnet.stellar.org
NEXT_PUBLIC_API_URL=http://localhost:4000
NEXT_PUBLIC_CONTRACT_ID=PORT=4000
STELLAR_NETWORK=testnet
HORIZON_URL=https://horizon-testnet.stellar.org
CONTRACT_ID=
ALLOWED_ORIGINS=http://localhost:3000- Install Freighter Wallet and switch to Testnet
- Visit Stellar Friendbot with your public key
- Receive 10,000 test XLM instantly
See CONTRIBUTING.md. All skill levels welcome!
See ROADMAP.md for planned features.
MIT — see LICENSE