🌟 Stellar MicroPay

Cross-border micro-payments, powered by the Stellar blockchain.

Stellar MicroPay is an open-source platform that lets anyone send small payments across borders instantly using XLM on the Stellar network. No banks. No high fees. No waiting.

---

✨ Features (v1)

• 🔗 Connect Wallet — Freighter browser wallet integration
• 💸 Send XLM — Send micro-payments to any Stellar address globally
• 📜 Transaction History — View your recent payment activity
• 🌍 Cross-border — Works anywhere in the world, near-zero fees

🗂 Project Structure

stellar-micropay/
├── 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

🚀 Quick Start

Prerequisites

Tool	Version
Node.js	≥ 18.x
npm / yarn	Latest
Rust + Cargo	≥ 1.74 (for contracts)
Freighter Wallet	Browser extension
Docker + Compose	≥ 24.x (optional, recommended)

1. Clone the repository

git clone https://github.com/your-org/stellar-micropay.git
cd stellar-micropay

2. Option A — Docker (recommended)

The fastest way to get a fully working dev environment with hot-reload:

docker compose up

• Frontend (HMR): http://localhost:3000
• Backend (nodemon): http://localhost:4000

Editing any frontend or backend file reflects instantly without restarting containers.

For a production build:

docker compose -f docker-compose.prod.yml up --build

2. Option B — Manual Setup

Run the setup script to install all dependencies and copy env files:

chmod +x scripts/setup-dev.sh
./scripts/setup-dev.sh

Then start each service in a separate terminal:

# Terminal 1
cd frontend && npm run dev   # → http://localhost:3000

# Terminal 2
cd backend && npm run dev    # → http://localhost:4000

3. Build Soroban Contracts (optional)

cd contracts/stellar-micropay-contract
cargo build --target wasm32-unknown-unknown --release

---

🔑 Environment Variables

Frontend (frontend/.env.local)

NEXT_PUBLIC_STELLAR_NETWORK=testnet
NEXT_PUBLIC_HORIZON_URL=https://horizon-testnet.stellar.org
NEXT_PUBLIC_API_URL=http://localhost:4000

Backend (backend/.env)

PORT=4000
STELLAR_NETWORK=testnet
HORIZON_URL=https://horizon-testnet.stellar.org

---

🧪 Get Testnet XLM

1. Install Freighter Wallet
2. Switch to Testnet in Freighter settings
3. Visit Stellar Friendbot and paste your public key
4. You'll receive 10,000 test XLM instantly

---

🤝 Contributing

We love contributions! See CONTRIBUTING.md to get started.

🗺 Roadmap

See ROADMAP.md for planned features.

📄 License

MIT — see LICENSE