Skip to content

Roadmap

May be out of date

The "Recent Progress" section at the bottom of this page is dated January 2025 and has not been refreshed. Phase statuses below may also lag the actual code. Cross-reference with the README before relying on any status flag.

This roadmap sequences the sarpoy-api, sarpoy-ui, and Solana program so we can ship a cohesive experience without blocking critical paths. Timelines are indicative (2-week sprints) and should be adjusted as milestones close.

Guiding Metrics

  • Time-to-bot-launch: < 5 minutes from login to live bot.
  • Median solver latency: < 1 second between chat turns (off-chain).
  • Settlement reliability: 99% of payouts confirmed on-chain within 2 blocks.

Phase 0 – Foundations (Completed Sprint 0) ✅

  • ✅ Converted SQLAlchemy models into TortoiseORM schemas + Aerich migrations.
  • ✅ Defined .env contract (database, Solana RPC, Anchor program IDs).
  • ✅ Fleshed out Solana program spec and anchor project scaffolding.
  • ✅ Documented API/UI contracts.

Status: Database migrates cleanly, health endpoints exist.

Phase 1 – sarpoy-api MVP (Completed Sprint 1–2) ✅

  • ✅ Implemented wallet-based auth (nonce, signature verification, JWT issuance).
  • ✅ CRUD for bots, chat sessions, and messages backed by TortoiseORM models.
  • ✅ Integrated Solana program with SarpoyClient for on-chain interaction.
  • ✅ Leaderboard endpoints with mock data.
  • ✅ Sample data for bots and chat sessions.

Status: API can drive a simple client. Program compiles and is ready for devnet deployment.

Phase 2 – sarpoy-ui MVP (In Progress Sprint 3–4) 🔄

  • ✅ Bootstrap Nuxt 3 project with Tailwind CSS, @solana/web3.js.
  • ✅ Build key pages:
  • Landing page with hero, stats, featured puzzles
  • Bot directory with search and filters
  • Bot detail + chat interface
  • Create puzzle form with SOL economics
  • Leaderboard page
  • ✅ Implement WalletConnectButton with Phantom wallet support.
  • ✅ Create useSolana() and useApi() composables.
  • 🔄 Connect UI to on-chain data (awaiting program deployment).

Status: UI scaffolding complete. End-to-end flow ready for devnet integration.

Phase 3 – Solana Program Hardening (Sprint 5–6) ⏳

  • ⏳ Finalize Anchor program (currently has 4 instructions: initialize, send_message, submit_solution, close_bot).
  • ⏳ Run integration tests against localnet + Devnet.
  • ⏳ Commission external audit or community review.

Status: Program implemented and compiles. Ready for deployment and testing.

Phase 4 – Beta + Scale (Sprint 7+)

  • Deploy API + UI to managed hosting (Fly/Vercel) with CI/CD and feature flags.
  • Add analytics dashboards, Discord alerts, and admin tooling.
  • Explore token-gated bots, multi-chain bridges, or marketplace extensions based on user feedback.

Status: Not yet started.

Risk Register (Living)

  • Anchor complexity: Mitigate by isolating Solana work behind interfaces and shipping mocks early.
  • Wallet UX friction: Run usability tests, provide multiple wallet adapters, cache session signatures.
  • Operational load: Add observability from day one and budget time for alert tuning in each sprint.

Recent Progress (Jan 2025)

  • Solana program lib.rs completed with all 4 instructions
  • Fixed PDA seed derivation and CPI signer issues
  • SarpoyClient class with inline IDL fallback for development
  • Nuxt 3 app scaffolded with 5 pages and wallet integration
  • README updated with quick start guides for all components