Penumbra Tokenomics

The Penumbra tokenomics dashboard for visualizing and analyzing network metrics.

This is a Next.js-based dashboard that provides comprehensive visualization and analysis of Penumbra's tokenomics data. Built with modern web technologies, it offers an intuitive interface for exploring key metrics and trends.

To participate in the test network, use a browser extension like Prax from the Chrome Web Store.

You can talk to us on Discord.

Features

• Real-time tokenomics data visualization
• Interactive charts and graphs using ECharts
• Responsive design with modern UI components
• Data persistence with PostgreSQL
• AWS S3 integration for file storage

Published Packages

All have a @penumbra-zone/ namespace prefix on npm.

🌘 bech32m 🌑 client 🌑 constants 🌑 crypto 🌑 getters 🌑 keys 🌑 perspective 🌑 protobuf 🌑 services 🌑 services-context 🌑 storage 🌑 transport-chrome 🌑 transport-dom 🌑 types 🌑 wasm 🌒

Tech Stack

• Next.js 14
• React 18
• TypeScript
• TailwindCSS
• Radix UI
• ECharts
• Redux Toolkit
• PostgreSQL
• AWS SDK

Getting Started

Prerequisites

Make sure you have the following tools installed:

• Node.js – Recommended via nvm
• pnpm – Package manager, recommended via corepack
• Git

Installation

1. Clone the repository:

git clone <repository-url>
cd tokenomics-dashboard

2. Install dependencies:

pnpm install

3. Set up environment variables:

cp .env.example .env

Edit the .env file with your specific configuration values.

Development

Run the development server:

# Run in development mode
pnpm dev

# Run with mock data
pnpm mock:dev

Open http://localhost:3000 with your browser to see the result.

Available Scripts

• pnpm dev - Start development server
• pnpm mock:dev - Start development server with mock data
• pnpm build - Build for production
• pnpm start - Start production server
• pnpm lint - Run ESLint
• pnpm format - Format code with Prettier
• pnpm format:check - Check code formatting

Deployment

In order to deploy the application, you'll need to configure backend access to a pindexer database, as well as object storage buckets for social cards. Consult the .env.example file for reference.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Security

If you believe you've found a security-related issue with Penumbra, please disclose responsibly by contacting the Penumbra Labs team at [email protected].