Skip to content

Amon is a Checker Subnet for the Akash Network (a DePIN), which provides real time intelligence data about Akash and stores it verifiably, securely on Filecoin.

Notifications You must be signed in to change notification settings

x-maues/amon-checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AMON Checker

Checker Network Logo

Reliable Intelligence Data for Akash Network (A Checker Subnet)

MIT License Built for Checker Network

Akash Network Checker Network Filecoin

📋 Overview

Amon continuously monitors the Akash Network(a DePIN compute marketplace)'s provider fleet, collecting critical metrics and submitting verifiable measurements to the Checker Network. This subnet is a vital component of the Checker Network ecosystem, ensuring reliable, fairly collected intelligence data from DePINs and Web3 networks.

✨ Key Features

  • Real-time Provider Monitoring - Track health metrics across the entire Akash provider fleet
  • Verifiable Measurements - Cryptographically secure data submission to Filecoin settlement layer
  • Resource Availability Tracking - Monitor CPU, memory, and storage capacity
  • Transparent Provider Performance - Access reliable metrics for informed deployment decisions

🏗️ Architecture

Core Components

Component Description
🔍 Provider Discovery Automatically maintains an up-to-date list of active Akash providers
🔔 Health Verification Performs comprehensive health checks including latency, uptime, and response validation
📊 Resource Monitor Tracks provider resource metrics (CPU, memory, storage) and capacity
🔐 Measurement Engine Generates and submits cryptographically verifiable measurements

Measurement Flow

  1. 🔄 Provider list is periodically refreshed from the Akash Network
  2. 🔍 Health checks and resource monitoring are performed on each provider
  3. ✅ Measurements are validated and formatted according to subnet specifications
  4. 📤 Verified measurements are submitted to the Checker Network
Checker Network Logo

🔧 Technical Specifications

  • Provider Health Metrics: Response time, availability, resource capacity
  • Resource Monitoring: CPU utilization, memory usage, storage availability
  • Measurement Frequency: Configurable intervals for health checks and updates
  • Auto-scaling: Dynamic provider list management with configurable thresholds
Checker Network Logo
 Display intelligence data locally

🚀 Usage

⚙️ Configuration for the AMON Checker

Environment variables for subnet customization:

Variable Description Default
AKASH_API_URL Akash Network API endpoint https://console-api.akash.network
CHECKER_API_URL Checker Network API endpoint https://api.checker.network
MEASUREMENT_DELAY Inter-measurement delay in ms 60000
UPDATE_NODES_DELAY Provider list refresh interval in ms 300000
MIN_PROVIDERS_REQUIRED Minimum provider count threshold 3

📁 AMON Project Structure

├── main.js              # Entry point and measurement loop
└── lib/
    ├── akash-client     # Better provider management with checks
    ├── nodes.js         # Provider discovery and management
    ├── measure.js       # Health and resource measurements
    ├── submit-measurement.js  # Measurement submission
    ├── constants.js     # Configuration constants
    ├── http-assertions.js     # Response validation
    └── random.js        # Utility functions for randomized picking

Setting up the Database

# Create the database
docker exec -it spark-db psql -U $env:UserName -c "CREATE DATABASE simple_subnet_api"

# Create the measurements table
docker exec -it spark-db psql -U $env:UserName -d simple_subnet_api -c "CREATE TABLE daily_measurements ( subnet VARCHAR(50) NOT NULL, day DATE NOT NULL, total BIGINT DEFAULT 0, successful BIGINT DEFAULT 0, PRIMARY KEY (subnet, day) );"

# Verify table creation
docker exec -it spark-db psql -U $env:UserName -d simple_subnet_api -c "\dt"

# Check table contents
docker exec -it spark-db psql -U $env:UserName -d simple_subnet_api -c "SELECT * FROM daily_measurements;"

Setting up the API and Running the Subnet

# Set up the simple subnet API
cd simple-subnet-api
npm i
node bin/migrate.js
node bin./simple-subnet-api.js

# Run the Amon checker subnet
cd amon
zinnia run main.js

-Maues

About

Amon is a Checker Subnet for the Akash Network (a DePIN), which provides real time intelligence data about Akash and stores it verifiably, securely on Filecoin.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors