Skip to content

pokt-network/pokt-status-dashboard

Repository files navigation

Pocket Network Status Dashboard

A real-time status dashboard for monitoring Pocket Network services, applications, gateways, suppliers, and tokenomics metrics. This dashboard provides comprehensive insights into the Pocket Network ecosystem through an intuitive web interface.

Prerequisites

Before running this dashboard, ensure you have:

  • Node.js 18+ or Bun runtime
  • Access to a Pocket Network API endpoint

Self-Hosting Guide

1. Clone the Repository

git clone <repository-url>
cd status-dashboard

2. Install Dependencies

Using Bun (recommended):

bun install

Or using npm:

npm install

3. Environment Configuration

Create a .env.local file in the root directory:

cp .env.example .env.local

Edit .env.local and set the following environment variables:

# Pocket Network API URL
NEXT_PUBLIC_POCKET_API_URL=https://your-pocket-api-endpoint.com

Important: Replace https://your-pocket-api-url.com with your actual Pocket Network API URL. It must be a Shannon Mainnet version.

4. Build the Application

bun run build

Or using npm:

npm run build

5. Start the Production Server

bun run start

Or using npm:

npm run start

The dashboard will be available at http://localhost:3000

Development

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

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

Configuration Options

Pagination Settings

You can modify default pagination settings in src/utils/constants.ts:

export const DEFAULT_PAGE_LIMIT = 10;
export const DEFAULT_PAGE_OFFSET = 0;
export const DEFAULT_PAGE_COUNT_TOTAL = true;
export const DEFAULT_PAGE_REVERSE = false;

API Configuration

The dashboard connects to Pocket Network APIs through the configured endpoint. Ensure your API endpoint supports the following endpoints:

  • /pokt-network/poktroll/application/application
  • /pokt-network/poktroll/gateway/gateway
  • /pokt-network/poktroll/service/params
  • /pokt-network/poktroll/supplier/supplier
  • /pokt-network/poktroll/tokenomics/tokenomics

Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature-name
  3. Commit your changes: git commit -am 'Add feature'
  4. Push to the branch: git push origin feature-name
  5. Submit a pull request

🔗 Links

📞 Support

For issues and questions:

  • Create an issue in the repository
  • Check the troubleshooting section above
  • Review the Pocket Network documentation for API-related questions

About

An OSS status dashboard for POKT node runners

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published