Project Structure
Complete file tree with descriptions for every file in the repository.
Overview
The repository is organized into three main directories, each representing a layer of the system. The frontend and oracle share the same Sui SDK and scoring formulas for consistency.
Frontend
fe_frontierpulse/
34
files
~95K
lines
Next.js 16
Oracle Backend
oracle_backend/
9
files
~3K
lines
Node.js
Smart Contract
smartcontract_FP/
6
files
~1K
lines
Sui Move (edition 2024) — PulseRegistry
Root files:PROJECT_README.mdRESEARCH_EVE_FRONTIER_SUI.mdideas/docs_fp/
Frontend
fe_frontierpulse/
Next.js 16 + React 19 + TailwindCSS 4 + Zustand 5
Oracle Backend
oracle_backend/
Node.js + TypeScript + node-cron + @mysten/sui SDK
Smart Contract
smartcontract_FP/
Sui Move (edition 2024) — PulseRegistry
Documentation Site
docs_fp/
Next.js 16 documentation site (this site)
Key Library Files
| File | Purpose | Key Exports |
|---|---|---|
| worldApi.ts | EVE Frontier World API client | fetchAllSystems(), fetchSystemDetail() |
| suiReader.ts | On-chain data reader via JSON-RPC | readRegistry() → CHI + stats |
| liveData.ts | Live scoring from assemblies + killmails | getLivePlayers(), getLiveCHI(), getLiveAlerts() |
| vitals.ts | Deterministic hash-based vitals | getSystemVitals(systemId) |
| store.ts | Zustand state (UI + watchlist + wallet) | useUIStore hook |
| colors.ts | Trust color palette | getTrustColor(), getSeverityColor() |
| types.ts | TypeScript interfaces | WorldSystem, PlayerReputation, CHIData, Alert |
The contract is deployed to Sui Testnet. Package ID:
0x6618...bbc9. PulseRegistry: 0x945f...32c4.