Skip to content

Chinaza007/StreamLine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌟 StreamLine

Send home. Instantly. For pennies.

Stellar Drips Wave License: MIT Contributors Welcome


🌍 The Problem

700+ million people send money across borders to support their families. Traditional remittance services charge:

  • 6-12% in fees on every transaction
  • $15-30 minimum fees making small transfers impossible
  • 2-5 days for money to arrive
  • Poor exchange rates that hide additional costs

For a $50 transfer, fees can consume $10-15. That's rent money. That's food money. That's a child's education.


✨ Our Solution

StreamLine is a Stellar-based remittance platform that enables instant, near-zero-cost cross-border payments designed for:

  • πŸƒβ€β™€οΈ Gig workers sending money home weekly
  • πŸ‘¨β€πŸ’» Remote workers in emerging markets
  • πŸ‘¨β€βš•οΈ Healthcare workers supporting families abroad
  • 🌏 Diaspora communities staying connected

Why StreamLine?

βœ… Under $0.01 per transaction - Powered by Stellar's efficiency
βœ… Instant settlement - Money arrives in seconds, not days
βœ… Mobile-first - Works on basic smartphones
βœ… SMS support - Recipients don't need crypto knowledge
βœ… Local currency - Automatic conversion at fair rates
βœ… Agent network - Cash out locally without a bank account


πŸš€ How It Works

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Sender    │────────>β”‚  StreamLine  │────────>β”‚  Recipient  β”‚
β”‚  (Mobile)   β”‚  $50    β”‚   (Stellar)  β”‚  $49.99 β”‚   (SMS)     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
     USA                 Instant + $0.01              Philippines
                         Settlement
  1. Sender enters recipient's phone number and amount
  2. StreamLine converts to stablecoins on Stellar
  3. Stellar network settles in 3-5 seconds
  4. Recipient gets SMS notification to cash out at local agent or mobile wallet
  5. Agent provides local currency instantly

πŸ› οΈ Tech Stack

Blockchain Layer

  • Stellar Blockchain - Fast, low-cost transactions
  • Soroban Smart Contracts - Escrow, auto-conversion, savings pools
  • Stellar Anchors - Fiat on/off-ramps
  • USDC/EURC - Stable value transfer

Application Layer

  • Frontend: React Native (iOS/Android), Progressive Web App
  • Backend: Node.js, Express, Rust (Soroban contracts)
  • Database: PostgreSQL, Redis (caching)
  • APIs: Stellar SDK, Horizon, Anchor integrations
  • Notifications: Twilio (SMS), Firebase (push)

Infrastructure

  • Hosting: AWS/Railway
  • CI/CD: GitHub Actions
  • Monitoring: Sentry, DataDog
  • Security: KYC/AML compliance, multi-sig wallets

πŸ—οΈ Architecture Overview

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                     Client Layer                         β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚ Mobile App   β”‚  β”‚  Web App     β”‚  β”‚  SMS Gateway β”‚  β”‚
β”‚  β”‚ (React Nat.) β”‚  β”‚   (PWA)      β”‚  β”‚   (Twilio)   β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    API Gateway                           β”‚
β”‚              (Node.js + Express + Auth)                  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  Business Logic Layer                    β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚  Transaction β”‚  β”‚   Wallet     β”‚  β”‚   Agent      β”‚  β”‚
β”‚  β”‚   Service    β”‚  β”‚   Manager    β”‚  β”‚   Network    β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  Stellar Integration                     β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚   Horizon    β”‚  β”‚   Soroban    β”‚  β”‚   Anchors    β”‚  β”‚
β”‚  β”‚     API      β”‚  β”‚  Contracts   β”‚  β”‚  (Fiat I/O)  β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β–Ό
                 ⭐ Stellar Network ⭐

🎯 Project Roadmap

Phase 1: MVP (Months 1-2) 🚧 Current Phase

  • Stellar wallet creation and management
  • Basic send/receive P2P transfers
  • SMS notification system
  • Single currency pair (USD β†’ PHP)
  • Simple web interface
  • Transaction history

Phase 2: Core Features (Months 3-4)

  • Soroban smart contracts for escrow
  • Multi-currency support (5+ corridors)
  • Mobile app (React Native)
  • QR code payments
  • Recurring payment scheduling
  • Exchange rate optimization

Phase 3: Agent Network (Months 5-6)

  • Agent onboarding system
  • Cash-out locations map
  • Agent reputation/rating
  • Commission management
  • Regional liquidity pools
  • KYC/AML compliance lite

Phase 4: Advanced Features (Months 7-9)

  • Micro-savings pools
  • Group remittance splitting
  • Loyalty rewards in XLM
  • Analytics dashboard
  • White-label solution for NGOs
  • Offline transaction queuing

Phase 5: Scale & Optimize (Months 10+)

  • Multi-chain support
  • AI-powered fraud detection
  • B2B partnerships
  • Regional regulatory compliance
  • 10+ currency corridors
  • Native blockchain wallet integration

πŸš€ Quick Start for Contributors

Prerequisites

- Node.js 18+
- Rust 1.70+ (for Soroban)
- Stellar CLI
- PostgreSQL 14+
- Git

Setup Development Environment

  1. Clone the repository
git clone https://github.com/YOUR-USERNAME/streamline.git
cd streamline
  1. Install dependencies
# Backend
cd backend
npm install

# Frontend
cd ../frontend
npm install

# Smart contracts
cd ../contracts
cargo build --target wasm32-unknown-unknown --release
  1. Configure environment
cp .env.example .env
# Edit .env with your Stellar testnet credentials
  1. Setup database
cd backend
npm run db:migrate
npm run db:seed
  1. Start development servers
# Terminal 1 - Backend
cd backend
npm run dev

# Terminal 2 - Frontend
cd frontend
npm run dev

# Terminal 3 - Soroban local network (optional)
stellar network start local
  1. Access the application
Frontend: http://localhost:3000
Backend API: http://localhost:5000
API Docs: http://localhost:5000/api-docs

Run Tests

# Backend tests
cd backend
npm test

# Frontend tests
cd frontend
npm test

# Smart contract tests
cd contracts
cargo test

πŸŽ“ Learning Resources

New to Stellar or blockchain development? Start here:


🀝 Contributing

We love contributors! Whether you're a:

  • πŸ¦€ Rust developer β†’ Soroban smart contracts
  • πŸ“± Mobile developer β†’ React Native app
  • ⛓️ Blockchain enthusiast β†’ Stellar integration
  • 🎨 Designer β†’ UI/UX improvements
  • 🌍 Translator β†’ Localization
  • πŸ“Š Data analyst β†’ Transaction analytics
  • πŸ“ Writer β†’ Documentation

There's a place for you here!

Check out our Contributing Guide and look for issues tagged:

  • good-first-issue - Perfect for newcomers
  • help-wanted - We need your expertise
  • beginner-friendly - Learning opportunity
  • high-impact - Critical features

πŸ’° Funding & Support

StreamLine is proudly supported by:

  • 🌊 Drips Network Wave - Open source funding
  • ⭐ Stellar Community Fund - Grant recipient
  • πŸ—οΈ Your contributions - Drips splits for active contributors

How Funding Works

Contributors earn through Drips dependency trees based on their contributions. The more you contribute, the more you earn!


πŸ“Š Current Stats

  • Contributors: Join us as a founding contributor!
  • Commits: Growing daily
  • Issues: 30+ tagged and ready
  • Stars: Give us a ⭐ if you believe in the mission

🌟 Why This Matters

Every transaction on StreamLine means:

  • A child staying in school instead of dropping out
  • A family having enough food for the month
  • Medical bills getting paid on time
  • Dreams staying alive across borders

We're not just building an app. We're building financial bridges that connect families.


πŸ“œ License

MIT License - See LICENSE for details


πŸ”— Links


πŸ™ Acknowledgments

Built with ❀️ by developers worldwide who believe in:

  • Financial inclusion
  • Open source collaboration
  • The power of blockchain for good

Special thanks to:

  • Stellar Development Foundation for the incredible blockchain
  • Drips Network for funding open source
  • Our contributors - You make this possible

πŸ’™ Join us in making remittances fair for everyone

Start Contributing β€’ View Issues β€’ Join Discord

Made with πŸ’™ by the StreamLine community

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors