- 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.
3.7 KiB
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-consolecalls the real/v1/agents+/v1/jobsAPIs (replace Local-port demo data) with register/create/transition actions. - Notifications & webhooks —
apps/dashboardin-app notification center + webhook endpoint management UI + delivery/retry view. - Analytics & reporting —
apps/adminrevenue/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/dashboardUI over@settlekit/escrow(/v1/escrow): create → fund → submit → release/refund (pattern fromvendor/arc-escrow). - P2P send —
apps/portal"send USDC" flow over@settlekit/app-kit(offlineLocalAppKitSdk+ documented live) (pattern fromvendor/arc-p2p-payments). - Crosschain bridge —
apps/checkoutApp Kit bridge surface over@settlekit/app-kit(pattern fromvendor/arc-multichain-wallet+vendor/circle-bridge-kit-transfer).
🔒 Blocked on credentials (not in the loop)
- Live Arc settlement (faucet key +
arc-canteen/circleCLI auth). - ERC-8004/8183 ABI cross-check against deployed bytecode.
- Production DB migration run (
db:migrateagainst a realDATABASE_URL).