settlekit/docs/DEVELOPMENT_ROADMAP.md
caelum0x 874fa3a08a feat(apps): Phase 7 — escrow lifecycle, portal P2P send, checkout crosschain bridge
- dashboard: escrow detail lifecycle actions (assign/fund/submit/approve/refund) via server actions + api.escrow.* client methods.
- portal: P2P 'send USDC on Arc' page + nav (offline App Kit send, live swap documented); +@settlekit/app-kit dep.
- checkout: 'pay from another chain' crosschain bridge option (App Kit bridge, offline) next to wallet-pay.
- Built inline (subagent limit hit). Phase 7 complete. 1308 tests / 213 suites, typecheck + builds green.
2026-06-21 17:44:20 +03:00

3.7 KiB

SettleKit — Development Roadmap

Living plan for the continuous feature-development loop. Each iteration: pick the next unchecked item, implement the feature/functionality, verify pnpm typecheck + the relevant build stay green (no new test suites — features first), then commit + push and check the box. Items blocked on credentials (live Arc/Circle, a real DB host) are marked 🔒 and skipped by the loop.

Convention: [ ] todo · [x] done · [~] in progress · 🔒 blocked-on-creds.

Phase 1 — Web3 account & session management

  • Wallet unlink — DELETE /v1/auth/wallet + AuthService.unlinkWallet (guards against stranding a wallet-only login) + store index cleanup; dashboard "Unlink" button. (portal unlink button: follow-up)
  • Profile page — view/edit displayName; PATCH /v1/auth/account + dashboard Profile card (EditProfile).
  • Active sessions — list + revoke; GET/DELETE /v1/auth/sessions + dashboard Security card.

Phase 2 — Agent economy surfaces (ERC-8004 / ERC-8183 → product)

  • API + persistence for agent identities — Pg agent_registry + /v1/agents (register/list/get/feedback), org-scoped.
  • API + persistence for agent jobs — Pg agent_jobs + /v1/jobs (create/list/get/transition), guarded lifecycle.
  • apps/agent-console: Agents page (ERC-8004 identity + reputation) and Jobs page (ERC-8183 lifecycle timeline), driven by the Local ports.

Phase 3 — Creator monetization surfaces

  • apps/creator-dashboard: Source detail page — per-source earnings, citations, lineage.
  • Payout detail page — a payout's legs + recursive split breakdown.
  • Attribution management — Prove&sign UI (/api/prove + ProofSigner) on @settlekit/attribution.

Phase 4 — Marketplace & checkout depth

  • apps/marketplace: agent-service detail page + tag/search filtering.
  • apps/checkout: wallet-pay option — real @circle-fin/app-kit (live) + offline LocalAppKitSdk default.

Phase 5 — Admin & observability

  • apps/admin: settlements console (status, reconcile view).
  • Webhook delivery log + replay UI (admin).
  • Risk review queue surface (admin).

Phase 6 — Live wiring, notifications, analytics, real Circle SDKs

  • Agent console live wiring — apps/agent-console calls the real /v1/agents + /v1/jobs APIs (replace Local-port demo data) with register/create/transition actions.
  • Notifications & webhooks — apps/dashboard in-app notification center + webhook endpoint management UI + delivery/retry view.
  • Analytics & reporting — apps/admin revenue/settlement/agent-economy dashboards with date ranges + CSV export.
  • Real Circle SDK deepening — @circle-fin/adapter-viem-v2 (live App Kit signer) + @circle-fin/developer-controlled-wallets (real DCW), dynamic-imported helpers.

Phase 7 — Port vendored Circle sample flows into the product

  • Escrow management — apps/dashboard UI over @settlekit/escrow (/v1/escrow): create → fund → submit → release/refund (pattern from vendor/arc-escrow).
  • P2P send — apps/portal "send USDC" flow over @settlekit/app-kit (offline LocalAppKitSdk + documented live) (pattern from vendor/arc-p2p-payments).
  • Crosschain bridge — apps/checkout App Kit bridge surface over @settlekit/app-kit (pattern from vendor/arc-multichain-wallet + vendor/circle-bridge-kit-transfer).

🔒 Blocked on credentials (not in the loop)

  • Live Arc settlement (faucet key + arc-canteen/circle CLI auth).
  • ERC-8004/8183 ABI cross-check against deployed bytecode.
  • Production DB migration run (db:migrate against a real DATABASE_URL).