Analytics dashboard for the Arweave ecosystem

Features • Architecture • Getting Started • License

⚠️ Archive Notice

This project is archived and no longer maintained.

This repository is provided as-is for historical reference and educational purposes. No support, updates, or bug fixes will be provided. The codebase may contain outdated dependencies with known vulnerabilities. It was originally developed by Roark Technology for the DataOS analytics platform.

Use at your own risk.

DataOS Analytics was a comprehensive analytics dashboard for the Arweave permanent storage network ecosystem. It provided real-time and historical insights into:

• Arweave L1 Metrics — Protocols, transactions, users, and storage growth
• Smartweave Analytics — Contract deployments and interactions
• Redstone Oracle Data — Transaction volumes and data feeds
• Protocol Trends — Application-level usage patterns and content distribution

• Time-series visualizations with Highcharts
• Configurable granularity (hourly, daily, weekly, monthly)
• Customizable date ranges
• Shareable chart states via URL parameters

• Interactive treemap for content type distribution
• Protocol trends table with sorting and filtering
• Per-application drill-down analytics
• Recent transaction listings

• Dark and light theme support
• Responsive design (mobile-first)
• Material UI components with custom theming
• Server-side rendering for optimal performance

• Dynamic OpenGraph image generation
• Twitter card support
• Shareable metric cards

┌─────────────────────────────────────────────────────────────────┐
│                         Frontend (Next.js 13)                    │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │   App Router │  │  Components │  │   Services  │              │
│  │   (Pages)    │  │   (React)   │  │  (Data API) │              │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘              │
│         │                │                │                      │
│         └────────────────┼────────────────┘                      │
│                          │                                       │
│                    ┌─────┴─────┐                                 │
│                    │  Supabase │                                 │
│                    │  Client   │                                 │
│                    └─────┬─────┘                                 │
└──────────────────────────┼──────────────────────────────────────┘
                           │
                    ┌──────┴──────┐
                    │   Supabase  │
                    │  (Postgres) │
                    └─────────────┘

src/
├── app/                    # Next.js App Router pages
│   ├── arweave/           # Arweave L1 analytics
│   ├── smartweave/        # Smartweave contract analytics
│   ├── redstone/          # Redstone oracle analytics
│   ├── l1-trends/         # Protocol trends & app explorer
│   └── stamp/             # Stamp protocol analytics
├── components/            # Reusable React components
│   ├── Charts/           # Highcharts wrappers
│   └── RootLayout/       # Layout components (Header, Footer)
├── services/             # Data fetching & API layer
├── utils/                # Helper functions
└── lib/                  # External service clients

• Node.js 18+
• pnpm, yarn, or npm
• Supabase account (for database)

1. Clone the repository

   git clone https://github.com/your-org/dataos-analytics-fe.git
   cd dataos-analytics-fe

2. Install dependencies

   yarn install
   # or
   pnpm install
   # or
   npm install

3. Configure environment variables

   cp .env.example .env.local

   Edit .env.local with your configuration:

   NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
   NEXT_PUBLIC_SUPABASE_KEY=your-supabase-anon-key

4. Run the development server

   yarn dev
   # or
   pnpm dev
   # or
   npm run dev

5. Open http://localhost:3000

This application expects a Supabase database with specific views and tables for Arweave analytics data. The data pipeline and database schema are not included in this repository.

Required database views include:

• l1_rolling_protocols_monthly
• l1_rolling_size_monthly
• l1_rolling_transactions_monthly
• l1_rolling_users_monthly
• l1_transactions_over_time
• l1_users_over_time
• l1_trends
• l2_actions_over_time
• l2_users_over_time
• redstone_cumulative
• redstone_transactions_and_tps
• And others...

This project is licensed under the MIT License — see the LICENSE file for details.

Originally developed by Roark Technology for the Arweave ecosystem.

_{This project is archived and provided for historical reference only.}