eto-monitor

v2.0.0

Published

3 months ago

ETO Protocol Monitor CLI - Real-time monitoring for ETO Protocol DMMv2 DeFi infrastructure

0High
0Medium
0Low

defibagholder

eto dmmv2 defi monitor cli blockchain oracle keeper ethereum

ETO Protocol Monitor CLI

Real-time monitoring CLI for ETO Protocol DMMv2 DeFi infrastructure

Installation • Quick Start • Documentation • Features

Overview

ETO Protocol Monitor is a comprehensive command-line tool for monitoring the entire ETO Protocol blockchain ecosystem. It provides real-time insights into DMM pools, PSM arbitrage opportunities, oracle health, keeper status, LP analytics, and AWS integration—all from your terminal.

Key Features

🔄 Live Dashboard - Real-time system monitoring with 2-second refresh
📊 Price Tracking - Monitor Reflective, DMM, and Oracle prices with deviation alerts
💰 LP Analytics - TVL, impermanent loss, fee revenue, and liquidity ratios
⚡ Arbitrage Detection - Identify PSM/DMM arbitrage opportunities
🏦 Vault Monitoring - Track staged tokens and drip status
☁️ AWS Integration - CloudWatch log integration for keeper status
👛 Keeper Health - Balance tracking and funding alerts
🔗 Oracle Status - Staleness detection and feed validation

Installation

npm install -g eto-monitor

Requirements:

Node.js >= 18.0.0
Internet connection (to access ETO RPC endpoint)
AWS CLI (optional, for eto aws command)

Note: Zero configuration required! No private keys, RPC setup, or environment variables needed.

Quick Start

# Start live monitoring dashboard
eto

# Quick health check
eto quick

# View all available commands
eto help

Commands

📺 Live Monitoring

| Command | Description | |---------|-------------| | eto | Live dashboard with 2-second refresh (default) | | eto live [sec] | Live dashboard with custom refresh interval | | eto watch [sec] | Full detailed monitoring mode (10s default) |

🔍 Quick Diagnostics

| Command | Description | |---------|-------------| | eto quick | Quick health summary of all systems | | eto summary | Full system health check with status codes | | eto deep | Deep diagnostic - all checks (verbose) |

🧩 Component Checks

| Command | Description | |---------|-------------| | eto controller | Controller status & configuration | | eto dmm | DMM/CLMM status, reserves & pricing | | eto psm | PSM status, throttle & volume stats | | eto oracle | Oracle Aggregator & individual oracles | | eto vault | sMAANG Vault health & drip status | | eto tokens | Token balances in all contracts |

📈 Analytics & Arbitrage

| Command | Description | |---------|-------------| | eto arb | Arbitrage detection & opportunities | | eto sync | Sync health & timing analysis | | eto prices | Price deviations across system | | eto lp | LP Analytics: IL, fees, PnL, ratios | | eto pnl | Same as lp (impermanent loss & fees) |

🤖 Keeper Status

| Command | Description | |---------|-------------| | eto keepers | Keeper wallet balances | | eto aws | AWS sync keeper logs & stats | | eto all | Run all checks once (with AWS) | | eto full | Same as all |

Features

Live Dashboard

The live dashboard provides a comprehensive real-time view of the entire ETO Protocol system:

Prices: Reflective, DMM, and Oracle prices with deviation alerts
System Status: Controller, PSM, EveryBlock mode, Oracle staleness
Keeper Balances: All keeper wallets with funding alerts
DMM Pool: TVL, liquidity ratios, fee rates, tick positions
Vault: Staged tokens (MAANG/USDC)
PSM: Status, net flow, volume
AWS Keeper: Uptime, syncs, arbs, recenters, drips, TX success rate

Price Monitoring

Real-time price tracking across Reflective, DMM, and Oracle
Deviation alerts in basis points (bps)
Visual deviation indicators (▁▂▄▆█)
Color-coded status (🟢 green / 🟡 yellow / 🔴 red)

LP Analytics

Total Value Locked (TVL): Current pool value
Liquidity Ratios: MAANG/USDC with visual bar
Impermanent Loss: Estimated IL calculation
Fee Revenue: Fees owed and collectable
Band Information: Tick ranges and positions

Arbitrage Detection

PSM/DMM arbitrage opportunities
Price deviation thresholds
Profitability calculations
Real-time opportunity alerts

Vault Health

Staged token amounts (MAANG/USDC)
Drip status and timing
Vault function health checks
Pending drip calculations

AWS Integration

CloudWatch log integration
Keeper uptime tracking
Transaction success rates
Sync/arb/recenter/drip statistics
Recent activity monitoring

Keeper Monitoring

Balance tracking for all keeper wallets
Funding alerts (critical/low thresholds)
Status indicators (▲◆▼)
Total keeper balance

Oracle Health

Oracle aggregator status
Individual oracle staleness
Active oracle count
Price feed validation

Examples

Basic Usage

# Start live monitoring (default 2s refresh)
eto

# Quick health check
eto quick

# Check arbitrage opportunities
eto arb

# View LP analytics and PnL
eto lp

# Monitor AWS keeper status
eto aws

# Full system diagnostic
eto deep

Advanced Usage

# Custom refresh interval (1 second)
eto live 1

# Check specific component
eto dmm
eto psm
eto vault

# Full monitoring mode (10s refresh)
eto watch 10

Output Format

Live Dashboard Example

╔══════════════════════════════════════════════════════════════════════════════╗
║  🔮 ETO DMMv2 LIVE MONITOR                           Block 586043 • Jan 8  ║
╠══════════════════════════════════════════════════════════════════════════════╣
║
║  💰 PRICES
║    Reflective: $332.411782
║    DMM:        $332.411782  (0.0 bps from ref)
║    Oracle:     $332.411782  (0.0 bps from ref)
║
║  ⚡ SYSTEM STATUS
║    Controller: ● OK    PSM: ● READY    EveryBlock: ○ OFF
║    Last Sync: 34m 46s    Oracles: 3/3    Oracle Age: 11h 0m
║
║  👛 KEEPER BALANCES
║    ▲ Sync:      56.61 ETO
║    ▲ Oracle 1&3: 893.51 ETO
║    ▲ Oracle 2:   290.16 ETO
║    Total:     1240.28 ETO
║
║  📊 DMM POOL
║    TVL: $141.6K    Liquidity: 388462598920    Fee: 30bps
║    Ratio: [█████████░░░░░░░░░░] 43%/57%
║    Tick: -218258 in [-218280, -218240]
║
║  🏦 VAULT
║    ○ Staged: 0 MAANG / 0 USDC
║
║  💱 PSM
║    Status: ● READY    Net Flow: ─ 0.00 MAANG
║
║  ☁️  AWS KEEPER
║    ● Up: 0h 34m 44s
║    Syncs: 372  Arbs: 1  Recenters: 1  Drips: 0
║    Recent: ● (1/1 ok)
║
╚══════════════════════════════════════════════════════════════════════════════╝
  Ctrl+C to stop • Refreshing every 2s

Status Indicators

| Symbol | Meaning | |--------|---------| | 🟢 ● | OK / Healthy | | 🟡 ◐ | Warning / Stale | | 🔴 ● | Error / Critical | | 🟢 ▲ | Good balance | | 🟡 ◆ | Low balance | | 🔴 ▼ | Critical balance |

Configuration

No configuration needed! The CLI automatically:

Connects to ETO blockchain at https://eto.ash.center/rpc
Uses hardcoded contract addresses for the current deployment
Requires no private keys (read-only operations)

To monitor different deployments, modify the source code.

Troubleshooting

AWS Command Not Working

# Install AWS CLI
brew install awscli        # macOS
apt install awscli         # Linux

# Configure credentials
aws configure

# Ensure CloudWatch read permissions

Connection Issues

Check network connectivity
Verify RPC endpoint is accessible: https://eto.ash.center/rpc
Try increasing timeout in source code if needed

Command Not Found

# Ensure global installation
npm install -g eto-monitor

# Check PATH includes npm global bin
npm config get prefix

Development

Setup

# Clone repository
git clone https://github.com/eto-protocol/eto-monitor.git
cd eto-monitor

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Test locally
npm link
eto quick

Project Structure

eto-monitor/
├── system-monitor-cli.ts    # Main CLI entry point
├── dist/                     # Built files
│   └── system-monitor-cli.js
├── package.json
├── tsconfig.json
└── README.md

Contributing

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

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

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

Support

For issues, feature requests, or questions:

Open an issue on GitHub
Contact the ETO Protocol team

Made with ❤️ for the ETO Protocol community

⬆ Back to Top