Automated Bitcoin Dollar-Cost Averaging on Starknet
StarkDCA lets you set-and-forget a recurring Bitcoin buying strategy powered entirely by Starknet smart contracts. Deposit USDT, choose your schedule, and a backend scheduler executes purchases at defined intervals using on-chain contracts and oracle price feeds — all non-custodial.
- Automated DCA — Create daily, weekly, or monthly Bitcoin accumulation plans
- Non-Custodial — Your funds stay on-chain; only you can cancel or withdraw
- Low Gas Fees — Powered by Starknet's ZK-rollup for minimal transaction costs
- Dark Mode — Full light/dark theme support across the entire app
- Real-Time Dashboard — Live price feeds, plan analytics, and execution history
- Email Notifications — Waitlist confirmation, verification, and launch alerts
- Waitlist System — Early access signup with position tracking
┌─────────────────────┐ ┌──────────────┐ ┌──────────────────┐
│ Frontend │────▶│ Backend │────▶│ Starknet Chain │
│ React / Vite │ │ Express API │ │ Cairo Contracts │
│ TailwindCSS │ │ Prisma ORM │ │ Oracle + USDT │
│ shadcn/ui + Radix │ │ BullMQ │ │ ERC-20 Tokens │
│ Zustand │ │ Redis │ │ │
└─────────────────────┘ └──────┬───────┘ └──────────────────┘
│ HTTP
┌──────▼───────┐
│ Email Service│
│ Vercel Funcs │
│ SMTP/SendGrid│
└──────────────┘
| Layer | Description |
|---|---|
| Frontend | React SPA with TailwindCSS, shadcn/ui, glassmorphism design system, Starknet wallet integration, DCA plan management, and real-time price display. |
| Backend | Express API with Prisma (PostgreSQL), Redis caching, BullMQ workers, and Starknet.js for on-chain execution. |
| Email Service | Standalone Vercel serverless functions handling all transactional emails (OTP, waitlist, launch). Backend calls it via HTTP. |
| Contracts | Cairo smart contracts handling plan state, fund custody, and execution authorization. |
StarkDCA/
├── apps/
│ ├── frontend/ # React + Vite + TailwindCSS + shadcn/ui
│ │ ├── src/
│ │ │ ├── components/
│ │ │ │ ├── landing/ # Landing page sections (Hero, Features, Team, …)
│ │ │ │ ├── ui/ # shadcn/ui primitives (Button, Card, Dialog, …)
│ │ │ │ └── Navbar.tsx
│ │ │ ├── features/dca/ # DCA feature module (components, hooks, types)
│ │ │ ├── layouts/ # DashboardLayout
│ │ │ ├── lib/ # cn() utility, ws-shim
│ │ │ ├── pages/ # Landing, Waitlist, Dashboard, Activity, Settings, Admin
│ │ │ ├── services/
│ │ │ │ ├── api/ # Axios client, DCA, price, waitlist endpoints
│ │ │ │ └── blockchain/ # Starknet wallet connect/disconnect
│ │ │ └── store/ # Zustand stores (auth, wallet, DCA)
│ │ ├── public/ # Static assets (favicon)
│ │ └── index.html # Entry point with SEO meta tags
│ ├── backend/ # Node.js + Express + TypeScript + Prisma
│ │ ├── prisma/ # Schema & migrations
│ │ ├── src/
│ │ │ ├── config/ # Environment loader
│ │ │ ├── infrastructure/ # DB, Redis, Email (HTTP client), Logger
│ │ │ ├── middleware/ # Auth, rate-limit, idempotency, validation
│ │ │ ├── modules/ # admin, auth, dca, execution, price, waitlist
│ │ │ └── utils/ # Errors, pagination, distributed lock
│ │ └── jest.config.js
│ ├── email-endpoint/ # Vercel serverless email service
│ │ ├── api/ # send-otp, send-email, health endpoints
│ │ └── lib/ # providers, templates, auth, validation
│ └── contracts/ # Cairo + Scarb + Starknet Foundry
│ ├── src/
│ │ ├── dca.cairo # Main DCA contract
│ │ ├── interfaces.cairo # IStarkDCA, IERC20, IOracle
│ │ └── lib.cairo
│ └── tests/
│ └── test_dca.cairo
├── packages/
│ └── shared-types/ # TypeScript types shared across apps
├── scripts/ # Docker entrypoint, migration scripts
├── CHANGELOG.md
├── Dockerfile
├── render.yaml
├── tsconfig.base.json
└── package.json # npm workspaces root
| Layer | Technology |
|---|---|
| Frontend | React 18, Vite 5, TypeScript 5.4, TailwindCSS 3.4, shadcn/ui, Radix UI, Framer Motion, Lucide Icons, Zustand, Axios, Starknet.js |
| Backend | Node.js, Express 4, TypeScript, Prisma (PostgreSQL), Redis, BullMQ, Winston, JWT, Jest |
| Contracts | Cairo (edition 2024_07), Scarb, Starknet Foundry v0.35.0 |
| Shared | @stark-dca/shared-types — TypeScript types shared across apps |
| Vercel serverless functions, NodeMailer / SendGrid, Zod validation | |
| Infra | Docker, Render (backend), Vercel (frontend + email service) |
# Clone the repo
git clone https://github.com/RabbitDaCoder/StarkDCA.git
cd StarkDCA
# Install all workspace dependencies
npm install
# Build shared types (required before other apps)
npm run build:shared
# Copy environment files
cp apps/backend/.env.example apps/backend/.env
cp apps/frontend/.env.example apps/frontend/.env
# Run database migrations
cd apps/backend && npx prisma migrate deploy && cd ../..# Start backend (port 4000)
npm run dev:backend
# Start frontend (port 3000, proxies /api to backend)
npm run dev:frontend# Build everything (shared → backend → frontend)
npm run buildnpm run test:backendcd apps/contracts
snforge testTests cover: plan creation, execution, completion, cancellation, and authorization checks.
| Variable | Description |
|---|---|
PORT |
Server port (default: 4000) |
NODE_ENV |
development or production |
DATABASE_URL |
PostgreSQL connection string |
REDIS_URL |
Redis connection string |
JWT_SECRET |
Secret key for JWT tokens |
JWT_ACCESS_SECRET |
JWT access token secret (min 32 ch) |
JWT_REFRESH_SECRET |
JWT refresh token secret (min 32 ch) |
STARKNET_RPC_URL |
Starknet RPC endpoint |
DCA_CONTRACT_ADDRESS |
Deployed DCA contract address |
EXECUTOR_PRIVATE_KEY |
Private key for the executor account |
EXECUTOR_ADDRESS |
Executor account address |
EMAIL_SERVICE_URL |
Vercel email-endpoint URL |
EMAIL_SERVICE_API_KEY |
Shared secret with email service |
CORS_ORIGIN |
Allowed frontend origin for CORS |
FRONTEND_URL |
Frontend URL (used in emails) |
GOOGLE_CLIENT_ID |
Google OAuth client ID |
GOOGLE_CLIENT_SECRET |
Google OAuth client secret |
BCRYPT_ROUNDS |
Password hashing rounds (default 12) |
ENABLE_CRON |
Enable in-process cron (true/false) |
| Variable | Description |
|---|---|
VITE_API_URL |
Backend API base URL (include /v1) |
VITE_STARKNET_CHAIN_ID |
Target chain (SN_SEPOLIA or SN_MAIN) |
VITE_DCA_CONTRACT_ADDRESS |
DCA contract address for direct reads |
VITE_DCA_ENGINE_ADDRESS |
DCA engine contract address |
VITE_USDT_TOKEN_ADDRESS |
USDT token contract address |
VITE_MBTC_TOKEN_ADDRESS |
mBTC token contract address |
VITE_STARKNET_RPC_URL |
Starknet JSON-RPC endpoint |
- Build:
scarb build - Declare:
starkli declare - Deploy:
starkli deploy - Update
DCA_CONTRACT_ADDRESSin backend and frontend.env
docker build -t starkdca-backend .
# Deploy to Render, Railway, Fly.io, or AWS ECScd apps/email-endpoint
npm install
npx vercel --prod
# Set env vars in Vercel dashboard (SMTP creds, EMAIL_SERVICE_API_KEY, etc.)
# Then set EMAIL_SERVICE_URL + EMAIL_SERVICE_API_KEY on Render backendSee apps/email-endpoint/README.md for full setup details.
npm run build:frontend
# Deploy apps/frontend/dist/ to Vercel, Netlify, or Cloudflare Pages- Fork & branch — Create a feature branch from
main - Follow conventions — Run
npm run lintandnpm run formatbefore committing - Test — Add tests for new logic; all tests must pass before merging
- PR — Open a pull request with a clear description
- Review — At least one approval required
| Name | Role | Links |
|---|---|---|
| Edeh Chinedu Daniel (RabbitDaCoder) | Smart Contract Developer / Software Engineer | 𝕏 · LinkedIn · GitHub |
| Muadh Ibrahim Adeleke | Graphic Designer | 𝕏 |
| Ojile Clement | UI/UX Designer | 𝕏 |
| Ezedimbu Anthony Maduabuchukwu | Graphic Designer | 𝕏 |
- Website: www.starkdca.xyz
- Support: support@starkdca.xyz
- X / Twitter: @StarkDCA_
- GitHub: RabbitDaCoder/StarkDCA
MIT