Skip to content

QuantaTrade AI — Components Index

Single-file context for all planned components. When a component is bootstrapped, its CLAUDE.md at the repo's root should cite this file.

Status legend: 🟢 in progress · 🟡 planned this phase · ⚪ future phase · 🔴 blocked

Smart Contracts

contracts/token — $QTRA ERC-20

  • Milestone: M2
  • Tech: Solidity, Hardhat, OpenZeppelin
  • Status: 🔴 blocked — immutability posture unresolved (staking-open-questions.md §4)
  • Supply: 1.2B fixed, mint permanently disabled, no admin key, no upgrade proxy
  • Chain: EVM (Ethereum / Base / Arbitrum — chain decision pending)

contracts/sale — SaleManager

  • Milestone: M2
  • Tech: Solidity, Hardhat
  • Status: 🟡 planned
  • Rounds: Private A, Private B, Private C, Public
  • Payment: USDC only
  • Gating: whitelist for private rounds, KYC status check integration

contracts/vesting — Allocation & Vesting

  • Milestone: M2
  • Tech: Solidity, Hardhat
  • Status: 🟡 planned
  • Schedule: per docs/tokenomics-proposal.md

contracts/staking — $QTRA Staking

  • Milestone: M5
  • Tech: Solidity, Hardhat
  • Status: 🔴 blocked — 8 open questions (docs/staking-open-questions.md)
  • Scope: warmup, cooldown, tier weights (1.00x/1.20x/1.60x), claim streams, revenue-share yield

contracts/revenue-router — Revenue Router (separate audit)

  • Milestone: M5
  • Tech: Solidity, Hardhat
  • Status: 🔴 highest-risk contract per client — dedicated audit budgeted
  • Scope: receives USDT/USDC revenue, splits 50/20/20 per spec, immutable parameters

Backend Services

backend/exchange-engine — Matching Engine

  • Milestone: M1
  • Tech: Java or Rust (decision pending)
  • Status: 🟡 planned
  • Scope: internal CLOB, matching, smart order routing, kill-switches, failover

backend/api-gateway — REST + WebSocket

  • Milestone: M1
  • Tech: Node.js 20, NestJS
  • Status: 🟡 planned
  • Scope: public + authenticated APIs, rate limiting, WS order streaming

backend/custody-service — BitGo integration

  • Milestone: M2
  • Tech: Node.js 20, NestJS
  • Status: 🔴 blocked — BitGo API creds pending from client
  • Confirmed provider: BitGo (2026-04-19, supersedes earlier Fireblocks scope)

backend/compliance-service — KYC / AML / Sanctions

  • Milestone: M4
  • Tech: Node.js 20, NestJS
  • Status: 🟡 planned
  • Provider: Sumsub (or equivalent — selection + contract pending)

backend/treasury-service — Treasury management

  • Milestone: M2
  • Tech: Node.js 20, NestJS
  • Status: 🟡 planned

backend/indexer — On-chain event indexer

  • Milestone: M1 baseline, extended M3/M5
  • Tech: Node.js 20 + viem, PostgreSQL + TimescaleDB
  • Status: 🟡 planned
  • Scope: token events, sale events, staking events, feeds for UI

backend/strategy-engine — Python strategies

  • Milestone: M4
  • Tech: Python 3.12, FastAPI
  • Status: ⚪ future
  • Scope: AI/ML strategies, backtesting, signal emission

Frontend

frontend/trading-platform — Main trading UI

  • Milestone: M4
  • Tech: Next.js 15, React, TradingView
  • Status: ⚪ future

frontend/presale-app — Token presale web app

  • Milestone: M3
  • Tech: Next.js 15, wagmi/viem
  • Status: 🟡 planned
  • Scope: wallet connect, round selection, USDC payment, KYC check

frontend/investor-dashboard — Investor portal

  • Milestone: M3
  • Tech: Next.js 15
  • Status: 🟡 planned
  • Scope: allocation view, vesting schedule, claim UI

frontend/admin-panel — Admin management

  • Milestone: M3
  • Tech: Next.js 15
  • Status: 🟡 planned
  • Scope: whitelist, round control, compliance queue

(untracked) frontend/ — March scaffold

  • Milestone: pre-M1 prototype
  • Tech: Next.js 15, Prisma, SQLite, NextAuth
  • Status: 🔴 unreviewed — decision pending (keep / discard / move). Contains .env with secrets — do not git add until scrubbed.

Infrastructure

infrastructure/terraform — Cloud infrastructure

  • Milestone: cross-cutting, baseline by M2
  • Tech: Terraform, AWS (or GCP — pending decision)
  • Status: 🟡 planned

infrastructure/kubernetes — Service orchestration

  • Milestone: cross-cutting, baseline by M2
  • Tech: Kubernetes manifests / Helm
  • Status: 🟡 planned

infrastructure/ci-cd — Pipelines

  • Milestone: cross-cutting, baseline by M1
  • Tech: GitHub Actions
  • Status: 🟡 planned

Data Platform

Layer Tech Purpose
Ledger, trades, core state PostgreSQL + TimescaleDB Double-entry ledger, time-series
Cache Redis Cluster Order books, sessions, pub/sub
Event streaming Kafka / Redpanda Event-driven service comms

References

  • docs/roadmap.md — Gantt + week-by-week milestones
  • docs/architecture.md — system architecture
  • docs/tech-decisions.md — stack rationale
  • docs/milestone-acceptance-criteria.md — Richard's checklist
  • docs/repo-bootstrap-plan.md — per-repo bootstrap order
  • docs/staking-open-questions.md — M5 blockers
  • docs/system-spec-summary.md — PDF spec digest (PDF appears truncated — buyback + tech sections missing)