Stellar-Sentinel/sentinel-frontend

选用指南

AI 根据 README 整理 · 2026/10/14 15:35:55

使用方式

通过浏览器访问在线仪表盘，或本地运行 Next.js 开发服务器使用。

查看 README 依据

# Stellar Sentinel Frontend [Open the live dashboard](https://sentinel-frontend-gules.vercel.app) Stellar Sentinel is a dashboard for screening Stellar account activity and reviewing Soroban contract flag events. Scores are transparent off-chain signals; they do not submit a transaction or create a contract flag. ## Architecture ```mermaid flowchart LR User --> UI[Next.js dashboard] UI -->|POST /risk/score| API[FastAPI backend] UI -->|GET /events and /network/status| API API -->|account activity| Horizon[Stellar Horizon]

cp .env.example .env.local npm ci npm run dev ``` Open [http://localhost:3000](http://localhost:3000). `npm run start` serves a production build after `npm run build`. ## Commands | Command | Purpose | | --- | --- | | `npm run dev` | Run the local Next.js development server. | | `npm run lint` | Run ESLint across the frontend. | | `npm run build` | Create a production build and check compilation/types. | | `npm run start` | Serve the production build. | There is no separate frontend unit-test suite configured yet. CI runs lint and build on pushes to `main` and pull requests.

部署要求

本地运行需要 Node.js 24 和 npm，并需单独启动后端服务。

查看 README 依据

README](https://github.com/Stellar-Sentinel/sentinel-contracts#testnet-deployment). ## Project layout - `app/page.tsx` — dashboard, account screening form, event feed, and section navigation. - `app/globals.css` — responsive layout, sidebar/mobile navigation, and component styles. - `app/layout.tsx` — document metadata and root layout. - `.env.example` — frontend API URL for local development. ## Run locally Requires Node.js 24 (the version used by CI) and npm. Start the backend separately; see [sentinel-backend](https://github.com/Stellar-Sentinel/sentinel-backend). ```bash

已知限制

事件源需要后端配置已部署的合约 ID；当前没有单独的前端单元测试套件。

查看 README 依据

feed requires a deployed contract ID configured in the backend. ## Stellar Testnet deployment The backend is configured for the Stellar Sentinel contract at [`CCZAAZ3FJ7LKZA7E7A6EKQTU2HCNVI3YUVIHKWHSULGZSWAJFS2D2XVX`](https://stellar.expert/explorer/testnet/contract/CCZAAZ3FJ7LKZA7E7A6EKQTU2HCNVI3YUVIHKWHSULGZSWAJFS2D2XVX). The dashboard reads its Soroban events through `GET /events`. The contract is initialized at threshold 70; its feed is empty until an authorized agent records a flag. Deployment and transaction details are in the [contract

cp .env.example .env.local npm ci npm run dev ``` Open [http://localhost:3000](http://localhost:3000). `npm run start` serves a production build after `npm run build`. ## Commands | Command | Purpose | | --- | --- | | `npm run dev` | Run the local Next.js development server. | | `npm run lint` | Run ESLint across the frontend. | | `npm run build` | Create a production build and check compilation/types. | | `npm run start` | Serve the production build. | There is no separate frontend unit-test suite configured yet. CI runs lint and build on pushes to `main` and pull requests.