Insight - Oracle Data Analytics Platform

Insight is a professional oracle data analytics platform that provides comprehensive analysis and comparison of mainstream oracle protocols including Chainlink, Band Protocol, UMA, Pyth, API3, RedStone, DIA, Tellor, Chronicle, and WINkLink.

Key Features

Real-time Price Monitoring - Live price feeds from multiple oracle providers with real-time updates
Cross-Oracle Price Comparison - Compare prices across different oracles for the same asset
Cross-Chain Performance Analysis - Analyze oracle performance across multiple blockchain networks
Market Overview - Track Total Value Secured (TVS) and market metrics
Price Alerts & Notifications - Configure custom price alerts with multiple trigger conditions
User Favorites & Snapshots - Save and share price snapshots and favorite configurations
Data Export - Export data in CSV, JSON, Excel, PDF, and PNG formats
Internationalization - Full support for English and Chinese (zh-CN)
Anomaly Detection - Automatic detection of price anomalies and outliers
Technical Indicators - RSI, MACD, Bollinger Bands, ATR, and more
Data Transparency - Data source indicators and update time tracking
Accessibility Support - Keyboard navigation, colorblind mode, screen reader support

Technology Stack

Frontend

Framework: Next.js 16.1.6 (App Router)
UI Library: React 19.2.3
Language: TypeScript 5.x
Styling: Tailwind CSS 4.x
State Management: React Query 5.90.21, Zustand 5.0.11
Charts: Recharts 3.8.0
Animations: Framer Motion 12.36.0
Internationalization: next-intl 4.8.3

Backend

API: Next.js API Routes
Database: Supabase 2.98.0 (PostgreSQL with Row Level Security)
Authentication: Supabase Auth with OAuth support
Real-time: WebSocket, Supabase Realtime
Error Tracking: Sentry 10.43.0

Oracle Clients

Pyth Hermes Client (@pythnetwork/hermes-client 2.0.0)
Custom oracle clients for all supported providers

Prerequisites

Node.js 18.x or higher
npm or yarn
Supabase account (for database and authentication)

Installation

Clone the repository:
```
git clone <repository-url>
cd insight
```
Install dependencies:
```
npm install
```
Set up environment variables (see Environment Variables section below)
Run the development server:
```
npm run dev
```

Environment Variables

Create a .env.local file in the root directory with the following variables:

Variable	Description	Required
`NEXT_PUBLIC_SUPABASE_URL`	Supabase project URL	Yes
`NEXT_PUBLIC_SUPABASE_ANON_KEY`	Supabase anonymous key	Yes
`NEXT_PUBLIC_APP_URL`	Application base URL	No
`NEXT_PUBLIC_WS_URL`	WebSocket server URL	No
`NEXT_PUBLIC_ENABLE_REALTIME`	Enable real-time features (default: true)	No
`NEXT_PUBLIC_ENABLE_ANALYTICS`	Enable Vercel Analytics	No
`NEXT_PUBLIC_ENABLE_PERFORMANCE_MONITORING`	Enable performance monitoring (Speed Insights)	No

Example .env.local:

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_WS_URL=ws://localhost:3001
NEXT_PUBLIC_ENABLE_REALTIME=true
NEXT_PUBLIC_ENABLE_ANALYTICS=true
NEXT_PUBLIC_ENABLE_PERFORMANCE_MONITORING=true

Available Scripts

Command	Description
`npm run dev`	Start development server
`npm run build`	Build for production
`npm run start`	Start production server
`npm run lint`	Run ESLint
`npm run lint:fix`	Run ESLint with auto-fix
`npm run format`	Format code with Prettier
`npm run format:check`	Check code formatting with Prettier
`npm run typecheck`	Run TypeScript type checking
`npm run validate`	Run lint, typecheck, and tests
`npm run test`	Run Jest tests
`npm run test:watch`	Run tests in watch mode
`npm run test:coverage`	Run tests with coverage report
`npm run test:e2e`	Run Playwright E2E tests
`npm run test:e2e:ui`	Run Playwright E2E tests with UI
`npm run clean:dev`	Clean .next and start dev server
`npm run clean:start`	Clean .next, build and start server
`npm run perf:test`	Run performance tests
`npm run perf:quick`	Run quick performance check
`npm run i18n:types`	Generate i18n types
`npm run i18n:check`	Check i18n translations
`npm run i18n:validate`	Validate i18n translations
`npm run naming:check`	Check naming conventions

Project Structure

insight/
├── src/
│   ├── app/                    # Next.js App Router pages and API routes
│   │   ├── [locale]/           # Localized pages (next-intl)
│   │   │   ├── alerts/         # Alerts management page
│   │   │   ├── api3/           # API3 oracle page
│   │   │   ├── band-protocol/  # Band Protocol oracle page
│   │   │   ├── chainlink/      # Chainlink oracle page
│   │   │   ├── chronicle/      # Chronicle oracle page
│   │   │   ├── cross-chain/    # Cross-chain analysis page
│   │   │   ├── cross-oracle/   # Cross-oracle comparison page
│   │   │   ├── dia/            # DIA oracle page
│   │   │   ├── favorites/      # User favorites page
│   │   │   ├── home-components/# Homepage components
│   │   │   ├── login/          # Login page
│   │   │   ├── market-overview/# Market overview page
│   │   │   ├── methodology/    # Methodology page
│   │   │   ├── price-query/    # Price query page
│   │   │   ├── pyth-network/   # Pyth oracle page
│   │   │   ├── redstone/       # RedStone oracle page
│   │   │   ├── register/       # Registration page
│   │   │   ├── settings/       # User settings page
│   │   │   ├── snapshot/       # Shared snapshots page
│   │   │   ├── tellor/         # Tellor oracle page
│   │   │   ├── uma/            # UMA oracle page
│   │   │   └── winklink/       # WINkLink oracle page
│   │   ├── api/                # API endpoints
│   │   │   ├── alerts/         # Price alerts API
│   │   │   │   ├── batch/      # Batch alert operations
│   │   │   │   ├── events/     # Alert events API
│   │   │   │   └── [id]/       # Individual alert endpoints
│   │   │   ├── auth/           # Authentication callbacks
│   │   │   ├── favorites/      # User favorites API
│   │   │   ├── oracles/        # Oracle data API
│   │   │   │   └── [provider]/ # Provider-specific endpoints
│   │   │   ├── snapshots/      # User snapshots API
│   │   │   │   └── [id]/       # Individual snapshot endpoints
│   │   │   ├── cron/           # Scheduled tasks
│   │   │   └── health/         # Health check endpoint
│   │   ├── error.tsx           # Error boundary
│   │   ├── global-error.tsx    # Global error handler
│   │   ├── layout.tsx          # Root layout
│   │   ├── not-found.tsx       # 404 page
│   │   ├── page.tsx            # Home page
│   │   ├── globals.css         # Global styles
│   │   └── favicon.ico         # Favicon
│   ├── components/             # React components
│   │   ├── accessibility/      # Accessibility components
│   │   ├── alerts/             # Alert components
│   │   ├── charts/             # Chart components
│   │   ├── comparison/         # Comparison components
│   │   ├── data-transparency/  # Data transparency components
│   │   ├── export/             # Export components
│   │   ├── favorites/          # Favorite components
│   │   ├── layout/             # Layout components
│   │   ├── mobile/             # Mobile components
│   │   ├── navigation/         # Navigation components
│   │   ├── oracle/             # Oracle-specific components
│   │   │   ├── charts/         # Oracle chart components
│   │   │   ├── common/         # Common oracle components
│   │   │   ├── forms/          # Form components
│   │   │   └── indicators/     # Technical indicators
│   │   ├── search/             # Search components
│   │   ├── settings/           # Settings components
│   │   ├── ui/                 # Reusable UI components
│   │   ├── AppInitializer.tsx  # App initializer
│   │   ├── ErrorBoundaries.tsx # Error boundaries
│   │   ├── Footer.tsx          # Footer component
│   │   ├── GaugeChart.tsx      # Gauge chart
│   │   ├── LanguageSwitcher.tsx# Language switcher
│   │   └── Navbar.tsx          # Navigation bar
│   ├── lib/                    # Core libraries
│   │   ├── analytics/          # Analytics utilities
│   │   ├── api/                # API utilities
│   │   ├── config/             # Configuration files
│   │   ├── constants/          # Application constants
│   │   ├── di/                 # Dependency injection
│   │   ├── errors/             # Error handling
│   │   ├── export/             # Data export utilities
│   │   ├── hooks/              # Custom React hooks
│   │   ├── indicators/         # Technical indicators
│   │   ├── monitoring/         # Performance monitoring
│   │   ├── oracles/            # Oracle client implementations
│   │   ├── queries/            # React Query keys
│   │   ├── realtime/           # Real-time communication
│   │   ├── services/           # External services
│   │   ├── snapshots/          # Snapshot management
│   │   ├── supabase/           # Supabase client and utilities
│   │   └── utils/              # Utility functions
│   ├── types/                  # TypeScript type definitions
│   │   ├── oracle/             # Oracle types
│   │   ├── api/                # API types
│   │   ├── ui/                 # UI types
│   │   ├── auth/               # Auth types
│   │   └── common/             # Common types
│   ├── i18n/                   # Internationalization
│   │   ├── messages/           # Translation messages
│   │   │   ├── common.json
│   │   │   ├── home.json
│   │   │   ├── navigation.json
│   │   │   ├── oracles/        # Oracle-specific translations
│   │   │   └── components/     # Component translations
│   │   ├── config.ts
│   │   └── i18n.ts
│   └── providers/              # React providers
│       └── ReactQueryProvider.tsx
├── supabase/
│   └── migrations/             # Database migrations
│       └── 001_initial_schema.sql
├── public/                     # Static assets
│   └── logos/                  # Logo assets
│       ├── cryptos/            # Cryptocurrency logos
│       └── oracles/            # Oracle logos
├── scripts/                    # Utility scripts
├── next.config.ts              # Next.js configuration
├── tailwind.config.ts          # Tailwind CSS configuration
├── tsconfig.json               # TypeScript configuration
├── jest.config.js              # Jest configuration
└── eslint.config.mjs           # ESLint configuration

Supported Oracles

Chainlink

Supported Chains: Ethereum, Arbitrum, Optimism, Polygon, Avalanche, Base, BNB Chain, Fantom, Starknet, Blast, Moonbeam, Kava, Polkadot
Features: Node analytics, extensive data feeds, high reliability

Band Protocol

Supported Chains: Cosmos, Osmosis, Juno, Ethereum, Polygon, Avalanche, Fantom, Cronos, Injective, Sei, Kava
Features: Validator analytics, cross-chain data feeds

UMA

Supported Chains: Ethereum, Arbitrum, Optimism, Polygon, Base, BNB Chain, Avalanche, Fantom, Gnosis
Features: Optimistic oracle, dispute resolution, validator analytics

Pyth

Supported Chains: Solana, Ethereum, Arbitrum, Polygon, Optimism, Avalanche, Base, Starknet, Blast, Sui, Aptos, Injective, Sei
Features: Publisher analytics, high-frequency updates, confidence intervals

API3

Supported Chains: Ethereum, Arbitrum, Polygon, Avalanche, Base, BNB Chain, Optimism, Moonbeam, Kava, Fantom, Gnosis, Linea, Scroll
Features: First-party oracle, quantifiable security, Airnode deployments

RedStone

Supported Chains: Ethereum, Arbitrum, Optimism, Polygon, Avalanche, Base, BNB Chain, Fantom, Linea, Mantle, Scroll, zkSync, Blast, Starknet, Aptos, Sui
Features: Modular oracle design, data streams, cross-chain support

DIA

Supported Chains: Ethereum, Arbitrum, Polygon, Avalanche, BNB Chain, Base, Fantom, Cronos, Moonbeam, Gnosis, Kava
Features: Open-source cross-chain oracle, NFT data feeds, transparent methodology

Tellor

Supported Chains: Ethereum, Arbitrum, Optimism, Polygon, Base, Avalanche, BNB Chain, Fantom, Moonbeam, Gnosis
Features: Stake-based reporting, dispute mechanism, mining rewards

Chronicle

Supported Chains: Ethereum, Arbitrum, Optimism, Polygon, Base, BNB Chain, Avalanche, Fantom, Gnosis
Features: MakerDAO native oracle, Scuttlebutt protocol, on-chain verification

WINkLink

Supported Chains: BNB Chain, TRON, Ethereum
Features: TRON ecosystem integration, gaming data feeds, entertainment focus

Database Schema

The application uses Supabase (PostgreSQL) with the following main tables:

user_profiles - User preferences and settings
price_records - Historical price data from oracles
user_snapshots - User-saved price snapshots
user_favorites - User favorite configurations
price_alerts - Price alert configurations
alert_events - Alert trigger event history

All tables have Row Level Security (RLS) enabled for data protection.

API Endpoints

Authentication

GET /api/auth/callback - OAuth callback handler
GET /api/auth/profile - Get user profile

Alerts

GET /api/alerts - List user alerts
POST /api/alerts - Create new alert
GET /api/alerts/[id] - Get specific alert
PUT /api/alerts/[id] - Update alert
DELETE /api/alerts/[id] - Delete alert
GET /api/alerts/events - List alert events
POST /api/alerts/events/[id]/acknowledge - Acknowledge alert event
POST /api/alerts/batch - Batch alert operations

Favorites

GET /api/favorites - List user favorites
POST /api/favorites - Create favorite
GET /api/favorites/[id] - Get specific favorite
DELETE /api/favorites/[id] - Delete favorite

Snapshots

GET /api/snapshots - List user snapshots
POST /api/snapshots - Create snapshot
GET /api/snapshots/[id] - Get specific snapshot
DELETE /api/snapshots/[id] - Delete snapshot
POST /api/snapshots/[id]/share - Share snapshot

Oracles

GET /api/oracles - List all oracle providers
POST /api/oracles - Create oracle configuration
GET /api/oracles/[provider] - Get specific oracle data
PUT /api/oracles/[provider] - Update oracle configuration

System

GET /api/health - Health check
GET /api/cron/cleanup - Cleanup expired records

Code Quality

本项目采用严格的代码质量标准，确保代码的可维护性和可靠性：

代码规范

ESLint: 使用 TypeScript ESLint 规则集，包含严格的类型检查
Prettier: 统一的代码格式化配置
TypeScript: 严格的类型检查配置 (strict: true)
命名规范: 统一的文件和变量命名约定

质量检查脚本

# 运行 ESLint 检查
npm run lint

# 自动修复 ESLint 问题
npm run lint:fix

# 运行类型检查
npm run typecheck

# 运行所有测试
npm run test

# 运行测试覆盖率检查
npm run test:coverage

# 运行完整验证（lint + typecheck + test）
npm run validate

# 检查命名规范
npm run naming:check

代码质量指标

测试覆盖率: 目标 80%+
类型安全: 100% TypeScript 覆盖
Lint 通过率: 零错误，最小化警告
构建成功率: 100%

持续改进

定期运行 npm run validate 确保代码质量
使用 npm run lint:fix 自动修复格式问题
提交前确保所有测试通过

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
确保代码通过所有质量检查 (npm run validate)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is private and proprietary.

Acknowledgments

Chainlink - Decentralized oracle network
Band Protocol - Cross-chain data oracle
UMA - Optimistic oracle
Pyth Network - High-frequency oracle
API3 - First-party oracle solution
RedStone - Modular oracle
DIA - Open-source oracle
Tellor - Decentralized oracle
Chronicle - MakerDAO oracle
WINkLink - TRON ecosystem oracle

Name		Name	Last commit message	Last commit date
Latest commit History 335 Commits
.husky		.husky
.trae		.trae
docs		docs
e2e		e2e
public		public
scripts		scripts
src		src
supabase/migrations		supabase/migrations
.editorconfig		.editorconfig
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc		.prettierrc
API_REFERENCE.md		API_REFERENCE.md
ARCHITECTURE.md		ARCHITECTURE.md
CHAINLINK_REAL_DATA.md		CHAINLINK_REAL_DATA.md
CODE_QUALITY_ANALYSIS.md		CODE_QUALITY_ANALYSIS.md
CODE_QUALITY_FIX_REPORT.md		CODE_QUALITY_FIX_REPORT.md
CODE_QUALITY_REPORT.md		CODE_QUALITY_REPORT.md
CONTRIBUTING.md		CONTRIBUTING.md
DATA_FETCHING_OPTIMIZATION_REPORT.md		DATA_FETCHING_OPTIMIZATION_REPORT.md
DEPLOYMENT.md		DEPLOYMENT.md
ORACLE_TEMPLATE_GUIDE.md		ORACLE_TEMPLATE_GUIDE.md
README.md		README.md
SECURITY.md		SECURITY.md
USER_GUIDE.md		USER_GUIDE.md
WEBSOCKET_API.md		WEBSOCKET_API.md
commit_msg.txt		commit_msg.txt
eslint.config.mjs		eslint.config.mjs
fix-unused-vars.sh		fix-unused-vars.sh
global.d.ts		global.d.ts
i18n-report.json		i18n-report.json
jest.config.js		jest.config.js
jest.setup.js		jest.setup.js
lint-report-after.json		lint-report-after.json
lint-report.json		lint-report.json
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
playwright.config.ts		playwright.config.ts
postcss.config.mjs		postcss.config.mjs
quality-analysis.json		quality-analysis.json
sentry.client.config.ts		sentry.client.config.ts
sentry.edge.config.ts		sentry.edge.config.ts
sentry.server.config.ts		sentry.server.config.ts
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

Insight - Oracle Data Analytics Platform

Key Features

Technology Stack

Frontend

Backend

Oracle Clients

Prerequisites

Installation

Environment Variables

Available Scripts

Project Structure

Supported Oracles

Chainlink

Band Protocol

UMA

Pyth

API3

RedStone

DIA

Tellor

Chronicle

WINkLink

Database Schema

API Endpoints

Authentication

Alerts

Favorites

Snapshots

Oracles

System

Code Quality

代码规范

质量检查脚本

代码质量指标

持续改进

Contributing

License

Acknowledgments

About

Resources

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages