# Monitor

Monitor is the pricing and oracle dashboard for `monitor.outsidethebox.top`.

It began as a rotating market display for fiat and crypto lines and now includes a live oracle subsystem for billing-oriented crypto quote generation.

## Current scope

Monitor currently provides:

- Rotating fiat and crypto line updates
- 7-day sparkline display for supported assets
- CoinGecko market chart integration for tracked assets
- KlingEx pair support for selected ecosystem assets
- Oracle asset registry and live cache
- Oracle status panel in the frontend
- Live quote calculator using oracle quote data
- Oracle API endpoints for billing and future checkout integrations

## Oracle milestone

This release introduces the first production-style oracle layer for OutsideTheBox billing and payment work.

Highlights:

- Added `/api/oracle/assets`
- Added `/api/oracle/prices`
- Added `/api/oracle/price/:pairKey`
- Added `/api/oracle/quote`
- Added `/api/oracle/status`
- Added oracle price cache refresh timer
- Added CoinGecko primary pricing
- Added CoinPaprika fallback pricing
- Added billing-enabled asset handling
- Added quote priority ordering
- Added frontend Oracle Status panel
- Added frontend live quote calculator
- EGAZ remains visible but is currently excluded from billing quotes

## Current tracked oracle assets

- USDC on Arbitrum
- ETH on Ethereum
- ETHO
- ETI
- EGAZ (displayed, not billing-enabled for now)

## Services and runtime layout

Primary backend:

- `backend/server.js`
- Served by `monitor-backend.service`

Oracle refresh:

- `oracle/fetch_prices.js`
- Refreshed by `otb-oracle-refresh.timer`

Frontend:

- Static files served by nginx from `/var/www/monitor`
- Source files maintained in `/home/def/monitor/frontend`

## Deployment notes

Backend is served locally on:

- `127.0.0.1:4010`

Oracle routes are mounted under:

- `/api/oracle/*`

The tax nginx vhost serves the frontend and proxies API requests to the backend.
The mintme webfront proxies public traffic to the tax host.

## Important note

If frontend changes are made under `/home/def/monitor/frontend`, they must also be copied into:

- `/var/www/monitor`

or the live site will continue serving the older frontend files.

## Status

This project is now at its first documented oracle milestone and is ready to be consumed by other internal systems such as OTB Billing.