Blockchain-powered crowdfunding for the internet.
CrowdPay lets creators, startups, and communities raise funds globally. Each campaign gets its own Stellar multisig wallet. Contributions are tracked on-chain, milestone payouts are governed by Soroban smart contracts, and contributors can deposit fiat via MoneyGram's Stellar anchor.
Status: Active development — testnet only.
- Creator launches a campaign with a funding goal, deadline, and optional milestones
- Contributors send USDC (or any Stellar asset — path payments handle conversion)
- Funds sit in a campaign escrow wallet; the Soroban contract tracks milestone completion
- Creator requests withdrawal → platform co-signs → funds released to creator
- If the campaign fails to hit its goal, contributors can claim refunds
Browser ──────────────────────────────────────────────────────────────
React 18 + Vite │ React Router │ Freighter wallet │ i18next (en, fr)
────────────────────────────────────────────────────────────────────────
│ HTTPS
▼
Backend ──────────────────────────────────────────────────────────────
Express │ JWT auth │ Winston │ Sentry │ rate-limit │ Swagger docs
┌────────────────────────────────────────────────────────────────┐
│ routes: campaigns · contributions · withdrawals · milestones │
│ disputes · users · wallets · notifications · webhooks │
│ anchor · admin · api-keys │
└────────────────────────────────────────────────────────────────┘
┌────────────────────────────────────────────────────────────────┐
│ services: stellarService · sorobanService · anchorService │
│ ledgerMonitor · reconciliation · contributionService │
│ emailService · kycProvider · webhookDispatcher │
│ walletSecrets · campaignStatusService │
└────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
PostgreSQL Stellar Horizon AWS S3 / R2
(pgv8/pg) + Soroban RPC (campaign images)
│
MoneyGram SEP-24 Anchor
(fiat ↔ USDC rails)
crowdpay/
├── backend/
│ ├── src/
│ │ ├── config/ # env, database, stellar client, logger, constants
│ │ ├── routes/ # one file per resource (campaigns, contributions, ...)
│ │ ├── services/ # all business logic and third-party integrations
│ │ ├── middleware/ # auth, validation, error handler, request ID
│ │ └── index.js # Express app entry point
│ └── db/
│ ├── schema.sql # base schema
│ ├── migrate.js # migration runner
│ └── migrations/ # date-prefixed SQL files
├── frontend/
│ └── src/
│ ├── pages/ # 18 route-level page components
│ ├── components/ # reusable UI (CampaignCard, ContributeModal, ...)
│ ├── context/ # AuthContext, ThemeContext, ToastContext
│ ├── services/ # typed API client functions
│ ├── locales/ # i18n JSON (en, fr)
│ └── config/ # Stellar/Freighter config
└── contracts/
└── soroban/ # Rust Soroban contracts (escrow, milestone release)
git clone https://github.com/Savitura/crowdpay
cd crowdpay
cp backend/.env.example backend/.env
docker compose up| Service | URL |
|---|---|
| Frontend | http://localhost:5173 |
| Backend | http://localhost:3001 |
| API docs | http://localhost:3001/api/docs |
The database schema is applied automatically. Hot-reload is active for both processes.
# Prerequisites: Node.js 20+, PostgreSQL 15+
cd backend && npm install && cp .env.example .env
# Fill in .env (see Environment Variables below)
npm run migrate:fresh
cd ../frontend && npm install
# Two terminals:
cd backend && npm run dev # http://localhost:3001
cd frontend && npm run dev # http://localhost:5173| Variable | Description |
|---|---|
DATABASE_URL |
PostgreSQL connection string |
JWT_SECRET |
Random 32+ char secret |
STELLAR_NETWORK |
testnet or mainnet |
STELLAR_HORIZON_URL |
Horizon endpoint URL |
PLATFORM_SECRET_KEY |
Stellar secret key for the platform co-signer wallet |
USDC_ISSUER |
USDC issuer (GBBD47... on testnet) |
WALLET_SECRET_LOCAL_KEK |
Base64-encoded key-encryption key for stored secrets |
FRONTEND_URL |
Allowed CORS origin (dev: http://localhost:5173) |
SMTP_HOST / EMAIL_SERVICE_API_KEY |
Email delivery (optional in dev) |
PERSONA_API_KEY / PERSONA_TEMPLATE_ID |
KYC provider (optional in dev) |
AWS_ACCESS_KEY_ID + S3 vars |
Image uploads (optional in dev) |
Generate a platform keypair:
node -e "const {Keypair} = require('@stellar/stellar-sdk'); const kp = Keypair.random(); console.log('Public:', kp.publicKey()); console.log('Secret:', kp.secret());"Fund it on testnet:
curl "https://friendbot.stellar.org?addr=<PLATFORM_PUBLIC_KEY>"cd backend && npm test # Node test runner + Supertest
cd frontend && npm test # VitestCampaign wallet: Each campaign has a dedicated Stellar account with a 2-of-2 multisig threshold — contributions go directly to it. The platform co-signer key is required for withdrawals.
Soroban escrow: The Rust contract at contracts/soroban/ holds contribution records on-chain. Milestone release calls invoke the contract before the backend builds the withdrawal transaction.
Anchor deposits: anchorService.js implements SEP-10 (web auth) + SEP-24 (interactive deposit) with MoneyGram. Users can deposit cash or USD and receive USDC in their CrowdPay wallet.
Reconciliation: reconciliation.js runs periodically to compare raised_amount in PostgreSQL against the live Stellar account balance. Discrepancies are logged and resolved.
Campaign status cron: campaignStatusService.js runs hourly (via node-cron in backend/src/index.js) to transition active campaigns to funded or failed when goals or deadlines are met. Set ENABLE_CAMPAIGN_STATUS_CRON=false to disable the in-process scheduler (e.g. when using an external cron that calls POST /api/campaigns/cron/fail-expired instead). On each transition, campaignStatusActions.js sends emails, fires webhooks, creates in-app notifications, logs the change in campaign_status_events, and queues contributor refunds for failed campaigns.
See CONTRIBUTING.md.
MIT