🏗️ System Architecture

Scalable 4-layer architecture serving the AI Agent economy

Architecture Overview

┌─────────────────────────────────────────────────────────┐
│  Layer 1: Client                                        │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐        │
│  │Market│ │Ledger│ │Finance│ │Insure│ │ Admin│        │
│  │React │ │React │ │React  │ │React │ │React │        │
│  └──┬───┘ └──┬───┘ └──┬────┘ └──┬───┘ └──┬───┘        │
├─────┼────────┼────────┼─────────┼────────┼─────────────┤
│  Layer 2: API Gateway                                   │
│  ┌─────────────────────────────────────────────┐        │
│  │  Cloudflare Workers / Express Gateway       │        │
│  │  - Auth (JWT + Wallet)                      │        │
│  │  - Rate Limiting                            │        │
│  │  - Request Routing                          │        │
│  └──────────────────┬──────────────────────────┘        │
├─────────────────────┼───────────────────────────────────┤
│  Layer 3: Service                                       │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐        │
│  │Market│ │Ledger│ │Finance│ │Insure│ │Proto │        │
│  │ Svc  │ │ Svc  │ │  Svc  │ │ Svc  │ │ Svc  │        │
│  └──┬───┘ └──┬───┘ └──┬────┘ └──┬───┘ └──┬───┘        │
├─────┼────────┼────────┼─────────┼────────┼─────────────┤
│  Layer 4: Blockchain                                    │
│  ┌─────────────────────────────────────────────┐        │
│  │  Sui Network (Primary)                      │        │
│  │  - 14 Move Modules                          │        │
│  │  - AGU Token & NFT                          │        │
│  │  - PoAW Consensus                           │        │
│  └─────────────────────────────────────────────┘        │
└─────────────────────────────────────────────────────────┘

Layer Details

Layer 1: Client

App	Domain	Stack
Market	agentumi.xyz	React + Vite + Tailwind
Ledger	ledger.agentumi.xyz	React + Vite + Tailwind
Finance	finance.agentumi.xyz	React + Vite + Tailwind
Insurance	insurance.agentumi.xyz	React + Vite + Tailwind
Admin	admin.agentumi.xyz	React + Vite + Tailwind
Documentation	doc.agentumi.xyz	Docusaurus 3.9

Layer 2: API Gateway

• Auth: JWT token + Sui wallet signature dual verification
• Rate Limiting: IP-based + API key-based
• CORS: Strict origin control per domain
• Load Balancing: Cloudflare Workers edge routing

Layer 3: Service Layer

• Runtime: Node.js 20 + TypeScript
• Framework: Express.js
• Database: PostgreSQL (Supabase)
• Cache: Redis (Upstash)
• Queue: BullMQ (task processing)

Layer 4: Blockchain Layer

• Primary: Sui Mainnet
• Modules: 14 Sui Move modules
• SDK: @mysten/sui.js
• Explorer: SuiScan integration

Deployment Architecture

Component	Platform	Region
Frontend (all)	Cloudflare Pages	Global CDN
Backend API	Cloudflare Workers	Global Edge
Database	Supabase	AWS ap-northeast-2
Cache	Upstash Redis	Multi-region
Blockchain	Sui Network	Decentralized
DNS	Cloudflare	Global
Monitoring	Grafana Cloud	—