Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions docs/general/system-flow.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# StartupChain System Flow

> **Last Updated:** December 11, 2025
> **Last Updated:** February 23, 2026
> **Status:** Early Production
> **Important:** Keep this diagram updated when making architectural changes.

Expand All @@ -13,6 +13,7 @@ StartupChain is an onchain company OS that allows founders to:
- Configure company structure (solo/multi-founder with equity splits)
- **Hybrid registration:** Server handles ENS commit/register/Safe deploy → **User signs** final `recordCompany()` tx
- Manage from a unified dashboard
- **ENS management (proposal-first):** founders propose ENS trait/subdomain updates via Safe queue, UI reflects onchain confirmation
- **Session persistence:** Registration state saved in cookie for page refresh resilience

**Core Flow:** `ENS Check → Auth → Setup Wizard → Prepay to Treasury → (Auto) Commit → Wait 60s → Deploy Safe → Register ENS (to Safe) → **User Signs recordCompany()** → Dashboard`
Expand Down Expand Up @@ -292,10 +293,10 @@ StartupChain is an onchain company OS that allows founders to:
│ ┌────────────────────────────────────────────────────────────────────────────────────┐ │
│ │ /dashboard/ens - ENS Management Page │ │
│ │ ┌──────────────────────────────────────────────────────────────────────────────┐ │ │
│ │ │ • ENS name display with expiry │ │ │
│ │ │ • Registration history (from cookie fallback or blockchain events) │ │ │
│ │ │ • Safe deployment tx, ENS registration tx, Company recording tx │ │ │
│ │ │ • Links to block explorer for each transaction │ │ │
│ │ │ • ENS profile traits (avatar/description/url) with proposal-first updates │ │ │
│ │ │ • Subdomain create/revoke proposals submitted to Safe queue │ │ │
│ │ │ • Pending proposal badges + periodic refresh until onchain confirmation │ │ │
│ │ │ • Links to Safe queue + explorer traces for registration/proposal txs │ │ │
│ │ └──────────────────────────────────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────────────────────┘ │
│ │
Expand Down
Loading
Loading